agentkit-sdk-python 0.7.4__tar.gz → 0.7.6__tar.gz

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentkit-sdk-python
-Version: 0.7.4
+Version: 0.7.6
 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
@@ -340,6 +340,40 @@ pip install agentkit-sdk-python==1.0.0.dev1
 
 **Note**: Development versions may contain bugs and are not recommended for production use.
 
+## Release Process
+
+Stable releases are published from GitHub tags. The source tree keeps the
+release version in `pyproject.toml` and `agentkit/version.py`, and the GitHub
+workflow verifies that the pushed tag matches those files before building and
+publishing the package.
+
+The release workflow must already exist on `main` before you push the release
+tag. For `0.7.5`, merge the tag-release automation change first, then create
+and push `v0.7.5`.
+
+Use the following workflow for a stable release:
+
+```bash
+git checkout main
+git pull github main
+git tag v0.7.5
+git push github v0.7.5
+```
+
+When the tag reaches GitHub, `.github/workflows/release-pypi.yml` will:
+
+- verify the tag is reachable from `main`
+- verify that `pyproject.toml` and `agentkit/version.py` match the tag version
+- build the wheel and source distribution from the tagged commit
+- verify the built artifacts contain the expected version metadata
+- publish the release to PyPI using the GitHub Actions secret `PYPI_API_TOKEN`
+
+The internal `local_build.py` helper is a separate local-only workflow and is
+not used by the GitHub tag release.
+
+Before using the GitHub tag release workflow, configure a project-scoped PyPI
+API token in the repository's GitHub Actions secrets as `PYPI_API_TOKEN`.
+
 ## Security and privacy
 
 This project takes security seriously.

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.6}/README.md

@@ -85,6 +85,40 @@ pip install agentkit-sdk-python==1.0.0.dev1
 
 **Note**: Development versions may contain bugs and are not recommended for production use.
 
+## Release Process
+
+Stable releases are published from GitHub tags. The source tree keeps the
+release version in `pyproject.toml` and `agentkit/version.py`, and the GitHub
+workflow verifies that the pushed tag matches those files before building and
+publishing the package.
+
+The release workflow must already exist on `main` before you push the release
+tag. For `0.7.5`, merge the tag-release automation change first, then create
+and push `v0.7.5`.
+
+Use the following workflow for a stable release:
+
+```bash
+git checkout main
+git pull github main
+git tag v0.7.5
+git push github v0.7.5
+```
+
+When the tag reaches GitHub, `.github/workflows/release-pypi.yml` will:
+
+- verify the tag is reachable from `main`
+- verify that `pyproject.toml` and `agentkit/version.py` match the tag version
+- build the wheel and source distribution from the tagged commit
+- verify the built artifacts contain the expected version metadata
+- publish the release to PyPI using the GitHub Actions secret `PYPI_API_TOKEN`
+
+The internal `local_build.py` helper is a separate local-only workflow and is
+not used by the GitHub tag release.
+
+Before using the GitHub tag release workflow, configure a project-scoped PyPI
+API token in the repository's GitHub Actions secrets as `PYPI_API_TOKEN`.
+
 ## Security and privacy
 
 This project takes security seriously.

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.6}/agentkit/frameworks/__init__.py

@@ -14,6 +14,7 @@ __all__ = [
     "LangChainAgentkitBridge",
     "LangGraphAgentkitBridge",
     "UnsupportedFrameworkAgentError",
+    "load_entry_object",
 ]
 
 
@@ -26,4 +27,8 @@ def __getattr__(name: str) -> Any:
         from agentkit.frameworks.langgraph import LangGraphAgentkitBridge
 
         return LangGraphAgentkitBridge
+    if name == "load_entry_object":
+        from agentkit.frameworks.migration import load_entry_object
+
+        return load_entry_object
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.6}/agentkit/frameworks/langgraph.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from collections.abc import AsyncGenerator
+import hashlib
 import inspect
 import json
 from typing import Any
@@ -84,6 +85,35 @@ def _resume_value(text_input: str) -> Any:
     return text_input
 
 
+def _update_output_text(data: Any) -> str:
+    """Extract user-facing output from LangGraph update payloads.
+
+    LangGraph ``stream_mode=["messages", "updates"]`` can emit internal LLM
+    message chunks as well as node state updates. Generic recursive extraction
+    is too broad for updates such as ``{"classify": {"route": "x"}}``; only
+    explicit output-like fields should override streamed message text.
+    """
+    if not isinstance(data, dict):
+        return chunk_to_text(data)
+
+    for key in ("answer", "output", "text", "content", "messages"):
+        if key in data:
+            text = chunk_to_text(data[key])
+            if text:
+                return text
+
+    latest = ""
+    for value in data.values():
+        if not isinstance(value, dict):
+            continue
+        for key in ("answer", "output", "text", "content", "messages"):
+            if key in value:
+                text = chunk_to_text(value[key])
+                if text:
+                    latest = text
+    return latest
+
+
 class LangGraphAgentkitBridge(BaseAgent):
     """Adapt a compiled LangGraph graph to AgentKit's ADK runtime boundary."""
 
@@ -112,7 +142,15 @@ class LangGraphAgentkitBridge(BaseAgent):
         session_id = getattr(session, "id", None)
         if not session_id:
             return None
-        return {"configurable": {"thread_id": session_id}}
+        app_name = getattr(session, "app_name", None)
+        user_id = getattr(session, "user_id", None)
+        if app_name and user_id:
+            raw_identity = f"{app_name}\0{user_id}\0{session_id}"
+            digest = hashlib.sha256(raw_identity.encode("utf-8")).hexdigest()
+            thread_id = f"agentkit:{digest}"
+        else:
+            thread_id = session_id
+        return {"configurable": {"thread_id": thread_id}}
 
     def _pending_interrupt(self, ctx: InvocationContext) -> Any | None:
         session = getattr(ctx, "session", None)
@@ -189,32 +227,37 @@ class LangGraphAgentkitBridge(BaseAgent):
         stream_fn = getattr(self._graph, "stream", None)
         if not callable(stream_fn):
             return None
-        try:
-            return stream_fn(
-                payload,
-                **_method_kwargs(
-                    stream_fn,
-                    {
-                        "config": config,
-                        "stream_mode": ["messages", "updates"],
-                        "version": "v2",
-                    },
-                ),
-            )
-        except TypeError:
-            try:
-                return stream_fn(
-                    payload,
-                    **_method_kwargs(
-                        stream_fn,
-                        {
-                            "config": config,
-                            "stream_mode": ["messages", "updates"],
-                        },
-                    ),
-                )
-            except TypeError:
-                return stream_fn(payload, **_method_kwargs(stream_fn, {"config": config}))
+        attempts = [
+            {
+                "config": config,
+                "stream_mode": ["messages", "updates"],
+                "version": "v2",
+            },
+            {
+                "config": config,
+                "stream_mode": ["messages", "updates"],
+            },
+            {"config": config},
+        ]
+
+        def iterate_attempts():
+            last_error: TypeError | None = None
+            for kwargs in attempts:
+                emitted = False
+                try:
+                    stream = stream_fn(payload, **_method_kwargs(stream_fn, kwargs))
+                    for item in stream:
+                        emitted = True
+                        yield item
+                    return
+                except TypeError as exc:
+                    if emitted:
+                        raise
+                    last_error = exc
+            if last_error is not None:
+                raise last_error
+
+        return iterate_attempts()
 
     async def _stream_graph(self, payload: Any, config: dict[str, Any] | None, *, prefer_sync: bool = False):
         if prefer_sync:
@@ -226,35 +269,33 @@ class LangGraphAgentkitBridge(BaseAgent):
 
         astream = getattr(self._graph, "astream", None)
         if callable(astream):
-            try:
-                stream = astream(
-                    payload,
-                    **_method_kwargs(
-                        astream,
-                        {
-                            "config": config,
-                            "stream_mode": ["messages", "updates"],
-                            "version": "v2",
-                        },
-                    ),
-                )
-            except TypeError:
+            attempts = [
+                {
+                    "config": config,
+                    "stream_mode": ["messages", "updates"],
+                    "version": "v2",
+                },
+                {
+                    "config": config,
+                    "stream_mode": ["messages", "updates"],
+                },
+                {"config": config},
+            ]
+            last_error: TypeError | None = None
+            for kwargs in attempts:
+                emitted = False
                 try:
-                    stream = astream(
-                        payload,
-                        **_method_kwargs(
-                            astream,
-                            {
-                                "config": config,
-                                "stream_mode": ["messages", "updates"],
-                            },
-                        ),
-                    )
-                except TypeError:
-                    stream = astream(payload, **_method_kwargs(astream, {"config": config}))
-            async for item in stream:
-                yield item
-            return
+                    stream = astream(payload, **_method_kwargs(astream, kwargs))
+                    async for item in stream:
+                        emitted = True
+                        yield item
+                    return
+                except TypeError as exc:
+                    if emitted:
+                        raise
+                    last_error = exc
+            if last_error is not None:
+                raise last_error
 
         stream = self._sync_stream(payload, config)
         if stream is not None:
@@ -318,9 +359,7 @@ class LangGraphAgentkitBridge(BaseAgent):
                     )
                     return
                 last_update = data
-                if saw_messages:
-                    continue
-                text = chunk_to_text(data)
+                text = _update_output_text(data)
                 if text:
                     pending_update_text = text
                 continue
@@ -334,10 +373,11 @@ class LangGraphAgentkitBridge(BaseAgent):
                     yield adk_event(ctx, self.name, delta, partial=True)
 
         if streamed:
+            update_text = pending_update_text or _update_output_text(last_update)
             if saw_messages or has_output:
-                final_text = accumulated_text
+                final_text = update_text or accumulated_text
             else:
-                final_text = pending_update_text or chunk_to_text(last_update)
+                final_text = update_text
                 if final_text:
                     yield adk_event(ctx, self.name, final_text, partial=True)
         else:

agentkit_sdk_python-0.7.6/agentkit/frameworks/migration.py

@@ -0,0 +1,135 @@
+"""Helpers used by generated framework migration apps."""
+
+from __future__ import annotations
+
+import importlib
+import importlib.util
+import inspect
+from pathlib import Path
+import sys
+from types import ModuleType
+from typing import Any
+
+
+def _prepend_sys_path(path: Path) -> None:
+    value = str(path)
+    if value not in sys.path:
+        sys.path.insert(0, value)
+
+
+def _load_module_from_file(entry_path: Path, import_name: str) -> ModuleType:
+    if not entry_path.is_file():
+        raise FileNotFoundError(f"Entry file does not exist: {entry_path}")
+
+    spec = importlib.util.spec_from_file_location(import_name, entry_path)
+    if spec is None or spec.loader is None:
+        raise RuntimeError(f"Cannot load entry module from {entry_path}")
+
+    module = importlib.util.module_from_spec(spec)
+    sys.modules[import_name] = module
+    try:
+        spec.loader.exec_module(module)
+    except Exception:
+        if sys.modules.get(import_name) is module:
+            del sys.modules[import_name]
+        raise
+    return module
+
+
+def _resolve_object(module: ModuleType, object_path: str) -> Any:
+    if not object_path:
+        raise ValueError("entry object path is required")
+
+    target: Any = module
+    for attr in object_path.split("."):
+        if not attr:
+            raise ValueError(
+                f"entry object path contains an empty attribute: {object_path!r}"
+            )
+        try:
+            target = getattr(target, attr)
+        except AttributeError as exc:
+            raise AttributeError(
+                f"Entry object {object_path!r} was not found; "
+                f"missing attribute {attr!r} on {target!r}."
+            ) from exc
+    return target
+
+
+def _call_zero_arg_factory(target: Any, object_path: str) -> Any:
+    if not callable(target):
+        raise TypeError(
+            f"Entry object {object_path!r} was marked as a factory, "
+            "but the loaded object is not callable."
+        )
+
+    try:
+        signature = inspect.signature(target)
+    except (TypeError, ValueError) as exc:
+        raise TypeError(
+            f"Entry factory {object_path!r} has no inspectable signature. "
+            "Expose a zero-argument factory or a constructed agent object."
+        ) from exc
+
+    required_params = [
+        name
+        for name, param in signature.parameters.items()
+        if param.default is inspect.Parameter.empty
+        and param.kind
+        in {
+            inspect.Parameter.POSITIONAL_ONLY,
+            inspect.Parameter.POSITIONAL_OR_KEYWORD,
+            inspect.Parameter.KEYWORD_ONLY,
+        }
+    ]
+    if required_params:
+        formatted = ", ".join(required_params)
+        raise TypeError(
+            f"Entry factory {object_path!r} requires arguments: {formatted}. "
+            "agentkit migrate can only call zero-argument factories; expose a "
+            "thin zero-argument entry object for migration."
+        )
+
+    result = target()
+    if inspect.isawaitable(result):
+        raise TypeError(
+            f"Entry factory {object_path!r} returned an awaitable object. "
+            "Async factories are not supported by generated migration apps; "
+            "expose a synchronous factory or a constructed agent object."
+        )
+    return result
+
+
+def load_entry_object(
+    *,
+    file: str,
+    object_path: str,
+    module: str | None = None,
+    project_root: str | Path = ".",
+    base_dir: str | Path | None = None,
+    import_name: str = "agentkit_migrated_entry",
+    call_factory: bool = False,
+) -> Any:
+    """Load an object from a migrated project's original entry reference.
+
+    The generated migration app lives beside or below the user's project files.
+    This helper keeps that app small while preserving the import behavior that
+    users expect from running their original project.
+    """
+
+    base_path = (
+        Path(base_dir).resolve() if base_dir is not None else Path.cwd().resolve()
+    )
+    project_root_path = (base_path / project_root).resolve()
+    _prepend_sys_path(project_root_path)
+
+    if module:
+        loaded_module = importlib.import_module(module)
+    else:
+        entry_path = (base_path / file).resolve()
+        loaded_module = _load_module_from_file(entry_path, import_name)
+
+    target = _resolve_object(loaded_module, object_path)
+    if call_factory:
+        return _call_zero_arg_factory(target, object_path)
+    return target

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.6}/agentkit/version.py

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

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.6}/agentkit_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentkit-sdk-python
-Version: 0.7.4
+Version: 0.7.6
 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
@@ -340,6 +340,40 @@ pip install agentkit-sdk-python==1.0.0.dev1
 
 **Note**: Development versions may contain bugs and are not recommended for production use.
 
+## Release Process
+
+Stable releases are published from GitHub tags. The source tree keeps the
+release version in `pyproject.toml` and `agentkit/version.py`, and the GitHub
+workflow verifies that the pushed tag matches those files before building and
+publishing the package.
+
+The release workflow must already exist on `main` before you push the release
+tag. For `0.7.5`, merge the tag-release automation change first, then create
+and push `v0.7.5`.
+
+Use the following workflow for a stable release:
+
+```bash
+git checkout main
+git pull github main
+git tag v0.7.5
+git push github v0.7.5
+```
+
+When the tag reaches GitHub, `.github/workflows/release-pypi.yml` will:
+
+- verify the tag is reachable from `main`
+- verify that `pyproject.toml` and `agentkit/version.py` match the tag version
+- build the wheel and source distribution from the tagged commit
+- verify the built artifacts contain the expected version metadata
+- publish the release to PyPI using the GitHub Actions secret `PYPI_API_TOKEN`
+
+The internal `local_build.py` helper is a separate local-only workflow and is
+not used by the GitHub tag release.
+
+Before using the GitHub tag release workflow, configure a project-scoped PyPI
+API token in the repository's GitHub Actions secrets as `PYPI_API_TOKEN`.
+
 ## Security and privacy
 
 This project takes security seriously.

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.6}/agentkit_sdk_python.egg-info/SOURCES.txt

@@ -48,6 +48,7 @@ agentkit/frameworks/__init__.py
 agentkit/frameworks/_common.py
 agentkit/frameworks/langchain.py
 agentkit/frameworks/langgraph.py
+agentkit/frameworks/migration.py
 agentkit/frameworks/serving/__init__.py
 agentkit/frameworks/serving/fastapi_mount.py
 agentkit/frameworks/serving/langserve.py
@@ -182,10 +183,6 @@ agentkit/toolkit/resources/samples/financial_analyst.py
 agentkit/toolkit/resources/samples/langchain_basic_stream.py
 agentkit/toolkit/resources/samples/simple_app_veadk.py
 agentkit/toolkit/resources/samples/simple_mcp_veadk.py
-agentkit/toolkit/resources/samples/__pycache__/customer_support_assistant.cpython-312.pyc
-agentkit/toolkit/resources/samples/__pycache__/financial_analyst.cpython-312.pyc
-agentkit/toolkit/resources/samples/__pycache__/simple_app_veadk.cpython-312.pyc
-agentkit/toolkit/resources/samples/__pycache__/simple_mcp_veadk.cpython-312.pyc
 agentkit/toolkit/resources/samples/eino_a2a/agent.go
 agentkit/toolkit/resources/samples/eino_a2a/build.sh
 agentkit/toolkit/resources/samples/eino_a2a/go.mod

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.6}/pyproject.toml

@@ -1,6 +1,10 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
 [project]
 name = "agentkit-sdk-python"
-version = "0.7.4"
+version = "0.7.6"
 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"