opalacoder 0.2.0__tar.gz → 0.2.3__tar.gz

{opalacoder-0.2.0 → opalacoder-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opalacoder
-Version: 0.2.0
+Version: 0.2.3
 Summary: Autonomous coding agent with interactive planning and modular execution
 Project-URL: Homepage, https://github.com/gilzamir/OpalaCoder
 Project-URL: Bug Tracker, https://github.com/gilzamir/OpalaCoder/issues

{opalacoder-0.2.0 → opalacoder-0.2.3}/docs/specs/07-configuracao.md

@@ -141,7 +141,223 @@ De `build_parser` ([cli.py:419](../../opalacoder/cli.py#L419)):
 
 ---
 
-## 5. Comandos do REPL
+## 5. AssetStore — Repositório de Assets Reutilizáveis
+
+> **Estado: IMPLEMENTADO**
+
+### Conceito
+
+A AssetStore é um **repositório local de assets reutilizáveis** empacotados com o OpalaCoder. Ela serve como banco de dados de casos bem-sucedidos de configuração para modelos locais e como biblioteca de skills extras que podem ser instaladas sob demanda em qualquer projeto.
+
+```
+opalacoder/assetstore/          ← instalado junto com o pacote pip
+    skills/
+        <ID>.zip                ← árvore completa da skill
+        <ID>.metadata           ← metadados YAML
+    modelconfigs/
+        <ID>.zip                ← único arquivo .yaml de configuração
+        <ID>.metadata           ← metadados YAML
+```
+
+O caminho base é sempre `Path(__file__).parent / "assetstore"`, portanto funciona corretamente quando instalado via `pip install opalacoder` em qualquer máquina.
+
+### Formato dos metadados (`.metadata`)
+
+Arquivo YAML com os campos:
+
+| Campo | Obrigatório | Descrição |
+|---|---|---|
+| `id` | ✓ | Identificador único do asset (ex: `skill_implement_feature`) |
+| `type` | ✓ | `skill` ou `modelconfig` |
+| `desc` | ✓ | Descrição legível usada como critério de busca |
+| `name` | skill | Nome da skill (igual ao diretório dentro do zip) |
+| `model` | modelconfig | Identificador do modelo (ex: `ollama/gpt-oss:latest`) |
+
+**Exemplo — skill:**
+```yaml
+id: skill_implement_feature
+type: skill
+name: implement-feature
+desc: Plan-Execute-Verify loop for implementing features and fixing bugs in project files
+```
+
+**Exemplo — modelconfig:**
+```yaml
+id: model_ollama_gpt_oss__latest
+type: modelconfig
+desc: gpt-oss:latest via Ollama — think=false, tool calling stable
+model: ollama/gpt-oss:latest
+```
+
+### Destino de instalação
+
+| Tipo | Destino no projeto |
+|---|---|
+| `skill` | `<projeto>/.opalacoder/skills/<name>/` |
+| `modelconfig` | `<projeto>/.opalacoder/modelsconfig/<provider>/<modelo>.yaml` |
+
+Para modelconfigs, o provider é normalizado: `ollama_chat/` e `ollama/` → diretório `ollama/`. Os dois pontos no nome do modelo viram `__`.
+
+### Comandos REPL
+
+```
+/list_assets [tipo]           — lista todos os assets (ou só do tipo especificado)
+/load_asset <tipo> <desc|id|*> — instala asset(s) no projeto ativo
+```
+
+`<desc>` pode ser o `id` exato ou o valor do campo `desc`. Usar `*` instala todos os assets do tipo.
+
+**Exemplos:**
+```
+/list_assets
+/list_assets modelconfig
+/load_asset skill skill_implement_feature
+/load_asset modelconfig model_ollama_gpt_oss__latest
+/load_asset skill *
+```
+
+Após instalar uma skill, ativá-la no projeto com `/addskill <name>`.
+
+---
+
+## 5.1. Banco de Configurações Refinadas de Modelos
+
+> **Estado: IMPLEMENTADO**
+
+### Conceito
+
+O diretório `.opalacoder/modelsconfig/` dentro de cada projeto funciona como um
+**banco de dados de casos bem-sucedidos de configuração para modelos locais**. Cada
+arquivo YAML registra os parâmetros que produziram comportamento correto e estável
+para um modelo específico naquele projeto — resultado de testes empíricos, não de
+valores genéricos.
+
+A motivação é que modelos locais (Ollama, LM Studio, etc.) exigem combinações
+precisas de parâmetros para funcionar bem: `think` e `stream` podem quebrar
+tool calling em certos modelos; `num_ctx` muito baixo degrada o raciocínio;
+`temperature` alta pode destabilizar modelos de instrução. Esses parâmetros
+**não são portáveis** — o que funciona para `deepseek-r1:14b` não funciona para
+`ministral-3:14b`. O banco de configurações resolve isso por projeto.
+
+### Estrutura de diretórios
+
+```
+<projeto>/
+└── .opalacoder/
+    └── modelsconfig/
+        └── <provider>/
+            └── <nome_do_modelo>.yaml
+```
+
+- **`<provider>`**: prefixo do modelo, com normalização — `ollama_chat/` e `ollama/`
+  mapeiam ambos para o diretório `ollama/`.
+- **`<nome_do_modelo>.yaml`**: nome do modelo com `:` substituído por `__`
+  (hífens mantidos).
+
+**Exemplos de mapeamento:**
+
+| Modelo digitado | Diretório | Arquivo |
+|---|---|---|
+| `ollama/deepseek-r1:14b` | `ollama/` | `deepseek-r1__14b.yaml` |
+| `ollama_chat/deepseek-r1:14b` | `ollama/` | `deepseek-r1__14b.yaml` |
+| `ollama/ministral-3:14b` | `ollama/` | `ministral-3__14b.yaml` |
+| `ollama/qwen3:14b` | `ollama/` | `qwen3__14b.yaml` |
+
+### Formato do arquivo YAML
+
+O arquivo pode conter qualquer chave de `model_params` aceita pelo sistema, mais
+uma chave especial `provider`:
+
+```yaml
+# .opalacoder/modelsconfig/ollama/deepseek-r1__14b.yaml
+# Configuração refinada para DeepSeek-R1 14B via Ollama
+# Obtida empiricamente — funciona com tool calling e thinking em tempo real
+
+provider: ollama_chat   # opcional: substitui o prefixo do modelo na sessão
+                        # aqui muda de ollama/ para ollama_chat/ para habilitar
+                        # o endpoint nativo do Ollama com thinking por chunk
+
+# LiteLLM / model_kwargs
+think: true
+stream: true
+temperature: 0.6
+num_ctx: 32768
+max_tokens: 8192
+
+# Parâmetros do agente
+max_heartbeats: 15
+```
+
+```yaml
+# .opalacoder/modelsconfig/ollama/ministral-3__14b.yaml
+# Ministral 3 14B — sem thinking (não suportado), tool calling estável
+
+think: false
+stream: false
+temperature: 0.7
+num_ctx: 16384
+max_tokens: 8128
+max_heartbeats: 20
+```
+
+**Chave `provider`** (opcional): quando presente, substitui o prefixo do modelo
+na interface. Útil para forçar `ollama_chat/` em modelos com suporte a thinking
+nativo, sem o usuário precisar digitar o prefixo correto.
+
+### Como usar
+
+Na janela de **criação** ou **configuração** de projeto, após definir o modelo,
+clique em **Load Refined Config**:
+
+- Se existir um arquivo para o modelo: carrega e substitui completamente o
+  `model_params` do projeto. Se o YAML tiver `provider:`, atualiza o campo
+  modelo com o novo prefixo.
+- Se não existir: exibe `--- ainda não temos parâmetros refinados para este modelo`.
+
+O backend resolve o arquivo via `GET/POST /api/opalacoder/model-config`
+([ide_server.py](../../opalacoder/ide_server.py)).
+
+### Critério para adicionar uma entrada
+
+Uma entrada deve ser adicionada ao banco quando:
+
+1. O modelo foi testado com a configuração e **tool calling funciona** sem erros.
+2. O comportamento de **thinking/reflection** (se aplicável) está correto.
+3. Os valores de **contexto e tokens** são adequados ao hardware disponível.
+
+O arquivo é mantido manualmente pelo usuário/equipe e versionado junto com o
+projeto. Não é gerado automaticamente.
+
+### Exemplo completo — `gpt-oss:latest` (Ollama)
+
+```yaml
+# .opalacoder/modelsconfig/ollama/gpt-oss__latest.yaml
+#
+# Configuração refinada para gpt-oss:latest via Ollama
+# Testado em: 2026-06-02 | Hardware: RTX 4090 24GB
+# Status: tool calling OK, thinking OK, stream OK
+#
+provider: ollama_chat   # endpoint nativo: thinking por chunk em tempo real
+
+# LiteLLM / model_kwargs
+think: false            # desativar thinking evita bug de tool_calls vazio (ollama #15288)
+stream: false           # stream false: mais estável com tool calling
+temperature: 0.1        # baixo para respostas determinísticas em tarefas de código
+num_ctx: 32768          # contexto amplo para projetos grandes
+max_tokens: 8192
+
+# Parâmetros do agente MemGPT (chat-orquestrador)
+max_heartbeats: 20
+max_context_tokens: 32768
+
+# Parâmetros do agente LLMAgentBlock (workers)
+max_tool_calls: 10
+debug: false
+```
+
+---
+
+## 6. Comandos do REPL
 
 Registrados em [cli_commands.py](../../opalacoder/cli_commands.py):
 

{opalacoder-0.2.0 → opalacoder-0.2.3}/gui_src/src/App.jsx

@@ -75,6 +75,7 @@ export default function App() {
   const [thinkingLogs, setThinkingLogs] = useState([]);
   const [showAdvancedParams, setShowAdvancedParams] = useState(false);
   const [newProjError, setNewProjError] = useState('');
+  const [modelConfigMsg, setModelConfigMsg] = useState('');
 
   // Directory picker state: { target: 'new'|'edit', current: '/path', dirs: [{name,path}] } | null
   const [dirPicker, setDirPicker] = useState(null);
@@ -182,6 +183,7 @@ export default function App() {
   const [newProjDesc, setNewProjDesc] = useState('');
   const [newProjModel, setNewProjModel] = useState('gemini/gemini-2.5-flash');
   const [newProjMode, setNewProjMode] = useState('auto');
+  const [newProjModelParams, setNewProjModelParams] = useState({});
   const [newProjApiKey, setNewProjApiKey] = useState('');
   const [newProjApiBase, setNewProjApiBase] = useState('http://localhost:11434/v1');
 
@@ -440,6 +442,18 @@ export default function App() {
     }
   }, [activeProject]);
 
+  // Polling for workspace file changes and git status (every 10 seconds)
+  useEffect(() => {
+    if (!activeProject) return;
+
+    const interval = setInterval(() => {
+      fetchFiles();
+      fetchGitStatus();
+    }, 10000);
+
+    return () => clearInterval(interval);
+  }, [activeProject]);
+
   useEffect(() => {
     if (activeSidebarTab === 'git' && activeProject) {
       fetchGitStatus();
@@ -980,7 +994,8 @@ export default function App() {
           model: newProjModel,
           mode: newProjMode,
           api_key: newProjApiKey,
-          api_base: newProjApiBase
+          api_base: newProjApiBase,
+          model_params: Object.keys(newProjModelParams).length ? newProjModelParams : undefined
         })
       });
       if (res.ok) {
@@ -1035,6 +1050,7 @@ export default function App() {
         if (found) fresh = found;
       }
     } catch (_) { }
+    setModelConfigMsg('');
     setEditingProject({
       name: fresh.name,
       project_name: fresh.project_name || fresh.name,
@@ -1087,6 +1103,30 @@ export default function App() {
     }
   };
 
+  const loadModelConfig = async (projectPath, model, applyFn) => {
+    setModelConfigMsg('');
+    if (!projectPath || !model) {
+      setModelConfigMsg('⚠️ Defina o caminho do projeto e o modelo antes de carregar.');
+      return;
+    }
+    try {
+      const res = await fetch('/api/opalacoder/model-config', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ projectPath, model }),
+      });
+      const data = await res.json();
+      if (!data.found) {
+        setModelConfigMsg(data.message);
+        return;
+      }
+      applyFn(data);
+      setModelConfigMsg('✅ Configuração refinada carregada.');
+    } catch (e) {
+      setModelConfigMsg(`⚠️ Erro ao carregar: ${e.message}`);
+    }
+  };
+
   const openDirPicker = async (target, startPath) => {
     const path = startPath || '~';
     try {
@@ -1194,6 +1234,7 @@ export default function App() {
         setChatMessages(prev => [...prev, { role: 'assistant', content: `🔴 Falha: ${err.message}` }]);
       } finally {
         setIsAgentRunning(false);
+        fetchFiles();
       }
       return;
     }
@@ -1474,7 +1515,7 @@ export default function App() {
               <div className="vscode-sidebar-header">
                 <span className="vscode-sidebar-title">EXPLORER: PROJECTS</span>
                 <button
-                  onClick={() => setShowNewProjectModal(true)}
+                  onClick={() => { setShowNewProjectModal(true); setModelConfigMsg(''); setNewProjModelParams({}); }}
                   style={{ background: 'transparent', border: 'none', cursor: 'pointer', color: '#c5c5c5' }}
                   title="Novo Projeto..."
                 >
@@ -1545,7 +1586,39 @@ export default function App() {
                 }}
                 style={dragOverPath === '__root__' ? { border: '2px dashed #007acc', backgroundColor: 'rgba(0, 122, 204, 0.05)' } : {}}
               >
-                <div className="vscode-sidebar-section-title">Workspace Files</div>
+                <div className="vscode-sidebar-section-title" style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
+                  <span>Workspace Files</span>
+                  {activeProject && (
+                    <button
+                      onClick={(e) => {
+                        e.stopPropagation();
+                        fetchFiles();
+                      }}
+                      title="Atualizar arquivos"
+                      style={{
+                        background: 'transparent',
+                        border: 'none',
+                        color: '#808080',
+                        cursor: 'pointer',
+                        display: 'flex',
+                        alignItems: 'center',
+                        padding: '2px',
+                        borderRadius: '3px',
+                        transition: 'color 0.2s, background-color 0.2s',
+                      }}
+                      onMouseOver={(e) => {
+                        e.currentTarget.style.color = '#ffffff';
+                        e.currentTarget.style.backgroundColor = 'rgba(255, 255, 255, 0.1)';
+                      }}
+                      onMouseOut={(e) => {
+                        e.currentTarget.style.color = '#808080';
+                        e.currentTarget.style.backgroundColor = 'transparent';
+                      }}
+                    >
+                      <RefreshCw size={12} />
+                    </button>
+                  )}
+                </div>
                 {files.length === 0 ? (
                   <div style={{ fontSize: '12px', color: '#808080', padding: '0 4px', fontStyle: 'italic' }}>
                     Selecione um projeto para explorar.
@@ -2194,6 +2267,22 @@ export default function App() {
                 </div>
               </div>
 
+              {/* Load refined model config */}
+              <div style={{ display: 'flex', alignItems: 'center', gap: '8px', flexWrap: 'wrap' }}>
+                <button type="button" className="vscode-button" style={{ background: '#3c3c3c', fontSize: '12px' }}
+                  onClick={() => loadModelConfig(newProjPath, newProjModel, (cfg) => {
+                    if (cfg.model_params) setNewProjModelParams(cfg.model_params);
+                    if (cfg.model) setNewProjModel(cfg.model);
+                  })}>
+                  Load Refined Config
+                </button>
+                {modelConfigMsg && (
+                  <span style={{ fontSize: '11px', color: modelConfigMsg.startsWith('✅') ? '#4ec9b0' : '#f48771' }}>
+                    {modelConfigMsg}
+                  </span>
+                )}
+              </div>
+
               {newProjError && (
                 <div style={{ color: '#f48771', fontSize: '11px', marginTop: '4px', whiteSpace: 'pre-wrap' }}>
                   ⚠️ {newProjError}
@@ -2359,6 +2448,25 @@ export default function App() {
                 </div>
               </div>
 
+              {/* Load refined model config */}
+              <div style={{ display: 'flex', alignItems: 'center', gap: '8px', flexWrap: 'wrap' }}>
+                <button type="button" className="vscode-button" style={{ background: '#3c3c3c', fontSize: '12px' }}
+                  onClick={() => loadModelConfig(editingProject.project_path, editingProject.model, (cfg) => {
+                    setEditingProject(p => ({
+                      ...p,
+                      model_params: cfg.model_params || p.model_params,
+                      model: cfg.model || p.model,
+                    }));
+                  })}>
+                  Load Refined Config
+                </button>
+                {modelConfigMsg && (
+                  <span style={{ fontSize: '11px', color: modelConfigMsg.startsWith('✅') ? '#4ec9b0' : '#f48771' }}>
+                    {modelConfigMsg}
+                  </span>
+                )}
+              </div>
+
               {/* Alternative model */}
               <div className="flex flex-col" style={{ gap: '4px' }}>
                 <label className="vscode-sidebar-section-title" style={{ padding: 0 }}>Modelo Alternativo</label>

{opalacoder-0.2.0 → opalacoder-0.2.3}/gui_src/src/index.css

@@ -92,6 +92,11 @@ input, select, textarea {
   outline: none;
 }
 
+select option {
+  background-color: var(--vscode-input-bg);
+  color: var(--vscode-text-fg);
+}
+
 input:focus, select:focus, textarea:focus {
   border-color: var(--vscode-active-border);
 }

{opalacoder-0.2.0 → opalacoder-0.2.3}/opalacoder/agent_stdin.py

@@ -286,11 +286,22 @@ async def handle_slash_command(data: dict) -> dict:
     T.confirm = lambda p, default=True: default   # sync fallback never used in GUI
     T.ask     = lambda p: ""
 
+    def _render_rich(obj) -> str:
+        from rich.console import Console as _Console
+        from rich.table import Table as _Table
+        from io import StringIO
+        if isinstance(obj, _Table):
+            buf = StringIO()
+            c = _Console(file=buf, highlight=False, no_color=True)
+            c.print(obj)
+            return buf.getvalue()
+        return str(obj)
+
     def _console_print(*args_c, **kwargs_c):
         if not args_c:
             messages.append("")
             return
-        raw = " ".join(str(x) for x in args_c)
+        raw = " ".join(_render_rich(x) for x in args_c)
         for line in raw.split("\n"):
             stripped = line.strip()
             if not stripped:
@@ -302,6 +313,9 @@ async def handle_slash_command(data: dict) -> dict:
                 messages.append("### 🧠 Active skills for this project\n"); continue
             if "Available skills" in stripped:
                 messages.append("### 📚 Available skills\n"); continue
+            clean = re.sub(r'\[/?[\w\s]+\]', '', stripped)
+            if clean and clean == clean.upper() and clean.replace(" ", "").isalpha():
+                messages.append(f"### {clean}\n"); continue
             m = re.match(r'\s*(?:\*\s*)?\[(green|cyan)\]\s*(.*?)\s*\[/\1\]\s*(.*)', line)
             if m:
                 name = m.group(2).strip()
@@ -316,7 +330,7 @@ async def handle_slash_command(data: dict) -> dict:
             if sm:
                 star = "⭐ " if has_star else "🔹 "
                 messages.append(f"{star}**`{sm.group(1).strip()}`** — {sm.group(2).strip()}"); continue
-            messages.append(re.sub(r'\[/?\w+\]', '', line))
+            messages.append(re.sub(r'\[/?[\w\s]+\]', '', line))
 
     T.console.print = _console_print
 

opalacoder-0.2.3/opalacoder/assetstore/modelconfigs/gpt_oss__latest.metadata

@@ -0,0 +1,4 @@
+id: gpt_oss__latest
+type: modelconfig
+desc: "GPT OSS latest model via Ollama"
+model: ollama/gpt-oss:latest

opalacoder-0.2.3/opalacoder/assetstore/skills/skill_html_css_js.metadata

@@ -0,0 +1,4 @@
+id: skill_html_css_js
+type: skill
+name: html-css-js
+desc: Best practice rules and contract detector for vanilla HTML/CSS/JavaScript projects

opalacoder-0.2.3/opalacoder/assetstore/skills/skill_implement_feature.metadata

@@ -0,0 +1,4 @@
+id: skill_implement_feature
+type: skill
+name: implement-feature
+desc: Plan-Execute-Verify loop for implementing features and fixing bugs in project files