@carven-time/mcp 0.1.1

package/dist/tools.d.ts

@@ -0,0 +1,352 @@
+export declare const toolDefs: readonly [{
+    readonly name: "list_templates";
+    readonly description: "List all event templates for the authenticated user. Templates define event types with a title and duration, and are required when creating booking links.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+        readonly required: string[];
+    };
+}, {
+    readonly name: "create_template";
+    readonly description: "Create a new event template. Templates define a type of meeting/event with a title and duration in minutes. You need a template ID to create booking links.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly title: {
+                readonly type: "string";
+                readonly description: "Template title (e.g., \"Date Night\", \"1:1 Meeting\")";
+            };
+            readonly duration_mins: {
+                readonly type: "number";
+                readonly description: "Duration in minutes (1-480)";
+            };
+        };
+        readonly required: readonly ["title", "duration_mins"];
+    };
+}, {
+    readonly name: "update_template";
+    readonly description: "Update an existing event template's title or duration.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly template_id: {
+                readonly type: "string";
+                readonly description: "Template ID (UUID)";
+            };
+            readonly title: {
+                readonly type: "string";
+                readonly description: "New title";
+            };
+            readonly duration_mins: {
+                readonly type: "number";
+                readonly description: "New duration in minutes (1-480)";
+            };
+        };
+        readonly required: readonly ["template_id"];
+    };
+}, {
+    readonly name: "delete_template";
+    readonly description: "Delete an event template by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly template_id: {
+                readonly type: "string";
+                readonly description: "Template ID (UUID)";
+            };
+        };
+        readonly required: readonly ["template_id"];
+    };
+}, {
+    readonly name: "check_availability";
+    readonly description: "Check available time slots for scheduling. Returns open slots respecting working hours, calendar busy times, buffer periods, and minimum notice. Use this before creating booking links.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly start_date: {
+                readonly type: "string";
+                readonly description: "Start date (YYYY-MM-DD)";
+            };
+            readonly end_date: {
+                readonly type: "string";
+                readonly description: "End date (YYYY-MM-DD). Defaults to start_date. Max 14-day range.";
+            };
+            readonly template_id: {
+                readonly type: "string";
+                readonly description: "Event template ID — uses its duration if provided.";
+            };
+            readonly duration_mins: {
+                readonly type: "number";
+                readonly description: "Slot duration in minutes (default 30). Ignored if template_id is set.";
+            };
+        };
+        readonly required: readonly ["start_date"];
+    };
+}, {
+    readonly name: "create_booking_link";
+    readonly description: "Create one or more magic links for specific time slots. Each link is a unique URL that a person can visit to confirm the booking. The booking creates a Google Calendar event for both parties.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly template_id: {
+                readonly type: "string";
+                readonly description: "Event template ID (UUID)";
+            };
+            readonly timeslots: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly start_time: {
+                            readonly type: "string";
+                            readonly description: "ISO 8601 datetime";
+                        };
+                        readonly end_time: {
+                            readonly type: "string";
+                            readonly description: "ISO 8601 datetime";
+                        };
+                    };
+                    readonly required: readonly ["start_time", "end_time"];
+                };
+                readonly description: "Time slots to create links for (1-50)";
+            };
+            readonly recipient_name: {
+                readonly type: "string";
+                readonly description: "Name of the person being invited";
+            };
+            readonly recipient_email: {
+                readonly type: "string";
+                readonly description: "Email of the person being invited";
+            };
+            readonly message: {
+                readonly type: "string";
+                readonly description: "Optional message to include";
+            };
+        };
+        readonly required: readonly ["template_id", "timeslots"];
+    };
+}, {
+    readonly name: "get_booking_status";
+    readonly description: "Check the status of a booking by ID. Returns CONFIRMED or CANCELLED with details including guest email, time, and Google Calendar event ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly booking_id: {
+                readonly type: "string";
+                readonly description: "Booking ID (UUID)";
+            };
+        };
+        readonly required: readonly ["booking_id"];
+    };
+}, {
+    readonly name: "get_signup_sheet";
+    readonly description: "Get a published sign-up sheet with all slots and remaining capacity. Use this to see what slots are available before claiming one.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sheet_id: {
+                readonly type: "string";
+                readonly description: "Sign-up sheet ID (UUID)";
+            };
+        };
+        readonly required: readonly ["sheet_id"];
+    };
+}, {
+    readonly name: "claim_signup_slot";
+    readonly description: "Claim a slot on a published sign-up sheet on behalf of a person. Enforces capacity limits and prevents duplicate claims by email.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sheet_id: {
+                readonly type: "string";
+                readonly description: "Sign-up sheet ID (UUID)";
+            };
+            readonly slot_id: {
+                readonly type: "string";
+                readonly description: "Slot ID (UUID)";
+            };
+            readonly claimant_name: {
+                readonly type: "string";
+                readonly description: "Full name of the person claiming the slot";
+            };
+            readonly claimant_email: {
+                readonly type: "string";
+                readonly description: "Email of the person claiming the slot";
+            };
+            readonly claimant_phone: {
+                readonly type: "string";
+                readonly description: "Phone number (optional)";
+            };
+            readonly custom_field_responses: {
+                readonly type: "object";
+                readonly additionalProperties: {
+                    readonly type: "string";
+                };
+                readonly description: "Responses to custom fields, keyed by field ID";
+            };
+        };
+        readonly required: readonly ["sheet_id", "slot_id", "claimant_name", "claimant_email"];
+    };
+}, {
+    readonly name: "get_round";
+    readonly description: "Get details of a group coordination round, including the availability heat map showing how many people are available in each time block. Use this to find the best meeting time for a group.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly round_id: {
+                readonly type: "string";
+                readonly description: "Round ID (UUID)";
+            };
+        };
+        readonly required: readonly ["round_id"];
+    };
+}, {
+    readonly name: "submit_availability";
+    readonly description: "Submit availability for a group coordination round. Each time block can be marked as PREFERRED, AVAILABLE, or UNAVAILABLE. Merges with any existing response.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly round_id: {
+                readonly type: "string";
+                readonly description: "Round ID (UUID)";
+            };
+            readonly availability: {
+                readonly type: "object";
+                readonly additionalProperties: {
+                    readonly type: "string";
+                    readonly enum: readonly ["PREFERRED", "AVAILABLE", "UNAVAILABLE"];
+                };
+                readonly description: "Map of ISO datetime keys to availability state for each 30-min block";
+            };
+            readonly guest_name: {
+                readonly type: "string";
+                readonly description: "For guest submissions — name of the participant";
+            };
+            readonly guest_email: {
+                readonly type: "string";
+                readonly description: "For guest submissions — email of the participant";
+            };
+            readonly is_flexible: {
+                readonly type: "boolean";
+                readonly description: "If true, indicates the person is flexible on all times";
+            };
+        };
+        readonly required: readonly ["round_id", "availability"];
+    };
+}, {
+    readonly name: "get_working_hours";
+    readonly description: "Get the user's configured working hours. Returns the recurring weekly schedule that defines when the user is available for bookings (e.g., Monday 09:00–17:00).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+        readonly required: string[];
+    };
+}, {
+    readonly name: "set_working_hours";
+    readonly description: "Set the user's weekly working hours. Each entry specifies a day of week (0=Sunday, 6=Saturday) and a start/end time in HH:MM format. Upserts entries — existing days are updated, new days are created.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly hours: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly day_of_week: {
+                            readonly type: "number";
+                            readonly description: "0=Sunday, 1=Monday, ..., 6=Saturday";
+                        };
+                        readonly start_time: {
+                            readonly type: "string";
+                            readonly description: "HH:MM format (e.g., \"09:00\")";
+                        };
+                        readonly end_time: {
+                            readonly type: "string";
+                            readonly description: "HH:MM format (e.g., \"17:00\")";
+                        };
+                    };
+                    readonly required: readonly ["day_of_week", "start_time", "end_time"];
+                };
+                readonly description: "Array of working hour entries (max 7, one per day)";
+            };
+        };
+        readonly required: readonly ["hours"];
+    };
+}, {
+    readonly name: "delete_working_hours_day";
+    readonly description: "Remove working hours for a specific day of the week. This makes the user unavailable on that day.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly day_of_week: {
+                readonly type: "number";
+                readonly description: "0=Sunday, 1=Monday, ..., 6=Saturday";
+            };
+        };
+        readonly required: readonly ["day_of_week"];
+    };
+}, {
+    readonly name: "get_date_overrides";
+    readonly description: "Get all date-specific overrides. Overrides take precedence over weekly working hours — they can block a date entirely or set custom hours for a specific date.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+        readonly required: string[];
+    };
+}, {
+    readonly name: "set_date_overrides";
+    readonly description: "Create or update date-specific availability overrides. Use is_blocked=true to mark a date as unavailable, or is_blocked=false with start_time/end_time for custom hours on that date.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly overrides: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly date: {
+                            readonly type: "string";
+                            readonly description: "Date in YYYY-MM-DD format";
+                        };
+                        readonly is_blocked: {
+                            readonly type: "boolean";
+                            readonly description: "true = entire day blocked, false = custom hours";
+                        };
+                        readonly start_time: {
+                            readonly type: "string";
+                            readonly description: "HH:MM (required when is_blocked=false)";
+                        };
+                        readonly end_time: {
+                            readonly type: "string";
+                            readonly description: "HH:MM (required when is_blocked=false)";
+                        };
+                    };
+                    readonly required: readonly ["date", "is_blocked"];
+                };
+                readonly description: "Array of date overrides (max 90)";
+            };
+        };
+        readonly required: readonly ["overrides"];
+    };
+}, {
+    readonly name: "delete_date_override";
+    readonly description: "Remove a date-specific override, reverting that date back to the regular weekly working hours.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly date: {
+                readonly type: "string";
+                readonly description: "Date in YYYY-MM-DD format";
+            };
+        };
+        readonly required: readonly ["date"];
+    };
+}];
+type ToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function handleTool(name: string, args: Record<string, unknown>): Promise<ToolResult>;
+export {};