Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Argument errors in system_key and desktop_wait that agents trip on

Fechada
  • Algo errado?
#199 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Um pull request relacionado já foi integrado.

  • #220 de @iamnbutler — integrado

Avaliação

Dificuldade
3/5
Tempo estimado
1-2 dias
Facilidade para iniciantes
55/100
Tipo de issue
Funcionalidade
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
macos, swift
Domínio
desktop-dev

Direção de pesquisa

Start with the MCP tool schemas and implementations for desktop_system_key and desktop_wait, then trace click handling and post-click observation timing. Validate that return aliases enter, responses identify the frontmost app, and the wait schema documents required fields and timeout bounds. Done means calls succeed on the first attempt with accurate feedback, and observation does not report a click as unchanged before its effect is visible.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Seen 2026-10-23 with Desktop Tools 0.17.1 (app and MCP), driving Ace Canary on macOS 27. Ace is an Electrobun app, so its UI is a WKWebView. The agent was a foreground Claude Code session recording demo videos.

Small schema issues that each cost a failed call:

  • desktop_system_key with return fails with "Choose a named key or one printable character." enter works. Accept return as an alias, since it's the key's name on a Mac.
  • Every desktop_system_key call comes back as unknown: "The keys went to whatever was frontmost; their effect was not read back." That's fair for the route, but it should say which app was frontmost when the keys were sent.
  • desktop_wait with element_appears needs both role and title, and element_gone needs element. The schema doesn't say so. timeout_ms must be an integer from 100 to 45000. List those constraints in the tool description so the first call is right.
  • An element click on Ace's New channel button returned completed while the next observation looked unchanged, yet the channel had been created. The observation after a click may be read too early.
Linguagem predominante
Swift
Estrelas
0
Forks
0
Merge médio
39min
PRs com merge (30d)
162

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de githubnext/desktop-tools

Todas as issues de githubnext/desktop-tools

Issues semelhantes

Mais issues de Swift

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.