gravity-schema 0.5.2__tar.gz → 0.5.4__tar.gz

{gravity_schema-0.5.2 → gravity_schema-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: gravity-schema
-Version: 0.5.2
+Version: 0.5.4
 Summary: Gravity agent manifest contract — models, validation, and JSON Schema export
 License-Expression: Apache-2.0
 License-File: LICENSE

{gravity_schema-0.5.2 → gravity_schema-0.5.4}/gravity_schema/catalog_imported.yaml

@@ -13156,3 +13156,481 @@
   breadth: generic
   guarantee: experimental
   side_effect: read
+- name: whatsapp.configure_conversational_automation
+  slug: WHATSAPP_CONFIGURE_CONVERSATIONAL_AUTOMATION
+  toolkit: whatsapp
+  description: Configure conversational automation settings for a WhatsApp Business phone number. Sets up away messages, greeting messages, custom commands, and ice breaker prompts to automate customer interactions....
+  scopes:
+  - whatsapp_business_messaging
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_flow
+  slug: WHATSAPP_CREATE_FLOW
+  toolkit: whatsapp
+  description: Create a new WhatsApp Flow for the WhatsApp Business Account. Use this action when you want to create an interactive flow that can collect user data, guide users through a process, or provide structur...
+  scopes:
+  - whatsapp_business_messaging
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_max_price_agreements
+  slug: WHATSAPP_CREATE_MAX_PRICE_AGREEMENTS
+  toolkit: whatsapp
+  description: Create a max price agreement for WhatsApp marketing messages pricing. Max price agreements set a ceiling on the per-conversation price you'll pay for WhatsApp messaging across your WhatsApp Business A...
+  scopes:
+  - business_management
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_message_template
+  slug: WHATSAPP_CREATE_MESSAGE_TEMPLATE
+  toolkit: whatsapp
+  description: Create a new message template for the WhatsApp Business Account. Templates must be approved by WhatsApp before they can be used. Templates are required for marketing messages and messages sent outside...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_qr_code
+  slug: WHATSAPP_CREATE_QR_CODE
+  toolkit: whatsapp
+  description: Create a new QR code with a prefilled message for a WhatsApp Business phone number. Use this action when you need to generate a shareable QR code that customers can scan to start a conversation with y...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_upload_session
+  slug: WHATSAPP_CREATE_UPLOAD_SESSION
+  toolkit: whatsapp
+  description: Create a resumable upload session for large file uploads to WhatsApp. This action initiates an upload session that allows you to upload large files in chunks. First create a session, then use the sess...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.get_activities
+  slug: WHATSAPP_GET_ACTIVITIES
+  toolkit: whatsapp
+  description: Retrieve activity history for a WhatsApp Business Account. This action returns a paginated list of activities such as phone number verifications, user additions, and other administrative actions perfo...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_business_account_details
+  slug: WHATSAPP_GET_BUSINESS_ACCOUNT_DETAILS
+  toolkit: whatsapp
+  description: Retrieve comprehensive details about a WhatsApp Business Account (WABA). Returns configuration, status, and settings information including account review status, business verification status, timezone...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_business_compliance_info
+  slug: WHATSAPP_GET_BUSINESS_COMPLIANCE_INFO
+  toolkit: whatsapp
+  description: Retrieve comprehensive business compliance information for a WhatsApp Business phone number. Returns regulatory and compliance details including entity registration status, grievance officer contact i...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_business_encryption
+  slug: WHATSAPP_GET_BUSINESS_ENCRYPTION
+  toolkit: whatsapp
+  description: Retrieve the WhatsApp Business public key and its signature verification status. Use this action when you need to obtain the end-to-end encryption public key for a WhatsApp Business phone number. This...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_business_profile
+  slug: WHATSAPP_GET_BUSINESS_PROFILE
+  toolkit: whatsapp
+  description: Get the business profile information for a WhatsApp Business phone number. This includes business details like description, address, website, and contact info.
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_client_business_accounts
+  slug: WHATSAPP_GET_CLIENT_BUSINESS_ACCOUNTS
+  toolkit: whatsapp
+  description: Retrieve WhatsApp Business Accounts shared with or managed by a business portfolio. Use this action when you need to get WhatsApp Business Accounts (WABAs) that are client accounts shared with or mana...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_commerce_settings
+  slug: WHATSAPP_GET_COMMERCE_SETTINGS
+  toolkit: whatsapp
+  description: Get commerce settings for a WhatsApp Business phone number. Retrieves cart and catalog visibility settings for a specific WhatsApp Business phone number. Use this action to check whether shopping cart...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_flow_assets
+  slug: WHATSAPP_GET_FLOW_ASSETS
+  toolkit: whatsapp
+  description: List assets associated with a WhatsApp Flow. Use this action when you need to retrieve the assets (such as flow.json) that are associated with a WhatsApp Flow. The response includes download URLs for...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_join_requests
+  slug: WHATSAPP_GET_JOIN_REQUESTS
+  toolkit: whatsapp
+  description: Get all pending join requests for a WhatsApp group. Use this action when you need to retrieve pending requests from users who want to join a WhatsApp group. This is useful for group administration, mo...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_media_info
+  slug: WHATSAPP_GET_MEDIA_INFO
+  toolkit: whatsapp
+  description: Get metadata and download URL for uploaded WhatsApp media. Returns media ID, download URL (valid for 5 minutes), MIME type, SHA256 hash, and file size. The download URL can be used to retrieve the act...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_message_history
+  slug: WHATSAPP_GET_MESSAGE_HISTORY
+  toolkit: whatsapp
+  description: Retrieve message history for a WhatsApp Business phone number. Returns a paginated list of messages with their delivery status information, including events like delivery status updates, timestamps, a...
+  scopes:
+  - whatsapp_business_messaging
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_message_templates
+  slug: WHATSAPP_GET_MESSAGE_TEMPLATES
+  toolkit: whatsapp
+  description: Get all message templates for the WhatsApp Business Account. Templates are required for sending messages outside the 24-hour window and for marketing/utility messages.
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_owned_business_accounts
+  slug: WHATSAPP_GET_OWNED_BUSINESS_ACCOUNTS
+  toolkit: whatsapp
+  description: Retrieve WhatsApp Business Accounts owned by a business portfolio. Use this action when you need to get all WhatsApp Business Accounts (WABAs) that are directly owned by a specific business. This diff...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_phone_number
+  slug: WHATSAPP_GET_PHONE_NUMBER
+  toolkit: whatsapp
+  description: Retrieve detailed information about a specific WhatsApp Business phone number. Returns phone number details including verification status, quality rating, display number, verified business name, throu...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_phone_numbers
+  slug: WHATSAPP_GET_PHONE_NUMBERS
+  toolkit: whatsapp
+  description: Retrieve all phone numbers registered to your WhatsApp Business Account. Returns phone number IDs, display numbers, verification status, quality ratings, and messaging throughput limits. Use the phone...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_schedules
+  slug: WHATSAPP_GET_SCHEDULES
+  toolkit: whatsapp
+  description: Retrieve campaign schedules associated with a WhatsApp Business Account. Use this action when you need to list all scheduled campaigns for a WABA, including their status, timing, and recurrence patter...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_settings
+  slug: WHATSAPP_GET_SETTINGS
+  toolkit: whatsapp
+  description: Get Cloud API settings for a WhatsApp Business phone number. Retrieves calling, storage, and payload encryption settings for a specific WhatsApp Business phone number. This includes information about...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_subscribed_apps
+  slug: WHATSAPP_GET_SUBSCRIBED_APPS
+  toolkit: whatsapp
+  description: Get all applications currently subscribed to webhooks for a WhatsApp Business Account. Use this action when you need to retrieve the list of third-party applications or integrations that are subscribe...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_template_library
+  slug: WHATSAPP_GET_TEMPLATE_LIBRARY
+  toolkit: whatsapp
+  description: Browse the pre-built message template library for WhatsApp Business Account. This retrieves a list of available templates that can be used for messaging. Use when you need to discover available messag...
+  scopes:
+  - whatsapp_business_messaging
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_template_status
+  slug: WHATSAPP_GET_TEMPLATE_STATUS
+  toolkit: whatsapp
+  description: Get the status and details of a specific message template. This is useful for checking if a template has been approved, rejected, or is still pending review.
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.list_flows
+  slug: WHATSAPP_LIST_FLOWS
+  toolkit: whatsapp
+  description: List all WhatsApp Flows associated with the WhatsApp Business Account. Returns flow details including name, status, categories, and any validation errors. Use when you need to retrieve all available f...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.list_groups
+  slug: WHATSAPP_LIST_GROUPS
+  toolkit: whatsapp
+  description: List all WhatsApp groups associated with a business phone number. Use this action when you need to retrieve the list of groups that a business phone number is a member of. This is useful for managing...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.list_qr_codes
+  slug: WHATSAPP_LIST_QR_CODES
+  toolkit: whatsapp
+  description: Get a list of all QR codes for a WhatsApp Business phone number. Use this action when you need to retrieve all message QR codes associated with a specific WhatsApp Business phone number. This is usefu...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.list_solutions
+  slug: WHATSAPP_LIST_SOLUTIONS
+  toolkit: whatsapp
+  description: Retrieve a paginated list of Multi-Partner Solutions for a WhatsApp Business Account. Use when you need to view all multi-partner solutions (such as SMB solutions) associated with a WABA, including th...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.publish_flow
+  slug: WHATSAPP_PUBLISH_FLOW
+  toolkit: whatsapp
+  description: Publish a WhatsApp Flow to make it available for use. Use this action when you have finished designing and testing a WhatsApp Flow and are ready to make it available for users. The flow must be in DRA...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.register_phone
+  slug: WHATSAPP_REGISTER_PHONE
+  toolkit: whatsapp
+  description: Register a WhatsApp Business phone number for use with WhatsApp Cloud API. Use when you need to register a phone number that has been added to your WhatsApp Business Account. This action requires sett...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_contacts
+  slug: WHATSAPP_SEND_CONTACTS
+  toolkit: whatsapp
+  description: 'Send contacts WhatsApp number. Note: The message will be delivered to the recipient only if they have initiated a conversation first.'
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_interactive_buttons
+  slug: WHATSAPP_SEND_INTERACTIVE_BUTTONS
+  toolkit: whatsapp
+  description: Send an interactive button message with up to 3 reply buttons to a WhatsApp user. Interactive button messages allow recipients to quickly respond by tapping predefined buttons. Perfect for yes/no ques...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_interactive_list
+  slug: WHATSAPP_SEND_INTERACTIVE_LIST
+  toolkit: whatsapp
+  description: Send an interactive list message to a WhatsApp number. List messages display a menu of options organized into sections. Users tap a button to view the list and select one option. Perfect for product c...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_location
+  slug: WHATSAPP_SEND_LOCATION
+  toolkit: whatsapp
+  description: Send a location message with coordinates, name, and address to a WhatsApp user. This action allows you to share location information through WhatsApp Business API. The location message includes latitu...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_media
+  slug: WHATSAPP_SEND_MEDIA
+  toolkit: whatsapp
+  description: 'Send a media message to a WhatsApp number. Note: The media will be delivered to the recipient only if they have texted first.'
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_media_by_id
+  slug: WHATSAPP_SEND_MEDIA_BY_ID
+  toolkit: whatsapp
+  description: Send media using a media ID from previously uploaded media. This is more efficient than sending media by URL as the media is already on WhatsApp servers. Use upload_media action first to get the media...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_message
+  slug: WHATSAPP_SEND_MESSAGE
+  toolkit: whatsapp
+  description: 'Send a text message to a WhatsApp user. Important: The recipient phone number must be registered on WhatsApp and must have initiated a conversation with your business within the last 24 hours, OR you...'
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_template_message
+  slug: WHATSAPP_SEND_TEMPLATE_MESSAGE
+  toolkit: whatsapp
+  description: Send a template message to a WhatsApp number.
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.set_two_step_verification
+  slug: WHATSAPP_SET_TWO_STEP_VERIFICATION
+  toolkit: whatsapp
+  description: Set or reset the two-step verification PIN for a WhatsApp Business phone number. Use when you need to change the 6-digit PIN that protects a registered phone number — for example after onboarding a ne...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.subscribe_app
+  slug: WHATSAPP_SUBSCRIBE_APP
+  toolkit: whatsapp
+  description: Subscribe your application to receive webhook notifications for a WhatsApp Business Account (WABA). This action registers the application to receive webhook events from the specified WABA. Use this ac...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_business_account
+  slug: WHATSAPP_UPDATE_BUSINESS_ACCOUNT
+  toolkit: whatsapp
+  description: Update metadata for a WhatsApp Flow including its name, categories, and endpoint URI. Use when you need to modify the configuration or settings of an existing WhatsApp Flow.
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_business_profile
+  slug: WHATSAPP_UPDATE_BUSINESS_PROFILE
+  toolkit: whatsapp
+  description: Update WhatsApp Business Profile information including business details, contact information, and profile settings. Use when you need to modify the business profile settings such as the about text, bu...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_commerce_settings
+  slug: WHATSAPP_UPDATE_COMMERCE_SETTINGS
+  toolkit: whatsapp
+  description: Set or update commerce settings for a WhatsApp Business phone number. Use this action to enable or disable shopping cart functionality and product catalog visibility for a specific WhatsApp Business p...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_flow_json
+  slug: WHATSAPP_UPDATE_FLOW_JSON
+  toolkit: whatsapp
+  description: Update the Flow JSON configuration for a WhatsApp Flow. Use this action when you need to update or upload a new flow.json file for an existing WhatsApp Flow. The Flow JSON defines the structure, scree...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_settings
+  slug: WHATSAPP_UPDATE_SETTINGS
+  toolkit: whatsapp
+  description: Update Cloud API settings for a WhatsApp Business phone number. Use this action to modify calling features, user identity verification settings, payload encryption configuration, and data storage pref...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.upload_media
+  slug: WHATSAPP_UPLOAD_MEDIA
+  toolkit: whatsapp
+  description: 'Upload media files (images, videos, audio, documents, stickers) to WhatsApp servers. The uploaded media gets a media ID that can be used in send_media or other messaging actions. Supported formats: -...'
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.upsert_message_template
+  slug: WHATSAPP_UPSERT_MESSAGE_TEMPLATE
+  toolkit: whatsapp
+  description: Create or update a message template for the WhatsApp Business Account. Use this action when you need to create a new message template or update an existing one with the same name. If a template with t...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.verify_code
+  slug: WHATSAPP_VERIFY_CODE
+  toolkit: whatsapp
+  description: Verify the OTP code for a pre-verified phone number. Use when you need to complete phone number verification by submitting the received OTP code. The phone number must first be added to your WhatsApp...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.who_am_i
+  slug: WHATSAPP_WHO_AM_I
+  toolkit: whatsapp
+  description: Return the identity (name) of the connected WhatsApp (Meta) account.
+  scopes: []
+  breadth: generic
+  guarantee: experimental
+  side_effect: read

{gravity_schema-0.5.2 → gravity_schema-0.5.4}/gravity_schema/cron.py

@@ -1,11 +1,16 @@
-"""Standard 5-field cron, local time. Day-of-week 0 or 7 is Sunday; when both day
+"""Standard 5-field cron, in whatever timezone the `after` datetime carries (gravity
+schedule passes Asia/Kolkata, like the hosted schedules). Day-of-week 0 or 7 is Sunday; when both day
 fields are restricted, either matching is enough (as in cron itself)."""
 
 from __future__ import annotations
 
+import math
 from datetime import datetime, timedelta
+from itertools import pairwise
 
 _BOUNDS = ((0, 59), (0, 23), (1, 31), (1, 12), (0, 7))
+# Every tick is a paid run; the control plane's MIN_SCHEDULE_MINUTES.
+MIN_GAP_MINUTES = 5
 
 
 def _values(field: str, low: int, high: int) -> set[int]:
@@ -22,6 +27,26 @@ def _values(field: str, low: int, high: int) -> set[int]:
     return out
 
 
+def field_values(expr: str) -> list[set[int]]:
+    """Each field's values. ValueError when a field is malformed, empty or out of its range."""
+    out = [_values(f, lo, hi) for f, (lo, hi) in zip(expr.split(), _BOUNDS)]
+    for vals, (lo, hi) in zip(out, _BOUNDS):
+        if not vals or min(vals) < lo or max(vals) > hi:
+            raise ValueError(f"'{expr}' has a value out of range")
+    return out
+
+
+def min_gap(expr: str) -> float:
+    """Minutes between the closest two fires, from the minute and hour fields alone (the day
+    fields can only widen it). Same arithmetic as the control plane's checkScheduleFloor."""
+    minutes, hours = field_values(expr)[:2]
+    mins = sorted(minutes)
+    gap = min((b - a for a, b in pairwise(mins)), default=math.inf)
+    if any((h + 1) % 24 in hours for h in hours):
+        gap = min(gap, 60 - mins[-1] + mins[0])
+    return gap
+
+
 def matches(expr: str, at: datetime) -> bool:
     fields = expr.split()
     minute, hour, dom, month, dow = (_values(f, *b) for f, b in zip(fields, _BOUNDS))

{gravity_schema-0.5.2 → gravity_schema-0.5.4}/gravity_schema/manifest.py

@@ -9,6 +9,7 @@ from pydantic import BaseModel, ConfigDict, Field, field_validator, model_valida
 from pydantic_core import PydanticCustomError
 
 from . import contract as C
+from . import cron
 from .errors import ErrorCode
 
 # Unknown fields are rejected, so a newer-contract field is reported, not dropped.
@@ -99,6 +100,18 @@ class RuntimeSpec(BaseModel):
             )
         return v
 
+    @field_validator("python", mode="before")
+    @classmethod
+    def _check_python_is_text(cls, v: Any) -> Any:
+        # YAML reads an unquoted 3.12 as a float (and 3.10 as 3.1).
+        if isinstance(v, (int, float)):
+            raise PydanticCustomError(
+                ErrorCode.INVALID_PYTHON_VERSION.value,
+                "Python version {value} is not quoted text.",
+                {"value": v, "remediation": 'Put it in quotes: python: "3.12".'},
+            )
+        return v
+
     @field_validator("python")
     @classmethod
     def _check_python(cls, v: str) -> str:
@@ -375,6 +388,37 @@ class ScheduleSpec(BaseModel):
                     ),
                 },
             )
+        try:
+            cron.field_values(v)
+        except ValueError:
+            raise PydanticCustomError(
+                ErrorCode.INVALID_TRIGGER.value,
+                "Schedule '{value}' has a value out of range.",
+                {
+                    "value": v,
+                    "remediation": (
+                        "Minutes are 0-59, hours 0-23, days 1-31, months 1-12 and "
+                        "weekdays 0-7 (0 and 7 are Sunday)."
+                    ),
+                },
+            ) from None
+        # The platform's scheduler cannot express cron's "either day matches".
+        if fields[2] != "*" and fields[4] != "*":
+            raise PydanticCustomError(
+                ErrorCode.INVALID_TRIGGER.value,
+                "Schedule '{value}' restricts both the day of the month and the weekday.",
+                {"value": v, "remediation": "Set one of them to *."},
+            )
+        if cron.min_gap(v) < cron.MIN_GAP_MINUTES:
+            raise PydanticCustomError(
+                ErrorCode.INVALID_TRIGGER.value,
+                "Schedules can run at most every {limit} minutes.",
+                {
+                    "value": v,
+                    "limit": cron.MIN_GAP_MINUTES,
+                    "remediation": f"Use '*/{cron.MIN_GAP_MINUTES} * * * *' or something slower.",
+                },
+            )
         return v
 
 
@@ -527,6 +571,18 @@ class Manifest(BaseModel):
             )
         return v
 
+    @field_validator("version", mode="before")
+    @classmethod
+    def _check_version_is_text(cls, v: Any) -> Any:
+        # YAML reads an unquoted 1.0 as a float.
+        if isinstance(v, (int, float)):
+            raise PydanticCustomError(
+                ErrorCode.INVALID_AGENT_VERSION.value,
+                "Agent version {value} is not quoted text.",
+                {"value": v, "remediation": 'Put it in quotes: version: "1.0.0".'},
+            )
+        return v
+
     @field_validator("version")
     @classmethod
     def _check_version(cls, v: str) -> str:

{gravity_schema-0.5.2 → gravity_schema-0.5.4}/gravity_schema/validation.py

@@ -156,7 +156,17 @@ def load_manifest_file(
             "Run `gravity init` to create one, or check the path.",
             str(p),
         )
-    return load_manifest_text(p.read_text(encoding="utf-8"), catalog=catalog)
+    try:
+        text = p.read_text(encoding="utf-8")
+    except UnicodeDecodeError:
+        # Notepad's "Unicode" is UTF-16; a BOM-only UTF-8 file decodes fine and YAML skips the BOM.
+        raise _fail(
+            ErrorCode.MALFORMED_YAML,
+            "Manifest is not UTF-8 text.",
+            "Save the file as UTF-8 (in Notepad: Encoding, then UTF-8).",
+            str(p),
+        ) from None
+    return load_manifest_text(text, catalog=catalog)
 
 
 def _fail(code: ErrorCode, message: str, remediation: str, location: str = "") -> ManifestValidationError:

{gravity_schema-0.5.2 → gravity_schema-0.5.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gravity-schema"
-version = "0.5.2"
+version = "0.5.4"
 description = "Gravity agent manifest contract — models, validation, and JSON Schema export"
 readme = "README.md"
 license = "Apache-2.0"

{gravity_schema-0.5.2 → gravity_schema-0.5.4}/tests/test_cron.py

@@ -1,7 +1,7 @@
 from datetime import datetime
 
 import pytest
-from gravity_schema.cron import matches, next_run
+from gravity_schema.cron import field_values, matches, min_gap, next_run
 
 MON_0900 = datetime(2026, 9, 28, 9, 0)  # a Monday
 
@@ -29,3 +29,18 @@ def test_next_run_is_strictly_after():
     assert next_run("0 9 * * *", MON_0900) == datetime(2026, 9, 29, 9, 0)
     with pytest.raises(ValueError):
         next_run("0 0 31 2 *", MON_0900)  # 31 February
+
+
+def test_field_values_checks_every_range():
+    assert field_values("0 9 1 * 7")[4] == {7}
+    for bad in ("60 * * * *", "0 24 * * *", "0 0 0 * *", "0 0 32 * *", "0 0 * 13 *", "0 0 * * 8", "5-3 * * * *", "*/0 * * * *"):
+        with pytest.raises(ValueError):
+            field_values(bad)
+
+
+def test_min_gap_is_the_closest_two_fires():
+    assert min_gap("*/5 * * * *") == 5
+    assert min_gap("0,3 * * * *") == 3
+    assert min_gap("0,59 * * * *") == 1  # 10:59 then 11:00
+    assert min_gap("59 9 * * *") == float("inf")  # once a day; the day fields don't matter
+    assert min_gap("58 9,10 * * *") == 60

{gravity_schema-0.5.2 → gravity_schema-0.5.4}/tests/test_manifest.py

@@ -8,9 +8,12 @@ from gravity_schema import (
     InputType,
     ManifestValidationError,
     ModelTier,
+    load_manifest_file,
     validate_manifest,
 )
 from gravity_schema.contract import MAX_INPUTS, MAX_TOOLS
+from gravity_schema.manifest import ScheduleSpec
+from pydantic import ValidationError
 
 
 def codes(exc: ManifestValidationError) -> set[ErrorCode]:
@@ -122,6 +125,32 @@ def test_valid_semver_accepted(manifest_data, good):
     assert validate_manifest(manifest_data).version == good
 
 
+@pytest.mark.parametrize("bad", [1.0, 1])
+def test_unquoted_version_says_to_quote_it(manifest_data, bad):
+    """`version: 1.0` is a YAML float; pydantic's bare 'Input should be a valid string' has no fix."""
+    manifest_data["version"] = bad
+
+    with pytest.raises(ManifestValidationError) as ei:
+        validate_manifest(manifest_data)
+
+    issue = only_issue(ei.value)
+    assert issue.code is ErrorCode.INVALID_AGENT_VERSION
+    assert issue.location == "version"
+    assert 'version: "1.0.0"' in (issue.remediation or "")
+
+
+def test_unquoted_python_says_to_quote_it(manifest_data):
+    manifest_data["runtime"]["python"] = 3.12
+
+    with pytest.raises(ManifestValidationError) as ei:
+        validate_manifest(manifest_data)
+
+    issue = only_issue(ei.value)
+    assert issue.code is ErrorCode.INVALID_PYTHON_VERSION
+    assert issue.location == "runtime.python"
+    assert 'python: "3.12"' in (issue.remediation or "")
+
+
 # Runtime
 
 
@@ -575,6 +604,59 @@ def test_invalid_cron_rejected(manifest_data, bad):
     assert ErrorCode.INVALID_TRIGGER in rejected_with(manifest_data)
 
 
+@pytest.mark.parametrize("bad", ["60 * * * *", "0 25 * * *", "0 8 32 * *", "0 8 1 13 *", "0 8 * * 8", "*/0 * * * *", "5-3 * * * *"])
+def test_cron_value_out_of_range_rejected(manifest_data, bad):
+    """These passed as '5 fields of digits' but never fire, or the platform refuses them."""
+    manifest_data["triggers"] = {"schedule": {"cron": bad}}
+
+    with pytest.raises(ManifestValidationError) as ei:
+        validate_manifest(manifest_data)
+
+    issue = only_issue(ei.value)
+    assert issue.code is ErrorCode.INVALID_TRIGGER
+    assert "0-59" in (issue.remediation or "")
+
+
+def test_cron_restricting_both_day_fields_rejected(manifest_data):
+    """Unix cron ORs them; the platform's scheduler cannot."""
+    manifest_data["triggers"] = {"schedule": {"cron": "0 9 1 * 1"}}
+
+    with pytest.raises(ManifestValidationError) as ei:
+        validate_manifest(manifest_data)
+
+    issue = only_issue(ei.value)
+    assert issue.code is ErrorCode.INVALID_TRIGGER
+    assert "Set one of them to *" in (issue.remediation or "")
+
+
+@pytest.mark.parametrize("bad", ["* * * * *", "*/2 * * * *", "*/4 * * * *", "0,3 * * * *", "0,59 * * * *", "0,2 9 * * *"])
+def test_cron_faster_than_every_5_minutes_rejected(manifest_data, bad):
+    """The control plane's floor (checkScheduleFloor), with its wording, caught before push."""
+    manifest_data["triggers"] = {"schedule": {"cron": bad}}
+
+    with pytest.raises(ManifestValidationError) as ei:
+        validate_manifest(manifest_data)
+
+    issue = only_issue(ei.value)
+    assert issue.code is ErrorCode.INVALID_TRIGGER
+    assert issue.message == "Schedules can run at most every 5 minutes."
+    assert issue.remediation
+
+
+@pytest.mark.parametrize("good", ["*/5 * * * *", "0,5 9 * * *", "0,30 * * * *", "59 23 * * *", "58 9,10 * * *", "0 9 1 * *", "0 9 * * 7"])
+def test_cron_at_or_above_the_floor_accepted(manifest_data, good):
+    manifest_data["triggers"] = {"schedule": {"cron": good}}
+    assert validate_manifest(manifest_data).triggers.schedule.cron == good
+
+
+def test_schedule_spec_alone_applies_the_same_rules():
+    """`gravity schedule --cron` validates through ScheduleSpec directly."""
+    with pytest.raises(ValidationError) as ei:
+        ScheduleSpec(cron="*/2 * * * *")
+    assert "Schedules can run at most every 5 minutes." in str(ei.value)
+    assert ScheduleSpec(cron="*/5 * * * *").cron == "*/5 * * * *"
+
+
 def test_an_agent_nothing_can_start_is_rejected(manifest_data):
     manifest_data["triggers"] = {"manual": False}
     assert ErrorCode.INVALID_TRIGGER in rejected_with(manifest_data)
@@ -626,6 +708,30 @@ def test_runtime_python_defaults_to_313(manifest_data):
     assert validate_manifest(manifest_data).runtime.python == "3.12"
 
 
+# Loading from disk (the path every gravity command takes)
+
+
+def test_utf16_manifest_file_reports_the_encoding(tmp_path):
+    """Notepad's 'Unicode' is UTF-16; it must be a problem, not a UnicodeDecodeError traceback."""
+    p = tmp_path / "manifest.yaml"
+    p.write_bytes("contract: v1\nname: x\n".encode("utf-16"))
+
+    with pytest.raises(ManifestValidationError) as ei:
+        load_manifest_file(p)
+
+    issue = only_issue(ei.value)
+    assert issue.code is ErrorCode.MALFORMED_YAML
+    assert issue.location == str(p)
+    assert "UTF-8" in (issue.remediation or "")
+
+
+def test_utf8_bom_manifest_file_still_loads(tmp_path):
+    """Notepad's default 'UTF-8 with BOM' is fine: YAML skips the BOM."""
+    p = tmp_path / "manifest.yaml"
+    p.write_bytes(b"\xef\xbb\xbf" + b"name: x\nruntime:\n  entrypoint: src/agent.py:graph\n")
+    assert load_manifest_file(p).name == "x"
+
+
 def test_a_secret_input_cannot_have_a_default(manifest_data):
     manifest_data["inputs"] = [{"name": "api_key", "type": "secret", "label": "Key", "default": "sk-x"}]
     with pytest.raises(ManifestValidationError) as e: