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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: teardrop-cli
-Version: 0.2.0
+Version: 0.3.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
@@ -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.1.8
+Requires-Dist: teardrop-sdk>=0.2.0
 Requires-Dist: tomli-w>=1.0
 Requires-Dist: typer>=0.12
 Provides-Extra: dev
@@ -206,6 +206,33 @@ Streaming output renders Markdown live with inline tool calls and structured UI
 
 ---
 
+## Automate Runs
+
+Use interval schedules for recurring prompts and event triggers for inbound webhooks:
+
+```bash
+teardrop schedules create \
+    --name hourly-briefing \
+    --prompt "Summarize open incidents" \
+    --interval-seconds 3600
+
+teardrop schedules list
+teardrop schedules runs <schedule-id>
+
+teardrop event-triggers create \
+    --name inbound-orders \
+    --prompt "Validate and process this order payload"
+
+teardrop event-triggers runs <trigger-id>
+teardrop event-triggers rotate-secret <trigger-id>
+```
+
+`event-triggers create` and `event-triggers rotate-secret` print the signing secret once. Store it immediately.
+
+Full reference: [docs/cli-reference.md](docs/cli-reference.md#schedules) and [docs/cli-reference.md](docs/cli-reference.md#event-triggers).
+
+---
+
 ## Chat with an Agent
 
 A stateful chat mode that automatically continues the same thread across invocations:

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

@@ -146,6 +146,33 @@ Streaming output renders Markdown live with inline tool calls and structured UI
 
 ---
 
+## Automate Runs
+
+Use interval schedules for recurring prompts and event triggers for inbound webhooks:
+
+```bash
+teardrop schedules create \
+    --name hourly-briefing \
+    --prompt "Summarize open incidents" \
+    --interval-seconds 3600
+
+teardrop schedules list
+teardrop schedules runs <schedule-id>
+
+teardrop event-triggers create \
+    --name inbound-orders \
+    --prompt "Validate and process this order payload"
+
+teardrop event-triggers runs <trigger-id>
+teardrop event-triggers rotate-secret <trigger-id>
+```
+
+`event-triggers create` and `event-triggers rotate-secret` print the signing secret once. Store it immediately.
+
+Full reference: [docs/cli-reference.md](docs/cli-reference.md#schedules) and [docs/cli-reference.md](docs/cli-reference.md#event-triggers).
+
+---
+
 ## Chat with an Agent
 
 A stateful chat mode that automatically continues the same thread across invocations:

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

@@ -0,0 +1,130 @@
+# 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
+```
+
+---
+
+## Schedules (`schedules create/get/list/update --json`)
+
+`schedules list --json` returns a JSON array; all other commands return a single object.
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | string (UUID) | Schedule identifier |
+| `org_id` | string | Owning org |
+| `user_id` | string | Creator user |
+| `name` | string | Display name |
+| `prompt` | string | Agent prompt |
+| `schedule_kind` | `"interval"` | Fixed constant |
+| `interval_seconds` | integer | Run frequency |
+| `enabled` | boolean | Active state |
+| `callback_url` | string \| null | Webhook called after each run |
+| `next_run_at` | string (ISO 8601) | Next scheduled time |
+| `last_run_at` | string \| null (ISO 8601) | Last completed run |
+| `consecutive_failures` | integer | Failures since last success |
+| `created_at` | string (ISO 8601) | |
+| `updated_at` | string (ISO 8601) | |
+
+```bash
+teardrop schedules create --name my-schedule --prompt "..." --interval-seconds 3600 --json | jq -r .id
+teardrop schedules update <id> --enabled false --json | jq .enabled
+teardrop schedules list --json | jq '.[].name'
+```
+
+---
+
+## Event Triggers (`event-triggers create/get/list/update --json`)
+
+`event-triggers list --json` returns a JSON array; all other commands return a single object.
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | string (UUID) | Trigger identifier |
+| `org_id` | string | Owning org |
+| `user_id` | string | Creator user |
+| `name` | string | Display name |
+| `prompt` | string | Prompt template (supports `{{field}}` / `{{event_json}}`) |
+| `schedule_kind` | `"event"` | Fixed constant |
+| `enabled` | boolean | Active state |
+| `callback_url` | string \| null | Webhook called after each run |
+| `trigger_token` | string | Public route discriminator |
+| `event_path` | string | Inbound dispatch path (e.g. `/agent/events/{trigger_token}`) |
+| `consecutive_failures` | integer | Failures since last success |
+| `last_run_at` | string \| null (ISO 8601) | |
+| `created_at` | string (ISO 8601) | |
+| `updated_at` | string (ISO 8601) | |
+
+**`event-triggers create --json` only** additionally includes:
+
+| Field | Type | Description |
+|---|---|---|
+| `secret` | string | Plaintext signing secret — shown once, never retrievable again |
+
+**`event-triggers rotate-secret --json`** returns the rotation model (not the full trigger object):
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | string (UUID) | Trigger identifier |
+| `secret` | string | New plaintext signing secret — shown once |
+
+```bash
+# Capture id and secret on creation for use in CI
+eval $(teardrop event-triggers create --name ci-hook --prompt "..." --json \
+  | jq -r '"TRIGGER_ID=" + .id, "TRIGGER_SECRET=" + .secret')
+
+teardrop event-triggers list --json | jq '.[].trigger_token'
+teardrop event-triggers rotate-secret <id> --json | jq -r .secret
+```
+
+---
+
+## Run History (`schedules runs / event-triggers runs --json`)
+
+Both commands return the same paginated envelope:
+
+```json
+{ "items": [ <ScheduledRunResult>, ... ], "next_cursor": "<cursor> | null" }
+```
+
+Each `ScheduledRunResult` item:
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | string (UUID) | Outcome record ID |
+| `schedule_id` | string (UUID) | Owning schedule or trigger ID |
+| `org_id` | string | |
+| `run_id` | string (UUID) | Core execution thread ID |
+| `status` | `"completed" \| "failed" \| "timeout" \| "skipped"` | |
+| `output_text` | string | Synthesized agent output |
+| `cost_usdc` | integer | Atomic USDC charged ($1.00 = `1000000`) |
+| `error` | string | Sanitized reason on failure; empty on success |
+| `created_at` | string (ISO 8601) | |
+
+```bash
+teardrop schedules runs <id> --json | jq '.items[] | select(.status == "failed") | .error'
+teardrop event-triggers runs <id> --limit 50 --json | jq '.next_cursor'
+```

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

@@ -9,6 +9,8 @@ This document covers every flag, env var, and subcommand. For the quick path, st
 - [Authentication](#authentication)
 - [Running Agents](#running-agents)
 - [Chat Sessions](#chat-sessions)
+- [Schedules](#schedules)
+- [Event Triggers](#event-triggers)
 - [Billing & Credits](#billing--credits)
 - [Tool Management](#tool-management)
 - [Marketplace](#marketplace)
@@ -119,6 +121,60 @@ will start a fresh thread.
 
 ---
 
+## Schedules
+
+Recurring interval-based runs:
+
+```bash
+teardrop schedules create \
+  --name hourly-briefing \
+  --prompt "Summarize open incidents" \
+  --interval-seconds 3600
+
+teardrop schedules list
+teardrop schedules get <schedule-id>
+teardrop schedules update <schedule-id> --enabled false
+teardrop schedules update <schedule-id> --clear-callback-url
+teardrop schedules runs <schedule-id> --limit 50 --json
+teardrop schedules delete <schedule-id>
+teardrop schedules delete <schedule-id> --yes
+```
+
+Non-JSON list output includes: `ID`, `Name`, `Enabled`, `Interval`, `Consecutive Failures`, `Last Run At`.
+
+Run history output includes: `Run ID`, `Status`, `Cost (USDC)`, `Error Message`, `Executed At`.
+
+`--clear-callback-url` sends an explicit `null` callback URL while still preserving PATCH semantics for all other omitted fields.
+
+---
+
+## Event Triggers
+
+Reactive runs exposed as signed public webhook endpoints:
+
+```bash
+teardrop event-triggers create \
+  --name inbound-orders \
+  --prompt "Validate and process this order payload"
+
+teardrop event-triggers list
+teardrop event-triggers get <trigger-id>
+teardrop event-triggers update <trigger-id> --enabled false
+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 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.
+
+Non-JSON list output includes: `ID`, `Name`, `Enabled`, `Kind`, `Consecutive Failures`, `Last Run At`.
+
+Run history output includes: `Run ID`, `Status`, `Cost (USDC)`, `Error Message`, `Executed At`.
+
+---
+
 ## Billing & Credits
 
 ```bash

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "teardrop-cli"
-version = "0.2.0"
+version = "0.3.0"
 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.1.8",
+    "teardrop-sdk>=0.2.0",
     "typer>=0.12",
     "rich>=13.0",
     "platformdirs>=4.0",

{teardrop_cli-0.2.0 → teardrop_cli-0.3.0}/src/teardrop_cli/_templates.py

@@ -47,7 +47,5 @@ def render_tool_template(name: str, *, with_marketplace: bool = False) -> dict:
     data = {**_BASE_TEMPLATE, "name": name}
     if with_marketplace:
         data["publish_as_mcp"] = True
-        data["marketplace_description"] = (
-            "One-line marketplace pitch (max 200 characters)."
-        )
+        data["marketplace_description"] = "One-line marketplace pitch (max 200 characters)."
     return data

{teardrop_cli-0.2.0 → teardrop_cli-0.3.0}/src/teardrop_cli/cli.py

@@ -23,9 +23,11 @@ from teardrop_cli._lazy import LazyGroup
         "quickstart": "teardrop_cli.commands.quickstart:app",
         "config": "teardrop_cli.commands.config_cmd:app",
         "run": "teardrop_cli.commands.run:app",
+        "schedules": "teardrop_cli.commands.schedules:app",
         "balance": "teardrop_cli.commands.balance:app",
         "usage": "teardrop_cli.commands.usage:app",
         "agent-tools": "teardrop_cli.commands.agent_tools:app",
+        "event-triggers": "teardrop_cli.commands.event_triggers:app",
         "marketplace": "teardrop_cli.commands.marketplace:app",
         "tools": "teardrop_cli.commands.tools:app",
         "earnings": "teardrop_cli.commands.earnings:app",

{teardrop_cli-0.2.0 → teardrop_cli-0.3.0}/src/teardrop_cli/commands/agent_tools.py

@@ -87,4 +87,4 @@ def _list(as_json: bool, base_url: str | None) -> None:
         ],
         rows,
         title="Agent Tools",
-    )
+    )

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

@@ -49,7 +49,9 @@ def signup(
         str | None,
         typer.Option("--org-name", help="Organization name (1–200 chars)."),
     ] = None,
-    as_json: Annotated[bool, typer.Option("--json", help="Output the JWT response as JSON.")] = False,
+    as_json: Annotated[
+        bool, typer.Option("--json", help="Output the JWT response as JSON.")
+    ] = False,
     base_url: Annotated[
         str | None, typer.Option("--base-url", help="Override the API base URL.", hidden=True)
     ] = None,
@@ -373,9 +375,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[siwe]'")
             raise typer.Exit(1) from None
         acct = Account.create()
         from rich.panel import Panel
@@ -536,9 +536,7 @@ def _login_siwe(
 
     try:
         with spinner("Signing in with Ethereum…"):
-            jwt_token = asyncio.run(
-                _siwe_auth_async(url, private_key, wallet_address)
-            )
+            jwt_token = asyncio.run(_siwe_auth_async(url, private_key, wallet_address))
     except Exception as exc:
         _handle_auth_error(exc)
         return
@@ -713,4 +711,5 @@ def invite(
     print_success(f"Invited [bold]{email}[/bold] (role: {role})")
     if link:
         from teardrop_cli.formatting import console
+
         console.print(f"  Invite link: [bold]{link}[/bold]")

{teardrop_cli-0.2.0 → teardrop_cli-0.3.0}/src/teardrop_cli/commands/balance.py

@@ -105,9 +105,7 @@ def show(as_json: bool, base_url: str | None) -> None:
         ["Daily spend", _fmt_usdc(data.get("daily_spend_usdc"))],
         ["Account status", "paused" if data.get("is_paused") else "active"],
     ]
-    print_table(
-        [("Field", {"style": "bold cyan"}), "Value"], rows, title="Account Balance"
-    )
+    print_table([("Field", {"style": "bold cyan"}), "Value"], rows, title="Account Balance")
 
     if data.get("is_paused"):
         console.print(
@@ -185,6 +183,7 @@ def _credit_history(limit: int, as_json: bool, base_url: str | None) -> None:
 
     if not items:
         from teardrop_cli.formatting import data_console
+
         data_console.print("[dim]No credit history found.[/dim]")
         return
 

{teardrop_cli-0.2.0 → teardrop_cli-0.3.0}/src/teardrop_cli/commands/chat.py

@@ -136,9 +136,7 @@ def app(
     if estimate_cost:
         from teardrop_cli.commands.run import _estimate_cost
 
-        _estimate_cost(
-            message, context=context, tool_policy=tool_policy, base_url=base_url
-        )
+        _estimate_cost(message, context=context, tool_policy=tool_policy, base_url=base_url)
         return
 
     # --- Capture the server-returned thread id ---
@@ -174,4 +172,4 @@ def app(
 
     # Always print the thread id for discoverability (to stderr)
     if final_thread:
-        console.print(f"[dim]thread: {final_thread}[/dim]")
+        console.print(f"[dim]thread: {final_thread}[/dim]")

{teardrop_cli-0.2.0 → teardrop_cli-0.3.0}/src/teardrop_cli/commands/config_cmd.py

@@ -108,6 +108,4 @@ def list_cmd(
         return
 
     rows = [[k, v] for k, v in cfg.items()]
-    print_table(
-        [("Key", {"style": "bold cyan"}), "Value"], rows, title="~/.teardrop/config.toml"
-    )
+    print_table([("Key", {"style": "bold cyan"}), "Value"], rows, title="~/.teardrop/config.toml")

{teardrop_cli-0.2.0 → teardrop_cli-0.3.0}/src/teardrop_cli/commands/earnings.py

@@ -73,11 +73,11 @@ def balance(
             from teardrop_cli.commands.auth import interactive_reauthenticate
 
             if not interactive_reauthenticate(base_url=base_url):
-                raise typer.Exit(1)
+                raise typer.Exit(1) from None
             with spinner("Fetching balance…"):
                 data = _call_once()
         elif action == "fail":
-            raise typer.Exit(1)
+            raise typer.Exit(1) from None
         else:
             raise
 
@@ -94,9 +94,7 @@ def balance(
     ]
     if data.get("settlement_wallet"):
         rows.append(["Settlement wallet", data["settlement_wallet"]])
-    print_table(
-        [("Field", {"style": "bold cyan"}), "Value"], rows, title="Earnings Balance"
-    )
+    print_table([("Field", {"style": "bold cyan"}), "Value"], rows, title="Earnings Balance")
 
 
 # ---------------------------------------------------------------------------
@@ -232,9 +230,7 @@ def withdraw(
         print_json(result)
         return
 
-    print_success(
-        "Withdrawal initiated. Transaction may take 1–5 minutes on-chain."
-    )
+    print_success("Withdrawal initiated. Transaction may take 1–5 minutes on-chain.")
 
 
 async def _quick_balance(client) -> dict | None: