Memo: Programmatic Agents (Read Only When Building Agent-Driven Scripts/CI)

Three shapes: one-shot (fire-and-forget), durable (multi-turn + streaming), resume (cross-process by ID). Always dispose (using/with/explicit close); always wait() for the terminal result even when skipping streaming. Separate startup failure (never ran: auth/config/network, retryable flag) from run failure (ran but errored, exit 2). Log run/agent IDs before streaming. Re-pass inline servers on resume; never assume ambient settings.