cyrus-gemini-runner 0.2.4

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/schemas.js

@@ -0,0 +1,678 @@
+/**
+ * Zod Schemas for Gemini CLI Stream Events
+ *
+ * These schemas provide runtime validation for Gemini CLI's stream-json output format.
+ * TypeScript types are derived from these schemas using z.infer<> for type safety.
+ *
+ * Note: The official `@google/gemini-cli-core` package (v0.17.1) exports TypeScript
+ * interfaces for these event types. However, we use custom Zod schemas because:
+ * 1. Runtime validation - official types are TypeScript-only, no runtime checks
+ * 2. Detailed tool typing - official uses `Record<string, unknown>` for tool params
+ * 3. Type guards and parsers - utility functions for narrowing event/tool types
+ * 4. Tool result typing - result schemas typed by tool_id prefix
+ *
+ * Our schemas are structurally compatible with the official types.
+ *
+ * Official type definitions (pinned to v0.17.0):
+ * @see https://github.com/google-gemini/gemini-cli/blob/v0.17.0/packages/core/src/output/types.ts
+ * @see https://www.npmjs.com/package/@google/gemini-cli-core/v/0.17.0
+ *
+ * Documentation:
+ * @see https://github.com/google-gemini/gemini-cli/blob/v0.17.0/docs/cli/headless.md
+ */
+import { z } from "zod";
+// ============================================================================
+// Base Schemas
+// ============================================================================
+/**
+ * ISO 8601 timestamp string (e.g., "2025-11-25T03:27:51.000Z")
+ */
+const TimestampSchema = z.string().datetime({ offset: true });
+// ============================================================================
+// Init Event Schema
+// ============================================================================
+/**
+ * Session initialization event
+ *
+ * Example:
+ * ```json
+ * {"type":"init","timestamp":"2025-11-25T03:27:51.000Z","session_id":"c25acda3-b51f-41f9-9bc5-954c70c17bf4","model":"auto"}
+ * ```
+ */
+export const GeminiInitEventSchema = z.object({
+    type: z.literal("init"),
+    timestamp: TimestampSchema,
+    session_id: z.string().uuid(),
+    model: z.string(),
+});
+// ============================================================================
+// Message Event Schema
+// ============================================================================
+/**
+ * User or assistant message event
+ *
+ * When delta is true, this message should be accumulated with previous delta messages
+ * of the same role. The caller (GeminiRunner) is responsible for accumulating delta messages.
+ *
+ * Examples:
+ * ```json
+ * {"type":"message","timestamp":"2025-11-25T03:27:51.001Z","role":"user","content":"What is 2 + 2?"}
+ * {"type":"message","timestamp":"2025-11-25T03:28:05.256Z","role":"assistant","content":"2 + 2 = 4.","delta":true}
+ * ```
+ */
+export const GeminiMessageEventSchema = z.object({
+    type: z.literal("message"),
+    timestamp: TimestampSchema,
+    role: z.enum(["user", "assistant"]),
+    content: z.string(),
+    delta: z.boolean().optional(),
+});
+// ============================================================================
+// Tool Parameter Schemas
+// ============================================================================
+/**
+ * Parameters for the read_file tool
+ *
+ * Example:
+ * ```json
+ * {"file_path":"package.json"}
+ * {"file_path":"app/mcts.py"}
+ * ```
+ */
+export const ReadFileParametersSchema = z.object({
+    file_path: z.string(),
+});
+/**
+ * Parameters for the write_file tool
+ *
+ * Example:
+ * ```json
+ * {"file_path":"tests/test_snake.py","content":"import unittest\n..."}
+ * ```
+ */
+export const WriteFileParametersSchema = z.object({
+    file_path: z.string(),
+    content: z.string(),
+});
+/**
+ * Parameters for the list_directory tool
+ *
+ * Example:
+ * ```json
+ * {"dir_path":"."}
+ * {"dir_path":"./src"}
+ * ```
+ */
+export const ListDirectoryParametersSchema = z.object({
+    dir_path: z.string(),
+});
+/**
+ * Parameters for the search_file_content tool
+ *
+ * Example:
+ * ```json
+ * {"pattern":"(TODO|FIXME)"}
+ * {"pattern":"function.*export"}
+ * ```
+ */
+export const SearchFileContentParametersSchema = z.object({
+    pattern: z.string(),
+});
+/**
+ * Parameters for the run_shell_command tool
+ *
+ * Example:
+ * ```json
+ * {"command":"/usr/bin/python3 -m pytest tests/"}
+ * {"command":"git status"}
+ * {"command":"flake8 --version"}
+ * ```
+ */
+export const RunShellCommandParametersSchema = z.object({
+    command: z.string(),
+});
+/**
+ * Todo item for the write_todos tool
+ */
+export const TodoItemSchema = z.object({
+    description: z.string(),
+    status: z.enum(["pending", "in_progress", "completed"]).optional(),
+});
+/**
+ * Parameters for the write_todos tool
+ *
+ * Example:
+ * ```json
+ * {"todos":[{"description":"Explore codebase to identify bugs","status":"in_progress"},{"description":"Fix coordinate system","status":"pending"}]}
+ * ```
+ */
+export const WriteTodosParametersSchema = z.object({
+    todos: z.array(TodoItemSchema),
+});
+/**
+ * Parameters for the replace tool (AI-powered code editing)
+ *
+ * Can use either instruction-based or literal string replacement:
+ * - instruction: Natural language description of the change
+ * - old_string/new_string: Literal string replacement
+ *
+ * Examples:
+ * Instruction-based:
+ * ```json
+ * {"instruction":"Modify get_other_snake_heads to return a list instead of dict","file_path":"app/mcts.py"}
+ * {"instruction":"Clean up comments in is_terminal.","file_path":"app/mcts.py"}
+ * ```
+ *
+ * Literal replacement:
+ * ```json
+ * {"file_path":"app/mcts.py","old_string":"    # Simulate other snakes' moves\\n    othe","new_string":"    # Track enemy positions\\n    enemy"}
+ * ```
+ */
+export const ReplaceParametersSchema = z.object({
+    instruction: z.string().optional(),
+    file_path: z.string().optional(),
+    old_string: z.string().optional(),
+    new_string: z.string().optional(),
+});
+/**
+ * Union of all known tool parameter schemas
+ */
+export const GeminiToolParametersSchema = z.union([
+    ReadFileParametersSchema,
+    WriteFileParametersSchema,
+    ListDirectoryParametersSchema,
+    SearchFileContentParametersSchema,
+    RunShellCommandParametersSchema,
+    WriteTodosParametersSchema,
+    ReplaceParametersSchema,
+]);
+// ============================================================================
+// Typed Tool Use Event Schemas (for specific tools)
+// ============================================================================
+/**
+ * Base schema for tool use events with timestamp and tool_id
+ */
+const ToolUseBaseSchema = z.object({
+    type: z.literal("tool_use"),
+    timestamp: TimestampSchema,
+    tool_id: z.string(),
+});
+/**
+ * Typed read_file tool use event
+ */
+export const ReadFileToolUseEventSchema = ToolUseBaseSchema.extend({
+    tool_name: z.literal("read_file"),
+    parameters: ReadFileParametersSchema,
+});
+/**
+ * Typed write_file tool use event
+ */
+export const WriteFileToolUseEventSchema = ToolUseBaseSchema.extend({
+    tool_name: z.literal("write_file"),
+    parameters: WriteFileParametersSchema,
+});
+/**
+ * Typed list_directory tool use event
+ */
+export const ListDirectoryToolUseEventSchema = ToolUseBaseSchema.extend({
+    tool_name: z.literal("list_directory"),
+    parameters: ListDirectoryParametersSchema,
+});
+/**
+ * Typed search_file_content tool use event
+ */
+export const SearchFileContentToolUseEventSchema = ToolUseBaseSchema.extend({
+    tool_name: z.literal("search_file_content"),
+    parameters: SearchFileContentParametersSchema,
+});
+/**
+ * Typed run_shell_command tool use event
+ */
+export const RunShellCommandToolUseEventSchema = ToolUseBaseSchema.extend({
+    tool_name: z.literal("run_shell_command"),
+    parameters: RunShellCommandParametersSchema,
+});
+/**
+ * Typed write_todos tool use event
+ */
+export const WriteTodosToolUseEventSchema = ToolUseBaseSchema.extend({
+    tool_name: z.literal("write_todos"),
+    parameters: WriteTodosParametersSchema,
+});
+/**
+ * Typed replace tool use event
+ */
+export const ReplaceToolUseEventSchema = ToolUseBaseSchema.extend({
+    tool_name: z.literal("replace"),
+    parameters: ReplaceParametersSchema,
+});
+/**
+ * Unknown tool use event (for tools not explicitly typed)
+ */
+export const UnknownToolUseEventSchema = ToolUseBaseSchema.extend({
+    tool_name: z.string(),
+    parameters: z.record(z.unknown()),
+});
+// ============================================================================
+// Tool Use Event Schema
+// ============================================================================
+/**
+ * Tool use event - represents a tool invocation by the model
+ *
+ * The tool_id is assigned by Gemini CLI and follows the format:
+ * `{tool_name}-{timestamp_ms}-{random_hex}`
+ *
+ * Example:
+ * ```json
+ * {"type":"tool_use","timestamp":"2025-11-25T03:27:54.691Z","tool_name":"list_directory","tool_id":"list_directory-1764041274691-eabd3cbcdee66","parameters":{"dir_path":"."}}
+ * {"type":"tool_use","timestamp":"2025-11-25T03:27:54.691Z","tool_name":"read_file","tool_id":"read_file-1764041274691-e1084c2fd73dc","parameters":{"file_path":"test.ts"}}
+ * ```
+ */
+export const GeminiToolUseEventSchema = z.object({
+    type: z.literal("tool_use"),
+    timestamp: TimestampSchema,
+    tool_name: z.string(),
+    tool_id: z.string(),
+    parameters: z.record(z.unknown()),
+});
+// ============================================================================
+// Tool Result Event Schema
+// ============================================================================
+/**
+ * Error information in tool result
+ */
+const ToolResultErrorSchema = z.object({
+    type: z.string().optional(),
+    message: z.string(),
+    code: z.string().optional(),
+});
+/**
+ * Tool result event - the result of a tool execution
+ *
+ * Uses tool_id (not tool_name) to match the corresponding tool_use event.
+ * Contains either output (success) or error (failure).
+ *
+ * Examples:
+ * Success:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-25T03:27:54.724Z","tool_id":"list_directory-1764041274691-eabd3cbcdee66","status":"success","output":"Listed 2 item(s)."}
+ * ```
+ *
+ * Error:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-25T03:28:13.200Z","tool_id":"read_file-1764041293170-fd5f6da4bd4a1","status":"error","output":"File path must be within...","error":{"type":"invalid_tool_params","message":"File path must be within..."}}
+ * ```
+ */
+export const GeminiToolResultEventSchema = z.object({
+    type: z.literal("tool_result"),
+    timestamp: TimestampSchema,
+    tool_id: z.string(),
+    status: z.enum(["success", "error"]),
+    output: z.string().optional(),
+    error: ToolResultErrorSchema.optional(),
+});
+// ============================================================================
+// Typed Tool Result Schemas
+// ============================================================================
+/**
+ * Tool result output types based on the originating tool
+ *
+ * These describe the expected output format for each tool type.
+ * The tool_id prefix indicates which tool generated the result.
+ */
+/**
+ * read_file tool result - returns empty string on success (file content is in context)
+ *
+ * Example:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-24T20:12:40.148Z","tool_id":"read_file-1764015160012-767cb93e436f3","status":"success","output":""}
+ * ```
+ */
+export const ReadFileToolResultSchema = z.object({
+    type: z.literal("tool_result"),
+    timestamp: TimestampSchema,
+    tool_id: z.string().startsWith("read_file-"),
+    status: z.enum(["success", "error"]),
+    output: z.string().optional(),
+    error: ToolResultErrorSchema.optional(),
+});
+/**
+ * write_file tool result - returns empty output on success
+ *
+ * Example:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-24T20:13:55.193Z","tool_id":"write_file-1764015234674-0581b9629931a","status":"success"}
+ * ```
+ */
+export const WriteFileToolResultSchema = z.object({
+    type: z.literal("tool_result"),
+    timestamp: TimestampSchema,
+    tool_id: z.string().startsWith("write_file-"),
+    status: z.enum(["success", "error"]),
+    output: z.string().optional(),
+    error: ToolResultErrorSchema.optional(),
+});
+/**
+ * list_directory tool result - returns summary of items found
+ *
+ * Example:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-24T20:12:53.273Z","tool_id":"list_directory-1764015173255-396a90dd79fa6","status":"success","output":"Listed 4 item(s). (1 ignored)"}
+ * ```
+ */
+export const ListDirectoryToolResultSchema = z.object({
+    type: z.literal("tool_result"),
+    timestamp: TimestampSchema,
+    tool_id: z.string().startsWith("list_directory-"),
+    status: z.enum(["success", "error"]),
+    output: z.string().optional(),
+    error: ToolResultErrorSchema.optional(),
+});
+/**
+ * search_file_content tool result - returns match info or "No matches found"
+ *
+ * Example:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-24T20:12:40.196Z","tool_id":"search_file_content-1764015160072-c1e0f530591f6","status":"success","output":"No matches found"}
+ * ```
+ */
+export const SearchFileContentToolResultSchema = z.object({
+    type: z.literal("tool_result"),
+    timestamp: TimestampSchema,
+    tool_id: z.string().startsWith("search_file_content-"),
+    status: z.enum(["success", "error"]),
+    output: z.string().optional(),
+    error: ToolResultErrorSchema.optional(),
+});
+/**
+ * run_shell_command tool result - returns command output
+ *
+ * Examples:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-24T20:13:15.060Z","tool_id":"run_shell_command-1764015194969-e79bcda1d6e9","status":"success","output":"/usr/bin/python3: No module named pytest"}
+ * {"type":"tool_result","timestamp":"2025-11-24T20:19:49.805Z","tool_id":"run_shell_command-1764015589776-b029531d6e71e","status":"success","output":"node"}
+ * ```
+ */
+export const RunShellCommandToolResultSchema = z.object({
+    type: z.literal("tool_result"),
+    timestamp: TimestampSchema,
+    tool_id: z.string().startsWith("run_shell_command-"),
+    status: z.enum(["success", "error"]),
+    output: z.string().optional(),
+    error: ToolResultErrorSchema.optional(),
+});
+/**
+ * write_todos tool result - returns empty output on success, or error if invalid
+ *
+ * Examples:
+ * Success:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-24T19:29:56.539Z","tool_id":"write_todos-1764012596037-37082c9903ce7","status":"success"}
+ * ```
+ *
+ * Error (multiple in_progress):
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-24T19:37:13.465Z","tool_id":"write_todos-1764013031965-70bbdf7c35856","status":"error","output":"Invalid parameters: Only one task can be \"in_progress\" at a time."}
+ * ```
+ */
+export const WriteTodosToolResultSchema = z.object({
+    type: z.literal("tool_result"),
+    timestamp: TimestampSchema,
+    tool_id: z.string().startsWith("write_todos-"),
+    status: z.enum(["success", "error"]),
+    output: z.string().optional(),
+    error: ToolResultErrorSchema.optional(),
+});
+/**
+ * replace tool result - returns empty output on success
+ *
+ * Example:
+ * ```json
+ * {"type":"tool_result","timestamp":"2025-11-24T19:31:12.165Z","tool_id":"replace-1764012672140-c56f46960e14a","status":"success"}
+ * ```
+ */
+export const ReplaceToolResultSchema = z.object({
+    type: z.literal("tool_result"),
+    timestamp: TimestampSchema,
+    tool_id: z.string().startsWith("replace-"),
+    status: z.enum(["success", "error"]),
+    output: z.string().optional(),
+    error: ToolResultErrorSchema.optional(),
+});
+/**
+ * Type guards for tool results based on tool_id prefix
+ */
+export function isReadFileToolResult(event) {
+    return event.tool_id.startsWith("read_file-");
+}
+export function isWriteFileToolResult(event) {
+    return event.tool_id.startsWith("write_file-");
+}
+export function isListDirectoryToolResult(event) {
+    return event.tool_id.startsWith("list_directory-");
+}
+export function isSearchFileContentToolResult(event) {
+    return event.tool_id.startsWith("search_file_content-");
+}
+export function isRunShellCommandToolResult(event) {
+    return event.tool_id.startsWith("run_shell_command-");
+}
+export function isWriteTodosToolResult(event) {
+    return event.tool_id.startsWith("write_todos-");
+}
+export function isReplaceToolResult(event) {
+    return event.tool_id.startsWith("replace-");
+}
+/**
+ * Extract tool name from tool_id
+ *
+ * Tool IDs follow the format: `{tool_name}-{timestamp_ms}-{random_hex}`
+ *
+ * @param toolId - The tool_id from a tool_use or tool_result event
+ * @returns The tool name, or null if format is invalid
+ */
+export function extractToolNameFromId(toolId) {
+    // Tool ID format: {tool_name}-{timestamp_ms}-{random_hex}
+    // Split on hyphen and rejoin all but last two parts
+    const parts = toolId.split("-");
+    if (parts.length < 3) {
+        return null;
+    }
+    // Remove the timestamp and random hex (last 2 parts)
+    return parts.slice(0, -2).join("-");
+}
+// ============================================================================
+// Error Event Schema
+// ============================================================================
+/**
+ * Non-fatal error event
+ *
+ * Example:
+ * ```json
+ * {"type":"error","timestamp":"2025-11-25T03:28:00.000Z","message":"Rate limit exceeded","code":429}
+ * ```
+ */
+export const GeminiErrorEventSchema = z.object({
+    type: z.literal("error"),
+    timestamp: TimestampSchema,
+    message: z.string(),
+    code: z.number().optional(),
+});
+// ============================================================================
+// Result Event Schema
+// ============================================================================
+/**
+ * Statistics from the Gemini session
+ */
+const ResultStatsSchema = z.object({
+    total_tokens: z.number().optional(),
+    input_tokens: z.number().optional(),
+    output_tokens: z.number().optional(),
+    duration_ms: z.number().optional(),
+    tool_calls: z.number().optional(),
+});
+/**
+ * Error information in result event
+ */
+const ResultErrorSchema = z.object({
+    type: z.string(),
+    message: z.string(),
+    code: z.number().optional(),
+});
+/**
+ * Final result event with session statistics
+ *
+ * Examples:
+ * Success:
+ * ```json
+ * {"type":"result","timestamp":"2025-11-25T03:28:05.262Z","status":"success","stats":{"total_tokens":8064,"input_tokens":7854,"output_tokens":58,"duration_ms":2534,"tool_calls":0}}
+ * ```
+ *
+ * Error:
+ * ```json
+ * {"type":"result","timestamp":"2025-11-25T03:27:54.727Z","status":"error","error":{"type":"FatalTurnLimitedError","message":"Reached max session turns..."},"stats":{"total_tokens":8255,"input_tokens":7862,"output_tokens":90,"duration_ms":0,"tool_calls":2}}
+ * ```
+ */
+export const GeminiResultEventSchema = z.object({
+    type: z.literal("result"),
+    timestamp: TimestampSchema,
+    status: z.enum(["success", "error"]),
+    stats: ResultStatsSchema.optional(),
+    error: ResultErrorSchema.optional(),
+});
+// ============================================================================
+// Union Schema for All Events
+// ============================================================================
+/**
+ * Discriminated union of all Gemini stream events
+ *
+ * Uses the 'type' field as the discriminator for type narrowing.
+ */
+export const GeminiStreamEventSchema = z.discriminatedUnion("type", [
+    GeminiInitEventSchema,
+    GeminiMessageEventSchema,
+    GeminiToolUseEventSchema,
+    GeminiToolResultEventSchema,
+    GeminiErrorEventSchema,
+    GeminiResultEventSchema,
+]);
+// ============================================================================
+// Validation Utilities
+// ============================================================================
+/**
+ * Parse and validate a Gemini stream event from a JSON string
+ *
+ * @param jsonString - Raw JSON string from Gemini CLI stdout
+ * @returns Validated and typed GeminiStreamEvent
+ * @throws ZodError if validation fails
+ */
+export function parseGeminiStreamEvent(jsonString) {
+    const parsed = JSON.parse(jsonString);
+    return GeminiStreamEventSchema.parse(parsed);
+}
+/**
+ * Safely parse a Gemini stream event, returning null on failure
+ *
+ * @param jsonString - Raw JSON string from Gemini CLI stdout
+ * @returns Validated GeminiStreamEvent or null if parsing/validation fails
+ */
+export function safeParseGeminiStreamEvent(jsonString) {
+    try {
+        const parsed = JSON.parse(jsonString);
+        const result = GeminiStreamEventSchema.safeParse(parsed);
+        return result.success ? result.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Type guard for checking if an event is a specific type
+ */
+export function isGeminiInitEvent(event) {
+    return event.type === "init";
+}
+export function isGeminiMessageEvent(event) {
+    return event.type === "message";
+}
+export function isGeminiToolUseEvent(event) {
+    return event.type === "tool_use";
+}
+export function isGeminiToolResultEvent(event) {
+    return event.type === "tool_result";
+}
+export function isGeminiErrorEvent(event) {
+    return event.type === "error";
+}
+export function isGeminiResultEvent(event) {
+    return event.type === "result";
+}
+// ============================================================================
+// Typed Tool Use Parsing Utilities
+// ============================================================================
+/**
+ * Parse a tool use event as a specific typed tool
+ *
+ * @param event - A GeminiToolUseEvent to parse
+ * @returns The typed tool use event, or null if the tool name doesn't match or validation fails
+ */
+export function parseAsReadFileTool(event) {
+    const result = ReadFileToolUseEventSchema.safeParse(event);
+    return result.success ? result.data : null;
+}
+export function parseAsWriteFileTool(event) {
+    const result = WriteFileToolUseEventSchema.safeParse(event);
+    return result.success ? result.data : null;
+}
+export function parseAsListDirectoryTool(event) {
+    const result = ListDirectoryToolUseEventSchema.safeParse(event);
+    return result.success ? result.data : null;
+}
+export function parseAsSearchFileContentTool(event) {
+    const result = SearchFileContentToolUseEventSchema.safeParse(event);
+    return result.success ? result.data : null;
+}
+export function parseAsRunShellCommandTool(event) {
+    const result = RunShellCommandToolUseEventSchema.safeParse(event);
+    return result.success ? result.data : null;
+}
+export function parseAsWriteTodosTool(event) {
+    const result = WriteTodosToolUseEventSchema.safeParse(event);
+    return result.success ? result.data : null;
+}
+export function parseAsReplaceTool(event) {
+    const result = ReplaceToolUseEventSchema.safeParse(event);
+    return result.success ? result.data : null;
+}
+/**
+ * Type guard for specific tool types based on tool_name
+ */
+export function isReadFileTool(event) {
+    return (event.tool_name === "read_file" &&
+        ReadFileParametersSchema.safeParse(event.parameters).success);
+}
+export function isWriteFileTool(event) {
+    return (event.tool_name === "write_file" &&
+        WriteFileParametersSchema.safeParse(event.parameters).success);
+}
+export function isListDirectoryTool(event) {
+    return (event.tool_name === "list_directory" &&
+        ListDirectoryParametersSchema.safeParse(event.parameters).success);
+}
+export function isSearchFileContentTool(event) {
+    return (event.tool_name === "search_file_content" &&
+        SearchFileContentParametersSchema.safeParse(event.parameters).success);
+}
+export function isRunShellCommandTool(event) {
+    return (event.tool_name === "run_shell_command" &&
+        RunShellCommandParametersSchema.safeParse(event.parameters).success);
+}
+export function isWriteTodosTool(event) {
+    return (event.tool_name === "write_todos" &&
+        WriteTodosParametersSchema.safeParse(event.parameters).success);
+}
+export function isReplaceTool(event) {
+    return (event.tool_name === "replace" &&
+        ReplaceParametersSchema.safeParse(event.parameters).success);
+}
+//# sourceMappingURL=schemas.js.map