agent-easy-framework 0.0.3__py3-none-any.whl

agent_easy_framework-0.0.3.dist-info/METADATA

@@ -0,0 +1,499 @@
+Metadata-Version: 2.4
+Name: agent-easy-framework
+Version: 0.0.3
+Summary: Enterprise golden-path framework for scaffolding MCP-first agent servers in Python.
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: uvicorn>=0.29.0
+Provides-Extra: all
+Requires-Dist: asyncpg>=0.29.0; extra == 'all'
+Requires-Dist: grpcio>=1.62.0; extra == 'all'
+Requires-Dist: httpx>=0.27.0; extra == 'all'
+Requires-Dist: neo4j>=5.18.0; extra == 'all'
+Requires-Dist: pyjwt[crypto]>=2.8.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27.0; extra == 'dev'
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Requires-Dist: vulture>=2.11; extra == 'dev'
+Provides-Extra: grpc
+Requires-Dist: grpcio>=1.62.0; extra == 'grpc'
+Provides-Extra: neo4j
+Requires-Dist: neo4j>=5.18.0; extra == 'neo4j'
+Provides-Extra: oidc
+Requires-Dist: httpx>=0.27.0; extra == 'oidc'
+Requires-Dist: pyjwt[crypto]>=2.8.0; extra == 'oidc'
+Provides-Extra: postgres
+Requires-Dist: asyncpg>=0.29.0; extra == 'postgres'
+Description-Content-Type: text/markdown
+
+# agent-easy
+
+**Scaffold production-ready MCP servers in Python — without inventing the plumbing.**
+
+You want agents to call your tools over the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). You do not want to wire up transports, config, secrets, auth, health checks, and lint gates from scratch every time.
+
+This framework generates a **complete, typed, testable MCP server project** you own. Run one command, configure YAML profiles, add your tools, ship.
+
+> **PyPI package:** `agent-easy-framework` · **CLI:** `agent-easy` (`pip install agent-easy-framework`, then `agent-easy mcp …`)
+
+> **You do not import this as a library at runtime.** It is a generator (like JHipster or `npx create-*`). The output is a standalone repo your team maintains.
+
+---
+
+## Quickstart (no clone)
+
+```bash
+uvx agent-easy-framework mcp my-service
+cd my-service && make setup && make example
+```
+
+That scaffolds a stdio MCP server with a sample `ping` tool and runs it in-process (~5 seconds). Attach an MCP client with `make run` when ready.
+
+Add another tool endpoint:
+
+```bash
+cd my-service
+uvx agent-easy-framework mcp add-tool echo_reply
+make check
+```
+
+Or from the project Makefile (same command, requires network):
+
+```bash
+cd my-service
+make add-tool TOOL=echo_reply
+make check
+```
+
+Full options:
+
+```bash
+uvx agent-easy-framework mcp billing-agent \
+  --datasources postgres,neo4j \
+  --transports stdio,http \
+  --auth oidc
+```
+
+Locked-down environments (no `uvx`):
+
+```bash
+pip install agent-easy-framework
+agent-easy mcp billing-agent --datasources neo4j --auth oidc
+```
+
+---
+
+## At a glance
+
+| | |
+|---|---|
+| **What it generates** | An MCP-first Python server with tools, data sources, auth, and ops endpoints |
+| **Who it is for** | Engineers shipping agent tools to Claude Desktop, IDEs, or internal platforms |
+| **Config model** | YAML profiles (Spring-style). No environment variables |
+| **Quality bar** | `mypy --strict`, ruff, dead-code detection, golden-path fact-checks baked in |
+| **Deep reference** | [GOLDEN_PATH.md](GOLDEN_PATH.md) — the contract every generated server follows |
+| **Copy-paste examples** | [examples/README.md](examples/README.md) — call `ping`, curl ops, browse live docs |
+
+---
+
+## Try it now (reference server)
+
+For contributors or anyone exploring the generator source, clone this repo:
+
+```bash
+make setup
+make example          # Flow 1: ping in-process — no server (~5 seconds)
+```
+
+Call the tool over HTTP MCP (two terminals):
+
+```bash
+make run-http         # terminal 1
+make example-http     # terminal 2 — Streamable HTTP client, not curl
+./examples/smoke_ops.sh   # optional: ops REST at :8080
+```
+
+Full walkthrough: [examples/README.md](examples/README.md).
+
+---
+
+## Your journey (start to shipped)
+
+Follow this path whether you are new to MCP or just do not want to rebuild the same skeleton again.
+
+```mermaid
+flowchart LR
+  subgraph step1 [1. Generate]
+    gen["uvx agent-easy-framework mcp …"]
+  end
+  subgraph step2 [2. Configure]
+    yaml["YAML profiles + secrets"]
+  end
+  subgraph step3 [3. Run]
+    run["make run / make docs"]
+  end
+  subgraph step4 [4. Extend]
+    tools["Add @tool handlers"]
+  end
+  subgraph step5 [5. Ship]
+    ci["make check + CI"]
+  end
+  gen --> yaml --> run --> tools --> ci
+```
+
+<details>
+<summary><strong>Step 1 — Generate your server</strong></summary>
+
+Pick only what you need. Unused providers and transports are pruned so dependencies stay minimal.
+
+```bash
+uvx agent-easy-framework mcp billing-agent \
+  --datasources postgres,neo4j \
+  --transports stdio,http \
+  --auth oidc
+```
+
+| Flag | Options | Default | When to use |
+|------|---------|---------|-------------|
+| `--output`, `-o` | directory path | `.` | Parent folder for the new project |
+| `--package` | Python identifier | derived from name | Override the import package name |
+| `--datasources` | `postgres`, `neo4j` | none | Your tools need a database |
+| `--transports` | `stdio`, `http`, `grpc` | `stdio` | `stdio` = local/IDE; `http` = deployed; `grpc` = custom adapter |
+| `--auth` | `none`, `oidc`, `basic` | `none` | `oidc` for SSO in prod; `basic` is **testing only** (runtime API key) |
+| `--profile` | any name | `local` | Default active profile in `config/base.yaml` |
+
+### Add a tool to an existing project
+
+Run from the project root (or pass `-C`). Requires `uvx` and the published `agent-easy-framework` package:
+
+```bash
+cd my-service
+uvx agent-easy-framework mcp add-tool echo_reply
+uvx agent-easy-framework mcp add-tool send_invoice -d "Create and send a customer invoice."
+make check
+```
+
+Or use the Makefile wrapper:
+
+```bash
+make add-tool TOOL=echo_reply
+make check
+```
+
+> **Profile note:** `make run` uses the active profile (`local` by default). The `local` profile forces stdio + no auth. Use `PROFILE=prod` or `make run-http` for HTTP/OIDC settings from generate flags.
+
+Locked-down environments (no `uvx`):
+
+```bash
+pip install agent-easy-framework
+agent-easy mcp billing-agent --datasources neo4j --auth oidc
+```
+
+</details>
+
+<details>
+<summary><strong>Step 2 — Configure profiles and secrets</strong></summary>
+
+Generated layout:
+
+```
+billing-agent/
+  config/
+    base.yaml              # shared defaults + active_profile
+    profiles/
+      local.yaml           # deep-merged on top of base
+      prod.yaml
+  secrets/                 # file-based secret provider (gitignored)
+    neo4j/password
+```
+
+**Profiles** — Spring-style. One knob at runtime:
+
+```bash
+billing-agent run                  # uses active_profile from base.yaml
+billing-agent run --profile prod   # override
+```
+
+**Secrets** — never committed as raw values. Reference them in YAML:
+
+```yaml
+password: ${secret:neo4j/password}
+```
+
+Create the file: `secrets/neo4j/password` (or plug in Vault / cloud providers later).
+
+**OIDC example** (`config/profiles/prod.yaml`):
+
+```yaml
+server:
+  auth:
+    provider: oidc
+    options:
+      issuer: https://login.your-idp.com/
+      audience: billing-agent
+      jwks_uri: https://login.your-idp.com/.well-known/jwks.json
+```
+
+</details>
+
+<details>
+<summary><strong>Step 3 — Install and run</strong></summary>
+
+```bash
+cd billing-agent
+make setup          # venv + minimal deps for your selection
+make run            # serve with default profile
+make run PROFILE=prod
+make docs           # live docs site from your tool registry (nothing committed)
+```
+
+Ops endpoints (for load balancers / k8s) — default **`127.0.0.1:8080`**:
+
+| Endpoint | Purpose |
+|----------|---------|
+| `GET /health` | Liveness — process is up |
+| `GET /ready` | Readiness — all data sources healthy |
+| `GET /admin/tools` | Registered tools and descriptions |
+
+Other default ports:
+
+| Surface | Default | Notes |
+|---------|---------|-------|
+| MCP (HTTP) | `8000` at `/mcp` | Streamable HTTP when `--transports http` |
+| Live docs | `8090` | `make docs` — registry-generated, not committed |
+
+</details>
+
+<details>
+<summary><strong>Step 4 — Add your tools</strong></summary>
+
+A tool is an async function with a typed Pydantic input model. The docstring becomes the MCP description.
+
+Create `src/billing_agent/core/tools/invoice.py` (requires `--datasources postgres` in Step 1):
+
+```python
+from pydantic import BaseModel, Field
+
+from billing_agent.core.context import AppContext
+from billing_agent.core.registry import tool
+
+
+class LookupInput(BaseModel):
+    invoice_id: str = Field(description="Invoice ID to fetch.")
+
+
+class LookupOutput(BaseModel):
+    total: float
+    status: str
+
+
+@tool
+async def lookup_invoice(params: LookupInput, ctx: AppContext) -> LookupOutput:
+    """Fetch an invoice total and status from the primary database."""
+    db = ctx.datasource("primary")   # name from config/server.datasources
+    rows = await db.fetch("SELECT total, status FROM invoices WHERE id = $1", params.invoice_id)
+    row = rows[0]
+    return LookupOutput(total=row["total"], status=row["status"])
+```
+
+Register it in `src/billing_agent/core/tools/__init__.py`:
+
+```python
+from billing_agent.core.tools import invoice as invoice
+```
+
+Restart the server. Your tool appears in `make docs` and every transport automatically.
+
+</details>
+
+<details>
+<summary><strong>Step 5 — Verify and ship</strong></summary>
+
+Every generated project includes the same quality gates:
+
+```bash
+make check    # lint + type + deadcode + golden-path fact-checks
+make test     # unit + smoke tests
+```
+
+CI in **this** repo runs the same checks on pull requests. Your generated project ships with pre-commit hooks ready to enable.
+
+</details>
+
+---
+
+## How a request flows
+
+When an MCP client calls your server, everything funnels through one registry — transports are thin adapters.
+
+```mermaid
+sequenceDiagram
+  participant Client as MCP Client
+  participant Transport as Transport adapter
+  participant Auth as Auth provider
+  participant Registry as Tool registry
+  participant Tool as Your @tool handler
+  participant DS as Data source
+
+  Client->>Transport: call_tool(name, arguments)
+  alt HTTP or gRPC
+    Transport->>Auth: validate Bearer token
+    Auth-->>Transport: Principal
+  end
+  Transport->>Registry: invoke_tool(name, args)
+  Registry->>Tool: handler(params, ctx)
+  Tool->>DS: query (optional)
+  DS-->>Tool: result
+  Tool-->>Registry: Pydantic output
+  Registry-->>Transport: JSON payload
+  Transport-->>Client: MCP response
+```
+
+**stdio** skips auth (trusted local channel). **HTTP** and **gRPC** enforce the configured provider.
+
+---
+
+## Architecture inside your generated server
+
+One core, multiple ways in. You write tools once; every transport exposes them.
+
+```mermaid
+flowchart TB
+  subgraph adapters [Transport adapters]
+    stdio[stdio]
+    http["Streamable HTTP"]
+    grpc[gRPC adapter]
+  end
+  subgraph ops [FastAPI surfaces]
+    health["/health · /ready · /admin"]
+    docs["Live docs server"]
+  end
+  subgraph core [Transport-agnostic core]
+    tools[Tool registry]
+    ds[Data source registry]
+    ctx[AppContext]
+  end
+  subgraph cfg [Config layer]
+    yaml[YAML profiles]
+    sec[Secret providers]
+    auth[Auth providers]
+  end
+  stdio --> core
+  http --> core
+  grpc --> core
+  ops --> core
+  core --> cfg
+  ds --> postgres[(PostgreSQL)]
+  ds --> neo4j[(Neo4j)]
+```
+
+FastAPI powers **ops endpoints** and the **live docs server** (`make docs`). MCP traffic uses the official `mcp` SDK (stdio) or Starlette (Streamable HTTP). gRPC is a custom adapter over the same tool registry.
+
+---
+
+## Choose your stack (decision guide)
+
+```mermaid
+flowchart TD
+  start([I need an MCP server]) --> local{Local dev only?}
+  local -->|Yes| stdio["transports: stdio"]
+  local -->|No| http["transports: stdio,http"]
+  http --> db{Need a database?}
+  db -->|Postgres| pg["--datasources postgres"]
+  db -->|Graph| neo["--datasources neo4j"]
+  db -->|Both| both["--datasources postgres,neo4j"]
+  db -->|No| none["--datasources omitted"]
+  http --> auth{Production auth?}
+  auth -->|SSO| oidc["--auth oidc"]
+  auth -->|Quick local test| noneAuth["--auth none"]
+  auth -->|Never prod| basic["--auth basic · testing only"]
+  stdio --> done([make setup && make run])
+  pg --> done
+  neo --> done
+  both --> done
+  none --> done
+  oidc --> done
+  noneAuth --> done
+  basic --> done
+```
+
+---
+
+## Example: Neo4j + OIDC (production-shaped)
+
+```bash
+uvx agent-easy-framework mcp graph-agent \
+  --datasources neo4j \
+  --transports stdio,http \
+  --auth oidc
+```
+
+```bash
+cd graph-agent
+mkdir -p secrets/neo4j
+echo 'your-password' > secrets/neo4j/password
+make setup && make run PROFILE=prod
+```
+
+Point `config/profiles/prod.yaml` at your IdP and Neo4j bolt URI. HTTP clients send `Authorization: Bearer <jwt>`.
+
+---
+
+## What you get out of the box
+
+- **MCP-first** — official `mcp` SDK; tools registered via `@tool` with enforced typing and docstrings
+- **Minimal deps** — generator prunes what you did not select
+- **YAML profiles** — no environment variables; `--profile` CLI override
+- **Pluggable providers** — same pattern for secrets, auth, and data sources
+- **Live docs** — `make docs` serves a registry-generated site; nothing committed
+- **Quality gates** — ruff, `mypy --strict`, vulture, custom fact-checks, pytest smoke test
+
+---
+
+## Generated project commands
+
+| Command | What it does |
+|---------|--------------|
+| `make setup` | Create venv, install deps |
+| `make example` | Call `ping` in-process (fast validation, no server) |
+| `make run` | Run server (`PROFILE=prod` to override) |
+| `make run-http` | Run HTTP MCP transport (when generated with `--transports http`) |
+| `make example-http` | Call `ping` over HTTP MCP (when generated with `--transports http`) |
+| `make docs` | Serve live documentation |
+| `make check` | Lint + type + deadcode + golden-path fact-checks |
+| `make factcheck` | Golden-path invariants only |
+| `make test` | Run tests |
+| `make fmt` | Auto-format |
+| `make all` | `check` + `test` |
+
+---
+
+## Contributing to this framework
+
+For maintainers working on the generator itself:
+
+```bash
+git clone https://github.com/KazzyAPI/agent-easy.git
+cd agent-easy
+make setup          # sync templates + venv + dev deps
+make check && make test
+make sync-templates # refresh bundled templates before publishing
+```
+
+See [GOLDEN_PATH.md](GOLDEN_PATH.md) for the full architectural contract.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

agent_easy_framework-0.0.3.dist-info/RECORD

@@ -0,0 +1,68 @@
+agent_server/__about__.py,sha256=f2UAInhJ97hsCgt9nUrJAJ4En2kuWxXID3spKvI8c4w,77
+agent_server/__init__.py,sha256=nG5tKfEzWlPdP2O2kGDrmyGNCQAXEU724V5X1g_CXv0,423
+agent_server/__main__.py,sha256=g-7HZK4xWZW80jxQK1HENjjwpOlORa8f30KHrJ3p0LY,169
+agent_server/bootstrap.py,sha256=r4bLc0ksy1KtMjH_uAatWg2lTIl4htq04AwDkuU01To,972
+agent_server/cli.py,sha256=fzNak0QHfwkkgCMPThiaHsY3R6z6OLNGKZ7lNfVTTd8,1785
+agent_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agent_server/runtime.py,sha256=G4_Jzr4DIMnMPkF7PmrBFvFbXwgx802xl5laTOFDXM0,1327
+agent_server/auth/__init__.py,sha256=4piQimXRW4HH5JMkw8yQk5UYcT-qGrN6Ofq9zXRwGR0,75
+agent_server/auth/base.py,sha256=JFtG2kaL0si9ABLzJCgkf_BzGYPy2a8IGOtLyOmwmNQ,2069
+agent_server/auth/basic.py,sha256=u53AJZO8gN9TA8byNTfP9hhYHzgTvrY1zUFowQGMei8,3370
+agent_server/auth/none.py,sha256=2Lfsp3-q3_6rVYIyVo0I-Fx2QeVItlyS_35eRT3buco,956
+agent_server/auth/oidc.py,sha256=7Z9dT-TCGGeI-5WYK9S3FNCzFCwOAhwIDG5_AiF425I,4090
+agent_server/checks/__init__.py,sha256=Itg9mVnigmI_fAkfOT9gSSz6nBm199cd_wYxdFpRh28,464
+agent_server/checks/invariants.py,sha256=nUNiOJMwyBFI85gm8QbTNRr3xo4clsdQueVNYPwIRGU,11987
+agent_server/config/__init__.py,sha256=d0Rtajz_P1RTDQFqBDtNL4Tpsm4OeILrYfOEl83m5DU,73
+agent_server/config/loader.py,sha256=onSYzcLfN2nOkd3bXe3lnBzAINRuR-5hi5-DwFjTePA,3590
+agent_server/config/schema.py,sha256=CjZ15e6bSnoT2vU8I7UgcWw-SWsITYGiUjpNcqLg-Yo,1540
+agent_server/config/secrets/__init__.py,sha256=RzYTDjhAxq_5B-9fv4X3QTyoXIB2Edcb_cvfhOK061A,75
+agent_server/config/secrets/base.py,sha256=RxzeI4kotio-2PEjgyPfMPyRq-FsgNGySIb6kEU9Aok,1684
+agent_server/config/secrets/file_provider.py,sha256=e6daFFPtWMcid-ScfJvHYvOXTSYA21h42zyjvZA01GE,1678
+agent_server/core/__init__.py,sha256=5cWyG6I_rlRKZiSVmz_8t56SaC6fOSWzw5UdpQ8lUm4,66
+agent_server/core/context.py,sha256=28-3Q1Ii8As6cO-FeSRMcXpGcCP2QfNNzdPP6S-2z5Q,2214
+agent_server/core/registry.py,sha256=tghEL9Do2GTyh6JkisaFA-4WtoeRxYkhRX4j9uBxYpw,4696
+agent_server/core/tools/__init__.py,sha256=PGL-xr__j8X2DHJ7WEnVlJZiGtksq-Oa_LYNQ8jtym0,361
+agent_server/core/tools/example.py,sha256=Z-t7jB29I-00_tjudP2SIh1pRwgsgzdCzZzegZGW11Y,824
+agent_server/datasources/__init__.py,sha256=MLeqADi6p3XoI5iiJs1HmP99UO03wF9NxHkDkCHmj78,66
+agent_server/datasources/base.py,sha256=5uG1Khc24Xj6Du8Ypi-CrVK-s2mLjIHNHrc7PI-c1KU,1943
+agent_server/datasources/neo4j.py,sha256=gguexeIUiP_wiJ2mFTaz9Bti-ZBiJRgXNoVlAB-H3Qo,2601
+agent_server/datasources/postgres.py,sha256=Jcn2oViuz1-dalVNbFs2z00TXBUb2Z_pdimTOBrwwqA,2610
+agent_server/docs/__init__.py,sha256=1oSgPKYnoVLGwaeszCXoLwfVvKJV_8-dEZ0Z738RZeY,469
+agent_server/docs/server.py,sha256=6gcxONb4JJgai0KBtZccJ98LGXjmVvyb3yI4WbnH0Fg,6359
+agent_server/ops/__init__.py,sha256=OskEY-oCyyTv7DZss34Hy_QijGT--BptNlBNim8fwTc,59
+agent_server/ops/app.py,sha256=JK-bICAAYj4aXbCNxwlHYQn1xZatZIHvL7IuV6vox0s,2185
+agent_server/ops/schemas.py,sha256=FHqAGjRSm3rcd0KUysniZUBeiQN60x5DT0nWAhZD7Fs,826
+agent_server/transports/__init__.py,sha256=orGwqKRklMyCflbehWtZyA3QC1_r8vD0Yy3Ci0zcinU,2098
+agent_server/transports/dispatch.py,sha256=TEd7DzhJJr2QsieKtTDsVE0VePq7kI4o_Y0gT8p0PQk,916
+agent_server/transports/http.py,sha256=4DbqE9mt0ykxNGfDYSi4FG-bJYnxGqgS90cWMDS0HQ8,3437
+agent_server/transports/mcp_app.py,sha256=MqtlZ-GHcujGdzk_iqi-WI-HBjDt6FXVkS0kzonMNjE,2526
+agent_server/transports/stdio.py,sha256=GQ2yW4fghJ0snst-hkiQGajAQ7Xrzwc11EfROsrznVU,1018
+agent_server/transports/grpc/__init__.py,sha256=qXDFJLozxdRlYes1mhn8rM4Vz2su4DaNce_jKRcKgGA,431
+agent_server/transports/grpc/agent_server_pb2.py,sha256=bhL2J_oeLZJOasZi5OvJqoxg6516pPsuBMb4BAsvMzE,2490
+agent_server/transports/grpc/agent_server_pb2_grpc.py,sha256=zF56FQnez88HU1cBcIJMXO-ymlIHUt9ViSef5AJvKSY,5158
+agent_server/transports/grpc/server.py,sha256=9Lb5SSl4YYsuRFySZGEXrGrjN_VoSxM3PlMdktlAjlU,4379
+create_agent_server/__about__.py,sha256=WBpOhito9IqvQGvZJhvsEKJI6v-uya2dD7RsKB8pH0w,296
+create_agent_server/__init__.py,sha256=AkESFNYBzrIfxBo4nLgNUMKG7pyKUhbNpex-X3LoKDs,755
+create_agent_server/add_tool.py,sha256=H6BjVGNk3gG99P0_aEyMTtHh4wSkJGYv6NxPlP7b42M,5433
+create_agent_server/cli.py,sha256=PYnuioCpvVKwvPKBY0a7c50_ocf9Sq5UKKbyhIlNGkU,6878
+create_agent_server/generator.py,sha256=bKjWvDGah9tQCeiOgVV4WeywpzE7UCkGH9_d-z6Tb8c,24473
+create_agent_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+create_agent_server/template_paths.py,sha256=6Zvdi4v6YfpMKSelHdwJTq-mvNj_qGtN5zXP8HPOMXs,2766
+create_agent_server/templates/gitignore,sha256=l5yEWHmEpIa2tsXI5lDVMLhmX4ir9GHRLc6eL75mhp4,241
+create_agent_server/templates/pre-commit-config.yaml,sha256=JC59NIxXsNRpOsYE2D3dobTqqArsRrm6WdoCsIhlgSs,1191
+create_agent_server/templates/config/base.yaml,sha256=ozsvFKnw8X7WF-ZJrUMm7Dkt2iS14pR3a4omuFwPtdQ,513
+create_agent_server/templates/config/profiles/local-http.yaml,sha256=H_6lFB7pg3cP1a54LseG7B2EC9ncttfcq7Y0jui30JY,279
+create_agent_server/templates/config/profiles/local.yaml,sha256=DXbi3b_pHvxNPTDjhJXI1Sb3Rlk4MOl-eM1RABdtDJY,148
+create_agent_server/templates/config/profiles/prod.yaml,sha256=ZIaSxlJCwce7zPK48siJnDjp5MOBBV7ucfRYzabiy5M,765
+create_agent_server/templates/examples/README.md,sha256=W-2aE3SjXAnJDeVmQIZiT7SYLVf-MkCkpg-WnOUsU0c,2966
+create_agent_server/templates/examples/call_ping.py,sha256=CmC9foogiWQ6dVRS29vQGVJtSAbikPdb73SO3Hgmy6c,1363
+create_agent_server/templates/examples/call_ping_http.py,sha256=ql37877FN2_LJoTEbdJgCSL1tGNWH7wtUIDG94AxVvs,1287
+create_agent_server/templates/examples/smoke_ops.sh,sha256=9rodNHGznSlS4H0rvH03PFKWv-XJN63VGIslLX5cXGE,538
+create_agent_server/templates/proto/agent_server.proto,sha256=cQzfwVBq8LG0XucXtimo-8aKdm_7sippH-r7Gb-ltlo,961
+create_agent_server/templates/tools/checks/run_checks.py,sha256=URB4YFNRtDqjSG-ciZRXFAapf6Vzs5OrsTxmuDivMKI,2151
+create_agent_server/templates/tools/checks/validate_typing.py,sha256=-S57a158GiHZ8cn7R7ba23H0pup2Qdf6hDhl09lOZRU,2259
+agent_easy_framework-0.0.3.dist-info/METADATA,sha256=rqxEI4ZFAWa7ZF7x-O-onkwdhIjODWnU9te26d4gCqs,14668
+agent_easy_framework-0.0.3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+agent_easy_framework-0.0.3.dist-info/entry_points.txt,sha256=OKlzXhKS8qZZQ0Z6AuJ6WltJW8P7m-GfWRX2rcd6icg,60
+agent_easy_framework-0.0.3.dist-info/licenses/LICENSE,sha256=Ew2onRHMM28wHYO5Ob-kdFS7wlAlw9ckegjAeEENJFc,1065
+agent_easy_framework-0.0.3.dist-info/RECORD,,

agent_easy_framework-0.0.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

agent_easy_framework-0.0.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agent-easy = create_agent_server.cli:main

agent_easy_framework-0.0.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nathan M
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_server/__about__.py

@@ -0,0 +1,3 @@
+"""Single source of truth for the package version."""
+
+__version__ = "0.0.3"

agent_server/__init__.py

@@ -0,0 +1,13 @@
+"""agent_server: the canonical MCP-first server package.
+
+This package is the golden-path reference implementation. The
+``agent-easy mcp`` generator copies it into new projects and renames the
+top-level package. Keep it real, runnable, typed, and tested - it is the
+contract every generated server inherits.
+"""
+
+from __future__ import annotations
+
+from agent_server.__about__ import __version__
+
+__all__ = ["__version__"]

agent_server/__main__.py

@@ -0,0 +1,8 @@
+"""Enable ``python -m agent_server``."""
+
+from __future__ import annotations
+
+from agent_server.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

agent_server/auth/__init__.py

@@ -0,0 +1 @@
+"""Authentication: provider protocol, registry, and built-in providers."""