erosolar-cli 1.0.2 → 1.0.5

package/dist/contracts/agent-schemas.json

@@ -0,0 +1,293 @@
+{
+  "$schema": "./schemas/agent-schemas.schema.json",
+  "contractVersion": "1.0.0",
+  "version": "2024-11-24",
+  "label": "Erosolar CLI Agent Configuration Schema",
+  "description": "Centralized configuration for all agents, models, providers, and capabilities",
+
+  "providers": [
+    {
+      "id": "openai",
+      "label": "OpenAI",
+      "description": "OpenAI GPT models including GPT-5 series",
+      "envVars": {
+        "apiKey": "OPENAI_API_KEY"
+      },
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "anthropic",
+      "label": "Anthropic",
+      "description": "Anthropic Claude models including Sonnet, Opus, and Haiku",
+      "envVars": {
+        "apiKey": "ANTHROPIC_API_KEY"
+      },
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "deepseek",
+      "label": "DeepSeek",
+      "description": "DeepSeek reasoning and chat models",
+      "envVars": {
+        "apiKey": "DEEPSEEK_API_KEY"
+      },
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "xai",
+      "label": "xAI",
+      "description": "xAI Grok models for coding and reasoning",
+      "envVars": {
+        "apiKey": "XAI_API_KEY"
+      },
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "google",
+      "label": "Google",
+      "description": "Google Gemini models with multimodal capabilities",
+      "envVars": {
+        "apiKey": "GOOGLE_API_KEY"
+      },
+      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+    }
+  ],
+
+  "models": [
+    {
+      "id": "gpt-5.1-codex",
+      "label": "gpt-5.1-codex",
+      "provider": "openai",
+      "description": "Optimized for Erosolar Code with the latest coding weights from OpenAI.",
+      "reasoningEffort": "medium",
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "gpt-5.1",
+      "label": "gpt-5.1",
+      "provider": "openai",
+      "description": "Balanced reasoning model when you need equal parts code and analysis.",
+      "reasoningEffort": "medium",
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "gpt-5-pro",
+      "label": "gpt-5-pro",
+      "provider": "openai",
+      "description": "OpenAI's flagship GPT-5 Pro for maximum depth and planning.",
+      "reasoningEffort": "medium",
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "gpt-5-mini",
+      "label": "gpt-5-mini",
+      "provider": "openai",
+      "description": "GPT-5 Mini with faster turnarounds while staying code-aware.",
+      "reasoningEffort": "medium",
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "gpt-5-nano",
+      "label": "gpt-5-nano",
+      "provider": "openai",
+      "description": "Ultra-responsive GPT-5 Nano tuned for edits and quick summaries.",
+      "reasoningEffort": "medium",
+      "capabilities": ["chat", "tools", "streaming"]
+    },
+    {
+      "id": "claude-sonnet-4-5-20250929",
+      "label": "sonnet-4.5",
+      "provider": "anthropic",
+      "description": "Anthropic Sonnet 4.5 tuned for deeper planning across large repositories.",
+      "temperature": 0.7,
+      "maxTokens": 4096,
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "claude-opus-4.1",
+      "label": "opus-4.1",
+      "provider": "anthropic",
+      "description": "Anthropic Opus 4.1 for the richest Claude reasoning runs.",
+      "temperature": 0.7,
+      "maxTokens": 4096,
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "claude-haiku-4.5",
+      "label": "haiku-4.5",
+      "provider": "anthropic",
+      "description": "Anthropic Haiku 4.5 focused on latency-sensitive workflows.",
+      "temperature": 0.5,
+      "maxTokens": 4096,
+      "capabilities": ["chat", "tools", "streaming"]
+    },
+    {
+      "id": "deepseek-reasoner",
+      "label": "deepseek-reasoner",
+      "provider": "deepseek",
+      "description": "DeepSeek Reasoner for chain-of-thought exploration with tool depth.",
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "deepseek-chat",
+      "label": "deepseek-chat",
+      "provider": "deepseek",
+      "description": "DeepSeek Chat for faster interactive editing and summarization.",
+      "capabilities": ["chat", "tools", "streaming"]
+    },
+    {
+      "id": "grok-4",
+      "label": "grok-4",
+      "provider": "xai",
+      "description": "xAI Grok-4 for their highest quality coding and reasoning responses.",
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "grok-4-fast-reasoning",
+      "label": "grok-4-fast-reasoning",
+      "provider": "xai",
+      "description": "Grok-4 fast reasoning mode when you need lower latency with thinking enabled.",
+      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    },
+    {
+      "id": "grok-4-fast-non-reasoning",
+      "label": "grok-4-fast-non-reasoning",
+      "provider": "xai",
+      "description": "Grok-4 fast non reasoning variant for concise edits and summaries.",
+      "capabilities": ["chat", "tools", "streaming"]
+    },
+    {
+      "id": "grok-code-fast-1",
+      "label": "grok-code-fast-1",
+      "provider": "xai",
+      "description": "xAI Grok Code Fast 1 tuned specifically for rapid coding assistance.",
+      "capabilities": ["chat", "tools", "streaming"]
+    },
+    {
+      "id": "gemini-2.5-pro",
+      "label": "gemini-2.5-pro",
+      "provider": "google",
+      "description": "Google Gemini 2.5 Pro for multimodal deep reasoning with longer outputs.",
+      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+    },
+    {
+      "id": "gemini-2.5-flash",
+      "label": "gemini-2.5-flash",
+      "provider": "google",
+      "description": "Google Gemini 2.5 Flash for lower-latency edits and iterative coding.",
+      "capabilities": ["chat", "tools", "streaming", "multimodal"]
+    }
+  ],
+
+  "profiles": [
+    {
+      "name": "general",
+      "label": "Erosolar",
+      "description": "General-purpose operator with balanced reasoning across research, planning, writing, and coding tasks.",
+      "defaultProvider": "openai",
+      "defaultModel": "gpt-5.1",
+      "temperature": 0.2,
+      "systemPrompt": {
+        "type": "rulebook",
+        "template": "{{rulebook}}"
+      },
+      "rulebook": {
+        "file": "agents/general.rules.json",
+        "version": "2024-11-24",
+        "contractVersion": "1.0.0",
+        "description": "Structured rules governing the balanced Erosolar profile."
+      },
+      "metadata": {
+        "primaryUseCase": "general-purpose",
+        "tags": ["balanced", "research", "planning", "coding"]
+      }
+    },
+    {
+      "name": "erosolar-code",
+      "label": "Erosolar Code",
+      "description": "OpenAI-tuned coding specialist optimized for rapid edits with deterministic grounding.",
+      "defaultProvider": "openai",
+      "defaultModel": "gpt-5.1-codex",
+      "systemPrompt": {
+        "type": "rulebook"
+      },
+      "rulebook": {
+        "file": "agents/erosolar-code.rules.json",
+        "version": "2024-11-24",
+        "contractVersion": "1.0.0",
+        "description": "Deterministic coding workflow guardrails."
+      },
+      "metadata": {
+        "primaryUseCase": "coding",
+        "tags": ["coding", "deterministic", "rapid-edits"]
+      }
+    }
+  ],
+
+  "slashCommands": [
+    {
+      "command": "/model",
+      "description": "Choose what model to use",
+      "category": "configuration"
+    },
+    {
+      "command": "/secrets",
+      "description": "Configure API keys",
+      "category": "configuration"
+    },
+    {
+      "command": "/tools",
+      "description": "Enable or disable CLI tools",
+      "category": "configuration"
+    },
+    {
+      "command": "/doctor",
+      "description": "Check environment, secrets, and tool readiness",
+      "category": "diagnostics"
+    },
+    {
+      "command": "/checks",
+      "description": "Run repo checks (npm test / npm run build / npm run lint)",
+      "category": "diagnostics"
+    },
+    {
+      "command": "/context",
+      "description": "Refresh workspace snapshot (depth/excerpt overrides)",
+      "category": "workspace"
+    }
+  ],
+
+  "capabilities": [
+    {
+      "id": "chat",
+      "label": "Chat",
+      "description": "Basic conversational capabilities"
+    },
+    {
+      "id": "reasoning",
+      "label": "Reasoning",
+      "description": "Extended chain-of-thought reasoning capabilities"
+    },
+    {
+      "id": "tools",
+      "label": "Tool Use",
+      "description": "Ability to call external tools and functions"
+    },
+    {
+      "id": "streaming",
+      "label": "Streaming",
+      "description": "Support for streaming responses"
+    },
+    {
+      "id": "multimodal",
+      "label": "Multimodal",
+      "description": "Support for images and other non-text inputs"
+    }
+  ],
+
+  "metadata": {
+    "schemaVersion": "1.0.0",
+    "lastUpdated": "2024-11-24",
+    "description": "This is the single source of truth for all agent configurations in the Erosolar CLI"
+  }
+}

package/dist/contracts/schemas/agent-profile.schema.json

@@ -0,0 +1,157 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Agent Profile Manifest v1.0",
+  "description": "Schema describing agent profiles, their default providers/models, and how system prompts are constructed.",
+  "type": "object",
+  "required": ["contractVersion", "version", "profiles"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "description": "Version of the profile manifest contract the payload implements."
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic or date-based version identifier for the manifest."
+    },
+    "label": {
+      "type": "string",
+      "description": "Optional display label for the manifest."
+    },
+    "description": {
+      "type": "string",
+      "description": "Optional description for operators."
+    },
+    "profiles": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/definitions/ProfileEntry"
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Implementation specific metadata."
+    }
+  },
+  "definitions": {
+    "ProfileEntry": {
+      "type": "object",
+      "required": ["name", "label", "defaultProvider", "defaultModel", "systemPrompt", "rulebook"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Stable identifier for the agent profile."
+        },
+        "label": {
+          "type": "string",
+          "description": "Human readable profile label."
+        },
+        "description": {
+          "type": "string",
+          "description": "Optional description rendered in UIs."
+        },
+        "defaultProvider": {
+          "type": "string",
+          "description": "Provider identifier the profile defaults to."
+        },
+        "defaultModel": {
+          "type": "string",
+          "description": "Default model identifier for the profile."
+        },
+        "temperature": {
+          "type": "number",
+          "description": "Optional default temperature."
+        },
+        "maxTokens": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Optional default max token count."
+        },
+        "systemPrompt": {
+          "$ref": "#/definitions/PromptConfig"
+        },
+        "rulebook": {
+          "$ref": "#/definitions/RulebookReference"
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Implementation specific metadata."
+        }
+      },
+      "additionalProperties": false
+    },
+    "PromptConfig": {
+      "oneOf": [
+        {
+          "$ref": "#/definitions/RulebookPromptConfig"
+        },
+        {
+          "$ref": "#/definitions/LiteralPromptConfig"
+        }
+      ]
+    },
+    "RulebookPromptConfig": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "const": "rulebook"
+        },
+        "template": {
+          "type": "string",
+          "description": "Optional template with placeholders like {{rulebook}}."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Implementation specific metadata."
+        }
+      },
+      "additionalProperties": false
+    },
+    "LiteralPromptConfig": {
+      "type": "object",
+      "required": ["type", "content"],
+      "properties": {
+        "type": {
+          "const": "literal"
+        },
+        "content": {
+          "type": "string",
+          "description": "Static system prompt to use verbatim."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Implementation specific metadata."
+        }
+      },
+      "additionalProperties": false
+    },
+    "RulebookReference": {
+      "type": "object",
+      "required": ["file"],
+      "properties": {
+        "file": {
+          "type": "string",
+          "description": "Relative path to the rulebook JSON file."
+        },
+        "version": {
+          "type": "string",
+          "description": "Optional human readable version of the rulebook."
+        },
+        "contractVersion": {
+          "type": "string",
+          "description": "Optional contract version for the referenced rulebook."
+        },
+        "description": {
+          "type": "string",
+          "description": "Summary of what the rulebook enforces."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Implementation specific metadata."
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/dist/contracts/schemas/agent-rules.schema.json

@@ -0,0 +1,238 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Agent Ruleset Contract v1.0",
+  "description": "Schema describing the ordered phases, steps, and rules that govern agent execution.",
+  "type": "object",
+  "required": ["contractVersion", "profile", "version", "phases"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "description": "Version of the agent rules contract the payload adheres to."
+    },
+    "profile": {
+      "type": "string",
+      "description": "Profile identifier the ruleset targets (e.g., general, erosolar-code)."
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic or date-based version of the ruleset."
+    },
+    "label": {
+      "type": "string",
+      "description": "Optional human readable name for the ruleset."
+    },
+    "description": {
+      "type": "string",
+      "description": "Optional long form description for the ruleset."
+    },
+    "globalPrinciples": {
+      "type": "array",
+      "description": "Rules that apply to every phase and step.",
+      "items": {
+        "$ref": "#/definitions/Rule"
+      }
+    },
+    "phases": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/definitions/Phase"
+      },
+      "description": "Ordered phases the agent should move through."
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Optional implementation specific metadata."
+    }
+  },
+  "definitions": {
+    "Phase": {
+      "type": "object",
+      "required": ["id", "label", "steps"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Stable identifier for the phase."
+        },
+        "label": {
+          "type": "string",
+          "description": "Display name for operators."
+        },
+        "description": {
+          "type": "string",
+          "description": "What the phase accomplishes."
+        },
+        "trigger": {
+          "type": "string",
+          "description": "Events or conditions that start the phase."
+        },
+        "steps": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/definitions/Step"
+          },
+          "description": "Steps within the phase."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Additional data used by tooling."
+        }
+      }
+    },
+    "Step": {
+      "type": "object",
+      "required": ["id", "title", "rules"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Stable identifier for the step."
+        },
+        "title": {
+          "type": "string",
+          "description": "Name of the step."
+        },
+        "description": {
+          "type": "string",
+          "description": "High-level summary of the step."
+        },
+        "intent": {
+          "type": "string",
+          "description": "Goal the agent should accomplish."
+        },
+        "entryCriteria": {
+          "type": "array",
+          "description": "Conditions that must be true before the step begins.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "exitCriteria": {
+          "type": "array",
+          "description": "Conditions that must be satisfied before leaving the step.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "allowedTools": {
+          "type": "array",
+          "description": "Tool IDs explicitly allowed during the step.",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "blockedTools": {
+          "type": "array",
+          "description": "Tool IDs that are prohibited while inside the step.",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "notes": {
+          "type": "array",
+          "description": "Free-form operator notes for the step.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "rules": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/definitions/Rule"
+          },
+          "description": "Rules that must be followed while executing the step."
+        },
+        "subSteps": {
+          "type": "array",
+          "description": "Nested sub-steps that inherit context from the parent.",
+          "items": {
+            "$ref": "#/definitions/Step"
+          }
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Implementation specific details."
+        }
+      }
+    },
+    "Rule": {
+      "type": "object",
+      "required": ["id", "summary", "severity"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Stable identifier for the rule."
+        },
+        "summary": {
+          "type": "string",
+          "description": "Short instruction that must be enforced."
+        },
+        "detail": {
+          "type": "string",
+          "description": "Extended rationale or clarification."
+        },
+        "severity": {
+          "type": "string",
+          "enum": ["critical", "required", "recommended"],
+          "description": "How strictly the rule must be enforced."
+        },
+        "appliesDuring": {
+          "type": "array",
+          "description": "Optional labels describing where the rule applies (analysis, planning, edits, etc.).",
+          "items": {
+            "type": "string"
+          }
+        },
+        "evidenceRequired": {
+          "type": "string",
+          "description": "Evidence the agent must cite when reporting compliance."
+        },
+        "references": {
+          "type": "array",
+          "description": "Supporting documentation for the rule.",
+          "items": {
+            "$ref": "#/definitions/Reference"
+          }
+        },
+        "toolHints": {
+          "type": "array",
+          "description": "Suggested tools for satisfying the rule.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Implementation specific metadata."
+        }
+      }
+    },
+    "Reference": {
+      "type": "object",
+      "required": ["label"],
+      "properties": {
+        "label": {
+          "type": "string",
+          "description": "Human readable name for the reference."
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Optional link to supporting documentation."
+        },
+        "file": {
+          "type": "string",
+          "description": "Workspace relative file reference."
+        },
+        "line": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Line number in the referenced file."
+        }
+      }
+    }
+  }
+}