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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentkit-sdk-python
-Version: 0.7.4
+Version: 0.7.5
 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.5}/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.5}/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.5}/agentkit/frameworks/langgraph.py

@@ -84,6 +84,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."""
 
@@ -318,9 +347,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 +361,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.5/agentkit/frameworks/migration.py

@@ -0,0 +1,86 @@
+"""Helpers used by generated framework migration apps."""
+
+from __future__ import annotations
+
+import importlib
+import importlib.util
+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 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",
+) -> 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)
+
+    return _resolve_object(loaded_module, object_path)

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.5}/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.5"

{agentkit_sdk_python-0.7.4 → agentkit_sdk_python-0.7.5}/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.5
 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.5}/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.5}/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.5"
 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"