duskware 0.2.0 → 0.2.1

package/README.md

@@ -6,32 +6,118 @@ CLI for Duskware - Sovereign Onchain Runtime for AI Agents on Base.
 
 ```bash
 npm install -g duskware
-# or
+# or run directly with npx
 npx duskware
 ```
 
 ## Quick Start
 
 ```bash
-# Initialize a new agent
-duskware init
+# Initialize a new agent identity
+npx duskware init
 
-# Check agent status
-duskware status
+# Add credits (requires USDC on Base)
+npx duskware credits topup 10
+
+# Run AI inference
+npx duskware inference prompt "Hello, I am an autonomous agent"
+
+# Check your status
+npx duskware status
 ```
 
 ## Commands
 
+### Credits (Unified Balance)
+
+Duskware uses a unified credits system. Deposit USDC once, use across all services.
+
+```bash
+# Check your credits balance
+duskware credits balance
+
+# Top up credits ($5, $10, $25, $50, or $100)
+duskware credits topup 10
+
+# View transaction history
+duskware credits transactions
+
+# View usage breakdown by service
+duskware credits usage
+```
+
+### Inference
+
+Access Claude, GPT, and other frontier models. Paid from your credits balance.
+
+```bash
+# Send inference request (uses claude-4.5-sonnet by default)
+duskware inference prompt "What is the meaning of life?"
+
+# Specify a different model
+duskware inference prompt "Hello" --model claude-4.5-haiku
+
+# List available models and pricing
+duskware inference models
+
+# Check credits balance
+duskware inference balance
+
+# Check inference proxy health
+duskware inference health
+```
+
+**Available Models:**
+| Model | Price |
+|-------|-------|
+| claude-4.5-haiku | $0.01 |
+| claude-4.5-sonnet | $0.05 |
+| claude-4.5-opus | $0.25 |
+| gpt-5.2 | $0.10 |
+| gpt-5-mini | $0.03 |
+
 ### Agent Identity
 
 ```bash
-# Deploy new AgentIdentity contract
-duskware init --network sepolia --name "MyAgent" --capabilities "research,coding"
+# Deploy new AgentIdentity contract on Base
+duskware init
 
 # Show agent status
 duskware status
 ```
 
+### Sandboxes
+
+Persistent Linux environments for autonomous agents.
+
+```bash
+# List your sandboxes
+duskware sandbox list
+
+# Create a new sandbox
+duskware sandbox create my-agent --tier starter
+
+# Execute command in sandbox
+duskware sandbox exec <sandboxId> "echo hello"
+
+# Stop sandbox (sleep mode - preserves state)
+duskware sandbox stop <sandboxId>
+
+# Delete sandbox
+duskware sandbox delete <sandboxId>
+
+# View available tiers and pricing
+duskware sandbox tiers
+```
+
+**Sandbox Tiers:**
+| Tier | vCPU | Memory | Disk | Price |
+|------|------|--------|------|-------|
+| starter | 1 | 512 MB | 5 GB | $5/mo |
+| medium | 2 | 2 GB | 20 GB | $10/mo |
+| power | 4 | 8 GB | 50 GB | $25/mo |
+| pro | 8 | 16 GB | 100 GB | $50/mo |
+
 ### Skills
 
 ```bash
@@ -62,7 +148,7 @@ duskware spawn revoke <childAddress>
 ### Trust
 
 ```bash
-# Submit attestation
+# Submit attestation (score 1-100)
 duskware trust attest <agentAddress> <score> --context "Great work"
 
 # Get trust score
@@ -89,20 +175,23 @@ duskware memory read
 duskware memory version
 ```
 
-### Inference
+### Specter (Autonomous Agents)
 
 ```bash
-# Send inference request
-duskware inference prompt "What is the meaning of life?" --model claude-sonnet
+# Initialize specter configuration
+duskware specter init
 
-# List available models
-duskware inference models
+# Start autonomous agent
+duskware specter start
 
-# Check prepaid balance
-duskware inference balance
+# Check status
+duskware specter status
+
+# Stop agent
+duskware specter stop
 
-# Prepay USDC for inference
-duskware inference prepay 10
+# View logs
+duskware specter logs
 ```
 
 ## Configuration
@@ -116,34 +205,25 @@ Config files are stored in `~/.duskware/`:
 └── memory/         # Local memory cache
 ```
 
-## Networks
+## Network
 
-- **Base Sepolia** (testnet): `--network sepolia`
-- **Base Mainnet**: `--network mainnet`
+Duskware runs on **Base Mainnet** by default.
 
-## Contract Addresses
+- **USDC Contract**: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
+- **Chain ID**: 8453
 
-### Base Sepolia
-- USDC: `0x036CbD53842c5426634e7929541eC2318f3dCF7e`
+## Payment
 
-### Base Mainnet
-- USDC: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
+All payments are processed via the x402 protocol through OpenX402.ai facilitator:
+- USDC on Base Mainnet
+- EIP-3009 gasless transfers
+- Payments go directly to Duskware treasury
 
-## Development
+## Links
 
-```bash
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Watch mode
-npm run dev
-
-# Run tests
-npm test
-```
+- **Dashboard**: https://duskware.xyz
+- **Documentation**: https://docs.duskware.xyz
+- **npm**: https://www.npmjs.com/package/duskware
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "duskware",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI for Duskware - Sovereign Onchain Runtime for AI Agents",
   "main": "dist/index.js",
   "bin": {