@desplega.ai/agent-swarm 1.172.0 → 2.0.0

package/src/tests/fetch-resolved-env.test.ts

@@ -120,6 +120,95 @@ describe("fetchResolvedEnv", () => {
       warning.mockRestore();
     }
   });
+
+  test("exportToEnv=false rows stay out of the harness env, even over a boot copy", async () => {
+    const agentId = crypto.randomUUID();
+    mockResponsesByAgentId.set(agentId, {
+      status: 200,
+      body: {
+        configs: [
+          { key: "VERCEL_TOKEN", value: "row-vercel", isSecret: true, exportToEnv: false },
+          { key: "GITHUB_TOKEN", value: "row-github", isSecret: true, exportToEnv: true },
+          { key: "PUBLIC_SETTING", value: "visible", isSecret: false, exportToEnv: true },
+          { key: "HIDDEN_SETTING", value: "hidden", isSecret: false, exportToEnv: false },
+          // A pre-215 API sends no flag: the row keeps exporting.
+          { key: "LEGACY_SECRET", value: "row-legacy", isSecret: true },
+          // Restricted keys never export, whatever the row says.
+          { key: "SLACK_APP_TOKEN", value: "row-xapp", isSecret: true, exportToEnv: true },
+        ],
+      },
+    });
+    const log = spyOn(console, "log").mockImplementation(() => {});
+    try {
+      // The base env stands for the container env or an older entrypoint's
+      // boot export; a withheld row must remove those copies too.
+      const result = await fetchResolvedEnv(testUrl, "key", agentId, {
+        VERCEL_TOKEN: "boot-vercel",
+        SLACK_APP_TOKEN: "boot-xapp",
+      });
+      expect(result.env.VERCEL_TOKEN).toBeUndefined();
+      expect(result.env.HIDDEN_SETTING).toBeUndefined();
+      expect(result.env.SLACK_APP_TOKEN).toBeUndefined();
+      expect(result.env.GITHUB_TOKEN).toBe("row-github");
+      expect(result.env.PUBLIC_SETTING).toBe("visible");
+      expect(result.env.LEGACY_SECRET).toBe("row-legacy");
+      const logged = log.mock.calls.map((call) => String(call[0])).join("\n");
+      expect(logged).toContain("HIDDEN_SETTING, SLACK_APP_TOKEN, VERCEL_TOKEN");
+      expect(logged).not.toContain("row-vercel");
+      expect(logged).not.toContain("boot-vercel");
+    } finally {
+      log.mockRestore();
+    }
+  });
+
+  test("a row revoked after boot leaves process.env, so merged adapter envs lose it", async () => {
+    const agentId = crypto.randomUUID();
+    const key = "REVOKED_AFTER_BOOT_SECRET";
+    mockResponsesByAgentId.set(agentId, {
+      status: 200,
+      body: { configs: [{ key, value: "row-value", isSecret: true, exportToEnv: false }] },
+    });
+    // The entrypoint exported the row at boot, before it was switched off.
+    process.env[key] = "boot-export";
+    const log = spyOn(console, "log").mockImplementation(() => {});
+    try {
+      const result = await fetchResolvedEnv(testUrl, "key", agentId);
+      expect(result.env[key]).toBeUndefined();
+      expect(process.env[key]).toBeUndefined();
+      // The amp, dsh, grok, cursor and claude adapters spawn with this shape.
+      expect({ ...process.env, ...result.env }[key]).toBeUndefined();
+    } finally {
+      delete process.env[key];
+      log.mockRestore();
+    }
+  });
+
+  test("a masked row keeps its boot value only when the row is exported", async () => {
+    const agentId = crypto.randomUUID();
+    mockResponsesByAgentId.set(agentId, {
+      status: 200,
+      body: {
+        configs: [
+          { key: "EXPORTED_BOOT", value: MASKED_SECRET_VALUE, isSecret: true, exportToEnv: true },
+          { key: "WITHHELD_BOOT", value: MASKED_SECRET_VALUE, isSecret: true, exportToEnv: false },
+        ],
+      },
+    });
+    const warning = spyOn(console, "warn").mockImplementation(() => {});
+    const log = spyOn(console, "log").mockImplementation(() => {});
+    try {
+      const result = await fetchResolvedEnv(testUrl, "key", agentId, {
+        EXPORTED_BOOT: "boot-exported",
+        WITHHELD_BOOT: "boot-withheld",
+      });
+      expect(result.env.EXPORTED_BOOT).toBe("boot-exported");
+      expect(result.env.WITHHELD_BOOT).toBeUndefined();
+    } finally {
+      warning.mockRestore();
+      log.mockRestore();
+    }
+  });
+
   test("repository scope requires the requested repository identity", async () => {
     const repoId = crypto.randomUUID();
     let url = "https://github.com/another-owner/fixture";
@@ -305,6 +394,45 @@ describe("fetchResolvedEnv", () => {
     ]);
   });
 
+  test("HELMCODE_API_NAN alias becomes NAN_API_KEY and pools for a nan/* model", async () => {
+    const agentId = crypto.randomUUID();
+    mockResponsesByAgentId.set(agentId, {
+      status: 200,
+      body: { configs: [{ key: "HELMCODE_API_NAN", value: "fixture-nan-a,fixture-nan-b" }] },
+    });
+    const result = await fetchResolvedEnv(testUrl, "key", agentId, {}, "nan/glm5.3-flash", {
+      provider: "opencode",
+    });
+    expect(result.env.NAN_API_KEY).toMatch(/^fixture-nan-[ab]$/);
+    expect(result.credentialSelections.map((selection) => selection.keyType)).toEqual([
+      "NAN_API_KEY",
+    ]);
+  });
+
+  test("an explicit NAN_API_KEY wins over the HELMCODE_API_NAN alias", async () => {
+    const agentId = crypto.randomUUID();
+    mockResponsesByAgentId.set(agentId, {
+      status: 200,
+      body: {
+        configs: [
+          { key: "NAN_API_KEY", value: "fixture-nan-canonical" },
+          { key: "HELMCODE_API_NAN", value: "fixture-nan-alias" },
+        ],
+      },
+    });
+    const result = await fetchResolvedEnv(testUrl, "key", agentId, {}, "nan/qwen3.6", {
+      provider: "pi",
+    });
+    expect(result.env.NAN_API_KEY).toBe("fixture-nan-canonical");
+  });
+
+  test("the alias also normalizes from the boot env when the API is unreachable", async () => {
+    const result = await fetchResolvedEnv("", "key", "agent-1", {
+      HELMCODE_API_NAN: "fixture-nan-boot",
+    });
+    expect(result.env.NAN_API_KEY).toBe("fixture-nan-boot");
+  });
+
   describe("model-scoped window filter — GET /api/keys/available?model=<family>", () => {
     beforeEach(() => {
       keysAvailableRequests.length = 0;

package/src/tests/fixtures/azure-boards/workitem.commented.json

@@ -0,0 +1,89 @@
+{
+  "subscriptionId": "a8d9a164-3964-405f-9e71-9159cce4eeb5",
+  "notificationId": 1,
+  "id": "40196cd7-1da3-43fb-a15d-48d654ab8304",
+  "eventType": "workitem.commented",
+  "publisherId": "tfs",
+  "message": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) commented on by Alex Example (CONTOSO)\r\n(https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9)",
+    "html": "<a href=\"https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&amp;id=9\">Task #9</a> ([Swarm test] List the 5 most recently modified files in the example-web-app repository) commented on by Alex Example (CONTOSO)",
+    "markdown": "[Task #9](https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9) ([Swarm test] List the 5 most recently modified files in the example-web-app repository) commented on by Alex Example (CONTOSO)"
+  },
+  "detailedMessage": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) commented on by Alex Example (CONTOSO)\r\n(https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9)\r\n\r\n@Swarm Bot (CONTOSO)(#) please do this task.\r\n",
+    "html": "<a href=\"https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&amp;id=9\">Task #9</a> ([Swarm test] List the 5 most recently modified files in the example-web-app repository) commented on by Alex Example (CONTOSO)<br/><div><a href=\"#\" data-vss-mention=\"version:2.0,7d40ac7f-6bdb-6baf-a2e2-dc9594e967d4\">@Swarm Bot (CONTOSO)</a>&nbsp;please do this task.</div>",
+    "markdown": "[Task #9](https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9) ([Swarm test] List the 5 most recently modified files in the example-web-app repository) commented on by Alex Example (CONTOSO)\r\n\r\n[@Swarm Bot (CONTOSO)](#) please do this task.\r\n"
+  },
+  "resource": {
+    "id": 9,
+    "rev": 3,
+    "fields": {
+      "System.AreaPath": "Contoso",
+      "System.TeamProject": "Contoso",
+      "System.IterationPath": "Contoso",
+      "System.WorkItemType": "Task",
+      "System.State": "To Do",
+      "System.Reason": "Added to backlog",
+      "System.AssignedTo": "Swarm Bot (CONTOSO) <swarm-bot@example.com>",
+      "System.CreatedDate": "2026-10-13T10:47:49.627Z",
+      "System.CreatedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "System.ChangedDate": "2026-10-13T10:49:24.08Z",
+      "System.ChangedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "System.CommentCount": 1,
+      "System.Title": "[Swarm test] List the 5 most recently modified files in the example-web-app repository",
+      "Microsoft.VSTS.Common.Priority": 2,
+      "Microsoft.VSTS.Common.StateChangeDate": "2026-10-13T10:47:49.627Z",
+      "System.Description": "<div>Test task for Azure Boards integration. List the 5 most recent commits on the `main` branch of the `smart-lab-platform web-app` repository (SHA, author, title). Read-only; do not modify code or create a PR.<br> </div>",
+      "System.History": "<div><a href=\"#\" data-vss-mention=\"version:2.0,7d40ac7f-6bdb-6baf-a2e2-dc9594e967d4\">@Swarm Bot (CONTOSO)</a>&nbsp;please do this task.</div>"
+    },
+    "multilineFieldsFormat": {
+      "System.Description": "html",
+      "System.History": "html"
+    },
+    "commentVersionRef": {
+      "commentId": 1510011,
+      "version": 1,
+      "url": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/comments/1510011/versions/1"
+    },
+    "_links": {
+      "self": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9"
+      },
+      "workItemUpdates": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/updates"
+      },
+      "workItemRevisions": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/revisions"
+      },
+      "workItemComments": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/comments"
+      },
+      "html": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_workitems/edit/9"
+      },
+      "workItemType": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItemTypes/Task"
+      },
+      "fields": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/fields"
+      }
+    },
+    "url": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9"
+  },
+  "resourceVersion": "1.0",
+  "resourceContainers": {
+    "collection": {
+      "id": "b51292df-d230-4305-a9da-cdee48c0d617",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "account": {
+      "id": "bf998297-d284-4c84-b338-e4558a468208",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "project": {
+      "id": "0d526892-c851-4fc5-b38a-8a401faa117e",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    }
+  },
+  "createdDate": "2026-10-13T10:49:30.4275889Z"
+}

package/src/tests/fixtures/azure-boards/workitem.created.json

@@ -0,0 +1,81 @@
+{
+  "subscriptionId": "88386d07-2a77-4bce-8a18-8e1903f16797",
+  "notificationId": 1,
+  "id": "09acb7d5-be99-4000-880c-7e3336ff3401",
+  "eventType": "workitem.created",
+  "publisherId": "tfs",
+  "message": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) created by Alex Example (CONTOSO)\r\n(https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9)",
+    "html": "<a href=\"https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&amp;id=9\">Task #9</a> ([Swarm test] List the 5 most recently modified files in the example-web-app repository) created by Alex Example (CONTOSO)",
+    "markdown": "[Task #9](https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9) ([Swarm test] List the 5 most recently modified files in the example-web-app repository) created by Alex Example (CONTOSO)"
+  },
+  "detailedMessage": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) created by Alex Example (CONTOSO)\r\n(https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9)\r\n\r\n- Area: Contoso\r\n- Iteration: Contoso\r\n- State: To Do\r\n",
+    "html": "<a href=\"https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&amp;id=9\">Task #9</a> ([Swarm test] List the 5 most recently modified files in the example-web-app repository) created by Alex Example (CONTOSO)<ul>\r\n<li>Area: Contoso</li>\r\n<li>Iteration: Contoso</li>\r\n<li>State: To Do</li></ul>",
+    "markdown": "[Task #9](https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9) ([Swarm test] List the 5 most recently modified files in the example-web-app repository) created by Alex Example (CONTOSO)\r\n\r\n* Area: Contoso\r\n* Iteration: Contoso\r\n* State: To Do\r\n"
+  },
+  "resource": {
+    "id": 9,
+    "rev": 1,
+    "fields": {
+      "System.AreaPath": "Contoso",
+      "System.TeamProject": "Contoso",
+      "System.IterationPath": "Contoso",
+      "System.WorkItemType": "Task",
+      "System.State": "To Do",
+      "System.Reason": "Added to backlog",
+      "System.CreatedDate": "2026-10-13T10:47:49.627Z",
+      "System.CreatedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "System.ChangedDate": "2026-10-13T10:47:49.627Z",
+      "System.ChangedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "System.CommentCount": 0,
+      "System.Title": "[Swarm test] List the 5 most recently modified files in the example-web-app repository",
+      "Microsoft.VSTS.Common.Priority": 2,
+      "Microsoft.VSTS.Common.StateChangeDate": "2026-10-13T10:47:49.627Z",
+      "System.Description": "<div>Test task for Azure Boards integration. List the 5 most recent commits on the `main` branch of the `smart-lab-platform web-app` repository (SHA, author, title). Read-only; do not modify code or create a PR.<br> </div>"
+    },
+    "multilineFieldsFormat": {
+      "System.Description": "html"
+    },
+    "_links": {
+      "self": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9"
+      },
+      "workItemUpdates": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/updates"
+      },
+      "workItemRevisions": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/revisions"
+      },
+      "workItemComments": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/comments"
+      },
+      "html": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_workitems/edit/9"
+      },
+      "workItemType": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItemTypes/Task"
+      },
+      "fields": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/fields"
+      }
+    },
+    "url": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9"
+  },
+  "resourceVersion": "1.0",
+  "resourceContainers": {
+    "collection": {
+      "id": "b51292df-d230-4305-a9da-cdee48c0d617",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "account": {
+      "id": "bf998297-d284-4c84-b338-e4558a468208",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "project": {
+      "id": "0d526892-c851-4fc5-b38a-8a401faa117e",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    }
+  },
+  "createdDate": "2026-10-13T10:47:56.5654685Z"
+}

package/src/tests/fixtures/azure-boards/workitem.deleted.json

@@ -0,0 +1,70 @@
+{
+  "subscriptionId": "d93f9857-822d-43b9-af3d-fa03cc8e505d",
+  "notificationId": 1,
+  "id": "71ec5eac-b50a-477b-b1c1-30faba5c8750",
+  "eventType": "workitem.deleted",
+  "publisherId": "tfs",
+  "message": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) deleted by Alex Example (CONTOSO)",
+    "html": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) deleted by Alex Example (CONTOSO)",
+    "markdown": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) deleted by Alex Example (CONTOSO)"
+  },
+  "detailedMessage": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) deleted by Alex Example (CONTOSO)\r\n\r\n- Area: Contoso\r\n- Iteration: Contoso\r\n- State: To Do\r\n- Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com>\r\n",
+    "html": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) deleted by Alex Example (CONTOSO)<ul>\r\n<li>Area: Contoso</li>\r\n<li>Iteration: Contoso</li>\r\n<li>State: To Do</li>\r\n<li>Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com></li></ul>",
+    "markdown": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) deleted by Alex Example (CONTOSO)\r\n\r\n* Area: Contoso\r\n* Iteration: Contoso\r\n* State: To Do\r\n* Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com>\r\n"
+  },
+  "resource": {
+    "id": 9,
+    "rev": 5,
+    "fields": {
+      "System.AreaPath": "Contoso",
+      "System.TeamProject": "Contoso",
+      "System.IterationPath": "Contoso",
+      "System.WorkItemType": "Task",
+      "System.State": "To Do",
+      "System.Reason": "Added to backlog",
+      "System.AssignedTo": "Swarm Bot (CONTOSO) <swarm-bot@example.com>",
+      "System.CreatedDate": "2026-10-13T10:47:49.627Z",
+      "System.CreatedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "System.ChangedDate": "2026-10-13T10:50:18.187Z",
+      "System.ChangedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "System.CommentCount": 2,
+      "System.Title": "[Swarm test] List the 5 most recently modified files in the example-web-app repository",
+      "Microsoft.VSTS.Common.Priority": 2,
+      "Microsoft.VSTS.Common.StateChangeDate": "2026-10-13T10:47:49.627Z",
+      "System.Description": "<div>Test task for Azure Boards integration. List the 5 most recent commits on the `main` branch of the `smart-lab-platform web-app` repository (SHA, author, title). Read-only; do not modify code or create a PR.<br> </div>"
+    },
+    "multilineFieldsFormat": {
+      "System.Description": "html"
+    },
+    "_links": {
+      "self": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/recyclebin/9"
+      },
+      "workItemType": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItemTypes/Task"
+      },
+      "fields": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/fields"
+      }
+    },
+    "url": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/recyclebin/9"
+  },
+  "resourceVersion": "1.0",
+  "resourceContainers": {
+    "collection": {
+      "id": "b51292df-d230-4305-a9da-cdee48c0d617",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "account": {
+      "id": "bf998297-d284-4c84-b338-e4558a468208",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "project": {
+      "id": "0d526892-c851-4fc5-b38a-8a401faa117e",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    }
+  },
+  "createdDate": "2026-10-13T10:50:24.8988125Z"
+}

package/src/tests/fixtures/azure-boards/workitem.restored.json

@@ -0,0 +1,82 @@
+{
+  "subscriptionId": "e2f8fec8-22c9-4324-bb8d-3fa493144922",
+  "notificationId": 1,
+  "id": "66e543cb-221e-4a68-9356-57d37174c41d",
+  "eventType": "workitem.restored",
+  "publisherId": "tfs",
+  "message": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) restored by Alex Example (CONTOSO)\r\n(https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9)",
+    "html": "<a href=\"https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&amp;id=9\">Task #9</a> ([Swarm test] List the 5 most recently modified files in the example-web-app repository) restored by Alex Example (CONTOSO)",
+    "markdown": "[Task #9](https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9) ([Swarm test] List the 5 most recently modified files in the example-web-app repository) restored by Alex Example (CONTOSO)"
+  },
+  "detailedMessage": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) restored by Alex Example (CONTOSO)\r\n(https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9)\r\n\r\n- Area: Contoso\r\n- Iteration: Contoso\r\n- State: To Do\r\n- Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com>\r\n",
+    "html": "<a href=\"https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&amp;id=9\">Task #9</a> ([Swarm test] List the 5 most recently modified files in the example-web-app repository) restored by Alex Example (CONTOSO)<ul>\r\n<li>Area: Contoso</li>\r\n<li>Iteration: Contoso</li>\r\n<li>State: To Do</li>\r\n<li>Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com></li></ul>",
+    "markdown": "[Task #9](https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9) ([Swarm test] List the 5 most recently modified files in the example-web-app repository) restored by Alex Example (CONTOSO)\r\n\r\n* Area: Contoso\r\n* Iteration: Contoso\r\n* State: To Do\r\n* Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com>\r\n"
+  },
+  "resource": {
+    "id": 9,
+    "rev": 6,
+    "fields": {
+      "System.AreaPath": "Contoso",
+      "System.TeamProject": "Contoso",
+      "System.IterationPath": "Contoso",
+      "System.WorkItemType": "Task",
+      "System.State": "To Do",
+      "System.Reason": "Added to backlog",
+      "System.AssignedTo": "Swarm Bot (CONTOSO) <swarm-bot@example.com>",
+      "System.CreatedDate": "2026-10-13T10:47:49.627Z",
+      "System.CreatedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "System.ChangedDate": "2026-10-13T10:50:37.613Z",
+      "System.ChangedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "System.CommentCount": 2,
+      "System.Title": "[Swarm test] List the 5 most recently modified files in the example-web-app repository",
+      "Microsoft.VSTS.Common.Priority": 2,
+      "Microsoft.VSTS.Common.StateChangeDate": "2026-10-13T10:47:49.627Z",
+      "System.Description": "<div>Test task for Azure Boards integration. List the 5 most recent commits on the `main` branch of the `smart-lab-platform web-app` repository (SHA, author, title). Read-only; do not modify code or create a PR.<br> </div>"
+    },
+    "multilineFieldsFormat": {
+      "System.Description": "html"
+    },
+    "_links": {
+      "self": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9"
+      },
+      "workItemUpdates": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/updates"
+      },
+      "workItemRevisions": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/revisions"
+      },
+      "workItemComments": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/comments"
+      },
+      "html": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_workitems/edit/9"
+      },
+      "workItemType": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItemTypes/Task"
+      },
+      "fields": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/fields"
+      }
+    },
+    "url": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9"
+  },
+  "resourceVersion": "1.0",
+  "resourceContainers": {
+    "collection": {
+      "id": "b51292df-d230-4305-a9da-cdee48c0d617",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "account": {
+      "id": "bf998297-d284-4c84-b338-e4558a468208",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "project": {
+      "id": "0d526892-c851-4fc5-b38a-8a401faa117e",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    }
+  },
+  "createdDate": "2026-10-13T10:50:43.9993374Z"
+}

package/src/tests/fixtures/azure-boards/workitem.updated.json

@@ -0,0 +1,130 @@
+{
+  "subscriptionId": "7a0f02b3-9c09-4ef2-82f7-ce5cb31ac236",
+  "notificationId": 1,
+  "id": "02a678cc-3de4-428a-9ff4-8e0e069f9b52",
+  "eventType": "workitem.updated",
+  "publisherId": "tfs",
+  "message": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) assigned to Swarm Bot (CONTOSO) by Alex Example (CONTOSO)\r\n(https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9)",
+    "html": "<a href=\"https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&amp;id=9\">Task #9</a> ([Swarm test] List the 5 most recently modified files in the example-web-app repository) assigned to Swarm Bot (CONTOSO) by Alex Example (CONTOSO)",
+    "markdown": "[Task #9](https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9) ([Swarm test] List the 5 most recently modified files in the example-web-app repository) assigned to Swarm Bot (CONTOSO) by Alex Example (CONTOSO)"
+  },
+  "detailedMessage": {
+    "text": "Task #9 ([Swarm test] List the 5 most recently modified files in the example-web-app repository) assigned to Swarm Bot (CONTOSO) by Alex Example (CONTOSO)\r\n(https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9)\r\n\r\n- New Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com>\r\n",
+    "html": "<a href=\"https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&amp;id=9\">Task #9</a> ([Swarm test] List the 5 most recently modified files in the example-web-app repository) assigned to Swarm Bot (CONTOSO) by Alex Example (CONTOSO)<ul>\r\n<li>New Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com></li></ul>",
+    "markdown": "[Task #9](https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9) ([Swarm test] List the 5 most recently modified files in the example-web-app repository) assigned to Swarm Bot (CONTOSO) by Alex Example (CONTOSO)\r\n\r\n* New Assigned to: Swarm Bot (CONTOSO) <swarm-bot@example.com>\r\n"
+  },
+  "resource": {
+    "id": 2,
+    "workItemId": 9,
+    "rev": 2,
+    "revisedBy": {
+      "id": "3a9a0823-7970-6056-85b0-fa927bad6a02",
+      "name": "Alex Example (CONTOSO) <alex.example@example.com>",
+      "displayName": "Alex Example (CONTOSO)",
+      "url": "https://spsprodcus7.vssps.visualstudio.com/Abf998297-d284-4c84-b338-e4558a468208/_apis/Identities/3a9a0823-7970-6056-85b0-fa927bad6a02",
+      "_links": {
+        "avatar": {
+          "href": "https://dev.azure.com/acme-org/_apis/GraphProfile/MemberAvatars/aad.M2E5YTA4MjMtNzk3MC03MDU2LTg1YjAtZmE5MjdiYWQ2YTAy"
+        }
+      },
+      "uniqueName": "alex.example@example.com",
+      "imageUrl": "https://dev.azure.com/acme-org/_apis/GraphProfile/MemberAvatars/aad.M2E5YTA4MjMtNzk3MC03MDU2LTg1YjAtZmE5MjdiYWQ2YTAy",
+      "descriptor": "aad.M2E5YTA4MjMtNzk3MC03MDU2LTg1YjAtZmE5MjdiYWQ2YTAy"
+    },
+    "revisedDate": "9999-01-01T00:00:00Z",
+    "fields": {
+      "System.Rev": {
+        "oldValue": 1,
+        "newValue": 2
+      },
+      "System.AuthorizedDate": {
+        "oldValue": "2026-10-13T10:47:49.627Z",
+        "newValue": "2026-10-13T10:48:32.36Z"
+      },
+      "System.RevisedDate": {
+        "oldValue": "2026-10-13T10:48:32.36Z",
+        "newValue": "9999-01-01T00:00:00Z"
+      },
+      "System.AssignedTo": {
+        "newValue": "Swarm Bot (CONTOSO) <swarm-bot@example.com>"
+      },
+      "System.ChangedDate": {
+        "oldValue": "2026-10-13T10:47:49.627Z",
+        "newValue": "2026-10-13T10:48:32.36Z"
+      },
+      "System.Watermark": {
+        "oldValue": 41,
+        "newValue": 42
+      }
+    },
+    "_links": {
+      "self": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/updates/2"
+      },
+      "workItemUpdates": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/updates"
+      },
+      "parent": {
+        "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9"
+      },
+      "html": {
+        "href": "https://dev.azure.com/acme-org/web/wi.aspx?pcguid=b51292df-d230-4305-a9da-cdee48c0d617&id=9"
+      }
+    },
+    "url": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/updates/2",
+    "revision": {
+      "id": 9,
+      "rev": 2,
+      "fields": {
+        "System.AreaPath": "Contoso",
+        "System.TeamProject": "Contoso",
+        "System.IterationPath": "Contoso",
+        "System.WorkItemType": "Task",
+        "System.State": "To Do",
+        "System.Reason": "Added to backlog",
+        "System.AssignedTo": "Swarm Bot (CONTOSO) <swarm-bot@example.com>",
+        "System.CreatedDate": "2026-10-13T10:47:49.627Z",
+        "System.CreatedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+        "System.ChangedDate": "2026-10-13T10:48:32.36Z",
+        "System.ChangedBy": "Alex Example (CONTOSO) <alex.example@example.com>",
+        "System.CommentCount": 0,
+        "System.Title": "[Swarm test] List the 5 most recently modified files in the example-web-app repository",
+        "Microsoft.VSTS.Common.Priority": 2,
+        "Microsoft.VSTS.Common.StateChangeDate": "2026-10-13T10:47:49.627Z",
+        "System.Description": "<div>Test task for Azure Boards integration. List the 5 most recent commits on the `main` branch of the `smart-lab-platform web-app` repository (SHA, author, title). Read-only; do not modify code or create a PR.<br> </div>"
+      },
+      "multilineFieldsFormat": {
+        "System.Description": "html"
+      },
+      "_links": {
+        "self": {
+          "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/revisions/2"
+        },
+        "workItemRevisions": {
+          "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/revisions"
+        },
+        "parent": {
+          "href": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9"
+        }
+      },
+      "url": "https://dev.azure.com/acme-org/0d526892-c851-4fc5-b38a-8a401faa117e/_apis/wit/workItems/9/revisions/2"
+    }
+  },
+  "resourceVersion": "1.0",
+  "resourceContainers": {
+    "collection": {
+      "id": "b51292df-d230-4305-a9da-cdee48c0d617",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "account": {
+      "id": "bf998297-d284-4c84-b338-e4558a468208",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    },
+    "project": {
+      "id": "0d526892-c851-4fc5-b38a-8a401faa117e",
+      "baseUrl": "https://dev.azure.com/acme-org/"
+    }
+  },
+  "createdDate": "2026-10-13T10:48:38.9033359Z"
+}