Skip to main content

appgrammar_tool_submit

Axiom: Shared | Category: Infrastructure

Multi-turn operation

This tool uses a multi-turn protocol. The initial call returns a prompt and token. Run the prompt on your LLM, then submit the structured output via appgrammar_tool_submit (or the tool-specific submit variant) to advance the operation.

Submit data for a multi-turn tool operation. Use the token from the previous step response to advance the operation.

Many tools (marked as multi-turn in this reference) return a prompt, schema, and one-time token on their first call. You run the prompt on your LLM, then submit the structured output here to advance the operation. This pattern repeats until the operation completes.

Returns one of:

  • Next step: { step, prompt, schema, token } — run this prompt next and submit again
  • Validation error: { error, details, retry_token, retries_remaining } — fix and resubmit
  • Complete: the final result of the tool operation

Parameters​

ParameterTypeRequiredDescription
operation_idstring (UUID)YesID of the tool operation to submit to.
tokenstring (UUID)YesSingle-use token from the previous step.
submissionobjectYesSubmission data for the current step. Must conform to the schema provided in the previous step response.

Example​

{
  "method": "tools/call",
  "params": {
    "name": "appgrammar_tool_submit",
    "arguments": {
      "operation_id": "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "token": "11111111-2222-3333-4444-555555555555",
      "submission": {
        "...": "step submission data"
      }
    }
  }
}