Fix file_change in-progress parsing

Author: KSemenenko

CodexSharpSDK.Tests/Performance/ThreadEventParserPerformanceTests.cs

@@ -20,6 +20,7 @@ public class ThreadEventParserPerformanceTests
         """{"type":"item.completed","item":{"id":"cmd_1","type":"command_execution","command":"ls","aggregated_output":"","status":"in_progress"}}""",
         """{"type":"item.completed","item":{"id":"cmd_2","type":"command_execution","command":"ls","aggregated_output":"done","exit_code":0,"status":"completed"}}""",
         """{"type":"item.completed","item":{"id":"cmd_3","type":"command_execution","command":"ls","aggregated_output":"boom","exit_code":1,"status":"failed"}}""",
+        """{"type":"item.started","item":{"id":"change_0","type":"file_change","changes":[{"path":"progress.txt","kind":"add"}],"status":"in_progress"}}""",
         """{"type":"item.completed","item":{"id":"change_1","type":"file_change","changes":[{"path":"a.txt","kind":"add"},{"path":"b.txt","kind":"update"},{"path":"c.txt","kind":"delete"}],"status":"completed"}}""",
         """{"type":"item.completed","item":{"id":"change_2","type":"file_change","changes":[{"path":"d.txt","kind":"update"}],"status":"failed"}}""",
         """{"type":"item.completed","item":{"id":"mcp_1","type":"mcp_tool_call","server":"srv","tool":"tool","arguments":{"x":1},"result":{"content":[{"type":"text","text":"ok"}],"structured_content":{"ok":true}},"status":"in_progress"}}""",
@@ -114,6 +115,7 @@ await Assert.That(commandStatuses).IsEquivalentTo(
         ]);
         await Assert.That(patchStatuses).IsEquivalentTo(
         [
+            PatchApplyStatus.InProgress,
             PatchApplyStatus.Completed,
             PatchApplyStatus.Failed,
         ]);

CodexSharpSDK.Tests/Unit/ThreadEventParserTests.cs

@@ -67,6 +67,22 @@ public async Task Parse_RecognizesAllItemKinds()
         await Assert.That(parsedItems[8]).IsTypeOf<CollabToolCallItem>();
     }
 
+    [Test]
+    public async Task Parse_FileChangeStartedWithInProgressStatus_IsSupported()
+    {
+        var parsed = ThreadEventParser.Parse(
+            "{\"type\":\"item.started\",\"item\":{\"id\":\"item_1\",\"type\":\"file_change\",\"changes\":[{\"path\":\"C:/git/CodexSandbox/apple.txt\",\"kind\":\"add\"},{\"path\":\"C:/git/CodexSandbox/banana.txt\",\"kind\":\"add\"}],\"status\":\"in_progress\"}}");
+
+        var item = (FileChangeItem)((ItemStartedEvent)parsed).Item;
+
+        await Assert.That(item.Id).IsEqualTo("item_1");
+        await Assert.That(item.Status).IsEqualTo(PatchApplyStatus.InProgress);
+        await Assert.That(item.Changes.Select(change => change.Path))
+            .IsEquivalentTo(["C:/git/CodexSandbox/apple.txt", "C:/git/CodexSandbox/banana.txt"]);
+        await Assert.That(item.Changes.Select(change => change.Kind))
+            .IsEquivalentTo([PatchChangeKind.Add, PatchChangeKind.Add]);
+    }
+
     [Test]
     public async Task Parse_ParsesCollabToolCallDetails()
     {

CodexSharpSDK/Internal/ThreadEventParser.cs

@@ -256,6 +256,7 @@ private static PatchApplyStatus ParsePatchApplyStatus(string status)
     {
         return status switch
         {
+            CodexProtocolConstants.Statuses.InProgress => PatchApplyStatus.InProgress,
             CodexProtocolConstants.Statuses.Completed => PatchApplyStatus.Completed,
             CodexProtocolConstants.Statuses.Failed => PatchApplyStatus.Failed,
             _ => throw new InvalidOperationException($"Unsupported patch apply status: {status}"),

CodexSharpSDK/Models/Items.cs

@@ -19,6 +19,7 @@ public enum PatchChangeKind
 
 public enum PatchApplyStatus
 {
+    InProgress,
     Completed,
     Failed,
 }

docs/Features/thread-run-flow.md

@@ -40,6 +40,7 @@ Provide deterministic thread-based execution over Codex CLI so C# consumers can
 - Invalid JSONL event lines must fail fast with parse context.
 - Protocol tokens are parsed via constants, not inline literals.
 - Parser must support `collab_tool_call` items emitted by multi-agent operations.
+- Parser must accept `file_change` lifecycle statuses across started/completed events, including `in_progress` payloads emitted before patch application finishes.
 - Optional `ILogger` (`Microsoft.Extensions.Logging`) receives process lifecycle diagnostics (start/success/failure/cancellation).
 - Structured output uses typed `StructuredOutputSchema` models (including DTO property selectors) that are serialized to CLI JSON schema files.
 - `LocalImageInput` accepts image path, `FileInfo`, or `Stream`; stream inputs are materialized to temp files and cleaned after run.