chore: import upstream snapshot with attribution

apps/sim/tools/azure_devops/get_pipeline_run.ts

@@ -0,0 +1,157 @@
+import type { GetPipelineRunParams, GetPipelineRunResponse } from '@/tools/azure_devops/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const getPipelineRunTool: ToolConfig<GetPipelineRunParams, GetPipelineRunResponse> = {
+  id: 'azure_devops_get_pipeline_run',
+  name: 'Azure DevOps Get Pipeline Run',
+  description:
+    'Get details for a specific pipeline run in an Azure DevOps project. Returns run state, result, timestamps, and the pipeline reference.',
+  version: '1.0.0',
+
+  params: {
+    organization: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Azure DevOps organization name',
+    },
+    project: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Azure DevOps project name',
+    },
+    pipelineId: {
+      type: 'number',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'ID of the pipeline',
+    },
+    runId: {
+      type: 'number',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'ID of the run to retrieve',
+    },
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Azure DevOps Personal Access Token (scopes: Build: Read, Pipeline: Read)',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const url = new URL(
+        `https://dev.azure.com/${params.organization.trim()}/${params.project.trim()}/_apis/pipelines/${params.pipelineId}/runs/${params.runId}`
+      )
+      url.searchParams.set('api-version', '7.2-preview.1')
+      return url.toString()
+    },
+    method: 'GET',
+    headers: (params) => ({
+      'Content-Type': 'application/json',
+      Authorization: `Basic ${btoa(`:${params.accessToken}`)}`,
+    }),
+  },
+
+  transformResponse: async (response) => {
+    const data = await response.json()
+
+    const run: AzureDevOpsPipelineRunDetailItem = {
+      id: data.id,
+      name: data.name,
+      state: data.state,
+      result: data.result,
+      createdDate: data.createdDate,
+      finishedDate: data.finishedDate,
+      url: data.url,
+      webUrl: data._links?.web?.href ?? '',
+      pipeline: {
+        id: data.pipeline?.id,
+        name: data.pipeline?.name,
+        folder: data.pipeline?.folder ?? '\\',
+        revision: data.pipeline?.revision,
+        url: data.pipeline?.url ?? '',
+      },
+    }
+
+    const resultLine = run.result ? ` | Result: ${run.result}` : ''
+    const finishedLine = run.finishedDate ? ` | Finished: ${run.finishedDate}` : ''
+
+    const content =
+      `Run: ${run.name} (ID: ${run.id})\n` +
+      `Pipeline: ${run.pipeline.name} (ID: ${run.pipeline.id})\n` +
+      `State: ${run.state}${resultLine}\n` +
+      `Created: ${run.createdDate}${finishedLine}\n` +
+      `Web URL: ${run.webUrl}`
+
+    return {
+      success: true,
+      output: {
+        content,
+        metadata: { run },
+      },
+    }
+  },
+
+  outputs: {
+    content: { type: 'string', description: 'Human-readable summary of the pipeline run' },
+    metadata: {
+      type: 'object',
+      description: 'Pipeline run metadata',
+      properties: {
+        run: {
+          type: 'object',
+          description: 'Full pipeline run detail object',
+          properties: {
+            id: { type: 'number', description: 'Run ID' },
+            name: { type: 'string', description: 'Run name (e.g. "20210601.1")' },
+            state: { type: 'string', description: 'Run state (e.g. "completed", "inProgress")' },
+            result: {
+              type: 'string',
+              description: 'Run result (e.g. "succeeded", "failed") — absent if still running',
+            },
+            createdDate: { type: 'string', description: 'ISO 8601 creation timestamp' },
+            finishedDate: {
+              type: 'string',
+              description: 'ISO 8601 finish timestamp — absent if still running',
+            },
+            url: { type: 'string', description: 'Run API URL' },
+            webUrl: { type: 'string', description: 'Browser URL for the run' },
+            pipeline: {
+              type: 'object',
+              description: 'Pipeline reference',
+              properties: {
+                id: { type: 'number', description: 'Pipeline ID' },
+                name: { type: 'string', description: 'Pipeline name' },
+                folder: { type: 'string', description: 'Pipeline folder' },
+                revision: { type: 'number', description: 'Pipeline revision number' },
+                url: { type: 'string', description: 'Pipeline API URL' },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+}
+
+interface AzureDevOpsPipelineRunDetailItem {
+  id: number
+  name: string
+  state: string
+  result?: string
+  createdDate: string
+  finishedDate?: string
+  url: string
+  webUrl: string
+  pipeline: {
+    id: number
+    name: string
+    folder: string
+    revision: number
+    url: string
+  }
+}