gravity-cli 0.9.0__tar.gz → 0.11.0__tar.gz

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/AGENT_STANDARD.md

@@ -348,7 +348,7 @@ to one address, with the output's content in the message body and no
 attachment; a thread sends at most 200 a day. The platform sends it, not the
 agent, so the agent needs no Gmail tool and no approval for it.
 
-Renderers: `markdown`, `docx`, `pptx`, `rows` (the first table, as CSV). Each
+Renderers: `markdown`, `docx`, `pptx`, `pdf`, `rows` (the first table, as CSV), `xlsx` (every table, a sheet each). Each
 consumer picks outputs and destinations per run. The agent writes one
 **corpus** into its final state, and every output is rendered from it:
 

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/AGENT_STANDARD_V2.md

@@ -384,7 +384,7 @@ record tagged with its app in `extra.app`. The platform delivers it after the
 run, not the agent, so the agent declares no write for it; an email goes at
 most once per run and a thread sends at most 200 a day, extra places included.
 
-Renderers: `markdown`, `docx`, `pptx`, `rows` (the first table, as CSV). Each
+Renderers: `markdown`, `docx`, `pptx`, `pdf`, `rows` (the first table, as CSV), `xlsx` (every table, a sheet each). Each
 consumer picks outputs and destinations per run. The agent writes one
 **corpus** into its final state, and every output is rendered from it:
 

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.5
 Name: gravity-cli
-Version: 0.9.0
+Version: 0.11.0
 Summary: gravity cli — init, run, and push python agents to the Gravity marketplace
 License-Expression: Apache-2.0
 License-File: LICENSE
 License-File: NOTICE
 Requires-Python: >=3.12
-Requires-Dist: gravity-schema==0.9.0
+Requires-Dist: gravity-schema==0.11.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: keyring>=25.0.0
 Requires-Dist: python-dotenv>=1.0.0
@@ -720,7 +720,7 @@ slots:                            # a part the consumer chooses; each adapter ge
 
 outputs:                          # extra formats the platform renders and delivers itself
   report:
-    renderer: markdown            # markdown | docx | pptx | rows
+    renderer: markdown            # markdown | docx | pptx | pdf | rows | xlsx
     label: "Digest as a document"
     destinations: [download]
 ```
@@ -752,7 +752,7 @@ outputs:                          # extra formats the platform renders and deliv
 | `triggers.webhook` | no | none | A list of events; `github.push` is the only one today. |
 | `state.max_kb` | no | no memory | Include `state:` to keep memory between runs, in `state["memory"]`. 1 to 256 KB. |
 | `slots.<name>` | no | none | A swappable part: `label`, `default` adapter, and `adapters` mapping each adapter name to the tools it may call. Code lives in `src/adapters/<slot>/<adapter>.py`. Slot names cannot repeat an input's name. |
-| `outputs.<name>` | no | none | Up to 8 extra formats rendered from the result: `renderer` (`markdown`, `docx`, `pptx` or `rows`), `label` and `destinations` (`download`, or a catalog tool such as `gmail.send`). |
+| `outputs.<name>` | no | none | Up to 8 extra formats rendered from the result: `renderer` (`markdown`, `docx`, `pptx`, `pdf`, `rows` or `xlsx`), `label` and `destinations` (`download`, or a catalog tool such as `gmail.send`). |
 
 Unknown fields are rejected rather than ignored, so a typo is reported instead of silently dropped.
 

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/README.md

@@ -703,7 +703,7 @@ slots:                            # a part the consumer chooses; each adapter ge
 
 outputs:                          # extra formats the platform renders and delivers itself
   report:
-    renderer: markdown            # markdown | docx | pptx | rows
+    renderer: markdown            # markdown | docx | pptx | pdf | rows | xlsx
     label: "Digest as a document"
     destinations: [download]
 ```
@@ -735,7 +735,7 @@ outputs:                          # extra formats the platform renders and deliv
 | `triggers.webhook` | no | none | A list of events; `github.push` is the only one today. |
 | `state.max_kb` | no | no memory | Include `state:` to keep memory between runs, in `state["memory"]`. 1 to 256 KB. |
 | `slots.<name>` | no | none | A swappable part: `label`, `default` adapter, and `adapters` mapping each adapter name to the tools it may call. Code lives in `src/adapters/<slot>/<adapter>.py`. Slot names cannot repeat an input's name. |
-| `outputs.<name>` | no | none | Up to 8 extra formats rendered from the result: `renderer` (`markdown`, `docx`, `pptx` or `rows`), `label` and `destinations` (`download`, or a catalog tool such as `gmail.send`). |
+| `outputs.<name>` | no | none | Up to 8 extra formats rendered from the result: `renderer` (`markdown`, `docx`, `pptx`, `pdf`, `rows` or `xlsx`), `label` and `destinations` (`download`, or a catalog tool such as `gmail.send`). |
 
 Unknown fields are rejected rather than ignored, so a typo is reported instead of silently dropped.
 

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/gravity_schema/catalog.yaml

@@ -74,6 +74,15 @@
   guarantee: certified
   side_effect: read
 
+- name: treg.email_find
+  slug: null
+  toolkit: null
+  description: find and verify a person's work email from their LinkedIn URL, or a full name plus the company's email domain; served by the gateway through the team's lookup account (a fraction of a cent a call), capped per call and verified in the same call
+  scopes: []
+  breadth: generic
+  guarantee: certified
+  side_effect: read
+
 - name: browser.act
   slug: null
   toolkit: null
@@ -155,6 +164,42 @@
   guarantee: certified
   side_effect: write
 
+- name: sheets.create
+  slug: GOOGLESHEETS_CREATE_GOOGLE_SHEET1
+  toolkit: googlesheets
+  description: create a new Google Sheet in the connected Google account
+  scopes: [sheets]
+  breadth: generic
+  guarantee: certified
+  side_effect: write
+
+- name: sheets.add_tab
+  slug: GOOGLESHEETS_ADD_SHEET
+  toolkit: googlesheets
+  description: add a tab to a Google Sheet in the connected Google account
+  scopes: [sheets]
+  breadth: generic
+  guarantee: certified
+  side_effect: write
+
+- name: docs.read
+  slug: GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT
+  toolkit: googledocs
+  description: read a Google Doc in the connected Google account as plain text (document_id, from a google-doc input)
+  scopes: [docs]
+  breadth: generic
+  guarantee: certified
+  side_effect: read
+
+- name: docs.create
+  slug: GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN
+  toolkit: googledocs
+  description: create a Google Doc from markdown in the connected Google account
+  scopes: [docs]
+  breadth: generic
+  guarantee: certified
+  side_effect: write
+
 - name: slack.send
   slug: SLACK_SEND_MESSAGE
   toolkit: slack

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/gravity_schema/contract.py

@@ -106,6 +106,8 @@ MAX_INPUTS: Final[int] = 50
 MAX_TOOLS: Final[int] = 50
 MAX_OPTIONS: Final[int] = 100
 MAX_FILE_EXTENSIONS: Final[int] = 20
+# A file input with `max` (several files): the most it may ask for. Each upload is up to 25 MB.
+MAX_FILES: Final[int] = 20
 MAX_NAME_LENGTH: Final[int] = 64
 MAX_ENTRYPOINT_LENGTH: Final[int] = 256
 MAX_LABEL_LENGTH: Final[int] = 200

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/gravity_schema/manifest.py

@@ -319,11 +319,23 @@ class Manifest(BaseModel):
 
     @model_validator(mode="after")
     def _check_monitor_has_a_trigger(self) -> Manifest:
-        if self.kind is AgentKind.MONITOR and self.triggers.schedule is None and not self.triggers.webhook:
+        if (self.kind is AgentKind.MONITOR and self.triggers.schedule is None and not self.triggers.webhook
+                and self.triggers.email is None):
             raise PydanticCustomError(
                 ErrorCode.INVALID_KIND.value,
-                "A monitor needs a schedule or a webhook trigger.",
-                {"remediation": "Add triggers.schedule or triggers.webhook, or use kind: interactive."},
+                "A monitor needs a schedule, an email or a webhook trigger.",
+                {"remediation": "Add triggers.schedule, triggers.email or triggers.webhook, or use kind: interactive."},
+            )
+        return self
+
+    @model_validator(mode="after")
+    def _check_email_trigger_reads_gmail(self) -> Manifest:
+        # Gravity reads the new mail with the person's Gmail, under the agent's own permission.
+        if self.triggers.email is not None and "gmail.read" not in self.permissions.tools:
+            raise PydanticCustomError(
+                ErrorCode.INVALID_TRIGGER.value,
+                "triggers.email watches Gmail, but the agent does not declare gmail.read.",
+                {"remediation": "Add gmail.read to permissions.tools."},
             )
         return self
 

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/gravity_schema/manifest_v2.py

@@ -53,7 +53,9 @@ RENDERER_DESTINATIONS: dict[Renderer, tuple[str, ...]] = {
                         "post.create", "file.create"),
     Renderer.DOCX: ("file.create", "document.create", "message.send"),
     Renderer.PPTX: ("file.create", "presentation.create", "message.send"),
+    Renderer.PDF: ("file.create", "message.send"),
     Renderer.ROWS: ("row.append", "file.create"),
+    Renderer.XLSX: ("file.create",),
 }
 
 # A filter on one of these fields takes one of the shape's listed values.

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/gravity_schema/rules.py

@@ -14,6 +14,8 @@ would get them: a condition on an input nobody answered and nothing defaulted do
 
 from __future__ import annotations
 
+import datetime as dt
+import re
 from typing import Any
 
 from .specs import ActionSpec, InputSpec, InputType
@@ -115,8 +117,52 @@ def apply_rules(manifest: Manifest, answers: dict[str, Any]) -> dict[str, Any]:
 Problem = tuple[str, str]  # (the input or choose_one label it is about, what to tell the person)
 
 
+DAY = re.compile(r"^\d{4}-\d{2}-\d{2}$")
+
+
+def _is_day(value: Any) -> bool:
+    if not isinstance(value, str) or not DAY.match(value):
+        return False
+    try:
+        dt.date.fromisoformat(value)
+    except ValueError:
+        return False
+    return True
+
+
+# The file id in a Google Doc or Sheet link, or a bare id (Google's are 25 or more of these characters).
+_GOOGLE_PATH = {"google-doc": "document", "google-sheet": "spreadsheets"}
+_GOOGLE_ID = re.compile(r"^[A-Za-z0-9_-]{25,}$")
+
+
+def google_file_id(kind: str, value: Any) -> str | None:
+    """'https://docs.google.com/spreadsheets/d/<id>/edit#gid=0' -> '<id>' for a google-sheet input (document for a
+    google-doc one); a bare id as it is; None for anything else, a Sheet's link in a Doc input included."""
+    text = value.strip() if isinstance(value, str) else ""
+    if _GOOGLE_ID.match(text):
+        return text
+    m = re.search(rf"docs\.google\.com/{_GOOGLE_PATH.get(kind, '-')}/d/([A-Za-z0-9_-]{{20,}})", text)
+    return m.group(1) if m else None
+
+
 def _bounds(spec: InputSpec, value: Any) -> str | None:
     label = spec.label or spec.name
+    if spec.many_days and not _blank(value):
+        if not isinstance(value, list) or not all(_is_day(v) for v in value):
+            return f'"{label}": pick days on the calendar.'
+        if spec.min is not None and len(value) < spec.min:
+            return f'"{label}": pick at least {spec.min} days.'
+        if spec.max is not None and len(value) > spec.max:
+            return f'"{label}": pick at most {spec.max} days.'
+        return None
+    if spec.many_files and not _blank(value):
+        if not isinstance(value, list) or not all(isinstance(v, str) and v.strip() for v in value):
+            return f'"{label}": upload the files again.'
+        if spec.min is not None and len(value) < spec.min:
+            return f'"{label}": upload at least {spec.min} files.'
+        if spec.max is not None and len(value) > spec.max:
+            return f'"{label}": upload at most {spec.max} files.'
+        return None
     if spec.type is InputType.MULTI_SELECT and not _blank(value):
         if not isinstance(value, list) or any(v not in (spec.options or []) for v in value):
             return f'"{label}": pick from {", ".join(spec.options or [])}.'
@@ -141,6 +187,10 @@ def _check(inputs: list[InputSpec], shown: list[str], answers: dict[str, Any]) -
             out.append((spec.name, f'"{spec.label or spec.name}" is required.'))
         elif spec.type is InputType.MULTI_SELECT and spec.min and _blank(value):
             out.append((spec.name, f'"{spec.label or spec.name}": pick at least {spec.min}.'))
+        elif spec.many_days and spec.min and _blank(value):
+            out.append((spec.name, f'"{spec.label or spec.name}": pick at least {spec.min} days.'))
+        elif spec.many_files and spec.min and _blank(value):
+            out.append((spec.name, f'"{spec.label or spec.name}": upload at least {spec.min} files.'))
         elif (problem := _bounds(spec, value)) is not None:
             out.append((spec.name, problem))
     return out

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/gravity_schema/rules_cases.json

@@ -11,7 +11,9 @@
       {"name": "brand_kit", "type": "text", "label": "Brand kit link", "show_if": {"platforms": ["instagram", "youtube"]}},
       {"name": "contact_source", "type": "static-dropdown", "label": "Contacts from", "options": ["gravity", "hunter", "both"], "default": "gravity"},
       {"name": "hunter_key", "type": "secret", "label": "Your Hunter API key", "required": true, "show_if": {"contact_source": ["hunter", "both"]}},
-      {"name": "goal", "type": "action-choice", "label": "What do you want to do first?", "actions": ["find_companies", "write_emails"]}
+      {"name": "goal", "type": "action-choice", "label": "What do you want to do first?", "actions": ["find_companies", "write_emails"]},
+      {"name": "call_days", "type": "date", "label": "Days for a call", "min": 1, "max": 3, "show_if": {"goal": "write_emails"}},
+      {"name": "past_pitches", "type": "file", "label": "Past pitch decks", "accept": ["pdf"], "min": 1, "max": 2, "show_if": {"goal": "find_companies"}}
     ],
     "slots": {
       "deliver": {"label": "Deliver to", "default": "gravity", "adapters": {"gravity": [], "gmail": ["gmail.draft"]}},
@@ -62,6 +64,38 @@
     {"name": "action choice must be offered",
      "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "delete_everything"},
      "visible": ["resume_text", "platforms", "contact_source", "goal"],
-     "problems": ["goal"]}
+     "problems": ["goal"]},
+    {"name": "a date with max takes a list of days",
+     "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "write_emails", "call_days": ["2026-11-03", "2026-11-05"]},
+     "visible": ["resume_text", "platforms", "contact_source", "goal", "call_days"],
+     "problems": []},
+    {"name": "days must be real calendar days",
+     "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "write_emails", "call_days": ["next tuesday", "2026-02-30"]},
+     "visible": ["resume_text", "platforms", "contact_source", "goal", "call_days"],
+     "problems": ["call_days"]},
+    {"name": "no more days than max",
+     "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "write_emails", "call_days": ["2026-11-03", "2026-11-04", "2026-11-05", "2026-11-06"]},
+     "visible": ["resume_text", "platforms", "contact_source", "goal", "call_days"],
+     "problems": ["call_days"]},
+    {"name": "min days asks for at least one",
+     "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "write_emails"},
+     "visible": ["resume_text", "platforms", "contact_source", "goal", "call_days"],
+     "problems": ["call_days"]},
+    {"name": "a file with max takes a list of links",
+     "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "find_companies", "past_pitches": ["https://x.test/uploads/a.pdf", "https://x.test/uploads/b.pdf"]},
+     "visible": ["resume_text", "platforms", "contact_source", "goal", "past_pitches"],
+     "problems": []},
+    {"name": "no more files than max",
+     "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "find_companies", "past_pitches": ["https://x.test/a.pdf", "https://x.test/b.pdf", "https://x.test/c.pdf"]},
+     "visible": ["resume_text", "platforms", "contact_source", "goal", "past_pitches"],
+     "problems": ["past_pitches"]},
+    {"name": "several files are a list, not one link",
+     "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "find_companies", "past_pitches": "https://x.test/a.pdf"},
+     "visible": ["resume_text", "platforms", "contact_source", "goal", "past_pitches"],
+     "problems": ["past_pitches"]},
+    {"name": "min files asks for at least one",
+     "answers": {"resume_text": "cv", "platforms": ["x"], "goal": "find_companies"},
+     "visible": ["resume_text", "platforms", "contact_source", "goal", "past_pitches"],
+     "problems": ["past_pitches"]}
   ]
 }

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/gravity_schema/specs.py

@@ -35,12 +35,16 @@ class InputType(str, Enum):
     # An API key or password. The platform seals it with KMS when it is submitted, keeps it
     # out of every API response and log, and opens it only to hand it to the running agent.
     SECRET = "secret"
-    # The agent gets a short-lived URL it fetches through the gateway.
+    # The agent gets a short-lived URL it fetches through the gateway; with `max`, a list of them (several files).
     FILE = "file"
     # Several of `options`; the value is a list.
     MULTI_SELECT = "multi-select"
     # One of this agent's declared `actions`; the chosen action runs (rules.py).
     ACTION_CHOICE = "action-choice"
+    # A Google Doc or Sheet of the person's: they paste its link, the agent gets the file id (rules.google_file_id),
+    # which is what docs.read and sheets.read take.
+    GOOGLE_DOC = "google-doc"
+    GOOGLE_SHEET = "google-sheet"
 
 
 # Which Python types each input's `default` may be.
@@ -57,6 +61,8 @@ _PYTHON_TYPES: dict[InputType, tuple[type, ...]] = {
     InputType.FILE: (),  # never has a default
     InputType.MULTI_SELECT: (list,),
     InputType.ACTION_CHOICE: (str,),
+    InputType.GOOGLE_DOC: (str,),
+    InputType.GOOGLE_SHEET: (str,),
 }
 
 # A `show_if` value: what the named input or slot must be for this question to be asked.
@@ -86,7 +92,9 @@ class Renderer(str, Enum):
     MARKDOWN = "markdown"
     DOCX = "docx"
     PPTX = "pptx"
-    ROWS = "rows"
+    PDF = "pdf"
+    ROWS = "rows"  # CSV of the first table
+    XLSX = "xlsx"  # every table a sheet
 
 
 class WebhookSource(str, Enum):
@@ -204,7 +212,8 @@ class InputSpec(BaseModel):
     default: Any | None = None
     # Asked only when every named earlier input or slot has one of the given values (rules.py).
     show_if: Annotated[ShowIf | None, Field(max_length=C.MAX_INPUTS)] = None
-    # multi-select only: how many options may be picked.
+    # multi-select: how many options may be picked. date: how many days; with `max` the answer is a list of
+    # "YYYY-MM-DD" days, picked on a calendar. file: how many files; with `max` the answer is a list of links.
     min: Annotated[int | None, Field(ge=0, le=C.MAX_OPTIONS)] = None
     max: Annotated[int | None, Field(ge=1, le=C.MAX_OPTIONS)] = None
     # action-choice only: the declared actions offered, in order.
@@ -253,14 +262,40 @@ class InputSpec(BaseModel):
             )
         return self
 
+    @property
+    def many_days(self) -> bool:
+        """A date input that takes several days: its answer is a list of "YYYY-MM-DD"."""
+        return self.type is InputType.DATE and self.max is not None
+
+    @property
+    def many_files(self) -> bool:
+        """A file input that takes several files: its answer is a list of links, one per file."""
+        return self.type is InputType.FILE and self.max is not None
+
     @model_validator(mode="after")
     def _check_choice_fields(self) -> InputSpec:
         multi = self.type is InputType.MULTI_SELECT
-        if (self.min is not None or self.max is not None) and not multi:
+        if (self.min is not None or self.max is not None) and not (multi or self.type in (InputType.DATE, InputType.FILE)):
+            raise PydanticCustomError(
+                ErrorCode.INVALID_INPUT.value,
+                "Input '{value}' sets min or max but is not a multi-select, a date or a file.",
+                {"value": self.name, "remediation": "Set type to 'multi-select', 'date' or 'file', or remove min and max."},
+            )
+        file_bounds = self.type is InputType.FILE and (self.min is not None or self.max is not None)
+        if file_bounds and (self.max is None or (self.min or 0) > self.max or self.max > C.MAX_FILES):
             raise PydanticCustomError(
                 ErrorCode.INVALID_INPUT.value,
-                "Input '{value}' sets min or max but is not a multi-select.",
-                {"value": self.name, "remediation": "Set type to 'multi-select', or remove min and max."},
+                "File input '{value}' asks for between {lo} and {hi} files.",
+                {"value": self.name, "lo": self.min or 0, "hi": self.max,
+                 "remediation": f"Set `max` (how many files may be uploaded, at most {C.MAX_FILES}), and keep min <= max."},
+            )
+        days_bounds = self.type is InputType.DATE and (self.min is not None or self.max is not None)
+        if days_bounds and (self.max is None or (self.min or 0) > self.max):
+            raise PydanticCustomError(
+                ErrorCode.INVALID_INPUT.value,
+                "Date input '{value}' asks for between {lo} and {hi} days.",
+                {"value": self.name, "lo": self.min or 0, "hi": self.max,
+                 "remediation": "Set `max` (how many days may be picked), and keep min <= max."},
             )
         if multi:
             count = len(self.options or [])
@@ -344,7 +379,7 @@ class InputSpec(BaseModel):
                 },
             )
 
-        expected = _PYTHON_TYPES[self.type]
+        expected = (list,) if self.many_days else _PYTHON_TYPES[self.type]
         # bool is an int subclass, so NUMBER needs this guard.
         is_bool = isinstance(self.default, bool)
         ok = (
@@ -451,6 +486,16 @@ class ScheduleSpec(BaseModel):
         return v
 
 
+class EmailTriggerSpec(BaseModel):
+    """Run when new mail matching a Gmail search arrives in the person's inbox. Gravity checks every 5 minutes and
+    starts a run only when there is new mail, with the messages in inputs["event"]["emails"]."""
+
+    model_config = _STRICT
+
+    query: Annotated[str, Field(min_length=1, max_length=500)]  # a Gmail search: "from:recruiting@acme.com is:unread"
+    consumer_can_change: bool = True
+
+
 class TriggersSpec(BaseModel):
     """What starts a run. Declared so the consumer sees it before installing."""
 
@@ -459,14 +504,15 @@ class TriggersSpec(BaseModel):
     manual: bool = True
     schedule: ScheduleSpec | None = None
     webhook: list[WebhookSource] = Field(default_factory=list)
+    email: EmailTriggerSpec | None = None
 
     @model_validator(mode="after")
     def _check_something_starts_it(self) -> TriggersSpec:
-        if not self.manual and self.schedule is None and not self.webhook:
+        if not self.manual and self.schedule is None and not self.webhook and self.email is None:
             raise PydanticCustomError(
                 ErrorCode.INVALID_TRIGGER.value,
                 "Nothing can start this agent.",
-                {"remediation": "Set manual: true, or add a schedule or a webhook."},
+                {"remediation": "Set manual: true, or add a schedule, an email trigger or a webhook."},
             )
         return self
 
@@ -536,6 +582,15 @@ class ChartHint(BaseModel):
     )
 
 
+class TabHint(BaseModel):
+    """One tab of the result, as the agent's page in Explore lists it: its name and what is on it."""
+
+    model_config = _HINT
+
+    name: Annotated[str, Field(max_length=C.MAX_NAME_LENGTH)]
+    about: Annotated[str, Field(max_length=C.MAX_LABEL_LENGTH)] | None = None
+
+
 class DisplaySpec(BaseModel):
     """How the run's result shows on the page, when the builder wants to say so.
 
@@ -546,6 +601,8 @@ class DisplaySpec(BaseModel):
         view:  document | report | table | chart | code | files
         field: the result key that is the main thing to show
         chart: {type: line | bar, x: date, y: [reach, likes]}
+        tabs:  [{name: Overview, about: "Your best options and what they cost"}], the
+               result's tabs in order, listed on the agent's page before anyone runs it
     """
 
     model_config = _HINT
@@ -553,6 +610,7 @@ class DisplaySpec(BaseModel):
     view: Annotated[str, Field(max_length=C.MAX_NAME_LENGTH)] | None = None
     field: Annotated[str, Field(max_length=C.MAX_NAME_LENGTH)] | None = None
     chart: ChartHint | None = None
+    tabs: Annotated[list[TabHint], Field(max_length=12)] = Field(default_factory=list)
 
 
 class ChooseOneSpec(BaseModel):

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/pyproject.toml

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

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/schema/manifest.schema.json

@@ -301,7 +301,7 @@
       "type": "object"
     },
     "DisplaySpec": {
-      "description": "How the run's result shows on the page, when the builder wants to say so.\n\nA hint, not a rule: without it the page reads the result's own shape, and a\nvalue the page doesn't know (a typo, a newer view) is ignored the same way,\nso it never fails a push or a run.\n\n    view:  document | report | table | chart | code | files\n    field: the result key that is the main thing to show\n    chart: {type: line | bar, x: date, y: [reach, likes]}",
+      "description": "How the run's result shows on the page, when the builder wants to say so.\n\nA hint, not a rule: without it the page reads the result's own shape, and a\nvalue the page doesn't know (a typo, a newer view) is ignored the same way,\nso it never fails a push or a run.\n\n    view:  document | report | table | chart | code | files\n    field: the result key that is the main thing to show\n    chart: {type: line | bar, x: date, y: [reach, likes]}\n    tabs:  [{name: Overview, about: \"Your best options and what they cost\"}], the\n           result's tabs in order, listed on the agent's page before anyone runs it",
       "properties": {
         "chart": {
           "anyOf": [
@@ -327,6 +327,14 @@
           "default": null,
           "title": "Field"
         },
+        "tabs": {
+          "items": {
+            "$ref": "#/$defs/TabHint"
+          },
+          "maxItems": 12,
+          "title": "Tabs",
+          "type": "array"
+        },
         "view": {
           "anyOf": [
             {
@@ -344,6 +352,28 @@
       "title": "DisplaySpec",
       "type": "object"
     },
+    "EmailTriggerSpec": {
+      "additionalProperties": false,
+      "description": "Run when new mail matching a Gmail search arrives in the person's inbox. Gravity checks every 5 minutes and\nstarts a run only when there is new mail, with the messages in inputs[\"event\"][\"emails\"].",
+      "properties": {
+        "consumer_can_change": {
+          "default": true,
+          "title": "Consumer Can Change",
+          "type": "boolean"
+        },
+        "query": {
+          "maxLength": 500,
+          "minLength": 1,
+          "title": "Query",
+          "type": "string"
+        }
+      },
+      "required": [
+        "query"
+      ],
+      "title": "EmailTriggerSpec",
+      "type": "object"
+    },
     "InputSpec": {
       "additionalProperties": false,
       "description": "One value the consumer supplies. Renders as one form field.",
@@ -523,7 +553,9 @@
         "secret",
         "file",
         "multi-select",
-        "action-choice"
+        "action-choice",
+        "google-doc",
+        "google-sheet"
       ],
       "title": "InputType",
       "type": "string"
@@ -1034,7 +1066,9 @@
         "markdown",
         "docx",
         "pptx",
-        "rows"
+        "pdf",
+        "rows",
+        "xlsx"
       ],
       "title": "Renderer",
       "type": "string"
@@ -1339,10 +1373,49 @@
       "title": "StateSpec",
       "type": "object"
     },
+    "TabHint": {
+      "description": "One tab of the result, as the agent's page in Explore lists it: its name and what is on it.",
+      "properties": {
+        "about": {
+          "anyOf": [
+            {
+              "maxLength": 200,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "About"
+        },
+        "name": {
+          "maxLength": 64,
+          "title": "Name",
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "title": "TabHint",
+      "type": "object"
+    },
     "TriggersSpec": {
       "additionalProperties": false,
       "description": "What starts a run. Declared so the consumer sees it before installing.",
       "properties": {
+        "email": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/EmailTriggerSpec"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "manual": {
           "default": true,
           "title": "Manual",

{gravity_cli-0.9.0 → gravity_cli-0.11.0}/packages/gravity-schema/tests/test_manifest.py

@@ -765,6 +765,14 @@ def test_display_hint_parses(manifest_data):
     assert (d.view, d.field, d.chart.x, d.chart.y) == ("chart", "daily", "date", ["reach"])
 
 
+def test_display_tabs_parse_and_survive_the_dump(manifest_data):
+    # The push sends model_dump, so the tabs must be in it for the catalog to list them.
+    manifest_data["display"] = {"tabs": [{"name": "Overview", "about": "Your best options"}, {"name": "Money"}]}
+    d = validate_manifest(manifest_data).display
+    assert [t.name for t in d.tabs] == ["Overview", "Money"]
+    assert validate_manifest(manifest_data).model_dump(mode="json", exclude_none=True)["display"]["tabs"][0] == {"name": "Overview", "about": "Your best options"}
+
+
 def test_display_never_fails_on_what_the_page_does_not_know(manifest_data):
     # An unknown view is kept for the page to ignore; an unknown key is dropped.
     manifest_data["display"] = {"view": "carousel", "colour": "blue"}