micro-models-agent 2.16.1 → 2.17.1

package/dist/modules/providers/manager.js

@@ -1,207 +0,0 @@
-import { createProvider, defaultRegistry } from "./create";
-import { resolveCacheCapability } from "./cache";
-import { BUILTIN_PROVIDERS } from "./presets";
-/**
- * Рулит активным провайдером + моделью в рантайме. Несколько настроенных
- * провайдеров (`ProviderConfig.entries`) с hot-swap (`switch`, `setModel`).
- * Легаси-конфиги (`{type, baseUrl, apiKey}`) нормализуются в список из одной
- * записи — старые конфиги продолжают работать.
- */
-export class ProviderManager {
-    entries;
-    lastKnownFallback;
-    activeProviderName;
-    model;
-    opts;
-    registry;
-    cache = new Map();
-    constructor(config, opts) {
-        this.opts = opts;
-        this.registry = opts.registry ?? defaultRegistry();
-        this.entries = this.normalizeEntries(config);
-        this.activeProviderName = this.resolveActive(config);
-        this.lastKnownFallback = config.fallback;
-        this.model = "";
-    }
-    /** Модель, с которой собран активный провайдер. */
-    get activeModel() {
-        return this.model;
-    }
-    /** Имя/label активного провайдера. */
-    get activeName() {
-        return this.activeProviderName;
-    }
-    /** Активный провайдер (строится и кешируется). */
-    get active() {
-        return this.build(this.activeProviderName);
-    }
-    /** Активная запись (неизвестная — ошибка). */
-    get activeEntry() {
-        const entry = this.entryByName(this.activeProviderName);
-        if (!entry)
-            throw new Error(`Unknown active provider "${this.activeProviderName}"`);
-        return entry;
-    }
-    /** Все записи (с метаданными пресетов), по приоритету. */
-    list() {
-        return this.entries
-            .map((e) => {
-            const preset = this.registry.get(e.type);
-            return { ...e, label: e.label || preset?.label || e.type };
-        })
-            .map((e, i) => ({ e, i, p: e.priority ?? Number.MAX_SAFE_INTEGER }))
-            .sort((a, b) => a.p - b.p || a.i - b.i)
-            .map(({ e }) => e);
-    }
-    /** Имена всех записей по приоритету. */
-    listNames() {
-        return this.list().map((e) => e.label);
-    }
-    /**
-     * CODE-ONLY роутинг capabilities: первая запись (по приоритету), чей пресет
-     * и окно контекста закрывают `needs`. Модели не exposed — модель провайдеров
-     * не выбирает.
-     */
-    pickFor(needs) {
-        const globalWindow = this.opts.contextWindow;
-        // Без ограничений — оставить текущий активный провайдер.
-        if (!needs.vision && !needs.tools && needs.minContext === undefined) {
-            return this.activeProviderName;
-        }
-        for (const e of this.list()) {
-            const caps = this.registry.get(e.type)?.capabilities;
-            if (needs.vision && !caps?.vision)
-                continue;
-            if (needs.tools && !caps?.tools)
-                continue;
-            if (needs.minContext !== undefined &&
-                (e.contextWindow ?? globalWindow) < needs.minContext) {
-                continue;
-            }
-            return e.label;
-        }
-        return undefined;
-    }
-    /** Hot-swap на именованный провайдер; пересобрать активный. */
-    switch(name, model) {
-        if (!this.entryByName(name)) {
-            throw new Error(`Unknown provider "${name}"`);
-        }
-        this.activeProviderName = name;
-        if (model !== undefined)
-            this.model = model;
-        return this.active;
-    }
-    /** Пересобрать активный провайдер с новой моделью. */
-    setModel(model) {
-        this.model = model;
-        // Кэш ключуется `${name}|${model}`; старые записи под прежнюю модель
-        // бесполезны и копятся. Сбрасываем — провайдер пересоберётся под новый
-        // model при следующем обращении к `active`.
-        this.resetCache();
-        return this.active;
-    }
-    /** Сериализовать обратно в ProviderConfig (active/entries в синхроне). */
-    toConfig(fallback) {
-        const active = this.activeEntry;
-        return {
-            active: this.activeProviderName,
-            entries: this.entries,
-            // Сохранить настроенное значение — хардкод false молча ронял
-            // пользовательский provider.fallback при каждом hot-swap.
-            fallback: fallback ?? this.lastKnownFallback ?? false,
-            type: active.type,
-            baseUrl: active.baseUrl,
-            apiKey: active.apiKey,
-        };
-    }
-    normalizeEntries(config) {
-        if (Array.isArray(config.entries) && config.entries.length > 0) {
-            return config.entries.map((e) => ({ ...e, label: e.label || e.type }));
-        }
-        // Легаси-форма одного провайдера (или пустой конфиг) → одна дефолтная запись.
-        return [
-            {
-                type: config.type ?? "openai-compat",
-                label: config.type ?? "openai-compat",
-                baseUrl: config.baseUrl ?? "",
-                apiKey: config.apiKey,
-                maxCompletionTokens: config.maxCompletionTokens,
-            },
-        ];
-    }
-    resolveActive(config) {
-        if (config.active && this.entryByName(config.active))
-            return config.active;
-        const first = this.entries[0];
-        return first ? (first.label ?? "openai-compat") : "openai-compat";
-    }
-    entryByName(name) {
-        return this.entries.find((e) => e.label === name || e.type === name);
-    }
-    build(name) {
-        const entry = this.entryByName(name);
-        if (!entry)
-            throw new Error(`Unknown provider "${name}"`);
-        const key = `${name}|${this.model}`;
-        const cached = this.cache.get(key);
-        if (cached)
-            return cached;
-        const provider = createProvider(entry.type, {
-            model: this.model,
-            baseUrl: entry.baseUrl,
-            apiKey: entry.apiKey,
-            contextWindow: entry.contextWindow ?? this.opts.contextWindow,
-            retry: entry.retry ?? this.opts.retry,
-            rateLimits: entry.rateLimits ?? this.opts.rateLimits,
-            maxCompletionTokens: entry.maxCompletionTokens,
-            getSessionId: this.opts.getSessionId,
-            capabilities: this.resolveCapabilities(entry),
-            logger: this.opts.logger,
-        }, this.registry);
-        this.cache.set(key, provider);
-        return provider;
-    }
-    /** Возможности пресета с наложенным переопределением кеша из записи. */
-    resolveCapabilities(entry) {
-        const spec = this.registry.get(entry.type);
-        if (!spec)
-            return { cache: resolveCacheCapability(undefined, entry.cache) };
-        return { ...spec.capabilities, cache: resolveCacheCapability(spec, entry.cache) };
-    }
-    /** Очистить кеш сборки (при смене конфига). */
-    resetCache() {
-        this.cache.clear();
-    }
-}
-/** Метаданные пресетов для CLI (label/capabilities/baseUrl). */
-export function presetOf(type) {
-    const spec = BUILTIN_PROVIDERS.find((p) => p.type === type);
-    if (!spec)
-        return undefined;
-    return { label: spec.label, baseUrl: spec.baseUrl };
-}
-/**
- * Эндпоинт АКТИВНОГО провайдера для внеполосных вызовов (context probe,
- * автозагрузка моделей, ключ кеша reasoning-пробы). Легаси-плоские поля
- * (`type`/`baseUrl`/`apiKey`) отражают активное на момент последней записи и
- * протухают после hot-swap `/provider use` — истина в entries. Фолбэк на
- * плоские поля для легаси-конфигов.
- */
-export function activeProviderEndpoint(config) {
-    const entries = Array.isArray(config?.entries) ? config.entries : [];
-    const active = entries.find((e) => e.label === config?.active || e.type === config?.active) ?? entries[0];
-    if (active) {
-        return { baseUrl: active.baseUrl, apiKey: active.apiKey, type: active.type };
-    }
-    return { baseUrl: config?.baseUrl ?? "", apiKey: config?.apiKey, type: config?.type ?? "openai-compat" };
-}
-/**
- * Стратегия reasoning АКТИВНОЙ записи провайдера (из её пресета). Легаси-плоское
- * `type` протухает после hot-swap `/provider use` и давало чужую стратегию
- * (напр. `prompt-tag` при активном `opencode-go`); неизвестный тип → "none".
- */
-export function reasoningStrategyForProvider(config) {
-    const type = activeProviderEndpoint(config).type;
-    return BUILTIN_PROVIDERS.find((p) => p.type === type)?.capabilities.reasoningStrategy ?? "none";
-}

package/dist/modules/providers/naming.js

@@ -1,15 +0,0 @@
-/** Display/identity-имя записи: label, иначе type. */
-export function providerEntryName(entry) {
-    return entry.label || entry.type;
-}
-/**
- * Занято ли `name` другой записью (кроме `exceptName`).
- * Записи адресуются по `label || type`, легаси-поиск матчит и голый `type`,
- * так что новый/переименованный провайдер не должен коллизить ни с тем, ни с
- * другим — иначе `provider.active` и edit/delete молча бьют не в ту запись.
- * `exceptName` позволяет правке сохранить собственное текущее имя.
- */
-export function providerNameTaken(entries, name, exceptName) {
-    return entries.some((e) => providerEntryName(e) !== exceptName &&
-        (providerEntryName(e) === name || e.type === name));
-}

package/dist/modules/providers/preflight.js

@@ -1,71 +0,0 @@
-import { errMsg } from "../../utils";
-/** Base URL + ключ активного провайдера (сначала entries, потом legacy). */
-export function resolveProviderTarget(provider) {
-    const entries = provider.entries ?? [];
-    if (entries.length > 0) {
-        const active = provider.active;
-        const entry = entries.find((e) => (e.label ?? e.type) === active) ??
-            entries.find((e) => e.type === active) ??
-            entries[0];
-        return { baseUrl: entry.baseUrl, apiKey: entry.apiKey ?? "" };
-    }
-    return { baseUrl: provider.baseUrl, apiKey: provider.apiKey ?? "" };
-}
-/** Резолв активного провайдера из конфига, затем его preflight. */
-export function preflightFromConfig(ctx) {
-    const target = resolveProviderTarget(ctx.config.provider);
-    return preflightProvider({
-        baseUrl: target.baseUrl,
-        apiKey: target.apiKey,
-        model: ctx.config.model,
-    });
-}
-/** Минимальная дешёвая chat-проба: подтверждает, что модель загружена. */
-export async function probeChat(cfg, timeoutMs) {
-    const url = `${cfg.baseUrl.replace(/\/+$/, "")}/chat/completions`;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        const resp = await fetch(url, {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${cfg.apiKey}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                model: cfg.model,
-                messages: [{ role: "user", content: "ok" }],
-                max_tokens: 1,
-            }),
-            signal: controller.signal,
-        });
-        if (!resp.ok)
-            throw new Error(`HTTP ${resp.status}`);
-        const data = (await resp.json());
-        const msg = data.choices?.[0]?.message;
-        return msg?.content || msg?.reasoning_content || "";
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-/**
- * Проверить, что провайдер отвечает и модель загружена. Один chat-вызов с
- * max_tokens=1 (стоимость пренебрежима). Не висит: ограничен timeoutMs.
- */
-export async function preflightProvider(cfg, opts = {}) {
-    const timeoutMs = opts.timeoutMs ?? 3000;
-    const probe = opts.probe ?? probeChat;
-    const start = Date.now();
-    try {
-        const text = await probe(cfg, timeoutMs);
-        const ms = Date.now() - start;
-        return text ? { ok: true, reason: "ok", ms } : { ok: false, reason: "no-model", ms };
-    }
-    catch (err) {
-        const ms = Date.now() - start;
-        const message = errMsg(err);
-        const reason = /abort|timeout/i.test(message) ? "timeout" : "unreachable";
-        return { ok: false, reason, ms };
-    }
-}

package/dist/modules/providers/presets.js

@@ -1,232 +0,0 @@
-// Builtin-пресеты провайдеров: capabilities, кеш-поведение, фабрики, base URL.
-// src/modules/providers/presets.ts
-import { OpenAICompatProvider } from "../../llm/openai-compat";
-/** Сборка OpenAI-совместимого провайдера (дефолт для большинства бэкендов). */
-function openaiCompat(opts) {
-    const retry = (opts.retry ?? {
-        maxRetries: 3,
-        baseDelay: 1000,
-        maxDelay: 30000,
-    });
-    const rateLimits = opts.rateLimits;
-    return new OpenAICompatProvider({
-        model: opts.model,
-        baseUrl: opts.baseUrl,
-        apiKey: opts.apiKey,
-        contextWindow: opts.contextWindow,
-        retry,
-        rateLimits,
-        maxCompletionTokens: opts.maxCompletionTokens,
-        getSessionId: opts.getSessionId,
-        cache: opts.capabilities?.cache,
-        logger: opts.logger,
-    });
-}
-const OPENAI_COMPAT = {
-    type: "openai-compat",
-    label: "OpenAI-compatible (LM Studio, Ollama, vLLM, etc.)",
-    baseUrl: "",
-    capabilities: {
-        streaming: true,
-        tools: true,
-        vision: false,
-        reasoningStrategy: "prompt-tag",
-        listModels: true,
-        requiresKey: false,
-        auth: "bearer",
-        // Локальные серверы (LM Studio, llama.cpp, vLLM) кешируют KV-префикс на
-        // сервере и отдают его в usage-полях OpenAI-формы.
-        cache: {
-            mechanism: "local",
-            report: "openai",
-            sessionHeader: false,
-            requestCachePrompt: false,
-            requestPromptCacheKey: false,
-            requestSessionId: false,
-            requestCacheControl: false,
-            requestStreamUsage: true,
-        },
-    },
-    create: openaiCompat,
-};
-/** LM Studio как first-class провайдер: тот же OpenAI-транспорт,
- *  но свой type — native discovery (`/api/v1/models`: загруженный контекст,
- *  capabilities) и фиксированный дефолтный URL едут с ним, а не прячутся
- *  внутри generic-записи `openai-compat`. */
-const LMSTUDIO = {
-    type: "lmstudio",
-    label: "LM Studio (localhost:1234)",
-    baseUrl: "http://localhost:1234/v1",
-    capabilities: {
-        streaming: true,
-        tools: true,
-        vision: false,
-        reasoningStrategy: "prompt-tag",
-        listModels: true,
-        requiresKey: false,
-        auth: "bearer",
-        // Тот же локальный KV-кеш, что и у generic openai-compat.
-        cache: {
-            mechanism: "local",
-            report: "openai",
-            sessionHeader: false,
-            requestCachePrompt: false,
-            requestPromptCacheKey: false,
-            requestSessionId: false,
-            requestCacheControl: false,
-            requestStreamUsage: true,
-        },
-    },
-    create: openaiCompat,
-};
-const OPENROUTER = { type: "openrouter",
-    label: "OpenRouter (openrouter.ai)",
-    baseUrl: "https://openrouter.ai/api/v1",
-    capabilities: {
-        streaming: true,
-        tools: true,
-        vision: true,
-        reasoningStrategy: "openai-effort",
-        listModels: true,
-        requiresKey: true,
-        auth: "bearer",
-        // OpenRouter проксирует кеши провайдеров и сообщает cached/cache_write
-        // токены. `session_id` прибивает последующие запросы к провайдеру с тёплым кешем.
-        cache: {
-            mechanism: "auto",
-            report: "openai",
-            sessionHeader: false,
-            requestCachePrompt: false,
-            requestPromptCacheKey: false,
-            requestSessionId: true,
-            requestCacheControl: false,
-            requestStreamUsage: true,
-        },
-    },
-    create: openaiCompat,
-};
-const OPENAI = {
-    type: "openai",
-    label: "OpenAI API",
-    baseUrl: "https://api.openai.com/v1",
-    capabilities: {
-        streaming: true,
-        tools: true,
-        vision: true,
-        reasoningStrategy: "openai-effort",
-        listModels: true,
-        requiresKey: true,
-        auth: "bearer",
-        // Автоматический prefix caching. `prompt_cache_key` держит запросы с общим
-        // префиксом на одном бэкенде ради более высокого hit-rate.
-        cache: {
-            mechanism: "auto",
-            report: "openai",
-            sessionHeader: false,
-            requestCachePrompt: false,
-            requestPromptCacheKey: true,
-            requestSessionId: false,
-            requestCacheControl: false,
-            requestStreamUsage: true,
-        },
-    },
-    create: openaiCompat,
-};
-const ANTHROPIC = {
-    type: "anthropic",
-    label: "Anthropic Claude",
-    baseUrl: "https://api.anthropic.com",
-    capabilities: {
-        streaming: false,
-        tools: false,
-        vision: true,
-        reasoningStrategy: "none",
-        listModels: false,
-        requiresKey: true,
-        auth: "header",
-        // Явные cache-брейкпоинты; отчёт идёт через собственные usage-поля Anthropic.
-        // Неактивно, пока не появится настоящий AnthropicProvider на /v1/messages.
-        cache: {
-            mechanism: "explicit",
-            report: "anthropic",
-            sessionHeader: false,
-            requestCachePrompt: false,
-            requestPromptCacheKey: false,
-            requestSessionId: false,
-            requestCacheControl: true,
-            requestStreamUsage: false,
-        },
-    },
-    // Messages API Anthropic НЕ OpenAI-совместим. Пресет — заглушка до настоящего
-    // AnthropicProvider; фабрика пока идёт по OpenAI-кодпасу (сломано), что видно
-    // через capabilities.
-    create: openaiCompat,
-};
-const OPENCODE_ZEN = {
-    type: "opencode-zen",
-    label: "OpenCode Zen (opencode.ai/zen)",
-    baseUrl: "https://opencode.ai/zen/v1",
-    capabilities: {
-        streaming: true,
-        tools: true,
-        vision: false,
-        reasoningStrategy: "openai-effort",
-        listModels: true,
-        requiresKey: false,
-        auth: "bearer",
-        // Серверный кеш с ценой Cached Read; для sticky-маршрутизации нужен
-        // заголовок сессии (`x-opencode-session`).
-        cache: {
-            mechanism: "auto",
-            report: "openai",
-            sessionHeader: true,
-            requestCachePrompt: false,
-            requestPromptCacheKey: false,
-            requestSessionId: false,
-            requestCacheControl: false,
-            requestStreamUsage: true,
-        },
-    },
-    create: openaiCompat,
-};
-const OPENCODE_GO = {
-    type: "opencode-go",
-    label: "OpenCode Go (opencode.ai/go)",
-    baseUrl: "https://opencode.ai/zen/go/v1",
-    capabilities: {
-        streaming: true,
-        tools: true,
-        vision: false,
-        reasoningStrategy: "openai-effort",
-        listModels: true,
-        requiresKey: false,
-        auth: "bearer",
-        cache: {
-            mechanism: "auto",
-            report: "openai",
-            sessionHeader: true,
-            requestCachePrompt: false,
-            requestPromptCacheKey: false,
-            requestSessionId: false,
-            requestCacheControl: false,
-            requestStreamUsage: true,
-        },
-    },
-    create: openaiCompat,
-};
-/** Все builtin-пресеты провайдеров. */
-export const BUILTIN_PROVIDERS = [
-    OPENAI_COMPAT,
-    LMSTUDIO,
-    OPENROUTER,
-    OPENAI,
-    ANTHROPIC,
-    OPENCODE_ZEN,
-    OPENCODE_GO,
-];
-/** Фиксированные base URL хостед-провайдеров (без скан-портов / автодетекта моделей). */
-export const HOSTED_BASE_URLS = {};
-for (const spec of BUILTIN_PROVIDERS) {
-    if (spec.baseUrl)
-        HOSTED_BASE_URLS[spec.type] = spec.baseUrl;
-}

package/dist/modules/providers/registry.js

@@ -1,27 +0,0 @@
-/**
- * Единый источник правды type → фабрика + capabilities.
- * Добавление провайдера — один вызов `register()`; петля агента не меняется.
- */
-export class ProviderRegistry {
-    specs = new Map();
-    /** Зарегистрировать спек провайдера. */
-    register(spec) {
-        this.specs.set(spec.type, spec);
-    }
-    /** Спек по типу, иначе undefined. */
-    get(type) {
-        return this.specs.get(type);
-    }
-    /** Зарегистрирован ли тип. */
-    has(type) {
-        return this.specs.has(type);
-    }
-    /** Все спеки. */
-    list() {
-        return [...this.specs.values()];
-    }
-    /** Все зарегистрированные типы. */
-    types() {
-        return [...this.specs.keys()];
-    }
-}

package/dist/modules/providers/types.js

@@ -1 +0,0 @@
-export {};

package/dist/modules/reasoning/policy.js

@@ -1,42 +0,0 @@
-/** Начальное состояние политики. */
-export function createPolicyState() {
-    return { iterationsSinceRaise: 0, boostRemaining: 0 };
-}
-const DECAY_THRESHOLD = 5;
-/** Вычисляет reasoning-уровень: подъём на сбоях, буст после плана, спад на рутине. */
-export function evaluateReasoningPolicy(input, state) {
-    // Сигналы подъёма (высший приоритет)
-    if (input.hallucinationRetry || input.auditRejection || input.recoverableLlmError) {
-        state.iterationsSinceRaise = 0;
-        return { level: "high", reason: input.hallucinationRetry ? "policy:hallucination-retry" : input.auditRejection ? "policy:audit-rejection" : "policy:recoverable-llm-error" };
-    }
-    // Создан план → буст на N итераций
-    if (input.planCreated) {
-        state.boostRemaining = 3;
-        state.iterationsSinceRaise = 0;
-        return { level: "high", reason: "policy:plan-created" };
-    }
-    // Активный буст от создания плана
-    if (state.boostRemaining > 0) {
-        state.boostRemaining--;
-        state.iterationsSinceRaise = 0;
-        return { level: "high", reason: "policy:plan-boost" };
-    }
-    // Сигналы понижения
-    if (input.consecutiveSuccesses >= 2) {
-        state.iterationsSinceRaise++;
-        return { level: "low", reason: "policy:routine-write" };
-    }
-    if (input.isRepetitive) {
-        state.iterationsSinceRaise++;
-        return { level: "low", reason: "policy:repetitive-tools" };
-    }
-    // Затухание: подъём держался слишком долго — возврат к базовому
-    if (state.iterationsSinceRaise >= DECAY_THRESHOLD) {
-        state.iterationsSinceRaise = 0;
-        return { level: input.baseline, reason: "policy:decay" };
-    }
-    // По умолчанию: базовый уровень
-    state.iterationsSinceRaise++;
-    return { level: input.baseline, reason: "policy:default" };
-}