gravity-cli 0.7.0__tar.gz → 0.7.2__tar.gz

{gravity_cli-0.7.0 → gravity_cli-0.7.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.5
 Name: gravity-cli
-Version: 0.7.0
+Version: 0.7.2
 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.7.0
+Requires-Dist: gravity-schema==0.7.2
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: keyring>=25.0.0
 Requires-Dist: python-dotenv>=1.0.0

{gravity_cli-0.7.0 → gravity_cli-0.7.2}/packages/gravity-schema/gravity_schema/catalog.yaml

@@ -56,6 +56,15 @@
   guarantee: community
   side_effect: read
 
+- name: web.fetch_proxied
+  slug: null
+  toolkit: null
+  description: read a public web page or API (GET) through Gravity's rotating proxies, for sites that refuse cloud addresses (Reddit RSS, PullPush, Product Hunt, LinkedIn and X pages); returns the final url, status, content_type and content, HTML as text (format text) or the body as sent (format raw). A blocked page comes back with its status. No account needed; charged to the run's budget
+  scopes: []
+  breadth: generic
+  guarantee: certified
+  side_effect: read
+
 - name: supadata.get_transcript
   slug: null
   toolkit: null
@@ -299,3 +308,84 @@
   breadth: generic
   guarantee: certified
   side_effect: write
+
+- name: forms.create
+  slug: GOOGLEFORMS_CREATE_FORM
+  toolkit: googleforms
+  description: create an empty Google Form with a title in the connected Google account; forms created through the API start unpublished. Add questions with forms.update and open it with forms.publish_settings
+  scopes: [https://www.googleapis.com/auth/forms.body]
+  breadth: generic
+  guarantee: certified
+  side_effect: write
+
+- name: forms.update
+  slug: GOOGLEFORMS_BATCH_UPDATE_FORM
+  toolkit: googleforms
+  description: apply a batch of changes to a Google Form in one atomic call (title, description, settings such as verified email collection, and questions); the API cannot create file-upload questions
+  scopes: [https://www.googleapis.com/auth/forms.body]
+  breadth: generic
+  guarantee: certified
+  side_effect: write
+
+- name: forms.publish_settings
+  slug: GOOGLEFORMS_SET_PUBLISH_SETTINGS
+  toolkit: googleforms
+  description: publish or unpublish a Google Form and turn response collection on or off, for example to close a form at its deadline
+  scopes: [https://www.googleapis.com/auth/forms.body]
+  breadth: generic
+  guarantee: certified
+  side_effect: write
+
+- name: forms.get
+  slug: GOOGLEFORMS_GET_FORM
+  toolkit: googleforms
+  description: read a Google Form's structure, settings, publish state and its responder link
+  scopes: [https://www.googleapis.com/auth/forms.body.readonly]
+  breadth: generic
+  guarantee: certified
+  side_effect: read
+
+- name: forms.list_responses
+  slug: GOOGLEFORMS_LIST_RESPONSES
+  toolkit: googleforms
+  description: list the responses submitted to a Google Form, with paging and an optional filter for responses after a timestamp
+  scopes: [https://www.googleapis.com/auth/forms.responses.readonly]
+  breadth: generic
+  guarantee: certified
+  side_effect: read
+
+- name: hunter.find_email
+  slug: HUNTER_EMAIL_FINDER
+  toolkit: hunter
+  description: find the most likely work email for a person from their name and company domain, with a confidence score; runs on Gravity's account where Composio Instant covers it, charged to the run's budget
+  scopes: []
+  breadth: generic
+  guarantee: community
+  side_effect: read
+
+- name: hunter.verify_email
+  slug: HUNTER_EMAIL_VERIFIER
+  toolkit: hunter
+  description: check whether an email address is deliverable (valid, accept_all, risky or invalid) before writing to it; runs on Gravity's account where Composio Instant covers it, charged to the run's budget
+  scopes: []
+  breadth: generic
+  guarantee: community
+  side_effect: read
+
+- name: exa.search
+  slug: EXA_SEARCH
+  toolkit: exa
+  description: search the web with Exa, including category 'people' (public profiles) and 'personal site' (portfolios); on Gravity's account through Composio Instant only type auto and at most 10 results, without page text (read pages with exa.contents)
+  scopes: []
+  breadth: generic
+  guarantee: community
+  side_effect: read
+
+- name: exa.contents
+  slug: EXA_GET_CONTENTS_ACTION
+  toolkit: exa
+  description: read the text of up to 10 URLs from Exa's index; check each URL's status, because the call succeeds even when a page fails
+  scopes: []
+  breadth: generic
+  guarantee: community
+  side_effect: read

{gravity_cli-0.7.0 → gravity_cli-0.7.2}/packages/gravity-schema/pyproject.toml

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

{gravity_cli-0.7.0 → gravity_cli-0.7.2}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "gravity-cli"
-version = "0.7.0"
+version = "0.7.2"
 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.7.0",  # released in lockstep: always the same version as this package
+    "gravity-schema==0.7.2",  # 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.7.0 → gravity_cli-0.7.2}/src/gravity_cli/CHANGELOG.md

@@ -4,6 +4,16 @@ Shown by `gravity update` and `gravity changelog`, and after an update. Each rel
 then one bullet per change: `- new|improved|fixed: A one-line headline. The detail behind it.`
 Write it for a builder, not for a maintainer. `tests/test_changelog.py` fails a release that has no entry.
 
+## 0.7.2 - 2026-10-23
+
+- new: Google Forms tools. forms.create, forms.update, forms.publish_settings, forms.get and forms.list_responses build a form in the person's own Google account, open it, close it at a deadline and read the responses. The API cannot make file-upload questions, so ask for a link instead.
+- new: hunter.find_email and hunter.verify_email find a work email from a name and a company and check it before anyone writes to it. They run on Gravity's account wherever Composio Instant covers them, charged to the run's budget.
+- new: exa.search and exa.contents search people and personal sites by what they work on (category 'people' or 'personal site') and read the pages found. On Gravity's account: at most 10 results and no page text in the search, so read pages with exa.contents.
+
+## 0.7.1 - 2026-10-23
+
+- new: web.fetch_proxied reads a public page through Gravity's rotating proxies, for sources that refuse cloud addresses (Reddit RSS, PullPush, Product Hunt, LinkedIn profile and post pages, X profiles). No account; a few hundredths of a cent from the run's budget per call.
+
 ## 0.7.0 - 2026-10-23
 
 - new: Questions that apply only sometimes. show_if asks an input only when a slot or an earlier input has a given value, and choose_one makes "upload or paste" an either / or that can be required. gravity run, gravity schedule and gravity dev apply the same rules the platform does on every run.

{gravity_cli-0.7.0 → gravity_cli-0.7.2}/src/gravity_cli/docs/Gravity.agent.md

@@ -490,9 +490,11 @@ Catalog of this release: {{tool_counts}}.
 
 {{curated_tools}}
 
-- `web.search`, `web.fetch` and `example.echo` need no account. `supadata.get_transcript` needs none, but takes the
+- `web.search`, `web.fetch`, `web.fetch_proxied` and `example.echo` need no account. `supadata.get_transcript` needs none, but takes the
   caller's own `api_key` argument: model it as a `secret` input. `web.render` and `firecrawl.*` need a connected
-  Firecrawl account (billed to it).
+  Firecrawl account (billed to it). `hunter.*` and `exa.*` run on Gravity's account where Composio Instant covers
+  them; `forms.*` needs the person's Google account, and forms made through the API start unpublished
+  (`forms.publish_settings` opens and closes them).
 - **Imported tools** are the same apps' other actions, synced from the vendor and unreviewed (guarantee
   `experimental`). Their names are verbose (`github.create_an_issue`, not `github.create_issue`), so look them up:
   `gravity tools github`, or `gravity tools issue`. Any imported tool that **changes something** must be under
@@ -504,6 +506,17 @@ Catalog of this release: {{tool_counts}}.
   and say so. For pages that refuse the sandbox or need JavaScript use `firecrawl.scrape` or `web.render`; cap the
   paid calls per run and degrade to one line under "could not do" when the account is not connected. Do not pass a
   `location` to a render: routing through another country measured 36 s against 8 s.
+- `web.fetch_proxied` GETs a URL through Gravity's rotating proxies, for sources that refuse the sandbox's cloud
+  address: Reddit RSS (`/r/<sub>/search.rss`) and Product Hunt pages answered 200 through it on 23 Oct 2026, PullPush
+  through the same proxies on 15 Oct. It is not a browser and changes no TLS fingerprint: Reddit's HTML and `.json`, Capterra, Glassdoor, G2 and Trustpilot
+  still answer 403. LinkedIn profile and post pages came back 200 with their JSON-LD for 7 of 8 profiles on 23 Oct;
+  some profiles answer LinkedIn's 999 from every address, so confirm a person another way when that happens. X
+  profile pages carry the latest posts with dates and links. A 403, 429 or 999 is tried on up to three proxies. Arguments: `url`, `format` (`text`, the default, turns HTML into lines of text; `raw` returns
+  JSON, XML or RSS as sent), `max_chars` (default 50,000, at most 200,000). It returns `url` (after redirects),
+  `status`, `content_type`, `content`, `truncated`, `attempts`; a 403, 404 or 429 is a result with that status, not
+  an error, so check `status`. Each call costs about $0.0002 from the run's budget, and a run gets at most 200.
+  Private, internal and metadata addresses, ports other than 80/443/8080/8443, and non-http(s) URLs answer
+  `URL_REFUSED`. Prefer it over a `proxy_url` secret input: the person supplies nothing.
 - Outbound HTTPS is open, so code may read public pages and APIs directly (`httpx`, `curl_cffi`). Anything that acts
   on an account still goes through a tool, so the person's connection and approvals apply.
 - Locally, `gravity connect <app>` attaches **your** account to your local runs (`gravity connect` alone lists what
@@ -818,6 +831,7 @@ checkpointing, durable approvals, `gravity.ask()`, action buttons, chains and ou
 | `Fill in the required input(s): …`, `pick one of …` (hosted, 400) | A visible required input is missing, or a dropdown, multi-select or action choice is out of bounds | Check `show_if` and defaults; `gravity run` reports the same |
 | "X needs Y to run first", "X runs once" | An action's `requires` has not completed in the conversation, or a `run_once` one already ran | Expected; the buttons show only what may run |
 | `402 BUDGET_EXCEEDED` | The run spent its model budget | Fewer or smaller calls; `max_tokens`; at most two in flight |
+| `URL_REFUSED`, `FETCH_FAILED`, `PROXY_LIMIT` (`web.fetch_proxied`) | Not a public http(s) URL on a web port; no proxy reached the page (connections or timeouts on three proxies); the run used its 200 proxied fetches | Fix the URL; retry later or degrade to one line under "could not do"; fetch fewer pages |
 | "finished without a result" (`gravity run`), `null` result (hosted) | The final state has no `result` | Return `{"result": ...}` |
 | "could not load the agent" | An import error, a relative import, env read at import, or the graph built at import | Section 5 |
 | Lockfile will not compile | A dependency has no Linux ARM64 wheel | Pick another version or package |

{gravity_cli-0.7.0 → gravity_cli-0.7.2}/uv.lock

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