Normalize tool lifecycle payloads

- Canonicalize provider runtime tool data and usage snapshots
- Update work log extraction and user input contracts for the new schema
- Add coverage for the revised lifecycle and ingestion shapes

Author: juliusmarminge

apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.test.ts

@@ -1809,7 +1809,9 @@ describe("ProviderRuntimeIngestion", () => {
         status: "in_progress",
         title: "Run tests",
         detail: "bun test",
-        data: { pid: 123 },
+        data: {
+          kind: "generic",
+        },
       },
     });
 

apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.ts

@@ -1,6 +1,7 @@
 import {
   ApprovalRequestId,
   type AssistantDeliveryMode,
+  type CanonicalJsonValue,
   CommandId,
   MessageId,
   type OrchestrationEvent,
@@ -102,6 +103,16 @@ function asString(value: unknown): string | undefined {
   return typeof value === "string" ? value : undefined;
 }
 
+function toCanonicalJsonValue(value: unknown): CanonicalJsonValue | undefined {
+  if (value === undefined) {
+    return undefined;
+  }
+  const normalized = JSON.parse(
+    JSON.stringify(value, (_key, nestedValue) => (nestedValue === undefined ? null : nestedValue)),
+  ) as CanonicalJsonValue | null;
+  return normalized ?? undefined;
+}
+
 function buildContextWindowActivityPayload(
   event: ProviderRuntimeEvent,
 ): ThreadTokenUsageSnapshot | undefined {
@@ -283,7 +294,9 @@ function runtimeEventToActivities(
           summary: "Runtime warning",
           payload: {
             message: truncateDetail(event.payload.message),
-            ...(event.payload.detail !== undefined ? { detail: event.payload.detail } : {}),
+            ...(event.payload.detail !== undefined
+              ? { detail: toCanonicalJsonValue(event.payload.detail) }
+              : {}),
           },
           turnId: toTurnId(event.turnId) ?? null,
           ...maybeSequence,
@@ -433,7 +446,9 @@ function runtimeEventToActivities(
           summary: "Context compacted",
           payload: {
             state: event.payload.state,
-            ...(event.payload.detail !== undefined ? { detail: event.payload.detail } : {}),
+            ...(event.payload.detail !== undefined
+              ? { detail: toCanonicalJsonValue(event.payload.detail) }
+              : {}),
           },
           turnId: toTurnId(event.turnId) ?? null,
           ...maybeSequence,

apps/server/src/provider/Layers/ClaudeAdapter.test.ts

@@ -914,12 +914,13 @@ describe("ClaudeAdapterLive", () => {
       const toolInputUpdated = runtimeEvents.find(
         (event) =>
           event.type === "item.updated" &&
-          (event.payload.data as { input?: { pattern?: string; path?: string } } | undefined)?.input
-            ?.pattern === "foo",
+          event.payload.data?.kind === "generic" &&
+          event.payload.data.input?.pattern === "foo",
       );
       assert.equal(toolInputUpdated?.type, "item.updated");
       if (toolInputUpdated?.type === "item.updated") {
         assert.deepEqual(toolInputUpdated.payload.data, {
+          kind: "generic",
           toolName: "Grep",
           input: {
             pattern: "foo",
@@ -931,17 +932,25 @@ describe("ClaudeAdapterLive", () => {
       const toolResultUpdated = runtimeEvents.find(
         (event) =>
           event.type === "item.updated" &&
-          (event.payload.data as { result?: { tool_use_id?: string } } | undefined)?.result
-            ?.tool_use_id === "tool-grep-1",
+          event.payload.data?.kind === "generic" &&
+          event.payload.data.result !== undefined &&
+          event.payload.data.result !== null &&
+          typeof event.payload.data.result === "object" &&
+          !Array.isArray(event.payload.data.result) &&
+          "tool_use_id" in event.payload.data.result &&
+          event.payload.data.result.tool_use_id === "tool-grep-1",
       );
       assert.equal(toolResultUpdated?.type, "item.updated");
       if (toolResultUpdated?.type === "item.updated") {
         assert.equal(
-          (
-            toolResultUpdated.payload.data as {
-              result?: { content?: string };
-            }
-          ).result?.content,
+          toolResultUpdated.payload.data?.kind === "generic" &&
+            toolResultUpdated.payload.data.result !== undefined &&
+            toolResultUpdated.payload.data.result !== null &&
+            typeof toolResultUpdated.payload.data.result === "object" &&
+            !Array.isArray(toolResultUpdated.payload.data.result) &&
+            "content" in toolResultUpdated.payload.data.result
+            ? toolResultUpdated.payload.data.result.content
+            : undefined,
           "src/example.ts:1:foo",
         );
       }