erosolar-cli 1.0.2 → 1.0.5

package/dist/contracts/v1/provider.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Provider Contract v1.0
+ *
+ * Stable interface for LLM provider integration.
+ */
+export declare const PROVIDER_CONTRACT_VERSION = "1.0.0";
+/**
+ * Provider configuration
+ */
+export interface ProviderConfig {
+    provider: string;
+    model: string;
+    apiKey?: string;
+    baseURL?: string;
+    temperature?: number;
+    maxTokens?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Conversation message structure
+ */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface BaseMessage {
+    role: MessageRole;
+    content: string;
+}
+export interface SystemMessage extends BaseMessage {
+    role: 'system';
+}
+export interface UserMessage extends BaseMessage {
+    role: 'user';
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface AssistantMessage extends BaseMessage {
+    role: 'assistant';
+    toolCalls?: ToolCall[];
+}
+export interface ToolMessage extends BaseMessage {
+    role: 'tool';
+    name: string;
+    toolCallId: string;
+}
+export type Message = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
+/**
+ * Tool definition for providers
+ */
+export interface ProviderToolDefinition {
+    name: string;
+    description: string;
+    parameters?: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+}
+/**
+ * Provider response types
+ */
+export interface ProviderUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+export interface ProviderMessageResponse {
+    type: 'message';
+    content: string;
+    usage?: ProviderUsage | null;
+}
+export interface ProviderToolCallsResponse {
+    type: 'tool_calls';
+    toolCalls: ToolCall[];
+    content?: string;
+    usage?: ProviderUsage | null;
+}
+export type ProviderResponse = ProviderMessageResponse | ProviderToolCallsResponse;
+/**
+ * Streaming response
+ */
+export interface StreamChunk {
+    type: 'content' | 'tool_call' | 'usage' | 'done';
+    content?: string;
+    toolCall?: Partial<ToolCall>;
+    usage?: ProviderUsage;
+}
+/**
+ * Provider interface
+ */
+export interface ILLMProvider {
+    readonly id: string;
+    readonly model: string;
+    /**
+     * Generate a completion (non-streaming)
+     */
+    generate(messages: Message[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    /**
+     * Generate a streaming completion
+     */
+    generateStream?(messages: Message[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    /**
+     * Get provider capabilities
+     */
+    getCapabilities(): ProviderCapabilities;
+}
+/**
+ * Provider capabilities
+ */
+export interface ProviderCapabilities {
+    streaming: boolean;
+    toolCalling: boolean;
+    vision: boolean;
+    functionCalling: boolean;
+    maxTokens: number;
+    supportedModalities: ('text' | 'image' | 'audio')[];
+}
+/**
+ * Provider factory
+ */
+export type ProviderFactory = (config: ProviderConfig) => ILLMProvider;
+/**
+ * Provider registry interface
+ */
+export interface IProviderRegistry {
+    /**
+     * Register a provider factory
+     */
+    register(providerId: string, factory: ProviderFactory): void;
+    /**
+     * Unregister a provider
+     */
+    unregister(providerId: string): void;
+    /**
+     * Create a provider instance
+     */
+    create(config: ProviderConfig): ILLMProvider;
+    /**
+     * Check if provider is registered
+     */
+    has(providerId: string): boolean;
+    /**
+     * List all registered providers
+     */
+    list(): string[];
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/contracts/v1/provider.d.ts.map

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

package/dist/contracts/v1/provider.js

@@ -4,3 +4,4 @@
  * Stable interface for LLM provider integration.
  */
 export const PROVIDER_CONTRACT_VERSION = '1.0.0';
+//# sourceMappingURL=provider.js.map

package/dist/contracts/v1/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/contracts/v1/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC"}

package/dist/contracts/v1/tool.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Tool Contract v1.0
+ *
+ * Stable interface for tool registration and execution.
+ */
+export declare const TOOL_CONTRACT_VERSION = "1.0.0";
+/**
+ * JSON Schema type definitions
+ */
+export interface JSONSchemaProperty {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string;
+    enum?: string[];
+    items?: JSONSchemaProperty;
+    properties?: Record<string, JSONSchemaProperty>;
+}
+export interface JSONSchemaObject {
+    type: 'object';
+    description?: string;
+    properties?: Record<string, JSONSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+/**
+ * Tool definition
+ */
+export interface IToolDefinition {
+    name: string;
+    description: string;
+    parameters?: JSONSchemaObject;
+    category?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool execution request
+ */
+export interface ToolExecutionRequest {
+    toolName: string;
+    executionId: string;
+    parameters: Record<string, unknown>;
+    context?: ToolExecutionContext;
+}
+/**
+ * Tool execution response
+ */
+export interface ToolExecutionResponse {
+    executionId: string;
+    success: boolean;
+    result?: string;
+    error?: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+    metadata?: {
+        elapsedMs?: number;
+        cached?: boolean;
+    };
+}
+/**
+ * Tool execution context
+ */
+export interface ToolExecutionContext {
+    workingDirectory?: string;
+    environment?: Record<string, string>;
+    user?: {
+        id: string;
+        permissions?: string[];
+    };
+}
+/**
+ * Tool suite definition
+ */
+export interface IToolSuite {
+    id: string;
+    name: string;
+    description?: string;
+    version?: string;
+    tools: IToolDefinition[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool handler function
+ */
+export type ToolHandler = (parameters: Record<string, unknown>, context?: ToolExecutionContext) => Promise<string> | string;
+/**
+ * Tool executor interface
+ */
+export interface IToolExecutor {
+    /**
+     * Execute a tool
+     */
+    execute(request: ToolExecutionRequest): Promise<ToolExecutionResponse>;
+    /**
+     * Check if a tool is available
+     */
+    hasToolAvailable(toolName: string): boolean;
+    /**
+     * List all available tools
+     */
+    listTools(): IToolDefinition[];
+    /**
+     * Get tool definition
+     */
+    getToolDefinition(toolName: string): IToolDefinition | null;
+}
+/**
+ * Tool registry interface
+ */
+export interface IToolRegistry {
+    /**
+     * Register a tool suite
+     */
+    registerSuite(suite: IToolSuite): void;
+    /**
+     * Unregister a tool suite
+     */
+    unregisterSuite(suiteId: string): void;
+    /**
+     * Register a single tool
+     */
+    registerTool(suiteId: string, definition: IToolDefinition, handler: ToolHandler): void;
+    /**
+     * Unregister a single tool
+     */
+    unregisterTool(toolName: string): void;
+    /**
+     * Get all registered suites
+     */
+    getSuites(): IToolSuite[];
+    /**
+     * Get a specific suite
+     */
+    getSuite(suiteId: string): IToolSuite | null;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/contracts/v1/tool.d.ts.map

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

package/dist/contracts/v1/tool.js

@@ -4,3 +4,4 @@
  * Stable interface for tool registration and execution.
  */
 export const TOOL_CONTRACT_VERSION = '1.0.0';
+//# sourceMappingURL=tool.js.map

package/dist/contracts/v1/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/contracts/v1/tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC"}

package/dist/contracts/v1/toolAccess.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Tool Selection Contract v1.0
+ *
+ * Enumerates the toggleable tool suites that can be surfaced to the agent at
+ * runtime plus optional presets that frontends can expose as one-click
+ * configurations.
+ */
+export declare const TOOL_SELECTION_CONTRACT_VERSION = "1.0.0";
+export type ToolPermissionScope = 'filesystem:read' | 'filesystem:write' | 'process:exec' | 'network:web' | 'network:api' | 'analysis:code' | 'analysis:quality' | 'analysis:dependency' | 'analysis:testing' | 'analysis:security' | 'planning:refactor' | 'external:web-search';
+export type ToolSelectionTarget = 'cli' | 'browser' | 'http' | 'worker' | 'service';
+export interface ToolAvailabilityOption {
+    id: string;
+    label: string;
+    description: string;
+    category?: string;
+    defaultEnabled: boolean;
+    pluginIds: string[];
+    requiresSecret?: string;
+    scopes?: ToolPermissionScope[];
+    metadata?: Record<string, unknown>;
+}
+export interface ToolSelectionPreset {
+    id: string;
+    label: string;
+    description?: string;
+    enabled?: string[];
+    disabled?: string[];
+    locked?: string[];
+    appliesTo?: ToolSelectionTarget[];
+    metadata?: Record<string, unknown>;
+    notes?: string;
+}
+export interface ToolSelectionManifest {
+    contractVersion: string;
+    profile: string;
+    version: string;
+    label?: string;
+    description?: string;
+    options: ToolAvailabilityOption[];
+    presets?: ToolSelectionPreset[];
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=toolAccess.d.ts.map

package/dist/contracts/v1/toolAccess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolAccess.d.ts","sourceRoot":"","sources":["../../../src/contracts/v1/toolAccess.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,+BAA+B,UAAU,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,GACd,aAAa,GACb,aAAa,GACb,eAAe,GACf,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/contracts/v1/toolAccess.js

@@ -0,0 +1,9 @@
+/**
+ * Tool Selection Contract v1.0
+ *
+ * Enumerates the toggleable tool suites that can be surfaced to the agent at
+ * runtime plus optional presets that frontends can expose as one-click
+ * configurations.
+ */
+export const TOOL_SELECTION_CONTRACT_VERSION = '1.0.0';
+//# sourceMappingURL=toolAccess.js.map

package/dist/contracts/v1/toolAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolAccess.js","sourceRoot":"","sources":["../../../src/contracts/v1/toolAccess.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,OAAO,CAAC"}

package/dist/core/agent.d.ts

@@ -0,0 +1,35 @@
+import type { ToolRuntime } from './toolRuntime.js';
+import { type ConversationMessage, type LLMProvider, type ProviderUsage } from './types.js';
+export interface AgentCallbacks {
+    onAssistantMessage?(content: string, metadata: AssistantMessageMetadata): void;
+}
+export interface AssistantMessageMetadata {
+    isFinal: boolean;
+    elapsedMs?: number;
+    usage?: ProviderUsage | null;
+}
+interface AgentOptions {
+    provider: LLMProvider;
+    toolRuntime: ToolRuntime;
+    systemPrompt: string;
+    callbacks?: AgentCallbacks;
+}
+export declare class AgentRuntime {
+    private readonly messages;
+    private readonly provider;
+    private readonly toolRuntime;
+    private readonly callbacks;
+    private activeRun;
+    private readonly baseSystemPrompt;
+    constructor(options: AgentOptions);
+    send(text: string): Promise<string>;
+    private processConversation;
+    private resolveToolCalls;
+    private get providerTools();
+    private emitAssistantMessage;
+    getHistory(): ConversationMessage[];
+    loadHistory(history: ConversationMessage[]): void;
+    clearHistory(): void;
+}
+export {};
+//# sourceMappingURL=agent.d.ts.map

package/dist/core/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAGhB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAChF;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9B;AAED,UAAU,YAAY;IACpB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;gBAErC,OAAO,EAAE,YAAY;IAY3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAkB3B,mBAAmB;YAgCnB,gBAAgB;IAY9B,OAAO,KAAK,aAAa,GAExB;IAED,OAAO,CAAC,oBAAoB;IAY5B,UAAU,IAAI,mBAAmB,EAAE;IAInC,WAAW,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAajD,YAAY,IAAI,IAAI;CAMrB"}

package/dist/core/agent.js

@@ -41,11 +41,14 @@ export class AgentRuntime {
                 if (narration) {
                     this.emitAssistantMessage(narration, { isFinal: false, usage });
                 }
-                this.messages.push({
+                const assistantMessage = {
                     role: 'assistant',
                     content: response.content ?? '',
-                    toolCalls: response.toolCalls,
-                });
+                };
+                if (response.toolCalls?.length) {
+                    assistantMessage.toolCalls = response.toolCalls;
+                }
+                this.messages.push(assistantMessage);
                 await this.resolveToolCalls(response.toolCalls);
                 continue;
             }
@@ -77,10 +80,11 @@ export class AgentRuntime {
             return;
         }
         const elapsedMs = this.activeRun ? Date.now() - this.activeRun.startedAt : undefined;
-        this.callbacks.onAssistantMessage?.(content, {
-            ...metadata,
-            elapsedMs,
-        });
+        const payload = { ...metadata };
+        if (typeof elapsedMs === 'number') {
+            payload.elapsedMs = elapsedMs;
+        }
+        this.callbacks.onAssistantMessage?.(content, payload);
     }
     getHistory() {
         return this.messages.map(cloneMessage);
@@ -107,11 +111,14 @@ export class AgentRuntime {
 function cloneMessage(message) {
     switch (message.role) {
         case 'assistant':
-            return {
+            const clone = {
                 role: 'assistant',
                 content: message.content,
-                toolCalls: message.toolCalls?.map(cloneToolCall),
             };
+            if (message.toolCalls) {
+                clone.toolCalls = message.toolCalls.map(cloneToolCall);
+            }
+            return clone;
         case 'tool':
             return {
                 role: 'tool',
@@ -133,3 +140,4 @@ function cloneToolCall(call) {
         arguments: { ...(call.arguments ?? {}) },
     };
 }
+//# sourceMappingURL=agent.js.map

package/dist/core/agent.js.map

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

package/dist/core/agentProfileManifest.d.ts

@@ -0,0 +1,3 @@
+import type { AgentProfileManifest } from '../contracts/v1/agentProfileManifest.js';
+export declare function getAgentProfileManifest(): AgentProfileManifest;
+//# sourceMappingURL=agentProfileManifest.d.ts.map

package/dist/core/agentProfileManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentProfileManifest.d.ts","sourceRoot":"","sources":["../../src/core/agentProfileManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EAKrB,MAAM,yCAAyC,CAAC;AAoBjD,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D"}