fix: missing tool error fields (#27)

docs/runner/codex/codex-takopi-events.md

@@ -171,7 +171,10 @@ Codex:
 {"type":"error","message":"stream error: broken pipe"}
 ```
 
-Cheatsheet meaning: this is a **fatal stream failure** (not just a tool failure). 
+Cheatsheet meaning: this is a **fatal stream failure** (not just a tool failure).
+However, Codex may also emit transient reconnect notices as `type="error"` with
+messages like `"Reconnecting... 1/5"` while it retries a dropped stream. Treat
+those as non-fatal progress updates (do **not** end the run).
 
 → Takopi:
 
@@ -237,7 +240,8 @@ This is usually safe to show as a short “what it’s doing” line (or ignore
 
 ### 3) `command_execution` (`item.started` and `item.completed`)
 
-Codex fields include `command`, `exit_code`, `status`, `aggregated_output` (often noisy). 
+Codex fields include `command`, `status`, `aggregated_output` (often noisy), and
+`exit_code` (null or omitted until completion). 
 
 → Takopi `action`:
 
@@ -246,7 +250,7 @@ Codex fields include `command`, `exit_code`, `status`, `aggregated_output` (ofte
 * `detail={ command, exit_code, status }` (optionally include output tail)
 * `phase="started"` on `item.started`
 * `phase="completed"` on `item.completed`
-* `ok = (item.status == "completed")` (or `exit_code == 0`)
+* `ok = (item.status == "completed")` (and `exit_code == 0` when present)
 
 Note: “failed” command becomes `ok=false` but it’s still just an `action` completion — the overall run might still succeed later, depending on agent behavior.
 
@@ -270,7 +274,8 @@ This is a great progress line for your UI (“updated docs/…, added …”).
 
 ### 5) `mcp_tool_call` (`item.started` and `item.completed`)
 
-Codex contains server/tool/arguments/result/error/status. Result can be large; may include base64 in content blocks. 
+Codex contains server/tool/arguments/status and may include result/error on
+completion. Result can be large; may include base64 in content blocks. 
 
 → Takopi `action`:
 

docs/runner/codex/exec-json-cheatsheet.md

@@ -3,8 +3,10 @@
 `codex exec --json` writes **one JSON object per line** (JSONL) to stdout. Each
 line is a top-level **thread event** with a `type` field.
 
-Below: **all fields** for every line type plus a **full-line example** for each
-shape that can be emitted.
+Below: **required + commonly emitted fields** for every line type plus a
+**full-line example** for each shape that can be emitted. Fields noted as
+optional may be omitted (or `null`) depending on Codex version and lifecycle.
+Unknown fields may appear; ignore what you don't use.
 
 ## Top-level event lines (non-item)
 
@@ -64,6 +66,10 @@ Example:
 {"type":"error","message":"stream error: broken pipe"}
 ```
 
+Note: Codex may emit transient reconnect notices as `type="error"` with messages
+like `"Reconnecting... 1/5"` while it retries a dropped stream. Treat those as
+non-fatal progress updates (the turn continues).
+
 ## Item event lines (`item.*`)
 
 Every item line includes:
@@ -99,7 +105,7 @@ Example:
 Fields:
 - `item.command`
 - `item.aggregated_output`
-- `item.exit_code` (null until completion)
+- `item.exit_code` (null or omitted until completion)
 - `item.status` (`in_progress`, `completed`, `failed`)
 
 Example (started):
@@ -138,10 +144,10 @@ Fields:
 - `item.server`
 - `item.tool`
 - `item.arguments` (JSON value; defaults to `null` if absent)
-- `item.result` (object or `null`)
+- `item.result` (object or `null`; may be omitted)
 - `item.result.content` (array of MCP content blocks)
 - `item.result.structured_content` (JSON value or `null`)
-- `item.error` (object or `null`)
+- `item.error` (object or `null`; may be omitted)
 - `item.error.message` (if `error` is present)
 - `item.status` (`in_progress`, `completed`, `failed`)
 
@@ -317,7 +323,8 @@ machine-only metadata.
   - `file_change.status`: `completed` = patch applied, `failed` = patch failed.
   - `mcp_tool_call.status`: `completed` = tool succeeded, `failed` = tool failed.
 - **Fatal stream errors:** `type = "error"` means the JSONL stream itself hit an
-  unrecoverable error.
+  unrecoverable error (except transient `"Reconnecting... X/Y"` notices, which
+  are non-fatal).
 
 ### Suggested minimal rendering
 
@@ -327,3 +334,12 @@ If you want a compact UI, the following is usually enough:
 - Final answer: `item.completed` with `item.type = "agent_message"`
 - Optional progress: `item.started` / `item.completed` for `command_execution`
   and `file_change`
+
+### Optional/conditional emission notes
+
+- `turn.failed` only appears on failure; otherwise `turn.completed` is emitted.
+- `reasoning` items only appear when reasoning summaries are enabled.
+- `todo_list` items only appear when the plan tool is active; they are the
+  primary source of `item.updated`.
+- `file_change` and `web_search` items are emitted only as `item.completed`
+  in the current `codex exec --json` stream.