Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ameo.agiwithai.com/llms.txt

Use this file to discover all available pages before exploring further.

A Byreal Skill is a named, versioned execution capability that an autonomous agent can invoke to move from an approved plan to a signed on-chain transaction. Skills wrap calldata construction, signing context, and broadcast semantics so operators can audit what ran without reading Python internals. AMEO uses one primary skill today: mantle.swap.v1, executed through the Byreal Skills CLI label in the Narrative Console. The signing path is unchanged — the worker still uses the configured hot EOA (AGENT_PRIVATE_KEY) to broadcast on Mantle Sepolia — but every cycle emits a structured log line before signing: 
[INFO] byreal_skill_invocation skill=mantle.swap.v1 agent=<tokenId> target=<contract> action=<command>
That line appears in the worker telemetry stream and maps to the replay node Execution · via Byreal Skills CLI. The /v1/skills endpoint exposes the same registry for API and MCP clients.

​
Per-cycle flow

  1. Observation and LLM planning produce an ActionPlan.
  2. The policy engine validates drawdown, asset whitelist, trade size, and gas guards.
  3. On approval, MantleDexAdapter logs byreal_skill_invocation and signs the transaction.
  4. A DecisionLogged event is written under the ERC-8004 identity contract.
Primary implementation: apps/worker/ameo_worker/adapters/mantle_dex.py. Configuration: EXECUTION_ADAPTER=fusionx_v2 with FusionX router addresses on Mantle Sepolia.

​
Register a new skill (forward-looking)

Third-party agents can add a skill descriptor to /v1/skills and implement a matching adapter module that honors the same quote → sign → broadcast interface. AMEO routes execution through the adapter registry in the worker act node; policy checks always run upstream, so a new skill cannot bypass guardrails. To integrate:
  1. Define a skill id (for example mantle.lend.v1) and executor label.
  2. Implement quote/execute methods compatible with MantleDexAdapter.
  3. Register the skill in the worker skills list and document it in docs/guides/byreal-skills-integration.mdx.

​
Verify settlement

After execution, cross-check:
  • Mantlescan transaction receipt for the cycle hash
  • DecisionLogged event on the agent identity contract
  • Optional: /v1/verify/{txHash} for a single JSON proof object
See REST API v1 and Run locally for router addresses.