teardrop-cli 0.1.0__py3-none-any.whl

teardrop_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,384 @@
+Metadata-Version: 2.4
+Name: teardrop-cli
+Version: 0.1.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: keyring>=25.0
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: rich>=13.0
+Requires-Dist: teardrop-sdk>=0.1.3
+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'
+Description-Content-Type: text/markdown
+
+# teardrop-cli
+
+Command-line interface for the [Teardrop](https://teardrop.dev) crypto-native AI agent platform. Authenticate, run prompts against agents, manage marketplace earnings, configure MCP servers, and inspect organization tools.
+
+---
+
+## Requirements
+
+- Python ≥ 3.11
+- A Teardrop account (email/password, M2M client credentials, Ethereum wallet, or pre-issued JWT)
+
+---
+
+## Installation
+
+```bash
+pip install teardrop-cli
+```
+
+Verify the installation:
+
+```bash
+teardrop --version
+```
+
+---
+
+## Authentication
+
+Credentials are resolved in this priority order at runtime:
+
+| Priority | Source |
+|----------|--------|
+| 1 | `TEARDROP_TOKEN` env var (static JWT) |
+| 2 | `TEARDROP_EMAIL` + `TEARDROP_SECRET` env vars |
+| 3 | `TEARDROP_CLIENT_ID` + `TEARDROP_CLIENT_SECRET` env vars |
+| 4 | System keyring |
+| 5 | Config file (`~/.config/teardrop/config.toml`) |
+
+### Login flows
+
+```bash
+# Email + password (interactive prompts if flags omitted)
+teardrop auth login --email user@example.com --secret ••••
+
+# Machine-to-machine (client credentials)
+teardrop auth login --client-id <id> --client-secret <secret>
+
+# Sign-In With Ethereum (EIP-4361)
+# On macOS/Linux:
+export TEARDROP_SIWE_PRIVATE_KEY=0x<private-key>
+# On Windows (PowerShell):
+$env:TEARDROP_SIWE_PRIVATE_KEY = "0x<private-key>"
+# Then:
+teardrop auth login --siwe
+
+# Pre-issued JWT
+teardrop auth login --token <jwt>
+```
+
+```bash
+teardrop auth whoami            # show current identity
+teardrop auth whoami --json     # as JSON
+teardrop auth logout            # clear all stored credentials
+```
+
+Override the API endpoint for any command with `--base-url <url>` (hidden flag).
+
+---
+
+## Billing
+
+```bash
+# Check account balance
+teardrop billing balance
+teardrop billing balance --json
+```
+
+Account balance is used to run agents. When it reaches zero, you'll get `PaymentRequiredError` (exit code 2).
+
+---
+
+## Agent
+
+### Run a prompt
+
+```bash
+teardrop agent run "Summarize the latest ETH gas trends"
+
+# Continue an existing thread
+teardrop agent run "Follow up on that" --thread-id <id>
+
+# Override model
+teardrop agent run "..." --model gpt-4o
+
+# Machine-readable: one JSON object per line (SSE event passthrough)
+teardrop agent run "..." --json
+```
+
+Streaming output renders Markdown live in the terminal. Tool calls are shown inline as they execute. A usage summary (input/output tokens + cost) is printed at the end.
+
+**Exit codes:**
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 2 | Insufficient account balance (`PaymentRequiredError`) — use `teardrop billing balance` to check |
+| 3 | Rate limited (`RateLimitError`) |
+| 5 | Agent stream error |
+| 130 | Interrupted (`Ctrl-C`) |
+
+---
+
+## Marketplace
+
+```bash
+# Current balance
+teardrop marketplace balance
+teardrop marketplace balance --json
+
+# Earnings history
+teardrop marketplace earnings
+teardrop marketplace earnings --limit 50 --cursor <cursor>
+
+# Withdraw USDC
+teardrop marketplace withdraw --amount-usdc 100 --payout-address 0x...
+teardrop marketplace withdraw --amount-usdc 100 --payout-address 0x... --yes   # skip confirm
+
+# Register payout address for marketplace listings
+teardrop marketplace publish --payout-address 0x...
+```
+
+---
+
+## MCP Servers
+
+Manage Model Context Protocol servers attached to your organization.
+
+```bash
+# List registered servers
+teardrop mcp list
+
+# Add a server
+teardrop mcp add --name "my-server" --url https://mcp.example.com
+teardrop mcp add --name "secure" --url https://mcp.example.com \
+    --auth-type bearer --auth-token <token>
+
+# Discover tools exposed by a server
+teardrop mcp discover <server-id>
+
+# Remove a server
+teardrop mcp remove <server-id>
+teardrop mcp remove <server-id> --yes    # skip confirm
+```
+
+---
+
+## Tools
+
+Inspect and dry-run validate organization tools.
+
+```bash
+# List all tools
+teardrop tools list
+teardrop tools list --json
+
+# Show a tool's schema and optionally validate input
+teardrop tools test <tool-id>
+teardrop tools test <tool-id> --input '{"param": "value"}'
+```
+
+`--input` performs local validation: checks required fields are present and types match the schema before any network call.
+
+---
+
+## LLM Configuration
+
+Configure organization-level LLM settings, including model selection, routing preference, and bring-your-own-key (BYOK) support.
+
+```bash
+# Get current config
+teardrop llm-config get org-1
+teardrop llm-config get org-1 --json
+
+# Set config with provider and model
+teardrop llm-config set org-1 \
+  --provider anthropic \
+  --model claude-haiku-4-5-20251001
+
+# Set with routing preference
+teardrop llm-config set org-1 \
+  --provider anthropic \
+  --model claude-haiku-4-5-20251001 \
+  --routing cost
+
+# Set advanced options
+teardrop llm-config set org-1 \
+  --provider openai \
+  --model gpt-4o \
+  --max-tokens 8000 \
+  --temperature 0.7 \
+  --timeout-seconds 60
+
+# Bring-your-own-key (BYOK)
+teardrop llm-config set org-1 \
+  --provider openai \
+  --model gpt-4o \
+  --byok-key $OPENAI_API_KEY
+
+# Read key from stdin (more secure)
+cat $key_file | teardrop llm-config set org-1 \
+  --provider openai \
+  --model gpt-4o \
+  --byok-key -
+
+# Self-hosted model
+teardrop llm-config set org-1 \
+  --provider openai \
+  --model llama2-70b \
+  --api-base https://gpu-cluster.internal.example.com:8000/v1 \
+  --byok-key $LOCAL_TOKEN
+
+# Rotate API key
+teardrop llm-config set org-1 \
+  --provider anthropic \
+  --model claude-sonnet-4-20250514 \
+  --rotate-key
+
+# Delete custom config (revert to global defaults)
+teardrop llm-config delete org-1
+teardrop llm-config delete org-1 --yes    # skip confirm
+```
+
+**Supported providers:** `anthropic`, `openai`, `google`, `openrouter`
+
+**Routing preferences:** `default`, `cost`, `speed`, `quality`
+
+**Validation:**
+- Temperature: 0.0–2.0
+- Max tokens: 1–200,000
+- Timeout: ≥ 1 second
+- API key handling: keys sent only over TLS; warnings shown for insecure practices
+
+**Caching:**
+- Config is cached locally for 5 minutes; use `--no-cache` to force refresh
+
+---
+
+## Models & Benchmarks
+
+View the model catalogue with performance metrics and discover your organization's actual usage.
+
+```bash
+# Public model benchmarks (no auth required)
+teardrop models benchmarks
+teardrop models benchmarks --json
+
+# Organization-scoped metrics (auth required)
+teardrop models benchmarks --org org-1
+teardrop models benchmarks --org org-1 --json
+
+# Bypass cache
+teardrop models benchmarks --no-cache
+teardrop models benchmarks --org org-1 --force-refresh
+```
+
+The public benchmark table shows:
+- Model identifiers and display names
+- Quality tier (1–3)
+- P95 latency (ms)
+- Pricing (cost per 1k tokens in/out)
+- 7-day usage stats (total runs)
+
+Organization-scoped metrics show your org's actual performance:
+- Number of runs
+- Average latency
+- Average cost per run
+- Total cost (7-day sum)
+- Tokens per second
+
+**Caching:**
+- Public benchmarks: 10 minutes local cache
+- Organization benchmarks: always fresh (no cache)
+
+---
+
+## Configuration
+
+The config file lives at the platform-appropriate path (e.g., `~/.config/teardrop/config.toml` on Linux/macOS). It is created automatically on first login and restricted to owner-read (`0o600` on POSIX).
+
+Sensitive secrets (passwords, tokens) are stored in the **system keyring**; only non-secret fields (email, client_id) are written to the config file.
+
+```toml
+# ~/.config/teardrop/config.toml
+base_url = "https://api.teardrop.dev"   # optional override
+```
+
+---
+
+## Development
+
+To contribute to `teardrop-cli`, clone the repository and install in editable mode with dev dependencies:
+
+```bash
+git clone https://github.com/teardrop-ai/teardrop-cli
+cd teardrop-cli
+pip install -e ".[dev]"
+```
+
+Run tests:
+
+```bash
+pytest
+```
+
+Lint and format:
+
+```bash
+ruff check src tests
+ruff format src tests
+```
+
+**Testing utilities** in `src/teardrop_cli/_fixtures.py`:
+- `make_jwt_payload(sub, org, role)` — mock JWT payload
+- `make_sse_events(text)` — mock SSE event sequence (text chunk → usage → done)
+
+All async tests use `asyncio_mode = "auto"` (configured in `pyproject.toml`).

teardrop_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+teardrop_cli/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+teardrop_cli/_fixtures.py,sha256=7k--fmvYIKv5Dads4C97unHobDsqHrKu7anI06_28s0,3765
+teardrop_cli/_lazy.py,sha256=ioeNbKdICjs3fmBf_1XX-4HU6Jp8_9SRZom9KnSlclQ,2127
+teardrop_cli/cli.py,sha256=M5bVFx3uhluNWWuWQIdHibaMBKyy5v0R_L9xVjUmELI,1334
+teardrop_cli/config.py,sha256=jqZvgyNlTnxWvA8mvE9_pdBlUA8suy6vHnPLXfLD3wM,7948
+teardrop_cli/formatting.py,sha256=_gfO2hcn0RUiMxFQmKj4r-JtyOO9Q3b73T1YbSC1CpI,7862
+teardrop_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+teardrop_cli/commands/agent.py,sha256=XE96d1JiBgnd_rnzOFl5KN6OXH-J4YvutReV6t202u4,6145
+teardrop_cli/commands/auth.py,sha256=8XnrNDewOJZQ4ASU-6Mu3wB0s41qYTPViUsodg_a9do,9109
+teardrop_cli/commands/billing.py,sha256=9_bQAnOQef_V5IDbTcXPXPR_ME3N-ld0D-KgIZnu0pQ,1441
+teardrop_cli/commands/llm_config.py,sha256=EH3c01HRvDQufWzPxX7UeXq-mIDwOFXzcnAEQPAboD4,12982
+teardrop_cli/commands/marketplace.py,sha256=iQmzjs20yqGlqkhyMvzl3xbszZQfKuTlRY2XZi5kLiM,6084
+teardrop_cli/commands/mcp.py,sha256=RJzCELbeuMbBdAod9ChnXvChMJaEyZHCbgK8U782PNM,6189
+teardrop_cli/commands/models.py,sha256=Juwlv8-DDH-ThHivLly7AydVrRFVTeIdh72AuHzliow,6149
+teardrop_cli/commands/tools.py,sha256=TiEwbzzJBRUmjmjgBSHJWKwf11-9_CgqVgW_yhRJU44,6005
+teardrop_cli-0.1.0.dist-info/METADATA,sha256=Hyb4wG0vifiPVhiVRyygAnhCRZoBJAkUyKnRmivs7aA,10665
+teardrop_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+teardrop_cli-0.1.0.dist-info/entry_points.txt,sha256=qsy4xScMDnM_fR4J_KxGrsRCesrz8t-lpCmMkWR5XDc,50
+teardrop_cli-0.1.0.dist-info/licenses/LICENSE,sha256=QQTEU1DIf_IFEVVGnv3ET-CkGg6-tPOtj4lSwkSCwO8,1068
+teardrop_cli-0.1.0.dist-info/RECORD,,

teardrop_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

teardrop_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+teardrop = teardrop_cli.cli:app

teardrop_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+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.