stelagent 0.0.2 → 0.0.4

package/README.md

@@ -1,87 +1,105 @@
-# @stelagent/cli
+# Stelagent CLI
 
-Modular, agent-first CLI for Stellar — wallet, payments, markets, and DeFi.
+Modular, agent-first CLI for Stellar — wallet, payments, markets, and monitoring.
 
-## Quick Start
+## Quick start for AI agents
+
+Paste this prompt into any AI agent (Claude Code, Cursor, OpenCode, OpenClaw, Hermes Agent, etc.) and chat naturally:
 
-```bash
-npx @stelagent/cli wallet login -e you@example.com
+```
+Read https://stelagent.noval.me/AGENTS.md, then set it up for me.
 ```
 
-Prompts for an OTP sent to your email, then creates or recovers your Stellar wallet.
+The agent reads the skill definition, handles wallet creation, OTP verification, and every Stellar operation on your behalf.
 
-## Usage
+### Install the skill
 
 ```bash
-stelagent <command> [options]
+# Via flins (recommended)
+npx flins@latest add stelagent.noval.me
+
+# Via skills.sh
+npx skills add stelagent.noval.me/stelagent-cli
 ```
 
-### `wallet login`
+Both commands download the skill into your project's skills directory and wire it into your agent's configuration automatically.
 
-Sign in with email to create or recover your wallet.
+## Install
 
 ```bash
-stelagent wallet login -e you@example.com
-stelagent wallet login -e you@example.com -n testnet
+npx stelagent@latest <command>
+# or
+bunx stelagent@latest <command>
 ```
 
-| Flag            | Description                                |
-| --------------- | ------------------------------------------ |
-| `-e, --email`   | Your email address (required)              |
-| `-n, --network` | `testnet` or `pubnet` (default: `testnet`) |
+No install needed — `npx` always runs the latest published version.
 
-One email always maps to one wallet. Logging in from any device with the same email recovers the same wallet.
+## Commands
 
-### `wallet address`
-
-Show the wallet public key.
+### Wallet
 
 ```bash
-stelagent wallet address
+npx stelagent@latest wallet login -e you@example.com                    # Request OTP
+npx stelagent@latest wallet verify -e you@example.com -o 123456          # Verify OTP
+npx stelagent@latest wallet address                                     # Show public key
+npx stelagent@latest wallet balance                                    # Check balances
+npx stelagent@latest wallet transfer -t GDXXX... -a 10                  # Send XLM
+npx stelagent@latest wallet logout                                     # Clear session
 ```
 
-### `wallet balance`
-
-Show token balances.
+### Payments
 
 ```bash
-stelagent wallet balance
+npx stelagent@latest send GDXXX... 100 -a USDC:GAXYZ...                # Custom asset
+npx stelagent@latest send GDXXX... 50 -a native --memo text:ref-99     # XLM with memo
+npx stelagent@latest pay https://api.example.com/premium                # x402 payment
 ```
 
-### `wallet transfer`
-
-Send XLM to another Stellar address.
+### Account queries
 
 ```bash
-stelagent wallet transfer -t GDXXX... -a 10
+npx stelagent@latest account details GDXXX...          # Balances, signers, thresholds
+npx stelagent@latest account transactions GDXXX...      # Transaction history
+npx stelagent@latest account payments GDXXX...          # Payment history
+npx stelagent@latest account effects GDXXX...           # Effect history
 ```
 
-| Flag           | Description                       |
-| -------------- | --------------------------------- |
-| `-t, --to`     | Destination public key (required) |
-| `-a, --amount` | Amount in XLM (required)          |
+### Assets & fees
 
-### `wallet logout`
+```bash
+npx stelagent@latest assets search --code USDC                              # Search assets
+npx stelagent@latest assets orderbook --selling XLM --buying USDC:G...     # Order book
+npx stelagent@latest fee                                                    # Fee stats
+```
 
-Clear the local session.
+### Streaming
 
 ```bash
-stelagent wallet logout
+npx stelagent@latest monitor transactions GDXXX...     # Stream transactions
+npx stelagent@latest monitor payments GDXXX...         # Stream payments
+npx stelagent@latest monitor effects GDXXX...          # Stream effects
 ```
 
-### `pay <url>`
-
-Make an x402 payment to access a paywalled resource.
+### MCP server
 
 ```bash
-stelagent pay https://api.example.com/premium
+npx stelagent@latest mcp    # Start MCP server on stdio
 ```
 
-If the URL returns HTTP 402, the CLI negotiates payment using the x402 protocol and retries with a signed payment header.
+All commands accept `-n testnet|pubnet` (default: `testnet`) and `-f json|text`. Account and asset queries support `--limit`, `--cursor`, and `--order asc|desc`.
+
+## Authentication
+
+Two-step OTP flow:
+
+1. **`wallet login -e <email>`** — sends a one-time code to your email
+2. **`wallet verify -e <email> -o <code>`** — verifies the code and creates (or recovers) your wallet
+
+One email maps to one wallet, recoverable from any device.
 
 ## Output
 
-All commands output structured JSON:
+All commands return structured JSON:
 
 ```json
 { "ok": true, "data": { ... } }
@@ -91,9 +109,11 @@ All commands output structured JSON:
 { "ok": false, "error": "..." }
 ```
 
+Use `--format text` for human-readable output.
+
 ## Architecture
 
-Wallets are stored server-side — one wallet per email, recoverable from any device. The CLI only holds a session token locally (`~/.stelagent/session.json`). Secret keys are fetched from the server over HTTPS on each command invocation and never persisted to disk.
+Wallets are stored server-side — one wallet per email, recoverable from any device. The CLI only holds a session token locally (`~/.stelagent/session.json`). Secret keys are fetched over HTTPS when needed and never written to disk.
 
 ## Development
 

package/dist/index.mjs

@@ -201,7 +201,7 @@ function formatError(e) {
 	if (e instanceof Error) return e.message;
 	return String(e);
 }
-async function runApp(command, fn, format = "json") {
+async function runApp(command, fn, format = "json", options) {
 	const start = Date.now();
 	try {
 		const result = await fn();
@@ -210,6 +210,7 @@ async function runApp(command, fn, format = "json") {
 			ok: true,
 			durationMs: Date.now() - start
 		});
+		if (!options?.silent) printResult(Result.ok(result), format);
 		return result;
 	} catch (e) {
 		writeAuditEntry({
@@ -1666,7 +1667,7 @@ const monitorTransactions = defineCommand({
 						error: `Stream error: ${message}`
 					}));
 				});
-			}, format);
+			}, format, { silent: true });
 		} catch (e) {
 			const message = e instanceof Error ? e.message : String(e);
 			printResult(Result.err(`Failed to stream transactions: ${message}`), "json");
@@ -1743,7 +1744,7 @@ const monitorPayments = defineCommand({
 						error: `Stream error: ${message}`
 					}));
 				});
-			}, format);
+			}, format, { silent: true });
 		} catch (e) {
 			const message = e instanceof Error ? e.message : String(e);
 			printResult(Result.err(`Failed to stream payments: ${message}`), "json");
@@ -1830,7 +1831,7 @@ const monitorCommand = defineCommand({
 								error: `Stream error: ${message}`
 							}));
 						});
-					}, format);
+					}, format, { silent: true });
 				} catch (e) {
 					const message = e instanceof Error ? e.message : String(e);
 					printResult(Result.err(`Failed to stream effects: ${message}`), "json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stelagent",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Modular, agent-first CLI for Stellar — wallet, payments, markets, and DeFi",
   "license": "MIT",
   "bin": {