teardrop-cli 0.3.0__tar.gz → 0.3.3__tar.gz

{teardrop_cli-0.3.0 → teardrop_cli-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: teardrop-cli
-Version: 0.3.0
+Version: 0.3.3
 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
@@ -45,7 +45,7 @@ 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.2.0
+Requires-Dist: teardrop-sdk>=0.3.2
 Requires-Dist: tomli-w>=1.0
 Requires-Dist: typer>=0.12
 Provides-Extra: dev
@@ -86,21 +86,27 @@ 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:
+The wizard walks you through sign-in, optional BYOK LLM setup, and your first agent run or scaffolded tool:
 
 ```bash
 teardrop quickstart
 ```
 
+Quickstart keeps local tool scaffolding and public marketplace browsing available
+without sign-in. A saved session is verified when you choose an agent run; if it
+is stale, the wizard offers sign-in again before asking for a prompt or payment
+confirmation. Environment credentials must be updated or unset when they are
+rejected because they take precedence over interactive login.
+
 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
 
+# Wallet-first (no email needed) — generates a wallet on first run if you don't have one
+teardrop auth login --siwe --generate-wallet
+
 # Already have an account
 teardrop auth login --email you@example.com
 ```
@@ -143,7 +149,7 @@ 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 probe --from-file tool.json  # test webhook health before publishing
 teardrop tools publish --from-file tool.json \
     --settlement-wallet 0xYourChecksumAddress
 ```
@@ -156,7 +162,7 @@ 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.
+Test a local webhook before publishing with `teardrop tools probe --from-file tool.json`; the spec's method and auth settings are used by default. After publishing, use `teardrop tools probe <tool-name>`. Pass `--auth-header-name` and `--auth-header-value` to override auth settings, 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).
 
@@ -295,6 +301,12 @@ 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.
 
+### LLM credit model
+
+Non-BYOK organizations use Teardrop's shared provider keys. Platform credits or x402 cover the model token costs and Teardrop platform fee. BYOK organizations pay their model provider directly through their own encrypted key, but still need platform credits or x402 for the Teardrop orchestration fee. BYOK uses the configured model and does not use pooled smart routing.
+
+New email-authenticated organizations may receive optional promotional credit after verifying their email when the program is enabled. Eligibility and availability are server-configured; SIWE users and marketplace author tools are excluded. A real top-up removes promotional restrictions.
+
 ---
 
 ## Browse the Marketplace
@@ -303,6 +315,8 @@ Pipe a key from stdin to keep it out of shell history: `--byok-key -`. See [docs
 teardrop marketplace list
 teardrop marketplace search "weather"
 teardrop marketplace info acme/weather
+teardrop marketplace reputation
+teardrop marketplace reputation acme/weather --json
 teardrop marketplace subscribe acme/weather
 teardrop marketplace subscriptions
 ```

{teardrop_cli-0.3.0 → teardrop_cli-0.3.3}/README.md

@@ -26,21 +26,27 @@ 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:
+The wizard walks you through sign-in, optional BYOK LLM setup, and your first agent run or scaffolded tool:
 
 ```bash
 teardrop quickstart
 ```
 
+Quickstart keeps local tool scaffolding and public marketplace browsing available
+without sign-in. A saved session is verified when you choose an agent run; if it
+is stale, the wizard offers sign-in again before asking for a prompt or payment
+confirmation. Environment credentials must be updated or unset when they are
+rejected because they take precedence over interactive login.
+
 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
 
+# Wallet-first (no email needed) — generates a wallet on first run if you don't have one
+teardrop auth login --siwe --generate-wallet
+
 # Already have an account
 teardrop auth login --email you@example.com
 ```
@@ -83,7 +89,7 @@ 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 probe --from-file tool.json  # test webhook health before publishing
 teardrop tools publish --from-file tool.json \
     --settlement-wallet 0xYourChecksumAddress
 ```
@@ -96,7 +102,7 @@ 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.
+Test a local webhook before publishing with `teardrop tools probe --from-file tool.json`; the spec's method and auth settings are used by default. After publishing, use `teardrop tools probe <tool-name>`. Pass `--auth-header-name` and `--auth-header-value` to override auth settings, 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).
 
@@ -235,6 +241,12 @@ 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.
 
+### LLM credit model
+
+Non-BYOK organizations use Teardrop's shared provider keys. Platform credits or x402 cover the model token costs and Teardrop platform fee. BYOK organizations pay their model provider directly through their own encrypted key, but still need platform credits or x402 for the Teardrop orchestration fee. BYOK uses the configured model and does not use pooled smart routing.
+
+New email-authenticated organizations may receive optional promotional credit after verifying their email when the program is enabled. Eligibility and availability are server-configured; SIWE users and marketplace author tools are excluded. A real top-up removes promotional restrictions.
+
 ---
 
 ## Browse the Marketplace
@@ -243,6 +255,8 @@ Pipe a key from stdin to keep it out of shell history: `--byok-key -`. See [docs
 teardrop marketplace list
 teardrop marketplace search "weather"
 teardrop marketplace info acme/weather
+teardrop marketplace reputation
+teardrop marketplace reputation acme/weather --json
 teardrop marketplace subscribe acme/weather
 teardrop marketplace subscriptions
 ```

{teardrop_cli-0.3.0 → teardrop_cli-0.3.3}/docs/cli-reference.md

@@ -39,7 +39,7 @@ teardrop auth login --client-id <id> --client-secret <secret>
 teardrop auth login --token <jwt>
 
 # Sign-In With Ethereum (EIP-4361) — pick one source for the key:
-teardrop auth login --siwe                              # interactive hidden prompt
+teardrop auth login --siwe                              # hidden prompt when no other source is supplied
 teardrop auth login --siwe --key-file ./wallet.key      # read once, never persisted
 teardrop auth login --siwe --generate-wallet            # creates a fresh wallet
 TEARDROP_SIWE_PRIVATE_KEY=0x... teardrop auth login --siwe   # CI / non-interactive
@@ -72,8 +72,9 @@ teardrop auth logout               # revoke refresh token + clear stored credent
 | 1 | `TEARDROP_API_KEY` env var (static JWT) |
 | 2 | `TEARDROP_EMAIL` + `TEARDROP_SECRET` env vars |
 | 3 | `TEARDROP_CLIENT_ID` + `TEARDROP_CLIENT_SECRET` env vars |
-| 4 | `access_token` in `~/.teardrop/config.toml` |
-| 5 | System keyring (email + secret, or client credentials) |
+| 4 | System keyring (email + secret, or client credentials) |
+| 5 | `access_token` in `~/.teardrop/config.toml` |
+| 6 | Legacy `auth.token` in `~/.teardrop/config.toml` |
 
 ---
 
@@ -123,17 +124,18 @@ will start a fresh thread.
 
 ## Schedules
 
-Recurring interval-based runs:
+Recurring interval-based runs. Most commands accept `--json` to return raw structured payloads for pipeline automation:
 
 ```bash
 teardrop schedules create \
   --name hourly-briefing \
   --prompt "Summarize open incidents" \
-  --interval-seconds 3600
+  --interval-seconds 3600 \
+  --json
 
-teardrop schedules list
-teardrop schedules get <schedule-id>
-teardrop schedules update <schedule-id> --enabled false
+teardrop schedules list --json
+teardrop schedules get <schedule-id> --json
+teardrop schedules update <schedule-id> --enabled false --json
 teardrop schedules update <schedule-id> --clear-callback-url
 teardrop schedules runs <schedule-id> --limit 50 --json
 teardrop schedules delete <schedule-id>
@@ -150,24 +152,25 @@ Run history output includes: `Run ID`, `Status`, `Cost (USDC)`, `Error Message`,
 
 ## Event Triggers
 
-Reactive runs exposed as signed public webhook endpoints:
+Reactive runs exposed as signed public webhook endpoints. Commands support a `--json` option to output formatted shapes (with creation and rotation payloads securely exposing the one-time dispatch secret):
 
 ```bash
 teardrop event-triggers create \
   --name inbound-orders \
-  --prompt "Validate and process this order payload"
+  --prompt "Validate and process this order payload" \
+  --json
 
-teardrop event-triggers list
-teardrop event-triggers get <trigger-id>
-teardrop event-triggers update <trigger-id> --enabled false
+teardrop event-triggers list --json
+teardrop event-triggers get <trigger-id> --json
+teardrop event-triggers update <trigger-id> --enabled false --json
 teardrop event-triggers update <trigger-id> --callback-url https://example.com/hook
 teardrop event-triggers runs <trigger-id> --limit 50 --json
-teardrop event-triggers rotate-secret <trigger-id>
+teardrop event-triggers rotate-secret <trigger-id> --json
 teardrop event-triggers delete <trigger-id>
 teardrop event-triggers delete <trigger-id> --yes
 ```
 
-`create` and `rotate-secret` display the signing secret once. Store it immediately; subsequent `list` and `get` calls do not return the plaintext secret.
+`create` and `rotate-secret` display the signing secret once (both inside non-JSON stderr summaries and their corresponding use-once JSON attributes). Store it immediately; subsequent `list`, `get`, or `update` calls permanently exclude the plaintext secret.
 
 Non-JSON list output includes: `ID`, `Name`, `Enabled`, `Kind`, `Consecutive Failures`, `Last Run At`.
 
@@ -189,10 +192,16 @@ teardrop usage --json
 
 The CLI does not support direct top-ups. To add credits or manage your billing methods, please visit the dashboard:
 
-[https://teardrop.dev/billing](https://teardrop.dev/billing)
+[https://teardrop.dev](https://teardrop.dev)
 
 If you run out of credits during an agent run, the agent will pause and provide this link.
 
+### LLM credit model
+
+Non-BYOK organizations use Teardrop's shared provider keys and need credits or x402 for model token costs plus the platform fee. BYOK organizations pay their provider directly through their encrypted key, but still need credits or x402 for the Teardrop orchestration fee. BYOK uses the configured model; pooled smart routing is disabled.
+
+Optional promotional credit may be granted after successful email verification when the server-side program is enabled. It is not available to SIWE users or marketplace author tools, and a real top-up removes promotional restrictions. The CLI does not assume eligibility or a fixed promotional amount.
+
 ---
 
 ## Tool Management
@@ -264,7 +273,13 @@ teardrop tools delete get_weather --yes              # skip confirmation
 
 ### Test webhook health
 
-Before publishing or after updating a webhook URL, test it:
+Before publishing, test a local spec without authentication or an API lookup:
+
+```bash
+teardrop tools probe --from-file tool.json
+```
+
+After publishing or updating a webhook URL, test the registered tool:
 
 ```bash
 teardrop tools probe get_weather                    # test default POST request
@@ -287,6 +302,8 @@ teardrop tools probe get_weather --method GET
 teardrop tools probe get_weather --payload '{"test": "data"}'
 ```
 
+For `--from-file`, the spec's `webhook_method`, `auth_header_name`, and `auth_header_value` are used by default. Explicit probe flags override them.
+
 Exit code: 0 on success (2xx–3xx), 1 on timeout/5xx/connection error. Warning (exit 0) on 4xx responses (e.g., auth failures).
 
 ---
@@ -298,6 +315,8 @@ teardrop marketplace list
 teardrop marketplace list --category data --json
 teardrop marketplace search "weather"
 teardrop marketplace info acme/weather
+teardrop marketplace reputation
+teardrop marketplace reputation acme/weather --json
 teardrop marketplace subscribe acme/weather
 teardrop marketplace subscribe acme/weather --yes    # skip confirmation
 teardrop marketplace subscriptions
@@ -352,7 +371,7 @@ teardrop llm-config set \
   --timeout-seconds 60
 ```
 
-**Providers:** `openrouter`, `google`, `anthropic`
+**Providers:** `openrouter`, `google`, `anthropic`, `openai`
 **Routing:** `default` · `cost` · `speed` · `quality`
 **Validation:** temperature 0.0–2.0 · max tokens 1–200,000 · timeout ≥ 1 s
 
@@ -373,6 +392,8 @@ Get-Content "$key_file" | teardrop llm-config set `
 teardrop llm-config set --provider anthropic --model claude-sonnet-4-6 --clear-key
 ```
 
+BYOK keys are encrypted by the platform and used only for the configured provider/model. Teardrop still charges the orchestration fee through credits or x402; it does not charge Teardrop for the provider's model usage.
+
 ---
 
 ## MCP Servers

{teardrop_cli-0.3.0 → teardrop_cli-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "teardrop-cli"
-version = "0.3.0"
+version = "0.3.3"
 description = "Command-line interface for the Teardrop AI agent platform"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -24,7 +24,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
-    "teardrop-sdk>=0.2.0",
+    "teardrop-sdk>=0.3.2",
     "typer>=0.12",
     "rich>=13.0",
     "platformdirs>=4.0",

{teardrop_cli-0.3.0 → teardrop_cli-0.3.3}/src/teardrop_cli/commands/auth.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import asyncio
 import os
 import re
+import sys
 from datetime import UTC, datetime
 from pathlib import Path
 from typing import Annotated
@@ -319,7 +320,11 @@ def login(
     print_success(f"Logged in as [bold]{email}[/bold]{org_label}")
 
 
-def interactive_reauthenticate(base_url: str | None = None) -> bool:
+def interactive_reauthenticate(
+    base_url: str | None = None,
+    *,
+    warning_message: str = "Your session expired during this command.",
+) -> bool:
     """Prompt the user to sign in again after an expired session.
 
     Returns ``True`` when authentication completed and the caller should retry,
@@ -328,7 +333,7 @@ def interactive_reauthenticate(base_url: str | None = None) -> bool:
     from teardrop_cli import config
     from teardrop_cli.formatting import console, print_warning
 
-    print_warning("Your session expired during this command.")
+    print_warning(warning_message)
     console.print("\n[bold]Sign in to continue:[/bold]")
     console.print("  [cyan]0[/cyan]  Cancel")
     console.print("  [cyan]1[/cyan]  Email + password [recommended]")
@@ -375,7 +380,7 @@ def _resolve_siwe_private_key(
         try:
             from eth_account import Account
         except ImportError:
-            print_error("eth-account is required.", hint="pip install 'teardrop-cli[siwe]'")
+            print_error("eth-account is required.", hint="pip install teardrop-cli")
             raise typer.Exit(1) from None
         acct = Account.create()
         from rich.panel import Panel
@@ -406,16 +411,21 @@ def _resolve_siwe_private_key(
     if env_key := os.environ.get("TEARDROP_SIWE_PRIVATE_KEY"):
         return env_key, False
 
-    print_error(
-        "No Ethereum private key found.",
-        hint=(
-            "Provide one via:\n"
-            "  • TEARDROP_SIWE_PRIVATE_KEY env var\n"
-            "  • --key-file PATH\n"
-            "  • --generate-wallet (creates a new wallet)"
-        ),
+    hint = (
+        "Provide one via:\n"
+        "  • TEARDROP_SIWE_PRIVATE_KEY env var\n"
+        "  • --key-file PATH\n"
+        "  • --generate-wallet (creates a new wallet)"
     )
-    raise typer.Exit(1)
+    if not sys.stdin.isatty():
+        print_error("No Ethereum private key found.", hint=hint)
+        raise typer.Exit(1)
+
+    private_key = typer.prompt("Ethereum private key", hide_input=True).strip()
+    if not private_key:
+        print_error("No Ethereum private key provided.", hint=hint)
+        raise typer.Exit(1)
+    return private_key, False
 
 
 async def _siwe_auth_async(
@@ -452,7 +462,9 @@ async def _siwe_auth_async(
 
     async with AsyncTeardropClient(url) as client:
         nonce_resp = await client.get_siwe_nonce()
-        nonce = nonce_resp.get("nonce", nonce_resp.get("value", ""))
+        # get_siwe_nonce() returns a SiweNonceResponse pydantic model (nonce: str),
+        # not a dict — access the attribute directly.
+        nonce = nonce_resp.nonce
 
         from urllib.parse import urlparse
 

{teardrop_cli-0.3.0 → teardrop_cli-0.3.3}/src/teardrop_cli/commands/marketplace.py

@@ -240,6 +240,80 @@ def info(
         data_console.print_json(json.dumps(schema, default=str))
 
 
+# ---------------------------------------------------------------------------
+# reputation
+# ---------------------------------------------------------------------------
+
+
+@app.command()
+def reputation(
+    qualified_name: Annotated[
+        str | None,
+        typer.Argument(metavar="ORG/TOOL", help="Optional qualified tool name filter."),
+    ] = None,
+    as_json: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
+    base_url: Annotated[str | None, typer.Option("--base-url", hidden=True)] = None,
+) -> None:
+    """Show public reputation metrics for marketplace tools (no auth required)."""
+    from teardrop_cli import config
+    from teardrop_cli.formatting import data_console, print_error, print_json, print_table, spinner
+
+    client = config.get_client(base_url, require_auth=False)
+
+    async def _fetch() -> dict:
+        try:
+            response = await client.get_public_reputation()
+            return response.model_dump() if hasattr(response, "model_dump") else dict(response)
+        finally:
+            await client.close()
+
+    with spinner("Fetching public reputation…"):
+        data = asyncio.run(_fetch())
+
+    tools = data.get("tools", [])
+    if qualified_name is not None:
+        tools = [tool for tool in tools if tool.get("qualified_tool_name") == qualified_name]
+        if not tools:
+            print_error(f"No public reputation found for {qualified_name!r}.")
+            raise typer.Exit(1)
+        data["tools"] = tools
+
+    if as_json:
+        print_json(data)
+        return
+
+    if not tools:
+        data_console.print("[dim]No public reputation data available.[/dim]")
+        return
+
+    data_console.print(
+        f"Schema: {data.get('schema_version', '—')}  |  "
+        f"Generated: {data.get('generated_at') or '—'}  |  "
+        f"Methodology: {data.get('methodology_url') or '—'}"
+    )
+
+    rows = [
+        [
+            tool.get("qualified_tool_name", "—"),
+            (
+                f"score={tool.get('reputation_score', '—')}  "
+                f"success={tool.get('success_rate', '—')}  "
+                f"sample={tool.get('sample_size', '—')}  "
+                f"confidence={tool.get('confidence', '—')}  "
+                f"freshness={tool.get('freshness', '—')}  "
+                f"latency_ms={tool.get('average_latency_ms', '—')}  "
+                f"callers={tool.get('unique_caller_count', '—')}"
+            ),
+        ]
+        for tool in tools
+    ]
+    print_table(
+        ["Tool", "Metrics"],
+        rows,
+        title="Public Tool Reputation",
+    )
+
+
 # ---------------------------------------------------------------------------
 # subscribe
 # ---------------------------------------------------------------------------