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

teardrop_cli-0.2.0/PKG-INFO

@@ -0,0 +1,297 @@
+Metadata-Version: 2.4
+Name: teardrop-cli
+Version: 0.2.0
+Summary: Command-line interface for the Teardrop AI agent platform
+Project-URL: Homepage, https://github.com/teardrop-ai/teardrop-cli
+Project-URL: Repository, https://github.com/teardrop-ai/teardrop-cli
+Project-URL: Issues, https://github.com/teardrop-ai/teardrop-cli/issues
+Author: teardrop-ai
+License: MIT License
+        
+        Copyright (c) 2026 teardrop-ai
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agent,ai,cli,crypto,teardrop
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: eth-account>=0.13
+Requires-Dist: httpx>=0.27
+Requires-Dist: keyring>=25.0
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: rich>=13.0
+Requires-Dist: teardrop-sdk>=0.1.8
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: hatch>=1.12; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: e2e
+Requires-Dist: pytest-timeout>=2.3; extra == 'e2e'
+Description-Content-Type: text/markdown
+
+# teardrop-cli
+
+The fastest way to **publish a tool, run an agent, and earn USDC** — straight from your terminal.
+
+[Teardrop](https://teardrop.dev) is the crypto-native AI agent platform. Tool authors publish webhooks, get paid per call in USDC, and never touch a dashboard. Agent users run prompts that automatically discover and pay for the right tools.
+
+```bash
+pip install teardrop-cli
+teardrop quickstart        # 60-second guided onboarding
+```
+
+> Already onboarded? Jump to [Run an Agent](#run-an-agent) or [Publish a Tool](#publish-a-tool).
+
+---
+
+## Install
+
+```bash
+pip install teardrop-cli
+teardrop --version
+```
+
+Requires Python ≥ 3.11.
+
+---
+
+## 60-Second Quickstart
+
+The wizard walks you through sign-in, BYOK LLM setup, and your first agent run or scaffolded tool:
+
+```bash
+teardrop quickstart
+```
+
+Prefer the manual path? Pick a sign-in method:
+
+```bash
+# Wallet-first (no email needed) — generates a wallet on first run if you don't have one
+teardrop auth login --siwe --generate-wallet
+
+# Email + password
+teardrop auth signup --email you@example.com --org-name acme
+
+# Already have an account
+teardrop auth login --email you@example.com
+```
+
+Then run your first agent:
+
+```bash
+teardrop run "Summarize the latest ETH gas trends"
+```
+
+---
+
+## Sign In
+
+| Goal | Command |
+|------|---------|
+| Create account & org | `teardrop auth signup` |
+| Generate a new wallet & sign in | `teardrop auth login --siwe --generate-wallet [--save-key]` |
+| Sign in with wallet (existing key) | `teardrop auth login --siwe --key-file wallet.key [--save-key]` |
+| Email + password | `teardrop auth login --email you@example.com` |
+| Pre-issued JWT | `teardrop auth login --token <jwt>` |
+| Invite a team member | `teardrop auth invite colleague@example.com` |
+| Show identity | `teardrop auth status` |
+| Sign out | `teardrop auth logout` |
+
+Private keys are never persisted by the CLI unless you pass ``--save-key``.
+When saved, the key is stored in your OS keyring (never in a config file)
+and can be used for automatic re-authentication when the session token
+expires.  An encrypted keyring backend is required — plaintext fallbacks
+are refused.
+
+For machine-to-machine credentials, env-var precedence, and CI patterns, see [docs/cli-reference.md](docs/cli-reference.md#authentication).
+
+---
+
+## Publish a Tool
+
+Scaffold a starter spec, edit it, and publish:
+
+```bash
+teardrop tools init my_scraper       # writes ./tool.json
+$EDITOR tool.json                    # set webhook_url, schema, price
+teardrop tools probe my_scraper      # test webhook health before publishing
+teardrop tools publish --from-file tool.json \
+    --settlement-wallet 0xYourChecksumAddress
+```
+
+Or run the interactive wizard:
+
+```bash
+teardrop tools publish
+```
+
+Tool name rules: `^[a-z][a-z0-9_]*$`, ≤ 64 chars. Prices are in atomic USDC (6 decimals): `5000` = **$0.005** per call. Settlement wallet is required once before your first payout.
+
+Test your webhook before publishing with `teardrop tools probe <tool-name>`. Optionally pass `--auth-header-name` and `--auth-header-value` if your webhook requires auth, or use `--method` and `--payload` to customize the probe request.
+
+Manage existing tools: `teardrop tools list | info | update | pause | delete | probe`. Full reference: [docs/cli-reference.md](docs/cli-reference.md#tool-management).
+
+---
+
+## Earn
+
+```bash
+teardrop earnings balance            # marketplace balance
+teardrop earnings history            # per-call history
+teardrop earnings withdraw 10.00     # to your settlement wallet
+teardrop earnings withdrawals        # past payouts
+```
+
+On-chain withdrawals typically settle in 1–5 minutes.
+
+---
+
+## Run an Agent
+
+```bash
+teardrop run "What is the current ETH gas price?"
+
+# Continue a thread
+teardrop run "Follow up" --thread <thread-id>
+
+# Pass structured context
+teardrop run "Process this order" --context '{"order_id":"ord_123"}'
+
+# Exclude specific tools
+teardrop run "Summarize news" --exclude platform/web_search
+
+# Estimate cost based on current pricing & config (no run performed)
+teardrop run "Analyze this data" --estimate-cost
+
+# Apply a tool policy from a file
+teardrop run "Execute workflow" --policy-file policy.json
+
+# Machine-readable output
+teardrop run "..." --json --no-stream
+
+# Include UI component data for dashboard export (adds ~60s overhead)
+teardrop run "..." --json --with-ui
+```
+
+Streaming output renders Markdown live with inline tool calls and structured UI components. A token + cost summary prints at the end. By default, CLI output is optimized for scripting and automation (`emit_ui=false`); use `--with-ui` only if you need structured UI component data in the JSON output.
+
+---
+
+## Chat with an Agent
+
+A stateful chat mode that automatically continues the same thread across invocations:
+
+```bash
+teardrop chat "What is the current ETH gas price?"   # auto-creates a thread
+teardrop chat "Follow up on that"                     # continues the same thread
+teardrop chat "Start fresh" --new                     # starts a new conversation
+teardrop chat "Specific thread" --thread thr_abc123   # explicit thread by id
+teardrop chat "..." --json                            # machine-readable output
+```
+
+The active thread id is stored in `~/.teardrop/config.toml` and reused on your next `teardrop chat` call. The thread id is printed after every turn for copy/paste. All run flags (`--context`, `--exclude`, `--policy-file`, `--estimate-cost`, `--with-ui`, `--no-stream`) are supported.
+
+Use `teardrop run` for one-shot, script-friendly calls — use `teardrop chat` for conversational interaction.
+
+---
+
+If a run fails on credit, check your balance and history:
+
+```bash
+teardrop balance             # current credits
+teardrop balance credit-history   # past charges and top-ups
+```
+
+To add credits, visit [teardrop.dev](https://teardrop.dev).
+
+---
+
+## Agent Tools
+
+List all tools visible to your agent (platform, marketplace subscriptions, and your own tools):
+
+```bash
+teardrop agent-tools list
+```
+
+---
+
+## Configure Your LLM
+
+One-shot bring-your-own-key wizard:
+
+```bash
+teardrop llm-config byok
+```
+
+Or set explicitly:
+
+```bash
+# Quality tier (default)
+teardrop llm-config set --provider anthropic --model claude-sonnet-4-6 --routing quality
+
+# Cost tier
+teardrop llm-config set --provider openrouter --model deepseek-chat --routing cost
+
+# Speed tier
+teardrop llm-config set --provider google --model gemini-3-flash --routing speed
+```
+
+Pipe a key from stdin to keep it out of shell history: `--byok-key -`. See [docs/cli-reference.md](docs/cli-reference.md#llm-configuration) for advanced tuning, BYOK details, and benchmarks.
+
+---
+
+## Browse the Marketplace
+
+```bash
+teardrop marketplace list
+teardrop marketplace search "weather"
+teardrop marketplace info acme/weather
+teardrop marketplace subscribe acme/weather
+teardrop marketplace subscriptions
+```
+
+Browsing requires no authentication. Subscribed tools become immediately available to your agents.
+
+---
+
+## Where to Go Next
+
+- **[Full CLI reference](docs/cli-reference.md)** — every flag, env-var precedence, exit codes, M2M auth, MCP servers, models benchmarks, config file, development.
+- **[End-to-end test guide](tests/e2e/README.md)** — running tests against a live API.
+- **[teardrop.dev](https://teardrop.dev)** — platform docs and dashboard.
+
+---
+
+## License
+
+MIT. See [LICENSE](LICENSE).

teardrop_cli-0.2.0/README.md

@@ -0,0 +1,237 @@
+# teardrop-cli
+
+The fastest way to **publish a tool, run an agent, and earn USDC** — straight from your terminal.
+
+[Teardrop](https://teardrop.dev) is the crypto-native AI agent platform. Tool authors publish webhooks, get paid per call in USDC, and never touch a dashboard. Agent users run prompts that automatically discover and pay for the right tools.
+
+```bash
+pip install teardrop-cli
+teardrop quickstart        # 60-second guided onboarding
+```
+
+> Already onboarded? Jump to [Run an Agent](#run-an-agent) or [Publish a Tool](#publish-a-tool).
+
+---
+
+## Install
+
+```bash
+pip install teardrop-cli
+teardrop --version
+```
+
+Requires Python ≥ 3.11.
+
+---
+
+## 60-Second Quickstart
+
+The wizard walks you through sign-in, BYOK LLM setup, and your first agent run or scaffolded tool:
+
+```bash
+teardrop quickstart
+```
+
+Prefer the manual path? Pick a sign-in method:
+
+```bash
+# Wallet-first (no email needed) — generates a wallet on first run if you don't have one
+teardrop auth login --siwe --generate-wallet
+
+# Email + password
+teardrop auth signup --email you@example.com --org-name acme
+
+# Already have an account
+teardrop auth login --email you@example.com
+```
+
+Then run your first agent:
+
+```bash
+teardrop run "Summarize the latest ETH gas trends"
+```
+
+---
+
+## Sign In
+
+| Goal | Command |
+|------|---------|
+| Create account & org | `teardrop auth signup` |
+| Generate a new wallet & sign in | `teardrop auth login --siwe --generate-wallet [--save-key]` |
+| Sign in with wallet (existing key) | `teardrop auth login --siwe --key-file wallet.key [--save-key]` |
+| Email + password | `teardrop auth login --email you@example.com` |
+| Pre-issued JWT | `teardrop auth login --token <jwt>` |
+| Invite a team member | `teardrop auth invite colleague@example.com` |
+| Show identity | `teardrop auth status` |
+| Sign out | `teardrop auth logout` |
+
+Private keys are never persisted by the CLI unless you pass ``--save-key``.
+When saved, the key is stored in your OS keyring (never in a config file)
+and can be used for automatic re-authentication when the session token
+expires.  An encrypted keyring backend is required — plaintext fallbacks
+are refused.
+
+For machine-to-machine credentials, env-var precedence, and CI patterns, see [docs/cli-reference.md](docs/cli-reference.md#authentication).
+
+---
+
+## Publish a Tool
+
+Scaffold a starter spec, edit it, and publish:
+
+```bash
+teardrop tools init my_scraper       # writes ./tool.json
+$EDITOR tool.json                    # set webhook_url, schema, price
+teardrop tools probe my_scraper      # test webhook health before publishing
+teardrop tools publish --from-file tool.json \
+    --settlement-wallet 0xYourChecksumAddress
+```
+
+Or run the interactive wizard:
+
+```bash
+teardrop tools publish
+```
+
+Tool name rules: `^[a-z][a-z0-9_]*$`, ≤ 64 chars. Prices are in atomic USDC (6 decimals): `5000` = **$0.005** per call. Settlement wallet is required once before your first payout.
+
+Test your webhook before publishing with `teardrop tools probe <tool-name>`. Optionally pass `--auth-header-name` and `--auth-header-value` if your webhook requires auth, or use `--method` and `--payload` to customize the probe request.
+
+Manage existing tools: `teardrop tools list | info | update | pause | delete | probe`. Full reference: [docs/cli-reference.md](docs/cli-reference.md#tool-management).
+
+---
+
+## Earn
+
+```bash
+teardrop earnings balance            # marketplace balance
+teardrop earnings history            # per-call history
+teardrop earnings withdraw 10.00     # to your settlement wallet
+teardrop earnings withdrawals        # past payouts
+```
+
+On-chain withdrawals typically settle in 1–5 minutes.
+
+---
+
+## Run an Agent
+
+```bash
+teardrop run "What is the current ETH gas price?"
+
+# Continue a thread
+teardrop run "Follow up" --thread <thread-id>
+
+# Pass structured context
+teardrop run "Process this order" --context '{"order_id":"ord_123"}'
+
+# Exclude specific tools
+teardrop run "Summarize news" --exclude platform/web_search
+
+# Estimate cost based on current pricing & config (no run performed)
+teardrop run "Analyze this data" --estimate-cost
+
+# Apply a tool policy from a file
+teardrop run "Execute workflow" --policy-file policy.json
+
+# Machine-readable output
+teardrop run "..." --json --no-stream
+
+# Include UI component data for dashboard export (adds ~60s overhead)
+teardrop run "..." --json --with-ui
+```
+
+Streaming output renders Markdown live with inline tool calls and structured UI components. A token + cost summary prints at the end. By default, CLI output is optimized for scripting and automation (`emit_ui=false`); use `--with-ui` only if you need structured UI component data in the JSON output.
+
+---
+
+## Chat with an Agent
+
+A stateful chat mode that automatically continues the same thread across invocations:
+
+```bash
+teardrop chat "What is the current ETH gas price?"   # auto-creates a thread
+teardrop chat "Follow up on that"                     # continues the same thread
+teardrop chat "Start fresh" --new                     # starts a new conversation
+teardrop chat "Specific thread" --thread thr_abc123   # explicit thread by id
+teardrop chat "..." --json                            # machine-readable output
+```
+
+The active thread id is stored in `~/.teardrop/config.toml` and reused on your next `teardrop chat` call. The thread id is printed after every turn for copy/paste. All run flags (`--context`, `--exclude`, `--policy-file`, `--estimate-cost`, `--with-ui`, `--no-stream`) are supported.
+
+Use `teardrop run` for one-shot, script-friendly calls — use `teardrop chat` for conversational interaction.
+
+---
+
+If a run fails on credit, check your balance and history:
+
+```bash
+teardrop balance             # current credits
+teardrop balance credit-history   # past charges and top-ups
+```
+
+To add credits, visit [teardrop.dev](https://teardrop.dev).
+
+---
+
+## Agent Tools
+
+List all tools visible to your agent (platform, marketplace subscriptions, and your own tools):
+
+```bash
+teardrop agent-tools list
+```
+
+---
+
+## Configure Your LLM
+
+One-shot bring-your-own-key wizard:
+
+```bash
+teardrop llm-config byok
+```
+
+Or set explicitly:
+
+```bash
+# Quality tier (default)
+teardrop llm-config set --provider anthropic --model claude-sonnet-4-6 --routing quality
+
+# Cost tier
+teardrop llm-config set --provider openrouter --model deepseek-chat --routing cost
+
+# Speed tier
+teardrop llm-config set --provider google --model gemini-3-flash --routing speed
+```
+
+Pipe a key from stdin to keep it out of shell history: `--byok-key -`. See [docs/cli-reference.md](docs/cli-reference.md#llm-configuration) for advanced tuning, BYOK details, and benchmarks.
+
+---
+
+## Browse the Marketplace
+
+```bash
+teardrop marketplace list
+teardrop marketplace search "weather"
+teardrop marketplace info acme/weather
+teardrop marketplace subscribe acme/weather
+teardrop marketplace subscriptions
+```
+
+Browsing requires no authentication. Subscribed tools become immediately available to your agents.
+
+---
+
+## Where to Go Next
+
+- **[Full CLI reference](docs/cli-reference.md)** — every flag, env-var precedence, exit codes, M2M auth, MCP servers, models benchmarks, config file, development.
+- **[End-to-end test guide](tests/e2e/README.md)** — running tests against a live API.
+- **[teardrop.dev](https://teardrop.dev)** — platform docs and dashboard.
+
+---
+
+## License
+
+MIT. See [LICENSE](LICENSE).

teardrop_cli-0.2.0/docs/cli-json-schema.md

@@ -0,0 +1,27 @@
+# Teardrop CLI Agent Run JSON Schema
+
+When running `teardrop run "..." --json` or `teardrop chat "..." --json`,
+the output is a single JSON object (implies `--no-stream`).
+
+## Schema Details
+
+The JSON object contains the following fields:
+
+- `text` (string): The final text response from the agent.
+- `thread_id` (string | null): The ID of the thread used for the run. This can be used with the `--thread` flag in future runs (or `teardrop chat`) to continue the conversation.
+
+## Example Output
+
+```json
+{
+  "text": "The price of ETH is currently $2,450.32.",
+  "thread_id": "thr_abc123"
+}
+```
+
+## Usage
+To capture specific fields, use `jq`:
+```bash
+teardrop run "ETH price" --json | jq -r .text
+teardrop chat "ETH price" --json | jq -r .thread_id
+```