aoa-demo 1.0.0__tar.gz

aoa_demo-1.0.0/.gitignore

@@ -0,0 +1,93 @@
+# ============================================================================
+# Python
+# ============================================================================
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# ============================================================================
+# Virtual environments
+# ============================================================================
+.venv/
+venv/
+ENV/
+env/
+
+# ============================================================================
+# Distribution / packaging
+# ============================================================================
+build/
+dist/
+*.egg-info/
+*.egg
+.eggs/
+wheels/
+
+# ============================================================================
+# Testing
+# ============================================================================
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+*.cover
+.hypothesis/
+.tox/
+.nox/
+
+# ============================================================================
+# Type checking
+# ============================================================================
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+
+# ============================================================================
+# Node (Maxitor web client — source lives in git; node_modules stays local only)
+# ============================================================================
+packages/aoa-maxitor/client/node_modules/
+packages/aoa-maxitor/client/.vite/
+
+# ============================================================================
+# IDE
+# ============================================================================
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# ============================================================================
+# Logs and temporary files
+# ============================================================================
+*.log
+code_quality.log
+*.tmp
+*.temp
+ocel_log.json
+
+# ============================================================================
+# Project specific - ARCHIVE (ваши локальные снимки)
+# ============================================================================
+archive/
+*.ver
+code.txt
+project_structure.txt
+
+# ============================================================================
+# Локальные черновики (русские версии документации и примеров)
+# ============================================================================
+*_draft.md
+*_draft.py
+.ipynb_checkpoints/
+docs/ru/
+
+# ============================================================================
+# НЕ ИГНОРИРУЕМ - эти файлы должны быть в git!
+# ============================================================================
+!.python-version
+!uv.lock

aoa_demo-1.0.0/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to `aoa-demo` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] – 2026-06-27
+
+### Changed
+
+- **Package renamed `aoa-examples` → `aoa-demo`; import namespace `aoa.examples` → `aoa.demo`.** The distribution of reference/demo domain models (`model/billing`, `model/inventory`, `model/store`, …) and the FastAPI + MCP showcase services is now `aoa-demo`. Install `aoa-demo` and update imports (`from aoa.examples.model… ` → `from aoa.demo.model…`). The rename removes the naming collision with the root `examples/` tutorial scripts and makes clear the package is a library of runnable demo domains, not tutorial snippets. The undeclared `aoa-maxitor` → demo coupling was also removed: three demo-dependent `aoa-maxitor` tests were dropped so the `maxitor` package no longer references `demo` in any form. ([#83](https://github.com/bystrovmaxim/aoa/issues/83))
+- **Test suite relocated into the package (`packages/aoa-examples/tests/`).** Example model tests moved out of the shared root `tests/examples/` — plus the clean `depends`-modes use-case test from the legacy `aoa_examples_tests/` directory — into the package's own `tests/` directory, with a per-package `[dependency-groups]` dev group and `[tool.pytest.ini_options]` (`testpaths`, `asyncio_mode`, `pythonpath`). The OCEL/pm4py coverage was moved out of this package entirely — converted into the runnable example `packages/aoa-ocel/examples/01_ocel_export.py` and covered by tests under `packages/aoa-ocel/tests/`. The root `tests/examples/` zone is now empty; the legacy `aoa_examples_tests/` directory is removed. ([#82](https://github.com/bystrovmaxim/aoa/issues/82))
+
+### Removed
+
+- **Store-domain OCEL export sub-feature.** The `PublishOrder*OcelAction` / `RecordOrderOcelAction` trace actions, the `build_store_ocel_machine` / `run_store_ocel_trace_batch` helpers, and `StoreOcelStoreResource` were removed from `aoa.examples.model.store`. The OCEL 2.0 export flow is now demonstrated by the self-contained runnable example `packages/aoa-ocel/examples/01_ocel_export.py` in the `aoa-ocel` package. ([#82](https://github.com/bystrovmaxim/aoa/issues/82))
+
+## [0.1.0] – 2026-06-24
+
+### Added
+
+- **Initial standalone release.** Runnable tutorial and how-to examples distributed as a separate package (`pip install aoa-examples`). Each example ships as both a plain `.py` and a Colab-ready `.ipynb` with `!pip install` cell and top-level `await`. Covers the full tutorial set (steps 00–26) plus how-to, extension, and research examples.

aoa_demo-1.0.0/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: aoa-demo
+Version: 1.0.0
+Summary: Example FastAPI and MCP services demonstrating ActionMachine.
+Project-URL: Homepage, https://github.com/action-machine/action-machine
+Project-URL: Documentation, https://action-machine.readthedocs.io
+Project-URL: Repository, https://github.com/action-machine/action-machine
+Author: @Bystrov.Maxim
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: aoa-action-machine<2.0.0,>=1.0.0a5
+Requires-Dist: aoa-ocel>=1.0.0a0
+Requires-Dist: pydantic<3.0,>=2.0
+Provides-Extra: fastapi
+Requires-Dist: aoa-fastapi-adapter>=1.0.0a0; extra == 'fastapi'
+Provides-Extra: mcp
+Requires-Dist: aoa-mcp-adapter>=1.0.0a0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="../../docs/assets/aoa-logo.png" alt="AOA" width="660"><br><br>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.12%2B-blue?logo=python&logoColor=white" alt="Python 3.12+"></a>
+  <a href="https://github.com/bystrovmaxim/aoa"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT"></a>
+  <a href="https://github.com/bystrovmaxim/aoa/actions/workflows/ci.yml"><img src="https://github.com/bystrovmaxim/aoa/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <img src="https://img.shields.io/badge/version-1.0.0-informational" alt="1.0.0">
+</p>
+
+# aoa-demo: Reference Services for AOA
+
+`aoa-demo` contains two runnable reference services — a FastAPI HTTP service and an MCP server — built on the same domain model: orders, products, and customers. Both services expose the same `Action` operations over different transports, demonstrating how a single piece of business logic is published via `FastApiAdapter` for REST clients and via `McpAdapter` for AI agents without duplicating any logic. The package also serves as the integration fixture used in the AOA test suite.

aoa_demo-1.0.0/README.md

@@ -0,0 +1,11 @@
+<p align="center">
+  <img src="../../docs/assets/aoa-logo.png" alt="AOA" width="660"><br><br>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.12%2B-blue?logo=python&logoColor=white" alt="Python 3.12+"></a>
+  <a href="https://github.com/bystrovmaxim/aoa"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT"></a>
+  <a href="https://github.com/bystrovmaxim/aoa/actions/workflows/ci.yml"><img src="https://github.com/bystrovmaxim/aoa/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <img src="https://img.shields.io/badge/version-1.0.0-informational" alt="1.0.0">
+</p>
+
+# aoa-demo: Reference Services for AOA
+
+`aoa-demo` contains two runnable reference services — a FastAPI HTTP service and an MCP server — built on the same domain model: orders, products, and customers. Both services expose the same `Action` operations over different transports, demonstrating how a single piece of business logic is published via `FastApiAdapter` for REST clients and via `McpAdapter` for AI agents without duplicating any logic. The package also serves as the integration fixture used in the AOA test suite.

aoa_demo-1.0.0/pyproject.toml

@@ -0,0 +1,48 @@
+# packages/aoa-demo/pyproject.toml — publishable distribution for ``aoa.demo``.
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "aoa-demo"
+version = "1.0.0"
+description = "Example FastAPI and MCP services demonstrating ActionMachine."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.12"
+authors = [{ name = "@Bystrov.Maxim" }]
+dependencies = [
+    "aoa-action-machine>=1.0.0a5,<2.0.0",
+    "aoa-ocel>=1.0.0a0",
+    "pydantic>=2.0,<3.0",
+]
+
+[tool.uv.sources]
+aoa-action-machine = { workspace = true }
+aoa-fastapi-adapter = { workspace = true }
+aoa-mcp-adapter = { workspace = true }
+aoa-ocel = { workspace = true }
+
+[project.optional-dependencies]
+fastapi = [
+    "aoa-fastapi-adapter>=1.0.0a0",
+]
+mcp = [
+    "aoa-mcp-adapter>=1.0.0a0",
+]
+
+[project.urls]
+Homepage = "https://github.com/action-machine/action-machine"
+Documentation = "https://action-machine.readthedocs.io"
+Repository = "https://github.com/action-machine/action-machine"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/aoa"]
+
+[dependency-groups]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.24"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+pythonpath = ["src"]

aoa_demo-1.0.0/src/aoa/demo/__init__.py

@@ -0,0 +1,36 @@
+# packages/aoa-demo/src/aoa/demo/__init__.py
+"""
+Usage examples for ActionMachine.
+
+═══════════════════════════════════════════════════════════════════════════════
+PURPOSE
+═══════════════════════════════════════════════════════════════════════════════
+
+Demonstrate end-to-end wiring (e.g. FastAPI + MCP with shared actions) without
+shipping example code inside the core ``action_machine`` package. Actions use
+standard **Intent** mixins on ``BaseAction`` and decorators for metadata and
+pipeline behavior. See the repository root ``README.md`` (Intent / architecture
+sections) and ``docs/CHANGELOG.md`` for naming and API notes.
+
+═══════════════════════════════════════════════════════════════════════════════
+ARCHITECTURE / DATA FLOW
+═══════════════════════════════════════════════════════════════════════════════
+
+    action_machine (library)
+              ^
+              | imports only from here as a separate namespace
+              |
+    examples/  (this package)
+              |
+              +-- model/
+              |       interchange + bounded-context demo domains for Maxitor
+              |
+              +-- fastapi_mcp_services/
+              |       dual-transport app + shared actions
+              |
+              +-- (future example packages)
+
+    Consumers typically copy or study subpackages; the library does not depend
+    on ``examples`` at runtime.
+
+"""

aoa_demo-1.0.0/src/aoa/demo/fastapi_mcp_services/README.md

@@ -0,0 +1,286 @@
+<p align="center">
+  <img src="../../../../../../docs/assets/aoa-logo.png" alt="AOA" width="660"><br><br>
+  <a href="https://github.com/bystrovmaxim/aoa"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.12%2B-blue?logo=python&logoColor=white" alt="Python 3.12+"></a>
+  <img src="https://img.shields.io/badge/extras-fastapi%20·%20mcp-lightgrey" alt="aoa-demo[fastapi,mcp]">
+  <a href="../../../../README.md"><img src="https://img.shields.io/badge/docs-aoa--examples-blue" alt="aoa-demo"></a>
+</p>
+
+# ActionMachine — FastAPI + MCP from one codebase
+
+This example illustrates a core ActionMachine principle: **the same Actions
+run through any protocol adapter without modification**.
+
+Actions inherit the standard set of **Intent** mixins from `BaseAction` and
+declare behavior with decorators (`@meta`, `@check_roles`, aspects, dependencies).
+The metadata graph is built when `NodeGraphCoordinator.build()` runs from those declarations —
+see the “Key concepts: Intent” section in the root `README.md`.
+
+Three actions (PingAction, CreateOrderAction, GetOrderAction) are defined once
+and wired to two transports: HTTP REST API (FastAPI) and MCP tools (for AI agents).
+
+> **Production:** do not copy `NoAuthCoordinator` from this example into production without thought.
+> For protected APIs, replace it with your own `AuthCoordinator` and real authentication.
+> `NoAuthCoordinator` here is an explicit “open endpoint”, for demonstration only.
+
+## Installation
+
+```bash
+# For the HTTP service:
+pip install aoa-run[fastapi]
+
+# For the MCP server:
+pip install aoa-run[mcp]
+
+# Both:
+pip install aoa-run[fastapi,mcp]
+```
+
+## Running FastAPI (HTTP)
+
+```bash
+uvicorn aoa.demo.fastapi_mcp_services.app_fastapi_service:app --reload
+```
+
+
+| URL                                                                      | Description    |
+| ------------------------------------------------------------------------ | -------------- |
+| [http://localhost:8000/docs](http://localhost:8000/docs)                 | Swagger UI     |
+| [http://localhost:8000/redoc](http://localhost:8000/redoc)               | ReDoc          |
+| [http://localhost:8000/openapi.json](http://localhost:8000/openapi.json) | OpenAPI schema |
+| [http://localhost:8000/health](http://localhost:8000/health)             | Health check   |
+
+
+## Running MCP (AI agents)
+
+```bash
+# Via stdio (Claude Desktop, Claude Code):
+python -m aoa.demo.fastapi_mcp_services.app_mcp_service
+
+# Via streamable-http (MCP Inspector):
+python -m aoa.demo.fastapi_mcp_services.app_mcp_service --transport streamable-http
+```
+
+---
+
+## Actions (shared by both transports)
+
+
+| Action            | FastAPI                         | MCP Tool        | Description     |
+| ----------------- | ------------------------------- | --------------- | --------------- |
+| PingAction        | `GET /api/v1/ping`              | `system.ping`   | Liveness check  |
+| CreateOrderAction | `POST /api/v1/orders`           | `orders.create` | Create an order |
+| GetOrderAction    | `GET /api/v1/orders/{order_id}` | `orders.get`    | Fetch an order  |
+
+
+FastAPI also registers `GET /health → {"status": "ok"}` automatically.
+
+### CreateOrderAction parameters
+
+
+| Field      | Type  | Required          | Constraints        | Description            |
+| ---------- | ----- | ----------------- | ------------------ | ---------------------- |
+| `user_id`  | str   | yes               | min_length=1       | User ID                |
+| `amount`   | float | yes               | gt=0               | Order amount           |
+| `currency` | str   | no (default: RUB) | pattern=^[A-Z]{3}$ | ISO 4217 currency code |
+
+
+### Examples
+
+**Create order (curl):**
+
+```bash
+curl -X POST http://localhost:8000/api/v1/orders \
+  -H "Content-Type: application/json" \
+  -d '{"user_id": "user_123", "amount": 1500.0, "currency": "RUB"}'
+```
+
+**Response (same shape for HTTP and MCP):**
+
+```json
+{
+  "order_id": "ORD-user_123-001",
+  "status": "created",
+  "total": 1500.0
+}
+```
+
+**Ping:**
+
+```bash
+curl http://localhost:8000/api/v1/ping
+```
+
+```json
+{"message": "pong"}
+```
+
+---
+
+## FastAPI: automatic OpenAPI generation
+
+The OpenAPI schema is generated from metadata already in the code:
+
+- **Field descriptions** → from `Field(description="...")` on Params and Result
+- **Constraints** → from `Field(gt=0, min_length=3, pattern=...)` on Params
+- **Examples** → from `Field(examples=["..."])` on Params and Result
+- **Endpoint summary** → from the action’s `@meta(description="...")`
+- **Tags** → from the `tags=[...]` argument when registering the route
+
+Nothing is duplicated — descriptions are written once in the Pydantic models.
+
+## FastAPI: error handling
+
+
+| Exception              | HTTP status               | Description              |
+| ---------------------- | ------------------------- | ------------------------ |
+| `AuthorizationError`   | 403 Forbidden             | Insufficient permissions |
+| `ValidationFieldError` | 422 Unprocessable Entity  | Field validation error   |
+| Anything else          | 500 Internal Server Error | Internal error           |
+
+
+---
+
+## MCP: available resources
+
+
+| Resource         | Description                                                             |
+| ---------------- | ----------------------------------------------------------------------- |
+| `system://graph` | System structure: nodes (actions, domains), edges (depends, belongs_to) |
+
+
+```json
+{
+  "nodes": [
+    {"id": "CreateOrderAction", "type": "action", "description": "Create a new order", "domain": "orders"},
+    {"id": "OrdersDomain", "type": "domain", "name": "orders"}
+  ],
+  "edges": [
+    {"from": "CreateOrderAction", "to": "OrdersDomain", "type": "belongs_to"}
+  ]
+}
+```
+
+## MCP: error handling
+
+
+| Exception              | MCP response             |
+| ---------------------- | ------------------------ |
+| `AuthorizationError`   | `PERMISSION_DENIED: ...` |
+| `ValidationFieldError` | `INVALID_PARAMS: ...`    |
+| Anything else          | `INTERNAL_ERROR: ...`    |
+
+
+---
+
+## Claude Desktop integration
+
+In `claude_desktop_config.json`:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "orders": {
+      "command": "python",
+      "args": ["-m", "aoa.demo.fastapi_mcp_services.app_mcp_service"]
+    }
+  }
+}
+```
+
+## Claude Code integration
+
+```bash
+claude mcp add orders -- python -m aoa.demo.fastapi_mcp_services.app_mcp_service
+```
+
+## Testing with MCP Inspector
+
+```bash
+# Terminal 1:
+python -m aoa.demo.fastapi_mcp_services.app_mcp_service --transport streamable-http
+
+# Terminal 2:
+npx -y @modelcontextprotocol/inspector
+```
+
+Connect to `http://localhost:8000/mcp`, open the **Tools** tab → **List Tools**.
+
+---
+
+## Architecture
+
+```
+HTTP client                   AI agent
+(curl, browser)               (Claude, ChatGPT)
+    │                              │
+    │  HTTP                        │  MCP protocol
+    ▼                              ▼
+FastApiAdapter               McpAdapter
+(app_fastapi_service.py)     (app_mcp_service.py)
+    │                              │
+    └──────────┬───────────────────┘
+               │
+               ▼
+       ActionProductMachine
+       (infrastructure.py)
+               │
+       ┌───────┼───────┐
+       │       │       │
+    Ping    Create    Get
+    Action  Order    Order
+            Action   Action
+```
+
+An Action is a unit of business logic. An adapter is transport. One action
+serves HTTP clients and AI agents at the same time, without duplication.
+
+## Package layout
+
+```
+fastapi_mcp_services/
+├── __init__.py              ← example overview
+├── infrastructure.py        ← built ``NodeGraphCoordinator`` + ``ActionProductMachine`` (shared)
+├── domains.py               ← business domains (OrdersDomain, SystemDomain)
+├── actions/
+│   ├── __init__.py
+│   ├── ping.py              ← PingAction
+│   ├── create_order.py      ← CreateOrderAction
+│   └── get_order.py         ← GetOrderAction
+├── app_fastapi_service.py   ← FastAPI app (HTTP)
+├── app_mcp_service.py       ← MCP server (AI agents)
+└── README.md                ← this file
+```
+
+## Fluent chain
+
+Optional keyword-only `connections` on each fluent call passes resources into `machine.run` for that route or tool only; use `PerCallConnection` when the resource must be built per request or per tool invocation (see `aoa.action_machine.resources.per_call_connection`).
+
+**FastAPI:**
+
+```python
+app = (
+    FastApiAdapter(machine=machine, title="Orders API", version="0.1.0")
+    .get("/api/v1/ping", PingAction, tags=["system"])
+    .post("/api/v1/orders", CreateOrderAction, tags=["orders"])
+    .get("/api/v1/orders/{order_id}", GetOrderAction, tags=["orders"])
+    .build()
+)
+```
+
+**MCP:**
+
+```python
+server = (
+    McpAdapter(machine=machine, server_name="Orders MCP", server_version="0.1.0")
+    .tool("system.ping", PingAction)
+    .tool("orders.create", CreateOrderAction)
+    .tool("orders.get", GetOrderAction)
+    .build()
+)
+```
+
+Same Actions. Different adapters. Zero duplication.

aoa_demo-1.0.0/src/aoa/demo/fastapi_mcp_services/__init__.py

@@ -0,0 +1,61 @@
+# packages/aoa-demo/src/aoa/demo/fastapi_mcp_services/__init__.py
+"""
+Example services on ActionMachine — FastAPI and MCP from one codebase.
+
+═══════════════════════════════════════════════════════════════════════════════
+PURPOSE
+═══════════════════════════════════════════════════════════════════════════════
+
+Demonstrates a core ActionMachine idea: the same Action classes run through any
+protocol adapter without changing business code.
+
+Three actions (``CreateOrderAction``, ``GetOrderAction``, ``PingAction``) are
+defined once under ``actions/`` and wired to two transports:
+
+- **FastAPI** (``app_fastapi_service.py``) — HTTP REST with OpenAPI.
+- **MCP** (``app_mcp_service.py``) — MCP server for AI agents (e.g. Claude,
+  ChatGPT, Cursor).
+
+Validation, checkers, logging, and plugins stay shared; adapters stay a thin
+transport layer.
+
+Actions use **Intent** mixins on ``BaseAction`` and decorators (``@meta``,
+``@check_roles``, aspects). Metadata is assembled when ``NodeGraphCoordinator.build()`` runs;
+see the root ``README.md`` (Intent section).
+
+═══════════════════════════════════════════════════════════════════════════════
+ARCHITECTURE / DATA FLOW
+═══════════════════════════════════════════════════════════════════════════════
+
+         +------------------ actions/ ------------------+
+         |  PingAction, CreateOrderAction, GetOrderAction |
+         +------------------------+-----------------------+
+                                  |
+              +-------------------+-------------------+
+              |                                       |
+       FastApiAdapter                         McpAdapter
+    app_fastapi_service                   app_mcp_service
+              |                                       |
+              v                                       v
+        HTTP clients                          AI / tool clients
+
+    infrastructure.py  ->  ActionProductMachine + NoAuthCoordinator
+    orders_domain.py / system_domain.py  ->  OrdersDomain, SystemDomain
+
+Package layout:
+
+    fastapi_mcp_services/
+    ├── __init__.py              <- this file
+    ├── infrastructure.py        <- ActionProductMachine + NoAuthCoordinator
+    ├── orders_domain.py          <- OrdersDomain
+    ├── system_domain.py          <- SystemDomain
+    ├── actions/
+    │   ├── __init__.py
+    │   ├── ping.py              <- PingAction
+    │   ├── create_order.py      <- CreateOrderAction
+    │   └── get_order.py         <- GetOrderAction
+    ├── app_fastapi_service.py   <- FastAPI app (HTTP)
+    ├── app_mcp_service.py       <- MCP server (AI agents)
+    └── README.md
+
+"""

aoa_demo-1.0.0/src/aoa/demo/fastapi_mcp_services/actions/__init__.py

@@ -0,0 +1,43 @@
+# packages/aoa-demo/src/aoa/demo/fastapi_mcp_services/actions/__init__.py
+"""
+Shared actions for FastAPI and MCP services.
+
+═══════════════════════════════════════════════════════════════════════════════
+PURPOSE
+═══════════════════════════════════════════════════════════════════════════════
+
+This package exports canonical action classes used by both HTTP (FastAPI) and
+MCP adapters in the example service. Action definitions, validation rules, and
+Params/Result models are shared across transports.
+
+═══════════════════════════════════════════════════════════════════════════════
+ARCHITECTURE / DATA FLOW
+═══════════════════════════════════════════════════════════════════════════════
+
+         +-------------------------------------+
+         | actions package (__init__)          |
+         |  - PingAction                       |
+         |  - CreateOrderAction                |
+         |  - GetOrderAction                   |
+         +-----------------+-------------------+
+                           |
+               +-----------+-----------+
+               |                       |
+        FastApiAdapter           McpAdapter
+      (HTTP endpoints)        (MCP tools for AI)
+               |                       |
+               +-----------+-----------+
+                           |
+                 shared action logic
+
+"""
+
+from .create_order import CreateOrderAction
+from .get_order import GetOrderAction
+from .ping import PingAction
+
+__all__ = [
+    "CreateOrderAction",
+    "GetOrderAction",
+    "PingAction",
+]