pi-worker

Headless worker helpers for pi -p.

Flags

• --last-message-file <path> writes the final assistant text on agent_end.
• --result-schema <path> enables the report_result tool and validates tool args against the JSON Schema file. Gotcha: a -t allowlist applies to extension tools too — include report_result in it (e.g. -t read,write,bash,report_result) or the model cannot call the tool and no result file is written.
• --result-file <path> overrides the structured result output path. Without it, result.json is written next to --last-message-file.
• --worker-heartbeat-file <path> writes a JSON liveness record on agent_start, tool_execution_end, and agent_end.
• --worker-trust answers project trust with { "trusted": "yes" } for this process.