opalacoder 0.1.26__tar.gz → 0.2.2__tar.gz

{opalacoder-0.1.26 → opalacoder-0.2.2}/CLAUDE.md

@@ -2,10 +2,13 @@
 
 1. Don't make baseless assumptions; before drawing any conclusions, conduct tests and analysis to gather as much information as possible.
 
+2. Dever apply direct patch ou modifications in external lib without user authorization.
+
+3. Dont call directly litellm (always use agenticblocks). If need same feature dont supported by agenticblocks, alert me and ask me about to do.
+
 # Project Guide
 
 ## Language
-
 All code, comments, and documentation must be written in **English**.
 
 ## Architecture

{opalacoder-0.1.26 → opalacoder-0.2.2}/GEMINI.md

@@ -2,6 +2,10 @@
 
 1. Don't make baseless assumptions; before drawing any conclusions, conduct tests and analysis to gather as much information as possible.
 
+2. Dever apply direct patch ou modifications in external lib without user authorization.
+
+3. Dont call directly litellm (always use agenticblocks). If need same feature dont supported by agenticblocks, alert me and ask me about to do.
+
 # Project Guide
 
 ## Language

{opalacoder-0.1.26 → opalacoder-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opalacoder
-Version: 0.1.26
+Version: 0.2.2
 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.2/debug/debug_litellm_callbacks.py

@@ -0,0 +1,43 @@
+import asyncio
+import os
+import litellm
+from litellm.integrations.custom_logger import CustomLogger
+
+class MyCustomHandler(CustomLogger):
+    def log_success_event(self, kwargs, response_obj, start_time, end_time):
+        print("--- log_success_event triggered! ---")
+
+    async def async_log_success_event(self, kwargs, response_obj, start_time, end_time):
+        print("--- async_log_success_event triggered! ---")
+
+litellm.callbacks = [MyCustomHandler()]
+# Set environment variables for debug logging
+os.environ['LITELLM_LOG'] = 'DEBUG'
+
+async def main():
+    # We will use the same router setup as agenticblocks
+    router = litellm.Router(
+        model_list=[{
+            "model_name": "openai/unsloth/gpt-oss-20b-GGUF:Q4_1",
+            "litellm_params": {
+                "model": "openai/unsloth/gpt-oss-20b-GGUF:Q4_1",
+                "api_base": "http://localhost:8080/v1",
+                "api_key": "test"
+            },
+        }]
+    )
+    print("Callbacks in litellm:", litellm.callbacks)
+    try:
+        # Call via router
+        response = await router.acompletion(
+            model="openai/unsloth/gpt-oss-20b-GGUF:Q4_1",
+            messages=[{"role": "user", "content": "hello"}],
+            api_base="http://localhost:8080/v1",
+            api_key="test",
+            mock_response="Hello back!"
+        )
+        print("Response received:", response)
+    except Exception as e:
+        print("Error during completion:", e)
+
+asyncio.run(main())

opalacoder-0.2.2/debug/test_thought_stream.py

@@ -0,0 +1,47 @@
+import asyncio
+import httpx
+
+async def main():
+    # Start the IDE server in a background task
+    from opalacoder.ide_server import start_gui_server
+    
+    # We will patch start_gui_server or run it directly on port 3005
+    print("Starting GUI server on port 3005...")
+    # Run the server startup in a separate thread/task
+    
+    # Set up project path
+    project_path = "/home/gilzamir/projetos/OpalaCoder"
+    project_name = "bobenglish"
+    
+    # Make a run request
+    url = "http://127.0.0.1:3005/api/opalacoder/run"
+    payload = {
+        "command": "run",
+        "agent": "chat_orchestrator",
+        "prompt": "Olá",
+        "project_name": project_name,
+        "project_path": project_path,
+        "model": "ollama/gemma4:latest", # or any dummy/mock model
+    }
+    
+    # We'll start the server and wait 2 seconds
+    server_task = asyncio.create_task(asyncio.to_thread(start_gui_server, "127.0.0.1", 3005))
+    await asyncio.sleep(3)
+    
+    print("Sending request to /api/opalacoder/run...")
+    try:
+        async with httpx.AsyncClient(timeout=60.0) as client:
+            async with client.stream("POST", url, json=payload) as response:
+                print("Response status:", response.status_code)
+                async for line in response.aiter_lines():
+                    if line.strip():
+                        print("STREAM LINE:", line)
+    except Exception as e:
+        print("Error during request:", e)
+    finally:
+        server_task.cancel()
+
+try:
+    asyncio.run(main())
+except Exception as e:
+    print("Finished:", e)

{opalacoder-0.1.26 → opalacoder-0.2.2}/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):