atom-lite 0.0.0-stage → 0.4.1

package/dist/mcp/tools.js

@@ -0,0 +1,162 @@
+import { checkApproval } from "../runtime/approvals.js";
+export const MCP_APPROVAL_REQUIRED = "MCP_APPROVAL_REQUIRED";
+export const MCP_CALL_FAILED = "MCP_CALL_FAILED";
+export const MCP_APPROVAL_PREFIX = "mcp";
+/**
+ * Wrap one discovered MCP tool as an Atom-lite `Tool`. The execution path is
+ * the same as built-ins: it receives the normal context, honours approval
+ * policy, and returns the normal result shape.
+ */
+export class McpTool {
+    manager;
+    tool;
+    definition;
+    constructor(manager, tool) {
+        this.manager = manager;
+        this.tool = tool;
+        this.definition = {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.inputSchema,
+        };
+    }
+    async execute(call, ctx) {
+        const args = (call.arguments ?? {});
+        const current = this.manager
+            .tools()
+            .find((t) => t.server === this.tool.server &&
+            t.remoteName === this.tool.remoteName);
+        const requiresApproval = current?.requiresApproval ?? this.tool.requiresApproval;
+        const callTimeoutMs = current?.callTimeoutMs ?? this.tool.callTimeoutMs;
+        if (requiresApproval) {
+            const approvals = ctx.approvals;
+            const request = {
+                command: `${MCP_APPROVAL_PREFIX} ${this.tool.server}/${this.tool.remoteName} ${JSON.stringify(args)}`,
+                cwd: ctx.workspace,
+                timeoutMs: callTimeoutMs,
+                sandboxed: true,
+            };
+            if (!approvals) {
+                return {
+                    toolCallId: call.id,
+                    name: this.tool.name,
+                    content: `${MCP_APPROVAL_REQUIRED}: approvals unavailable`,
+                    isError: true,
+                };
+            }
+            const decision = await checkApproval(approvals, request);
+            if (!decision.allowed) {
+                return {
+                    toolCallId: call.id,
+                    name: this.tool.name,
+                    content: `${MCP_APPROVAL_REQUIRED}: ${this.tool.server}/${this.tool.remoteName}`,
+                    isError: true,
+                };
+            }
+        }
+        try {
+            const result = await this.manager.callTool(this.tool.server, this.tool.remoteName, args, { signal: ctx.signal });
+            return {
+                toolCallId: call.id,
+                name: this.tool.name,
+                content: summariseMcpResult(result),
+                isError: Boolean(result?.isError),
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message === "USER_CANCELLED") {
+                return {
+                    toolCallId: call.id,
+                    name: this.tool.name,
+                    content: "USER_CANCELLED",
+                    isError: true,
+                };
+            }
+            return {
+                toolCallId: call.id,
+                name: this.tool.name,
+                content: `${MCP_CALL_FAILED}: ${message}`,
+                isError: true,
+            };
+        }
+    }
+}
+export function createMcpTools(manager) {
+    return manager.tools().map((tool) => new McpTool(manager, tool));
+}
+/** Map an MCP tool result into the single string Atom-lite tools use. */
+export function summariseMcpResult(result) {
+    if (result == null)
+        return "";
+    if (typeof result !== "object")
+        return String(result);
+    const record = result;
+    if (Array.isArray(record.content)) {
+        const parts = record.content.map((part) => {
+            if (!part || typeof part !== "object")
+                return String(part);
+            const typed = part;
+            if (typed.type === "text" && typeof typed.text === "string") {
+                return typed.text;
+            }
+            if (typed.type === "image") {
+                const mime = typeof typed.mimeType === "string" ? typed.mimeType : "image";
+                const bytes = byteLengthOf(typed.data);
+                return `[${mime} ${bytes} bytes]`;
+            }
+            if (typed.type === "audio") {
+                const mime = typeof typed.mimeType === "string" ? typed.mimeType : "audio";
+                const bytes = byteLengthOf(typed.data);
+                return `[${mime} ${bytes} bytes]`;
+            }
+            if (typed.type === "resource") {
+                const resource = typed.resource;
+                if (resource && typeof resource === "object") {
+                    const r = resource;
+                    const mime = typeof r.mimeType === "string" ? r.mimeType : "resource";
+                    const bytes = byteLengthOf(r.blob);
+                    return `[${mime} ${bytes} bytes]`;
+                }
+                return "[resource]";
+            }
+            if (typed.type === "resource_link") {
+                return typeof typed.uri === "string"
+                    ? `[resource_link ${typed.uri}]`
+                    : "[resource_link]";
+            }
+            if (typeof typed.type === "string") {
+                const mime = typeof typed.mimeType === "string" ? typed.mimeType : typed.type;
+                const bytes = byteLengthOf(typed.data ?? typed.blob);
+                if (bytes > 0)
+                    return `[${mime} ${bytes} bytes]`;
+                return `[${typed.type}]`;
+            }
+            return `[${JSON.stringify(typed).slice(0, 120)}]`;
+        });
+        return parts.join("\n").trim();
+    }
+    if (typeof record.result === "string")
+        return record.result;
+    try {
+        return JSON.stringify(record);
+    }
+    catch {
+        return String(record);
+    }
+}
+function byteLengthOf(value) {
+    if (typeof value === "string") {
+        // MCP image/audio data is base64.
+        try {
+            return Buffer.byteLength(value, "base64");
+        }
+        catch {
+            return Buffer.byteLength(value, "utf8");
+        }
+    }
+    if (value instanceof Uint8Array)
+        return value.byteLength;
+    return 0;
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,92 @@
+import type { McpServerConfig } from "../config/schema.js";
+export type { McpServerConfig };
+export type JsonRpcId = number | string;
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcSuccess {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result: unknown;
+}
+export interface JsonRpcFailure {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcSuccess | JsonRpcFailure;
+export interface McpTransportCloseInfo {
+    code?: number | null;
+    signal?: string | null;
+}
+export interface McpTransportHandlers {
+    onMessage(message: unknown): void;
+    onError(error: Error): void;
+    onClose(info: McpTransportCloseInfo): void;
+}
+/** A bidirectional JSON-RPC carrier. Tests inject a fake; production uses stdio. */
+export interface McpTransport {
+    start(): Promise<void>;
+    send(message: unknown): void;
+    close(): void | Promise<void>;
+    setHandlers(handlers: McpTransportHandlers): void;
+    /** Optional diagnostic text (stderr) for connection failures. */
+    stderrText?(): string;
+}
+export type McpTransportFactory = (serverName: string, config: McpServerConfig) => McpTransport;
+export interface McpRemoteTool {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+/** A discovered tool after namespacing and policy decoration. */
+export interface McpToolState {
+    server: string;
+    remoteName: string;
+    /** Namespaced model-facing name: `mcp__<server>__<tool>`. */
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    requiresApproval: boolean;
+    callTimeoutMs: number;
+}
+export type McpServerState = "disabled" | "idle" | "connecting" | "ready" | "failed" | "closed";
+export interface McpServerStatus {
+    name: string;
+    state: McpServerState;
+    enabled: boolean;
+    requiresApproval: boolean;
+    toolCount: number;
+    tools: string[];
+    lastError?: string;
+}
+export type McpEvent = {
+    type: "mcp_server_connected";
+    server: string;
+    toolCount: number;
+} | {
+    type: "mcp_server_failed";
+    server: string;
+    error: string;
+} | {
+    type: "mcp_tools_changed";
+    server: string;
+    toolCount: number;
+};
+export interface McpCallResult {
+    content?: unknown;
+    isError?: boolean;
+    [key: string]: unknown;
+}

package/dist/mcp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":""}

package/dist/providers/catalog.d.ts

@@ -0,0 +1,60 @@
+import type { Config } from "../config/schema.js";
+export type ProviderType = "openai-compatible" | "ollama" | "gemini";
+export interface ProviderPreset {
+    id: string;
+    label: string;
+    description: string;
+    type: ProviderType;
+    baseUrl?: string;
+    model: string;
+    /** True when the provider needs an API key before it can be used. */
+    requiresKey: boolean;
+    /** Conventional environment variable for the key. */
+    keyEnv?: string;
+    /** Where a user can create a key. */
+    keyUrl?: string;
+    headers?: Record<string, string>;
+    /** Shown before live model discovery completes (and as an offline fallback). */
+    fallbackModels: string[];
+    local?: boolean;
+}
+/**
+ * Curated provider catalog. Hosted providers use the OpenAI-compatible adapter
+ * (Anthropic exposes an OpenAI-compatible endpoint); Gemini uses its native
+ * adapter; local runtimes are keyless.
+ */
+export declare const PROVIDER_PRESETS: ProviderPreset[];
+export declare function getPreset(id: string): ProviderPreset | undefined;
+/**
+ * Build the provider profile stored in config from a preset, preserving any
+ * model the user already chose.
+ */
+export declare function materializeProviderConfig(preset: ProviderPreset, existing?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Provider profiles that should appear in `/model`: explicitly configured
+ * profiles, profiles with a stored credential, and presets whose key is in the
+ * environment.
+ */
+export declare function availableProviderNames(config: Config, credentialsPath?: string): string[];
+export declare function providerLabel(id: string): string;
+/** Filter out models that clearly cannot be used for a chat/tool call. */
+export declare function isLikelyChatModel(id: string): boolean;
+export declare function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T>;
+/**
+ * Ask a configured provider for its models. Failures are returned as an empty
+ * list so callers can fall back to the configured model.
+ */
+export declare function listModelsForProvider(config: Config, profile: string, timeoutMs?: number): Promise<string[]>;
+export interface KeyProbeResult {
+    ok: boolean;
+    /** Authentication was explicitly rejected (401/403). */
+    invalid: boolean;
+    models: string[];
+    error?: string;
+}
+/**
+ * Validate an API key before persisting it. Reaches the provider's model list
+ * endpoint directly so auth failures are visible (the adapters intentionally
+ * swallow list errors and fall back to the configured model).
+ */
+export declare function probeApiKey(preset: ProviderPreset, apiKey: string, timeoutMs?: number): Promise<KeyProbeResult>;

package/dist/providers/catalog.js

@@ -0,0 +1,289 @@
+import { loadCredentials } from "../config/credentials.js";
+import { createProvider } from "./factory.js";
+const GPT_FALLBACKS = [
+    "gpt-4o-mini",
+    "gpt-4o",
+    "gpt-4.1-mini",
+    "gpt-4.1",
+    "o4-mini",
+    "o3",
+];
+const CLAUDE_FALLBACKS = [
+    "claude-sonnet-4-20250514",
+    "claude-3-7-sonnet-latest",
+    "claude-3-5-haiku-latest",
+];
+const GEMINI_FALLBACKS = ["gemini-2.5-flash", "gemini-2.5-pro", "gemini-2.0-flash"];
+/**
+ * Curated provider catalog. Hosted providers use the OpenAI-compatible adapter
+ * (Anthropic exposes an OpenAI-compatible endpoint); Gemini uses its native
+ * adapter; local runtimes are keyless.
+ */
+export const PROVIDER_PRESETS = [
+    {
+        id: "kilo",
+        label: "Kilo Gateway",
+        description: "Free hosted gateway (no key required)",
+        type: "openai-compatible",
+        baseUrl: "https://api.kilo.ai/api/gateway",
+        model: "kilo-auto/free",
+        requiresKey: false,
+        fallbackModels: ["kilo-auto/free"],
+    },
+    {
+        id: "openai",
+        label: "OpenAI",
+        description: "Official OpenAI API",
+        type: "openai-compatible",
+        baseUrl: "https://api.openai.com/v1",
+        model: "gpt-4o-mini",
+        requiresKey: true,
+        keyEnv: "OPENAI_API_KEY",
+        keyUrl: "https://platform.openai.com/api-keys",
+        fallbackModels: GPT_FALLBACKS,
+    },
+    {
+        id: "anthropic",
+        label: "Anthropic",
+        description: "Claude via Anthropic's OpenAI-compatible endpoint",
+        type: "openai-compatible",
+        baseUrl: "https://api.anthropic.com/v1",
+        model: "claude-sonnet-4-20250514",
+        requiresKey: true,
+        keyEnv: "ANTHROPIC_API_KEY",
+        keyUrl: "https://console.anthropic.com/settings/keys",
+        headers: { "anthropic-version": "2023-06-01" },
+        fallbackModels: CLAUDE_FALLBACKS,
+    },
+    {
+        id: "google",
+        label: "Google Gemini",
+        description: "Official Gemini API",
+        type: "gemini",
+        baseUrl: "https://generativelanguage.googleapis.com",
+        model: "gemini-2.5-flash",
+        requiresKey: true,
+        keyEnv: "GEMINI_API_KEY",
+        keyUrl: "https://aistudio.google.com/app/apikey",
+        fallbackModels: GEMINI_FALLBACKS,
+    },
+    {
+        id: "openrouter",
+        label: "OpenRouter",
+        description: "Many hosted models through one key",
+        type: "openai-compatible",
+        baseUrl: "https://openrouter.ai/api/v1",
+        model: "openai/gpt-4o-mini",
+        requiresKey: true,
+        keyEnv: "OPENROUTER_API_KEY",
+        keyUrl: "https://openrouter.ai/keys",
+        fallbackModels: ["openai/gpt-4o-mini", "anthropic/claude-sonnet-4", "google/gemini-2.5-flash"],
+    },
+    {
+        id: "groq",
+        label: "Groq",
+        description: "Fast hosted inference",
+        type: "openai-compatible",
+        baseUrl: "https://api.groq.com/openai/v1",
+        model: "llama-3.3-70b-versatile",
+        requiresKey: true,
+        keyEnv: "GROQ_API_KEY",
+        keyUrl: "https://console.groq.com/keys",
+        fallbackModels: ["llama-3.3-70b-versatile", "llama-3.1-8b-instant"],
+    },
+    {
+        id: "mistral",
+        label: "Mistral",
+        description: "Official Mistral API",
+        type: "openai-compatible",
+        baseUrl: "https://api.mistral.ai/v1",
+        model: "mistral-large-latest",
+        requiresKey: true,
+        keyEnv: "MISTRAL_API_KEY",
+        keyUrl: "https://console.mistral.ai/api-keys",
+        fallbackModels: ["mistral-large-latest", "mistral-small-latest", "codestral-latest"],
+    },
+    {
+        id: "xai",
+        label: "xAI",
+        description: "Grok models",
+        type: "openai-compatible",
+        baseUrl: "https://api.x.ai/v1",
+        model: "grok-3-mini",
+        requiresKey: true,
+        keyEnv: "XAI_API_KEY",
+        keyUrl: "https://console.x.ai",
+        fallbackModels: ["grok-3-mini", "grok-3", "grok-2-latest"],
+    },
+    {
+        id: "ollama",
+        label: "Ollama",
+        description: "Local Ollama runtime",
+        type: "ollama",
+        baseUrl: "http://127.0.0.1:11434",
+        model: "qwen2.5-coder:7b",
+        requiresKey: false,
+        local: true,
+        fallbackModels: ["qwen2.5-coder:7b", "llama3.2:3b"],
+    },
+    {
+        id: "lmstudio",
+        label: "LM Studio",
+        description: "Local OpenAI-compatible server",
+        type: "openai-compatible",
+        baseUrl: "http://127.0.0.1:1234/v1",
+        model: "local-model",
+        requiresKey: false,
+        local: true,
+        fallbackModels: ["local-model"],
+    },
+    {
+        id: "llamacpp",
+        label: "llama.cpp",
+        description: "Local llama-server endpoint",
+        type: "openai-compatible",
+        baseUrl: "http://127.0.0.1:8080/v1",
+        model: "local-model",
+        requiresKey: false,
+        local: true,
+        fallbackModels: ["local-model"],
+    },
+];
+export function getPreset(id) {
+    return PROVIDER_PRESETS.find((p) => p.id === id);
+}
+/**
+ * Build the provider profile stored in config from a preset, preserving any
+ * model the user already chose.
+ */
+export function materializeProviderConfig(preset, existing) {
+    const out = {
+        type: preset.type,
+        model: existing?.model ??
+            preset.model,
+        apiKeyEnv: preset.keyEnv ?? null,
+    };
+    if (preset.baseUrl)
+        out.baseUrl = existing?.baseUrl ?? preset.baseUrl;
+    if (preset.headers)
+        out.headers = { ...preset.headers, ...(existing?.headers ?? {}) };
+    return out;
+}
+/**
+ * Provider profiles that should appear in `/model`: explicitly configured
+ * profiles, profiles with a stored credential, and presets whose key is in the
+ * environment.
+ */
+export function availableProviderNames(config, credentialsPath) {
+    const names = new Set();
+    for (const [name, profile] of Object.entries(config.providers)) {
+        if (profile && typeof profile === "object")
+            names.add(name);
+    }
+    const creds = loadCredentials(credentialsPath);
+    for (const name of Object.keys(creds.apiKeys)) {
+        if (getPreset(name))
+            names.add(name);
+    }
+    for (const preset of PROVIDER_PRESETS) {
+        if (preset.keyEnv && process.env[preset.keyEnv])
+            names.add(preset.id);
+    }
+    return [...names];
+}
+export function providerLabel(id) {
+    return getPreset(id)?.label ?? id;
+}
+/** Filter out models that clearly cannot be used for a chat/tool call. */
+export function isLikelyChatModel(id) {
+    return !/embedding|embed-|whisper|tts|dall-e|moderation|imagen|veo|audio|realtime|transcribe/i.test(id);
+}
+export async function withTimeout(promise, ms) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error("TIMEOUT")), ms);
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/**
+ * Ask a configured provider for its models. Failures are returned as an empty
+ * list so callers can fall back to the configured model.
+ */
+export async function listModelsForProvider(config, profile, timeoutMs = 8000) {
+    try {
+        const adapter = createProvider(config, profile);
+        if (typeof adapter.listModels !== "function")
+            return [];
+        const models = (await withTimeout(adapter.listModels(), timeoutMs));
+        return models.filter((m) => typeof m === "string" && m && isLikelyChatModel(m));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Validate an API key before persisting it. Reaches the provider's model list
+ * endpoint directly so auth failures are visible (the adapters intentionally
+ * swallow list errors and fall back to the configured model).
+ */
+export async function probeApiKey(preset, apiKey, timeoutMs = 10000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        if (preset.type === "gemini") {
+            const base = (preset.baseUrl ?? "https://generativelanguage.googleapis.com").replace(/\/$/, "");
+            const res = await fetch(`${base}/v1beta/models?key=${encodeURIComponent(apiKey)}`, { signal: controller.signal });
+            if (res.status === 401 || res.status === 403) {
+                return { ok: false, invalid: true, models: [], error: `HTTP ${res.status}` };
+            }
+            if (!res.ok) {
+                return { ok: false, invalid: false, models: [], error: `HTTP ${res.status}` };
+            }
+            const json = (await res.json());
+            const models = (json.models ?? [])
+                .map((m) => String(m.name ?? "").replace(/^models\//, ""))
+                .filter((m) => m && isLikelyChatModel(m));
+            return { ok: true, invalid: false, models };
+        }
+        const base = (preset.baseUrl ?? "").replace(/\/$/, "");
+        const res = await fetch(`${base}/models`, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                ...(preset.headers ?? {}),
+            },
+            signal: controller.signal,
+        });
+        if (res.status === 401 || res.status === 403) {
+            return { ok: false, invalid: true, models: [], error: `HTTP ${res.status}` };
+        }
+        if (!res.ok) {
+            return { ok: false, invalid: false, models: [], error: `HTTP ${res.status}` };
+        }
+        const json = (await res.json());
+        const data = json.data ?? json.models ?? [];
+        const models = data
+            .map((m) => String(m.id ?? m.name ?? ""))
+            .filter((m) => m && isLikelyChatModel(m));
+        return { ok: true, invalid: false, models };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            invalid: false,
+            models: [],
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/providers/catalog.js.map

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

package/dist/providers/context-window.d.ts

@@ -0,0 +1,11 @@
+/** Extract a context window from an OpenAI-compatible /models entry. */
+export declare function contextWindowFromModelEntry(entry: unknown): number | undefined;
+/** Compact token count used by the status line: 999, 1.2k, 256k, 1M. */
+export declare function formatTokenCount(count: number): string;
+/**
+ * Render `used/window`, matching the compact peer style (`1.2k/256k`).
+ * Unknown values are shown as `?` rather than a fake number.
+ */
+export declare function formatContextUsage(used: number | undefined, window: number | undefined): string;
+/** Guess a context window from the model id when no metadata is available. */
+export declare function knownContextWindow(model: string | undefined): number | undefined;