[Feature]: CLI - ACP: queue session/prompt while a turn is running instead of rejecting it with -32603

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

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
54/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
typescript
Domínio
api, cli

Direção de pesquisa

Start by tracing the mcode acp handler for session/prompt and the existing TUI and ACP queue paths; inspect the queue extension methods and their tests. Reproduce a prompt arriving during an active turn, then verify the selected behavior: the message is delivered once after the turn and its response tracks that queued turn, or the error names the callable queue method. Check that queued messages remain visible through mcode/session/queue/list and removable with mcode/session/queue/delete.

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

Descrição

Product or interface

CLI - ACP

Use case and problem

A third-party ACP client that talks to mcode acp cannot steer a running turn. When it sends session/prompt while a turn is still active, the ACP adapter rejects it:

Internal error: MiniMax Code Runtime failed: Session already has an active Turn. Use queue send to deliver the message after it.

This happens in practice whenever a background message has to reach a session that is busy — for example a parent agent that is notified that its subagent finished while the parent's own turn is still running. The message is not queued and not delivered: it fails.

The agent already has the machinery for this. The TUI queues messages typed during a run, and the ACP adapter exposes the same capability as a vendor extension:

"_meta": { "minimax-code/extensions": { "methods": [
  "mcode/session/steer",
  "mcode/session/queue/list", "mcode/session/queue/enqueue",
  "mcode/session/queue/update", "mcode/session/queue/delete", "mcode/session/queue/steer"
] } }

But the error message only says "Use queue send" without naming the method, and the ACP protocol has no standard way to advertise steering or queueing — the promptCapabilities object in the ACP schema only carries image, audio and embeddedContext, so initialize cannot tell a generic client that steering exists. A generic client therefore has to read the vendor _meta block and guess the method name, and most clients do not.

Desired behavior

Either of these would make mcode acp usable from generic ACP clients:

  1. session/prompt received while a turn is running is queued and delivered once the running turn finishes, with the session/prompt response returned when the queued turn actually runs — the same behaviour the TUI already has. This is the interoperable option, since a client that cannot know about a vendor extension cannot use it.
  2. The error names the exact method to call, e.g. Session already has an active Turn. Call mcode/session/queue/enqueue to deliver the message after it. — at minimum, the error should carry the method name so a client can recover without reading the source.

Acceptance criteria:

  • A session/prompt that arrives during a running turn is either queued or rejected with an error that names the callable extension method. It is never silently dropped.
  • With option 1, the message is delivered exactly once, after the running turn, and the session/prompt response corresponds to the queued turn.
  • Queued messages are visible through mcode/session/queue/list and can be removed with mcode/session/queue/delete, consistent with the existing extension contract.
Platform

Multiple platforms

Alternatives and additional context
  • Steering via mcode/session/steer works for clients that read the vendor extension, but the ACP schema itself has no capability to advertise it, so clients have to hard-code provider-specific knowledge.
  • The client side of this problem is tracked in the Paseo repository: https://github.com/getpaseo/paseo/issues/8300 and https://github.com/getpaseo/paseo/discussions/8301 — they are looking at queuing messages on the client side, but a client-side queue cannot be applied when the client is not the one that owns the turn.
  • Related open issues in this repository: #295 (parallel queued tasks in the interactive TUI), #335 (separating mid-run steer/queue messages in Goal mode). This request is about the ACP surface specifically, not the TUI.
Linguagem predominante
TypeScript
Estrelas
2.1k
Forks
271
Merge médio
16h 6min
PRs com merge (30d)
32

Preparar o ambiente

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 MiniMax-AI/minimax-code

Todas as issues de MiniMax-AI/minimax-code

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

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