@bryti/agent 0.0.1 → 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Config loading and validation.
+ *
+ * Loads config.yml from the data directory, substitutes ${ENV_VAR} references,
+ * and validates required fields at startup so misconfigurations fail early.
+ */
+import type { ActiveHoursConfig } from "./active-hours.js";
+export type { ActiveHoursConfig };
+export interface ProviderConfig {
+    name: string;
+    base_url: string;
+    api: string;
+    api_key: string;
+    models: ModelEntry[];
+}
+export interface ModelEntry {
+    id: string;
+    name?: string;
+    api?: string;
+    context_window?: number;
+    max_tokens?: number;
+    input?: ("text" | "image")[];
+    cost?: {
+        input: number;
+        output: number;
+    };
+    compat?: Record<string, unknown>;
+}
+export interface WorkerTypeConfig {
+    /** Description shown in the system prompt so the agent knows when to use this type. */
+    description?: string;
+    /** Model override for this worker type. */
+    model?: string;
+    /** Tools available to this worker type. Default: ["web_search", "fetch_url"]. */
+    tools?: string[];
+    /** Timeout in seconds. Default: 3600. */
+    timeout_seconds?: number;
+}
+export interface CronJob {
+    schedule: string;
+    message: string;
+}
+export interface Config {
+    agent: {
+        name: string;
+        /** Additional content prepended to the system prompt. Persona, standing
+         *  instructions, or context about the user. The framework adds memory,
+         *  tool descriptions, and all other sections automatically. */
+        system_prompt: string;
+        model: string;
+        /** Ordered list of fallback model strings to try when the primary fails. */
+        fallback_models: string[];
+        /** IANA timezone string, e.g. "Europe/Amsterdam". Injected into the system
+         *  prompt so the agent resolves relative time expressions correctly.
+         *  Defaults to UTC when omitted. */
+        timezone?: string;
+        /** Model to use for the reflection pass. Defaults to the primary model.
+         *  Use this to pick a cheaper model for background reflection without
+         *  affecting the main agent. Format: "provider/model-id". */
+        reflection_model?: string;
+    };
+    telegram: {
+        token: string;
+        allowed_users: number[];
+    };
+    whatsapp: {
+        enabled: boolean;
+        /** Phone numbers in international format without +, e.g. ["31612345678"] */
+        allowed_users: string[];
+    };
+    models: {
+        providers: ProviderConfig[];
+    };
+    tools: {
+        web_search: {
+            enabled: boolean;
+            /** SearXNG instance URL (no trailing slash). Workers only. */
+            searxng_url: string;
+            /** Brave Search API key. If set, used instead of SearXNG. Workers only. */
+            brave_api_key?: string;
+        };
+        fetch_url: {
+            timeout_ms: number;
+        };
+        files: {
+            base_dir: string;
+        };
+        workers: {
+            /** Maximum number of workers that may run concurrently. Default: 3. */
+            max_concurrent: number;
+            /** Default model for workers. Falls back to first fallback model, then primary. */
+            model?: string;
+            /** Named worker types with preset defaults. The agent can select a type
+             *  when dispatching to get its model, tools, and timeout without
+             *  specifying them individually. */
+            types?: Record<string, WorkerTypeConfig>;
+        };
+    };
+    /**
+     * Optional integrations. Each entry is injected into process.env at startup
+     * so extensions can read them without needing separate .env entries.
+     *
+     * Convention: integrations.<name>.<key> → env var NAME_KEY (uppercased, dots to underscores).
+     * Example: integrations.hedgedoc.url → HEDGEDOC_URL
+     */
+    integrations: Record<string, Record<string, string>>;
+    cron: CronJob[];
+    /** Optional active hours window. Scheduler callbacks skip firing outside it. */
+    active_hours?: ActiveHoursConfig;
+    /** Trust and permission settings. */
+    trust: {
+        /** Tools pre-approved for elevated access (skip permission prompts). */
+        approved_tools: string[];
+    };
+    data_dir: string;
+}
+/**
+ * Inject integration config values into process.env.
+ * Convention: integrations.<name>.<key> becomes <NAME>_<KEY> (uppercased).
+ * Existing env vars are never overwritten; .env always wins.
+ */
+export declare function applyIntegrationEnvVars(config: Config): void;
+export declare function loadConfig(configPath?: string): Config;
+/**
+ * Ensure data directories exist.
+ */
+export declare function ensureDataDirs(config: Config): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -0,0 +1,317 @@
+/**
+ * Config loading and validation.
+ *
+ * Loads config.yml from the data directory, substitutes ${ENV_VAR} references,
+ * and validates required fields at startup so misconfigurations fail early.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse as parseYaml } from "yaml";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+function toFiniteNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim()) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+function normalizeModelCost(cost) {
+    if (!cost || typeof cost !== "object") {
+        return undefined;
+    }
+    const raw = cost;
+    const hasAny = raw.input !== undefined || raw.output !== undefined;
+    if (!hasAny) {
+        return undefined;
+    }
+    return {
+        input: toFiniteNumber(raw.input) ?? 0,
+        output: toFiniteNumber(raw.output) ?? 0,
+    };
+}
+/**
+ * Replace ${VAR} references with values from process.env.
+ */
+function substituteEnvVars(text) {
+    // Only substitute uppercase env-style names (e.g. ${TELEGRAM_BOT_TOKEN}).
+    // This avoids clobbering template literals in prompt/examples like ${city}.
+    return text.replace(/\$\{([A-Z_][A-Z0-9_]*)\}/g, (_match, varName) => {
+        const value = process.env[varName];
+        if (value === undefined) {
+            throw new Error(`Environment variable ${varName} is not set`);
+        }
+        return value;
+    });
+}
+/**
+ * Recursively substitute env vars in all string values of an object.
+ */
+function substituteDeep(obj) {
+    if (typeof obj === "string") {
+        return substituteEnvVars(obj);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(substituteDeep);
+    }
+    if (obj !== null && typeof obj === "object") {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = substituteDeep(value);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Parse the integrations section, extracting string key-value pairs.
+ *
+ * Only string values are kept — nested objects, booleans, and numbers are
+ * ignored. Each entry's values can use ${ENV_VAR} substitution (already
+ * applied by substituteDeep before this is called).
+ */
+function integrationsFromConfig(substituted) {
+    const raw = (substituted.integrations ?? {});
+    const result = {};
+    for (const [name, entry] of Object.entries(raw)) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry))
+            continue;
+        const values = {};
+        for (const [key, value] of Object.entries(entry)) {
+            if (typeof value === "string") {
+                values[key] = value;
+            }
+        }
+        if (Object.keys(values).length > 0) {
+            result[name] = values;
+        }
+    }
+    return result;
+}
+/**
+ * Inject integration config values into process.env.
+ * Convention: integrations.<name>.<key> becomes <NAME>_<KEY> (uppercased).
+ * Existing env vars are never overwritten; .env always wins.
+ */
+export function applyIntegrationEnvVars(config) {
+    for (const [name, values] of Object.entries(config.integrations)) {
+        for (const [key, value] of Object.entries(values)) {
+            const envKey = `${name}_${key}`.toUpperCase().replace(/[^A-Z0-9]/g, "_");
+            if (process.env[envKey] === undefined) {
+                process.env[envKey] = value;
+            }
+        }
+    }
+}
+/**
+ * Parse the tools section of the substituted config, applying defaults.
+ */
+function toolsFromConfig(substituted, dataDir) {
+    const raw = (substituted.tools ?? {});
+    const webRaw = (raw.web_search ?? {});
+    return {
+        web_search: {
+            enabled: webRaw.enabled !== false,
+            searxng_url: webRaw.searxng_url ?? "https://searx.be",
+            brave_api_key: webRaw.brave_api_key ?? undefined,
+        },
+        fetch_url: {
+            timeout_ms: 10000,
+            ...raw.fetch_url,
+        },
+        files: {
+            base_dir: path.join(dataDir, "files"),
+            ...raw.files,
+        },
+        workers: {
+            max_concurrent: 3,
+            ...raw.workers,
+        },
+    };
+}
+export function loadConfig(configPath) {
+    const dataDir = path.resolve(process.env.BRYTI_DATA_DIR || "./data");
+    const cfgPath = configPath || path.join(dataDir, "config.yml");
+    if (!fs.existsSync(cfgPath)) {
+        throw new Error(`Config file not found: ${cfgPath}`);
+    }
+    const raw = fs.readFileSync(cfgPath, "utf-8");
+    const parsed = parseYaml(raw);
+    const substituted = substituteDeep(parsed);
+    // Defaults
+    const config = {
+        agent: {
+            name: "Bryti",
+            system_prompt: "You are a helpful personal assistant.",
+            model: "",
+            fallback_models: [],
+            ...substituted.agent,
+        },
+        telegram: {
+            token: "",
+            allowed_users: [],
+            ...substituted.telegram,
+        },
+        whatsapp: {
+            enabled: substituted.whatsapp?.enabled ?? false,
+            allowed_users: (substituted.whatsapp?.allowed_users ?? []).map(String),
+        },
+        models: {
+            providers: [],
+            ...substituted.models,
+        },
+        tools: toolsFromConfig(substituted, dataDir),
+        integrations: integrationsFromConfig(substituted),
+        cron: substituted.cron || [],
+        active_hours: substituted.active_hours ?? undefined,
+        trust: {
+            approved_tools: (substituted.trust?.approved_tools) ?? [],
+        },
+        data_dir: dataDir,
+    };
+    for (const provider of config.models.providers) {
+        provider.models = provider.models.map((model) => ({
+            ...model,
+            cost: normalizeModelCost(model.cost),
+        }));
+    }
+    // Validate
+    validateConfig(config);
+    return config;
+}
+/**
+ * Validate config at startup so bad config doesn't surface 30 minutes later
+ * when a cron job fires.
+ */
+function validateConfig(config) {
+    const errors = [];
+    const warnings = [];
+    // --- Required fields ---
+    if (!config.telegram.token && !config.whatsapp.enabled) {
+        errors.push("telegram.token is required (or enable whatsapp)");
+    }
+    if (!config.agent.model) {
+        errors.push("agent.model is required");
+    }
+    if (config.models.providers.length === 0) {
+        errors.push("at least one model provider is required");
+    }
+    // --- Primary model must be resolvable ---
+    if (config.agent.model) {
+        const [providerName] = config.agent.model.includes("/")
+            ? config.agent.model.split("/", 2)
+            : [config.agent.model];
+        const provider = config.models.providers.find((p) => p.name === providerName);
+        if (!provider) {
+            errors.push(`agent.model "${config.agent.model}" references provider "${providerName}" ` +
+                `which is not in models.providers. Available: ${config.models.providers.map((p) => p.name).join(", ")}`);
+        }
+    }
+    // --- Fallback models must reference known providers ---
+    for (const fb of config.agent.fallback_models ?? []) {
+        const [providerName] = fb.includes("/") ? fb.split("/", 2) : [fb];
+        const provider = config.models.providers.find((p) => p.name === providerName);
+        if (!provider) {
+            warnings.push(`fallback_model "${fb}" references unknown provider "${providerName}"`);
+        }
+    }
+    // --- WhatsApp needs allowed_users if enabled ---
+    if (config.whatsapp.enabled && config.whatsapp.allowed_users.length === 0) {
+        warnings.push("whatsapp is enabled but allowed_users is empty. " +
+            "Anyone who finds the bot's number can message it.");
+    }
+    // --- Web search needs a URL ---
+    if (config.tools.web_search.enabled && !config.tools.web_search.searxng_url) {
+        warnings.push("web_search is enabled but searxng_url is empty. Workers won't be able to search.");
+    }
+    // --- Emit ---
+    for (const w of warnings) {
+        console.warn(`Config warning: ${w}`);
+    }
+    if (errors.length > 0) {
+        throw new Error(`Config errors:\n  - ${errors.join("\n  - ")}`);
+    }
+}
+/**
+ * Ensure data directories exist.
+ */
+export function ensureDataDirs(config) {
+    const dirs = [
+        config.data_dir,
+        path.join(config.data_dir, "history"),
+        path.join(config.data_dir, "files"),
+        path.join(config.data_dir, "files", "extensions"),
+        path.join(config.data_dir, "usage"),
+        path.join(config.data_dir, "logs"),
+        path.join(config.data_dir, ".pi"),
+        path.join(config.data_dir, "pending"),
+        path.join(config.data_dir, "skills"),
+    ];
+    // WhatsApp auth directory (always create in case user adds WhatsApp later)
+    dirs.push(path.join(config.data_dir, "whatsapp-auth"));
+    for (const dir of dirs) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Write .pi/settings.json so pi discovers agent-written extensions.
+    // Pi's discoverAndLoadExtensions reads configuredPaths from settings and
+    // scans directories for .ts/.js files.
+    writeExtensionSettings(config);
+    // Seed default extensions into the user's extensions directory.
+    // Only copies when the target file does not exist.
+    // An empty file signals intentional deletion by the agent — never overwrite it.
+    seedDefaultExtensions(path.join(config.data_dir, "files", "extensions"));
+}
+/**
+ * Seed default extensions into the user's extensions directory.
+ *
+ * Only copies when the target file doesn't exist. Never overwrites. An empty
+ * file (0 bytes) is a tombstone meaning the agent intentionally deleted it;
+ * never replace those either.
+ */
+function seedDefaultExtensions(extensionsDir) {
+    // In production (dist/): defaults are copied alongside the compiled output.
+    // In development (src/ via ts-node or tsx): walk up to project root.
+    const defaultsDir = path.join(__dirname, "defaults", "extensions");
+    if (!fs.existsSync(defaultsDir)) {
+        return;
+    }
+    for (const filename of fs.readdirSync(defaultsDir)) {
+        const target = path.join(extensionsDir, filename);
+        // File already exists (including empty tombstone) — leave it alone.
+        if (fs.existsSync(target)) {
+            continue;
+        }
+        const source = path.join(defaultsDir, filename);
+        fs.copyFileSync(source, target);
+        console.log(`[extensions] seeded default: ${filename}`);
+    }
+}
+/**
+ * Write pi settings pointing to the agent's extension directory so pi
+ * discovers extensions the agent writes via file_write.
+ */
+function writeExtensionSettings(config) {
+    const settingsPath = path.join(config.data_dir, ".pi", "settings.json");
+    const extensionsDir = path.resolve(config.data_dir, "files", "extensions");
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+        }
+        catch {
+            // Corrupted settings, overwrite
+        }
+    }
+    const currentPaths = Array.isArray(settings.extensions) ? settings.extensions : [];
+    if (!currentPaths.includes(extensionsDir)) {
+        settings.extensions = [...currentPaths, extensionsDir];
+        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/crash-recovery.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Crash recovery: pending-message checkpoints.
+ *
+ * Before processing a user message, write a checkpoint to disk. If the process
+ * crashes mid-response, the next startup finds the checkpoint and notifies the
+ * user. Checkpoints are deleted after successful processing.
+ */
+import type { Config } from "./config.js";
+import type { IncomingMessage } from "./channels/types.js";
+export interface PendingCheckpoint {
+    text: string;
+    channelId: string;
+    platform: string;
+    timestamp: number;
+}
+export declare function writePendingCheckpoint(config: Config, msg: IncomingMessage): void;
+export declare function deletePendingCheckpoint(config: Config, userId: string): void;
+/**
+ * Scan for leftover pending files from a previous crash. Files between
+ * 2 min and 1 hour old get a notification; older ones are silently discarded.
+ */
+export declare function recoverPendingCheckpoints(config: Config, sendNotification: (checkpoint: PendingCheckpoint, userId: string) => Promise<void>): Promise<void>;
+//# sourceMappingURL=crash-recovery.d.ts.map

package/dist/crash-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crash-recovery.d.ts","sourceRoot":"","sources":["../src/crash-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAYjF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM5E;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACjF,OAAO,CAAC,IAAI,CAAC,CAyDf"}

package/dist/crash-recovery.js

@@ -0,0 +1,96 @@
+/**
+ * Crash recovery: pending-message checkpoints.
+ *
+ * Before processing a user message, write a checkpoint to disk. If the process
+ * crashes mid-response, the next startup finds the checkpoint and notifies the
+ * user. Checkpoints are deleted after successful processing.
+ */
+import fs from "node:fs";
+import path from "node:path";
+function pendingDir(config) {
+    return path.join(config.data_dir, "pending");
+}
+function pendingPath(config, userId) {
+    return path.join(pendingDir(config), `${userId}.json`);
+}
+export function writePendingCheckpoint(config, msg) {
+    const checkpoint = {
+        text: msg.text,
+        channelId: msg.channelId,
+        platform: msg.platform,
+        timestamp: Date.now(),
+    };
+    try {
+        fs.writeFileSync(pendingPath(config, msg.userId), JSON.stringify(checkpoint), "utf8");
+    }
+    catch (err) {
+        console.warn("[pending] Failed to write checkpoint:", err.message);
+    }
+}
+export function deletePendingCheckpoint(config, userId) {
+    try {
+        fs.rmSync(pendingPath(config, userId), { force: true });
+    }
+    catch (err) {
+        console.warn("[pending] Failed to delete checkpoint:", err.message);
+    }
+}
+/**
+ * Scan for leftover pending files from a previous crash. Files between
+ * 2 min and 1 hour old get a notification; older ones are silently discarded.
+ */
+export async function recoverPendingCheckpoints(config, sendNotification) {
+    const dir = pendingDir(config);
+    let entries;
+    try {
+        entries = fs.readdirSync(dir).filter((f) => f.endsWith(".json") && f !== "restart.json");
+    }
+    catch {
+        return;
+    }
+    if (entries.length === 0)
+        return;
+    const now = Date.now();
+    const MIN_AGE_MS = 2 * 60 * 1000; // 2 minutes: ignore files written moments before a clean restart
+    const MAX_AGE_MS = 60 * 60 * 1000; // 1 hour: too stale to be useful
+    // Group by userId (filename = <userId>.json), keep most recent per user
+    const byUser = new Map();
+    for (const entry of entries) {
+        const filePath = path.join(dir, entry);
+        let checkpoint;
+        try {
+            checkpoint = JSON.parse(fs.readFileSync(filePath, "utf8"));
+        }
+        catch {
+            fs.rmSync(filePath, { force: true });
+            continue;
+        }
+        const userId = entry.slice(0, -5); // strip .json
+        const existing = byUser.get(userId);
+        if (!existing || checkpoint.timestamp > existing.checkpoint.timestamp) {
+            byUser.set(userId, { checkpoint, filePath });
+        }
+    }
+    for (const [userId, { checkpoint, filePath }] of byUser) {
+        const age = now - checkpoint.timestamp;
+        // Always delete the file first to prevent repeat notifications on the next restart
+        try {
+            fs.rmSync(filePath, { force: true });
+        }
+        catch {
+            // ignore
+        }
+        if (age < MIN_AGE_MS || age > MAX_AGE_MS) {
+            console.log(`[pending] Skipping stale checkpoint for ${userId} (age ${Math.round(age / 1000)}s)`);
+            continue;
+        }
+        console.log(`[pending] Crash recovery: notifying ${userId} (age ${Math.round(age / 1000)}s)`);
+        try {
+            await sendNotification(checkpoint, userId);
+        }
+        catch (err) {
+            console.warn(`[pending] Failed to notify ${userId}:`, err.message);
+        }
+    }
+}
+//# sourceMappingURL=crash-recovery.js.map

package/dist/crash-recovery.js.map

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