@aomi-labs/client 0.1.23 → 0.1.24

package/dist/cli.js

@@ -1838,7 +1838,7 @@ Available: ${available}`);
       requirePendingTxs(txIds) {
         const uniqueIds = Array.from(new Set(txIds));
         if (uniqueIds.length !== txIds.length) {
-          fatal("Duplicate transaction IDs are not allowed in a single `aomi sign` call.");
+          fatal("Duplicate transaction IDs are not allowed in a single `aomi tx sign` call.");
         }
         return uniqueIds.map((txId) => this.requirePendingTx(txId));
       }
@@ -2274,7 +2274,7 @@ async function chatCommand(config, message, verbose) {
     }
     if (capturedRequests.length > 0) {
       console.log(
-        "\nRun `aomi tx` to see pending transactions, `aomi sign <id>` to sign."
+        "\nRun `aomi tx list` to see pending transactions, `aomi tx sign <id>` to sign."
       );
     }
   } finally {
@@ -3504,17 +3504,17 @@ async function signCommand(config, txIds) {
   var _a3, _b, _c, _d;
   if (txIds.length === 0) {
     fatal(
-      "Usage: aomi sign <tx-id> [<tx-id> ...]\nRun `aomi tx` to see pending transaction IDs."
+      "Usage: aomi tx sign <tx-id> [<tx-id> ...]\nRun `aomi tx list` to see pending transaction IDs."
     );
   }
   const privateKey = config.privateKey;
   if (!privateKey) {
     fatal(
       [
-        "Private key required for `aomi sign`.",
+        "Private key required for `aomi tx sign`.",
         "Pass one of:",
         "  --private-key <hex-key>",
-        "  PRIVATE_KEY=<hex-key> aomi sign <tx-id>"
+        "  PRIVATE_KEY=<hex-key> aomi tx sign <tx-id>"
       ].join("\n")
     );
   }
@@ -3771,7 +3771,7 @@ async function simulateCommand(txIds) {
     fatal("No active session. Run `aomi chat` first.");
   }
   if (txIds.length === 0) {
-    fatal("Usage: aomi simulate <tx-id> [<tx-id> ...]\nRun `aomi tx` to see available IDs.");
+    fatal("Usage: aomi tx simulate <tx-id> [<tx-id> ...]\nRun `aomi tx list` to see available IDs.");
   }
   const pendingTxs = txIds.map((txId) => cli.requirePendingTx(txId));
   console.log(
@@ -3827,12 +3827,12 @@ ${DIM}Total gas: ${result.total_gas.toLocaleString()}${RESET}`);
   console.log();
   if (result.batch_success) {
     console.log(
-      `${GREEN}All steps passed.${RESET} Run \`aomi sign ${txIds.join(" ")}\` to execute.`
+      `${GREEN}All steps passed.${RESET} Run \`aomi tx sign ${txIds.join(" ")}\` to execute.`
     );
   } else {
     const failed = result.steps.find((s) => !s.success);
     console.log(
-      `\x1B[31mBatch failed at step ${(_c = failed == null ? void 0 : failed.step) != null ? _c : "?"}.${RESET} Fix the issue and re-queue, or run \`aomi sign\` on the successful prefix.`
+      `\x1B[31mBatch failed at step ${(_c = failed == null ? void 0 : failed.step) != null ? _c : "?"}.${RESET} Fix the issue and re-queue, or run \`aomi tx sign\` on the successful prefix.`
     );
   }
 }
@@ -4890,7 +4890,7 @@ var secretDef = defineCommand7({
 // package.json
 var package_default = {
   name: "@aomi-labs/client",
-  version: "0.1.23",
+  version: "0.1.24",
   description: "Platform-agnostic TypeScript client for the Aomi backend API",
   type: "module",
   main: "./dist/index.cjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aomi-labs/client",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Platform-agnostic TypeScript client for the Aomi backend API",
   "type": "module",
   "main": "./dist/index.cjs",

package/skills/aomi-transact/.skill-optimizer/cli-commands.json

@@ -0,0 +1,124 @@
+[
+  {
+    "command": "chat",
+    "description": "Send a message to the agent and print the response",
+    "args": [{ "name": "message", "required": true, "description": "The message text" }],
+    "options": [
+      { "name": "--model", "takesValue": true, "description": "Set the session model before sending the message" },
+      { "name": "--verbose", "takesValue": false, "description": "Stream agent responses, tool calls, and events live" },
+      { "name": "--new-session", "takesValue": false, "description": "Create a fresh active session for this command" },
+      { "name": "--app", "takesValue": true, "description": "App name (default: 'default')" },
+      { "name": "--chain", "takesValue": true, "description": "Active chain id for chat/session context" },
+      { "name": "--public-key", "takesValue": true, "description": "Wallet address so the agent knows your wallet" }
+    ]
+  },
+  {
+    "command": "app list",
+    "description": "List available apps",
+    "options": []
+  },
+  {
+    "command": "app current",
+    "description": "Show the current app",
+    "options": []
+  },
+  {
+    "command": "model list",
+    "description": "List models available to the current backend",
+    "options": []
+  },
+  {
+    "command": "model set",
+    "description": "Set the active model for the current session",
+    "args": [{ "name": "rig", "required": true, "description": "Model identifier" }],
+    "options": []
+  },
+  {
+    "command": "chain list",
+    "description": "List supported chains",
+    "options": []
+  },
+  {
+    "command": "session list",
+    "description": "List local sessions with metadata",
+    "options": []
+  },
+  {
+    "command": "session new",
+    "description": "Start a fresh local/backend session and make it active",
+    "options": []
+  },
+  {
+    "command": "session resume",
+    "description": "Resume a local session",
+    "args": [{ "name": "id", "required": true, "description": "session-id or session-N" }],
+    "options": []
+  },
+  {
+    "command": "session delete",
+    "description": "Delete a local session file",
+    "args": [{ "name": "id", "required": true, "description": "session-id or session-N" }],
+    "options": []
+  },
+  {
+    "command": "log",
+    "description": "Show full conversation history with tool results",
+    "options": []
+  },
+  {
+    "command": "tx",
+    "description": "List pending and signed transactions",
+    "options": []
+  },
+  {
+    "command": "simulate",
+    "description": "Batch-simulate pending transactions atomically (e.g. approve then swap)",
+    "args": [{ "name": "tx-id", "required": true, "variadic": true, "description": "One or more pending tx ids" }],
+    "options": []
+  },
+  {
+    "command": "sign",
+    "description": "Sign and submit a pending transaction",
+    "args": [{ "name": "tx-id", "required": true, "variadic": true, "description": "One or more pending tx ids" }],
+    "options": [
+      { "name": "--eoa", "takesValue": false, "description": "Force EOA signing path" },
+      { "name": "--aa", "takesValue": false, "description": "Force AA signing path" },
+      { "name": "--aa-provider", "takesValue": true, "description": "AA provider name (AA only)" },
+      { "name": "--aa-mode", "takesValue": true, "description": "AA mode (AA only)" },
+      { "name": "--rpc-url", "takesValue": true, "description": "Override RPC URL for this signing call" },
+      { "name": "--private-key", "takesValue": true, "description": "Hex private key (must start with 0x)" },
+      { "name": "--public-key", "takesValue": true, "description": "Wallet address; must match the signer" }
+    ]
+  },
+  {
+    "command": "secret list",
+    "description": "List configured secrets for the active session",
+    "options": []
+  },
+  {
+    "command": "secret add",
+    "description": "Add a secret to the active session (NAME=value)",
+    "args": [{ "name": "kv", "required": true, "description": "KEY=value pair, e.g. ALCHEMY_API_KEY=..." }],
+    "options": []
+  },
+  {
+    "command": "secret clear",
+    "description": "Clear all secrets for the active session",
+    "options": []
+  },
+  {
+    "command": "status",
+    "description": "Show current session state",
+    "options": []
+  },
+  {
+    "command": "events",
+    "description": "List system events",
+    "options": []
+  },
+  {
+    "command": "close",
+    "description": "Close the current session",
+    "options": []
+  }
+]

package/skills/aomi-transact/.skill-optimizer/skill-optimizer.json

@@ -0,0 +1,52 @@
+{
+  "name": "aomi-transact",
+  "target": {
+    "surface": "cli",
+    "repoPath": "..",
+    "skill": "../SKILL.md",
+    "discovery": {
+      "mode": "manifest"
+    },
+    "cli": {
+      "commands": "./cli-commands.json"
+    }
+  },
+  "benchmark": {
+    "apiKeyEnv": "OPENROUTER_API_KEY",
+    "format": "pi",
+    "timeout": 240000,
+    "taskGeneration": {
+      "enabled": true,
+      "maxTasks": 20,
+      "outputDir": "."
+    },
+    "models": [
+      {
+        "id": "openrouter/anthropic/claude-sonnet-4-6",
+        "name": "Claude Sonnet 4.6",
+        "tier": "flagship"
+      },
+      {
+        "id": "openrouter/openai/gpt-4o",
+        "name": "Gpt 4o",
+        "tier": "mid"
+      }
+    ],
+    "output": {
+      "dir": "../benchmark-results"
+    },
+    "verdict": {
+      "perModelFloor": 0.6000000000000001,
+      "targetWeightedAverage": 0.8
+    }
+  },
+  "optimize": {
+    "model": "openrouter/anthropic/claude-sonnet-4-6",
+    "apiKeyEnv": "OPENROUTER_API_KEY",
+    "allowedPaths": [
+      "SKILL.md"
+    ],
+    "validation": [],
+    "maxIterations": 5
+  }
+}

package/skills/aomi-transact/SKILL.md

@@ -5,8 +5,8 @@ description: >
   check balances or prices, build wallet requests, confirm quotes or routes,
   sign transactions or EIP-712 payloads, switch apps or chains, or execute
   swaps, transfers, and DeFi actions on-chain. Covers Aomi chat, transaction
-  review, AA-first signing with mode fallback, persistent AA configuration,
-  session controls, and per-session secret ingestion.
+  review, AA-first signing with mode fallback, session controls, and
+  per-session secret ingestion.
 compatibility: "Requires @aomi-labs/client (`npm install -g @aomi-labs/client`). CLI executable is `aomi`. Requires viem for signing (`npm install viem`). Use AOMI_APP / --app, AOMI_MODEL / --model, AOMI_CHAIN_ID / --chain, CHAIN_RPC_URL / --rpc-url, `aomi secret add` for session secret ingestion, and AOMI_STATE_DIR for local session storage."
 
 license: MIT
@@ -62,7 +62,6 @@ aomi model list|set|current
 aomi app list|current
 aomi chain list
 aomi secret list|clear|add
-aomi aa status|set|test|reset
 ```
 
 ## Quick Start
@@ -182,7 +181,7 @@ Run `aomi tx list` to see pending transactions, `aomi tx sign <id>` to sign.
 Use these rules exactly:
 
 - Default command: `aomi tx sign <tx-id> [<tx-id> ...]`
-- Default behavior (**auto-detect**): if an AA provider is configured (env vars, `~/.aomi/aa.json`, or flags), use AA automatically. If no AA provider is configured, use EOA. There is no silent fallback — AA either works or fails.
+- Default behavior (**auto-detect**): if an AA provider is configured (env vars or flags), use AA automatically. If no AA provider is configured, use EOA. There is no silent fallback — AA either works or fails.
 - **Mode fallback**: when AA is used, the CLI tries the preferred mode (default 7702). If it fails, it tries the alternative mode (4337). If both fail, it returns an error suggesting `--eoa`.
 - `--eoa`: force direct EOA execution, skip AA entirely.
 - `--aa-provider` or `--aa-mode`: AA-specific controls that also force AA mode. Cannot be used with `--eoa`.
@@ -202,16 +201,16 @@ aomi tx sign tx-1 --aa-provider pimlico --aa-mode 4337 --private-key 0xYourPriva
 
 ### Batch Simulation
 
-Use `aomi simulate` to dry-run pending transactions before signing. Simulation
+Use `aomi tx simulate` to dry-run pending transactions before signing. Simulation
 runs each tx sequentially on a forked chain so state-dependent flows (approve →
 swap) are validated as a batch — the swap sees the approve's state changes.
 
 ```bash
 # Simulate a single pending tx
-aomi simulate tx-1
+aomi tx simulate tx-1
 
 # Simulate a multi-step batch in order (approve then swap)
-aomi simulate tx-1 tx-2
+aomi tx simulate tx-1 tx-2
 ```
 
 The response includes per-step success/failure, revert reasons, and gas usage:
@@ -240,7 +239,7 @@ When to simulate:
 When not to simulate:
 
 - Read-only operations (balances, prices, quotes).
-- If there are no pending transactions (`aomi tx` shows nothing).
+- If there are no pending transactions (`aomi tx list` shows nothing).
 
 Simulation and signing workflow:
 
@@ -250,16 +249,16 @@ aomi chat "approve and swap 100 USDC for ETH on Uniswap" \
   --public-key 0xYourAddress --chain 1
 
 # 2. Check what got queued
-aomi tx
+aomi tx list
 
 # 3. Simulate the batch
-aomi simulate tx-1 tx-2
+aomi tx simulate tx-1 tx-2
 
 # 4. If simulation succeeds, sign
-aomi sign tx-1 tx-2 --private-key 0xYourPrivateKey --rpc-url https://eth.llamarpc.com
+aomi tx sign tx-1 tx-2 --private-key 0xYourPrivateKey --rpc-url https://eth.llamarpc.com
 
 # 5. Verify
-aomi tx
+aomi tx list
 ```
 
 ### Account Abstraction
@@ -275,11 +274,11 @@ Use AA when:
 
 How to choose:
 
-- `aomi sign` with no AA flags: try AA first, then fall back to EOA automatically if AA is unavailable.
-- `aomi sign --aa`: require AA only. Use this when the user does not want an EOA fallback.
-- `aomi sign --eoa`: bypass AA entirely and sign directly with the wallet key.
-- `aomi sign --aa-provider alchemy|pimlico`: force a specific AA provider.
-- `aomi sign --aa-mode 4337|7702`: force the execution mode when the user wants a specific AA path.
+- `aomi tx sign` with no AA flags: try AA first, then fall back to EOA automatically if AA is unavailable.
+- `aomi tx sign --aa`: require AA only. Use this when the user does not want an EOA fallback.
+- `aomi tx sign --eoa`: bypass AA entirely and sign directly with the wallet key.
+- `aomi tx sign --aa-provider alchemy|pimlico`: force a specific AA provider.
+- `aomi tx sign --aa-mode 4337|7702`: force the execution mode when the user wants a specific AA path.
 
 More signing notes:
 
@@ -371,7 +370,7 @@ aomi secret add NAME=value [NAME=value ...]
 ### Batch Simulation
 
 ```bash
-aomi simulate <tx-id> [<tx-id> ...]
+aomi tx simulate <tx-id> [<tx-id> ...]
 ```
 
 - Runs pending transactions sequentially on a forked chain (Anvil snapshot/revert).
@@ -379,7 +378,7 @@ aomi simulate <tx-id> [<tx-id> ...]
 - Returns per-step success/failure, revert reasons, and `gas_used`.
 - Returns `total_gas` for the entire batch.
 - No on-chain state is modified — the fork is reverted after simulation.
-- Requires pending transactions to exist in the session (`aomi tx` to check).
+- Requires pending transactions to exist in the session (`aomi tx list` to check).
 
 ### App And Model Commands
 
@@ -467,44 +466,25 @@ When using AA, the CLI tries modes in order:
 2. If preferred mode fails, try the alternative mode (7702 ↔ 4337).
 3. If both modes fail, return error with suggestion: use `--eoa` to sign without AA.
 
-### Persistent AA Configuration
-
-AA settings can be persisted to `~/.aomi/aa.json` using the `aomi aa` commands,
-eliminating the need to pass env vars or flags on every sign.
-
-```bash
-# Configure AA provider and credentials
-aomi aa set provider alchemy
-aomi aa set key <your-alchemy-key>
-aomi aa set alchemy-key <your-alchemy-key>    # provider-specific key
-aomi aa set pimlico-key <your-pimlico-key>     # provider-specific key
-aomi aa set policy <gas-policy-id>
-aomi aa set mode 7702
-aomi aa set fallback eoa
+### AA Configuration
 
-# View resolved config (all layers merged)
-aomi aa status
+AA is configured per-invocation via flags or environment variables. There is
+no persistent AA config file — export the relevant env vars in your shell, or
+pass `--aa-*` flags directly on `aomi tx sign`.
 
-# Validate setup against a chain
-aomi aa test --chain 8453
-
-# Clear all persisted config
-aomi aa reset
-```
-
-Priority chain for AA resolution: **flag > env var > `~/.aomi/aa.json` > defaults**.
+Priority chain for AA resolution: **flag > env var > defaults**.
 
 ### AA Providers
 
-| Provider | Flag                    | Env Var           | Persistent Config         | Notes                            |
-| -------- | ----------------------- | ----------------- | ------------------------- | -------------------------------- |
-| Alchemy  | `--aa-provider alchemy` | `ALCHEMY_API_KEY` | `aomi aa set provider alchemy` | 4337 (sponsored via gas policy), 7702 (EOA pays gas) |
-| Pimlico  | `--aa-provider pimlico` | `PIMLICO_API_KEY` | `aomi aa set provider pimlico` | 4337 (sponsored via dashboard policy). Direct private key supported. |
+| Provider | Flag                    | Env Var           | Notes                            |
+| -------- | ----------------------- | ----------------- | -------------------------------- |
+| Alchemy  | `--aa-provider alchemy` | `ALCHEMY_API_KEY` | 4337 (sponsored via gas policy), 7702 (EOA pays gas) |
+| Pimlico  | `--aa-provider pimlico` | `PIMLICO_API_KEY` | 4337 (sponsored via dashboard policy). Direct private key supported. |
 
 Provider selection rules:
 
-- If the user explicitly selects a provider (flag or persistent config), use it.
-- In auto-detect mode, the CLI uses the first configured AA provider.
+- If the user explicitly selects a provider via flag, use it.
+- In auto-detect mode, the CLI uses the first configured AA provider (whichever env var is set).
 - If no AA provider is configured, auto-detect uses EOA directly.
 
 ### AA Modes
@@ -538,15 +518,6 @@ export ALCHEMY_GAS_POLICY_ID=your-policy-id
 aomi tx sign tx-1
 ```
 
-Or use persistent config:
-
-```bash
-aomi aa set provider alchemy
-aomi aa set key your-key
-aomi aa set policy your-policy-id
-aomi tx sign tx-1
-```
-
 **Pimlico** (sponsorship via dashboard policy):
 
 ```bash
@@ -589,20 +560,22 @@ Practical rule:
 ### Flags And Env Vars
 
 All config can be passed as flags. Flags override environment variables.
-Environment variables override persistent config (`~/.aomi/aa.json`).
-
-| Flag            | Env Var            | Default                | Purpose                                 |
-| --------------- | ------------------ | ---------------------- | --------------------------------------- |
-| `--backend-url` | `AOMI_BACKEND_URL` | `https://api.aomi.dev` | Backend URL                             |
-| `--api-key`     | `AOMI_API_KEY`     | none                   | API key for non-default apps            |
-| `--app`         | `AOMI_APP`         | `default`              | Backend app                             |
-| `--model`       | `AOMI_MODEL`       | backend default        | Session model                           |
-| `--public-key`  | `AOMI_PUBLIC_KEY`  | none                   | Wallet address for chat/session context |
-| `--private-key` | `PRIVATE_KEY`      | none                   | Signing key for `aomi tx sign`          |
-| `--rpc-url`     | `CHAIN_RPC_URL`    | chain RPC default      | RPC override for signing                |
-| `--chain`       | `AOMI_CHAIN_ID`    | `1`                    | Active wallet chain                     |
-| `--aa-provider` | `AOMI_AA_PROVIDER` | auto-detect            | AA provider override                    |
-| `--aa-mode`     | `AOMI_AA_MODE`     | chain default          | AA mode override                        |
+
+| Flag            | Env Var            | Default                | Purpose                                                   |
+| --------------- | ------------------ | ---------------------- | --------------------------------------------------------- |
+| `--backend-url` | `AOMI_BACKEND_URL` | `https://api.aomi.dev` | Backend URL                                               |
+| `--api-key`     | `AOMI_API_KEY`     | none                   | API key for non-default apps                              |
+| `--app`         | `AOMI_APP`         | `default`              | Backend app                                               |
+| `--model`       | `AOMI_MODEL`       | backend default        | Session model                                             |
+| `--new-session` | —                  | off                    | Create a fresh active session for this command            |
+| `--public-key`  | `AOMI_PUBLIC_KEY`  | none                   | Wallet address for chat/session context                   |
+| `--private-key` | `PRIVATE_KEY`      | none                   | Signing key for `aomi tx sign`                            |
+| `--rpc-url`     | `CHAIN_RPC_URL`    | chain RPC default      | RPC override for signing                                  |
+| `--chain`       | `AOMI_CHAIN_ID`    | none                   | Active wallet chain (inherits session chain if unset)     |
+| `--eoa`         | —                  | off                    | Force plain EOA, skip AA even if configured (sign-only)   |
+| `--aa`          | —                  | off                    | Force AA, error if provider not configured (sign-only)    |
+| `--aa-provider` | `AOMI_AA_PROVIDER` | auto-detect            | AA provider override: `alchemy` \| `pimlico` (sign-only)  |
+| `--aa-mode`     | `AOMI_AA_MODE`     | chain default          | AA mode override: `4337` \| `7702` (sign-only)            |
 
 ### AA Provider Credentials
 
@@ -634,7 +607,8 @@ Storage layout by default:
 
 - `~/.aomi/sessions/` stores per-session JSON files.
 - `~/.aomi/active-session.txt` stores the active local session pointer.
-- `~/.aomi/aa.json` stores persistent AA configuration.
+
+AA configuration is supplied per-invocation via flags or environment variables (no persistent `aa.json` file).
 
 ### Important Config Rules
 
@@ -686,18 +660,18 @@ aomi chat "approve and swap 500 USDC for ETH on Uniswap" \
   --public-key 0xYourAddress --chain 1
 
 # 2. Check queued requests
-aomi tx
+aomi tx list
 
 # 3. Simulate the batch — approve then swap
-aomi simulate tx-1 tx-2
+aomi tx simulate tx-1 tx-2
 
 # 4. If simulation passes, sign the batch
-aomi sign tx-1 tx-2 \
+aomi tx sign tx-1 tx-2 \
   --private-key 0xYourPrivateKey \
   --rpc-url https://eth.llamarpc.com
 
 # 5. Verify
-aomi tx
+aomi tx list
 ```
 
 ### Explicit EOA Flow
@@ -718,16 +692,14 @@ aomi tx sign tx-1 \
   --private-key 0xYourPrivateKey
 ```
 
-### AA Setup With Persistent Config
+### AA Setup With Environment Variables
 
 ```bash
-# One-time setup
-aomi aa set provider alchemy
-aomi aa set key your-alchemy-key
-aomi aa set policy your-gas-policy-id
-aomi aa status
+# Export once per shell — auto-detected by `aomi tx sign`
+export ALCHEMY_API_KEY=your-alchemy-key
+export ALCHEMY_GAS_POLICY_ID=your-gas-policy-id
 
-# Now all signs auto-use AA — no flags needed
+# All subsequent signs auto-use AA — no flags needed
 aomi tx sign tx-1 --private-key 0xYourPrivateKey
 ```
 
@@ -794,11 +766,10 @@ aomi session close
 
 - If `aomi chat` returns `(no response)`, wait briefly and run `aomi session status`.
 - If AA signing fails, the CLI tries the alternative AA mode automatically. If both modes fail, it returns an error suggesting `--eoa`. Read the console output before retrying manually.
-- If AA is required and fails, check `ALCHEMY_API_KEY` or `PIMLICO_API_KEY`, the selected chain, and any requested `--aa-mode`. Use `aomi aa status` to see the resolved AA config.
+- If AA is required and fails, check `ALCHEMY_API_KEY` or `PIMLICO_API_KEY`, the selected chain, and any requested `--aa-mode`.
 - If a transaction fails on-chain, check the RPC URL, balance, and chain.
 - `401`, `429`, and generic parameter errors during `aomi tx sign` are often RPC problems rather than transaction-construction problems. Try a reliable RPC for the correct chain.
 - If `ALCHEMY_API_KEY` is set, construct the correct chain-specific Alchemy RPC before falling back to random public endpoints.
 - If one or two public RPCs fail for the same chain, stop rotating through random endpoints and ask the user for a proper RPC URL for that chain.
-- Use `aomi aa test --chain <id>` to validate AA setup for a specific chain before signing.
-- If `aomi simulate` fails with a revert, read the revert reason. Common causes: expired quote or timestamp (re-chat to get a fresh quote), insufficient token balance, or missing prior approval. Do not sign transactions that failed simulation without understanding why.
-- If `aomi simulate` returns `stateful: false`, the backend could not fork the chain — simulation ran each tx independently via `eth_call`, so state-dependent flows (approve → swap) may show false negatives. Retry or check that the backend's Anvil instance is running.
+- If `aomi tx simulate` fails with a revert, read the revert reason. Common causes: expired quote or timestamp (re-chat to get a fresh quote), insufficient token balance, or missing prior approval. Do not sign transactions that failed simulation without understanding why.
+- If `aomi tx simulate` returns `stateful: false`, the backend could not fork the chain — simulation ran each tx independently via `eth_call`, so state-dependent flows (approve → swap) may show false negatives. Retry or check that the backend's Anvil instance is running.