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 | 19x 19x 19x 19x 19x 19x 19x 19x | import { z } from 'zod';
import { requiredId, paginationFields } from '../utils';
// ============================================================================
// browse_snippets - CQRS Query Tool (discriminated union schema)
// Actions: list, get
// Uses z.discriminatedUnion() for type-safe action handling.
// ============================================================================
// --- Shared enums ---
const SnippetScopeSchema = z
.enum(['personal', 'project', 'public'])
.describe('The scope of snippets');
const SnippetVisibilitySchema = z
.enum(['private', 'internal', 'public'])
.describe('Visibility level of snippets');
// --- Shared fields ---
const projectIdField = z
.string()
.optional()
.describe("Project ID or URL-encoded path (e.g., '123' or 'group/project')");
// --- Action: list ---
const ListSnippetsSchema = z.object({
action: z.literal('list').describe('List snippets with filtering by scope and visibility'),
scope: SnippetScopeSchema.describe(
'Scope of snippets: "personal" for current user, "project" for project-specific (requires projectId), "public" for all public snippets',
),
projectId: projectIdField.describe(
"Project ID or URL-encoded path. Required when scope is 'project'",
),
visibility: SnippetVisibilitySchema.optional().describe(
'Filter by visibility: private (author only), internal (authenticated users), public (everyone)',
),
created_after: z
.string()
.optional()
.describe(
"Return snippets created after this date (ISO 8601). Example: '2024-01-01T00:00:00Z'",
),
created_before: z
.string()
.optional()
.describe(
"Return snippets created before this date (ISO 8601). Example: '2024-12-31T23:59:59Z'",
),
...paginationFields(),
});
// --- Action: get ---
const GetSnippetSchema = z.object({
action: z.literal('get').describe('Get single snippet details or raw content'),
id: requiredId.describe('The ID of the snippet to retrieve'),
projectId: projectIdField.describe(
'Project ID or URL-encoded path. Required for project snippets, leave empty for personal snippets',
),
raw: z
.boolean()
.optional()
.default(false)
.describe('Return raw content of snippet files instead of metadata'),
});
// --- Discriminated union combining all actions ---
export const BrowseSnippetsSchema = z.discriminatedUnion('action', [
ListSnippetsSchema,
GetSnippetSchema,
]);
// ============================================================================
// Type exports
// ============================================================================
export type BrowseSnippetsInput = z.infer<typeof BrowseSnippetsSchema>;
|