agentkit-sdk-python 0.4.2__tar.gz → 0.4.3__tar.gz

{agentkit_sdk_python-0.4.2 → agentkit_sdk_python-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentkit-sdk-python
-Version: 0.4.2
+Version: 0.4.3
 Summary: Python SDK for transforming any AI agent into a production-ready application. Framework-agnostic primitives for runtime, memory, authentication, and tools with volcengine-managed infrastructure.
 Author-email: Xiangrui Cheng <innsdcc@gmail.com>, Yumeng Bao <baoyumeng.123@gmail.com>, Yaozheng Fang <fangyozheng@gmail.com>, Guodong Li <cu.eric.lee@gmail.com>
 License:                                  Apache License

{agentkit_sdk_python-0.4.2 → agentkit_sdk_python-0.4.3}/agentkit/apps/agent_server_app/agent_server_app.py

@@ -15,6 +15,7 @@
 import json
 import logging
 from contextlib import asynccontextmanager
+from typing import Any
 from typing_extensions import override
 
 import uvicorn
@@ -67,6 +68,19 @@ class AgentKitAgentLoader(BaseAgentLoader):
     def list_agents(self) -> list[str]:
         return [self.agent.name]
 
+    @override
+    def list_agents_detailed(self) -> list[dict[str, Any]]:
+        name = self.agent.name
+        description = getattr(self.agent, "description", "") or ""
+        return [
+            {
+                "name": name,
+                "root_agent_name": name,
+                "description": description,
+                "language": "python",
+            }
+        ]
+
 
 class AgentkitAgentServerApp(BaseAgentkitApp):
     def __init__(
@@ -110,8 +124,6 @@ class AgentkitAgentServerApp(BaseAgentkitApp):
 
         self.app = self.server.get_fast_api_app(lifespan=lifespan)
 
-        self.app.mount("/", _a2a_server_app)
-
         # Attach ASGI middleware for unified telemetry across all routes
         self.app.add_middleware(AgentkitTelemetryHTTPMiddleware)
 
@@ -121,9 +133,12 @@ class AgentkitAgentServerApp(BaseAgentkitApp):
 
             # Extract headers (fallback keys supported)
             headers = request.headers
-            user_id = (
-                headers.get("user_id") or headers.get("x-user-id") or "agentkit_user"
-            )
+            telemetry_headers = {
+                k: v
+                for k, v in dict(headers).items()
+                if k.lower() not in {"authorization", "token"}
+            }
+            user_id = headers.get("user_id") or "agentkit_user"
             session_id = headers.get("session_id") or ""
 
             # Determine app_name from loader
@@ -157,7 +172,7 @@ class AgentkitAgentServerApp(BaseAgentkitApp):
             telemetry.trace_agent_server(
                 func_name="_invoke_compat",
                 span=span,
-                headers=dict(headers),
+                headers=telemetry_headers,
                 text=text or "",
             )
 
@@ -210,6 +225,9 @@ class AgentkitAgentServerApp(BaseAgentkitApp):
         # Compatibility route for AgentKit CLI invoke
         self.app.add_api_route("/invoke", _invoke_compat, methods=["POST"])
 
+        # Mount A2A server app last to avoid shadowing API routes like `/invoke`.
+        self.app.mount("/", _a2a_server_app)
+
     def run(self, host: str, port: int = 8000) -> None:
         """Run the app with Uvicorn server."""
         uvicorn.run(self.app, host=host, port=port)

{agentkit_sdk_python-0.4.2 → agentkit_sdk_python-0.4.3}/agentkit/apps/agent_server_app/middleware.py

@@ -27,7 +27,6 @@ class AgentkitTelemetryHTTPMiddleware:
         self.app = app
 
     async def __call__(self, scope, receive, send):
-        print(f"test: {scope}")
         if scope["type"] != "http":
             return await self.app(scope, receive, send)
 
@@ -37,7 +36,7 @@ class AgentkitTelemetryHTTPMiddleware:
         headers = {k.decode("latin-1"): v.decode("latin-1") for k, v in headers_list}
         span = telemetry.tracer.start_span(name="agent_server_request")
         ctx = trace.set_span_in_context(span)
-        context_api.attach(ctx)
+        token = context_api.attach(ctx)
         headers = {
             k: v for k, v in headers.items() if k.lower() not in _EXCLUDED_HEADERS
         }
@@ -45,8 +44,10 @@ class AgentkitTelemetryHTTPMiddleware:
         # Currently unable to retrieve user_id and session_id from headers; keep logic for future use
         user_id = headers.get("user_id")
         session_id = headers.get("session_id")
-        headers["user_id"] = user_id
-        headers["session_id"] = session_id
+        if user_id:
+            headers["user_id"] = user_id
+        if session_id:
+            headers["session_id"] = session_id
         telemetry.trace_agent_server(
             func_name=f"{method} {path}",
             span=span,
@@ -73,3 +74,5 @@ class AgentkitTelemetryHTTPMiddleware:
         except Exception as e:
             telemetry.trace_agent_server_finish(path=path, func_result="", exception=e)
             raise
+        finally:
+            context_api.detach(token)

{agentkit_sdk_python-0.4.2 → agentkit_sdk_python-0.4.3}/agentkit/platform/configuration.py

@@ -164,6 +164,7 @@ class VolcConfiguration:
         3. Global Env Vars
         4. Global Config File
         5. VeFaaS IAM
+        6. .env file in current working directory (fallback)
         """
         # 1. Explicit
         if self._ak and self._sk:
@@ -189,11 +190,76 @@ class VolcConfiguration:
         if creds := self._get_credential_from_vefaas_iam():
             return creds
 
+        # 6. .env file fallback (Current Working Directory)
+        if creds := self._get_dotenv_credentials(service_key):
+            return creds
+
         raise ValueError(
-            f"Volcengine credentials not found (Service: {service_key}). Please set environment variables VOLCENGINE_ACCESS_KEY and "
-            "VOLCENGINE_SECRET_KEY, or configure in global config file ~/.agentkit/config.yaml."
+            "\n".join(
+                [
+                    f"Volcengine credentials not found (Service: {service_key}).",
+                    "Recommended (global, set once):",
+                    "  agentkit config --global --set volcengine.access_key=YOUR_ACCESS_KEY",
+                    "  agentkit config --global --set volcengine.secret_key=YOUR_SECRET_KEY",
+                    "Alternative (per-shell):",
+                    "  export VOLCENGINE_ACCESS_KEY=YOUR_ACCESS_KEY",
+                    "  export VOLCENGINE_SECRET_KEY=YOUR_SECRET_KEY",
+                ]
+            )
         )
 
+    def _get_dotenv_credentials(self, service_key: str) -> Optional[Credentials]:
+        """Attempt to read credentials from a local .env file.
+
+        This is a last-resort fallback for CLI users who commonly expect `.env` in the
+        current working directory to provide environment variables.
+
+        Notes:
+        - Reads only `Path.cwd() / '.env'`.
+        - Does NOT mutate the current process environment.
+        """
+
+        try:
+            from dotenv import dotenv_values
+        except Exception:
+            return None
+
+        env_file_path = Path.cwd() / ".env"
+
+        try:
+            values = dotenv_values(env_file_path)
+        except Exception:
+            return None
+
+        if not isinstance(values, dict):
+            return None
+
+        def _get(key: str) -> str:
+            v = values.get(key)
+            return str(v) if v is not None else ""
+
+        svc_upper = service_key.upper()
+
+        # Service-specific keys (align with environment variable behavior)
+        ak = _get(f"VOLCENGINE_{svc_upper}_ACCESS_KEY")
+        sk = _get(f"VOLCENGINE_{svc_upper}_SECRET_KEY")
+        if not ak or not sk:
+            # Legacy support
+            ak = ak or _get(f"VOLC_{svc_upper}_ACCESSKEY")
+            sk = sk or _get(f"VOLC_{svc_upper}_SECRETKEY")
+
+        if ak and sk:
+            return Credentials(access_key=ak, secret_key=sk)
+
+        # Global keys
+        ak = _get("VOLCENGINE_ACCESS_KEY") or _get("VOLC_ACCESSKEY")
+        sk = _get("VOLCENGINE_SECRET_KEY") or _get("VOLC_SECRETKEY")
+
+        if ak and sk:
+            return Credentials(access_key=ak, secret_key=sk)
+
+        return None
+
     def _get_service_env_credentials(self, service_key: str) -> Optional[Credentials]:
         svc_upper = service_key.upper()
         ak = os.getenv(f"VOLCENGINE_{svc_upper}_ACCESS_KEY")

{agentkit_sdk_python-0.4.2 → agentkit_sdk_python-0.4.3}/agentkit/toolkit/config/utils.py

@@ -18,7 +18,7 @@ from pathlib import Path
 from typing import Dict, Any, Optional
 import logging
 
-from dotenv import load_dotenv, dotenv_values
+from dotenv import dotenv_values
 from yaml import safe_load, YAMLError
 
 from .constants import AUTO_CREATE_VE
@@ -48,8 +48,7 @@ def load_dotenv_file(project_dir: Path) -> Dict[str, str]:
     if not env_file_path.exists():
         return {}
 
-    # Load .env into environment temporarily to get the values
-    load_dotenv(env_file_path)
+    # Parse values without mutating the current process environment.
     env_values = dotenv_values(env_file_path)
     return {k: str(v) for k, v in env_values.items() if v is not None}
 

{agentkit_sdk_python-0.4.2 → agentkit_sdk_python-0.4.3}/agentkit/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-VERSION = "0.4.2"
+VERSION = "0.4.3"

{agentkit_sdk_python-0.4.2 → agentkit_sdk_python-0.4.3}/agentkit_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentkit-sdk-python
-Version: 0.4.2
+Version: 0.4.3
 Summary: Python SDK for transforming any AI agent into a production-ready application. Framework-agnostic primitives for runtime, memory, authentication, and tools with volcengine-managed infrastructure.
 Author-email: Xiangrui Cheng <innsdcc@gmail.com>, Yumeng Bao <baoyumeng.123@gmail.com>, Yaozheng Fang <fangyozheng@gmail.com>, Guodong Li <cu.eric.lee@gmail.com>
 License:                                  Apache License

{agentkit_sdk_python-0.4.2 → agentkit_sdk_python-0.4.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentkit-sdk-python"
-version = "0.4.2"
+version = "0.4.3"
 description = "Python SDK for transforming any AI agent into a production-ready application. Framework-agnostic primitives for runtime, memory, authentication, and tools with volcengine-managed infrastructure."
 readme = "README.md"
 requires-python = ">=3.10"