@mcp-consultant-tools/azure-devops 25.0.0 → 27.0.0-beta.1

package/build/AzureDevOpsService.d.ts

@@ -6,243 +6,151 @@ export interface AzureDevOpsConfig {
     enableWorkItemWrite?: boolean;
     enableWorkItemDelete?: boolean;
     enableWikiWrite?: boolean;
-    showDevOpsAdminReadonly?: boolean;
-    enablePipelineUpsert?: boolean;
-    enableServiceConnUpsert?: boolean;
-    enableVariableGroupUpsert?: boolean;
-    enableAgentPoolUpsert?: boolean;
-    enableEnvironmentUpsert?: boolean;
-    enablePipelineDelete?: boolean;
-    enableServiceConnDelete?: boolean;
-    enableVariableGroupDelete?: boolean;
-    enableAgentPoolDisable?: boolean;
-    enableEnvironmentDelete?: boolean;
+    /**
+     * Comment format for work item comments.
+     * - 'markdown' (default): Send comments as Markdown (for orgs with Markdown preview enabled)
+     * - 'html': Convert Markdown to HTML before sending (for legacy orgs without Markdown preview)
+     */
+    commentFormat?: 'markdown' | 'html';
+    enablePullRequestWrite?: boolean;
 }
-export interface PipelineDefinition {
-    id: number;
+export interface AdoApiCollectionResponse<T> {
+    value: T[];
+    count?: number;
+    [key: string]: any;
+}
+export interface Repository {
+    id: string;
     name: string;
-    path?: string;
-    revision?: number;
-    queueStatus?: string;
-    type?: string;
-    quality?: string;
-    authoredBy?: {
-        displayName: string;
-        id: string;
-    };
-    createdDate?: string;
-    project?: {
+    url: string;
+    project: {
         id: string;
         name: string;
     };
-    repository?: {
-        id: string;
-        name: string;
-        type: string;
-    };
-    process?: {
-        yamlFilename?: string;
-        type?: number;
-    };
-    triggers?: any[];
-    variables?: Record<string, {
-        value: string;
-        isSecret?: boolean;
-    }>;
-    _links?: Record<string, {
-        href: string;
-    }>;
+    defaultBranch?: string;
+    size?: number;
+    remoteUrl?: string;
+    sshUrl?: string;
+    webUrl?: string;
 }
-export interface Build {
-    id: number;
-    buildNumber: string;
-    status: string;
-    result?: string;
-    queueTime?: string;
-    startTime?: string;
-    finishTime?: string;
-    sourceBranch?: string;
-    sourceVersion?: string;
-    definition?: {
-        id: number;
-        name: string;
-    };
-    requestedBy?: {
+export interface PullRequest {
+    pullRequestId: number;
+    title: string;
+    description?: string;
+    status: 'active' | 'completed' | 'abandoned' | 'all';
+    createdBy: {
         displayName: string;
+        id: string;
+        uniqueName: string;
     };
-    requestedFor?: {
+    creationDate: string;
+    closedDate?: string;
+    sourceRefName: string;
+    targetRefName: string;
+    mergeStatus?: string;
+    isDraft?: boolean;
+    reviewers?: PullRequestReviewer[];
+    labels?: {
+        id: string;
+        name: string;
+    }[];
+    autoCompleteSetBy?: {
         displayName: string;
+        id: string;
     };
-    project?: {
+    completionOptions?: any;
+    repository: {
         id: string;
         name: string;
     };
-    priority?: string;
-    reason?: string;
-    parameters?: string;
+    supportsIterations?: boolean;
     _links?: Record<string, {
         href: string;
     }>;
 }
-export interface BuildTimeline {
-    id: string;
-    changeId: number;
-    lastChangedBy?: string;
-    lastChangedOn?: string;
-    records: TimelineRecord[];
-}
-export interface TimelineRecord {
-    id: string;
-    parentId?: string;
-    type: string;
-    name: string;
-    startTime?: string;
-    finishTime?: string;
-    state: string;
-    result?: string;
-    order?: number;
-    log?: {
-        id: number;
-        type: string;
-        url: string;
-    };
-    errorCount?: number;
-    warningCount?: number;
-    issues?: any[];
-}
-export interface ServiceConnection {
+export interface PullRequestReviewer {
     id: string;
-    name: string;
-    type: string;
-    url?: string;
-    description?: string;
-    authorization?: {
-        scheme: string;
-        parameters?: Record<string, string>;
-    };
-    isShared?: boolean;
-    isReady?: boolean;
-    owner?: string;
-    createdBy?: {
-        displayName: string;
-        id: string;
-    };
-    serviceEndpointProjectReferences?: Array<{
-        projectReference: {
-            id: string;
-            name: string;
-        };
-        name: string;
-    }>;
-}
-export interface ServiceConnectionType {
-    name: string;
     displayName: string;
-    description?: string;
-    helpMarkDown?: string;
-    authenticationSchemes?: Array<{
-        scheme: string;
-        displayName: string;
-    }>;
-    dataSources?: any[];
-    inputDescriptors?: any[];
+    uniqueName: string;
+    vote: number;
+    isRequired?: boolean;
+    hasDeclined?: boolean;
+    isFlagged?: boolean;
 }
-export interface AgentPool {
+export interface PullRequestThread {
     id: number;
-    name: string;
-    size?: number;
-    isHosted?: boolean;
-    poolType?: string;
-    createdBy?: {
-        displayName: string;
-        id: string;
-    };
-    createdOn?: string;
-    autoProvision?: boolean;
-    autoUpdate?: boolean;
-    autoSize?: boolean;
-    targetSize?: number;
-    agentCloudId?: number;
-    owner?: {
-        displayName: string;
-        id: string;
+    publishedDate: string;
+    lastUpdatedDate: string;
+    status: 'unknown' | 'active' | 'fixed' | 'wontFix' | 'closed' | 'byDesign' | 'pending';
+    threadContext?: {
+        filePath?: string;
+        leftFileStart?: {
+            line: number;
+            offset: number;
+        };
+        leftFileEnd?: {
+            line: number;
+            offset: number;
+        };
+        rightFileStart?: {
+            line: number;
+            offset: number;
+        };
+        rightFileEnd?: {
+            line: number;
+            offset: number;
+        };
     };
-    options?: string;
+    comments: PullRequestComment[];
     properties?: Record<string, any>;
+    isDeleted?: boolean;
 }
-export interface Agent {
+export interface PullRequestComment {
     id: number;
-    name: string;
-    version?: string;
-    osDescription?: string;
-    enabled?: boolean;
-    status?: string;
-    provisioningState?: string;
-    accessPoint?: string;
-    createdOn?: string;
-    maxParallelism?: number;
-    systemCapabilities?: Record<string, string>;
-    userCapabilities?: Record<string, string>;
-    assignedRequest?: any;
-    lastCompletedRequest?: any;
-}
-export interface Environment {
-    id: number;
-    name: string;
-    description?: string;
-    createdBy?: {
-        displayName: string;
-        id: string;
-    };
-    createdOn?: string;
-    lastModifiedBy?: {
+    parentCommentId?: number;
+    author: {
         displayName: string;
         id: string;
     };
-    lastModifiedOn?: string;
-    project?: {
-        id: string;
-        name: string;
-    };
-    resources?: any[];
+    content: string;
+    publishedDate: string;
+    lastUpdatedDate?: string;
+    lastContentUpdatedDate?: string;
+    commentType: 'unknown' | 'text' | 'codeChange' | 'system';
+    usersLiked?: any[];
 }
-export interface DeploymentRecord {
+export interface PullRequestIteration {
     id: number;
-    environmentId: number;
-    definition?: {
-        id: number;
-        name: string;
-    };
-    owner?: {
+    description?: string;
+    author: {
         displayName: string;
         id: string;
     };
-    planType?: string;
-    startTime?: string;
-    finishTime?: string;
-    result?: string;
-    queueTime?: string;
-    requestIdentifier?: string;
-}
-export interface Check {
-    id: number;
-    type: {
-        id: string;
-        name: string;
+    createdDate: string;
+    updatedDate?: string;
+    sourceRefCommit: {
+        commitId: string;
     };
-    settings?: any;
-    resource?: {
-        type: string;
-        id: string;
-        name?: string;
+    targetRefCommit: {
+        commitId: string;
+    };
+    commonRefCommit?: {
+        commitId: string;
     };
-    timeout?: number;
-    retryInterval?: number;
+    hasMoreCommits?: boolean;
+    reason?: string;
 }
-export interface AdoApiCollectionResponse<T> {
-    value: T[];
-    count?: number;
-    [key: string]: any;
+export interface PullRequestChange {
+    changeId: number;
+    changeType: string;
+    item: {
+        objectId: string;
+        originalObjectId?: string;
+        gitObjectType: string;
+        commitId?: string;
+        path: string;
+        url?: string;
+    };
 }
 export declare class AzureDevOpsService {
     private config;
@@ -431,369 +339,70 @@ export declare class AzureDevOpsService {
      */
     getVariableGroup(project: string, groupId: number): Promise<any>;
     /**
-     * List all pipeline definitions in a project
-     * @param project The project name
-     * @returns List of pipeline definitions
-     */
-    listPipelineDefinitions(project: string): Promise<any>;
-    /**
-     * Get a specific pipeline definition with full details
-     * @param project The project name
-     * @param definitionId The pipeline definition ID
-     * @returns Full pipeline definition
-     */
-    getPipelineDefinition(project: string, definitionId: number): Promise<any>;
-    /**
-     * Get the YAML content for a pipeline definition
-     * @param project The project name
-     * @param definitionId The pipeline definition ID
-     * @returns YAML content or location info for external repos
-     */
-    getPipelineYaml(project: string, definitionId: number): Promise<any>;
-    /**
-     * List recent pipeline runs for a definition
-     * @param project The project name
-     * @param definitionId The pipeline definition ID
-     * @param top Maximum number of results (default: 10)
-     * @returns List of builds/runs
-     */
-    listPipelineRuns(project: string, definitionId: number, top?: number): Promise<any>;
-    /**
-     * Get build status and details
-     * @param project The project name
-     * @param buildId The build ID
-     * @param detail Level of detail: "summary" | "timeline" | "full"
-     * @param timelineScope Timeline scope: 'stages' | 'jobs' | 'all' | 'problems' (default: 'problems')
-     * @param maxIssues Maximum issues per timeline record (default: 5)
-     * @returns Build details
-     */
-    getBuildStatus(project: string, buildId: number, detail?: string, timelineScope?: 'stages' | 'jobs' | 'all' | 'problems', maxIssues?: number): Promise<any>;
-    /**
-     * Get build timeline (step-by-step breakdown)
-     * @param project The project name
-     * @param buildId The build ID
-     * @param scope Filter scope: 'stages' | 'jobs' | 'all' | 'problems' (default: 'problems')
-     * @param maxIssues Maximum issues per record (default: 5, prioritizes errors over warnings)
-     * @returns Build timeline with records and summary stats
-     */
-    getBuildTimeline(project: string, buildId: number, scope?: 'stages' | 'jobs' | 'all' | 'problems', maxIssues?: number): Promise<any>;
-    /**
-     * Get build logs
-     * @param project The project name
-     * @param buildId The build ID
-     * @param logId Optional specific log ID
-     * @returns Build logs
-     */
-    getBuildLogs(project: string, buildId: number, logId?: number): Promise<any>;
-    /**
-     * Create a new pipeline definition
-     * @param project The project name
-     * @param name Pipeline name
-     * @param repositoryId Repository ID
-     * @param yamlPath Path to YAML file in repository
-     * @param folder Optional folder path
-     * @returns Created pipeline definition
-     */
-    createPipelineDefinition(project: string, name: string, repositoryId: string, yamlPath: string, folder?: string): Promise<any>;
-    /**
-     * Update a pipeline definition
-     * @param project The project name
-     * @param definitionId The pipeline definition ID
-     * @param updates Object with updated properties
-     * @returns Updated pipeline definition
-     */
-    updatePipelineDefinition(project: string, definitionId: number, updates: {
-        name?: string;
-        path?: string;
-        queueStatus?: string;
-        triggers?: any[];
-        variables?: Record<string, {
-            value: string;
-            isSecret?: boolean;
-            allowOverride?: boolean;
-        }>;
-    }): Promise<any>;
-    /**
-     * Rename a pipeline definition
-     * @param project The project name
-     * @param definitionId The pipeline definition ID
-     * @param newName The new name
-     * @returns Updated pipeline definition
-     */
-    renamePipelineDefinition(project: string, definitionId: number, newName: string): Promise<any>;
-    /**
-     * Queue a new build
-     * @param project The project name
-     * @param definitionId The pipeline definition ID
-     * @param branch Optional source branch
-     * @param variables Optional variables to pass
-     * @param parameters Optional pipeline parameters
-     * @returns Queued build
-     */
-    queueBuild(project: string, definitionId: number, branch?: string, variables?: Record<string, string>, parameters?: Record<string, any>): Promise<any>;
-    /**
-     * Cancel a running build
-     * @param project The project name
-     * @param buildId The build ID
-     * @returns Cancelled build
-     */
-    cancelBuild(project: string, buildId: number): Promise<any>;
-    /**
-     * Retry a failed build
+     * List all Git repositories in a project
      * @param project The project name
-     * @param buildId The build ID to retry
-     * @returns New build
+     * @returns List of repositories with their IDs
      */
-    retryBuild(project: string, buildId: number): Promise<any>;
+    listRepositories(project: string): Promise<any>;
     /**
-     * Delete a pipeline definition
+     * List pull requests in a repository
      * @param project The project name
-     * @param definitionId The pipeline definition ID
-     * @returns Deletion confirmation
+     * @param repositoryId Repository ID (GUID) or name
+     * @param status Filter by status: active, completed, abandoned, all (default: active)
+     * @param top Maximum results (default: 25)
+     * @param creatorId Filter by creator ID
+     * @param reviewerId Filter by reviewer ID
+     * @returns List of pull requests
      */
-    deletePipelineDefinition(project: string, definitionId: number): Promise<any>;
+    listPullRequests(project: string, repositoryId: string, status?: 'active' | 'completed' | 'abandoned' | 'all', top?: number, creatorId?: string, reviewerId?: string): Promise<any>;
     /**
-     * List all service connections in a project
+     * Get details of a specific pull request
      * @param project The project name
-     * @returns List of service connections
+     * @param repositoryId Repository ID (GUID) or name
+     * @param pullRequestId The PR ID
+     * @returns Pull request details with reviewers
      */
-    listServiceConnections(project: string): Promise<any>;
+    getPullRequest(project: string, repositoryId: string, pullRequestId: number): Promise<any>;
     /**
-     * Get a specific service connection
-     * @param project The project name
-     * @param connectionId The service connection ID
-     * @returns Service connection details
+     * Convert numeric vote to label
      */
-    getServiceConnection(project: string, connectionId: string): Promise<any>;
+    private getVoteLabel;
     /**
-     * Get available service connection types
-     * @returns List of service connection types
-     */
-    getServiceConnectionTypes(): Promise<any>;
-    /**
-     * Create a new service connection
+     * Get commits in a pull request
      * @param project The project name
-     * @param name Connection name
-     * @param type Connection type
-     * @param configuration Type-specific configuration
-     * @returns Created service connection
+     * @param repositoryId Repository ID (GUID) or name
+     * @param pullRequestId The PR ID
+     * @returns List of commits
      */
-    createServiceConnection(project: string, name: string, type: string, configuration: {
-        url?: string;
-        description?: string;
-        authorization?: {
-            scheme: string;
-            parameters?: Record<string, string>;
-        };
-        data?: Record<string, string>;
-    }): Promise<any>;
+    getPullRequestCommits(project: string, repositoryId: string, pullRequestId: number): Promise<any>;
     /**
-     * Update a service connection
+     * Get threads/comments on a pull request
      * @param project The project name
-     * @param connectionId The service connection ID
-     * @param updates Updated properties (not credentials)
-     * @returns Updated service connection
+     * @param repositoryId Repository ID (GUID) or name
+     * @param pullRequestId The PR ID
+     * @returns List of discussion threads
      */
-    updateServiceConnection(project: string, connectionId: string, updates: {
-        name?: string;
-        description?: string;
-        url?: string;
-        data?: Record<string, string>;
-    }): Promise<any>;
-    /**
-     * Share a service connection across projects
-     * @param connectionId The service connection ID
-     * @param projectIds Array of project IDs to share with
-     * @returns Updated service connection
-     */
-    shareServiceConnection(connectionId: string, projectIds: string[]): Promise<any>;
+    getPullRequestThreads(project: string, repositoryId: string, pullRequestId: number): Promise<any>;
     /**
-     * Delete a service connection
+     * Get file changes in a pull request
      * @param project The project name
-     * @param connectionId The service connection ID
-     * @returns Deletion confirmation
+     * @param repositoryId Repository ID (GUID) or name
+     * @param pullRequestId The PR ID
+     * @param iterationId Iteration ID (default: latest)
+     * @returns List of changed files
      */
-    deleteServiceConnection(project: string, connectionId: string): Promise<any>;
+    getPullRequestChanges(project: string, repositoryId: string, pullRequestId: number, iterationId?: number): Promise<any>;
     /**
-     * Create a new variable group
+     * Add a comment thread to a pull request
      * @param project The project name
-     * @param name Variable group name
-     * @param description Optional description
-     * @param variables Initial variables
-     * @returns Created variable group
-     */
-    createVariableGroup(project: string, name: string, description?: string, variables?: Record<string, {
-        value: string;
-        isSecret?: boolean;
-    }>): Promise<any>;
-    /**
-     * Update a variable group's metadata
-     * @param project The project name
-     * @param groupId The variable group ID
-     * @param updates Updated properties
-     * @returns Updated variable group
-     */
-    updateVariableGroupMetadata(project: string, groupId: number, updates: {
-        name?: string;
-        description?: string;
-    }): Promise<any>;
-    /**
-     * Set or update a variable in a variable group
-     * @param project The project name
-     * @param groupId The variable group ID
-     * @param variableName Variable name
-     * @param value Variable value
-     * @param isSecret Whether the variable is secret
-     * @returns Updated variable group
-     */
-    setVariable(project: string, groupId: number, variableName: string, value: string, isSecret?: boolean): Promise<any>;
-    /**
-     * Remove a variable from a variable group
-     * @param project The project name
-     * @param groupId The variable group ID
-     * @param variableName Variable name to remove
-     * @returns Updated variable group
-     */
-    removeVariable(project: string, groupId: number, variableName: string): Promise<any>;
-    /**
-     * Delete a variable group
-     * @param project The project name
-     * @param groupId The variable group ID
-     * @returns Deletion confirmation
-     */
-    deleteVariableGroup(project: string, groupId: number): Promise<any>;
-    /**
-     * List all agent pools
-     * @param poolType Optional filter: "automation" or "deployment"
-     * @returns List of agent pools
-     */
-    listAgentPools(poolType?: string): Promise<any>;
-    /**
-     * Get a specific agent pool
-     * @param poolId The pool ID
-     * @returns Agent pool details
-     */
-    getAgentPool(poolId: number): Promise<any>;
-    /**
-     * List agents in a pool
-     * @param poolId The pool ID
-     * @param includeCapabilities Include agent capabilities
-     * @returns List of agents
-     */
-    listAgents(poolId: number, includeCapabilities?: boolean): Promise<any>;
-    /**
-     * Get a specific agent
-     * @param poolId The pool ID
-     * @param agentId The agent ID
-     * @returns Agent details
-     */
-    getAgent(poolId: number, agentId: number): Promise<any>;
-    /**
-     * Update an agent pool
-     * @param poolId The pool ID
-     * @param updates Updated settings
-     * @returns Updated agent pool
-     */
-    updateAgentPool(poolId: number, updates: {
-        autoProvision?: boolean;
-        autoUpdate?: boolean;
-        autoSize?: boolean;
-        targetSize?: number;
-    }): Promise<any>;
-    /**
-     * Enable a disabled agent
-     * @param poolId The pool ID
-     * @param agentId The agent ID
-     * @returns Updated agent
-     */
-    enableAgent(poolId: number, agentId: number): Promise<any>;
-    /**
-     * Disable an agent
-     * @param poolId The pool ID
-     * @param agentId The agent ID
-     * @returns Updated agent
-     */
-    disableAgent(poolId: number, agentId: number): Promise<any>;
-    /**
-     * List all environments in a project
-     * @param project The project name
-     * @returns List of environments
-     */
-    listEnvironments(project: string): Promise<any>;
-    /**
-     * Get a specific environment
-     * @param project The project name
-     * @param environmentId The environment ID
-     * @returns Environment details
-     */
-    getEnvironment(project: string, environmentId: number): Promise<any>;
-    /**
-     * Get deployment history for an environment
-     * @param project The project name
-     * @param environmentId The environment ID
-     * @param top Maximum number of results
-     * @returns Deployment records
-     */
-    getEnvironmentDeployments(project: string, environmentId: number, top?: number): Promise<any>;
-    /**
-     * Create a new environment
-     * @param project The project name
-     * @param name Environment name
-     * @param description Optional description
-     * @returns Created environment
-     */
-    createEnvironment(project: string, name: string, description?: string): Promise<any>;
-    /**
-     * Update an environment
-     * @param project The project name
-     * @param environmentId The environment ID
-     * @param updates Updated properties
-     * @returns Updated environment
-     */
-    updateEnvironment(project: string, environmentId: number, updates: {
-        name?: string;
-        description?: string;
-    }): Promise<any>;
-    /**
-     * Delete an environment
-     * @param project The project name
-     * @param environmentId The environment ID
-     * @returns Deletion confirmation
-     */
-    deleteEnvironment(project: string, environmentId: number): Promise<any>;
-    /**
-     * Get all checks configured for an environment
-     * @param project The project name
-     * @param environmentId The environment ID
-     * @returns List of check configurations
-     */
-    getEnvironmentChecks(project: string, environmentId: number): Promise<any>;
-    /**
-     * Add a check to an environment
-     * @param project The project name
-     * @param environmentId The environment ID
-     * @param checkType The type of check (e.g., "Approval", "ExclusiveLock")
-     * @param configuration Check configuration
-     * @returns Created check
-     */
-    addEnvironmentCheck(project: string, environmentId: number, checkType: string, configuration: any): Promise<any>;
-    /**
-     * Update an existing environment check
-     * @param project The project name
-     * @param checkId The check configuration ID
-     * @param updates Updated settings and/or timeout
-     * @returns Updated check
-     */
-    updateEnvironmentCheck(project: string, checkId: number, updates: {
-        settings?: any;
-        timeout?: number;
-    }): Promise<any>;
-    /**
-     * Remove a check from an environment
-     * @param project The project name
-     * @param checkId The check configuration ID
-     * @returns Deletion confirmation
+     * @param repositoryId Repository ID (GUID) or name
+     * @param pullRequestId The PR ID
+     * @param content Comment content (markdown supported)
+     * @param filePath Optional file path for inline comment
+     * @param lineNumber Optional line number (right side) for inline comment
+     * @param status Thread status: active, fixed, wontFix, closed, byDesign, pending (default: active)
+     * @returns Created thread
      */
-    removeEnvironmentCheck(project: string, checkId: number): Promise<any>;
+    addPullRequestThread(project: string, repositoryId: string, pullRequestId: number, content: string, filePath?: string, lineNumber?: number, status?: 'active' | 'fixed' | 'wontFix' | 'closed' | 'byDesign' | 'pending'): Promise<any>;
 }
 //# sourceMappingURL=AzureDevOpsService.d.ts.map