opalacoder 0.2.3.1__tar.gz → 0.2.3.2__tar.gz

{opalacoder-0.2.3.1 → opalacoder-0.2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opalacoder
-Version: 0.2.3.1
+Version: 0.2.3.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
@@ -19,6 +19,7 @@ Requires-Dist: pyqt6-webengine>=6.0.0
 Requires-Dist: pyqt6>=6.0.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: pywebview>=4.0
+Requires-Dist: pywinpty>=2.0.0; sys_platform == 'win32'
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: qtpy>=2.4.0
 Requires-Dist: rich>=13.0.0

opalacoder-0.2.3.2/docs/specs/10-chat-meta-params.md

@@ -0,0 +1,70 @@
+# Chat Meta-Parameters
+
+Meta-parameters are per-turn configuration overrides embedded directly in a chat message. They take effect only for the duration of that single agent turn and are automatically reverted before the next message.
+
+## Syntax
+
+```
+@key=value@
+```
+
+- String values must be quoted: `@system_prompt="be ironic"@`
+- Numeric values are unquoted: `@max_tokens=512@` `@temperature=0.9@`
+- Multiple params in the same message are supported: `@max_tokens=512@ @temperature=0.2@`
+- Tokens are stripped from the message before it reaches the agent.
+
+## Allowed Parameters
+
+| Parameter      | Type   | Safe minimum | Description                                   |
+|---------------|--------|-------------|-----------------------------------------------|
+| `max_tokens`  | int    | 256         | Maximum tokens for the agent's LLM calls this turn |
+| `temperature` | float  | 0.0         | Sampling temperature                          |
+| `top_k`       | int    | 1           | Top-K sampling                                |
+| `top_p`       | float  | 0.0         | Top-P (nucleus) sampling                      |
+| `min_p`       | float  | 0.0         | Min-P sampling                                |
+| `system_prompt` | str  | —           | Injects additional text as the system prompt for this turn only |
+
+## Restrictions
+
+### max_tokens minimum is 256
+
+The `MemGPTAgentBlock` uses `max_tokens` for every internal LLM call — including tool-call heartbeats and response synthesis. Values below 256 cause the model to cut JSON tool calls mid-stream, producing empty or broken responses with no visible error.
+
+Values below 256 are **automatically clamped to 256** with a warning in the server log. The user-specified value is never passed to the model.
+
+### system_prompt is injected, not replaced
+
+Setting `@system_prompt="..."@` **replaces** `agent.system_prompt` for that turn. The original is restored immediately after the agent responds. This means the injected prompt must be self-contained if it needs to include the original instructions.
+
+### Parameters apply to all internal calls in a turn
+
+For `chat_orchestrator` (MemGPT), a single user turn may trigger multiple LLM heartbeats. The override applies to every heartbeat in that turn, not just the final response call.
+
+### Unknown keys are silently ignored
+
+Any `@key=value@` token whose key is not in the allowed list is stripped from the message text but produces no override and no error.
+
+## Examples
+
+```
+Implemente uma função de quicksort. @max_tokens=512@
+```
+Limits the agent's output budget for this turn to 512 tokens.
+
+```
+O que você acha da minha abordagem? @system_prompt="responda de forma muito crítica e direta"@
+```
+The agent responds with the injected system prompt; the original is restored on the next turn.
+
+```
+Resumo rápido. @max_tokens=300@ @temperature=0.2@
+```
+Multiple overrides in a single message.
+
+## Implementation
+
+| File | Role |
+|------|------|
+| `opalacoder/chat_meta_params.py` | Parser (`parse_meta_params`) and context manager (`apply_meta_params`) |
+| `opalacoder/agent_stdin.py` | Integration point in `handle_run` — wraps `agent.run()` with `apply_meta_params` |
+| `tests/test_chat_meta_params.py` | Unit tests for parser and restore logic |

{opalacoder-0.2.3.1 → opalacoder-0.2.3.2}/docs/specs/backlog_register.md

@@ -39,13 +39,14 @@
 9. Permitir que mensagens no chat não podem ser copiadas.
 
 ## FROM CURRENT = 0.2.3 TO NEXT = 0.2.4
+1. Revisar código. ✅
 
-1. Menu contextual para copiar, cortar e colar no terminal e no chat.
-2. Adicionar botões de maximizar e de minimizar o editor de texto (e outros paineis?).
-3. Adicionar o conceito de meta configurações de chat (configurações que somente são válidas naquele momento que se conversa com o agente - durante a vida de uma mensagem). Por enquanto, apenas os parâmetros max_tokens, system_prompt, temperature, top-k, top-p, min-p são permitidos. Exemplos:
+2. Adicionar botões de maximizar e de minimizar o editor de texto (e outros paineis?). ✅
+
+3. ✅ Adicionar o conceito de meta configurações de chat (configurações que somente são válidas naquele momento que se conversa com o agente - durante a vida de uma mensagem). Por enquanto, apenas os parâmetros max_tokens, system_prompt, temperature, top-k, top-p, min-p são permitidos. Exemplos:
 	3.1 User: Implemente uma função que calcula a série de fourier. <param max_tokens=3>.
 	3.2 Agent: ok ok
-	3.3 User: Ora, ora, o que é você? <param system_prompt="seja irônico na resposta">
+	3.3 User: Ora, ora, o que é você?  @system_prompt="seja irônico na resposta"@
 	3.4 Agent: resposta irônica
 	3.5 User:...
 	3.6 Agent:...
@@ -53,6 +54,7 @@
 
 	Neste exemplo, em 3.1, o valor de max_tokens deve ser revertido depois que o agente der a resposta (a vida de uma meta instrução é só o do turno).
 	Em 3.3, o system_prompt softre uma injeção, mas que dura somente enquanto o agente responde. Observe que, a partir de 3.3, max_tokens já volta para o seu valor padrão. E partir de 3.5, a injeção de system prompt perde o efeito (resetando-se o system prompt para sua versão original).
+	Por baixo dos panos, primeiro identifica se a mensagem tem params, que são substituições válidas que começam com @, remove os parmas, faz a alteração temporária, executa a chamada, espera o modelo responder, desfaz a alteração temporária. ✅
 
 4. Prover ferramentas/funções de selecionar e pedir para o agente redefinir o que está selecionado. Ou para o agente detectar um erro em uma função ou trecho de código selecionado. Possíveis formas de se fazer isso:
 	4.1 : o usuário seleciona o texto, e no menu contextual tem opções: refinar e corrigir se algo estiver selecionado. Também há a possibilidade do usuário selecionar algo ou deixar o cursor em alguma parte e executar CTRL+i e então abrir uma caixa em que o usuário pode pedir algo (o agente recebe o que foi selecionado, a linha inicial, a linha final e a posição do cursor. Uma interpretação é feita "se seleção vazia e linha inicial igual a linha final, focar na posição do cursor como o lugar onde posso começar a colocar algo.")
@@ -61,6 +63,12 @@
 
 6. Disponibilizar a ferramenta web_search para o agente.
 
+7. Terminal do windows 11. ✅
+
+8. Menu contextual para copiar, cortar e colar no terminal.
+
+9. Adicionar mais opções de parâmetros, como temperature,  top_p, top_k,  min_p,  presence_penalty, repetition_penalty.
+
 ## FROM CURRENT = 0.2.4 TO NEXT = 0.2.5
 
 1. Implementar suporte a git.