teardrop-cli 0.1.0__tar.gz

teardrop_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,50 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install hatch
+        run: pip install hatch
+
+      - name: Build package
+        run: hatch build
+
+      - name: Store distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/teardrop-cli
+    permissions:
+      id-token: write  # trusted publisher (OIDC)
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

teardrop_cli-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,38 @@
+name: Test
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: ["**"]
+
+jobs:
+  test:
+    name: "py${{ matrix.python-version }} / ${{ matrix.os }}"
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Format
+        run: ruff format src/ tests/
+
+      - name: Lint
+        run: ruff check src/ tests/ --fix
+
+      - name: Test
+        run: pytest --tb=short -q

teardrop_cli-0.1.0/.gitignore

@@ -0,0 +1,211 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Local Skills (Disable if needed)
+.github/skills/
+prompts/

teardrop_cli-0.1.0/.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+  "python.defaultInterpreterPath": "${workspaceFolder}/venv/Scripts/python.exe",
+  "python.analysis.extraPaths": ["${workspaceFolder}/src"]
+}

teardrop_cli-0.1.0/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.

teardrop_cli-0.1.0/PKG-INFO

@@ -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`).