@vm3jack/mcp-server-azure-devops 1.0.0

package/dist/features/pipelines/artifacts.js

@@ -0,0 +1,288 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchRunArtifacts = fetchRunArtifacts;
+exports.getArtifactContainerInfo = getArtifactContainerInfo;
+exports.parseArtifactContainer = parseArtifactContainer;
+const axios_1 = __importDefault(require("axios"));
+const jszip_1 = __importDefault(require("jszip"));
+const FileContainerInterfaces_1 = require("azure-devops-node-api/interfaces/FileContainerInterfaces");
+const PipelinesInterfaces_1 = require("azure-devops-node-api/interfaces/PipelinesInterfaces");
+const MAX_ITEMS_PER_ARTIFACT = 200;
+function extractContainerInfo(resource) {
+    const data = resource?.data;
+    if (typeof data !== 'string' || data.length === 0) {
+        return {};
+    }
+    const segments = data.split('/').filter((segment) => segment.length > 0);
+    if (segments.length < 2) {
+        return {};
+    }
+    const containerId = Number.parseInt(segments[1] ?? '', 10);
+    if (Number.isNaN(containerId)) {
+        return {};
+    }
+    const rootPath = segments.slice(2).join('/');
+    return {
+        containerId,
+        rootPath: rootPath.length > 0 ? rootPath : undefined,
+    };
+}
+function mapBuildArtifact(artifact) {
+    const resource = artifact.resource;
+    const { containerId, rootPath } = extractContainerInfo(resource);
+    return {
+        name: artifact.name ?? 'unknown',
+        type: resource?.type,
+        source: artifact.source,
+        downloadUrl: resource?.downloadUrl,
+        resourceUrl: resource?.url,
+        containerId,
+        rootPath,
+    };
+}
+function normalizePathSegment(segment) {
+    return segment.replace(/^[\\/]+|[\\/]+$/g, '');
+}
+function normalizeFullPath(path) {
+    return path.replace(/\\+/g, '/').replace(/^\/+/, '');
+}
+function makeRelativePath(path, prefixes) {
+    const normalized = normalizeFullPath(path);
+    const filteredPrefixes = prefixes
+        .map((prefix) => normalizePathSegment(prefix))
+        .filter((prefix) => prefix.length > 0)
+        .sort((a, b) => b.length - a.length);
+    for (const prefix of filteredPrefixes) {
+        if (normalized === prefix) {
+            return '';
+        }
+        if (normalized.startsWith(`${prefix}/`)) {
+            return normalized.slice(prefix.length + 1);
+        }
+    }
+    return normalized;
+}
+function mapContainerItems(items, artifact) {
+    const basePrefixes = [artifact.rootPath, artifact.name].filter((value) => typeof value === 'string' && value.length > 0);
+    const uniquePaths = new Set();
+    const mapped = [];
+    let truncated = false;
+    for (const item of items) {
+        const relative = makeRelativePath(item.path, basePrefixes);
+        if (relative.length === 0) {
+            continue;
+        }
+        if (uniquePaths.has(relative)) {
+            continue;
+        }
+        uniquePaths.add(relative);
+        mapped.push({
+            path: relative,
+            itemType: item.itemType === FileContainerInterfaces_1.ContainerItemType.Folder ? 'folder' : 'file',
+            size: item.fileLength,
+        });
+        if (mapped.length >= MAX_ITEMS_PER_ARTIFACT) {
+            truncated = true;
+            break;
+        }
+    }
+    mapped.sort((a, b) => a.path.localeCompare(b.path));
+    return {
+        items: mapped,
+        truncated,
+    };
+}
+async function listContainerItems(connection, projectId, artifact) {
+    if (typeof artifact.containerId !== 'number') {
+        return {};
+    }
+    const fileContainerApi = typeof connection.getFileContainerApi === 'function'
+        ? await connection.getFileContainerApi()
+        : null;
+    if (!fileContainerApi || typeof fileContainerApi.getItems !== 'function') {
+        return {};
+    }
+    const scopeCandidates = [projectId, undefined].filter((scope, index, array) => array.indexOf(scope) === index);
+    const itemPathCandidates = [
+        artifact.rootPath,
+        artifact.name,
+        undefined,
+    ].filter((value, index, arr) => arr.indexOf(value) === index);
+    for (const scope of scopeCandidates) {
+        for (const itemPath of itemPathCandidates) {
+            try {
+                const items = await fileContainerApi.getItems(artifact.containerId, scope, typeof itemPath === 'string' && itemPath.length > 0
+                    ? itemPath
+                    : undefined);
+                if (!Array.isArray(items) || items.length === 0) {
+                    continue;
+                }
+                const { items: mapped, truncated } = mapContainerItems(items, artifact);
+                if (mapped.length === 0) {
+                    continue;
+                }
+                return {
+                    items: mapped,
+                    truncated,
+                };
+            }
+            catch {
+                // Swallow and try next combination.
+            }
+        }
+    }
+    return {};
+}
+async function listPipelineArtifactItems(artifact) {
+    const downloadUrl = artifact.signedContentUrl || artifact.downloadUrl || artifact.resourceUrl;
+    if (!downloadUrl) {
+        return {};
+    }
+    try {
+        const response = await axios_1.default.get(downloadUrl, {
+            responseType: 'arraybuffer',
+        });
+        const zip = await jszip_1.default.loadAsync(response.data);
+        const basePrefixes = [artifact.name, artifact.rootPath].filter((value) => typeof value === 'string' && value.length > 0);
+        const items = [];
+        const directories = new Set();
+        let hitLimit = false;
+        zip.forEach((entryPath, entry) => {
+            if (hitLimit) {
+                return;
+            }
+            const relative = makeRelativePath(entryPath, basePrefixes);
+            if (relative.length === 0) {
+                return;
+            }
+            if (entry.dir) {
+                const folderPath = relative.replace(/\/+$/, '');
+                if (folderPath.length > 0) {
+                    directories.add(folderPath);
+                }
+                return;
+            }
+            // Ensure parent folders are recorded even when the archive omits explicit entries
+            const segments = relative.split('/');
+            if (segments.length > 1) {
+                for (let i = 1; i < segments.length; i += 1) {
+                    const folder = segments.slice(0, i).join('/');
+                    directories.add(folder);
+                }
+            }
+            items.push({
+                path: relative,
+                itemType: 'file',
+            });
+            if (items.length >= MAX_ITEMS_PER_ARTIFACT) {
+                hitLimit = true;
+            }
+        });
+        const folderItems = Array.from(directories)
+            .filter((folder) => folder.length > 0)
+            .map((folder) => ({ path: folder, itemType: 'folder' }));
+        const combined = [...folderItems, ...items]
+            .filter((entry, index, array) => {
+            const duplicateIndex = array.findIndex((candidate) => candidate.path === entry.path);
+            return duplicateIndex === index;
+        })
+            .sort((a, b) => a.path.localeCompare(b.path));
+        const truncated = hitLimit || combined.length > MAX_ITEMS_PER_ARTIFACT;
+        return {
+            items: truncated ? combined.slice(0, MAX_ITEMS_PER_ARTIFACT) : combined,
+            truncated,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+async function fetchRunArtifacts(connection, projectId, runId, pipelineId) {
+    try {
+        const buildApi = await connection.getBuildApi();
+        if (!buildApi || typeof buildApi.getArtifacts !== 'function') {
+            return [];
+        }
+        const artifacts = await buildApi.getArtifacts(projectId, runId);
+        if (!artifacts || artifacts.length === 0) {
+            return [];
+        }
+        const summaries = artifacts.map(mapBuildArtifact);
+        if (typeof pipelineId === 'number') {
+            const pipelinesApi = await connection.getPipelinesApi();
+            await Promise.all(summaries.map(async (summary) => {
+                try {
+                    const artifactDetails = await pipelinesApi.getArtifact(projectId, pipelineId, runId, summary.name, PipelinesInterfaces_1.GetArtifactExpandOptions.SignedContent);
+                    const signedContentUrl = artifactDetails?.signedContent?.url;
+                    if (signedContentUrl) {
+                        summary.signedContentUrl = signedContentUrl;
+                    }
+                }
+                catch {
+                    // Ignore failures fetching signed content; best-effort enrichment.
+                }
+            }));
+        }
+        const enriched = await Promise.all(summaries.map(async (artifact) => {
+            const collectors = [];
+            const artifactType = artifact.type?.toLowerCase();
+            if (artifactType === 'container' ||
+                typeof artifact.containerId === 'number') {
+                collectors.push(listContainerItems(connection, projectId, artifact));
+            }
+            if (artifactType?.includes('pipelineartifact')) {
+                collectors.push(listPipelineArtifactItems(artifact));
+            }
+            if (collectors.length === 0) {
+                return artifact;
+            }
+            let aggregatedItems;
+            let truncated = false;
+            for (const collector of collectors) {
+                try {
+                    const result = await collector;
+                    if (!result.items || result.items.length === 0) {
+                        continue;
+                    }
+                    aggregatedItems = aggregatedItems
+                        ? [...aggregatedItems, ...result.items]
+                        : result.items;
+                    truncated = truncated || Boolean(result.truncated);
+                }
+                catch {
+                    // Continue to next collector
+                }
+            }
+            if (!aggregatedItems || aggregatedItems.length === 0) {
+                return artifact;
+            }
+            const uniqueItems = Array.from(new Map(aggregatedItems.map((item) => [item.path, item])).values()).sort((a, b) => a.path.localeCompare(b.path));
+            return {
+                ...artifact,
+                items: uniqueItems.length > MAX_ITEMS_PER_ARTIFACT
+                    ? uniqueItems.slice(0, MAX_ITEMS_PER_ARTIFACT)
+                    : uniqueItems,
+                itemsTruncated: truncated ||
+                    uniqueItems.length > MAX_ITEMS_PER_ARTIFACT ||
+                    undefined,
+            };
+        }));
+        return enriched;
+    }
+    catch {
+        return [];
+    }
+}
+function getArtifactContainerInfo(artifact) {
+    return {
+        containerId: artifact.containerId,
+        rootPath: artifact.rootPath,
+    };
+}
+function parseArtifactContainer(resource) {
+    return extractContainerInfo(resource);
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/features/pipelines/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../src/features/pipelines/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/features/pipelines/artifacts.spec.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/pipelines/artifacts.spec.unit.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const axios_1 = __importDefault(require("axios"));
+const jszip_1 = __importDefault(require("jszip"));
+const FileContainerInterfaces_1 = require("azure-devops-node-api/interfaces/FileContainerInterfaces");
+const artifacts_1 = require("./artifacts");
+jest.mock('axios');
+const mockedAxios = axios_1.default;
+describe('fetchRunArtifacts', () => {
+    const projectId = 'test-project';
+    const runId = 123;
+    const getBuildApi = jest.fn();
+    const getFileContainerApi = jest.fn();
+    const getPipelinesApi = jest.fn();
+    const connection = {
+        getBuildApi,
+        getFileContainerApi,
+        getPipelinesApi,
+    };
+    beforeEach(() => {
+        jest.resetAllMocks();
+    });
+    it('lists container artifact items with relative paths', async () => {
+        const containerArtifact = {
+            name: 'embedding-metrics',
+            source: 'source-1',
+            resource: {
+                type: 'Container',
+                data: '#/39106000/embedding-metrics',
+                downloadUrl: 'https://example.com/artifact.zip',
+                url: 'https://example.com/artifact',
+            },
+        };
+        const items = [
+            {
+                containerId: 39106000,
+                path: 'embedding-metrics',
+                itemType: FileContainerInterfaces_1.ContainerItemType.Folder,
+                status: FileContainerInterfaces_1.ContainerItemStatus.Created,
+            },
+            {
+                containerId: 39106000,
+                path: 'embedding-metrics/data',
+                itemType: FileContainerInterfaces_1.ContainerItemType.Folder,
+                status: FileContainerInterfaces_1.ContainerItemStatus.Created,
+            },
+            {
+                containerId: 39106000,
+                path: 'embedding-metrics/data/metrics.json',
+                itemType: FileContainerInterfaces_1.ContainerItemType.File,
+                status: FileContainerInterfaces_1.ContainerItemStatus.Created,
+                fileLength: 2048,
+            },
+        ];
+        getBuildApi.mockResolvedValue({
+            getArtifacts: jest.fn().mockResolvedValue([containerArtifact]),
+        });
+        getFileContainerApi.mockResolvedValue({
+            getItems: jest.fn().mockResolvedValue(items),
+        });
+        const artifacts = await (0, artifacts_1.fetchRunArtifacts)(connection, projectId, runId);
+        expect(artifacts).toHaveLength(1);
+        expect(artifacts[0].items).toEqual([
+            { path: 'data', itemType: 'folder', size: undefined },
+            { path: 'data/metrics.json', itemType: 'file', size: 2048 },
+        ]);
+        expect(artifacts[0].itemsTruncated).toBeUndefined();
+    });
+    it('lists pipeline artifact entries from zip content', async () => {
+        const pipelineArtifact = {
+            name: 'embedding-batch',
+            source: 'source-2',
+            resource: {
+                type: 'PipelineArtifact',
+                downloadUrl: 'https://example.com/pipeline-artifact.zip',
+                url: 'https://example.com/pipeline-artifact',
+            },
+        };
+        const zip = new jszip_1.default();
+        zip.file('embedding-batch/logs/summary.json', '{"ok":true}');
+        const zipBuffer = await zip.generateAsync({ type: 'uint8array' });
+        const arrayBuffer = zipBuffer.buffer.slice(zipBuffer.byteOffset, zipBuffer.byteOffset + zipBuffer.byteLength);
+        mockedAxios.get.mockResolvedValue({ data: arrayBuffer });
+        getBuildApi.mockResolvedValue({
+            getArtifacts: jest.fn().mockResolvedValue([pipelineArtifact]),
+        });
+        getFileContainerApi.mockResolvedValue({
+            getItems: jest.fn().mockResolvedValue([]),
+        });
+        const artifacts = await (0, artifacts_1.fetchRunArtifacts)(connection, projectId, runId);
+        expect(mockedAxios.get).toHaveBeenCalledWith('https://example.com/pipeline-artifact.zip', expect.objectContaining({ responseType: 'arraybuffer' }));
+        expect(artifacts).toHaveLength(1);
+        expect(artifacts[0].items).toEqual([
+            { path: 'logs', itemType: 'folder' },
+            { path: 'logs/summary.json', itemType: 'file' },
+        ]);
+        expect(artifacts[0].itemsTruncated).toBeUndefined();
+    });
+});
+//# sourceMappingURL=artifacts.spec.unit.js.map

package/dist/features/pipelines/artifacts.spec.unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.spec.unit.js","sourceRoot":"","sources":["../../../src/features/pipelines/artifacts.spec.unit.ts"],"names":[],"mappings":"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"}

package/dist/features/pipelines/download-pipeline-artifact/feature.d.ts

@@ -0,0 +1,3 @@
+import { WebApi } from 'azure-devops-node-api';
+import { DownloadPipelineArtifactOptions, PipelineArtifactContent } from '../types';
+export declare function downloadPipelineArtifact(connection: WebApi, options: DownloadPipelineArtifactOptions): Promise<PipelineArtifactContent>;

package/dist/features/pipelines/download-pipeline-artifact/feature.js

@@ -0,0 +1,222 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadPipelineArtifact = downloadPipelineArtifact;
+const axios_1 = __importDefault(require("axios"));
+const jszip_1 = __importDefault(require("jszip"));
+const PipelinesInterfaces_1 = require("azure-devops-node-api/interfaces/PipelinesInterfaces");
+const errors_1 = require("../../../shared/errors");
+const environment_1 = require("../../../utils/environment");
+const artifacts_1 = require("../artifacts");
+const helpers_1 = require("../helpers");
+function normalizeArtifactPath(artifactPath) {
+    const trimmed = artifactPath.trim();
+    if (trimmed.length === 0) {
+        throw new errors_1.AzureDevOpsResourceNotFoundError('Artifact path must include the artifact name and file path.');
+    }
+    const sanitized = trimmed.replace(/^[\\/]+/, '').replace(/[\\/]+$/, '');
+    const segments = sanitized
+        .split(/[\\/]+/)
+        .filter((segment) => segment.length > 0);
+    const artifactName = segments.shift();
+    if (!artifactName) {
+        throw new errors_1.AzureDevOpsResourceNotFoundError('Artifact path must include the artifact name and file path.');
+    }
+    if (segments.length === 0) {
+        throw new errors_1.AzureDevOpsResourceNotFoundError('Please specify a file path inside the artifact (e.g. <artifact>/<path/to/file>).');
+    }
+    return {
+        artifactName,
+        relativePath: segments.join('/'),
+    };
+}
+function joinPaths(...parts) {
+    return parts
+        .filter((part) => typeof part === 'string' && part.length > 0)
+        .map((part) => part.replace(/^[\\/]+|[\\/]+$/g, ''))
+        .filter((part) => part.length > 0)
+        .join('/');
+}
+function buildContainerPathCandidates(artifactName, rootPath, relativePath) {
+    const normalizedRelative = relativePath.replace(/^[\\/]+/, '');
+    const candidates = new Set();
+    candidates.add(normalizedRelative);
+    candidates.add(joinPaths(rootPath, normalizedRelative));
+    candidates.add(joinPaths(artifactName, normalizedRelative));
+    candidates.add(joinPaths(rootPath, artifactName, normalizedRelative));
+    candidates.add(joinPaths(artifactName, rootPath, normalizedRelative));
+    return Array.from(candidates).filter((candidate) => candidate.length > 0);
+}
+function streamToBuffer(stream) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        stream.on('data', (chunk) => {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        });
+        stream.on('error', reject);
+        stream.on('end', () => {
+            resolve(Buffer.concat(chunks));
+        });
+    });
+}
+async function getContainerItemStream(connection, containerId, projectId, candidatePaths) {
+    if (typeof connection.getFileContainerApi !== 'function') {
+        return null;
+    }
+    const fileContainerApi = await connection.getFileContainerApi();
+    if (!fileContainerApi || typeof fileContainerApi.getItem !== 'function') {
+        return null;
+    }
+    const scopeCandidates = [projectId, undefined].filter((scope, index, array) => array.indexOf(scope) === index);
+    for (const candidatePath of candidatePaths) {
+        for (const scope of scopeCandidates) {
+            try {
+                const response = await fileContainerApi.getItem(containerId, scope, candidatePath);
+                if (response.statusCode === 404) {
+                    continue;
+                }
+                if (response.result) {
+                    return { stream: response.result, path: candidatePath };
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                if (/\b403\b|forbidden|access/i.test(message)) {
+                    throw new errors_1.AzureDevOpsAuthenticationError(`Failed to access container ${containerId}: ${message}`);
+                }
+                // Ignore other errors and try the next variation; the container API
+                // returns 400 for invalid paths, which we treat as a miss.
+            }
+        }
+    }
+    return null;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function normalizeZipPath(path) {
+    return path.replace(/^[\\/]+|[\\/]+$/g, '').replace(/\\+/g, '/');
+}
+function selectZipEntry(zip, relativePath, artifactName, rootPath) {
+    const normalized = normalizeZipPath(relativePath);
+    const candidates = [normalized];
+    if (artifactName) {
+        candidates.push(`${artifactName}/${normalized}`);
+    }
+    if (rootPath) {
+        candidates.push(`${rootPath}/${normalized}`);
+        if (artifactName) {
+            candidates.push(`${artifactName}/${rootPath}/${normalized}`);
+        }
+    }
+    for (const candidate of candidates) {
+        const match = zip.file(candidate);
+        if (!match) {
+            continue;
+        }
+        const files = Array.isArray(match) ? match : [match];
+        const file = files.find((entry) => !entry.dir);
+        if (file) {
+            return file;
+        }
+    }
+    const fallbackMatches = zip
+        .file(new RegExp(`${escapeRegExp(normalized)}$`))
+        ?.filter((entry) => !entry.dir);
+    if (fallbackMatches && fallbackMatches.length > 0) {
+        fallbackMatches.sort((a, b) => a.name.length - b.name.length);
+        return fallbackMatches[0] ?? null;
+    }
+    return null;
+}
+async function downloadFromContainer(connection, projectId, artifactName, artifact, relativePath) {
+    const { containerId, rootPath } = (0, artifacts_1.parseArtifactContainer)(artifact.resource);
+    if (typeof containerId !== 'number') {
+        return null;
+    }
+    const pathCandidates = buildContainerPathCandidates(artifactName, rootPath, relativePath);
+    const resolved = await getContainerItemStream(connection, containerId, projectId, pathCandidates);
+    if (!resolved) {
+        throw new errors_1.AzureDevOpsResourceNotFoundError(`File ${relativePath} not found in artifact ${artifactName}.`);
+    }
+    const buffer = await streamToBuffer(resolved.stream);
+    return {
+        artifact: artifactName,
+        path: resolved.path,
+        content: buffer.toString('utf8'),
+    };
+}
+async function downloadFromPipelineArtifact(connection, projectId, runId, artifactName, artifact, relativePath, pipelineId) {
+    const resolvedPipelineId = await (0, helpers_1.resolvePipelineId)(connection, projectId, runId, pipelineId);
+    if (typeof resolvedPipelineId !== 'number') {
+        throw new errors_1.AzureDevOpsResourceNotFoundError(`Unable to resolve pipeline identifier for artifact ${artifactName}.`);
+    }
+    const pipelinesApi = await connection.getPipelinesApi();
+    const artifactDetails = await pipelinesApi.getArtifact(projectId, resolvedPipelineId, runId, artifactName, PipelinesInterfaces_1.GetArtifactExpandOptions.SignedContent);
+    const downloadUrl = artifactDetails?.signedContent?.url ||
+        artifact.resource?.downloadUrl ||
+        artifactDetails?.url;
+    if (!downloadUrl) {
+        throw new errors_1.AzureDevOpsResourceNotFoundError(`Artifact ${artifactName} does not expose downloadable content.`);
+    }
+    const response = await axios_1.default.get(downloadUrl, {
+        responseType: 'arraybuffer',
+    });
+    const zip = await jszip_1.default.loadAsync(response.data);
+    const file = selectZipEntry(zip, relativePath, artifactName, (0, artifacts_1.parseArtifactContainer)(artifact.resource).rootPath);
+    if (!file) {
+        throw new errors_1.AzureDevOpsResourceNotFoundError(`File ${relativePath} not found in artifact ${artifactName}.`);
+    }
+    const content = await file.async('string');
+    return {
+        artifact: artifactName,
+        path: file.name,
+        content,
+    };
+}
+async function downloadPipelineArtifact(connection, options) {
+    try {
+        const projectId = options.projectId ?? environment_1.defaultProject;
+        const runId = options.runId;
+        const { artifactName, relativePath } = normalizeArtifactPath(options.artifactPath);
+        const buildApi = await connection.getBuildApi();
+        let artifacts;
+        try {
+            artifacts = await buildApi.getArtifacts(projectId, runId);
+        }
+        catch (error) {
+            throw new errors_1.AzureDevOpsResourceNotFoundError(`Pipeline run ${runId} not found in project ${projectId}: ${String(error)}`);
+        }
+        const artifact = artifacts.find((item) => item.name === artifactName);
+        if (!artifact) {
+            throw new errors_1.AzureDevOpsResourceNotFoundError(`Artifact ${artifactName} not found for run ${runId} in project ${projectId}.`);
+        }
+        const containerResult = await downloadFromContainer(connection, projectId, artifactName, artifact, relativePath);
+        if (containerResult) {
+            return containerResult;
+        }
+        return await downloadFromPipelineArtifact(connection, projectId, runId, artifactName, artifact, relativePath, options.pipelineId);
+    }
+    catch (error) {
+        if (error instanceof errors_1.AzureDevOpsError) {
+            throw error;
+        }
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            if (message.includes('authentication') ||
+                message.includes('unauthorized') ||
+                message.includes('401')) {
+                throw new errors_1.AzureDevOpsAuthenticationError(`Failed to authenticate: ${error.message}`);
+            }
+            if (message.includes('not found') ||
+                message.includes('does not exist') ||
+                message.includes('404')) {
+                throw new errors_1.AzureDevOpsResourceNotFoundError(`Pipeline artifact or project not found: ${error.message}`);
+            }
+        }
+        throw new errors_1.AzureDevOpsError(`Failed to download pipeline artifact: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=feature.js.map