Next

TESTING.md

@@ -142,6 +142,35 @@ pnpm test:ci        # Optimized for CI (unit + integration)
 pnpm test:ci:main   # Full test suite including E2E
 ```
 
+### Agent GMX Allora E2E (Starts Local onchain-actions)
+
+`agent-gmx-allora` E2E tests now start a local `onchain-actions` dev server (plus Memgraph) automatically.
+
+Requirements:
+- Docker running (for Memgraph via `docker compose`)
+- A local onchain-actions worktree at `worktrees/onchain-actions-001` (override with `ONCHAIN_ACTIONS_WORKTREE_DIR`)
+- Network access (E2E hits Allora consumer API; set `ALLORA_API_KEY` if needed)
+
+Commands:
+```bash
+cd typescript/clients/web-ag-ui/apps/agent-gmx-allora
+
+# Full suite (unit + integration + e2e)
+pnpm test
+
+# E2E only (starts Memgraph + onchain-actions automatically)
+pnpm test:e2e
+```
+
+Optional overrides:
+```bash
+# Use a different onchain-actions worktree location
+ONCHAIN_ACTIONS_WORKTREE_DIR=/absolute/path/to/worktrees/onchain-actions-001 pnpm test:e2e
+
+# Use a different compose file (rare)
+ONCHAIN_ACTIONS_MEMGRAPH_COMPOSE_FILE=/absolute/path/to/compose.dev.db.yaml pnpm test:e2e
+```
+
 ### Running Specific Tests
 
 ```bash

typescript/clients/web-a2a/src/components/PrivyClientProvider.tsx

@@ -3,16 +3,12 @@
 import { PrivyProvider } from '@privy-io/react-auth';
 import type React from 'react';
 
-function isPlaceholderAppId(appId: string): boolean {
-  return appId === 'your_privy_app_id_here';
-}
-
 export function PrivyClientProvider({ children }: { children: React.ReactNode }) {
   const appId = process.env.NEXT_PUBLIC_PRIVY_APP_ID;
 
-  if (!appId || isPlaceholderAppId(appId)) {
+  if (!appId) {
     throw new Error(
-      'Privy is not configured: set NEXT_PUBLIC_PRIVY_APP_ID to a valid Privy App ID (build can succeed without it, but the app cannot run without it).',
+      'Privy is not configured. Set NEXT_PUBLIC_PRIVY_APP_ID to a valid Privy App ID and restart the dev server.',
     );
   }
 

typescript/clients/web-ag-ui/TESTING.md

@@ -0,0 +1,75 @@
+# Web AG-UI Agent Testing Notes
+
+This note documents how to correctly run tests for any given agent in `clients/web-ag-ui`, based on what was tried initially, what was wrong, and where we landed.
+
+## What I Tried Initially (Wrong)
+
+1. I ran repo-level commands from `typescript/`:
+   - `pnpm lint`
+   - `pnpm build`
+
+2. I also ran a general `pnpm install` in the monorepo root.
+
+These actions triggered unrelated packages (for example `clients/web-a2a`) and caused failures unrelated to the target agent. This made the results noisy and misleading for the actual work.
+
+Additionally, I attempted to add dependencies directly inside `apps/web`:
+- `pnpm add -D prettier`
+
+That failed with:
+- `ERR_PNPM_PATCH_NOT_APPLIED` because `clients/web-ag-ui` uses `patchedDependencies` at the workspace root, and installing inside a leaf app can conflict with those patches.
+
+## What Was Actually Correct
+
+All test and build workflows should be scoped to **`clients/web-ag-ui` only**, and ideally filtered to the specific app (agent) being worked on.
+
+### Correct Pattern (for any agent app)
+
+Use `pnpm -C` to scope to `clients/web-ag-ui` and then filter to the agent package name.
+
+Example for `agent-gmx-allora`:
+
+```
+pnpm -C typescript/clients/web-ag-ui --filter agent-gmx-allora run lint
+pnpm -C typescript/clients/web-ag-ui --filter agent-gmx-allora run build
+pnpm -C typescript/clients/web-ag-ui --filter agent-gmx-allora run test
+```
+
+This runs unit + integration + e2e (if defined) without touching unrelated workspaces.
+
+### Example for `apps/web`
+
+```
+pnpm -C typescript/clients/web-ag-ui --filter web run lint
+pnpm -C typescript/clients/web-ag-ui --filter web run build
+pnpm -C typescript/clients/web-ag-ui --filter web run test
+```
+
+Note: `apps/web` currently has no test suites, so the test scripts are no-ops (by design).
+
+## Practical Outcome / Final Approach
+
+- Always scope commands to `clients/web-ag-ui`.
+- Always use `--filter <package>` to target the exact app you are testing.
+- Avoid running monorepo-root scripts for this workstream.
+- Avoid `pnpm add` inside leaf apps unless patches are fully resolved at the workspace root.
+
+## Recommended Quick Checklist
+
+For any agent in `clients/web-ag-ui/apps/<agent>`:
+
+1. Lint:
+   - `pnpm -C typescript/clients/web-ag-ui --filter <agent-name> run lint`
+
+2. Build:
+   - `pnpm -C typescript/clients/web-ag-ui --filter <agent-name> run build`
+
+3. Tests:
+   - `pnpm -C typescript/clients/web-ag-ui --filter <agent-name> run test`
+
+4. Format (if needed):
+   - `pnpm -C typescript/clients/web-ag-ui --filter <agent-name> run format`
+
+5. Format check:
+   - `pnpm -C typescript/clients/web-ag-ui --filter <agent-name> run format:check`
+
+This keeps the scope tight and avoids unrelated failures.

typescript/clients/web-ag-ui/apps/agent-clmm/.env.test.example

@@ -14,4 +14,4 @@ CLMM_E2E_PRIVATE_KEY=replace-with-private-key
 # Optional: increase live test timeout (milliseconds).
 # EMBER_E2E_TIMEOUT_MS=180000
 # Optional: provide a real Arbitrum RPC endpoint for live txs.
-# ARBITRUM_RPC_URL=https://arb-mainnet.g.alchemy.com/v2/replace-with-key
+# ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc

typescript/clients/web-ag-ui/apps/agent-clmm/src/clients/clients.ts

@@ -1,10 +1,11 @@
 import { createPublicClient, createWalletClient, http, type Account } from 'viem';
 import { arbitrum } from 'viem/chains';
 
+const DEFAULT_ARBITRUM_RPC_URL = 'https://arb1.arbitrum.io/rpc';
+
 const ARBITRUM_RPC_URL =
-  // Default to a public Arbitrum One RPC so local dev works without requiring a paid RPC key.
-  // If you need higher reliability/throughput, set ARBITRUM_RPC_URL to an Alchemy/Infura/etc endpoint.
-  process.env['ARBITRUM_RPC_URL'] ?? 'https://arb1.arbitrum.io/rpc';
+  // Default to a public Arbitrum One RPC for local dev; set ARBITRUM_RPC_URL to override.
+  process.env['ARBITRUM_RPC_URL'] ?? DEFAULT_ARBITRUM_RPC_URL;
 
 const RPC_RETRY_COUNT = 2;
 const RPC_TIMEOUT_MS = 8000;

typescript/clients/web-ag-ui/apps/agent-clmm/src/core/delegatedExecution.ts

@@ -149,10 +149,11 @@ export async function redeemDelegationsAndExecuteTransactions(params: {
   }
 
   const rpcUrl = (params.clients.public as unknown as { transport?: { url?: unknown } }).transport?.url;
+  const defaultArbitrumRpcUrl = 'https://arb1.arbitrum.io/rpc';
   const resolvedRpcUrl =
     typeof rpcUrl === 'string'
       ? rpcUrl
-      : process.env['ARBITRUM_RPC_URL'] ?? 'https://arb-mainnet.g.alchemy.com/v2/demo-key';
+      : process.env['ARBITRUM_RPC_URL'] ?? defaultArbitrumRpcUrl;
 
   const simulationClient = createClient({
     account: params.clients.wallet.account,

typescript/clients/web-ag-ui/apps/agent-clmm/src/workflow/context.unit.test.ts

@@ -66,7 +66,7 @@ describe('ClmmStateAnnotation view reducer history limits', () => {
     expect(view.transactionHistory).toHaveLength(STATE_HISTORY_LIMIT);
     expect(view.transactionHistory[0]?.cycle).toBe(5);
     expect(view.transactionHistory.at(-1)?.cycle).toBe(STATE_HISTORY_LIMIT + 4);
-  });
+  }, 20_000);
 
   it('caps accounting history lists at the configured accounting limit', async () => {
     vi.resetModules();

typescript/clients/web-ag-ui/apps/agent-gmx-allora/.env.example

@@ -1,2 +1,74 @@
+# GMX Allora Agent (.env.example)
+#
+# Copy to `.env` (gitignored) and adjust for local development.
+# This app uses Node's native env loading via `tsx --env-file=...` in scripts.
+
 # Optional: bypass delegation signing by using the agent wallet for execution
 DELEGATIONS_BYPASS=false
+
+# Agent wallet (delegatee).
+# Used for delegation signing context and for tx execution when broadcasting is enabled.
+# If GMX_ALLORA_AGENT_WALLET_ADDRESS is not set, it will be derived from A2A_TEST_AGENT_NODE_PRIVATE_KEY.
+# GMX_ALLORA_AGENT_WALLET_ADDRESS=0x0000000000000000000000000000000000000000
+
+# Onchain-actions base URL.
+# Accepts either a base URL (e.g. https://api.emberai.xyz) or an OpenAPI spec URL
+# (e.g. https://api.emberai.xyz/openapi.json); the agent normalizes to the base URL.
+# ONCHAIN_ACTIONS_API_URL=https://api.emberai.xyz
+
+# Allora API (agent is the only component that talks to Allora directly).
+# ALLORA_API_BASE_URL=https://api.allora.network
+# ALLORA_API_KEY=
+# ALLORA_CHAIN_ID=ethereum-11155111
+#
+# Allora topic whitelist enforced in agent config (`src/config/constants.ts`):
+# - TOPIC 1:  BTC/USD - Log-Return - 8h
+# - TOPIC 3:  SOL/USD - Log-Return - 8h
+# - TOPIC 14: BTC/USD - Price - 8h
+# - TOPIC 19: NEAR/USD - Log-Return - 8h
+# - TOPIC 2:  ETH/USD - Log-Return - 24h
+# - TOPIC 16: ETH/USD - Log-Return - 24h
+# - TOPIC 2:  ETH/USD - Log-Return - 8h
+# - TOPIC 17: SOL/USD - Log-Return - 24h
+# - TOPIC 10: SOL/USD - Price - 8h
+
+# Allora inference cache TTLs (ms). Set to 0 to disable caching.
+# ALLORA_INFERENCE_CACHE_TTL_MS=30000
+# ALLORA_8H_INFERENCE_CACHE_TTL_MS=30000
+
+# GMX agent runtime controls.
+# GMX_ALLORA_MODE=debug               # production (default) | debug
+# GMX_ALLORA_POLL_INTERVAL_MS=1800000  # default 1800000 (30m)
+# GMX_ALLORA_STREAM_LIMIT=-1          # default -1 (no limit)
+# GMX_ALLORA_STATE_HISTORY_LIMIT=100  # default 100
+
+# Transaction submission mode.
+# - plan: build transaction plans via onchain-actions only (no broadcasting)
+# - submit/execute: broadcast planned transactions (dev only; requires agent key)
+# GMX_ALLORA_TX_SUBMISSION_MODE=plan
+# A2A_TEST_AGENT_NODE_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# RPC used when transaction broadcasting is enabled.
+# ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
+
+# Smoke helpers (tests/smoke/gmx-allora-smoke.ts).
+# SMOKE_WALLET=0x0000000000000000000000000000000000000000
+# SMOKE_USDC_ADDRESS=0xaf88d065e77c8cC2239327C5EDb3A432268e5831
+# When DELEGATIONS_BYPASS=false and GMX_ALLORA_TX_SUBMISSION_MODE=execute, smoke runs need a delegator key
+# to sign delegations that the agent wallet can redeem.
+# SMOKE_DELEGATOR_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# LangGraph dev server configuration.
+# If omitted, defaults to http://localhost:8126 and graph id "agent-gmx-allora".
+# LANGGRAPH_DEPLOYMENT_URL=http://localhost:8126
+# LANGGRAPH_GRAPH_ID=agent-gmx-allora
+
+# Optional: pin a thread id for cron/runner scripts (otherwise a UUIDv7 is generated).
+# STARTER_THREAD_ID=
+
+# Optional: run the "starter cron" API runner (see src/cronApiRunner.ts).
+# STARTER_CRON_INTERVAL_MS=5000
+# STARTER_CRON_EXPRESSION=*/5 * * * * *
+
+# Optional: override where the agent looks for config/service.json (expects service.json inside this dir).
+# AGENT_CONFIG_DIR=/absolute/path/to/config/dir

typescript/clients/web-ag-ui/apps/agent-gmx-allora/.env.test.example

@@ -1,2 +1,89 @@
 # CI-safe defaults for integration/e2e tests.
 # Copy this file to `.env.test` to override locally (file is gitignored).
+
+# If set, tests use this URL and skip booting a local onchain-actions worktree.
+# Leave unset to auto-boot a local worktree on http://localhost:50051.
+ONCHAIN_ACTIONS_API_URL=http://localhost:50051
+
+# If agent/web E2E needs to boot onchain-actions + memgraph locally, point at the worktree.
+# Auto-discovery will look for a single `worktrees/onchain-actions-*` directory, but if you have
+# more than one, set this explicitly.
+# ONCHAIN_ACTIONS_WORKTREE_DIR=/absolute/path/to/forge/worktrees/onchain-actions-001
+
+# Optional: override which docker compose file is used to boot memgraph in the onchain-actions worktree.
+# Defaults to `${ONCHAIN_ACTIONS_WORKTREE_DIR}/compose.dev.db.yaml`.
+# ONCHAIN_ACTIONS_MEMGRAPH_COMPOSE_FILE=/absolute/path/to/compose.dev.db.yaml
+
+# Optional: onchain-actions boot overrides used by tests/setup/onchainActions.globalSetup.ts.
+# These are forwarded to the onchain-actions worktree when the test global setup runs.
+# (Most have CI-safe defaults in the setup script, so you typically don't need to set them.)
+# COINGECKO_API_KEY=
+# COINGECKO_USE_PRO=false
+# SQUID_INTEGRATOR_ID=test
+# DUNE_API_KEY=test
+# BIRDEYE_API_KEY=
+# PENDLE_CHAIN_IDS=42161
+# ALGEBRA_CHAIN_IDS=42161
+# GMX_CHAIN_IDS=42161
+# SERVICE_WALLET_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+# DUST_CHAIN_ID=1
+# DUST_CHAIN_RECEIVER_ADDRESS=0x0000000000000000000000000000000000000000
+
+# Allora API (agent is the only component that talks to Allora directly).
+ALLORA_API_BASE_URL=https://api.allora.network
+# ALLORA_API_KEY=
+# ALLORA_CHAIN_ID=ethereum-11155111
+#
+# Allora topic whitelist enforced in agent config (`src/config/constants.ts`):
+# - TOPIC 1:  BTC/USD - Log-Return - 8h
+# - TOPIC 3:  SOL/USD - Log-Return - 8h
+# - TOPIC 14: BTC/USD - Price - 8h
+# - TOPIC 19: NEAR/USD - Log-Return - 8h
+# - TOPIC 2:  ETH/USD - Log-Return - 24h
+# - TOPIC 16: ETH/USD - Log-Return - 24h
+# - TOPIC 2:  ETH/USD - Log-Return - 8h
+# - TOPIC 17: SOL/USD - Log-Return - 24h
+# - TOPIC 10: SOL/USD - Price - 8h
+
+# Allora inference cache TTLs (ms). Set to 0 to disable caching (useful in tests).
+# ALLORA_INFERENCE_CACHE_TTL_MS=0
+# ALLORA_8H_INFERENCE_CACHE_TTL_MS=0
+
+# GMX agent runtime controls (optional).
+# GMX_ALLORA_MODE=debug  # default is production
+# GMX_ALLORA_POLL_INTERVAL_MS=1800000
+# GMX_ALLORA_STREAM_LIMIT=-1
+# GMX_ALLORA_STATE_HISTORY_LIMIT=100
+
+# Agent wallet (delegatee).
+# If GMX_ALLORA_AGENT_WALLET_ADDRESS is not set, it will be derived from A2A_TEST_AGENT_NODE_PRIVATE_KEY.
+# GMX_ALLORA_AGENT_WALLET_ADDRESS=0x0000000000000000000000000000000000000000
+
+# Transaction submission mode (tests default to plan-building).
+GMX_ALLORA_TX_SUBMISSION_MODE=plan
+# A2A_TEST_AGENT_NODE_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# RPC used when transaction broadcasting is enabled.
+# ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
+
+# Smoke/E2E helpers.
+# Used by tests/smoke/gmx-allora-smoke.ts and apps/web/tests/gmxAllora.system.e2e.test.ts.
+SMOKE_WALLET=0x0000000000000000000000000000000000000001
+# Optional profile for web-driven E2E:
+# - mocked: enable agent-local MSW interceptors for Allora + onchain-actions.
+# - live: disable interceptors and use real HTTP providers.
+# E2E_PROFILE=mocked
+# When DELEGATIONS_BYPASS=false and GMX_ALLORA_TX_SUBMISSION_MODE=execute, smoke runs need a delegator key
+# to sign delegations that the agent wallet can redeem.
+# SMOKE_DELEGATOR_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+# SMOKE_USDC_ADDRESS=0x0000000000000000000000000000000000000000
+
+# LangGraph API runner config (optional; used by src/cronApiRunner.ts).
+# LANGGRAPH_DEPLOYMENT_URL=http://localhost:8126
+# LANGGRAPH_GRAPH_ID=agent-gmx-allora
+# STARTER_THREAD_ID=
+# STARTER_CRON_INTERVAL_MS=5000
+# STARTER_CRON_EXPRESSION=*/5 * * * * *
+
+# Optional: override where the agent looks for config/service.json.
+# AGENT_CONFIG_DIR=/absolute/path/to/config/dir