aiusd-pro

---
name: aiusd-pro
version: 1.0.1
description: "AIUSD Pro ,  AI-powered trading agent with built-in reasoning. Use when user wants to trade, check balances, or manage positions through natural language conversation."
license: MIT
compatibility: "Requires node >= 18"
metadata:
  openclaw:
    emoji: "🤖"
    requires:
      bins: ["node"]
---

# AIUSD Pro

## intent

chat with aiusd through natural language to trade, check balances, manage positions, and execute multi-step operations. use this when a user wants anything related to aiusd or trading without needing to understand internal command syntax. the backend ai agent handles domain knowledge, tool selection, and multi-turn reasoning. you relay requests as natural language and retrieve responses from a long-running background process.

## inputs

- **user request**: natural language intent (e.g., "buy 100 usdc worth of sol", "what are my balances", "stake 500 aiusd")
- **aiusd-pro cli package**: installed via npx (no global install required) or `npm install -g aiusd-pro`
- **authentication**: aiusd session token from browser login or `login --browser` flow
- **network connectivity**: http/https access to aiusd backend (public api, no oauth required)
- **node runtime**: node >= 18 in PATH or available to npx

## procedure

### authentication flow

1. **check existing auth**: run `npx -y aiusd-pro send 'hello'` and observe response.
   - output: agent responds with greeting or confirmation (auth valid)
   - output: auth error (401/403, missing/expired token)

2. **if auth fails, initiate browser login**:
   - run `npx -y aiusd-pro login --browser`
   - output: json object with `url` (string) and `session_id` (string)
   - relay the `url` to the user; never fabricate or modify it
   - do NOT close the skill after this step

3. **poll for login completion**:
   - run `npx -y aiusd-pro login --poll-session <session_id>` where `<session_id>` is from step 2
   - output: `{"status": "pending"}` (user still signing in) or `{"status": "authenticated", "token": "..."}` (login complete)
   - poll every 3-5 seconds for up to 5 minutes; abort if timeout

4. **verify auth**: run `npx -y aiusd-pro send 'hello'` again
   - output: agent responds (auth now valid); proceed to main flow

### main conversation loop

5. **send user request in background mode** (all agent operations take 10-300 seconds):
   - run: `bash background:true command:"npx -y aiusd-pro send '<user request here>'"`
   - input: user request as natural language (do not parse or rewrite)
   - output: stdout containing `sessionId: <id>` (alphanumeric string)
   - store the `sessionId` for polling

6. **poll for completion** (check every 2-3 seconds):
   - run: `process action:poll sessionId:<sessionId>`
   - output: `{"status": "running"}` (agent still processing) or `{"status": "exited"}` (agent finished)
   - repeat until status is `exited` or 5 minute timeout; abort if timeout

7. **retrieve final response**:
   - run: `process action:log sessionId:<sessionId>`
   - output: agent's full response text (formatted for human reading, includes browser link at end)
   - relay output to user as-is, including the browser link (`https://aiusd.ai/chat/<session-id>`)

8. **if response is a confirmation prompt or clarification request**:
   - relay the prompt to the user verbatim
   - await user's reply (e.g., "yes", "no", "clarify X")
   - goto step 5 with user's reply as the new request (same session, same `sessionId` context is maintained server-side)
   - repeat steps 6-8 until agent response is final (no more prompts)

### session management

9. **start a fresh session** (if user requests or old session state is stale):
   - run: `bash command:"npx -y aiusd-pro session reset"`
   - output: `{"status": "reset"}`

10. **list or manage sessions** (debugging):
    - run: `bash command:"npx -y aiusd-pro session list"`
    - output: json array of session objects with ids and timestamps

11. **cancel an in-flight operation** (if user requests abort):
    - run: `bash command:"npx -y aiusd-pro cancel"`
    - output: `{"status": "cancelled"}`

## decision points

- **if `send` returns 401/403 auth error**: branch to authentication flow (steps 2-4). do not retry `send` until auth succeeds.

- **if poll returns `running` for > 5 minutes**: timeout. abort polling, inform user "agent is taking too long; try again later or cancel with `npx -y aiusd-pro cancel`".

- **if response contains a confirmation prompt (e.g., "confirm?", "approve?", "yes/no")**: do not execute or interpret the action. relay prompt to user, await their explicit response, then `send` that response back to the agent in a new `send` call.

- **if response is a final error from the agent** (e.g., "insufficient balance", "invalid symbol"): relay to user; do not retry. user must correct the request and you start a new `send`.

- **if user asks for a follow-up question or new request** (e.g., after a successful trade, asks "what's the price of btc now?"): send the new request via a new `send` call; server maintains session history automatically.

- **if user requests a fresh conversation**: run `session reset`, then proceed with a new `send`.

- **if network request times out** (unreachable host, dns failure): retry once after 5 seconds. if second attempt fails, inform user "network unreachable; check internet connection and try again".

## output contract

- **successful response**: agent's text output, one or more lines, formatted as prose or structured data (agent decides format). always includes a browser continuation link at the bottom in format `https://aiusd.ai/chat/<session-id>`.
- **confirmation prompt output**: agent's question (e.g., "will buy ~0.65 sol at $153. confirm?"). awaiting user input.
- **error output**: agent error message (e.g., "insufficient usdc balance") or system error (e.g., "network timeout", "auth failed").
- **session reset output**: json `{"status": "reset"}` or confirmation string.
- **poll output**: json `{"status": "running"}` or `{"status": "exited"}`.
- **auth output**: json `{"status": "authenticated", "token": "..."}` (on successful login) or `{"status": "pending"}` (login in progress).

all outputs are logged to process stdout and retrievable via `process action:log sessionId:<id>`.

## outcome signal

- user receives a natural language response from the ai agent that answers their request or asks for clarification
- if the request was a trade or position action, the response includes a transaction id or confirmation summary
- if the request was informational (balance, price, position), the response includes the requested data
- all responses include a clickable browser link (`https://aiusd.ai/chat/<session-id>`) that allows the user to continue the conversation in the web ui
- if a confirmation was needed, the agent prompts the user and waits; upon confirmation, a follow-up response confirms execution (e.g., "tx abc123 confirmed")
- auth failures or network errors produce explicit error text that instructs the user to re-authenticate or retry

---

credits: original skill author unknown; enriched per implexa quality standards with explicit decision logic, edge case handling, and complete auth flow documentation.