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 | 19x 19x 19x 19x 19x 19x 19x 19x 19x | import { z } from 'zod';
import { PaginationOptionsSchema } from '../shared';
import { requiredId } from '../utils';
// ============================================================================
// Search scope enum - GitLab API search scopes
// ============================================================================
export const SearchScopeSchema = z
.enum([
'projects',
'issues',
'merge_requests',
'milestones',
'snippet_titles',
'users',
'groups',
'blobs',
'commits',
'wiki_blobs',
'notes',
])
.describe('Search scope determining what type of resources to search');
// ============================================================================
// Base search parameters shared across all scopes
// ============================================================================
const BaseSearchParams = z.object({
search: z.string().min(1).describe('Search query string (minimum 1 character)'),
state: z
.enum(['opened', 'closed', 'merged', 'all'])
.optional()
.describe('Filter by state (for issues and merge_requests scopes)'),
confidential: z
.boolean()
.optional()
.describe('Filter by confidentiality (for issues scope, Premium only)'),
order_by: z.enum(['created_at', 'updated_at']).optional().describe('Sort results by field'),
sort: z.enum(['asc', 'desc']).optional().describe('Sort direction'),
});
// ============================================================================
// browse_search - CQRS Query Tool (discriminated union schema)
// Actions: global, project, group
// Uses z.discriminatedUnion() for type-safe action handling.
// ============================================================================
// --- Action: global ---
const GlobalSearchSchema = z
.object({
action: z.literal('global').describe('Search across entire GitLab instance'),
scope: SearchScopeSchema,
})
.merge(BaseSearchParams)
.merge(PaginationOptionsSchema);
// --- Action: project ---
const ProjectSearchSchema = z
.object({
action: z.literal('project').describe('Search within a specific project'),
project_id: requiredId.describe(
"Project ID or URL-encoded path (e.g., 'group/project' or '123')",
),
scope: SearchScopeSchema,
ref: z.string().optional().describe('Branch/tag reference for code search (blobs, commits)'),
})
.merge(BaseSearchParams)
.merge(PaginationOptionsSchema);
// --- Action: group ---
const GroupSearchSchema = z
.object({
action: z.literal('group').describe('Search within a specific group and its subgroups'),
group_id: requiredId.describe("Group ID or URL-encoded path (e.g., 'my-group' or '123')"),
scope: SearchScopeSchema,
})
.merge(BaseSearchParams)
.merge(PaginationOptionsSchema);
// --- Discriminated union combining all actions ---
export const BrowseSearchSchema = z.discriminatedUnion('action', [
GlobalSearchSchema,
ProjectSearchSchema,
GroupSearchSchema,
]);
// ============================================================================
// Type exports
// ============================================================================
export type SearchScope = z.infer<typeof SearchScopeSchema>;
export type BrowseSearchInput = z.infer<typeof BrowseSearchSchema>;
export type GlobalSearchInput = z.infer<typeof GlobalSearchSchema>;
export type ProjectSearchInput = z.infer<typeof ProjectSearchSchema>;
export type GroupSearchInput = z.infer<typeof GroupSearchSchema>;
|