azure devops: validate-integration fixes + manual description

- bgColor switched from white to Azure DevOps brand color #0078D4 (block + mdx)
- WIQL query_work_items: hydrate ALL matched IDs by chunking through batches
  of 200 instead of silently truncating; check response.ok on the follow-up
  fetch and surface a clear error on 4xx/5xx; trim org/project; expose
  totalMatched in metadata so users can see pre-hydration count
- Add MANUAL-CONTENT-START:intro section to the azure_devops.mdx docs page
- Update unit tests for new chunking behavior and update-work-item validation

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: waleedlatif1

apps/docs/content/docs/en/tools/azure_devops.mdx

@@ -7,9 +7,26 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
 
 <BlockInfoCard 
   type="azure_devops"
-  color="#FFFFFF"
+  color="#0078D4"
 />
 
+{/* MANUAL-CONTENT-START:intro */}
+[Azure DevOps](https://azure.microsoft.com/en-us/products/devops) is Microsoft's end-to-end DevOps platform for planning, building, testing, and shipping software. It powers engineering at tens of thousands of enterprises across automotive, financial services, government, and any organization built on the Microsoft stack.
+
+With the Azure DevOps integration in Sim, you can:
+
+- **Inspect pipelines and runs**: List pipelines, fetch metadata, and walk through run history with status and result
+- **Triage build failures**: Pull build timelines to see which stage, job, or task failed, then fetch the exact log for the failing step
+- **Audit changes between builds**: Surface the work items that landed between any two builds — useful for release notes and regression hunts
+- **Query work items with WIQL**: Run full WIQL queries and get hydrated work item fields back in a single call, not just IDs
+- **Manage work item lifecycle**: Create, update, and read Issues, Tasks, and Epics with structured fields — title, description, priority, assignee, area path, iteration, tags, effort, and dates
+- **Collaborate via comments**: Add internal or public comments to work items and read full comment history
+- **React in real time**: Trigger workflows when builds fail or new work items are created via Azure DevOps service hooks
+
+These capabilities let your Sim agents close the loop on the DevOps lifecycle — automatically triaging broken builds, drafting release notes between deployments, syncing work items across systems, and keeping engineering operations running while your team focuses on shipping.
+{/* MANUAL-CONTENT-END */}
+
+
 ## Usage Instructions
 
 Integrate Azure DevOps into your workflow. List and inspect pipelines and builds, query and manage work items, and add or read comments.

apps/sim/blocks/blocks/azure_devops.ts

@@ -22,7 +22,7 @@ export const AzureDevOpsBlock: BlockConfig<AzureDevOpsResponse> = {
   category: 'tools',
   integrationType: IntegrationType.DeveloperTools,
   tags: ['ci-cd', 'project-management', 'version-control'],
-  bgColor: '#FFFFFF',
+  bgColor: '#0078D4',
   icon: AzureDevOpsIcon,
   authMode: AuthMode.ApiKey,
   triggerAllowed: true,
@@ -136,7 +136,11 @@ export const AzureDevOpsBlock: BlockConfig<AzureDevOpsResponse> = {
       required: true,
       condition: {
         field: 'operation',
-        value: ['azure_devops_list_build_logs', 'azure_devops_get_build_log', 'azure_devops_get_build_timeline'],
+        value: [
+          'azure_devops_list_build_logs',
+          'azure_devops_get_build_log',
+          'azure_devops_get_build_timeline',
+        ],
       },
     },
     {

apps/sim/tools/azure_devops/azure-devops.test.ts

@@ -317,7 +317,9 @@ describe('Azure DevOps request builders', () => {
       { op: 'replace', path: '/fields/System.State', value: 'Doing' },
       { op: 'replace', path: '/fields/Microsoft.VSTS.Scheduling.Effort', value: 5 },
     ])
-    expect(buildBody(updateWorkItemTool, { ...baseParams, workItemId: 101 })).toEqual([])
+    expect(() => buildBody(updateWorkItemTool, { ...baseParams, workItemId: 101 })).toThrow(
+      /requires at least one field/
+    )
 
     const createWithEffortParams = {
       ...createParams,
@@ -575,8 +577,10 @@ describe('Azure DevOps response transforms', () => {
     expect(batch.output.metadata.count).toBe(1)
   })
 
-  it('hydrates WIQL query results with a second fetch and caps IDs at 200', async () => {
-    const fetchMock = vi.fn().mockResolvedValue(responseJson({ value: [rawWorkItem] }))
+  it('hydrates WIQL query results in chunks of 200 IDs', async () => {
+    const fetchMock = vi
+      .fn()
+      .mockImplementation(() => Promise.resolve(responseJson({ value: [rawWorkItem] })))
     globalThis.fetch = fetchMock as unknown as typeof fetch
 
     const workItems = Array.from({ length: 201 }, (_, index) => ({
@@ -589,9 +593,27 @@ describe('Azure DevOps response transforms', () => {
       wiqlQuery: 'SELECT [System.Id] FROM workitems',
     } satisfies QueryWorkItemsParams)
 
-    const detailsUrl = new URL(String(fetchMock.mock.calls[0][0]))
-    expect(detailsUrl.searchParams.get('ids')?.split(',')).toHaveLength(200)
-    expect(result.output.metadata.workItems).toHaveLength(1)
+    expect(fetchMock).toHaveBeenCalledTimes(2)
+    const firstChunk = new URL(String(fetchMock.mock.calls[0][0]))
+    const secondChunk = new URL(String(fetchMock.mock.calls[1][0]))
+    expect(firstChunk.searchParams.get('ids')?.split(',')).toHaveLength(200)
+    expect(secondChunk.searchParams.get('ids')?.split(',')).toHaveLength(1)
+    expect(result.output.metadata.totalMatched).toBe(201)
+    expect(result.output.metadata.workItems).toHaveLength(2)
+  })
+
+  it('throws when WIQL hydration fetch returns a non-OK status', async () => {
+    const fetchMock = vi
+      .fn()
+      .mockResolvedValue(new Response('forbidden', { status: 403, statusText: 'Forbidden' }))
+    globalThis.fetch = fetchMock as unknown as typeof fetch
+
+    await expect(
+      queryWorkItemsTool.transformResponse!(responseJson({ workItems: [{ id: 1, url: 'x' }] }), {
+        ...baseParams,
+        wiqlQuery: 'SELECT [System.Id] FROM workitems',
+      } satisfies QueryWorkItemsParams)
+    ).rejects.toThrow(/Failed to hydrate work item details/)
   })
 
   it('does not hydrate WIQL empty results', async () => {

apps/sim/tools/azure_devops/query_work_items.ts

@@ -44,7 +44,7 @@ export const queryWorkItemsTool: ToolConfig<QueryWorkItemsParams, QueryWorkItems
 
   request: {
     url: (params) =>
-      `https://dev.azure.com/${params.organization}/${params.project}/_apis/wit/wiql?api-version=7.2-preview.2`,
+      `https://dev.azure.com/${params.organization.trim()}/${params.project.trim()}/_apis/wit/wiql?api-version=7.2-preview.2`,
     method: 'POST',
     headers: (params) => ({
       'Content-Type': 'application/json',
@@ -67,41 +67,53 @@ export const queryWorkItemsTool: ToolConfig<QueryWorkItemsParams, QueryWorkItems
       }
     }
 
-    const ids = workItemRefs
-      .slice(0, 200)
-      .map((wi) => wi.id)
-      .join(',')
+    const allIds = workItemRefs.map((wi) => wi.id)
+    const BATCH_SIZE = 200
+    const organization = params!.organization.trim()
+    const project = params!.project.trim()
+    const authHeader = `Basic ${btoa(`:${params!.accessToken}`)}`
 
-    const detailsUrl = new URL(
-      `https://dev.azure.com/${params!.organization}/${params!.project}/_apis/wit/workitems`
-    )
-    detailsUrl.searchParams.set('ids', ids)
-    detailsUrl.searchParams.set('$expand', 'all')
-    detailsUrl.searchParams.set('api-version', '7.2-preview.3')
+    const workItems: AzureDevOpsWorkItem[] = []
+    for (let i = 0; i < allIds.length; i += BATCH_SIZE) {
+      const chunk = allIds.slice(i, i + BATCH_SIZE)
+      const detailsUrl = new URL(
+        `https://dev.azure.com/${organization}/${project}/_apis/wit/workitems`
+      )
+      detailsUrl.searchParams.set('ids', chunk.join(','))
+      detailsUrl.searchParams.set('$expand', 'all')
+      detailsUrl.searchParams.set('api-version', '7.2-preview.3')
 
-    const detailsResponse = await fetch(detailsUrl.toString(), {
-      method: 'GET',
-      headers: {
-        'Content-Type': 'application/json',
-        Authorization: `Basic ${btoa(`:${params!.accessToken}`)}`,
-      },
-    })
+      const detailsResponse = await fetch(detailsUrl.toString(), {
+        method: 'GET',
+        headers: {
+          'Content-Type': 'application/json',
+          Authorization: authHeader,
+        },
+      })
 
-    const detailsData = await detailsResponse.json()
-    const workItems: AzureDevOpsWorkItem[] = (detailsData.value ?? []).map(
-      (raw: AzureDevOpsRawWorkItem) => mapWorkItem(raw)
-    )
+      if (!detailsResponse.ok) {
+        const errorBody = await detailsResponse.text().catch(() => '')
+        throw new Error(
+          `Failed to hydrate work item details (${detailsResponse.status}): ${errorBody || detailsResponse.statusText}`
+        )
+      }
+
+      const detailsData = await detailsResponse.json()
+      for (const raw of detailsData.value ?? []) {
+        workItems.push(mapWorkItem(raw as AzureDevOpsRawWorkItem))
+      }
+    }
 
     const content =
       workItems.length === 0
         ? 'No work item details found.'
-        : `Found ${workItems.length} work item(s):\n\n${workItems.map(formatWorkItem).join('\n\n')}`
+        : `Found ${workItems.length} work item(s) (of ${allIds.length} matched):\n\n${workItems.map(formatWorkItem).join('\n\n')}`
 
     return {
       success: true,
       output: {
         content,
-        metadata: { count: workItems.length, workItems },
+        metadata: { count: workItems.length, totalMatched: allIds.length, workItems },
       },
     }
   },
@@ -115,7 +127,12 @@ export const queryWorkItemsTool: ToolConfig<QueryWorkItemsParams, QueryWorkItems
       type: 'object',
       description: 'Work items metadata',
       properties: {
-        count: { type: 'number', description: 'Number of work items returned' },
+        count: { type: 'number', description: 'Number of work items returned (after hydration)' },
+        totalMatched: {
+          type: 'number',
+          description: 'Total number of work items matched by the WIQL query before hydration',
+          optional: true,
+        },
         workItems: {
           type: 'array',
           description: 'Array of work item details',

apps/sim/tools/azure_devops/types.ts

@@ -274,6 +274,7 @@ export interface QueryWorkItemsResponse extends ToolResponse {
     content: string
     metadata: {
       count: number
+      totalMatched?: number
       workItems: AzureDevOpsWorkItem[]
     }
   }