Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 | 18x 18x 18x 18x 18x 18x 18x 18x 18x 18x 18x 18x 18x | import { z } from "zod";
import { requiredId } from "../utils";
// ============================================================================
// browse_refs - CQRS Query Tool (discriminated union schema)
// Actions: list_branches, get_branch, list_tags, get_tag,
// list_protected_branches, get_protected_branch, list_protected_tags
// Uses z.discriminatedUnion() for type-safe action handling.
// ============================================================================
// --- Shared fields ---
const projectIdField = requiredId.describe(
"Project ID or URL-encoded path (e.g., 'my-group/my-project')"
);
// Pagination fields
const perPageField = z
.number()
.int()
.min(1)
.max(100)
.optional()
.describe("Number of items per page (max 100)");
const pageField = z.number().int().min(1).optional().describe("Page number");
// --- Action: list_branches ---
const ListBranchesSchema = z.object({
action: z.literal("list_branches").describe("List all repository branches with optional search"),
project_id: projectIdField,
search: z.string().optional().describe("Filter branches by name (supports wildcards)"),
regex: z.string().optional().describe("Filter branches by regex pattern"),
per_page: perPageField,
page: pageField,
});
// --- Action: get_branch ---
const GetBranchSchema = z.object({
action: z.literal("get_branch").describe("Get details of a specific branch"),
project_id: projectIdField,
branch: z.string().describe("Branch name (URL-encoded if contains slashes)"),
});
// --- Action: list_tags ---
const ListTagsSchema = z.object({
action: z.literal("list_tags").describe("List all repository tags"),
project_id: projectIdField,
search: z.string().optional().describe("Filter tags by name (supports wildcards)"),
order_by: z
.enum(["name", "updated", "version"])
.optional()
.describe("Sort by field (default: updated)"),
sort: z.enum(["asc", "desc"]).optional().describe("Sort direction (default: desc)"),
per_page: perPageField,
page: pageField,
});
// --- Action: get_tag ---
const GetTagSchema = z.object({
action: z.literal("get_tag").describe("Get details of a specific tag"),
project_id: projectIdField,
tag_name: z.string().describe("Tag name (URL-encoded if contains special characters)"),
});
// --- Action: list_protected_branches ---
const ListProtectedBranchesSchema = z.object({
action: z
.literal("list_protected_branches")
.describe("List all protected branches with their protection rules"),
project_id: projectIdField,
search: z.string().optional().describe("Filter protected branches by name"),
per_page: perPageField,
page: pageField,
});
// --- Action: get_protected_branch ---
const GetProtectedBranchSchema = z.object({
action: z.literal("get_protected_branch").describe("Get protection rules for a specific branch"),
project_id: projectIdField,
name: z.string().describe("Branch name or wildcard pattern (e.g., 'main', 'release-*')"),
});
// --- Action: list_protected_tags ---
const ListProtectedTagsSchema = z.object({
action: z
.literal("list_protected_tags")
.describe("List all protected tags with their protection rules"),
project_id: projectIdField,
per_page: perPageField,
page: pageField,
});
// --- Discriminated union combining all actions ---
export const BrowseRefsSchema = z.discriminatedUnion("action", [
ListBranchesSchema,
GetBranchSchema,
ListTagsSchema,
GetTagSchema,
ListProtectedBranchesSchema,
GetProtectedBranchSchema,
ListProtectedTagsSchema,
]);
// ============================================================================
// Type exports
// ============================================================================
export type BrowseRefsInput = z.infer<typeof BrowseRefsSchema>;
|