Skip to content

v0.11.0-beta — Ferramentas e Modelos 🐺

Pre-release
Pre-release

Choose a tag to compare

View all tags
@msant262 msant262 released this 08 Jul 04:49
v0.11.0-beta
5b498c5

Okami Agent — v0.11.0-beta "Ferramentas e Modelos" 🐺

Suíte: 3.364 → 3.443 testes · lançada 2026-07-08 (mesmo dia da v0.10.0-beta).

⚠️ Beta. A superfície de comandos e config ainda pode mudar até a GA. Recomendado para uso real
(inclusive em VPS 24/7) — mas rode okami policy check --strict antes de expor publicamente. Ver o
CHANGELOG completo.

🌐 Site: https://okamiagent.com · 📚 Docs: https://okamiagent.com/docs

A história desta release

1 commit (4bfbc14), mas denso: 5 ondas paralelas atacando 3 frentes de fricção no uso real — troca
de provider/modelo pouco visível, qualidade baixa nas chamadas de tool e falta de skills práticas para
workflows do dia a dia (pesquisa, monitoramento, automação). E2E real (minimax): task COMPLETE com
auto-verificação (od/wc/sha256), inclusive interceptando e corrigindo sozinho um bug de echo -n no meio
da execução.

✨ Highlights

  • Resolver único de modelo/alias — okami model, /model --save e /models numerado, com
    did-you-mean em vez de override silencioso.
  • Schema rico nas tools — enum/default/minimum/maximum explícitos fecham a causa-raiz
    diagnosticada das chamadas de tool ruins.
  • Cadeia de estratégias fuzzy no edit — paridade com o Hermes, incluindo did-you-mean top-3.
  • 4 skills novas: watchers (RSS/GitHub/JSON), stocks (Yahoo Finance), github (CI/merge/issues),
    scripts arxiv/wikipedia em pesquisa-web.

🔀 Troca de modelo

  • okami/llm/model_aliases.py: resolver ÚNICO de alias/tier — aliases semânticos (sonnet, opus,
    haiku, codex, gpt, minimax, mimo, grok, …), tiers dinâmicos fast/smart, validação contra
    o catálogo de providers, extensível via model_aliases: no yaml.
  • okami model (novo comando): picker interativo, switch direto, list --json.
  • /model no gateway/Telegram passa a usar o MESMO resolver — ganha --save (persiste em
    okami.local.yaml) e /models numerado (uso mobile sem digitar nome completo).
  • Typo de alias agora vira erro com sugestão (did-you-mean) em vez de aplicar um override silencioso
    errado.

🛠️ Tools — schema rico

Causa-raiz diagnosticada das chamadas de tool ruins:

  • to_openai_schema passa a emitir enum/default/minimum/maximum (arg_constraints) — antes todo
    parâmetro de "modo" era texto livre, sem contrato, e o modelo chutava valor. Aplicado em
    search_files, spawn_jobs, todo_write, spawn, manage_skill, browse.
  • Bug real corrigido: spawn.background sem tipo boolean — a string "false" virava True no runtime.
  • todo_write: leitura sem args, merge por id, status cancelled (paridade com o TODO_SCHEMA do
    Hermes).

✏️ Edit — paridade de cadeia de estratégias fuzzy

  • Novas estratégias: escape_normalized (\n literal), trimmed_boundary, block_anchor (ancora
    primeira+última linha, difflib no meio) — mais de 1 match seguem sendo tratados como ambíguo, o edit
    nunca escolhe sozinho entre candidatos.
  • Did-you-mean top-3 com números de linha; read_file ganha line_numbers opt-in.

🧩 Skills práticas

  • watchers: RSS/GitHub/JSON com poll + watermark dedup — a base de "me avisa quando X mudar" via
    cron → Telegram.
  • pesquisa-web ganha scripts: arxiv + wikipedia, com HTTP compartilhado.
  • stocks: cotações via Yahoo Finance, sem API key.
  • github: CI/merge/issues, gh-first com fallback via gh_api.py.
  • Mecanismo novo: frontmatter requires_tools/fallback_for_tools esconde a skill quando o tooling
    necessário não está disponível (paridade Hermes).

🔌 Plugins

  • Hook transform_tool_result: não-bloqueante, componível, isolado por plugin.
  • security-guidance: veto vira aviso ANEXADO ao resultado da tool — o próprio modelo vê e se
    autocorrige, em vez de a tool simplesmente falhar sem explicação.

✅ Release verification

  • 3.443 testes passando (uv run pytest -q), subindo de 3.364.
  • E2E real com minimax: task COMPLETE com auto-verificação mecânica (od/wc/sha256).
  • Reprodução local: 
    uv sync --frozen
uv run pytest -q
uv run ruff check okami tests
uv run bandit -c pyproject.toml -r okami -q
uv run okami policy check --strict

🚀 Instalação / upgrade

# instalação nova (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/OkamiOps/Okami-Agent/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/OkamiOps/Okami-Agent/main/scripts/install.ps1 | iex

# upgrade de instalação existente
uv tool upgrade okami-agent   # ou: pip install -U okami-agent

okami setup     # configura em 2-3 cliques
okami doctor    # confirma que a versão instalada bate com o pyproject (sem version-drift)
okami chat      # conversa no terminal

📄 License

MIT (LICENSE) © 2026 OkamiOps.

🔗 Links

Assets 5
Loading