Skip to main content

Overview

Drive one Tell run from a process that is not linked to the PHP SDK. The shell controller beside this example writes one versioned request to stdin and reads ordered JSONL frames from stdout. It can be replaced by any language that can spawn a process and parse one JSON object per line.

Example

Key Points

  • controller.sh is the actual non-PHP controller; this cookbook wrapper only makes it runnable through Instructor Hub.
  • Stdout contains only tell.agent.frame.v1 JSONL. Human diagnostics go to stderr, so a controller never has to separate prose from protocol data.
  • One invocation consumes one request, produces zero or more progress frames, then exactly one result, error, or cancelled terminal frame.
  • This live example uses the configured default Tell provider and is therefore tagged no-replay. The package subprocess tests use the public deterministic driver and require no provider credential.