ivon-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{ivon_cli-0.1.0/src/ivon_cli.egg-info → ivon_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ivon-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: ivon CLI — Meta Ads connector commands + MCP access for the ivon autonomous marketing team
 Author: ivon (LemonTree Media)
 License: Proprietary
@@ -20,7 +20,8 @@ server that powers ivon's agents, wrapped in human-friendly commands.
 ## Install
 
 ```bash
-pip install -e cli/          # from the repo root (or publish to PyPI later)
+pip install ivon-cli         # from PyPI (or pipx install ivon-cli)
+pip install -e cli/          # from the repo root, for development
 ```
 
 ## Login
@@ -38,7 +39,9 @@ revoke all CLI / MCP access.
 ## Meta Ads commands
 
 ```bash
-ivon meta tools                                   # list every MCP tool
+ivon meta tools                                   # list every MCP tool, grouped
+ivon meta tools get_insights                      # one tool: params, defaults + example
+ivon meta tools get_insights --json               # same as JSON Schema (for agents)
 ivon meta accounts                                # your ad accounts
 ivon meta campaigns -a act_123 --status ACTIVE
 ivon meta adsets -a act_123 -c <campaign_id>
@@ -51,6 +54,11 @@ ivon meta call create_campaign -p account_id=act_123 -p name="Spring Sale" \
 `ivon meta call <tool> -p key=value` reaches any tool on the server —
 values parse as JSON when possible (`-p limit=25`, `-p targeting='{"geo_locations":{"countries":["US"]}}'`).
 
+`ivon meta tools` reads a catalog snapshot bundled with the CLI, so discovery
+is instant and works before login; `--refresh` re-fetches from the live
+server. Refresh the bundled snapshot with `scripts/snapshot_cli_tools.py`
+after changing the backend's tool surface.
+
 ## MCP client setup
 
 ```bash

{ivon_cli-0.1.0 → ivon_cli-0.2.0}/README.md

@@ -6,7 +6,8 @@ server that powers ivon's agents, wrapped in human-friendly commands.
 ## Install
 
 ```bash
-pip install -e cli/          # from the repo root (or publish to PyPI later)
+pip install ivon-cli         # from PyPI (or pipx install ivon-cli)
+pip install -e cli/          # from the repo root, for development
 ```
 
 ## Login
@@ -24,7 +25,9 @@ revoke all CLI / MCP access.
 ## Meta Ads commands
 
 ```bash
-ivon meta tools                                   # list every MCP tool
+ivon meta tools                                   # list every MCP tool, grouped
+ivon meta tools get_insights                      # one tool: params, defaults + example
+ivon meta tools get_insights --json               # same as JSON Schema (for agents)
 ivon meta accounts                                # your ad accounts
 ivon meta campaigns -a act_123 --status ACTIVE
 ivon meta adsets -a act_123 -c <campaign_id>
@@ -37,6 +40,11 @@ ivon meta call create_campaign -p account_id=act_123 -p name="Spring Sale" \
 `ivon meta call <tool> -p key=value` reaches any tool on the server —
 values parse as JSON when possible (`-p limit=25`, `-p targeting='{"geo_locations":{"countries":["US"]}}'`).
 
+`ivon meta tools` reads a catalog snapshot bundled with the CLI, so discovery
+is instant and works before login; `--refresh` re-fetches from the live
+server. Refresh the bundled snapshot with `scripts/snapshot_cli_tools.py`
+after changing the backend's tool surface.
+
 ## MCP client setup
 
 ```bash

{ivon_cli-0.1.0 → ivon_cli-0.2.0}/pyproject.toml

@@ -32,7 +32,7 @@ where = ["src"]
 "" = "src"
 
 [tool.setuptools.package-data]
-ivon_cli = ["data/*.md"]
+ivon_cli = ["data/*.md", "_tools_snapshot.json"]
 
 [tool.setuptools.dynamic]
 version = {attr = "ivon_cli.__version__"}

ivon_cli-0.2.0/src/ivon_cli/__init__.py

@@ -0,0 +1,3 @@
+"""ivon CLI."""
+
+__version__ = "0.2.0"