hoomanjs 1.33.0 → 1.35.0

package/dist/core/config.d.ts

@@ -1,60 +1,119 @@
 import { z } from "zod";
-/** LLM backend; extend as you add providers. */
-export declare enum LlmProvider {
-    Anthropic = "anthropic",
-    Bifrost = "bifrost",
-    Google = "google",
-    Groq = "groq",
-    Moonshot = "moonshot",
-    OpenAI = "openai",
-    Ollama = "ollama",
-    Bedrock = "bedrock",
-    TensorZero = "tensorzero",
-    Xai = "xai"
-}
-declare const ResolvedLlmSchema: z.ZodObject<{
-    provider: z.ZodEnum<typeof LlmProvider>;
-    model: z.ZodString;
-    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-}, z.core.$strip>;
-declare const ProviderSchema: z.ZodObject<{
-    provider: z.ZodEnum<typeof LlmProvider>;
-    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-}, z.core.$strip>;
-declare const NamedProviderSchema: z.ZodObject<{
-    name: z.ZodString;
-    options: z.ZodObject<{
-        provider: z.ZodEnum<typeof LlmProvider>;
-        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-declare const NamedLlmSchema: z.ZodObject<{
-    name: z.ZodString;
-    options: z.ZodObject<{
-        provider: z.ZodString;
-        model: z.ZodString;
-        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    }, z.core.$strip>;
-    default: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
+import { LlmProvider, type LlmOptions, type NamedLlmConfig, type NamedProviderConfig, type ProviderOptions } from "./models/types.js";
 declare const ConfigSchema: z.ZodPipe<z.ZodObject<{
     name: z.ZodString;
-    providers: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    providers: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Anthropic>;
+        options: z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            thinking: z.ZodOptional<z.ZodEnum<{
+                disabled: "disabled";
+                adaptive: "adaptive";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Azure>;
+        options: z.ZodObject<{
+            resourceName: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            apiKey: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            apiVersion: z.ZodOptional<z.ZodString>;
+            useDeploymentBasedUrls: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Bedrock>;
+        options: z.ZodObject<{
+            region: z.ZodOptional<z.ZodString>;
+            accessKeyId: z.ZodOptional<z.ZodString>;
+            secretAccessKey: z.ZodOptional<z.ZodString>;
+            sessionToken: z.ZodOptional<z.ZodString>;
+            apiKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Google>;
+        options: z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Groq>;
+        options: z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Minimax>;
+        options: z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            thinking: z.ZodOptional<z.ZodEnum<{
+                disabled: "disabled";
+                adaptive: "adaptive";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
         name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Moonshot>;
         options: z.ZodObject<{
-            provider: z.ZodEnum<typeof LlmProvider>;
-            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        }, z.core.$strip>;
-    }, z.core.$strip>>>>;
+            apiKey: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Ollama>;
+        options: z.ZodObject<{
+            baseURL: z.ZodOptional<z.ZodString>;
+            thinking: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>]>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.OpenAI>;
+        options: z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.OpenRouter>;
+        options: z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodLiteral<LlmProvider.Xai>;
+        options: z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "provider">>;
     llms: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
+        provider: z.ZodString;
         options: z.ZodObject<{
-            provider: z.ZodString;
             model: z.ZodString;
-            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        }, z.core.$strip>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
         default: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     search: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
         provider: z.ZodOptional<z.ZodEnum<{
@@ -102,36 +161,115 @@ declare const ConfigSchema: z.ZodPipe<z.ZodObject<{
         sleep: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
-        agents: z.ZodOptional<z.ZodObject<{
+        subagents: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
-            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
-    compaction: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    compaction: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         ratio: z.ZodOptional<z.ZodNumber>;
         keep: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>>, z.ZodTransform<{
-        ratio: number;
-        keep: number;
-    }, {
-        ratio?: number | undefined;
-        keep?: number | undefined;
-    } | null | undefined>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodTransform<{
     name: string;
-    providers: {
+    providers: ({
         name: string;
+        provider: LlmProvider.Anthropic;
         options: {
-            provider: LlmProvider;
-            params: Record<string, any>;
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            thinking?: "disabled" | "adaptive" | undefined;
         };
-    }[];
+    } | {
+        name: string;
+        provider: LlmProvider.Azure;
+        options: {
+            resourceName?: string | undefined;
+            baseURL?: string | undefined;
+            apiKey?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            apiVersion?: string | undefined;
+            useDeploymentBasedUrls?: boolean | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Bedrock;
+        options: {
+            region?: string | undefined;
+            accessKeyId?: string | undefined;
+            secretAccessKey?: string | undefined;
+            sessionToken?: string | undefined;
+            apiKey?: string | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Google;
+        options: {
+            apiKey?: string | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Groq;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Minimax;
+        options: {
+            apiKey?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            thinking?: "disabled" | "adaptive" | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Moonshot;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Ollama;
+        options: {
+            baseURL?: string | undefined;
+            thinking?: boolean | "high" | "medium" | "low" | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.OpenAI;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.OpenRouter;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Xai;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    })[];
     llms: {
         name: string;
+        provider: string;
         options: {
-            provider: string;
             model: string;
-            params: Record<string, any>;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
         };
         default: boolean;
     }[];
@@ -176,9 +314,8 @@ declare const ConfigSchema: z.ZodPipe<z.ZodObject<{
         sleep: {
             enabled: boolean;
         };
-        agents: {
+        subagents: {
             enabled: boolean;
-            concurrency: number;
         };
     };
     compaction: {
@@ -187,26 +324,108 @@ declare const ConfigSchema: z.ZodPipe<z.ZodObject<{
     };
 }, {
     name: string;
+    providers: ({
+        name: string;
+        provider: LlmProvider.Anthropic;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            thinking?: "disabled" | "adaptive" | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Azure;
+        options: {
+            resourceName?: string | undefined;
+            baseURL?: string | undefined;
+            apiKey?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            apiVersion?: string | undefined;
+            useDeploymentBasedUrls?: boolean | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Bedrock;
+        options: {
+            region?: string | undefined;
+            accessKeyId?: string | undefined;
+            secretAccessKey?: string | undefined;
+            sessionToken?: string | undefined;
+            apiKey?: string | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Google;
+        options: {
+            apiKey?: string | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Groq;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Minimax;
+        options: {
+            apiKey?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            thinking?: "disabled" | "adaptive" | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Moonshot;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Ollama;
+        options: {
+            baseURL?: string | undefined;
+            thinking?: boolean | "high" | "medium" | "low" | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.OpenAI;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.OpenRouter;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    } | {
+        name: string;
+        provider: LlmProvider.Xai;
+        options: {
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        };
+    })[];
     llms: {
         name: string;
+        provider: string;
         options: {
-            provider: string;
             model: string;
-            params: Record<string, any>;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
         };
         default: boolean;
     }[];
-    compaction: {
-        ratio: number;
-        keep: number;
-    };
-    providers?: {
-        name: string;
-        options: {
-            provider: LlmProvider;
-            params: Record<string, any>;
-        };
-    }[] | null | undefined;
     search?: {
         enabled?: boolean | undefined;
         provider?: "brave" | "exa" | "firecrawl" | "serper" | "tavily" | undefined;
@@ -248,30 +467,43 @@ declare const ConfigSchema: z.ZodPipe<z.ZodObject<{
         sleep?: {
             enabled?: boolean | undefined;
         } | undefined;
-        agents?: {
+        subagents?: {
             enabled?: boolean | undefined;
-            concurrency?: number | undefined;
         } | undefined;
     } | null | undefined;
+    compaction?: {
+        ratio?: number | undefined;
+        keep?: number | undefined;
+    } | null | undefined;
 }>>;
 export type ConfigData = z.infer<typeof ConfigSchema>;
-export type ProviderConfig = z.infer<typeof ProviderSchema>;
-export type NamedProviderConfig = z.infer<typeof NamedProviderSchema>;
-export type LlmConfig = z.infer<typeof ResolvedLlmSchema>;
-export type NamedLlmConfig = z.infer<typeof NamedLlmSchema>;
+export type ProviderConfig = ProviderOptions;
+export type LlmConfig = {
+    provider: LlmProvider;
+    providerOptions: ProviderOptions;
+    llmOptions: LlmOptions;
+};
 export type ResolvedNamedLlmConfig = {
     name: string;
-    options: LlmConfig;
+    provider: LlmProvider;
+    providerOptions: ProviderOptions;
+    llmOptions: LlmOptions;
     default: boolean;
 };
 export type CompactionConfig = ConfigData["compaction"];
 export type PromptsConfig = ConfigData["prompts"];
 export type SearchConfig = ConfigData["search"];
 export type ToolsConfig = ConfigData["tools"];
+export type ConfigOptions = {
+    overlayPaths?: readonly string[];
+};
+export { LlmProvider };
+export type { NamedLlmConfig, NamedProviderConfig };
 export declare class Config {
     private data;
     private readonly path;
-    constructor(path: string);
+    private readonly overlayPaths;
+    constructor(path: string, options?: ConfigOptions);
     get name(): string;
     private resolveNamedLlm;
     get providers(): NamedProviderConfig[];
@@ -284,8 +516,8 @@ export declare class Config {
     get tools(): ToolsConfig;
     get compaction(): CompactionConfig;
     private readJson;
+    private readOverlay;
     reload(): void;
     persist(): void;
     update(partial: Partial<ConfigData>): void;
 }
-export {};