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

{google_adk_extras-0.2.5/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.5
-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.5 → 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.5 → 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.7/docs/streaming.md

@@ -0,0 +1,119 @@
+# Streaming
+
+The optional streaming layer adds a persistent, bi‑directional channel on top of
+Google ADK’s existing `/run`, `/run_sse`, and `/run_live` primitives. It exposes
+simple endpoints for a chat‑style UI while keeping strict ADK type parity.
+
+- Uplink payload: the exact ADK `RunAgentRequest` (JSON)
+- Downlink events: the exact ADK `Event` JSON
+- Per‑channel binding to `(appName, userId, sessionId)`
+
+## Enable
+
+```python
+from google_adk_extras import AdkBuilder
+
+app = (
+    AdkBuilder()
+      .with_agents_dir("./agents")  # or programmatic loader/instances
+      .build_fastapi_app(enable_streaming=True)
+)
+```
+
+Optional config:
+
+```python
+from google_adk_extras.streaming import StreamingConfig
+
+cfg = StreamingConfig(
+    streaming_path_base="/stream",
+    strict_types=True,
+    create_session_on_open=True,  # create a new ADK session on first subscribe
+    ttl_seconds=900,
+    max_queue_size=128,
+    max_channels_per_user=20,
+    heartbeat_interval=20.0,
+)
+
+app = AdkBuilder().with_agents_dir("./agents").build_fastapi_app(
+    enable_streaming=True,
+    streaming_config=cfg,
+)
+```
+
+## Endpoints (default base: `/stream`)
+
+- `GET  /stream/events/{channelId}?appName=&userId=&sessionId=` — SSE downlink
+  - If `sessionId` is omitted and `create_session_on_open=True`, a session is created.
+  - First, a control message is sent: `event: channel-bound` with `data: {appName,userId,sessionId}`.
+  - Subsequent `data: ...` lines contain raw ADK `Event` JSON.
+
+- `POST /stream/send/{channelId}` — enqueue a single run on the bound channel
+  - Body must be a strict ADK `RunAgentRequest` JSON whose `(appName,userId,sessionId)`
+    match the channel binding.
+
+- `WS   /stream/ws/{channelId}?appName=&userId=&sessionId=` — WebSocket bidi
+  - On connect, a `{"event":"channel-bound",...}` JSON frame is sent with the final `sessionId`.
+  - Client sends strict `RunAgentRequest` JSON frames to enqueue runs.
+  - Server streams raw ADK `Event` JSON frames back.
+
+## Minimal Client Examples
+
+SSE (browser):
+
+```html
+<script>
+const ch = crypto.randomUUID();
+const src = new EventSource(`/stream/events/${ch}?appName=my_app&userId=u1`);
+let sessionId;
+src.addEventListener('channel-bound', (e) => {
+  const info = JSON.parse(e.data);
+  sessionId = info.sessionId;
+  // Now send a RunAgentRequest
+  fetch(`/stream/send/${ch}`, {
+    method: 'POST',
+    headers: {'Content-Type':'application/json'},
+    body: JSON.stringify({
+      appName: "my_app",
+      userId: "u1",
+      sessionId,
+      streaming: true,
+      newMessage: { parts: [{ text: "Hello!" }] }
+    })
+  });
+});
+
+src.onmessage = (e) => {
+  const event = JSON.parse(e.data); // ADK Event JSON
+  console.log('event', event);
+};
+</script>
+```
+
+WebSocket (browser):
+
+```html
+<script>
+const ch = crypto.randomUUID();
+const ws = new WebSocket(`ws://${location.host}/stream/ws/${ch}?appName=my_app&userId=u1`);
+let sessionId;
+ws.onmessage = (msg) => {
+  const data = JSON.parse(msg.data);
+  if (data.event === 'channel-bound') {
+    sessionId = data.sessionId;
+    ws.send(JSON.stringify({
+      appName: 'my_app', userId: 'u1', sessionId, streaming: true,
+      newMessage: { parts: [{ text: 'Hello!' }] }
+    }));
+  } else {
+    console.log('event', data); // ADK Event JSON
+  }
+};
+</script>
+```
+
+### Notes
+- This layer is optional. The core ADK endpoints remain available.
+- By default we preserve ADK wire types. If you need a convenience payload
+  (non‑strict), you can add your own translator at your API boundary.
+

{google_adk_extras-0.2.5 → 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.7/examples/streaming_sse_ws.py

@@ -0,0 +1,31 @@
+"""Streaming (SSE + WebSocket) example using AdkBuilder.
+
+Run:
+  uvicorn examples.streaming_sse_ws:app --reload
+
+This example enables the optional streaming layer and exposes routes under
+`/stream`:
+- GET  /stream/events/{channelId}?appName=&userId=&sessionId= (SSE)
+- POST /stream/send/{channelId}  (body = RunAgentRequest JSON)
+- WS   /stream/ws/{channelId}?appName=&userId=&sessionId=
+
+Notes:
+- On open, the server emits a channel-bound control message containing the
+  bound sessionId so the client can populate RunAgentRequest.
+"""
+
+from google_adk_extras import AdkBuilder
+
+
+app = (
+    AdkBuilder()
+    # Use either on-disk agents or programmatic agents. For streaming layer,
+    # the agent loader is optional if you stub the runner in tests; in real apps
+    # provide your agents via one of these methods:
+    # .with_agents_dir("./agents")
+
+    # Enable streaming layer with defaults
+    .with_web_ui(False)
+    .build_fastapi_app(enable_streaming=True)
+)
+

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

@@ -14,9 +14,9 @@ nav:
   - Getting Started: getting-started.md
   - Quickstarts: quickstarts.md
   - FastAPI Integration: fastapi.md
+  - Streaming: streaming.md
   - Services:
       - Durable Services: services.md
-      - Credentials: credentials.md
   - Programmatic Agents: agent-loading.md
   - URIs & Configuration: uris.md
   - Examples: examples.md
@@ -49,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.5 → google_adk_extras-0.2.7}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "google-adk-extras"
-version = "0.2.5"
-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.5 → 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.5"
+__version__ = "0.2.7"