@balchemyai/agent-sdk 0.1.1 → 0.1.2

package/docs/examples/swing-trader.yaml

@@ -0,0 +1,50 @@
+# Swing Trader Strategy
+#
+# Holds positions for 2–72 hours. Enters on RSI oversold + MACD crossover.
+# Targets 20% gain, stops at 10% loss. Uses a trailing stop to lock in profits.
+#
+# Risk profile: MEDIUM — requires technical indicator signals, holds through
+# short-term volatility.
+# Recommended LLM: claude-haiku-4-5 or gpt-4o-mini
+
+mcp_endpoint: "${MCP_ENDPOINT}"
+api_key: "${BALCHEMY_API_KEY}"
+
+llm:
+  provider: anthropic
+  api_key: "${LLM_API_KEY}"
+  model: claude-haiku-4-5
+  max_daily_usd: 2              # Swing trader fires infrequently
+  timeout_ms: 10000
+
+strategy: swing-trader
+
+behavior_rules:
+  version: "1"
+  preset: swing-trader
+
+  filters:
+    min_liquidity_usd: 50000    # Only liquid assets for swing trades
+    max_market_cap_usd: 500000000  # Mid-cap and below
+    allowed_chains: [solana, base]
+
+  entry:
+    trigger: rsi_signal
+    indicators: [rsi, macd]
+    rsi_oversold: 30            # Enter when RSI < 30 (oversold)
+    max_position_usd: 200       # Larger positions — fewer, higher-conviction trades
+    slippage_bps: 100           # Tight slippage — not chasing
+    min_confidence: 0.75        # High confidence required
+
+  exit:
+    take_profit_pct: 20         # Exit at +20%
+    stop_loss_pct: 10           # Exit at -10%
+    trailing_stop_pct: 8        # Trail 8% below peak once in profit
+    min_hold_hours: 2           # Never exit in first 2 hours (noise avoidance)
+    max_hold_hours: 72          # Force exit after 3 days
+
+  risk:
+    max_single_trade_usd: 200
+    max_daily_loss_usd: 300
+    max_open_positions: 5
+    pause_on_drawdown_pct: 25

package/docs/partner-integration-checklist.md

@@ -0,0 +1,32 @@
+# Partner Integration Checklist
+
+## Discovery & Metadata
+
+- [ ] Publish `/.well-known/erc8004-discovery.json`
+- [ ] Publish `/.well-known/erc8004-onboarding.md`
+- [ ] Publish `/.well-known/erc8004-skills-manifest.json`
+
+## Onboarding
+
+- [ ] Enable at least one onboarding mode (`siwe` or `walletless`)
+- [ ] Verify `POST /api/public/erc8004/onboarding/siwe`
+- [ ] Verify `POST /api/public/erc8004/onboarding/identity` (if walletless enabled)
+- [ ] If using Balchemy Studio, link `agentId` to `botId` from `My Bots -> MCP & Agents -> Agent Card -> External Agent Mapping`
+- [ ] Validate replay protection (token/jti reuse rejection)
+
+## Headers and Claims
+
+- [ ] `Authorization: Bearer <mcpApiKey>` on MCP calls
+- [ ] Identity claims include `provider`, `subjectId`, `agentId`, `chainId`, `controllingAddress`
+- [ ] Provider auth header and timeout configured
+
+## Rate Limits
+
+- [ ] Onboarding route limits configured and monitored
+- [ ] Discovery feed and health endpoint limits configured
+
+## Operational
+
+- [ ] JWKS endpoint reachable (`/.well-known/jwks.json`)
+- [ ] Seed/failure telemetry visible in admin panel
+- [ ] Kill-switches documented and tested

package/docs/python-parity-backlog.md

@@ -0,0 +1,20 @@
+# Python SDK Minimum Parity Backlog
+
+## Must-Have
+
+1. `onboard_with_siwe(message, signature, agent_id)`
+2. `onboard_with_identity(provider, identity_token, agent_id, chain_id=8453)`
+3. `connect_mcp(endpoint, api_key)`
+4. `list_tools()` and `call_tool(name, arguments)`
+5. Error classes aligned with TS SDK codes
+
+## Should-Have
+
+1. Built-in timeout and retry policy helpers
+2. SSE fallback parsing parity
+3. Typed response dataclasses
+
+## Nice-to-Have
+
+1. Async client (`httpx`) and sync wrapper
+2. CLI helper for onboarding smoke checks

package/docs/release-policy.md

@@ -0,0 +1,24 @@
+# SDK Release Policy (SemVer)
+
+## Versioning
+
+- `MAJOR`: breaking API changes.
+- `MINOR`: backward-compatible feature additions.
+- `PATCH`: bug fixes and internal improvements.
+
+## Stability Levels
+
+- `0.x`: fast iteration, possible interface churn.
+- `1.x`: stable public API contract.
+
+## Publish Gates
+
+1. Typecheck passes.
+2. Onboarding smoke examples updated.
+3. Changelog entry added.
+4. Backward compatibility review complete for public exports.
+
+## Deprecation Rule
+
+- Add deprecation notice in docs before removal.
+- Keep deprecated APIs for at least one minor release when possible.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@balchemyai/agent-sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "license": "MIT",
   "private": false,
   "description": "Balchemy external AI agent onboarding + MCP SDK — ERC-8004 onboarding, Solana/EVM trading, 100 tools via MCP",
@@ -38,11 +38,10 @@
   "homepage": "https://balchemy.ai",
   "repository": {
     "type": "git",
-    "url": "https://github.com/balchemy/balchemy-agent",
-    "directory": "packages/sdk"
+    "url": "https://github.com/balchemy-ai/balchemy-agent-sdk"
   },
   "bugs": {
-    "url": "https://github.com/balchemy/balchemy-agent/issues"
+    "url": "https://github.com/balchemy-ai/balchemy-agent-sdk/issues"
   },
   "engines": {
     "node": ">=18.0.0"