botinabox 2.4.2 → 2.5.0

package/dist/core/llm/auto-discovery.js

@@ -1,49 +0,0 @@
-import { readdir, readFile } from "node:fs/promises";
-import { join } from "node:path";
-/**
- * Scans nodeModulesPath/@botinabox/{pkg}/package.json for each package in the scope.
- * If pkg.botinabox?.type === 'provider', dynamically imports the package
- * and returns the discovered LLMProvider instances.
- *
- * The optional importer parameter allows injection for testing.
- */
-export async function discoverProviders(nodeModulesPath, importer = (name) => import(name)) {
-    const scopeDir = join(nodeModulesPath, "@botinabox");
-    let entries;
-    try {
-        entries = await readdir(scopeDir);
-    }
-    catch {
-        // No @botinabox scope directory — gracefully return empty
-        return [];
-    }
-    const providers = [];
-    for (const entry of entries) {
-        const pkgPath = join(scopeDir, entry, "package.json");
-        let pkg;
-        try {
-            const raw = await readFile(pkgPath, "utf8");
-            pkg = JSON.parse(raw);
-        }
-        catch {
-            continue;
-        }
-        const botinabox = pkg.botinabox;
-        if (botinabox?.type !== "provider") {
-            continue;
-        }
-        const packageName = pkg.name;
-        if (!packageName) {
-            continue;
-        }
-        try {
-            const mod = await importer(packageName);
-            const provider = "default" in mod && mod.default ? mod.default : mod;
-            providers.push(provider);
-        }
-        catch {
-            // Failed to import — skip silently
-        }
-    }
-    return providers;
-}

package/dist/core/llm/cost-tracker.d.ts

@@ -1,6 +0,0 @@
-import type { HookBus } from "../hooks/hook-bus.js";
-import type { DataStore } from "../data/data-store.js";
-import type { ModelInfo } from "./types.js";
-export declare function setupCostTracker(hooks: HookBus, db: DataStore, opts?: {
-    modelCatalog?: ModelInfo[];
-}): void;

package/dist/core/llm/cost-tracker.js

@@ -1,38 +0,0 @@
-function calculateCostCents(usage, model) {
-    if (!model?.inputCostPerMToken)
-        return 0;
-    const inputCost = (usage.inputTokens / 1_000_000) * model.inputCostPerMToken;
-    const outputCost = (usage.outputTokens / 1_000_000) * (model.outputCostPerMToken ?? 0);
-    return Math.round((inputCost + outputCost) * 100);
-}
-export function setupCostTracker(hooks, db, opts) {
-    const catalog = opts?.modelCatalog ?? [];
-    hooks.register("run.completed", async (payload) => {
-        const ctx = payload;
-        if (!ctx.usage)
-            return;
-        const modelId = ctx.usage.model ?? ctx.model;
-        const providerId = ctx.usage.provider ?? ctx.provider;
-        if (!modelId || !providerId)
-            return;
-        const modelInfo = catalog.find((m) => m.id === modelId);
-        const costCents = calculateCostCents(ctx.usage, modelInfo);
-        await db.insert("cost_events", {
-            agent_id: ctx.agentId ?? null,
-            run_id: ctx.runId ?? null,
-            provider: providerId,
-            model: modelId,
-            input_tokens: ctx.usage.inputTokens,
-            output_tokens: ctx.usage.outputTokens,
-            cost_cents: costCents,
-        });
-        if (ctx.agentId) {
-            const agent = await db.get("agents", ctx.agentId);
-            if (agent) {
-                await db.update("agents", ctx.agentId, {
-                    spent_monthly_cents: (agent.spent_monthly_cents ?? 0) + costCents,
-                });
-            }
-        }
-    }, { priority: 20 });
-}

package/dist/core/llm/index.d.ts

@@ -1,4 +0,0 @@
-export { ProviderRegistry } from "./provider-registry.js";
-export { ModelRouter } from "./model-router.js";
-export { discoverProviders } from "./auto-discovery.js";
-export type { LLMProvider, ModelInfo, ResolvedModel, ChatParams, ChatResult, ChatMessage, ContentBlock, TokenUsage, ToolDefinition, ToolUse, } from "./types.js";

package/dist/core/llm/index.js

@@ -1,3 +0,0 @@
-export { ProviderRegistry } from "./provider-registry.js";
-export { ModelRouter } from "./model-router.js";
-export { discoverProviders } from "./auto-discovery.js";

package/dist/core/llm/model-router.d.ts

@@ -1,25 +0,0 @@
-import type { ModelConfig } from "../../shared/index.js";
-import type { ModelInfo, ResolvedModel } from "./types.js";
-import type { ProviderRegistry } from "./provider-registry.js";
-export declare class ModelRouter {
-    private readonly registry;
-    private readonly config;
-    constructor(registry: ProviderRegistry, config: ModelConfig);
-    /**
-     * Resolve a model ID or alias to a ResolvedModel.
-     * 1. Look up alias in config.aliases (or use as-is)
-     * 2. Search all registered providers for a model with that id
-     */
-    resolve(modelIdOrAlias: string): ResolvedModel | undefined;
-    /**
-     * Try primary model, then each in config.fallbackChain.
-     * Throws if none found.
-     */
-    resolveWithFallback(modelIdOrAlias: string): ResolvedModel;
-    /**
-     * Use config.routing[purpose] ?? config.default, then resolveWithFallback.
-     */
-    resolveForPurpose(purpose: string): ResolvedModel;
-    /** Returns all models from all registered providers. */
-    listAvailable(): ModelInfo[];
-}

package/dist/core/llm/model-router.js

@@ -1,49 +0,0 @@
-export class ModelRouter {
-    registry;
-    config;
-    constructor(registry, config) {
-        this.registry = registry;
-        this.config = config;
-    }
-    /**
-     * Resolve a model ID or alias to a ResolvedModel.
-     * 1. Look up alias in config.aliases (or use as-is)
-     * 2. Search all registered providers for a model with that id
-     */
-    resolve(modelIdOrAlias) {
-        const modelId = this.config.aliases[modelIdOrAlias] ?? modelIdOrAlias;
-        for (const provider of this.registry.list()) {
-            const found = provider.models.find((m) => m.id === modelId);
-            if (found) {
-                return { provider: provider.id, model: found.id };
-            }
-        }
-        return undefined;
-    }
-    /**
-     * Try primary model, then each in config.fallbackChain.
-     * Throws if none found.
-     */
-    resolveWithFallback(modelIdOrAlias) {
-        const primary = this.resolve(modelIdOrAlias);
-        if (primary)
-            return primary;
-        for (const fallback of this.config.fallbackChain) {
-            const resolved = this.resolve(fallback);
-            if (resolved)
-                return resolved;
-        }
-        throw new Error(`No available model found for "${modelIdOrAlias}" and fallback chain [${this.config.fallbackChain.join(", ")}]`);
-    }
-    /**
-     * Use config.routing[purpose] ?? config.default, then resolveWithFallback.
-     */
-    resolveForPurpose(purpose) {
-        const modelIdOrAlias = this.config.routing[purpose] ?? this.config.default;
-        return this.resolveWithFallback(modelIdOrAlias);
-    }
-    /** Returns all models from all registered providers. */
-    listAvailable() {
-        return this.registry.listModels();
-    }
-}

package/dist/core/llm/provider-registry.d.ts

@@ -1,9 +0,0 @@
-import type { LLMProvider, ModelInfo } from "./types.js";
-export declare class ProviderRegistry {
-    private providers;
-    register(provider: LLMProvider): void;
-    unregister(id: string): void;
-    get(id: string): LLMProvider | undefined;
-    list(): LLMProvider[];
-    listModels(): ModelInfo[];
-}

package/dist/core/llm/provider-registry.js

@@ -1,25 +0,0 @@
-export class ProviderRegistry {
-    providers = new Map();
-    register(provider) {
-        if (this.providers.has(provider.id)) {
-            throw new Error(`Provider already registered: ${provider.id}`);
-        }
-        this.providers.set(provider.id, provider);
-    }
-    unregister(id) {
-        this.providers.delete(id);
-    }
-    get(id) {
-        return this.providers.get(id);
-    }
-    list() {
-        return Array.from(this.providers.values());
-    }
-    listModels() {
-        const models = [];
-        for (const provider of this.providers.values()) {
-            models.push(...provider.models);
-        }
-        return models;
-    }
-}

package/dist/core/llm/types.d.ts

@@ -1,2 +0,0 @@
-/** LLM module types — re-exports from @botinabox/shared */
-export type { LLMProvider, ModelInfo, ResolvedModel, ChatParams, ChatResult, ChatMessage, ContentBlock, TokenUsage, ToolDefinition, ToolUse, } from "../../shared/index.js";

package/dist/core/llm/types.js

@@ -1,2 +0,0 @@
-/** LLM module types — re-exports from @botinabox/shared */
-export {};

package/dist/core/orchestrator/adapters/api-adapter.d.ts

@@ -1,34 +0,0 @@
-import type { ModelRouter } from '../../llm/model-router.js';
-import type { ChatMessage, TokenUsage } from "../../../shared/index.js";
-export declare class ApiExecutionAdapter {
-    private modelRouter;
-    readonly type = "api";
-    constructor(modelRouter: ModelRouter);
-    execute(ctx: {
-        agent: {
-            id: string;
-            model?: string;
-            adapter_config?: string;
-        };
-        task: {
-            description?: string;
-            context?: string;
-        };
-        sessionParams?: {
-            history?: ChatMessage[];
-        };
-        contextFiles?: string[];
-        abortSignal?: AbortSignal;
-        onLog?: (stream: 'stdout' | 'stderr', chunk: string) => void;
-    }): Promise<{
-        output: string;
-        exitCode: number;
-        usage: TokenUsage & {
-            provider: string;
-            model: string;
-        };
-        sessionParams: {
-            history: ChatMessage[];
-        };
-    }>;
-}

package/dist/core/orchestrator/adapters/api-adapter.js

@@ -1,88 +0,0 @@
-import { readFileSync, existsSync } from 'node:fs';
-import { toolLoop } from './tool-loop.js';
-export class ApiExecutionAdapter {
-    modelRouter;
-    type = 'api';
-    constructor(modelRouter) {
-        this.modelRouter = modelRouter;
-    }
-    async execute(ctx) {
-        const modelId = ctx.agent.model ?? 'default';
-        const resolved = this.modelRouter.resolve(modelId) ?? this.modelRouter.resolveForPurpose('default');
-        const { provider, model } = resolved;
-        // Get the LLM provider
-        const registry = this.modelRouter.registry;
-        const providerImpl = registry.list().find((p) => p.id === provider);
-        if (!providerImpl) {
-            throw new Error(`Provider not found: ${provider}`);
-        }
-        // Build system prompt
-        let systemPrompt = '';
-        // Load context files
-        if (ctx.contextFiles && ctx.contextFiles.length > 0) {
-            const fileContents = [];
-            for (const filePath of ctx.contextFiles) {
-                if (existsSync(filePath)) {
-                    const content = readFileSync(filePath, 'utf8');
-                    fileContents.push(`<file path="${filePath}">\n${content}\n</file>`);
-                }
-            }
-            if (fileContents.length > 0) {
-                systemPrompt = fileContents.join('\n\n');
-            }
-        }
-        // Build messages from history + task
-        const messages = [
-            ...(ctx.sessionParams?.history ?? []),
-        ];
-        const taskContent = [
-            ctx.task.description,
-            ctx.task.context,
-        ].filter(Boolean).join('\n\n');
-        if (taskContent) {
-            messages.push({ role: 'user', content: taskContent });
-        }
-        let outputText = '';
-        let totalUsage = { inputTokens: 0, outputTokens: 0 };
-        const history = [...messages];
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const callLLM = (params) => providerImpl.chat(params);
-            for await (const event of toolLoop({
-                model,
-                messages,
-                systemPrompt: systemPrompt || undefined,
-                maxIterations: 20,
-                signal: ctx.abortSignal,
-            }, callLLM)) {
-                if (event.type === 'text') {
-                    outputText += event.content;
-                    ctx.onLog?.('stdout', event.content);
-                }
-                else if (event.type === 'done') {
-                    totalUsage = {
-                        inputTokens: (totalUsage.inputTokens ?? 0) + (event.result.usage.inputTokens ?? 0),
-                        outputTokens: (totalUsage.outputTokens ?? 0) + (event.result.usage.outputTokens ?? 0),
-                    };
-                }
-            }
-            history.push({ role: 'assistant', content: outputText });
-            return {
-                output: outputText,
-                exitCode: 0,
-                usage: { ...totalUsage, provider, model },
-                sessionParams: { history },
-            };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            ctx.onLog?.('stderr', message);
-            return {
-                output: message,
-                exitCode: 1,
-                usage: { inputTokens: 0, outputTokens: 0, provider, model },
-                sessionParams: { history },
-            };
-        }
-    }
-}

package/dist/core/orchestrator/adapters/cli-adapter.d.ts

@@ -1,22 +0,0 @@
-export declare class CliExecutionAdapter {
-    readonly type = "cli";
-    execute(ctx: {
-        agent: {
-            id: string;
-            cwd?: string;
-            adapter_config?: string;
-            skip_permissions?: boolean;
-        };
-        task: {
-            title: string;
-            description?: string;
-            context?: string;
-        };
-        logPath?: string;
-        onLog?: (stream: string, chunk: string) => void;
-        abortSignal?: AbortSignal;
-    }): Promise<{
-        output: string;
-        exitCode: number;
-    }>;
-}

package/dist/core/orchestrator/adapters/cli-adapter.js

@@ -1,69 +0,0 @@
-import { createWriteStream } from 'node:fs';
-import { spawnProcess, killProcessGroup } from './process-manager.js';
-import { extractOutput } from './output-extractor.js';
-export class CliExecutionAdapter {
-    type = 'cli';
-    async execute(ctx) {
-        const cwd = ctx.agent.cwd ?? process.cwd();
-        let config = {};
-        if (ctx.agent.adapter_config) {
-            try {
-                config = JSON.parse(ctx.agent.adapter_config);
-            }
-            catch {
-                // Ignore invalid config
-            }
-        }
-        const skipPermissions = ctx.agent.skip_permissions ?? config['skip_permissions'] ?? false;
-        const args = [];
-        if (skipPermissions) {
-            args.push('--dangerously-skip-permissions');
-        }
-        // Build prompt from task
-        const prompt = [
-            ctx.task.title,
-            ctx.task.description,
-            ctx.task.context,
-        ]
-            .filter(Boolean)
-            .join('\n\n');
-        // Append prompt as final argument (--print mode)
-        args.push('--print', prompt);
-        const child = spawnProcess('claude', args, { cwd });
-        const stdoutChunks = [];
-        let logStream = null;
-        if (ctx.logPath) {
-            logStream = createWriteStream(ctx.logPath, { flags: 'a' });
-        }
-        // Set up abort handler
-        const abortHandler = () => {
-            if (child.pid != null) {
-                killProcessGroup(child.pid);
-            }
-        };
-        ctx.abortSignal?.addEventListener('abort', abortHandler);
-        child.stdout?.on('data', (chunk) => {
-            stdoutChunks.push(chunk);
-            const str = chunk.toString('utf8');
-            ctx.onLog?.('stdout', str);
-            logStream?.write(chunk);
-        });
-        child.stderr?.on('data', (chunk) => {
-            const str = chunk.toString('utf8');
-            ctx.onLog?.('stderr', str);
-        });
-        const exitCode = await new Promise((resolve) => {
-            child.on('close', (code) => {
-                resolve(code ?? 1);
-            });
-            child.on('error', () => {
-                resolve(1);
-            });
-        });
-        ctx.abortSignal?.removeEventListener('abort', abortHandler);
-        logStream?.end();
-        const rawOutput = Buffer.concat(stdoutChunks).toString('utf8');
-        const output = extractOutput(rawOutput);
-        return { output, exitCode };
-    }
-}

package/dist/core/orchestrator/adapters/deterministic-adapter.d.ts

@@ -1,35 +0,0 @@
-/**
- * DeterministicAdapter — executes scripts without LLM calls.
- * Story 6.1
- *
- * For tasks that don't require reasoning: routing, validation,
- * data fetching, file transforms. Runs a user-specified command
- * (Python, Node, bash) as a subprocess with task context on stdin.
- */
-export interface DeterministicConfig {
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-    timeoutMs?: number;
-    inputMode?: 'stdin' | 'arg';
-}
-export declare class DeterministicAdapter {
-    readonly type = "deterministic";
-    execute(ctx: {
-        agent: {
-            id: string;
-            cwd?: string;
-            adapter_config?: string;
-        };
-        task: {
-            title: string;
-            description?: string;
-            context?: string;
-        };
-        abortSignal?: AbortSignal;
-        onLog?: (stream: string, chunk: string) => void;
-    }): Promise<{
-        output: string;
-        exitCode: number;
-    }>;
-}

package/dist/core/orchestrator/adapters/deterministic-adapter.js

@@ -1,75 +0,0 @@
-/**
- * DeterministicAdapter — executes scripts without LLM calls.
- * Story 6.1
- *
- * For tasks that don't require reasoning: routing, validation,
- * data fetching, file transforms. Runs a user-specified command
- * (Python, Node, bash) as a subprocess with task context on stdin.
- */
-import { spawnProcess, killProcessGroup } from './process-manager.js';
-const DEFAULT_TIMEOUT_MS = 30_000;
-export class DeterministicAdapter {
-    type = 'deterministic';
-    async execute(ctx) {
-        const cwd = ctx.agent.cwd ?? process.cwd();
-        let config = { command: 'echo' };
-        if (ctx.agent.adapter_config) {
-            try {
-                config = JSON.parse(ctx.agent.adapter_config);
-            }
-            catch {
-                throw new Error('Invalid adapter_config for deterministic adapter');
-            }
-        }
-        if (!config.command) {
-            throw new Error('Deterministic adapter requires a command');
-        }
-        const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-        // Build task payload as JSON for the script
-        const payload = JSON.stringify({
-            taskId: ctx.task.title,
-            description: ctx.task.description ?? '',
-            context: ctx.task.context ?? '',
-        });
-        // Build args — append payload as final arg in 'arg' mode
-        const args = [...(config.args ?? [])];
-        if (config.inputMode === 'arg') {
-            args.push(payload);
-        }
-        const child = spawnProcess(config.command, args, {
-            cwd,
-            extraEnv: config.env,
-        });
-        // Write payload to stdin in default mode
-        if (config.inputMode !== 'arg' && child.stdin) {
-            child.stdin.write(payload);
-            child.stdin.end();
-        }
-        const stdoutChunks = [];
-        child.stdout?.on('data', (chunk) => {
-            stdoutChunks.push(chunk);
-            ctx.onLog?.('stdout', chunk.toString('utf8'));
-        });
-        child.stderr?.on('data', (chunk) => {
-            ctx.onLog?.('stderr', chunk.toString('utf8'));
-        });
-        // Set up abort + timeout
-        const abortHandler = () => {
-            if (child.pid != null)
-                killProcessGroup(child.pid);
-        };
-        ctx.abortSignal?.addEventListener('abort', abortHandler);
-        const timeout = setTimeout(() => {
-            if (child.pid != null)
-                killProcessGroup(child.pid);
-        }, timeoutMs);
-        const exitCode = await new Promise((resolve) => {
-            child.on('close', (code) => resolve(code ?? 1));
-            child.on('error', () => resolve(1));
-        });
-        clearTimeout(timeout);
-        ctx.abortSignal?.removeEventListener('abort', abortHandler);
-        const output = Buffer.concat(stdoutChunks).toString('utf8');
-        return { output, exitCode };
-    }
-}

package/dist/core/orchestrator/adapters/env-whitelist.d.ts

@@ -1,4 +0,0 @@
-/**
- * Filter the process environment to only allowed keys, then merge in extras.
- */
-export declare function filterEnv(allowed?: string[], extra?: Record<string, string>): Record<string, string>;

package/dist/core/orchestrator/adapters/env-whitelist.js

@@ -1,27 +0,0 @@
-const DEFAULT_ALLOWED_ENV = [
-    'PATH',
-    'HOME',
-    'SHELL',
-    'LANG',
-    'USER',
-    'TERM',
-    'NODE_PATH',
-    'TMPDIR',
-];
-/**
- * Filter the process environment to only allowed keys, then merge in extras.
- */
-export function filterEnv(allowed, extra) {
-    const allowedKeys = allowed ?? DEFAULT_ALLOWED_ENV;
-    const result = {};
-    for (const key of allowedKeys) {
-        const val = process.env[key];
-        if (val !== undefined) {
-            result[key] = val;
-        }
-    }
-    if (extra) {
-        Object.assign(result, extra);
-    }
-    return result;
-}

package/dist/core/orchestrator/adapters/output-extractor.d.ts

@@ -1,11 +0,0 @@
-export declare const MAX_OUTPUT_BYTES: number;
-/**
- * Extract final output from NDJSON log content.
- * Finds last line with {type:'result'} or {role:'assistant'}.
- * Caps at 4MB.
- */
-export declare function extractOutput(ndjsonContent: string): string;
-/**
- * Read file and extract output.
- */
-export declare function extractOutputFromFile(logPath: string): string;

package/dist/core/orchestrator/adapters/output-extractor.js

@@ -1,59 +0,0 @@
-import { readFileSync } from 'node:fs';
-export const MAX_OUTPUT_BYTES = 4 * 1024 * 1024; // 4MB
-/**
- * Extract final output from NDJSON log content.
- * Finds last line with {type:'result'} or {role:'assistant'}.
- * Caps at 4MB.
- */
-export function extractOutput(ndjsonContent) {
-    const lines = ndjsonContent.split('\n').filter((l) => l.trim().length > 0);
-    let lastOutput;
-    for (const line of lines) {
-        try {
-            const parsed = JSON.parse(line);
-            if (parsed['type'] === 'result') {
-                const content = parsed['result'] ?? parsed['content'] ?? parsed['output'];
-                if (typeof content === 'string') {
-                    lastOutput = content;
-                }
-            }
-            else if (parsed['role'] === 'assistant') {
-                const content = parsed['content'];
-                if (typeof content === 'string') {
-                    lastOutput = content;
-                }
-            }
-            else if (parsed['type'] === 'assistant') {
-                const message = parsed['message'];
-                if (message && Array.isArray(message['content'])) {
-                    for (const block of message['content']) {
-                        if (typeof block === 'object' &&
-                            block !== null &&
-                            block['type'] === 'text') {
-                            lastOutput = block['text'];
-                        }
-                    }
-                }
-            }
-        }
-        catch {
-            // Skip non-JSON lines
-        }
-    }
-    if (!lastOutput) {
-        // Fall back to raw content
-        lastOutput = ndjsonContent;
-    }
-    // Cap at 4MB
-    if (Buffer.byteLength(lastOutput, 'utf8') > MAX_OUTPUT_BYTES) {
-        return Buffer.from(lastOutput, 'utf8').subarray(0, MAX_OUTPUT_BYTES).toString('utf8');
-    }
-    return lastOutput;
-}
-/**
- * Read file and extract output.
- */
-export function extractOutputFromFile(logPath) {
-    const content = readFileSync(logPath, 'utf8');
-    return extractOutput(content);
-}