get_pull_requests_count

Instructions

Implementation Reference

• src/tools/getPullRequestsCount.ts:57-96 (handler)

  The handler function for the 'get_pull_requests_count' tool. It resolves project ID/key and repository ID/name using helper utilities, then calls backlog.getPullRequestsCount().

  export const getPullRequestsCountTool = (
    backlog: Backlog,
    { t }: TranslationHelper
  ): ToolDefinition<
    ReturnType<typeof getPullRequestsCountSchema>,
    (typeof PullRequestCountSchema)['shape']
  > => {
    return {
      name: 'get_pull_requests_count',
      description: t(
        'TOOL_GET_PULL_REQUESTS_COUNT_DESCRIPTION',
        'Returns count of pull requests for a repository'
      ),
      schema: z.object(getPullRequestsCountSchema(t)),
      outputSchema: PullRequestCountSchema,
      handler: async ({ projectId, projectKey, repoId, repoName, ...params }) => {
        const result = resolveIdOrKey(
          'project',
          { id: projectId, key: projectKey },
          t
        );
        if (!result.ok) {
          throw result.error;
        }
        const repoResult = resolveIdOrName(
          'repository',
          { id: repoId, name: repoName },
          t
        );
        if (!repoResult.ok) {
          throw repoResult.error;
        }
        return backlog.getPullRequestsCount(
          result.value,
          String(repoResult.value),
          params
        );
      },
    };
  };

• src/tools/getPullRequestsCount.ts:8-55 (schema)

  Input schema definition for the tool, defining optional fields: projectId, projectKey, repoId, repoName, statusId, assigneeId, issueId, createdUserId.

  const getPullRequestsCountSchema = buildToolSchema((t) => ({
    projectId: z
      .number()
      .optional()
      .describe(
        t(
          'TOOL_GET_PULL_REQUESTS_COUNT_PROJECT_ID',
          'The numeric ID of the project (e.g., 12345)'
        )
      ),
    projectKey: z
      .string()
      .optional()
      .describe(
        t(
          'TOOL_GET_PULL_REQUESTS_COUNT_PROJECT_KEY',
          "The key of the project (e.g., 'PROJECT')"
        )
      ),
    repoId: z
      .number()
      .optional()
      .describe(t('TOOL_GET_PULL_REQUESTS_COUNT_REPO_ID', 'Repository ID')),
    repoName: z
      .string()
      .optional()
      .describe(t('TOOL_GET_PULL_REQUESTS_COUNT_REPO_NAME', 'Repository name')),
    statusId: z
      .array(z.number())
      .optional()
      .describe(t('TOOL_GET_PULL_REQUESTS_COUNT_STATUS_ID', 'Status IDs')),
    assigneeId: z
      .array(z.number())
      .optional()
      .describe(
        t('TOOL_GET_PULL_REQUESTS_COUNT_ASSIGNEE_ID', 'Assignee user IDs')
      ),
    issueId: z
      .array(z.number())
      .optional()
      .describe(t('TOOL_GET_PULL_REQUESTS_COUNT_ISSUE_ID', 'Issue IDs')),
    createdUserId: z
      .array(z.number())
      .optional()
      .describe(
        t('TOOL_GET_PULL_REQUESTS_COUNT_CREATED_USER_ID', 'Created user IDs')
      ),
  }));

• src/types/zod/backlogOutputDefinition.ts:429-431 (schema)

  Output schema for the tool - returns an object with a single numeric 'count' field.

  export const PullRequestCountSchema = z.object({
    count: z.number(),
  });

• src/tools/tools.ts:145-145 (registration)

  Registration of the tool in the 'git' toolset group within the allTools registry.

  getPullRequestsCountTool(backlog, helper),