@agent-native/scheduling 0.2.1 → 0.2.2-nightly-20260927023146

package/src/manifest.ts

@@ -1,13 +1,3 @@
-/**
- * Machine-readable manifest of what this package ships.
- *
- * Consumed by `agent-native add scheduling` (or the template scaffolder) to:
- *   - generate stub action files in the consumer's `actions/` folder
- *   - symlink/copy skill files into the consumer's `.agents/skills/`
- *   - append required secret declarations
- *   - print the list in `agent-native info @agent-native/scheduling`
- */
-
 export interface SchedulingManifest {
   manifestVersion: 1;
   name: string;
@@ -23,7 +13,6 @@ export const MANIFEST: SchedulingManifest = {
   manifestVersion: 1,
   name: "@agent-native/scheduling",
   actions: [
-    // Event types
     "list-event-types",
     "get-event-type",
     "create-event-type",
@@ -35,7 +24,6 @@ export const MANIFEST: SchedulingManifest = {
     "set-event-type-location",
     "add-private-link",
     "revoke-private-link",
-    // Availability / schedules
     "list-schedules",
     "create-schedule",
     "update-schedule",
@@ -46,7 +34,6 @@ export const MANIFEST: SchedulingManifest = {
     "get-availability",
     "check-availability",
     "find-available-slot",
-    // Bookings
     "list-bookings",
     "get-booking",
     "create-booking",
@@ -59,7 +46,6 @@ export const MANIFEST: SchedulingManifest = {
     "send-reschedule-link",
     "add-booking-note",
     "export-bookings-csv",
-    // Integrations
     "list-calendar-integrations",
     "connect-calendar",
     "connect-video",
@@ -69,29 +55,24 @@ export const MANIFEST: SchedulingManifest = {
     "set-destination-calendar",
     "refresh-busy-times",
     "install-conferencing-app",
-    // Team
     "create-team",
     "invite-team-member",
     "accept-team-invite",
     "remove-team-member",
     "update-member-role",
     "set-team-branding",
-    // Round-robin / hosts
     "assign-round-robin-host",
     "set-event-type-hosts",
     "set-host-availability-override",
     "create-host-group",
-    // Settings / profile
     "update-profile",
     "set-appearance",
     "set-default-conferencing-app",
-    // Workflows
     "list-workflows",
     "create-workflow",
     "update-workflow",
     "delete-workflow",
     "toggle-workflow",
-    // Routing forms
     "list-routing-forms",
     "create-routing-form",
     "update-routing-form",

package/src/react/components/SlotPicker.tsx

@@ -1,14 +1,6 @@
 import { TZDate } from "@date-fns/tz";
 import { format } from "date-fns";
 
-/**
- * SlotPicker — minimal, unstyled primitive that renders a vertical list of
- * available slots grouped by date. Consumers style the buttons via their
- * own Tailwind class layer.
- *
- * This is the "headless" spec: consumers can wrap it with their app's design
- * system for a fully styled picker.
- */
 import type { Slot } from "../../shared/index.js";
 import { useSchedulingT } from "../i18n.js";
 

package/src/react/components/TimezoneSelect.tsx

@@ -4,8 +4,6 @@ export interface TimezoneSelectProps {
   className?: string;
 }
 
-// A compact list; consumers can replace with the full 600+ IANA zones from
-// `Intl.supportedValuesOf("timeZone")` at the call site if they need all of them.
 const COMMON_ZONES = [
   "UTC",
   "America/New_York",

package/src/react/components/_shadcn-shims.d.ts

@@ -1,38 +1,3 @@
-/**
- * Type shims for the consumer's shadcn/ui components.
- *
- * The scheduling package's React components import shadcn primitives via
- * the standard `@/components/ui/*` alias. That alias is resolved at
- * *build time* by the consumer's bundler (Vite / React Router) using the
- * template's `tsconfig.json` `paths` setting.
- *
- * The package itself doesn't have access to that alias during `tsc`
- * compilation, so we declare broad shapes here to make the compiler happy
- * without coupling the package to a specific shadcn version. Runtime
- * behaviour is driven entirely by the consumer's actual shadcn modules.
- *
- * Expected consumer primitives (add to your `app/components/ui/` folder
- * before importing any `@agent-native/scheduling/react/components` files):
- *
- *   - button    (Button)
- *   - input     (Input)
- *   - label     (Label)
- *   - textarea  (Textarea)
- *   - switch    (Switch)
- *   - badge     (Badge)
- *   - card      (Card, CardContent, CardDescription, CardHeader, CardTitle)
- *   - dialog    (Dialog, DialogContent, DialogHeader, DialogTitle,
- *                DialogDescription, DialogFooter, DialogTrigger)
- *   - select    (Select, SelectContent, SelectItem, SelectTrigger, SelectValue)
- *   - separator (Separator)
- *   - tabs      (Tabs, TabsList, TabsTrigger, TabsContent)
- *   - tooltip   (Tooltip, TooltipContent, TooltipTrigger)
- *   - dropdown-menu (DropdownMenu, DropdownMenuContent, DropdownMenuItem,
- *                    DropdownMenuSeparator, DropdownMenuTrigger)
- *   - alert-dialog (AlertDialog, AlertDialogAction, AlertDialogCancel,
- *                   AlertDialogContent, AlertDialogDescription, AlertDialogFooter,
- *                   AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger)
- */
 declare module "@/components/ui/button" {
   import type { ComponentType, ButtonHTMLAttributes, ReactNode } from "react";
   export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {

package/src/react/components/booking-links/AvailabilityEditor.tsx

@@ -1,15 +1,4 @@
 import { type LocaleCode } from "@agent-native/core/client/i18n";
-/**
- * AvailabilityEditor — weekly schedule grid with per-day toggles and time
- * pickers. Matches the calendar template's visual baseline.
- *
- * This is the "schedule body" — for the full per-day intervals +
- * date-override grid, compose this with a `DateOverridesEditor`
- * (not included yet; scheduling's existing per-page implementation
- * remains canonical for v0.1).
- *
- * Shadcn primitives expected in the consumer: input, switch.
- */
 import { Input, Switch } from "@agent-native/toolkit/ui";
 
 import { schedulingMessage, useSchedulingT } from "../../i18n.js";
@@ -131,10 +120,6 @@ export function AvailabilityEditor({
   );
 }
 
-/**
- * Summarize a `WeeklySchedule` in a short phrase, e.g. "Weekdays, 9 am - 5 pm".
- * Useful for list-row subtitles.
- */
 export function summarizeAvailability(
   ws: WeeklySchedule,
   locale: LocaleCode = "en-US",

package/src/react/components/booking-links/BookingLinkCreateDialog.tsx

@@ -10,17 +10,6 @@ import {
   Label,
   Textarea,
 } from "@agent-native/toolkit/ui";
-/**
- * BookingLinkCreateDialog — dialog prompting for Title / URL / Duration
- * when creating a new booking link (a.k.a. event type).
- *
- * The consumer owns the mutation — this component just collects the four
- * inputs and calls `onSubmit` once the user clicks Continue. It stays
- * dumb: no data fetching, no optimistic UI.
- *
- * Shadcn primitives expected in the consumer: dialog, button, input,
- * label, textarea.
- */
 import { useEffect, useState } from "react";
 
 import { useSchedulingT } from "../../i18n.js";
@@ -35,15 +24,9 @@ export interface BookingLinkCreateDraft {
 export interface BookingLinkCreateDialogProps {
   open: boolean;
   onOpenChange: (open: boolean) => void;
-  /**
-   * URL prefix shown before the slug input, e.g.
-   * "calendar.app/meet/alice/" or "cal.local/steve@foo.com/"
-   */
   slugPrefix: string;
-  /** Default duration in minutes. Defaults to 30. */
   defaultLength?: number;
   onSubmit: (draft: BookingLinkCreateDraft) => void | Promise<void>;
-  /** Button label — defaults to "Continue". */
   submitLabel?: string;
 }
 
@@ -75,7 +58,6 @@ export function BookingLinkCreateDialog(props: BookingLinkCreateDialogProps) {
   const [submitting, setSubmitting] = useState(false);
   const [slugEdited, setSlugEdited] = useState(false);
 
-  // Reset form when the dialog reopens
   useEffect(() => {
     if (open) {
       setForm({
@@ -136,10 +118,6 @@ export function BookingLinkCreateDialog(props: BookingLinkCreateDialogProps) {
                 className="rounded-l-none border-0 focus-visible:ring-0 focus-visible:ring-offset-0"
                 value={form.slug}
                 onChange={(e) => {
-                  // Capture before setForm — React nulls e.currentTarget once
-                  // the event finishes synchronous propagation, so reading it
-                  // inside the updater closure throws "Cannot read properties
-                  // of null (reading 'value')".
                   const next = e.currentTarget.value;
                   setSlugEdited(true);
                   setForm((prev) => ({

package/src/react/components/booking-links/ConferencingSelector.tsx

@@ -16,30 +16,6 @@ import {
   IconVideo,
   IconVideoOff,
 } from "@tabler/icons-react";
-/**
- * ConferencingSelector — choose how a booking's video meeting is set up.
- *
- * Renders a grid of options (no conferencing, Google Meet, Zoom, custom
- * link). Each option is fully styled with the consumer's shadcn
- * primitives. The Zoom option does NOT accept a pasted personal meeting
- * URL — the user connects their Zoom account via OAuth instead, and the
- * app auto-creates a meeting per booking. See `connect-video` action.
- *
- * Shadcn primitives expected in the consumer: button, input, label,
- * badge. Icons from `@tabler/icons-react`.
- *
- * Props:
- *   - `value`        — current conferencing config { type, url? }
- *   - `onChange`     — called with the next config (call instantly — the
- *                      caller owns persistence, typically optimistic)
- *   - `zoomStatus`   — 'connected' | 'disconnected' | 'not-configured'
- *                      drives the Connect Zoom button / installed chip
- *   - `onConnectZoom` — optional callback that starts the OAuth flow; if
- *                      omitted, the button is hidden (useful for preview)
- *   - `googleConnected` — whether Google Meet is available (depends on
- *                         Google Calendar credential)
- *   - `onConnectGoogle` — optional, same shape as onConnectZoom
- */
 import { useId, type ComponentType } from "react";
 
 import { useSchedulingT } from "../../i18n.js";
@@ -48,7 +24,6 @@ export type ConferencingType = "none" | "google_meet" | "zoom" | "custom";
 
 export interface ConferencingValue {
   type: ConferencingType;
-  /** Used for `custom` — the meeting URL. Ignored for `zoom` (OAuth-created). */
   url?: string;
 }
 
@@ -61,7 +36,6 @@ export interface ConferencingSelectorProps {
   googleStatus?: ProviderStatus;
   onConnectZoom?: () => void;
   onConnectGoogle?: () => void;
-  /** Hide the label above the grid (for use inside a card with its own title). */
   hideLabel?: boolean;
 }
 

package/src/react/components/booking-links/CustomFieldsEditor.tsx

@@ -9,20 +9,6 @@ import {
   IconTrash,
 } from "@tabler/icons-react";
 import { nanoid } from "nanoid";
-/**
- * CustomFieldsEditor — add, remove, reorder, and configure custom form
- * fields shown on a booking page.
- *
- * The shape matches the calendar template's `CustomField`. The scheduling
- * template's event types also have `customFields` — both can use this
- * directly.
- *
- * All edits flow through `onChange` synchronously so the caller can
- * update the UI (and persist) optimistically.
- *
- * Shadcn primitives expected in the consumer: button, input, label,
- * textarea, switch. Icons from `@tabler/icons-react`.
- */
 import { useState } from "react";
 
 import { useSchedulingT } from "../../i18n.js";
@@ -50,7 +36,6 @@ export interface CustomField {
 export interface CustomFieldsEditorProps {
   fields: CustomField[];
   onChange: (fields: CustomField[]) => void;
-  /** Hide the outer label + add button (e.g. if rendered inside its own card). */
   hideLabel?: boolean;
 }
 

package/src/react/components/booking-links/DurationPicker.tsx

@@ -1,14 +1,5 @@
 import { Button, Input } from "@agent-native/toolkit/ui";
 import { IconPlus, IconX } from "@tabler/icons-react";
-/**
- * DurationPicker — multi-select of booking durations rendered as pills.
- *
- * Bookers will pick between the selected durations on the public booking
- * page (if more than one is selected). Shows 15/30/45/60 as default
- * presets; the user can type an arbitrary number and add it too.
- *
- * Shadcn primitives expected in the consumer: button, input, label.
- */
 import { useState } from "react";
 
 import { useSchedulingT } from "../../i18n.js";
@@ -19,7 +10,6 @@ export interface DurationPickerProps {
   value: number[];
   onChange: (next: number[]) => void;
   presets?: number[];
-  /** Minimum valid duration, defaults to 5 (minutes). */
   min?: number;
 }
 
@@ -36,7 +26,7 @@ export function DurationPicker(props: DurationPickerProps) {
     const next = value.includes(mins)
       ? value.filter((d) => d !== mins)
       : [...value, mins].sort((a, b) => a - b);
-    if (next.length === 0) return; // keep at least one
+    if (next.length === 0) return;
     onChange(next);
   };
 
@@ -52,7 +42,6 @@ export function DurationPicker(props: DurationPickerProps) {
     onChange(next);
   };
 
-  // Union of presets + selected values → pill row.
   const pillOptions = Array.from(new Set([...presets, ...value])).sort(
     (a, b) => a - b,
   );

package/src/react/components/booking-links/SlugEditor.tsx

@@ -1,30 +1,16 @@
 import { Label } from "@agent-native/toolkit/ui";
-/**
- * SlugEditor — inline-editable URL preview for a booking link.
- *
- * Renders the public booking URL as a single interactive line. Clicking
- * the username segment (if editable) or the slug segment swaps it for an
- * input; pressing Enter / blurring commits. All changes are fired through
- * the `onUsernameChange` / `onSlugChange` callbacks synchronously — the
- * caller owns persistence and should update UI optimistically.
- *
- * Shadcn primitives expected in the consumer: label.
- */
 import { useState } from "react";
 
 import { useSchedulingT } from "../../i18n.js";
 
 export interface SlugEditorProps {
   host: string;
-  /** Path prefix before the username, e.g. "/meet" (calendar) or "" (scheduling). */
   pathPrefix?: string;
   username: string;
   slug: string;
   onUsernameChange?: (next: string) => void;
   onSlugChange: (next: string) => void;
-  /** Hide the top label (e.g. inside a compact inline row). */
   hideLabel?: boolean;
-  /** Label text. Defaults to "URL". */
   label?: string;
 }
 

package/src/react/components/booking-links/index.ts

@@ -1,12 +1,3 @@
-/**
- * Shared booking-link / event-type UI components. Consumers:
- *   - calendar template → app/pages/BookingLinksPage
- *   - custom scheduling surfaces → event-type detail pages
- *
- * Every component here renders with the consumer's shadcn primitives
- * imported via `@/components/ui/*`. See the top of each file for the
- * list of primitives required.
- */
 export * from "./AvailabilityEditor.js";
 export * from "./BookingLinkCreateDialog.js";
 export * from "./ConferencingSelector.js";

package/src/react/components/index.ts

@@ -1,13 +1,3 @@
-/**
- * Styled components for the scheduling package.
- *
- * These components import shadcn primitives from the consumer via the
- * `@/components/ui/*` alias — the package doesn't bundle shadcn. See each
- * component file for the list of primitives it expects.
- *
- * NOTE: In v0.1 the main `<Booker>` lives in app surfaces first. Once its API
- * stabilizes we hoist it here (v0.2).
- */
 export * from "./SlotPicker.js";
 export * from "./TimezoneSelect.js";
 export * from "./booking-links/index.js";

package/src/react/hooks/useBookingFlow.ts

@@ -1,13 +1,3 @@
-/**
- * useBookingFlow — the Booker state machine.
- *
- * Stages: "pick-date" → "pick-slot" → "fill-form" → "success"
- * (plus "error" for any step's failure).
- *
- * Persistence: stores the current selection in a tuple that can be mirrored
- * to URL query params and `application_state.booker-state` so both the agent
- * and a page refresh see the same state.
- */
 import { useState, useCallback } from "react";
 
 import type { Slot } from "../../shared/index.js";

package/src/react/hooks/useEventType.ts

@@ -1,7 +1,3 @@
-/**
- * useEventType — fetch one event type by id or slug via a consumer-provided
- * callback (typically calling the `get-event-type` action).
- */
 import { useEffect, useState } from "react";
 
 import type { EventType } from "../../shared/index.js";

package/src/react/hooks/useReschedule.ts

@@ -1,7 +1,3 @@
-/**
- * useReschedule — fetch an existing booking + drive the Booker through a
- * reschedule flow that replaces its start/end time.
- */
 import { useEffect, useState } from "react";
 
 import type { Booking } from "../../shared/index.js";

package/src/react/hooks/useSlots.ts

@@ -1,11 +1,3 @@
-/**
- * useSlots — fetches available time slots for an event type over a date
- * range. Plays well with @tanstack/react-query when it's available, falls
- * back to a plain fetch + state when not.
- *
- * The hook is transport-agnostic: consumers pass a `fetchSlots` callback
- * that calls their own API (typically an action like `check-availability`).
- */
 import { useEffect, useState, useCallback } from "react";
 
 import type { Slot } from "../../shared/index.js";
@@ -18,7 +10,6 @@ export interface UseSlotsOpts {
   from: string;
   to: string;
   timezone?: string;
-  /** Consumer-provided fetch function — typically calls `check-availability` */
   fetchSlots: (params: {
     eventTypeId?: string;
     slug?: string;
@@ -28,7 +19,6 @@ export interface UseSlotsOpts {
     to: string;
     timezone?: string;
   }) => Promise<{ slots: Slot[] }>;
-  /** If false, don't fetch (e.g. waiting on a dependency) */
   enabled?: boolean;
 }
 

package/src/react/hooks/useTimezone.ts

@@ -1,7 +1,3 @@
-/**
- * Timezone hook — resolves the viewer's IANA timezone with `localStorage`
- * persistence and a setter. Booker uses this to display slot times.
- */
 import { useCallback, useEffect, useState } from "react";
 
 const KEY = "scheduling.timezone";

package/src/react/index.ts

@@ -1,8 +1,3 @@
-/**
- * Headless hooks for scheduling UIs. The stable API surface of the React
- * entry point — components live at `@agent-native/scheduling/react/components`
- * and are less stable until v1.0.
- */
 export * from "./hooks/useTimezone.js";
 export * from "./hooks/useSlots.js";
 export * from "./hooks/useBookingFlow.js";

package/src/schema/bookings.ts

@@ -1,11 +1,3 @@
-/**
- * Bookings — the materialized appointments created when someone books an
- * event type.
- *
- * Each Booking may have multiple attendees (seated events), multiple
- * references (one per external system: Google Calendar event id, Zoom
- * meeting id, etc.), and a recurring parent (for recurring series).
- */
 import {
   table,
   text,
@@ -17,19 +9,15 @@ import { boolean } from "drizzle-orm/pg-core";
 
 export const bookings = table("bookings", {
   id: text("id").primaryKey(),
-  /** Public booking uid used in URLs like /booking/:uid and /reschedule/:uid */
   uid: text("uid").notNull().unique(),
   eventTypeId: text("event_type_id").notNull(),
-  /** Organizer email (assigned host for round-robin) */
   hostEmail: text("host_email").notNull(),
 
   title: text("title").notNull(),
   description: text("description"),
 
-  /** ISO 8601 UTC */
   startTime: text("start_time").notNull(),
   endTime: text("end_time").notNull(),
-  /** Timezone in which the organizer/attendees originally picked the slot */
   timezone: text("timezone").notNull().default("UTC"),
 
   status: text("status", {
@@ -38,32 +26,24 @@ export const bookings = table("bookings", {
     .notNull()
     .default("confirmed"),
 
-  /** JSON Location — see shared types */
   location: text("location"),
 
-  /** JSON object of custom field responses */
   customResponses: text("custom_responses"),
 
-  /** Reschedule/cancel tokens for public magic links */
   cancelToken: text("cancel_token"),
   rescheduleToken: text("reschedule_token"),
 
-  /** uid of the booking this one replaced (reschedule chain) */
   fromReschedule: text("from_reschedule"),
   cancellationReason: text("cancellation_reason"),
   reschedulingReason: text("rescheduling_reason"),
 
-  /** Calendar invite iCal UID (stable across reschedules for RFC 5545 compliance) */
   iCalUid: text("ical_uid").notNull(),
   iCalSequence: integer("ical_sequence").notNull().default(0),
 
-  /** Recurring series parent id; null for non-recurring */
   recurringEventId: text("recurring_event_id"),
 
-  /** Payment state (Tier 2) */
   paid: boolean("paid").notNull().default(false),
 
-  /** Whether the host marked themselves a no-show */
   noShowHost: boolean("no_show_host").notNull().default(false),
 
   metadata: text("metadata"),
@@ -73,7 +53,6 @@ export const bookings = table("bookings", {
   ...ownableColumns(),
 });
 
-/** Attendees attached to a booking (N for seated events, 1 for personal). */
 export const bookingAttendees = table("booking_attendees", {
   id: text("id").primaryKey(),
   bookingId: text("booking_id").notNull(),
@@ -85,14 +64,9 @@ export const bookingAttendees = table("booking_attendees", {
   createdAt: text("created_at").notNull(),
 });
 
-/**
- * External system references — Google Calendar event ids, Zoom meeting ids,
- * ICS UIDs, etc. One booking → many references.
- */
 export const bookingReferences = table("booking_references", {
   id: text("id").primaryKey(),
   bookingId: text("booking_id").notNull(),
-  /** Provider kind: "google_calendar", "office365_calendar", "zoom_video", … */
   type: text("type").notNull(),
   externalId: text("external_id").notNull(),
   meetingUrl: text("meeting_url"),
@@ -101,17 +75,14 @@ export const bookingReferences = table("booking_references", {
   createdAt: text("created_at").notNull(),
 });
 
-/** Seat reservations — one per attendee on a seated event. */
 export const bookingSeats = table("booking_seats", {
   id: text("id").primaryKey(),
   bookingId: text("booking_id").notNull(),
   attendeeId: text("attendee_id").notNull(),
-  /** Opaque reference string used for attendee self-manage links */
   referenceUid: text("reference_uid").notNull().unique(),
   createdAt: text("created_at").notNull(),
 });
 
-/** Internal notes on a booking (host-only). */
 export const bookingNotes = table("booking_notes", {
   id: text("id").primaryKey(),
   bookingId: text("booking_id").notNull(),

package/src/schema/calendar-cache.ts

@@ -1,22 +1,11 @@
-/**
- * Calendar cache — short-TTL cache of busy intervals fetched from external
- * calendars. Keyed by (credentialId, selected-calendars-hash, time-window).
- *
- * Booking the same slot twice at 3:00pm is the worst UX in a scheduling
- * product, so this cache has a short TTL (default 5 min) and is explicitly
- * busted on every booking create/update/cancel.
- */
 import { table, text } from "@agent-native/core/db/schema";
 
 export const calendarCache = table("calendar_cache", {
   id: text("id").primaryKey(),
   credentialId: text("credential_id").notNull(),
-  /** Hash of (credentialId + sorted selected calendar ids + time range) */
   cacheKey: text("cache_key").notNull().unique(),
-  /** ISO 8601 start of the queried window */
   windowStart: text("window_start").notNull(),
   windowEnd: text("window_end").notNull(),
-  /** JSON array of {start, end} busy intervals */
   busyJson: text("busy_json").notNull(),
   expiresAt: text("expires_at").notNull(),
   createdAt: text("created_at").notNull(),