Ask for input mid-run

version: 2
identifier: pick_changes
name: Pick changes
description: The commits since a ref you pick, starting from the latest release.
steps:
- id: release
  tool_name: github__tool__gh_release
  input: {}
- id: pick
  tool_name: ask
  input:
    prompt: List the commits since which ref?
    outputSchema:
      type: object
      required:
      - base
      properties:
        base:
          type: string
          description: Which tag or commit should the list start after?
    default:
      base: '{{release.tag}}'
    whenUnanswered: default
- id: commits
  tool_name: github__tool__git_log
  input:
    base: '{{pick.answer.base}}'
    head: HEAD
finish:
  output:
    since: '{{pick.answer.base}}'
    answered: '{{pick.answered}}'
    count: '{{commits.count}}'

version: 2
identifier: pick_changes
name: Pick changes
description: The commits since a ref you pick, starting from the latest release.
steps:
- id: release
  tool_name: github__tool__gh_release
  input: {}
- id: pick
  tool_name: ask
  input:
    prompt: List the commits since which ref?
    outputSchema:
      type: object
      required:
      - base
      properties:
        base:
          type: string
          description: Which tag or commit should the list start after?
    default:
      base: '{{release.tag}}'
    whenUnanswered: default
- id: commits
  tool_name: github__tool__git_log
  input:
    base: '{{pick.answer.base}}'
    head: HEAD
finish:
  output:
    since: '{{pick.answer.base}}'
    answered: '{{pick.answered}}'
    count: '{{commits.count}}'

pick_changes finds the latest release, asks which ref to start from, and lists the commits since the answer.

version: 2
identifier: pick_changes
name: Pick changes
description: The commits since a ref you pick, starting from the latest release.
steps:
- id: release
  tool_name: github__tool__gh_release
  input: {}
- id: pick
  tool_name: ask
  input:
    prompt: List the commits since which ref?
    outputSchema:
      type: object
      required:
      - base
      properties:
        base:
          type: string
          description: Which tag or commit should the list start after?
    default:
      base: '{{release.tag}}'
    whenUnanswered: default
- id: commits
  tool_name: github__tool__git_log
  input:
    base: '{{pick.answer.base}}'
    head: HEAD
finish:
  output:
    since: '{{pick.answer.base}}'
    answered: '{{pick.answered}}'
    count: '{{commits.count}}'

Set up the ask step

The pick step’s input sets the question and its answer:

prompt is the question.
outputSchema lists the fields to fill in. Each field’s description is what the person reads for it.
default is the answer to use when nobody answers, here the latest release’s tag.
whenUnanswered: default uses default instead of failing the run.

Later steps read the answer as {{pick.answer.base}}.

Answer in the terminal

graph plan run pick_changes

The question appears on stderr. Type an answer and press Enter:

? List the commits since which ref? [pick]
  (blank cancels)
  base — Which tag or commit should the list start after? [text]: v0.14.0
→ github__tool__git_log {"base":"v0.14.0","head":"HEAD"}
✓ github__tool__git_log 71.0ms

{
  "answered": true,
  "count": 32,
  "since": "v0.14.0"
}

When nobody answers

With no terminal to ask, as in a script or a scheduled job, the step uses default:

graph plan run pick_changes </dev/null

{
  "answered": false,
  "count": 28,
  "since": "v0.15.0"
}

A blank answer in the terminal declines the question and gives the same result.

Branch with route

Take different steps depending on the answer.

Run a plan

Pass inputs on the command line instead.

Serve plans over MCP

Ask the question through an MCP client.

Debug a plan

Run the plan in the workbench, where questions appear as a form.

Getting started

Agents

Plans

Tools

Packs

Integrating

Reference

Ask for input mid-run

Set up the ask step

Answer in the terminal

When nobody answers

Branch with route

Run a plan

Serve plans over MCP

Debug a plan

​Set up the ask step

​Answer in the terminal

​When nobody answers

​Related guides

Branch with route

Run a plan

Serve plans over MCP

Debug a plan

Set up the ask step

Answer in the terminal

When nobody answers

Related guides