@matthias-hausberger/beige 0.0.1

package/dist/config/loader.js

@@ -0,0 +1,103 @@
+import { readFileSync, existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { homedir } from "os";
+import JSON5 from "json5";
+import { validateConfig } from "./schema.js";
+const TOOLKIT_MARK = "_toolkit";
+function loadToolkitRegistry() {
+    const registryPath = resolve(homedir(), ".beige", "toolkit-registry.json");
+    if (!existsSync(registryPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(registryPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function mergeToolkitTools(config, configDir) {
+    const registry = loadToolkitRegistry();
+    if (!registry) {
+        return;
+    }
+    for (const [toolkitName, toolkit] of Object.entries(registry.toolkits)) {
+        for (const toolName of toolkit.tools) {
+            if (config.tools[toolName]) {
+                continue;
+            }
+            const toolPath = resolve(toolkit.path, "tools", toolName);
+            const toolConfig = {
+                path: toolPath,
+                target: "gateway",
+                [TOOLKIT_MARK]: toolkitName,
+            };
+            config.tools[toolName] = toolConfig;
+        }
+    }
+}
+/**
+ * Resolve environment variable references in strings.
+ * Supports ${VAR_NAME} syntax. Throws if a referenced var is not set.
+ */
+function resolveEnvVars(value) {
+    if (typeof value === "string") {
+        return value.replace(/\$\{([^}]+)\}/g, (match, varName) => {
+            const envValue = process.env[varName];
+            if (envValue === undefined) {
+                throw new Error(`Environment variable '${varName}' is not set (referenced in config)`);
+            }
+            return envValue;
+        });
+    }
+    if (Array.isArray(value)) {
+        return value.map(resolveEnvVars);
+    }
+    if (value !== null && typeof value === "object") {
+        const result = {};
+        for (const [k, v] of Object.entries(value)) {
+            result[k] = resolveEnvVars(v);
+        }
+        return result;
+    }
+    return value;
+}
+/**
+ * Resolve relative tool paths against the config file directory.
+ */
+function resolveToolPaths(config, configDir) {
+    for (const tool of Object.values(config.tools)) {
+        if (tool.path && !tool.path.startsWith("/")) {
+            tool.path = resolve(configDir, tool.path);
+        }
+    }
+}
+/**
+ * Resolve relative skill paths against the config file directory.
+ */
+function resolveSkillPaths(config, configDir) {
+    if (!config.skills)
+        return;
+    for (const skill of Object.values(config.skills)) {
+        if (skill.path && !skill.path.startsWith("/")) {
+            skill.path = resolve(configDir, skill.path);
+        }
+    }
+}
+/**
+ * Load and validate a beige config file (JSON5 format).
+ */
+export function loadConfig(configPath) {
+    const absolutePath = resolve(configPath);
+    const configDir = dirname(absolutePath);
+    const raw = readFileSync(absolutePath, "utf-8");
+    const parsed = JSON5.parse(raw);
+    const resolved = resolveEnvVars(parsed);
+    const config = validateConfig(resolved);
+    resolveToolPaths(config, configDir);
+    resolveSkillPaths(config, configDir);
+    mergeToolkitTools(config, configDir);
+    return config;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/loader.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loader.spec.d.ts.map

package/dist/config/loader.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.spec.d.ts","sourceRoot":"","sources":["../../src/config/loader.spec.ts"],"names":[],"mappings":""}

package/dist/config/loader.spec.js

@@ -0,0 +1,195 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { writeFileSync, mkdirSync, rmSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+import { loadConfig } from "./loader.js";
+describe("loadConfig", () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = join(tmpdir(), `beige-test-${Date.now()}`);
+        mkdirSync(tempDir, { recursive: true });
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    describe("JSON5 parsing", () => {
+        it("parses valid JSON5 with comments", () => {
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          // This is a comment
+          llm: {
+            providers: {
+              anthropic: { apiKey: "test-key" },
+            },
+          },
+          tools: {},
+          agents: {
+            /* Multi-line
+               comment */
+            assistant: {
+              model: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+              tools: [],
+            },
+          },
+          channels: {},
+        }
+      `);
+            const config = loadConfig(configPath);
+            expect(config.llm.providers.anthropic.apiKey).toBe("test-key");
+            expect(config.agents.assistant).toBeDefined();
+        });
+        it("parses unquoted keys", () => {
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: { anthropic: { apiKey: "test" } } },
+          tools: {},
+          agents: { assistant: { model: { provider: "anthropic", model: "claude" }, tools: [] } },
+          channels: {},
+        }
+      `);
+            const config = loadConfig(configPath);
+            expect(config.llm.providers.anthropic).toBeDefined();
+        });
+        it("parses trailing commas", () => {
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: { anthropic: { apiKey: "test", }, }, },
+          tools: {},
+          agents: {
+            assistant: { model: { provider: "anthropic", model: "claude", }, tools: [], },
+          },
+          channels: {},
+        }
+      `);
+            const config = loadConfig(configPath);
+            expect(config.llm.providers.anthropic.apiKey).toBe("test");
+        });
+    });
+    describe("environment variable resolution", () => {
+        it("resolves ${ENV_VAR} references", () => {
+            process.env.TEST_API_KEY = "my-secret-key";
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: { anthropic: { apiKey: "\${TEST_API_KEY}" } } },
+          tools: {},
+          agents: { assistant: { model: { provider: "anthropic", model: "claude" }, tools: [] } },
+          channels: {},
+        }
+      `);
+            const config = loadConfig(configPath);
+            expect(config.llm.providers.anthropic.apiKey).toBe("my-secret-key");
+            delete process.env.TEST_API_KEY;
+        });
+        it("resolves env vars in nested objects", () => {
+            process.env.TEST_TOKEN = "bot-token-123";
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: { anthropic: { apiKey: "test" } } },
+          tools: {},
+          agents: { assistant: { model: { provider: "anthropic", model: "claude" }, tools: [] } },
+          channels: {
+            telegram: {
+              enabled: true,
+              token: "\${TEST_TOKEN}",
+              allowedUsers: [123],
+              agentMapping: { default: "assistant" },
+            },
+          },
+        }
+      `);
+            const config = loadConfig(configPath);
+            expect(config.channels.telegram?.token).toBe("bot-token-123");
+            delete process.env.TEST_TOKEN;
+        });
+        it("throws when env var is not set", () => {
+            delete process.env.NONEXISTENT_VAR;
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: { anthropic: { apiKey: "\${NONEXISTENT_VAR}" } } },
+          tools: {},
+          agents: { assistant: { model: { provider: "anthropic", model: "claude" }, tools: [] } },
+          channels: {},
+        }
+      `);
+            expect(() => loadConfig(configPath)).toThrow("NONEXISTENT_VAR");
+        });
+        it("resolves env vars in arrays", () => {
+            process.env.ALLOWED_USER = "999888";
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: { anthropic: { apiKey: "test" } } },
+          tools: {},
+          agents: { assistant: { model: { provider: "anthropic", model: "claude" }, tools: [] } },
+          channels: {
+            telegram: {
+              enabled: true,
+              token: "test",
+              allowedUsers: [123, "\${ALLOWED_USER}"],
+              agentMapping: { default: "assistant" },
+            },
+          },
+        }
+      `);
+            const config = loadConfig(configPath);
+            // Note: JSON5 parses strings in number arrays as strings
+            // The actual validation would convert these
+            expect(config.channels.telegram?.allowedUsers).toContain("999888");
+            delete process.env.ALLOWED_USER;
+        });
+    });
+    describe("path resolution", () => {
+        it("resolves relative tool paths against config directory", () => {
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: { anthropic: { apiKey: "test" } } },
+          tools: {
+            mytool: { path: "./tools/mytool", target: "gateway" },
+          },
+          agents: { assistant: { model: { provider: "anthropic", model: "claude" }, tools: ["mytool"] } },
+          channels: {},
+        }
+      `);
+            const config = loadConfig(configPath);
+            expect(config.tools.mytool.path).toBe(join(tempDir, "tools/mytool"));
+        });
+        it("keeps absolute tool paths unchanged", () => {
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: { anthropic: { apiKey: "test" } } },
+          tools: {
+            mytool: { path: "/absolute/path/to/tool", target: "gateway" },
+          },
+          agents: { assistant: { model: { provider: "anthropic", model: "claude" }, tools: ["mytool"] } },
+          channels: {},
+        }
+      `);
+            const config = loadConfig(configPath);
+            expect(config.tools.mytool.path).toBe("/absolute/path/to/tool");
+        });
+    });
+    describe("validation", () => {
+        it("validates config schema after loading", () => {
+            const configPath = join(tempDir, "config.json5");
+            writeFileSync(configPath, `
+        {
+          llm: { providers: {} },
+          tools: {},
+          agents: {},
+          channels: {},
+        }
+      `);
+            // Should not throw - empty providers/agents is valid
+            expect(() => loadConfig(configPath)).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=loader.spec.js.map

package/dist/config/loader.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.spec.js","sourceRoot":"","sources":["../../src/config/loader.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAc,MAAM,IAAI,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACrD,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;;;;;;;;;;;;;OAmBzB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;OAOzB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;;;OASzB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC/C,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,eAAe,CAAC;YAE3C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;OAOzB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAEpE,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,eAAe,CAAC;YAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;;;;;;;;OAczB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAE9D,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;YAEnC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;OAOzB,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,QAAQ,CAAC;YAEpC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;;;;;;;;OAczB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,yDAAyD;YACzD,4CAA4C;YAC5C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAEnE,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;;;OASzB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;;;OASzB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,aAAa,CAAC,UAAU,EAAE;;;;;;;OAOzB,CAAC,CAAC;YAEH,qDAAqD;YACrD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Beige configuration schema.
+ * Config is loaded from a YAML file. Environment variables are resolved at load time.
+ */
+export interface BeigeConfig {
+    llm: LLMConfig;
+    tools: Record<string, ToolConfig>;
+    skills?: Record<string, SkillConfig>;
+    agents: Record<string, AgentConfig>;
+    gateway?: GatewayServerConfig;
+    channels: ChannelsConfig;
+}
+export interface LLMConfig {
+    providers: Record<string, LLMProviderConfig>;
+}
+export interface LLMProviderConfig {
+    apiKey: string;
+    baseUrl?: string;
+    api?: string;
+}
+export interface ToolConfig {
+    /** Path to the tool package directory (relative to config file) */
+    path: string;
+    /** Where the tool handler executes */
+    target: "gateway" | "sandbox";
+    /** Arbitrary tool-specific configuration */
+    config?: Record<string, unknown>;
+    /** Internal: marks tools auto-loaded from toolkits */
+    _toolkit?: string;
+}
+export interface SkillConfig {
+    /** Path to the skill package directory (relative to config file) */
+    path: string;
+}
+export interface SkillManifest {
+    name: string;
+    description: string;
+    /** Default: "README.md" */
+    contextFile?: string;
+    requires?: {
+        tools?: string[];
+        skills?: string[];
+    };
+}
+export interface AgentConfig {
+    model: ModelRef;
+    /** Fallback models to try if the primary fails (after retries exhausted) */
+    fallbackModels?: ModelRef[];
+    /** List of tool names from the tools registry that this agent can use */
+    tools: string[];
+    /** List of skill names from the skills registry that this agent can use */
+    skills?: string[];
+    sandbox?: SandboxConfig;
+}
+export interface ModelRef {
+    provider: string;
+    model: string;
+    thinkingLevel?: "off" | "minimal" | "low" | "medium" | "high";
+}
+export interface SandboxConfig {
+    image?: string;
+    extraMounts?: Record<string, string>;
+    extraEnv?: Record<string, string>;
+}
+export interface GatewayServerConfig {
+    host?: string;
+    port?: number;
+    logFile?: string;
+}
+export interface ChannelsConfig {
+    telegram?: TelegramChannelConfig;
+}
+/**
+ * Channel-level default settings. These can be overridden per-session
+ * by the user (e.g. via Telegram commands or TUI slash commands).
+ */
+export interface ChannelDefaultSettings {
+    /**
+     * If true, the channel is notified whenever the agent calls a tool
+     * (e.g. "🔧 exec: ls -la"). Default: false.
+     */
+    verbose?: boolean;
+    /**
+     * If true, responses are streamed to the user in real-time (message updates
+     * as the LLM generates). If false, the full response is sent once complete.
+     * Default: true.
+     */
+    streaming?: boolean;
+}
+export interface TelegramChannelConfig {
+    enabled: boolean;
+    token: string;
+    allowedUsers: number[];
+    agentMapping: {
+        default: string;
+    };
+    /** Channel-level setting defaults (overridable per-session). */
+    defaults?: ChannelDefaultSettings;
+}
+export interface ToolManifest {
+    name: string;
+    description: string;
+    commands?: string[];
+    target: "gateway" | "sandbox";
+}
+export declare function validateConfig(config: unknown): BeigeConfig;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC5B,yEAAyE;IACzE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC/D;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;KAEjB,CAAC;IACF,gEAAgE;IAChE,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CA8C3D"}

package/dist/config/schema.js

@@ -0,0 +1,42 @@
+/**
+ * Beige configuration schema.
+ * Config is loaded from a YAML file. Environment variables are resolved at load time.
+ */
+export function validateConfig(config) {
+    const c = config;
+    if (!c.llm?.providers || typeof c.llm.providers !== "object") {
+        throw new Error("Config: llm.providers is required");
+    }
+    if (!c.tools || typeof c.tools !== "object") {
+        throw new Error("Config: tools is required");
+    }
+    if (!c.agents || typeof c.agents !== "object") {
+        throw new Error("Config: agents is required");
+    }
+    // Validate agent tool references
+    for (const [agentName, agent] of Object.entries(c.agents)) {
+        if (!agent.model?.provider || !agent.model?.model) {
+            throw new Error(`Config: agents.${agentName}.model requires provider and model`);
+        }
+        for (const toolName of agent.tools) {
+            if (!c.tools[toolName]) {
+                throw new Error(`Config: agent '${agentName}' references unknown tool '${toolName}'`);
+            }
+        }
+        // Validate agent skill references
+        for (const skillName of agent.skills ?? []) {
+            if (!c.skills?.[skillName]) {
+                throw new Error(`Config: agent '${agentName}' references unknown skill '${skillName}'`);
+            }
+        }
+    }
+    // Validate channel agent references
+    if (c.channels?.telegram?.enabled) {
+        const defaultAgent = c.channels.telegram.agentMapping?.default;
+        if (defaultAgent && !c.agents[defaultAgent]) {
+            throw new Error(`Config: telegram.agentMapping.default references unknown agent '${defaultAgent}'`);
+        }
+    }
+    return c;
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyHH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,MAAM,CAAC,GAAG,MAAqB,CAAC;IAEhC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,iCAAiC;IACjC,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,kBAAkB,SAAS,oCAAoC,CAAC,CAAC;QACnF,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,kBAAkB,SAAS,8BAA8B,QAAQ,GAAG,CACrE,CAAC;YACJ,CAAC;QACH,CAAC;QACD,kCAAkC;QAClC,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,kBAAkB,SAAS,+BAA+B,SAAS,GAAG,CACvE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;QAC/D,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,mEAAmE,YAAY,GAAG,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/config/schema.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.spec.d.ts.map

package/dist/config/schema.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.spec.d.ts","sourceRoot":"","sources":["../../src/config/schema.spec.ts"],"names":[],"mappings":""}

package/dist/config/schema.spec.js

@@ -0,0 +1,180 @@
+import { describe, it, expect } from "vitest";
+import { validateConfig } from "./schema.js";
+import { createMinimalConfig, createFullConfig } from "../test/fixtures.js";
+describe("validateConfig", () => {
+    describe("valid configs", () => {
+        it("accepts minimal valid config", () => {
+            const config = createMinimalConfig();
+            expect(() => validateConfig(config)).not.toThrow();
+        });
+        it("accepts full config with tools and multiple agents", () => {
+            const config = createFullConfig();
+            expect(() => validateConfig(config)).not.toThrow();
+        });
+        it("accepts config with fallback models", () => {
+            const config = createMinimalConfig({
+                agents: {
+                    assistant: {
+                        model: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+                        fallbackModels: [
+                            { provider: "openai", model: "gpt-4o" },
+                        ],
+                        tools: [],
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).not.toThrow();
+        });
+        it("accepts config with thinking level", () => {
+            const config = createMinimalConfig({
+                agents: {
+                    assistant: {
+                        model: {
+                            provider: "anthropic",
+                            model: "claude-sonnet-4-20250514",
+                            thinkingLevel: "high",
+                        },
+                        tools: [],
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).not.toThrow();
+        });
+        it("accepts config with sandbox options", () => {
+            const config = createMinimalConfig({
+                agents: {
+                    assistant: {
+                        model: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+                        tools: [],
+                        sandbox: {
+                            image: "custom-sandbox:v1",
+                            extraMounts: { "/host/path": "/container/path" },
+                            extraEnv: { DEBUG: "true" },
+                        },
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).not.toThrow();
+        });
+        it("accepts config with gateway settings", () => {
+            const config = createMinimalConfig({
+                gateway: {
+                    host: "0.0.0.0",
+                    port: 8080,
+                    logFile: "/var/log/beige.log",
+                },
+            });
+            expect(() => validateConfig(config)).not.toThrow();
+        });
+    });
+    describe("missing required fields", () => {
+        it("throws when llm.providers is missing", () => {
+            const config = { ...createMinimalConfig(), llm: {} };
+            expect(() => validateConfig(config)).toThrow("llm.providers is required");
+        });
+        it("throws when tools is missing", () => {
+            const { tools, ...config } = createMinimalConfig();
+            expect(() => validateConfig(config)).toThrow("tools is required");
+        });
+        it("throws when agents is missing", () => {
+            const { agents, ...config } = createMinimalConfig();
+            expect(() => validateConfig(config)).toThrow("agents is required");
+        });
+    });
+    describe("agent validation", () => {
+        it("throws when agent model.provider is missing", () => {
+            const config = createMinimalConfig({
+                agents: {
+                    assistant: {
+                        model: { provider: "", model: "claude-sonnet-4-20250514" },
+                        tools: [],
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).toThrow("model requires provider");
+        });
+        it("throws when agent model.model is missing", () => {
+            const config = createMinimalConfig({
+                agents: {
+                    assistant: {
+                        model: { provider: "anthropic", model: "" },
+                        tools: [],
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).toThrow("model requires provider and model");
+        });
+        it("throws when agent references unknown tool", () => {
+            const config = createMinimalConfig({
+                agents: {
+                    assistant: {
+                        model: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+                        tools: ["nonexistent-tool"],
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).toThrow("unknown tool 'nonexistent-tool'");
+        });
+        it("throws when agent references unknown skill", () => {
+            const config = createMinimalConfig({
+                skills: {
+                    "code-review": { path: "/skills/code-review" },
+                },
+                agents: {
+                    assistant: {
+                        model: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+                        tools: [],
+                        skills: ["nonexistent-skill"],
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).toThrow("unknown skill 'nonexistent-skill'");
+        });
+        it("accepts config with skills", () => {
+            const config = createMinimalConfig({
+                skills: {
+                    "code-review": { path: "/skills/code-review" },
+                    "testing": { path: "/skills/testing" },
+                },
+                agents: {
+                    assistant: {
+                        model: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+                        tools: [],
+                        skills: ["code-review", "testing"],
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).not.toThrow();
+        });
+    });
+    describe("channel validation", () => {
+        it("throws when telegram agentMapping.default references unknown agent", () => {
+            const config = createMinimalConfig({
+                channels: {
+                    telegram: {
+                        enabled: true,
+                        token: "test-token",
+                        allowedUsers: [123],
+                        agentMapping: { default: "nonexistent-agent" },
+                    },
+                },
+            });
+            expect(() => validateConfig(config)).toThrow("unknown agent 'nonexistent-agent'");
+        });
+        it("accepts disabled telegram channel even with invalid agent mapping", () => {
+            const config = createMinimalConfig({
+                channels: {
+                    telegram: {
+                        enabled: false,
+                        token: "test-token",
+                        allowedUsers: [123],
+                        agentMapping: { default: "nonexistent-agent" },
+                    },
+                },
+            });
+            // Disabled channels are not validated for agent references
+            expect(() => validateConfig(config)).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=schema.spec.js.map