gravity-cli 0.5.4__tar.gz → 0.5.6__tar.gz

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.5
 Name: gravity-cli
-Version: 0.5.4
+Version: 0.5.6
 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.5.4
+Requires-Dist: gravity-schema==0.5.6
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: keyring>=25.0.0
 Requires-Dist: python-dotenv>=1.0.0
@@ -792,6 +792,7 @@ Real tools act on a connected account. Connect one with `gravity-gateway connect
 
 ## What's new
 
+- **0.5.5** `manifest.yaml` takes an optional `display:` hint for how a run's result shows: `view` (document, report, table, chart, code or files), `field` (the result key to show) and `chart` (`type: line` or `bar`, `x`, and up to three `y` fields). It is a hint, never a rule: an unknown view or key is ignored, so it never fails a push. 0.5.4 and earlier refuse a manifest that has it.
 - **0.5.4** `gravity agents` shows each agent's review: a REVIEW column (not submitted, submitted, approved, rejected), and under "From the Gravity team" the reviewer's notes and what to do next. An agent the Gravity team turned off shows as `off` with the reason. UPDATED reads "3 min ago" instead of a timestamp, and status and review are coloured. Also, from a full audit of every command: `gravity --version`. Clear messages instead of tracebacks for: a proxy or sign-in page answering instead of Gravity, a refused `GRAVITY_API_TOKEN` or `GRAVITY_DEV_TOKEN`, an expired sign-in code, a non-UTF-8 manifest, an out-of-range `--port`, a missing agent folder, a malformed session file. `gravity validate` now refuses what the build would refuse: a `graph` that is not an async factory, `os.environ` or `asyncio.run` at import, relative imports, unquoted `python: 3.12`, schedules faster than every 5 minutes or with both day fields, out-of-range cron fields; it accepts a re-exported `graph`. `gravity agents` shows the review status and failure reasons; `gravity runs` never shortens an id; `gravity logs` never wraps. `gravity push` refuses a bundle over 30 MB or a manifest over 12 KB before uploading, and says why when a failed version is re-pushed. `gravity build` ships `tools_needed.yaml`, leaves dotfiles out, and refuses to build without `requirements.lock`. `gravity adapt` leaves the folder untouched when a model call fails. `gravity schedule` checks inputs before the first tick and runs on Asia/Kolkata like the hosted schedules. `gravity run` deletes `.gravity/payload.json` after the run, warns when no `.venv` is present, and keeps a plain agent's `result`. `gravity connect <app>` refuses on the shared test account instead of attaching your account to it. The builder guide and agent standard describe the real flow (init, validate, run or dev, build, push, review on /app).
 - **0.5.3** `gravity dev` opens a local dashboard for your agent: a form from your manifest, a live timeline, approvals, the result and run history; runs from `gravity run` in the same folder show up in it live, and the other way round. WhatsApp joins the catalog (51 tools; 1,402 across 15 apps including the curated and built-in ones). Agents can return generated images: put them in a corpus section's `images` and they land in the Word, PowerPoint and Markdown outputs. The agent standard now shows how to generate images and embeddings through the gateway. `NEEDS_RECONNECT` on the shared test account tells you to ask Gravity, not to connect your own account.
 - **0.5.2** Jira, Confluence and Notion join the catalog: 1,351 tools across 11 apps. `get_store()` works in local runs, kept in `.gravity/store.json`. Renewing an expired sign-in keeps your gateway token, so `gravity run` keeps working after an hour. Commands start faster: the catalog loads in a quarter of the time.

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/README.md

@@ -775,6 +775,7 @@ Real tools act on a connected account. Connect one with `gravity-gateway connect
 
 ## What's new
 
+- **0.5.5** `manifest.yaml` takes an optional `display:` hint for how a run's result shows: `view` (document, report, table, chart, code or files), `field` (the result key to show) and `chart` (`type: line` or `bar`, `x`, and up to three `y` fields). It is a hint, never a rule: an unknown view or key is ignored, so it never fails a push. 0.5.4 and earlier refuse a manifest that has it.
 - **0.5.4** `gravity agents` shows each agent's review: a REVIEW column (not submitted, submitted, approved, rejected), and under "From the Gravity team" the reviewer's notes and what to do next. An agent the Gravity team turned off shows as `off` with the reason. UPDATED reads "3 min ago" instead of a timestamp, and status and review are coloured. Also, from a full audit of every command: `gravity --version`. Clear messages instead of tracebacks for: a proxy or sign-in page answering instead of Gravity, a refused `GRAVITY_API_TOKEN` or `GRAVITY_DEV_TOKEN`, an expired sign-in code, a non-UTF-8 manifest, an out-of-range `--port`, a missing agent folder, a malformed session file. `gravity validate` now refuses what the build would refuse: a `graph` that is not an async factory, `os.environ` or `asyncio.run` at import, relative imports, unquoted `python: 3.12`, schedules faster than every 5 minutes or with both day fields, out-of-range cron fields; it accepts a re-exported `graph`. `gravity agents` shows the review status and failure reasons; `gravity runs` never shortens an id; `gravity logs` never wraps. `gravity push` refuses a bundle over 30 MB or a manifest over 12 KB before uploading, and says why when a failed version is re-pushed. `gravity build` ships `tools_needed.yaml`, leaves dotfiles out, and refuses to build without `requirements.lock`. `gravity adapt` leaves the folder untouched when a model call fails. `gravity schedule` checks inputs before the first tick and runs on Asia/Kolkata like the hosted schedules. `gravity run` deletes `.gravity/payload.json` after the run, warns when no `.venv` is present, and keeps a plain agent's `result`. `gravity connect <app>` refuses on the shared test account instead of attaching your account to it. The builder guide and agent standard describe the real flow (init, validate, run or dev, build, push, review on /app).
 - **0.5.3** `gravity dev` opens a local dashboard for your agent: a form from your manifest, a live timeline, approvals, the result and run history; runs from `gravity run` in the same folder show up in it live, and the other way round. WhatsApp joins the catalog (51 tools; 1,402 across 15 apps including the curated and built-in ones). Agents can return generated images: put them in a corpus section's `images` and they land in the Word, PowerPoint and Markdown outputs. The agent standard now shows how to generate images and embeddings through the gateway. `NEEDS_RECONNECT` on the shared test account tells you to ask Gravity, not to connect your own account.
 - **0.5.2** Jira, Confluence and Notion join the catalog: 1,351 tools across 11 apps. `get_store()` works in local runs, kept in `.gravity/store.json`. Renewing an expired sign-in keeps your gateway token, so `gravity run` keeps working after an hour. Commands start faster: the catalog loads in a quarter of the time.

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/packages/gravity-schema/gravity_schema/catalog.yaml

@@ -47,6 +47,15 @@
   guarantee: certified
   side_effect: read
 
+- name: web.render
+  slug: FIRECRAWL_SCRAPE
+  toolkit: firecrawl
+  description: render a public web page in a browser and read its main content as markdown, for pages built by JavaScript that web.fetch returns empty. Needs a connected Firecrawl account (gravity connect firecrawl); usage is billed to that account
+  scopes: []
+  breadth: generic
+  guarantee: community
+  side_effect: read
+
 - name: supadata.get_transcript
   slug: null
   toolkit: null
@@ -56,6 +65,24 @@
   guarantee: certified
   side_effect: read
 
+- name: firecrawl.scrape
+  slug: FIRECRAWL_SCRAPE
+  toolkit: firecrawl
+  description: read one web page through Firecrawl (rendered in a browser, with its proxies, from a chosen country) as markdown or raw HTML; for pages that refuse plain HTTP clients. Needs a connected Firecrawl account (gravity connect firecrawl); usage is billed to that account
+  scopes: []
+  breadth: generic
+  guarantee: certified
+  side_effect: read
+
+- name: firecrawl.search
+  slug: FIRECRAWL_SEARCH
+  toolkit: firecrawl
+  description: search the web through Firecrawl and get the top results with their page content, tailored to a country. Needs a connected Firecrawl account (gravity connect firecrawl); usage is billed to that account
+  scopes: []
+  breadth: generic
+  guarantee: certified
+  side_effect: read
+
 - name: gmail.read
   slug: GMAIL_FETCH_EMAILS
   toolkit: gmail

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/packages/gravity-schema/gravity_schema/manifest.py

@@ -14,6 +14,8 @@ from .errors import ErrorCode
 
 # Unknown fields are rejected, so a newer-contract field is reported, not dropped.
 _STRICT = ConfigDict(extra="forbid", str_strip_whitespace=True)
+# Display hints only: an unknown key is dropped rather than refused (DisplaySpec).
+_HINT = ConfigDict(extra="ignore", str_strip_whitespace=True)
 
 
 class InputType(str, Enum):
@@ -517,6 +519,37 @@ class SlotSpec(BaseModel):
         return self
 
 
+class ChartHint(BaseModel):
+    """Which of the records' fields to plot: `x` along the bottom, `y` as the lines or bars."""
+
+    model_config = _HINT
+
+    type: Annotated[str, Field(max_length=C.MAX_NAME_LENGTH)] | None = None  # line | bar
+    x: Annotated[str, Field(max_length=C.MAX_NAME_LENGTH)] | None = None
+    y: Annotated[list[Annotated[str, Field(max_length=C.MAX_NAME_LENGTH)]], Field(max_length=3)] = Field(
+        default_factory=list
+    )
+
+
+class DisplaySpec(BaseModel):
+    """How the run's result shows on the page, when the builder wants to say so.
+
+    A hint, not a rule: without it the page reads the result's own shape, and a
+    value the page doesn't know (a typo, a newer view) is ignored the same way,
+    so it never fails a push or a run.
+
+        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]}
+    """
+
+    model_config = _HINT
+
+    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
+
+
 class Manifest(BaseModel):
     """A complete agent declaration. Structural only: tool existence is checked in validation.py."""
 
@@ -541,6 +574,8 @@ class Manifest(BaseModel):
     kind: AgentKind = AgentKind.INTERACTIVE
     # Empty: the agent returns `result` only.
     outputs: dict[str, OutputSpec] = Field(default_factory=dict)
+    # How the result shows on screen; absent, the page decides from the result itself.
+    display: DisplaySpec | None = None
 
     @field_validator("contract")
     @classmethod

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/packages/gravity-schema/pyproject.toml

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

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/packages/gravity-schema/schema/manifest.schema.json

@@ -26,6 +26,48 @@
       "title": "ApprovalsSpec",
       "type": "object"
     },
+    "ChartHint": {
+      "description": "Which of the records' fields to plot: `x` along the bottom, `y` as the lines or bars.",
+      "properties": {
+        "type": {
+          "anyOf": [
+            {
+              "maxLength": 64,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Type"
+        },
+        "x": {
+          "anyOf": [
+            {
+              "maxLength": 64,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "X"
+        },
+        "y": {
+          "items": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "maxItems": 3,
+          "title": "Y",
+          "type": "array"
+        }
+      },
+      "title": "ChartHint",
+      "type": "object"
+    },
     "DependenciesSpec": {
       "additionalProperties": false,
       "properties": {
@@ -38,6 +80,50 @@
       "title": "DependenciesSpec",
       "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]}",
+      "properties": {
+        "chart": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ChartHint"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "field": {
+          "anyOf": [
+            {
+              "maxLength": 64,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Field"
+        },
+        "view": {
+          "anyOf": [
+            {
+              "maxLength": 64,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "View"
+        }
+      },
+      "title": "DisplaySpec",
+      "type": "object"
+    },
     "InputSpec": {
       "additionalProperties": false,
       "description": "One value the consumer supplies. Renders as one form field.",
@@ -381,6 +467,17 @@
       "title": "Description",
       "type": "string"
     },
+    "display": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/DisplaySpec"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
     "inputs": {
       "items": {
         "$ref": "#/$defs/InputSpec"

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/packages/gravity-schema/tests/test_manifest.py

@@ -739,3 +739,24 @@ def test_a_secret_input_cannot_have_a_default(manifest_data):
     assert "cannot have a default" in str(e.value)
     del manifest_data["inputs"][0]["default"]
     assert validate_manifest(manifest_data).inputs[0].type.value == "secret"
+
+
+# Display hints (same field as the platform's gravity-schema)
+
+
+def test_display_is_optional(manifest_data):
+    assert validate_manifest(manifest_data).display is None
+
+
+def test_display_hint_parses(manifest_data):
+    manifest_data["display"] = {"view": "chart", "field": "daily", "chart": {"type": "line", "x": "date", "y": ["reach"]}}
+    d = validate_manifest(manifest_data).display
+    assert (d.view, d.field, d.chart.x, d.chart.y) == ("chart", "daily", "date", ["reach"])
+
+
+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"}
+    d = validate_manifest(manifest_data).display
+    assert d.view == "carousel"
+    assert "colour" not in d.model_dump()

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "gravity-cli"
-version = "0.5.4"
+version = "0.5.6"
 description = "gravity cli — init, run, and push python agents to the Gravity marketplace"
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE", "NOTICE"]
 requires-python = ">=3.12"
 dependencies = [
-    "gravity-schema==0.5.4",  # released in lockstep: always the same version as this package
+    "gravity-schema==0.5.6",  # released in lockstep: always the same version as this package
     "typer>=0.15.0",
     "httpx>=0.27.0",
     "rich>=13.9.0",

{gravity_cli-0.5.4 → gravity_cli-0.5.6}/uv.lock

@@ -164,7 +164,7 @@ wheels = [
 
 [[package]]
 name = "gravity-cli"
-version = "0.5.4"
+version = "0.5.6"
 source = { editable = "." }
 dependencies = [
     { name = "gravity-schema" },
@@ -201,7 +201,7 @@ dev = [
 
 [[package]]
 name = "gravity-schema"
-version = "0.5.4"
+version = "0.5.6"
 source = { editable = "packages/gravity-schema" }
 dependencies = [
     { name = "pydantic" },