feat(sdk): add optional summary field to execution-summary types

Add `summary?: string | null` to `ExecutionSummary` and
`WorkflowExecutionSummary` so consumers can read the new
agent/workflow summary field emitted by the orchestrator
(execution_summary endpoints).

Optional + nullable for forward compatibility with orchestrators
that have not yet rolled out the field.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Theaxiom

src/__tests__/types.test.ts

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright 2026 100monkeys.ai
+
+import { ExecutionSummary, WorkflowExecutionSummary } from "../types";
+
+describe("ExecutionSummary summary field", () => {
+  test("ExecutionSummary accepts summary field", () => {
+    const e: ExecutionSummary = {
+      id: "x",
+      status: "completed",
+      started_at: "2026-01-01T00:00:00Z",
+      summary: "hi",
+    };
+    expect(e.summary).toBe("hi");
+  });
+
+  test("ExecutionSummary accepts null summary", () => {
+    const e: ExecutionSummary = {
+      id: "x",
+      status: "completed",
+      started_at: "2026-01-01T00:00:00Z",
+      summary: null,
+    };
+    expect(e.summary).toBeNull();
+  });
+
+  test("ExecutionSummary accepts omitted summary", () => {
+    const e: ExecutionSummary = {
+      id: "x",
+      status: "completed",
+      started_at: "2026-01-01T00:00:00Z",
+    };
+    expect(e.summary).toBeUndefined();
+  });
+});
+
+describe("WorkflowExecutionSummary summary field", () => {
+  test("WorkflowExecutionSummary accepts summary field", () => {
+    const w: WorkflowExecutionSummary = {
+      id: "x",
+      workflow_name: "wf",
+      status: "completed",
+      started_at: "2026-01-01T00:00:00Z",
+      summary: "hi",
+    };
+    expect(w.summary).toBe("hi");
+  });
+
+  test("WorkflowExecutionSummary accepts null summary", () => {
+    const w: WorkflowExecutionSummary = {
+      id: "x",
+      workflow_name: "wf",
+      status: "completed",
+      started_at: "2026-01-01T00:00:00Z",
+      summary: null,
+    };
+    expect(w.summary).toBeNull();
+  });
+
+  test("WorkflowExecutionSummary accepts omitted summary", () => {
+    const w: WorkflowExecutionSummary = {
+      id: "x",
+      workflow_name: "wf",
+      status: "completed",
+      started_at: "2026-01-01T00:00:00Z",
+    };
+    expect(w.summary).toBeUndefined();
+  });
+});

src/types.ts

@@ -27,6 +27,7 @@ export interface ExecutionSummary {
   status: string;
   started_at: string;
   ended_at?: string;
+  summary?: string | null;
 }
 
 export interface ExecutionDetail extends ExecutionSummary {
@@ -149,6 +150,7 @@ export interface WorkflowExecutionSummary {
   started_at: string;
   ended_at?: string;
   current_state?: string;
+  summary?: string | null;
 }
 
 export interface WorkflowExecutionListResponse {