gnosys 5.11.4 → 5.12.2

package/dist/lib/config.d.ts

@@ -11,6 +11,7 @@ declare const LLMProviderEnum: z.ZodEnum<{
     lmstudio: "lmstudio";
     xai: "xai";
     mistral: "mistral";
+    openrouter: "openrouter";
     custom: "custom";
 }>;
 export type LLMProviderName = z.infer<typeof LLMProviderEnum>;
@@ -26,6 +27,7 @@ declare const DreamConfigSchema: z.ZodObject<{
         lmstudio: "lmstudio";
         xai: "xai";
         mistral: "mistral";
+        openrouter: "openrouter";
         custom: "custom";
     }>>;
     model: z.ZodOptional<z.ZodString>;
@@ -33,6 +35,14 @@ declare const DreamConfigSchema: z.ZodObject<{
     generateSummaries: z.ZodDefault<z.ZodBoolean>;
     discoverRelationships: z.ZodDefault<z.ZodBoolean>;
     minMemories: z.ZodDefault<z.ZodNumber>;
+    schedule: z.ZodDefault<z.ZodObject<{
+        startHour: z.ZodDefault<z.ZodNumber>;
+        endHour: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    systemIdleMinutes: z.ZodDefault<z.ZodNumber>;
+    minNewMemoriesToDream: z.ZodDefault<z.ZodNumber>;
+    minHoursBetweenRuns: z.ZodDefault<z.ZodNumber>;
+    maxLLMCallsPerRun: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type DreamConfig = z.infer<typeof DreamConfigSchema>;
 declare const RecallConfigSchema: z.ZodObject<{
@@ -41,52 +51,6 @@ declare const RecallConfigSchema: z.ZodObject<{
     minRelevance: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type RecallConfig = z.infer<typeof RecallConfigSchema>;
-declare const ChatConfigSchema: z.ZodObject<{
-    toolsEnabled: z.ZodDefault<z.ZodBoolean>;
-    autoSummarizeAfterTurns: z.ZodDefault<z.ZodNumber>;
-    systemPromptPrefix: z.ZodDefault<z.ZodString>;
-}, z.core.$strip>;
-export type ChatConfig = z.infer<typeof ChatConfigSchema>;
-declare const MultimodalConfigSchema: z.ZodObject<{
-    transcriptionProvider: z.ZodDefault<z.ZodEnum<{
-        groq: "groq";
-        openai: "openai";
-        local: "local";
-    }>>;
-    whisperModel: z.ZodDefault<z.ZodString>;
-    visionProvider: z.ZodOptional<z.ZodEnum<{
-        anthropic: "anthropic";
-        ollama: "ollama";
-        groq: "groq";
-        openai: "openai";
-        lmstudio: "lmstudio";
-        xai: "xai";
-        mistral: "mistral";
-        custom: "custom";
-    }>>;
-    visionModel: z.ZodOptional<z.ZodString>;
-    chunkSize: z.ZodDefault<z.ZodNumber>;
-    maxFileSizeMb: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export type MultimodalConfig = z.infer<typeof MultimodalConfigSchema>;
-declare const WebConfigSchema: z.ZodObject<{
-    source: z.ZodDefault<z.ZodEnum<{
-        sitemap: "sitemap";
-        directory: "directory";
-        urls: "urls";
-    }>>;
-    sitemapUrl: z.ZodOptional<z.ZodString>;
-    contentDir: z.ZodOptional<z.ZodString>;
-    urls: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    outputDir: z.ZodDefault<z.ZodString>;
-    exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    categories: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-    llmEnrich: z.ZodDefault<z.ZodBoolean>;
-    prune: z.ZodDefault<z.ZodBoolean>;
-    concurrency: z.ZodDefault<z.ZodNumber>;
-    crawlDelayMs: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export type WebConfig = z.infer<typeof WebConfigSchema>;
 export declare const GnosysConfigSchema: z.ZodObject<{
     llm: z.ZodDefault<z.ZodObject<{
         defaultProvider: z.ZodDefault<z.ZodEnum<{
@@ -97,6 +61,7 @@ export declare const GnosysConfigSchema: z.ZodObject<{
             lmstudio: "lmstudio";
             xai: "xai";
             mistral: "mistral";
+            openrouter: "openrouter";
             custom: "custom";
         }>>;
         anthropic: z.ZodDefault<z.ZodObject<{
@@ -128,6 +93,11 @@ export declare const GnosysConfigSchema: z.ZodObject<{
             model: z.ZodDefault<z.ZodString>;
             apiKey: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        openrouter: z.ZodDefault<z.ZodObject<{
+            model: z.ZodDefault<z.ZodString>;
+            baseUrl: z.ZodDefault<z.ZodString>;
+            apiKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         custom: z.ZodOptional<z.ZodObject<{
             model: z.ZodString;
             baseUrl: z.ZodString;
@@ -144,6 +114,7 @@ export declare const GnosysConfigSchema: z.ZodObject<{
                 lmstudio: "lmstudio";
                 xai: "xai";
                 mistral: "mistral";
+                openrouter: "openrouter";
                 custom: "custom";
             }>;
             model: z.ZodString;
@@ -157,6 +128,7 @@ export declare const GnosysConfigSchema: z.ZodObject<{
                 lmstudio: "lmstudio";
                 xai: "xai";
                 mistral: "mistral";
+                openrouter: "openrouter";
                 custom: "custom";
             }>;
             model: z.ZodString;
@@ -170,6 +142,7 @@ export declare const GnosysConfigSchema: z.ZodObject<{
                 lmstudio: "lmstudio";
                 xai: "xai";
                 mistral: "mistral";
+                openrouter: "openrouter";
                 custom: "custom";
             }>;
             model: z.ZodString;
@@ -183,6 +156,7 @@ export declare const GnosysConfigSchema: z.ZodObject<{
                 lmstudio: "lmstudio";
                 xai: "xai";
                 mistral: "mistral";
+                openrouter: "openrouter";
                 custom: "custom";
             }>;
             model: z.ZodString;
@@ -196,6 +170,7 @@ export declare const GnosysConfigSchema: z.ZodObject<{
                 lmstudio: "lmstudio";
                 xai: "xai";
                 mistral: "mistral";
+                openrouter: "openrouter";
                 custom: "custom";
             }>;
             model: z.ZodString;
@@ -247,6 +222,7 @@ export declare const GnosysConfigSchema: z.ZodObject<{
             lmstudio: "lmstudio";
             xai: "xai";
             mistral: "mistral";
+            openrouter: "openrouter";
             custom: "custom";
         }>>;
         model: z.ZodOptional<z.ZodString>;
@@ -254,6 +230,14 @@ export declare const GnosysConfigSchema: z.ZodObject<{
         generateSummaries: z.ZodDefault<z.ZodBoolean>;
         discoverRelationships: z.ZodDefault<z.ZodBoolean>;
         minMemories: z.ZodDefault<z.ZodNumber>;
+        schedule: z.ZodDefault<z.ZodObject<{
+            startHour: z.ZodDefault<z.ZodNumber>;
+            endHour: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        systemIdleMinutes: z.ZodDefault<z.ZodNumber>;
+        minNewMemoriesToDream: z.ZodDefault<z.ZodNumber>;
+        minHoursBetweenRuns: z.ZodDefault<z.ZodNumber>;
+        maxLLMCallsPerRun: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     chat: z.ZodDefault<z.ZodObject<{
         toolsEnabled: z.ZodDefault<z.ZodBoolean>;
@@ -275,6 +259,7 @@ export declare const GnosysConfigSchema: z.ZodObject<{
             lmstudio: "lmstudio";
             xai: "xai";
             mistral: "mistral";
+            openrouter: "openrouter";
             custom: "custom";
         }>>;
         visionModel: z.ZodOptional<z.ZodString>;
@@ -314,11 +299,11 @@ export declare function resolveTaskModel(config: GnosysConfig, task: "structurin
  */
 export declare function getProviderModel(config: GnosysConfig, provider: LLMProviderName): string;
 /**
- * Get the Groq API key, checking config first then env var.
+ * Get the Groq API key (global → provider → legacy env).
  */
 export declare function getGroqApiKey(config: GnosysConfig): string | undefined;
 /**
- * Get the OpenAI API key, checking config first then env var.
+ * Get the OpenAI API key (global → provider → legacy env).
  */
 export declare function getOpenAIApiKey(config: GnosysConfig): string | undefined;
 /**
@@ -345,6 +330,14 @@ export declare function getXAIApiKey(config: GnosysConfig): string | undefined;
  * Get the Mistral API key, checking config first then env var.
  */
 export declare function getMistralApiKey(config: GnosysConfig): string | undefined;
+/**
+ * Get the OpenRouter API key, checking config first then env var.
+ */
+export declare function getOpenRouterApiKey(config: GnosysConfig): string | undefined;
+/**
+ * Get the OpenRouter API base URL from config.
+ */
+export declare function getOpenRouterBaseUrl(config: GnosysConfig): string;
 /**
  * Get the Custom provider API key, checking config first then env var.
  */

package/dist/lib/config.js

@@ -5,11 +5,11 @@
 import { z } from "zod";
 import fs from "fs/promises";
 import path from "path";
-import { execSync } from "child_process";
 import { getGnosysHome } from "./paths.js";
 import { atomicWriteFile } from "./atomicWrite.js";
+import { getApiKeyForProviderFromConfig, } from "./apiKeyVault.js";
 // ─── LLM Provider Schemas ───────────────────────────────────────────────
-const LLMProviderEnum = z.enum(["anthropic", "ollama", "groq", "openai", "lmstudio", "xai", "mistral", "custom"]);
+const LLMProviderEnum = z.enum(["anthropic", "ollama", "groq", "openai", "lmstudio", "xai", "mistral", "openrouter", "custom"]);
 const AnthropicConfigSchema = z.object({
     model: z.string().default("claude-sonnet-4-6"),
     apiKey: z.string().optional(), // Falls back to ANTHROPIC_API_KEY env var
@@ -39,6 +39,11 @@ const MistralConfigSchema = z.object({
     model: z.string().default("mistral-small-4"),
     apiKey: z.string().optional(),
 });
+const OpenRouterConfigSchema = z.object({
+    model: z.string().default("nvidia/nemotron-3-super-120b-a12b:free"),
+    baseUrl: z.string().default("https://openrouter.ai/api/v1"),
+    apiKey: z.string().optional(),
+});
 const CustomConfigSchema = z.object({
     model: z.string(),
     baseUrl: z.string(),
@@ -57,6 +62,10 @@ const LLMConfigSchema = z.object({
     lmstudio: LMStudioConfigSchema.default({ model: "default", baseUrl: "http://localhost:1234/v1" }),
     xai: XAIConfigSchema.default({ model: "grok-4.20" }),
     mistral: MistralConfigSchema.default({ model: "mistral-small-4" }),
+    openrouter: OpenRouterConfigSchema.default({
+        model: "nvidia/nemotron-3-super-120b-a12b:free",
+        baseUrl: "https://openrouter.ai/api/v1",
+    }),
     custom: CustomConfigSchema.optional(),
 });
 const TaskModelsSchema = z.object({
@@ -96,6 +105,19 @@ const DreamConfigSchema = z.object({
     discoverRelationships: z.boolean().default(true),
     /** Min memory count before dream mode activates */
     minMemories: z.number().int().min(1).default(10),
+    /** Night-only launch window for scheduled Dream runs. Hours are local 0-23. */
+    schedule: z.object({
+        startHour: z.number().int().min(0).max(23).default(2),
+        endHour: z.number().int().min(0).max(23).default(5),
+    }).default({ startHour: 2, endHour: 5 }),
+    /** Required real machine idle time before scheduled Dream can run. */
+    systemIdleMinutes: z.number().int().min(1).default(30),
+    /** Minimum new or changed memories since the last successful run. */
+    minNewMemoriesToDream: z.number().int().min(0).default(10),
+    /** Cooldown between scheduled Dream runs. */
+    minHoursBetweenRuns: z.number().int().min(0).default(20),
+    /** Hard cap on paid LLM calls in a single Dream run. */
+    maxLLMCallsPerRun: z.number().int().min(0).default(12),
 });
 // ─── Recall Schema ─────────────────────────────────────────────────────
 const RecallConfigSchema = z.object({
@@ -177,6 +199,7 @@ export const GnosysConfigSchema = z.object({
         lmstudio: { model: "default", baseUrl: "http://localhost:1234/v1" },
         xai: { model: "grok-4.20" },
         mistral: { model: "mistral-small-4" },
+        openrouter: { model: "nvidia/nemotron-3-super-120b-a12b:free", baseUrl: "https://openrouter.ai/api/v1" },
     }),
     /** Task-specific model overrides */
     taskModels: TaskModelsSchema.default({}),
@@ -227,6 +250,11 @@ export const GnosysConfigSchema = z.object({
         generateSummaries: true,
         discoverRelationships: true,
         minMemories: 10,
+        schedule: { startHour: 2, endHour: 5 },
+        systemIdleMinutes: 30,
+        minNewMemoriesToDream: 10,
+        minHoursBetweenRuns: 20,
+        maxLLMCallsPerRun: 12,
     }),
     /** Chat TUI — interactive chat configuration (v5.8.0) */
     chat: ChatConfigSchema.default({
@@ -282,67 +310,22 @@ export function getProviderModel(config, provider) {
         case "lmstudio": return config.llm.lmstudio.model;
         case "xai": return config.llm.xai.model;
         case "mistral": return config.llm.mistral.model;
+        case "openrouter": return config.llm.openrouter.model;
         case "custom": return config.llm.custom?.model || "";
         default: return config.llm.anthropic.model;
     }
 }
 /**
- * Resolve an API key from multiple sources in priority order:
- * 1. Config (gnosys.json)
- * 2. GNOSYS_<PROVIDER>_KEY env var (new convention)
- * 3. macOS Keychain (if on macOS)
- * 4. Legacy env var (ANTHROPIC_API_KEY, etc.)
- * 5. ~/.config/gnosys/.env (read at startup)
- */
-function resolveApiKey(configKey, gnosysEnvVar, legacyEnvVar) {
-    // 1. Config value
-    if (configKey)
-        return configKey;
-    // 2. New GNOSYS_*_KEY env var
-    if (process.env[gnosysEnvVar])
-        return process.env[gnosysEnvVar];
-    // Skip keychain lookups inside vitest — test env can't differentiate
-    // a real keychain entry from a stubbed env var, so tests asserting "no
-    // key configured" leak the developer's actual keys.
-    const inTest = !!process.env.VITEST;
-    // 3. macOS Keychain
-    if (!inTest && process.platform === "darwin") {
-        try {
-            const result = execSync(`security find-generic-password -a "$USER" -s "${gnosysEnvVar}" -w 2>/dev/null`, { stdio: "pipe", encoding: "utf-8", timeout: 2000 }).trim();
-            if (result)
-                return result;
-        }
-        catch {
-            // Not in keychain — fall through
-        }
-    }
-    // 4. Linux GNOME Keyring (secret-tool)
-    if (!inTest && process.platform === "linux") {
-        try {
-            const result = execSync(`secret-tool lookup service gnosys account ${gnosysEnvVar} 2>/dev/null`, { stdio: "pipe", encoding: "utf-8", timeout: 2000 }).trim();
-            if (result)
-                return result;
-        }
-        catch {
-            // secret-tool not installed or no entry — fall through
-        }
-    }
-    // 5. Legacy env var
-    if (legacyEnvVar && process.env[legacyEnvVar])
-        return process.env[legacyEnvVar];
-    return undefined;
-}
-/**
- * Get the Groq API key, checking config first then env var.
+ * Get the Groq API key (global → provider → legacy env).
  */
 export function getGroqApiKey(config) {
-    return resolveApiKey(config.llm.groq.apiKey, "GNOSYS_GROQ_KEY", "GROQ_API_KEY");
+    return getApiKeyForProviderFromConfig(config, "groq");
 }
 /**
- * Get the OpenAI API key, checking config first then env var.
+ * Get the OpenAI API key (global → provider → legacy env).
  */
 export function getOpenAIApiKey(config) {
-    return resolveApiKey(config.llm.openai.apiKey, "GNOSYS_OPENAI_KEY", "OPENAI_API_KEY");
+    return getApiKeyForProviderFromConfig(config, "openai");
 }
 /**
  * Get the OpenAI base URL from config.
@@ -360,7 +343,7 @@ export function getLMStudioBaseUrl(config) {
  * Get the Anthropic API key, checking config first then env var.
  */
 export function getAnthropicApiKey(config) {
-    return resolveApiKey(config.llm.anthropic.apiKey, "GNOSYS_ANTHROPIC_KEY", "ANTHROPIC_API_KEY");
+    return getApiKeyForProviderFromConfig(config, "anthropic");
 }
 /**
  * Get the Ollama base URL from config.
@@ -372,19 +355,31 @@ export function getOllamaBaseUrl(config) {
  * Get the xAI API key, checking config first then env var.
  */
 export function getXAIApiKey(config) {
-    return resolveApiKey(config.llm.xai.apiKey, "GNOSYS_XAI_KEY", "XAI_API_KEY");
+    return getApiKeyForProviderFromConfig(config, "xai");
 }
 /**
  * Get the Mistral API key, checking config first then env var.
  */
 export function getMistralApiKey(config) {
-    return resolveApiKey(config.llm.mistral.apiKey, "GNOSYS_MISTRAL_KEY", "MISTRAL_API_KEY");
+    return getApiKeyForProviderFromConfig(config, "mistral");
+}
+/**
+ * Get the OpenRouter API key, checking config first then env var.
+ */
+export function getOpenRouterApiKey(config) {
+    return getApiKeyForProviderFromConfig(config, "openrouter");
+}
+/**
+ * Get the OpenRouter API base URL from config.
+ */
+export function getOpenRouterBaseUrl(config) {
+    return config.llm.openrouter.baseUrl;
 }
 /**
  * Get the Custom provider API key, checking config first then env var.
  */
 export function getCustomApiKey(config) {
-    return resolveApiKey(config.llm.custom?.apiKey, "GNOSYS_CUSTOM_KEY", "GNOSYS_LLM_API_KEY");
+    return getApiKeyForProviderFromConfig(config, "custom");
 }
 // ─── Migration ───────────────────────────────────────────────────────────
 /**
@@ -578,6 +573,10 @@ export function generateConfigTemplate() {
             lmstudio: { model: "default", baseUrl: "http://localhost:1234/v1" },
             xai: { model: "grok-4.20" },
             mistral: { model: "mistral-small-4" },
+            openrouter: {
+                model: "nvidia/nemotron-3-super-120b-a12b:free",
+                baseUrl: "https://openrouter.ai/api/v1",
+            },
         },
         taskModels: {},
         bulkIngestionBatchSize: 500,
@@ -617,4 +616,6 @@ export function generateConfigTemplate() {
 /**
  * All supported provider names.
  */
-export const ALL_PROVIDERS = ["anthropic", "ollama", "groq", "openai", "lmstudio", "xai", "mistral", "custom"];
+export const ALL_PROVIDERS = [
+    "anthropic", "ollama", "groq", "openai", "lmstudio", "xai", "mistral", "openrouter", "custom",
+];

package/dist/lib/configCommand.d.ts

@@ -0,0 +1,10 @@
+import type { GnosysResolver } from "./resolver.js";
+type GetResolver = () => Promise<GnosysResolver>;
+export declare function runConfigShowCommand(getResolver: GetResolver, opts: {
+    json?: boolean;
+}): Promise<void>;
+export declare function runConfigSetCommand(getResolver: GetResolver, key: string, value: string, extra: string[]): Promise<void>;
+export declare function runConfigInitCommand(getResolver: GetResolver, opts: {
+    force?: boolean;
+}): Promise<void>;
+export {};