Skip to content

Advanced Autonomous Agent Executor (AAAX)

AAAX AAAX

aaax.one

Advanced Autonomous Agent Executor (AAAX) is the PSI shell for package-shaped agent systems. It gives packages a place to become useful: inspect a manifest, mount its tactics and channels, bind local handlers, open a FastAPI surface, and hand the resulting environment to a human, script, coding agent, or another system.

$ aaax inspect packages/analyst-pack mounted tactic echo -> psi://demo/analyst-pack/tactics/echo mounted channel events -> psi://demo/analyst-pack/channels/events $ aaax serve packages/analyst-pack --port 8400 listening http://127.0.0.1:8400

AAAX stays thin on purpose. LLLM owns tactic execution, SSSN owns semantic channels, PsiHub owns package protocol and storage, and agent tools own their reasoning loops. AAAX is the shell where those resources get named, mounted, served, and passed along.

AAAX also works independently. A Strategy can be a Pydantic-modeled resource table with local handlers and a FastAPI app. Add LLLM, SSSN, and PsiHub only when you want their tactic, channel, or package layers.

Inspect Read a package or strategy and see the local command surface before serving it.
Mount Mount `psi.toml` resources into one shell without erasing their `psi://` refs.
Pipe Call tactics, append/query channels, and invoke resources through stable endpoints.
Handoff Preserve cards, docs, examples, assets, and service URLs for people and agents.

Fast Path

Serve a package:

aaax serve packages/analyst-pack --port 8400

Call a tactic:

curl -X POST http://127.0.0.1:8400/tactics/echo/run \
  -H 'content-type: application/json' \
  -d '{"input": {"text": "hello"}, "context": {"request": "demo"}}'

Write and read a channel:

curl -X POST http://127.0.0.1:8400/channels/events/events \
  -H 'content-type: application/json' \
  -d '{"input": {"kind": "record", "payload": {"text": "hello"}}}'

curl 'http://127.0.0.1:8400/channels/events/events?limit=10'

Shape

flowchart LR A["PsiHub package"] --> B["AAAX shell"] C["strategy.py"] --> B B --> D["resource table"] B --> E["Pydantic/FastAPI surface"] E --> F["LLLM tactics"] E --> G["SSSN channels"] D --> H["human, agent, or system handoff"]

AAAX treats a package like something you mount into a shell session. The local name can change, but the package ref remains stable. A caller can list what is mounted, run one tactic, append an event, invoke a service, or call the shell's top-level /run command. That caller can be a person, an app, an agent, or the next system in a larger loop.

What AAAX Owns

  • Strategy, StrategyResource, and the shell's mounted resource table.
  • Pydantic request, response, resource, and strategy description models.
  • Loading strategy.py, aaax.py, module:factory, package folders, and direct psi.toml files.
  • Mounting PsiHub package resources into one local namespace.
  • Binding Python tactic entrypoints through LLLM when available.
  • Opening SSSN-backed local channel endpoints.
  • Serving the shell through FastAPI and the aaax CLI.

What Stays Outside

  • LLM provider execution, tool policy, traces, evals, and runtime internals.
  • Package indexing, package upload/download, validation reports, and hub storage.
  • Durable production storage, deployment, queueing, and service orchestration.
  • Coding-agent behavior itself. AAAX gives agents a shell surface; it does not decide how they reason.

Next