Execution Primitives

At a glance

Primitive	Tool	How
Parallel	run_parallel	Auto (tasks: [{tool, args}])
Background / watch loops	background_run	Auto (modes via params)
Session cron wake-up	scheduler.schedule	tools.modules.scheduler
Shared KV	kv	With agent spawn enabled
Memory write	memory.remember	Memory enabled

run_parallel

jsonc

{
  "name": "run_parallel",
  "arguments": {
    "tasks": [
      {"tool": "filesystem.read", "args": {"path": "README.md"}},
      {"tool": "filesystem.read", "args": {"path": "CHANGELOG.md"}}
    ]
  }
}

Legacy keys actions / name / params are still accepted by the dispatcher.

background_run

Modes include launch (name+params), status (task_id), wait (task_id+wait), list (list_tasks), cancel (task_id+cancel), plus:

• notify_when: wake a new turn when a log pattern appears
• wait_for: block this turn until a pattern
• watch: true + command + interval (+ optional until)
• signal / stdin for a running task

This is the supported "watcher" surface. There is no watch_start tool family. YAML runtime.watchers does not register tools.

scheduler.schedule

Recurring wake-up of this session via digitorn-background. See scheduler.

Related

• Built-in tools
• context_builder