google-adk-extras 0.2.6__tar.gz → 0.2.7__tar.gz

{google_adk_extras-0.2.6/src/google_adk_extras.egg-info → google_adk_extras-0.2.7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: google-adk-extras
-Version: 0.2.6
-Summary: Production-ready services, credentials, and FastAPI wiring for Google ADK
+Version: 0.2.7
+Summary: Production-ready services and FastAPI wiring for Google ADK
 Home-page: https://github.com/DeadMeme5441/google-adk-extras
 Author: DeadMeme5441
 Author-email: DeadMeme5441 <deadunderscorememe@gmail.com>
@@ -49,7 +49,7 @@ Dynamic: requires-python
 [![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.
+Production-ready extensions for Google ADK (Agent Development Kit). This library adds durable service backends (sessions, artifacts, memory) and clean FastAPI wiring (with optional streaming) so you can run ADK agents with real storage.
 
 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.
 
@@ -58,10 +58,9 @@ What this is not: a fork of ADK. It builds on ADK’s core runtime, agents, tool
 
 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:
+This package focuses on a few 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
+- FastAPI integration with optional streaming (SSE/WS)
 
 
 ## Features
@@ -69,8 +68,7 @@ This package focuses on three gaps common in real apps:
 - 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
+- Enhanced FastAPI wiring for ADK apps (with optional streaming)
 - Fluent builder (`AdkBuilder`) to assemble a FastAPI app or a Runner
  - A2A helpers for exposing/consuming agents (see below)
 
@@ -95,17 +93,17 @@ If you plan to use specific backends, also install their clients (examples):
 - MongoDB: `uv pip install pymongo`
 - Redis: `uv pip install redis`
 - S3: `uv pip install boto3`
-- JWT: `uv pip install PyJWT`
+  
+Note on credentials (0.2.7): This release removes custom credential services and URI helpers from this package. For outbound credentials used by tools, rely on ADK’s experimental BaseCredentialService (e.g., InMemory/SessionState) or your own ADK-compatible implementation. Inbound API authentication (protecting /run and streaming routes) will be provided as an optional FastAPI layer separately.
 
 
 ## Quickstart (FastAPI)
 
-Use the fluent builder to wire services and credentials. Then run with uvicorn.
+Use the fluent builder to wire services. Then run with uvicorn.
 
 ```python
 # app.py
 from google_adk_extras import AdkBuilder
-from google_adk_extras.credentials import GoogleOAuth2CredentialService
 
 app = (
     AdkBuilder()
@@ -113,11 +111,7 @@ app = (
     .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"],
-    ))
+    # credentials: rely on ADK defaults or pass an ADK BaseCredentialService if needed
     .with_web_ui(True)     # serve ADK’s dev UI if assets available
     .with_agent_reload(True)
     .build_fastapi_app()
@@ -251,24 +245,8 @@ 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()
-)
-```
+<!-- Credential URI helpers removed. Use ADK’s BaseCredentialService directly if needed,
+     and handle inbound API authentication at FastAPI level. -->
 
 
 ## Notes & limitations

{google_adk_extras-0.2.6 → google_adk_extras-0.2.7}/README.md

@@ -6,7 +6,7 @@
 [![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.
+Production-ready extensions for Google ADK (Agent Development Kit). This library adds durable service backends (sessions, artifacts, memory) and clean FastAPI wiring (with optional streaming) so you can run ADK agents with real storage.
 
 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.
 
@@ -15,10 +15,9 @@ What this is not: a fork of ADK. It builds on ADK’s core runtime, agents, tool
 
 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:
+This package focuses on a few 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
+- FastAPI integration with optional streaming (SSE/WS)
 
 
 ## Features
@@ -26,8 +25,7 @@ This package focuses on three gaps common in real apps:
 - 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
+- Enhanced FastAPI wiring for ADK apps (with optional streaming)
 - Fluent builder (`AdkBuilder`) to assemble a FastAPI app or a Runner
  - A2A helpers for exposing/consuming agents (see below)
 
@@ -52,17 +50,17 @@ If you plan to use specific backends, also install their clients (examples):
 - MongoDB: `uv pip install pymongo`
 - Redis: `uv pip install redis`
 - S3: `uv pip install boto3`
-- JWT: `uv pip install PyJWT`
+  
+Note on credentials (0.2.7): This release removes custom credential services and URI helpers from this package. For outbound credentials used by tools, rely on ADK’s experimental BaseCredentialService (e.g., InMemory/SessionState) or your own ADK-compatible implementation. Inbound API authentication (protecting /run and streaming routes) will be provided as an optional FastAPI layer separately.
 
 
 ## Quickstart (FastAPI)
 
-Use the fluent builder to wire services and credentials. Then run with uvicorn.
+Use the fluent builder to wire services. Then run with uvicorn.
 
 ```python
 # app.py
 from google_adk_extras import AdkBuilder
-from google_adk_extras.credentials import GoogleOAuth2CredentialService
 
 app = (
     AdkBuilder()
@@ -70,11 +68,7 @@ app = (
     .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"],
-    ))
+    # credentials: rely on ADK defaults or pass an ADK BaseCredentialService if needed
     .with_web_ui(True)     # serve ADK’s dev UI if assets available
     .with_agent_reload(True)
     .build_fastapi_app()
@@ -208,24 +202,8 @@ 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()
-)
-```
+<!-- Credential URI helpers removed. Use ADK’s BaseCredentialService directly if needed,
+     and handle inbound API authentication at FastAPI level. -->
 
 
 ## Notes & limitations

{google_adk_extras-0.2.6 → google_adk_extras-0.2.7}/docs/examples.md

@@ -6,6 +6,6 @@ These examples are kept small and runnable; see the `examples/` folder.
 - `examples/runner_basic.py` — runner without FastAPI.
 - `examples/custom_loader.py` — programmatic agents.
 - `examples/services/` — focused snippets per backend.
-- `examples/credentials/` — focused credential usage.
+  (credential service examples removed; rely on ADK defaults)
 
 Install extras to match what you run, e.g. `uv pip install google-adk-extras[sql,yaml,web]`.

{google_adk_extras-0.2.6 → google_adk_extras-0.2.7}/examples/README.md

@@ -2,7 +2,7 @@ Examples
 
 This folder contains small, runnable examples that mirror the documentation. They are intentionally minimal and designed to be copy–pasted into your app.
 
-- fastapi_app.py — Build a FastAPI app with durable services and optional credentials.
+- fastapi_app.py — Build a FastAPI app with durable services.
 - runner_basic.py — Build a Runner for programmatic use without FastAPI.
 - custom_loader.py — Register programmatic agents with `CustomAgentLoader`.
 - services/ — Focused snippets for sessions, artifacts, memory backends.

{google_adk_extras-0.2.6 → google_adk_extras-0.2.7}/mkdocs.yml

@@ -17,7 +17,6 @@ nav:
   - Streaming: streaming.md
   - Services:
       - Durable Services: services.md
-      - Credentials: credentials.md
   - Programmatic Agents: agent-loading.md
   - URIs & Configuration: uris.md
   - Examples: examples.md
@@ -50,7 +49,7 @@ plugins:
         Durable Services:
         - services.md: Sessions, artifacts, memory backends and trade-offs
         Credentials:
-        - credentials.md: OAuth2 (Google/GitHub/Microsoft/X), JWT, Basic Auth
+        # credentials docs removed; use ADK documentation for outbound creds
         Programmatic Agents:
         - agent-loading.md: Custom loaders and in-memory registrations
         Configuration:

{google_adk_extras-0.2.6 → google_adk_extras-0.2.7}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "google-adk-extras"
-version = "0.2.6"
-description = "Production-ready services, credentials, and FastAPI wiring for Google ADK"
+version = "0.2.7"
+description = "Production-ready services and FastAPI wiring for Google ADK"
 readme = "README.md"
 requires-python = ">=3.10,<3.13"
 authors = [
@@ -38,6 +38,20 @@ all = [
     "google-adk-extras[sql,mongodb,redis,yaml,s3,jwt,web,docs]",
 ]
 
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F"]
+ignore = [
+  "F401",  # unused-import (common in optional backends)
+  "F841",  # unused-variable (tests and examples)
+  "F821",  # undefined-name (forward-ref type strings in optional extras)
+  "E402",  # module-import-not-at-top-of-file (test-only patterns)
+  "E501",  # line-too-long (permissive until we tighten rules)
+]
+
 [build-system]
 requires = ["setuptools>=45", "wheel"]
 build-backend = "setuptools.build_meta"

{google_adk_extras-0.2.6 → google_adk_extras-0.2.7}/src/google_adk_extras/__init__.py

@@ -1,4 +1,4 @@
-"""Production-ready services, credentials, and FastAPI wiring for Google ADK.
+"""Production-ready services and FastAPI wiring for Google ADK.
 
 Public API surface:
 - AdkBuilder
@@ -11,7 +11,7 @@ Service groups are exposed via subpackages:
 - google_adk_extras.sessions
 - google_adk_extras.artifacts
 - google_adk_extras.memory
-- google_adk_extras.credentials
+  (credential services are provided by ADK; no custom extras here)
 """
 
 from .adk_builder import AdkBuilder
@@ -28,4 +28,4 @@ __all__ = [
     "CustomAgentLoader",
 ]
 
-__version__ = "0.2.6"
+__version__ = "0.2.7"