{"id":"appointment-windows-build","version":"1.0.0","description":"Build deterministic appointment windows from pinned time-zone facts and caller-supplied booking rules.","supported_operations":["build appointment windows","enumerate booking slots","apply blackout periods to slots","generate local opening hour slots","create notice bounded availability","expand appointment schedule windows"],"unsupported_operations":["book an appointment with a provider","modify or cancel an existing appointment","expand cron or RRULE recurrences"],"semantics":["Intervals are half-open [start,end); sorted by start epoch then end epoch.","Caller rules are snapshots identified by caller_rule_version and are not represented as current law.","Ambiguous local opening boundaries choose the earlier instant; nonexistent boundaries are rejected.","No host clock, locale, network, randomness, Intl, or host time zone is used."],"limits":{"max_input_bytes":65536,"max_blackouts":100,"max_opening_rules":14,"max_windows":1000},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["caller_rule_version","zone_id","now","notice_seconds","horizon_seconds","range_start_local","range_end_local","duration_seconds","slot_step_seconds","opening_hours","blackouts"],"properties":{"caller_rule_version":{"type":"string","minLength":1,"maxLength":64},"zone_id":{"type":"string","minLength":1,"maxLength":64},"now":{"type":"string","minLength":20,"maxLength":30},"notice_seconds":{"type":"integer","minimum":0,"maximum":31536000},"horizon_seconds":{"type":"integer","minimum":0,"maximum":31536000},"range_start_local":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"range_end_local":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"duration_seconds":{"type":"integer","minimum":300,"maximum":28800},"slot_step_seconds":{"type":"integer","minimum":300,"maximum":28800},"opening_hours":{"type":"array","minItems":1,"maxItems":14,"items":{"type":"object","additionalProperties":false,"required":["weekday","start","end"],"properties":{"weekday":{"type":"integer","minimum":0,"maximum":6},"start":{"type":"string","pattern":"^[0-2][0-9]:[0-5][0-9]$"},"end":{"type":"string","pattern":"^[0-2][0-9]:[0-5][0-9]$"}}}},"blackouts":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","minLength":20,"maxLength":30},"end":{"type":"string","minLength":20,"maxLength":30}}}}}},"output_schema":{"type":"object","additionalProperties":false,"required":["standard_version","data_version","caller_rule_version","zone_id","windows"],"properties":{"standard_version":{"type":"string","const":"RFC3339+ISO8601-1:2019"},"data_version":{"type":"string","const":"iana-tzdb-2025b-compact"},"caller_rule_version":{"type":"string","minLength":1,"maxLength":64},"zone_id":{"type":"string"},"windows":{"type":"array","maxItems":1000,"items":{"type":"object","additionalProperties":false,"required":["start","end","start_epoch_seconds","end_epoch_seconds"],"properties":{"start":{"type":"string"},"end":{"type":"string"},"start_epoch_seconds":{"type":"integer"},"end_epoch_seconds":{"type":"integer"}}}}}},"examples":[{"input":{"caller_rule_version":"policy-v7","zone_id":"UTC","now":"2026-06-01T00:00:00Z","notice_seconds":0,"horizon_seconds":31536000,"opening_hours":[{"weekday":1,"start":"09:00","end":"12:00"}],"blackouts":[],"range_start_local":"2026-06-01","range_end_local":"2026-06-02","duration_seconds":3600,"slot_step_seconds":3600},"output":{"standard_version":"RFC3339+ISO8601-1:2019","data_version":"iana-tzdb-2025b-compact","caller_rule_version":"policy-v7","zone_id":"UTC","windows":[{"start":"2026-06-01T09:00:00Z","end":"2026-06-01T10:00:00Z","start_epoch_seconds":1780304400,"end_epoch_seconds":1780308000},{"start":"2026-06-01T10:00:00Z","end":"2026-06-01T11:00:00Z","start_epoch_seconds":1780308000,"end_epoch_seconds":1780311600},{"start":"2026-06-01T11:00:00Z","end":"2026-06-01T12:00:00Z","start_epoch_seconds":1780311600,"end_epoch_seconds":1780315200}]}},{"input":{"caller_rule_version":"policy-v7","zone_id":"Etc/UTC","now":"2026-06-01T00:00:00Z","notice_seconds":0,"horizon_seconds":31536000,"opening_hours":[{"weekday":1,"start":"09:00","end":"12:00"}],"blackouts":[],"range_start_local":"2026-06-01","range_end_local":"2026-06-02","duration_seconds":3600,"slot_step_seconds":3600},"output":{"standard_version":"RFC3339+ISO8601-1:2019","data_version":"iana-tzdb-2025b-compact","caller_rule_version":"policy-v7","zone_id":"UTC","windows":[{"start":"2026-06-01T09:00:00Z","end":"2026-06-01T10:00:00Z","start_epoch_seconds":1780304400,"end_epoch_seconds":1780308000},{"start":"2026-06-01T10:00:00Z","end":"2026-06-01T11:00:00Z","start_epoch_seconds":1780308000,"end_epoch_seconds":1780311600},{"start":"2026-06-01T11:00:00Z","end":"2026-06-01T12:00:00Z","start_epoch_seconds":1780311600,"end_epoch_seconds":1780315200}]}}],"execute_url":"/v1/tools/appointment-windows-build/versions/1.0.0/execute"}