erosolar-cli 1.5.3 → 1.5.5

package/dist/bin/plugins/tools/registry.js

@@ -0,0 +1,57 @@
+const registry = new Map();
+export function registerToolPlugin(plugin) {
+    if (!plugin?.id?.trim()) {
+        throw new Error('Tool plugin id cannot be blank.');
+    }
+    registry.set(plugin.id, normalizePlugin(plugin));
+}
+export function unregisterToolPlugin(id) {
+    registry.delete(id);
+}
+export function listRegisteredToolPlugins() {
+    return Array.from(registry.values());
+}
+export async function instantiateToolPlugins(target, context, options = {}) {
+    const modules = [];
+    for (const plugin of registry.values()) {
+        if (!supportsTarget(plugin, target)) {
+            continue;
+        }
+        if (options.filter && !options.filter(plugin)) {
+            continue;
+        }
+        const result = await plugin.create(context);
+        if (!result) {
+            continue;
+        }
+        if (Array.isArray(result)) {
+            for (const entry of result) {
+                if (entry) {
+                    modules.push(entry);
+                }
+            }
+        }
+        else {
+            modules.push(result);
+        }
+    }
+    return modules;
+}
+function normalizePlugin(plugin) {
+    if (!plugin.targets?.length) {
+        return {
+            ...plugin,
+            targets: ['universal'],
+        };
+    }
+    return {
+        ...plugin,
+        targets: Array.from(new Set(plugin.targets)),
+    };
+}
+function supportsTarget(plugin, target) {
+    if (plugin.targets.includes('universal')) {
+        return true;
+    }
+    return plugin.targets.includes(target);
+}

package/dist/bin/plugins/tools/search/localSearchPlugin.js

@@ -0,0 +1,13 @@
+import { SearchCapabilityModule } from '../../../capabilities/searchCapability.js';
+export function createLocalSearchToolPlugin() {
+    return {
+        id: 'tool.search.local',
+        description: 'Local ripgrep-based search tooling.',
+        targets: ['node', 'cloud'],
+        create: (context) => {
+            return new SearchCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/skills/skillPlugin.js

@@ -0,0 +1,8 @@
+import { skillCapability } from '../../../capabilities/skillCapability.js';
+export function createSkillToolPlugin() {
+    return {
+        id: 'tool.skills.loader',
+        targets: ['node', 'cloud'],
+        create: () => skillCapability,
+    };
+}

package/dist/bin/plugins/tools/taskManagement/taskManagementPlugin.js

@@ -0,0 +1,11 @@
+import { TaskManagementCapabilityModule } from '../../../capabilities/taskManagementCapability.js';
+export function createTaskManagementToolPlugin() {
+    return {
+        id: 'tool.task-management.local',
+        description: 'Task tracking and planning tools for organizing complex multi-step work.',
+        targets: ['node', 'cloud'],
+        create: (_context) => {
+            return new TaskManagementCapabilityModule({});
+        },
+    };
+}

package/dist/bin/plugins/tools/testing/testingPlugin.js

@@ -0,0 +1,11 @@
+import { TestingCapabilityModule } from '../../../capabilities/testingCapability.js';
+export function createTestingToolPlugin() {
+    return {
+        id: 'tool.testing.coverage',
+        description: 'Test generation scaffolding plus coverage execution/reporting utilities.',
+        targets: ['node'],
+        create: async (context) => new TestingCapabilityModule({
+            workingDir: context.workingDir,
+        }),
+    };
+}

package/dist/bin/plugins/tools/web/webPlugin.js

@@ -0,0 +1,11 @@
+import { WebCapabilityModule } from '../../../capabilities/webCapability.js';
+export function createWebToolPlugin() {
+    return {
+        id: 'tool.web.local',
+        description: 'Web content fetching and search tools for accessing online information.',
+        targets: ['node', 'cloud'],
+        create: (_context) => {
+            return new WebCapabilityModule({});
+        },
+    };
+}

package/dist/bin/providers/anthropicProvider.js

@@ -0,0 +1,329 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { APIError, RateLimitError } from '@anthropic-ai/sdk/error.js';
+const DEFAULT_RATE_LIMIT_RETRIES = 4;
+const DEFAULT_RATE_LIMIT_INITIAL_DELAY_MS = 1500;
+const MIN_RATE_LIMIT_DELAY_MS = 750;
+const MAX_RATE_LIMIT_DELAY_MS = 40000;
+export class AnthropicMessagesProvider {
+    constructor(options) {
+        this.id = 'anthropic';
+        this.client = new Anthropic({ apiKey: options.apiKey });
+        this.model = options.model;
+        this.maxTokens = options.maxTokens ?? 2048;
+        this.temperature = options.temperature ?? 0;
+        this.rateLimitMaxRetries = Math.max(0, options.rateLimitMaxRetries ?? DEFAULT_RATE_LIMIT_RETRIES);
+        this.rateLimitInitialDelayMs = Math.max(MIN_RATE_LIMIT_DELAY_MS, options.rateLimitInitialDelayMs ?? DEFAULT_RATE_LIMIT_INITIAL_DELAY_MS);
+        this.enablePromptCaching = options.enablePromptCaching ?? true;
+    }
+    async generate(messages, tools) {
+        const { system, chat } = convertConversation(messages, this.enablePromptCaching);
+        const response = await this.executeWithRateLimitRetries(() => this.client.messages.create({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            messages: chat,
+            ...(system ? { system } : {}),
+            ...(tools.length ? { tools: tools.map(mapTool) } : {}),
+        }));
+        const usage = mapUsage(response.usage);
+        const toolCalls = response.content
+            .filter((block) => block.type === 'tool_use')
+            .map((block) => ({
+            id: block.id,
+            name: block.name,
+            arguments: toRecord(block.input),
+        }));
+        const textContent = response.content
+            .filter((block) => block.type === 'text')
+            .map((block) => ('text' in block ? block.text : ''))
+            .join('\n')
+            .trim();
+        if (toolCalls.length > 0) {
+            return {
+                type: 'tool_calls',
+                toolCalls,
+                content: textContent,
+                usage,
+            };
+        }
+        return {
+            type: 'message',
+            content: textContent,
+            usage,
+        };
+    }
+    async *generateStream(messages, tools) {
+        const { system, chat } = convertConversation(messages, this.enablePromptCaching);
+        const stream = this.client.messages.stream({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            messages: chat,
+            ...(system ? { system } : {}),
+            ...(tools.length ? { tools: tools.map(mapTool) } : {}),
+        });
+        let currentToolCall = null;
+        let currentToolCallInput = '';
+        let toolCallId = '';
+        for await (const event of stream) {
+            // Handle different event types
+            if (event.type === 'content_block_start') {
+                const block = event.content_block;
+                if (block.type === 'tool_use') {
+                    toolCallId = block.id;
+                    currentToolCall = {
+                        id: block.id,
+                        name: block.name,
+                        arguments: {},
+                    };
+                    currentToolCallInput = '';
+                }
+            }
+            else if (event.type === 'content_block_delta') {
+                const delta = event.delta;
+                if (delta.type === 'text_delta') {
+                    yield {
+                        type: 'content',
+                        content: delta.text,
+                    };
+                }
+                else if (delta.type === 'input_json_delta' && currentToolCall) {
+                    // accumulate tool input JSON fragments
+                    if (typeof delta.partial_json === 'string' && delta.partial_json) {
+                        currentToolCallInput += delta.partial_json;
+                    }
+                }
+            }
+            else if (event.type === 'content_block_stop') {
+                if (currentToolCall && toolCallId) {
+                    if (currentToolCallInput.trim()) {
+                        try {
+                            currentToolCall.arguments = toRecord(JSON.parse(currentToolCallInput));
+                        }
+                        catch {
+                            currentToolCall.arguments = {};
+                        }
+                    }
+                    yield {
+                        type: 'tool_call',
+                        toolCall: currentToolCall,
+                    };
+                    currentToolCall = null;
+                    currentToolCallInput = '';
+                    toolCallId = '';
+                }
+            }
+            else if (event.type === 'message_stop') {
+                const finalMessage = await stream.finalMessage();
+                const usage = mapUsage(finalMessage.usage);
+                if (usage) {
+                    yield {
+                        type: 'usage',
+                        usage,
+                    };
+                }
+                yield {
+                    type: 'done',
+                };
+            }
+        }
+    }
+    getCapabilities() {
+        return {
+            streaming: true,
+            toolCalling: true,
+            vision: this.model.includes('sonnet') || this.model.includes('opus'),
+            functionCalling: true,
+            maxTokens: this.maxTokens,
+            supportedModalities: ['text', 'image'],
+        };
+    }
+    async executeWithRateLimitRetries(operation) {
+        let retries = 0;
+        let delayMs = this.rateLimitInitialDelayMs;
+        while (true) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                if (!isRateLimitError(error)) {
+                    throw error;
+                }
+                if (retries >= this.rateLimitMaxRetries) {
+                    throw buildRateLimitFailureError(error, retries);
+                }
+                const waitMs = determineRetryDelay(error.headers, delayMs);
+                await sleep(waitMs);
+                retries += 1;
+                delayMs = Math.min(delayMs * 2, MAX_RATE_LIMIT_DELAY_MS);
+            }
+        }
+    }
+}
+function convertConversation(messages, enablePromptCaching = false) {
+    const systemPrompts = [];
+    const chat = [];
+    for (const message of messages) {
+        switch (message.role) {
+            case 'system': {
+                systemPrompts.push(message.content);
+                break;
+            }
+            case 'user': {
+                chat.push({
+                    role: 'user',
+                    content: [{ type: 'text', text: message.content }],
+                });
+                break;
+            }
+            case 'assistant': {
+                const contentBlocks = [];
+                if (message.content.trim().length > 0) {
+                    contentBlocks.push({ type: 'text', text: message.content });
+                }
+                for (const call of message.toolCalls ?? []) {
+                    contentBlocks.push({
+                        type: 'tool_use',
+                        id: call.id,
+                        name: call.name,
+                        input: call.arguments,
+                    });
+                }
+                chat.push({
+                    role: 'assistant',
+                    content: contentBlocks.length ? contentBlocks : [{ type: 'text', text: '' }],
+                });
+                break;
+            }
+            case 'tool': {
+                const block = {
+                    type: 'tool_result',
+                    tool_use_id: message.toolCallId,
+                    content: [{ type: 'text', text: message.content }],
+                };
+                chat.push({
+                    role: 'user',
+                    content: [block],
+                });
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    // Add cache control breakpoints to optimize costs
+    // Cache the first few user messages (usually contain system context)
+    if (enablePromptCaching && chat.length > 2) {
+        const cacheBreakpoint = Math.min(2, chat.length - 1);
+        for (let i = 0; i < cacheBreakpoint; i++) {
+            const message = chat[i];
+            if (message && message.role === 'user' && Array.isArray(message.content)) {
+                const lastContent = message.content[message.content.length - 1];
+                if (lastContent && 'text' in lastContent) {
+                    lastContent['cache_control'] = { type: 'ephemeral' };
+                }
+            }
+        }
+    }
+    return {
+        system: systemPrompts.length ? systemPrompts.join('\n\n') : null,
+        chat,
+    };
+}
+function mapTool(definition) {
+    return {
+        name: definition.name,
+        description: definition.description,
+        input_schema: definition.parameters ?? {
+            type: 'object',
+            properties: {},
+        },
+    };
+}
+function toRecord(value) {
+    if (isPlainRecord(value)) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed) {
+            return {};
+        }
+        try {
+            const parsed = JSON.parse(trimmed);
+            return isPlainRecord(parsed) ? parsed : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    return {};
+}
+function isPlainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function mapUsage(usage) {
+    if (!usage) {
+        return null;
+    }
+    const total = typeof usage.input_tokens === 'number' && typeof usage.output_tokens === 'number'
+        ? usage.input_tokens + usage.output_tokens
+        : undefined;
+    return {
+        inputTokens: usage.input_tokens,
+        outputTokens: usage.output_tokens,
+        totalTokens: total,
+    };
+}
+function isRateLimitError(error) {
+    if (error instanceof RateLimitError) {
+        return true;
+    }
+    if (error instanceof APIError && error.status === 429) {
+        return true;
+    }
+    return typeof error === 'object' && error !== null && 'status' in error && error.status === 429;
+}
+function determineRetryDelay(headers, fallbackMs) {
+    const retryAfter = parseRetryAfterHeader(headers);
+    if (retryAfter !== null) {
+        return clamp(retryAfter, MIN_RATE_LIMIT_DELAY_MS, MAX_RATE_LIMIT_DELAY_MS);
+    }
+    const jitter = fallbackMs * 0.25;
+    const randomized = fallbackMs + (Math.random() * (2 * jitter) - jitter);
+    return clamp(Math.round(randomized), MIN_RATE_LIMIT_DELAY_MS, MAX_RATE_LIMIT_DELAY_MS);
+}
+function parseRetryAfterHeader(headers) {
+    if (!headers || typeof headers.get !== 'function') {
+        return null;
+    }
+    const retryAfter = headers.get('retry-after');
+    if (!retryAfter) {
+        return null;
+    }
+    const numeric = Number(retryAfter);
+    if (Number.isFinite(numeric) && numeric >= 0) {
+        return numeric * 1000;
+    }
+    const parsedDate = Date.parse(retryAfter);
+    if (Number.isFinite(parsedDate)) {
+        return Math.max(0, parsedDate - Date.now());
+    }
+    return null;
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+async function sleep(durationMs) {
+    await new Promise((resolve) => setTimeout(resolve, durationMs));
+}
+function buildRateLimitFailureError(error, retries) {
+    const baseMessage = 'Anthropic rejected the request because the per-minute token rate limit was exceeded.';
+    const retryDetails = retries > 0 ? ` Waited and retried ${retries} time${retries === 1 ? '' : 's'} without success.` : '';
+    const advisory = ' Reduce the prompt size or wait for usage to reset before trying again. ' +
+        'See https://docs.claude.com/en/api/rate-limits for quota guidance.';
+    const original = error.message ? `\nOriginal message: ${error.message}` : '';
+    return new Error(`${baseMessage}${retryDetails}${advisory}${original}`, {
+        cause: error,
+    });
+}

package/dist/bin/providers/googleProvider.js

@@ -0,0 +1,203 @@
+import { GoogleGenAI, } from '@google/genai';
+export class GoogleGenAIProvider {
+    constructor(options) {
+        this.client = new GoogleGenAI({
+            apiKey: options.apiKey,
+        });
+        this.id = options.providerId ?? 'google';
+        this.model = options.model;
+        this.temperature = options.temperature;
+        this.maxOutputTokens = options.maxOutputTokens;
+    }
+    async generate(messages, tools) {
+        const { contents, systemInstruction } = mapConversation(messages);
+        const config = {};
+        if (systemInstruction) {
+            config.systemInstruction = systemInstruction;
+        }
+        if (typeof this.temperature === 'number') {
+            config.temperature = this.temperature;
+        }
+        if (typeof this.maxOutputTokens === 'number') {
+            config.maxOutputTokens = this.maxOutputTokens;
+        }
+        const mappedTools = mapTools(tools);
+        if (mappedTools.length > 0) {
+            config.tools = mappedTools;
+        }
+        const response = await this.client.models.generateContent({
+            model: this.model,
+            contents: contents.length ? contents : createEmptyUserContent(),
+            config: Object.keys(config).length ? config : undefined,
+        });
+        const usage = mapUsage(response.usageMetadata);
+        const toolCalls = mapFunctionCalls(response.functionCalls ?? []);
+        const content = response.text?.trim() ?? '';
+        if (toolCalls.length > 0) {
+            return {
+                type: 'tool_calls',
+                toolCalls,
+                content,
+                usage,
+            };
+        }
+        return {
+            type: 'message',
+            content,
+            usage,
+        };
+    }
+}
+function mapConversation(messages) {
+    const contents = [];
+    const systemPrompts = [];
+    for (const message of messages) {
+        switch (message.role) {
+            case 'system': {
+                if (message.content.trim()) {
+                    systemPrompts.push(message.content.trim());
+                }
+                break;
+            }
+            case 'user': {
+                contents.push({
+                    role: 'user',
+                    parts: [{ text: message.content }],
+                });
+                break;
+            }
+            case 'assistant': {
+                contents.push(mapAssistantMessage(message));
+                break;
+            }
+            case 'tool': {
+                const content = mapToolMessage(message);
+                if (content) {
+                    contents.push(content);
+                }
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    return {
+        contents,
+        systemInstruction: systemPrompts.length ? systemPrompts.join('\n\n') : undefined,
+    };
+}
+function mapAssistantMessage(message) {
+    const parts = [];
+    const text = message.content.trim();
+    if (text) {
+        parts.push({ text });
+    }
+    for (const call of message.toolCalls ?? []) {
+        parts.push({
+            functionCall: {
+                id: call.id || undefined,
+                name: call.name,
+                args: toRecord(call.arguments),
+            },
+        });
+    }
+    return {
+        role: 'model',
+        parts: parts.length ? parts : [{ text: '' }],
+    };
+}
+function mapToolMessage(message) {
+    if (!message.toolCallId) {
+        return null;
+    }
+    return {
+        role: 'user',
+        parts: [
+            {
+                functionResponse: {
+                    id: message.toolCallId,
+                    name: message.name,
+                    response: parseToolResponse(message.content),
+                },
+            },
+        ],
+    };
+}
+function parseToolResponse(content) {
+    const trimmed = content.trim();
+    if (!trimmed) {
+        return { output: '' };
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+    }
+    return { output: content };
+}
+function mapFunctionCalls(calls) {
+    return calls
+        .filter((call) => Boolean(call.name))
+        .map((call) => ({
+        id: call.id || call.name || 'function_call',
+        name: call.name ?? 'function_call',
+        arguments: toRecord(call.args),
+    }));
+}
+function createEmptyUserContent() {
+    return [
+        {
+            role: 'user',
+            parts: [{ text: '' }],
+        },
+    ];
+}
+function mapTools(tools) {
+    if (!tools.length) {
+        return [];
+    }
+    return [
+        {
+            functionDeclarations: tools.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                parametersJsonSchema: tool.parameters ?? { type: 'object', properties: {} },
+            })),
+        },
+    ];
+}
+function mapUsage(metadata) {
+    if (!metadata) {
+        return null;
+    }
+    return {
+        inputTokens: metadata.promptTokenCount ?? undefined,
+        outputTokens: metadata.candidatesTokenCount ?? undefined,
+        totalTokens: metadata.totalTokenCount ?? undefined,
+    };
+}
+function toRecord(value) {
+    if (isPlainRecord(value)) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed) {
+            return {};
+        }
+        try {
+            const parsed = JSON.parse(trimmed);
+            return isPlainRecord(parsed) ? parsed : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    return {};
+}
+function isPlainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}