google-adk-extras 0.1.1__tar.gz → 0.2.5__tar.gz

{google_adk_extras-0.1.1 → google_adk_extras-0.2.5}/MANIFEST.in

@@ -4,7 +4,9 @@ include pyproject.toml
 include setup.py
 recursive-include src *.py
 recursive-include examples *.py *.md
+recursive-include docs *.md
+include mkdocs.yml
 global-exclude __pycache__
 global-exclude *.pyc
 global-exclude *.pyo
-global-exclude *~
+global-exclude *~

google_adk_extras-0.2.5/PKG-INFO

@@ -0,0 +1,302 @@
+Metadata-Version: 2.4
+Name: google-adk-extras
+Version: 0.2.5
+Summary: Production-ready services, credentials, and FastAPI wiring for Google ADK
+Home-page: https://github.com/DeadMeme5441/google-adk-extras
+Author: DeadMeme5441
+Author-email: DeadMeme5441 <deadunderscorememe@gmail.com>
+Requires-Python: >=3.10,<3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-adk
+Requires-Dist: google-genai
+Provides-Extra: sql
+Requires-Dist: sqlalchemy; extra == "sql"
+Provides-Extra: mongodb
+Requires-Dist: pymongo; extra == "mongodb"
+Provides-Extra: redis
+Requires-Dist: redis; extra == "redis"
+Provides-Extra: yaml
+Requires-Dist: pyyaml; extra == "yaml"
+Provides-Extra: s3
+Requires-Dist: boto3; extra == "s3"
+Provides-Extra: jwt
+Requires-Dist: PyJWT; extra == "jwt"
+Provides-Extra: web
+Requires-Dist: fastapi; extra == "web"
+Requires-Dist: watchdog; extra == "web"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs; extra == "docs"
+Requires-Dist: mkdocs-material; extra == "docs"
+Requires-Dist: mkdocs-llmstxt; extra == "docs"
+Provides-Extra: all
+Requires-Dist: google-adk-extras[docs,jwt,mongodb,redis,s3,sql,web,yaml]; extra == "all"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# google-adk-extras
+
+[![PyPI](https://img.shields.io/pypi/v/google-adk-extras?label=PyPI)](https://pypi.org/project/google-adk-extras/)
+![Python](https://img.shields.io/badge/python-3.12%2B-blue)
+![License](https://img.shields.io/badge/license-Apache%202.0-green)
+[![Docs](https://img.shields.io/badge/docs-site-brightgreen)](https://deadmeme5441.github.io/google-adk-extras/)
+[![Docs Build](https://github.com/DeadMeme5441/google-adk-extras/actions/workflows/docs.yml/badge.svg)](https://github.com/DeadMeme5441/google-adk-extras/actions/workflows/docs.yml)
+
+Production-ready extensions for Google ADK (Agent Development Kit). This library adds durable service backends (sessions, artifacts, memory), practical credential services (OAuth2/JWT/Basic), and clean FastAPI wiring so you can run ADK agents with real storage and auth.
+
+What this is not: a fork of ADK. It builds on ADK’s core runtime, agents, tools and callbacks, and drops in where ADK expects services and a web server.
+
+
+## Why it exists
+
+ADK provides the core primitives (Runner, Session/State, MemoryService, ArtifactService, CredentialService, Agents/Tools, callbacks, Dev UI, and deployment paths). See the official ADK docs for concepts and APIs.
+
+This package focuses on three gaps common in real apps:
+- Durable storage backends beyond in‑memory defaults
+- Usable credential flows (Google/GitHub/Microsoft/X OAuth2, JWT, Basic)
+- FastAPI integration that accepts your credential service without hacks
+
+
+## Features
+
+- Session services: SQL (SQLite/Postgres/MySQL), MongoDB, Redis, YAML files
+- Artifact services: Local folder (versioned), S3‑compatible, SQL, MongoDB
+- Memory services: SQL, MongoDB, Redis, YAML files (term search over text parts)
+- Credential services: Google/GitHub/Microsoft/X (OAuth2), JWT, HTTP Basic
+- Enhanced FastAPI wiring that respects a provided credential service
+- Fluent builder (`AdkBuilder`) to assemble a FastAPI app or a Runner
+ - A2A helpers for exposing/consuming agents (see below)
+
+Note on Runner: `EnhancedRunner` is a thin subclass of ADK’s `Runner` for compatibility with the enhanced web server; it does not change behavior.
+
+
+## Install
+
+Requirements: Python 3.12+, google-adk.
+
+Using uv:
+
+```bash
+# create a venv (optional)
+uv venv && source .venv/bin/activate
+# install the package
+uv pip install google-adk-extras
+```
+
+If you plan to use specific backends, also install their clients (examples):
+- SQL: `uv pip install sqlalchemy`
+- MongoDB: `uv pip install pymongo`
+- Redis: `uv pip install redis`
+- S3: `uv pip install boto3`
+- JWT: `uv pip install PyJWT`
+
+
+## Quickstart (FastAPI)
+
+Use the fluent builder to wire services and credentials. Then run with uvicorn.
+
+```python
+# app.py
+from google_adk_extras import AdkBuilder
+from google_adk_extras.credentials import GoogleOAuth2CredentialService
+
+app = (
+    AdkBuilder()
+    .with_agents_dir("./agents")                          # ADK agents on disk
+    .with_session_service("sqlite:///./sessions.db")      # or: mongodb://, redis://, yaml://
+    .with_artifact_service("local://./artifacts")         # or: s3://bucket, mongodb://, sql://
+    .with_memory_service("yaml://./memory")               # or: redis://, mongodb://, sql://
+    .with_credential_service(GoogleOAuth2CredentialService(
+        client_id="…apps.googleusercontent.com",
+        client_secret="…",
+        scopes=["openid", "email", "profile"],
+    ))
+    .with_web_ui(True)     # serve ADK’s dev UI if assets available
+    .with_agent_reload(True)
+    .build_fastapi_app()
+)
+```
+
+Run:
+
+```bash
+uvicorn app:app --reload
+```
+
+If you don’t keep agents on disk, register them programmatically and use a custom loader (see below).
+
+
+## Quickstart (Runner)
+
+Create a Runner wired with your chosen backends. Use agent name (filesystem loader) or pass an agent instance.
+
+```python
+from google_adk_extras import AdkBuilder
+
+runner = (
+    AdkBuilder()
+    .with_agents_dir("./agents")
+    .with_session_service("sqlite:///./sessions.db")
+    .with_memory_service("redis://localhost:6379")
+    .with_artifact_service("local://./artifacts")
+    .build_runner("my_agent")
+)
+
+result = await runner.run("Hello there!")
+```
+
+
+## How this extends ADK (in practice)
+
+ADK defines abstract service interfaces and a runner/web stack. This package provides drop‑in implementations and a small web‑server shim:
+
+- Sessions
+  - `SQLSessionService` — SQLAlchemy; JSON‑serialized state/events
+  - `MongoSessionService` — PyMongo; per‑session doc, indexed by app/user/id
+  - `RedisSessionService` — hashes per session + user set; JSON state/events
+- `YamlFileSessionService` — `base/app/user/{session_id}.yaml`
+
+### A2A helpers (new)
+
+Two light-weight helpers wrap ADK’s A2A capabilities:
+
+- `AdkBuilder.enable_a2a_for_registered_agents(enabled=True, mount_base="/a2a", card_factory=None)`
+  - Expose programmatically registered agents (added via `with_agent_instance()` / `with_agents()`) over A2A without an `agents_dir`.
+  - Optionally supply `card_factory(name, agent) -> dict` to build an Agent Card; otherwise a minimal card is used.
+
+- `AdkBuilder.with_remote_a2a_agent(name, agent_card_url, description=None)`
+  - Register a `RemoteA2aAgent` by agent card URL so your root agent can delegate to a remote agent.
+  - Requires `google-adk[a2a]` installed.
+
+Expose a programmatic agent via A2A:
+
+```python
+from google_adk_extras import AdkBuilder
+from google.adk.agents import Agent
+
+hello = Agent(model="gemini-2.0-flash", name="hello", instruction="You are helpful.")
+
+app = (
+    AdkBuilder()
+      .with_agent_instance("hello", hello)
+      .with_a2a_protocol(True)
+      .enable_a2a_for_registered_agents()  # becomes available at /a2a/hello
+      .build_fastapi_app()
+)
+```
+
+Consume a remote A2A agent:
+
+```python
+from a2a.utils.constants import AGENT_CARD_WELL_KNOWN_PATH
+from google_adk_extras import AdkBuilder
+
+card_url = f"http://remote-host:8001/a2a/prime{AGENT_CARD_WELL_KNOWN_PATH}"
+
+app = (
+    AdkBuilder()
+      .with_remote_a2a_agent("prime_agent", card_url, description="Prime checker")
+      # add your root agent via with_agent_instance(...)
+      .build_fastapi_app()
+)
+```
+
+- Artifacts
+  - `LocalFolderArtifactService` — per‑artifact metadata JSON + versioned data files
+  - `S3ArtifactService` — metadata JSON + versioned data objects in S3‑compatible storage
+  - `SQLArtifactService` — blobs per version in SQL
+  - `MongoArtifactService` — blobs per version in MongoDB
+
+- Memory
+  - `SQLMemoryService`, `MongoMemoryService`, `RedisMemoryService`, `YamlFileMemoryService`
+  - Extracts text from `google.genai.types.Content`, tokenizes simple terms, and searches terms
+
+- Credentials
+  - OAuth2: Google, GitHub, Microsoft, X (Twitter)
+  - Tokens: JWT (generate/verify/refresh‑aware), HTTP Basic (+ multi‑user variant)
+  - Persist via ADK’s session/in‑memory credential stores
+
+- FastAPI integration
+  - `get_enhanced_fast_api_app(...)` accepts a provided credential service
+  - `EnhancedAdkWebServer` returns `EnhancedRunner` and keeps ADK’s caching/cleanup
+  - Prefer the fluent `AdkBuilder()` path for multi‑backend wiring in one place
+
+
+## Agent loading options
+
+- Directory loading (ADK default): `with_agents_dir("./agents")` and create `./agents/<app_name>/agent.json` (or your ADK agent files) per app.
+- Programmatic agents: register instances and avoid a folder layout.
+
+```python
+from google_adk_extras import AdkBuilder
+from google_adk_extras.custom_agent_loader import CustomAgentLoader
+from google.adk.agents.base_agent import BaseAgent
+
+loader = CustomAgentLoader()
+loader.register_agent("my_app", BaseAgent(name="my_app"))  # replace with a real agent
+
+app = (
+    AdkBuilder()
+    .with_agent_loader(loader)
+    .with_session_service("sqlite:///./sessions.db")
+    .build_fastapi_app()
+)
+```
+
+
+## Credential URI cheatsheet (optional)
+
+If you prefer URIs instead of constructing services:
+
+- Google OAuth2: `oauth2-google://client_id:secret@scopes=openid,email,profile`
+- GitHub OAuth2: `oauth2-github://client_id:secret@scopes=user,repo`
+- Microsoft OAuth2: `oauth2-microsoft://<tenant>/<client_id>:<secret>@scopes=User.Read`
+- X OAuth2: `oauth2-x://client_id:secret@scopes=tweet.read,users.read`
+- JWT: `jwt://<secret>@algorithm=HS256&issuer=my-app&audience=api.example.com&expiration_minutes=60`
+- Basic: `basic-auth://username:password@realm=My%20API`
+
+```python
+cred = (
+    AdkBuilder()
+    .with_credential_service_uri("jwt://secret@issuer=my-app")
+    ._create_credential_service()
+)
+```
+
+
+## Notes & limitations
+
+- The runner in this package is intentionally thin. All agent logic, tools, callbacks, and evaluation remain ADK responsibilities.
+- The repository currently ships only the pieces listed above; referenced registries or configuration subsystems are intentionally out of scope.
+- Some direct FastAPI parameters (e.g., ADK’s special memory URIs) pass through for parity, but the fluent builder is the recommended path for the extended backends offered here.
+
+
+## Docs
+
+This repo ships a full MkDocs site in `docs/`.
+
+Build locally with uv:
+
+```bash
+uv pip install .[docs]
+uv run mkdocs serve
+```
+
+## Development
+
+```bash
+uv sync                 # or: pip install -e .
+pytest -q               # run tests
+```
+
+
+## License
+
+Apache 2.0 — see LICENSE.

google_adk_extras-0.2.5/README.md

@@ -0,0 +1,259 @@
+# google-adk-extras
+
+[![PyPI](https://img.shields.io/pypi/v/google-adk-extras?label=PyPI)](https://pypi.org/project/google-adk-extras/)
+![Python](https://img.shields.io/badge/python-3.12%2B-blue)
+![License](https://img.shields.io/badge/license-Apache%202.0-green)
+[![Docs](https://img.shields.io/badge/docs-site-brightgreen)](https://deadmeme5441.github.io/google-adk-extras/)
+[![Docs Build](https://github.com/DeadMeme5441/google-adk-extras/actions/workflows/docs.yml/badge.svg)](https://github.com/DeadMeme5441/google-adk-extras/actions/workflows/docs.yml)
+
+Production-ready extensions for Google ADK (Agent Development Kit). This library adds durable service backends (sessions, artifacts, memory), practical credential services (OAuth2/JWT/Basic), and clean FastAPI wiring so you can run ADK agents with real storage and auth.
+
+What this is not: a fork of ADK. It builds on ADK’s core runtime, agents, tools and callbacks, and drops in where ADK expects services and a web server.
+
+
+## Why it exists
+
+ADK provides the core primitives (Runner, Session/State, MemoryService, ArtifactService, CredentialService, Agents/Tools, callbacks, Dev UI, and deployment paths). See the official ADK docs for concepts and APIs.
+
+This package focuses on three gaps common in real apps:
+- Durable storage backends beyond in‑memory defaults
+- Usable credential flows (Google/GitHub/Microsoft/X OAuth2, JWT, Basic)
+- FastAPI integration that accepts your credential service without hacks
+
+
+## Features
+
+- Session services: SQL (SQLite/Postgres/MySQL), MongoDB, Redis, YAML files
+- Artifact services: Local folder (versioned), S3‑compatible, SQL, MongoDB
+- Memory services: SQL, MongoDB, Redis, YAML files (term search over text parts)
+- Credential services: Google/GitHub/Microsoft/X (OAuth2), JWT, HTTP Basic
+- Enhanced FastAPI wiring that respects a provided credential service
+- Fluent builder (`AdkBuilder`) to assemble a FastAPI app or a Runner
+ - A2A helpers for exposing/consuming agents (see below)
+
+Note on Runner: `EnhancedRunner` is a thin subclass of ADK’s `Runner` for compatibility with the enhanced web server; it does not change behavior.
+
+
+## Install
+
+Requirements: Python 3.12+, google-adk.
+
+Using uv:
+
+```bash
+# create a venv (optional)
+uv venv && source .venv/bin/activate
+# install the package
+uv pip install google-adk-extras
+```
+
+If you plan to use specific backends, also install their clients (examples):
+- SQL: `uv pip install sqlalchemy`
+- MongoDB: `uv pip install pymongo`
+- Redis: `uv pip install redis`
+- S3: `uv pip install boto3`
+- JWT: `uv pip install PyJWT`
+
+
+## Quickstart (FastAPI)
+
+Use the fluent builder to wire services and credentials. Then run with uvicorn.
+
+```python
+# app.py
+from google_adk_extras import AdkBuilder
+from google_adk_extras.credentials import GoogleOAuth2CredentialService
+
+app = (
+    AdkBuilder()
+    .with_agents_dir("./agents")                          # ADK agents on disk
+    .with_session_service("sqlite:///./sessions.db")      # or: mongodb://, redis://, yaml://
+    .with_artifact_service("local://./artifacts")         # or: s3://bucket, mongodb://, sql://
+    .with_memory_service("yaml://./memory")               # or: redis://, mongodb://, sql://
+    .with_credential_service(GoogleOAuth2CredentialService(
+        client_id="…apps.googleusercontent.com",
+        client_secret="…",
+        scopes=["openid", "email", "profile"],
+    ))
+    .with_web_ui(True)     # serve ADK’s dev UI if assets available
+    .with_agent_reload(True)
+    .build_fastapi_app()
+)
+```
+
+Run:
+
+```bash
+uvicorn app:app --reload
+```
+
+If you don’t keep agents on disk, register them programmatically and use a custom loader (see below).
+
+
+## Quickstart (Runner)
+
+Create a Runner wired with your chosen backends. Use agent name (filesystem loader) or pass an agent instance.
+
+```python
+from google_adk_extras import AdkBuilder
+
+runner = (
+    AdkBuilder()
+    .with_agents_dir("./agents")
+    .with_session_service("sqlite:///./sessions.db")
+    .with_memory_service("redis://localhost:6379")
+    .with_artifact_service("local://./artifacts")
+    .build_runner("my_agent")
+)
+
+result = await runner.run("Hello there!")
+```
+
+
+## How this extends ADK (in practice)
+
+ADK defines abstract service interfaces and a runner/web stack. This package provides drop‑in implementations and a small web‑server shim:
+
+- Sessions
+  - `SQLSessionService` — SQLAlchemy; JSON‑serialized state/events
+  - `MongoSessionService` — PyMongo; per‑session doc, indexed by app/user/id
+  - `RedisSessionService` — hashes per session + user set; JSON state/events
+- `YamlFileSessionService` — `base/app/user/{session_id}.yaml`
+
+### A2A helpers (new)
+
+Two light-weight helpers wrap ADK’s A2A capabilities:
+
+- `AdkBuilder.enable_a2a_for_registered_agents(enabled=True, mount_base="/a2a", card_factory=None)`
+  - Expose programmatically registered agents (added via `with_agent_instance()` / `with_agents()`) over A2A without an `agents_dir`.
+  - Optionally supply `card_factory(name, agent) -> dict` to build an Agent Card; otherwise a minimal card is used.
+
+- `AdkBuilder.with_remote_a2a_agent(name, agent_card_url, description=None)`
+  - Register a `RemoteA2aAgent` by agent card URL so your root agent can delegate to a remote agent.
+  - Requires `google-adk[a2a]` installed.
+
+Expose a programmatic agent via A2A:
+
+```python
+from google_adk_extras import AdkBuilder
+from google.adk.agents import Agent
+
+hello = Agent(model="gemini-2.0-flash", name="hello", instruction="You are helpful.")
+
+app = (
+    AdkBuilder()
+      .with_agent_instance("hello", hello)
+      .with_a2a_protocol(True)
+      .enable_a2a_for_registered_agents()  # becomes available at /a2a/hello
+      .build_fastapi_app()
+)
+```
+
+Consume a remote A2A agent:
+
+```python
+from a2a.utils.constants import AGENT_CARD_WELL_KNOWN_PATH
+from google_adk_extras import AdkBuilder
+
+card_url = f"http://remote-host:8001/a2a/prime{AGENT_CARD_WELL_KNOWN_PATH}"
+
+app = (
+    AdkBuilder()
+      .with_remote_a2a_agent("prime_agent", card_url, description="Prime checker")
+      # add your root agent via with_agent_instance(...)
+      .build_fastapi_app()
+)
+```
+
+- Artifacts
+  - `LocalFolderArtifactService` — per‑artifact metadata JSON + versioned data files
+  - `S3ArtifactService` — metadata JSON + versioned data objects in S3‑compatible storage
+  - `SQLArtifactService` — blobs per version in SQL
+  - `MongoArtifactService` — blobs per version in MongoDB
+
+- Memory
+  - `SQLMemoryService`, `MongoMemoryService`, `RedisMemoryService`, `YamlFileMemoryService`
+  - Extracts text from `google.genai.types.Content`, tokenizes simple terms, and searches terms
+
+- Credentials
+  - OAuth2: Google, GitHub, Microsoft, X (Twitter)
+  - Tokens: JWT (generate/verify/refresh‑aware), HTTP Basic (+ multi‑user variant)
+  - Persist via ADK’s session/in‑memory credential stores
+
+- FastAPI integration
+  - `get_enhanced_fast_api_app(...)` accepts a provided credential service
+  - `EnhancedAdkWebServer` returns `EnhancedRunner` and keeps ADK’s caching/cleanup
+  - Prefer the fluent `AdkBuilder()` path for multi‑backend wiring in one place
+
+
+## Agent loading options
+
+- Directory loading (ADK default): `with_agents_dir("./agents")` and create `./agents/<app_name>/agent.json` (or your ADK agent files) per app.
+- Programmatic agents: register instances and avoid a folder layout.
+
+```python
+from google_adk_extras import AdkBuilder
+from google_adk_extras.custom_agent_loader import CustomAgentLoader
+from google.adk.agents.base_agent import BaseAgent
+
+loader = CustomAgentLoader()
+loader.register_agent("my_app", BaseAgent(name="my_app"))  # replace with a real agent
+
+app = (
+    AdkBuilder()
+    .with_agent_loader(loader)
+    .with_session_service("sqlite:///./sessions.db")
+    .build_fastapi_app()
+)
+```
+
+
+## Credential URI cheatsheet (optional)
+
+If you prefer URIs instead of constructing services:
+
+- Google OAuth2: `oauth2-google://client_id:secret@scopes=openid,email,profile`
+- GitHub OAuth2: `oauth2-github://client_id:secret@scopes=user,repo`
+- Microsoft OAuth2: `oauth2-microsoft://<tenant>/<client_id>:<secret>@scopes=User.Read`
+- X OAuth2: `oauth2-x://client_id:secret@scopes=tweet.read,users.read`
+- JWT: `jwt://<secret>@algorithm=HS256&issuer=my-app&audience=api.example.com&expiration_minutes=60`
+- Basic: `basic-auth://username:password@realm=My%20API`
+
+```python
+cred = (
+    AdkBuilder()
+    .with_credential_service_uri("jwt://secret@issuer=my-app")
+    ._create_credential_service()
+)
+```
+
+
+## Notes & limitations
+
+- The runner in this package is intentionally thin. All agent logic, tools, callbacks, and evaluation remain ADK responsibilities.
+- The repository currently ships only the pieces listed above; referenced registries or configuration subsystems are intentionally out of scope.
+- Some direct FastAPI parameters (e.g., ADK’s special memory URIs) pass through for parity, but the fluent builder is the recommended path for the extended backends offered here.
+
+
+## Docs
+
+This repo ships a full MkDocs site in `docs/`.
+
+Build locally with uv:
+
+```bash
+uv pip install .[docs]
+uv run mkdocs serve
+```
+
+## Development
+
+```bash
+uv sync                 # or: pip install -e .
+pytest -q               # run tests
+```
+
+
+## License
+
+Apache 2.0 — see LICENSE.

google_adk_extras-0.2.5/docs/agent-loading.md

@@ -0,0 +1,28 @@
+# Programmatic Agents
+
+You don’t need on‑disk agent folders. Register agent instances directly.
+
+```python
+from google_adk_extras import AdkBuilder, CustomAgentLoader
+from google.adk.agents.base_agent import BaseAgent
+
+class EchoAgent(BaseAgent):
+    name = "echo"
+    async def _run_async_impl(self, ctx):
+        text = ctx.user_content.text if ctx.user_content else ""
+        yield self.create_text_response(f"Echo: {text}")
+
+loader = CustomAgentLoader()
+loader.register_agent("echo_app", EchoAgent())
+
+app = (
+  AdkBuilder()
+  .with_agent_loader(loader)
+  .with_session_service("sqlite:///./sessions.db")
+  .build_fastapi_app()
+)
+```
+
+Guidance
+- Use programmatic loading for testing or dynamic agent assembly.
+- Do not mix `with_agents_dir()` and registered instances in one builder.

google_adk_extras-0.2.5/docs/credentials.md

@@ -0,0 +1,31 @@
+# Credentials
+
+Provide auth to tools and agents using credential services.
+
+## OAuth2
+- `GoogleOAuth2CredentialService`
+- `GitHubOAuth2CredentialService`
+- `MicrosoftOAuth2CredentialService`
+- `XOAuth2CredentialService`
+
+```python
+from google_adk_extras.credentials import GoogleOAuth2CredentialService
+
+cred = GoogleOAuth2CredentialService(
+    client_id="...",
+    client_secret="...",
+    scopes=["openid", "email", "profile"],
+)
+
+app = AdkBuilder().with_credential_service(cred).build_fastapi_app()
+```
+
+## JWT
+- `JWTCredentialService` (requires `PyJWT` via extra `[jwt]`).
+
+## HTTP Basic
+- `HTTPBasicAuthCredentialService` and multi‑user variant.
+
+Notes
+- You can also configure via URIs (see URIs page).
+- Credential storage defaults to ADK’s session/in‑memory stores.

google_adk_extras-0.2.5/docs/examples.md

@@ -0,0 +1,11 @@
+# Examples
+
+These examples are kept small and runnable; see the `examples/` folder.
+
+- `examples/fastapi_app.py` — full app with durable backends.
+- `examples/runner_basic.py` — runner without FastAPI.
+- `examples/custom_loader.py` — programmatic agents.
+- `examples/services/` — focused snippets per backend.
+- `examples/credentials/` — focused credential usage.
+
+Install extras to match what you run, e.g. `uv pip install google-adk-extras[sql,yaml,web]`.

google_adk_extras-0.2.5/docs/fastapi.md

@@ -0,0 +1,24 @@
+# FastAPI Integration
+
+Use `get_enhanced_fast_api_app` indirectly via `AdkBuilder.build_fastapi_app()`.
+
+Key points
+- Accepts your provided `credential_service` (no forced in‑memory default).
+- Honors ADK’s Dev UI when assets are present.
+- Preserves ADK’s runner caching/cleanup semantics via `EnhancedAdkWebServer`.
+
+Example
+```python
+app = (
+  AdkBuilder()
+  .with_agents_dir("./agents")
+  .with_session_service("sqlite:///./sessions.db")
+  .with_artifact_service("local://./artifacts")
+  .with_memory_service("yaml://./memory")
+  .build_fastapi_app()
+)
+```
+
+Dev UI
+- Set `with_web_ui(True)`; if ADK’s web assets are available, the UI is served.
+- Use `with_agent_reload(True)` for filesystem agent hot‑reload.