agentkit-sdk-python 0.7.4__py3-none-any.whl → 0.7.6__py3-none-any.whl

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/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/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/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.dist-info → agentkit_sdk_python-0.7.6.dist-info}/METADATA

@@ -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.dist-info → agentkit_sdk_python-0.7.6.dist-info}/RECORD

@@ -1,6 +1,6 @@
 agentkit/__init__.py,sha256=l27ZMDslc3VhmmnPZJyrqVvTDoZ0LqhCtM5hw0caHcU,1021
 agentkit/errors.py,sha256=UWlXv0ZsXd_oLTMlxuf4u9-XkTdRYeVZueE--Z3JsHU,1214
-agentkit/version.py,sha256=S9zUkhZqaZ0llqw_JF_CXK5OsV7vd2EIpTBKb38hgCI,653
+agentkit/version.py,sha256=oFLDChAr94DBKT7M7QxgZ_7Ypdo7s4CRVCDwIb-kkCk,653
 agentkit/apps/__init__.py,sha256=-oXTjxV3gejpJ8pffTUcUAXw0LfxKCYZJk-_hIJhtLM,1921
 agentkit/apps/base_app.py,sha256=3hZZExL1wyTGWveJEZZoqXN086MzmkVS_WU1vyulIWg,754
 agentkit/apps/utils.py,sha256=IzimIDmT6FS6PV9MLimPh46mq5zT-EjVmnYPxBdyEq0,1934
@@ -40,10 +40,11 @@ agentkit/client/__init__.py,sha256=WHKgNGkpYsJp0xD20drYcxAMDclwDqrfURqxEVv0V1Y,1
 agentkit/client/base_agentkit_client.py,sha256=NV1m2FtboUcMdVUJL2ep75nAwDQ42roiWgl3YKaUSn8,2955
 agentkit/client/base_iam_client.py,sha256=F3ggcZjt14CAcgDYpncF2XGr1zTGnhaOzqEJl4NGHwU,2432
 agentkit/client/base_service_client.py,sha256=zpPUidGMDRAMDnSVjrX7BwuOp4BQdAEk0b8HoXks0TE,15049
-agentkit/frameworks/__init__.py,sha256=NPT7kxcY7shMyA2m1QoxhXzAc9JEvDCNFyWupedTCSY,808
+agentkit/frameworks/__init__.py,sha256=cfUdMeixph0xAo6B5qGQBBdm8LeQbWZIl1vmO9cEL3E,971
 agentkit/frameworks/_common.py,sha256=0L0cyBQxtlOdi3GbQ_UgaOoHWwenztlKrxUsyvV3hXw,3859
 agentkit/frameworks/langchain.py,sha256=Tcy2HGYqKmcugDSn3OMaD_6uxhsJtZI3o5E8Rw7UJrg,5947
-agentkit/frameworks/langgraph.py,sha256=CHhaX6DcE8McC6Cs31gexEJHqJJ7cFiqh8D6vyQ8FVE,12770
+agentkit/frameworks/langgraph.py,sha256=FX8QHjfS4QHSTGq4oYwQ7MytrUejDFmVczihNPCts4A,14201
+agentkit/frameworks/migration.py,sha256=j8MxFvAFKkDsTy_e1l5bN-B276AE7rwxLrHuBodNcfc,4385
 agentkit/frameworks/serving/__init__.py,sha256=EaR0jzP6np8v1gyD6CYlaRoIY1KgBaFosqCmRUgMc2E,302
 agentkit/frameworks/serving/fastapi_mount.py,sha256=LV6gJunwd7aU8MFdDYSxeaIUYWvYwMl2Am1J07ddP0A,1958
 agentkit/frameworks/serving/langserve.py,sha256=R2R0g95LHcSFJ1BnOm2cxnULv3wQaZNUdm5Aqd-Oq5s,17238
@@ -178,10 +179,6 @@ agentkit/toolkit/resources/samples/financial_analyst.py,sha256=5lkkvtG6u2SlLg_Mw
 agentkit/toolkit/resources/samples/langchain_basic_stream.py,sha256=hSnysOQxnzyZ4NmHUyxmJdmEMsVWlRlg8HUz12Gt5fY,3229
 agentkit/toolkit/resources/samples/simple_app_veadk.py,sha256=pzO1cCwZsNdAT-to7xRivBDBfqek_zGxhT5xdGJOVkY,2215
 agentkit/toolkit/resources/samples/simple_mcp_veadk.py,sha256=VguGNLGIbv1O-11bgbNX4UIEX0lpeULLZw0Cn1ayWEA,1696
-agentkit/toolkit/resources/samples/__pycache__/customer_support_assistant.cpython-312.pyc,sha256=KQUfeIRfNZRGcd7dCWavgrmOJ2alT8qTUq4p56TGTTo,208
-agentkit/toolkit/resources/samples/__pycache__/financial_analyst.cpython-312.pyc,sha256=EkaSa3UQaNUbvtxblrjV3KQtbywIqaZTWSkzaF31-AE,4373
-agentkit/toolkit/resources/samples/__pycache__/simple_app_veadk.cpython-312.pyc,sha256=p3D45XVsVFUZf5Z3bhaGwj4vqSZ2tcqM2t8Zq2hhoR4,2332
-agentkit/toolkit/resources/samples/__pycache__/simple_mcp_veadk.cpython-312.pyc,sha256=w47SK2g3D4H8JHryuvJQF2oU9EYYQBPdsGr9DOzG0oQ,1722
 agentkit/toolkit/resources/samples/eino_a2a/agent.go,sha256=__TJxBHJ4o3SPv2VUVGiNP32Hd8aYd79i22GlXFl1Xo,2010
 agentkit/toolkit/resources/samples/eino_a2a/build.sh,sha256=GbUBI8p_hs6j1LW93VG1RmwWfo5ECW3Bpvoc96bLe9s,1683
 agentkit/toolkit/resources/samples/eino_a2a/go.mod,sha256=ruHkgBsD0mCutShombeZVH1Kh0S0sydXGSVoY3VCkM8,6742
@@ -244,9 +241,9 @@ agentkit/utils/redact.py,sha256=RAtiggxH74eb1Da6Gg0G5SLTVWRaIE5RqYnCozSZozQ,2167
 agentkit/utils/request.py,sha256=1IGxPS3BSCKk1K1_j862_v34xzLEx04CIvrLVb1MsGQ,1625
 agentkit/utils/template_utils.py,sha256=Qjg9V6dEpjAd_yYezIIPwuDsDeeMmp6XTMn5ZECifNc,6336
 agentkit/utils/ve_sign.py,sha256=JfKig7zni8KvdhgbLJXm3Zy_ttyzKrYGUmBY_82_A4Q,12762
-agentkit_sdk_python-0.7.4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agentkit_sdk_python-0.7.4.dist-info/METADATA,sha256=s47zJ5ciuJGmqJoi4WcqSMqz8lUM4HWt3eAHAQ4kKGo,19880
-agentkit_sdk_python-0.7.4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-agentkit_sdk_python-0.7.4.dist-info/entry_points.txt,sha256=fhzZUsvsLXeB4mPaa0SBQiTBqFT404uDAKPaePAOUAE,58
-agentkit_sdk_python-0.7.4.dist-info/top_level.txt,sha256=ipy8JF-QQ-V0C1oRFLxsyaW8zwrasfJ-zjAh9vgOc7U,9
-agentkit_sdk_python-0.7.4.dist-info/RECORD,,
+agentkit_sdk_python-0.7.6.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+agentkit_sdk_python-0.7.6.dist-info/METADATA,sha256=qyc849JYVuXgxK90Hcc_20C9n8xCerH5S8Z9WnV8ReU,21144
+agentkit_sdk_python-0.7.6.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+agentkit_sdk_python-0.7.6.dist-info/entry_points.txt,sha256=fhzZUsvsLXeB4mPaa0SBQiTBqFT404uDAKPaePAOUAE,58
+agentkit_sdk_python-0.7.6.dist-info/top_level.txt,sha256=ipy8JF-QQ-V0C1oRFLxsyaW8zwrasfJ-zjAh9vgOc7U,9
+agentkit_sdk_python-0.7.6.dist-info/RECORD,,

{agentkit_sdk_python-0.7.4.dist-info → agentkit_sdk_python-0.7.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (83.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any