iac-code 0.12.1__tar.gz → 0.13.1__tar.gz

{iac_code-0.12.1 → iac_code-0.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iac_code
-Version: 0.12.1
+Version: 0.13.1
 Summary: Your AI-powered Infrastructure as Code assistant
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -19,7 +19,7 @@ Provides-Extra: http
 License-File: LICENSE
 
 <p align="center">
-  <img src="website/static/img/logo-with-front.png" alt="iac-code" width="200">
+  <img src="https://raw.githubusercontent.com/aliyun/iac-code/main/website/static/img/logo-with-front.png" alt="iac-code" width="200">
 </p>
 <p align="center">
   <em>AI-powered Infrastructure as Code assistant for cloud infrastructure through natural language interaction. Currently supports Alibaba Cloud ROS and Terraform workflows.</em>
@@ -29,21 +29,40 @@ License-File: LICENSE
   <a href="https://pypi.org/project/iac-code"><img src="https://img.shields.io/pypi/v/iac-code?color=%2334D058&label=pypi%20package" alt="PyPI Package"></a>
   <a href="https://pypi.org/project/iac-code"><img src="https://img.shields.io/pypi/pyversions/iac-code?color=%2334D058&label=python" alt="Python"></a>
 </p>
+
+> **Documentation**: [https://aliyun.github.io/iac-code/](https://aliyun.github.io/iac-code/)
+
 <p align="center">
-  <strong>Language</strong>: English | <a href="readme/README.zh.md">中文</a> | <a href="readme/README.es.md">Español</a> | <a href="readme/README.fr.md">Français</a> | <a href="readme/README.de.md">Deutsch</a> | <a href="readme/README.ja.md">日本語</a> | <a href="readme/README.pt.md">Português</a>
+  <a href="https://github.com/aliyun/iac-code/releases/latest"><img src="https://img.shields.io/badge/Download-IaC%20Code%20Desktop-5268f2?style=for-the-badge" alt="Download IaC Code Desktop"></a>
+  <br>
+  <a href="https://ros-public-tools.oss-cn-beijing.aliyuncs.com/github-releases/aliyun/iac-code/desktop/stable/iac-code-macos-arm64.dmg">macOS Apple Silicon</a> ·
+  <a href="https://ros-public-tools.oss-cn-beijing.aliyuncs.com/github-releases/aliyun/iac-code/desktop/stable/iac-code-windows-x64.exe">Windows x64</a> ·
+  <a href="https://ros-public-tools.oss-cn-beijing.aliyuncs.com/github-releases/aliyun/iac-code/desktop/stable/iac-code-linux-x64.AppImage">Linux AppImage</a> ·
+  <a href="https://ros-public-tools.oss-cn-beijing.aliyuncs.com/github-releases/aliyun/iac-code/desktop/stable/iac-code-linux-x64.deb">Linux deb</a> ·
+  <a href="https://github.com/aliyun/iac-code/releases/latest">All release files</a>
 </p>
 
-> **Documentation**: [https://aliyun.github.io/iac-code/](https://aliyun.github.io/iac-code/)
+## Desktop App
+
+No Python, pip, or terminal setup required — download the native app and start building cloud infrastructure right away. Get the package for your platform from the [latest GitHub Release](https://github.com/aliyun/iac-code/releases/latest):
+
+- macOS Apple Silicon: `.dmg`
+- Windows x64: setup `.exe`
+- Linux x64: `.AppImage` or `.deb`
+
+The Desktop app runs the same IaC Code engine and uses the same providers, cloud credentials, settings, projects, and sessions as the CLI and Web app. On first launch, select the project directory you want IaC Code to work in. Windows also checks for Git Bash and guides you through installation if it is missing.
 
 <p align="center">
-  <img src="website/static/img/demo_en.gif" alt="iac-code demo" width="100%">
+  <img src="https://raw.githubusercontent.com/aliyun/iac-code/main/website/static/img/screenshots/iac-code-desktop-en.jpg" alt="IaC Code Desktop app" width="100%">
 </p>
 
+macOS, Windows, and AppImage builds can check for and apply cryptographically signed updates in the app. The deb package is updated by installing a newer package. Stable macOS packages are signed with Apple Developer ID and notarized by Apple; stable Windows packages carry an Authenticode publisher signature. Always download from the official release page and verify the accompanying `SHA256SUMS`. See the [Desktop App guide](https://aliyun.github.io/iac-code/docs/desktop-app) for installation and troubleshooting details.
+
 ## Installation
 
-IaC Code requires Python 3.10 or later. It supports macOS, Linux, and Windows.
+The CLI and Web app below run on Python 3.10 or later, on macOS, Linux, and Windows. If you only use the Desktop app, you can skip this section.
 
-> **Windows note**: On Windows, [Git for Windows](https://gitforwindows.org/) must be installed to provide the bash shell used by the tool execution environment. If Git Bash is installed but not on PATH, set the `IAC_CODE_GIT_BASH_PATH` environment variable.
+> **Windows note**: On Windows, [Git for Windows](https://gitforwindows.org/) must be installed to provide the bash shell used by the tool execution environment. If Git Bash is installed but not on PATH, set the `IAC_CODE_GIT_BASH_PATH` environment variable. If it is not installed yet, run `iac-code install-git-bash` to install Git for Windows automatically (downloaded via the npmmirror mirror).
 
 ```bash
 pip install iac-code
@@ -61,6 +80,10 @@ Run directly to enter the interactive REPL:
 iac-code
 ```
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aliyun/iac-code/main/website/static/img/demo_en.gif" alt="iac-code demo" width="100%">
+</p>
+
 ### Non-Interactive Mode
 
 Pass a one-shot prompt via `--prompt`:
@@ -86,17 +109,9 @@ iac-code web
 
 By default it opens `http://127.0.0.1:8766` in your browser (loopback only). See the [Web App guide](https://aliyun.github.io/iac-code/web-app) for details.
 
-### Desktop App
-
-For an installed native experience, download the package for your platform from [GitHub Releases](https://github.com/aliyun/iac-code/releases):
-
-- macOS Apple Silicon: `.dmg`
-- Windows x64: setup `.exe`
-- Linux x64: `.AppImage` or `.deb`
-
-The Desktop app runs the same IaC Code engine and uses the same providers, cloud credentials, settings, projects, and sessions as the CLI and Web app. On first launch, select the project directory you want IaC Code to work in. Windows also checks for Git Bash and guides you through installation if it is missing.
-
-macOS, Windows, and AppImage builds can check for and apply cryptographically signed updates in the app. The deb package is updated by installing a newer package. Release installers do not yet carry commercial publisher signatures, so macOS or Windows may display an unknown-developer warning; verify the accompanying `SHA256SUMS` before installation. See the [Desktop App guide](https://aliyun.github.io/iac-code/docs/desktop-app) for installation and troubleshooting details.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aliyun/iac-code/main/website/static/img/screenshots/iac-code-web-en.jpg" alt="IaC Code Web app" width="100%">
+</p>
 
 ## Contributing
 
@@ -116,4 +131,4 @@ See the [Contributing Guide](https://aliyun.github.io/iac-code/getting-started/c
 
 | [DingTalk](https://qr.dingtalk.com/action/joingroup?code=v1,k1,ubm/77U7qRh/STFZUNBP26X4PNg2z6+uhiPcLGtDNfU=&_dt_no_comment=1&origin=11) | [Discord](https://discord.gg/qECFuFBwF) |
 | :----------------------------------------------------------: | :----------------------------------------------------------: |
-| [<img src="website/static/img/qrcode-dingtalk.jpg" width="120" height="120" alt="DingTalk">](https://qr.dingtalk.com/action/joingroup?code=v1,k1,ubm/77U7qRh/STFZUNBP26X4PNg2z6+uhiPcLGtDNfU=&_dt_no_comment=1&origin=11) | [<img src="website/static/img/qrcode-discord.jpg" width="120" height="120" alt="Discord">](https://discord.gg/qECFuFBwF) |
+| [<img src="https://raw.githubusercontent.com/aliyun/iac-code/main/website/static/img/qrcode-dingtalk.jpg" width="120" height="120" alt="DingTalk">](https://qr.dingtalk.com/action/joingroup?code=v1,k1,ubm/77U7qRh/STFZUNBP26X4PNg2z6+uhiPcLGtDNfU=&_dt_no_comment=1&origin=11) | [<img src="https://raw.githubusercontent.com/aliyun/iac-code/main/website/static/img/qrcode-discord.jpg" width="120" height="120" alt="Discord">](https://discord.gg/qECFuFBwF) |

iac_code-0.12.1/src/iac_code.egg-info/PKG-INFO → iac_code-0.13.1/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.1
-Name: iac-code
-Version: 0.12.1
-Summary: Your AI-powered Infrastructure as Code assistant
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Provides-Extra: a2a
-Provides-Extra: a2a-grpc
-Provides-Extra: a2a-redis
-Provides-Extra: a2a-signing
-Provides-Extra: diagram
-Provides-Extra: http
-License-File: LICENSE
-
 <p align="center">
   <img src="website/static/img/logo-with-front.png" alt="iac-code" width="200">
 </p>
@@ -36,14 +16,36 @@ License-File: LICENSE
 > **Documentation**: [https://aliyun.github.io/iac-code/](https://aliyun.github.io/iac-code/)
 
 <p align="center">
-  <img src="website/static/img/demo_en.gif" alt="iac-code demo" width="100%">
+  <a href="https://github.com/aliyun/iac-code/releases/latest"><img src="https://img.shields.io/badge/Download-IaC%20Code%20Desktop-5268f2?style=for-the-badge" alt="Download IaC Code Desktop"></a>
+  <br>
+  <a href="https://ros-public-tools.oss-cn-beijing.aliyuncs.com/github-releases/aliyun/iac-code/desktop/stable/iac-code-macos-arm64.dmg">macOS Apple Silicon</a> ·
+  <a href="https://ros-public-tools.oss-cn-beijing.aliyuncs.com/github-releases/aliyun/iac-code/desktop/stable/iac-code-windows-x64.exe">Windows x64</a> ·
+  <a href="https://ros-public-tools.oss-cn-beijing.aliyuncs.com/github-releases/aliyun/iac-code/desktop/stable/iac-code-linux-x64.AppImage">Linux AppImage</a> ·
+  <a href="https://ros-public-tools.oss-cn-beijing.aliyuncs.com/github-releases/aliyun/iac-code/desktop/stable/iac-code-linux-x64.deb">Linux deb</a> ·
+  <a href="https://github.com/aliyun/iac-code/releases/latest">All release files</a>
+</p>
+
+## Desktop App
+
+No Python, pip, or terminal setup required — download the native app and start building cloud infrastructure right away. Get the package for your platform from the [latest GitHub Release](https://github.com/aliyun/iac-code/releases/latest):
+
+- macOS Apple Silicon: `.dmg`
+- Windows x64: setup `.exe`
+- Linux x64: `.AppImage` or `.deb`
+
+The Desktop app runs the same IaC Code engine and uses the same providers, cloud credentials, settings, projects, and sessions as the CLI and Web app. On first launch, select the project directory you want IaC Code to work in. Windows also checks for Git Bash and guides you through installation if it is missing.
+
+<p align="center">
+  <img src="website/static/img/screenshots/iac-code-desktop-en.jpg" alt="IaC Code Desktop app" width="100%">
 </p>
 
+macOS, Windows, and AppImage builds can check for and apply cryptographically signed updates in the app. The deb package is updated by installing a newer package. Stable macOS packages are signed with Apple Developer ID and notarized by Apple; stable Windows packages carry an Authenticode publisher signature. Always download from the official release page and verify the accompanying `SHA256SUMS`. See the [Desktop App guide](https://aliyun.github.io/iac-code/docs/desktop-app) for installation and troubleshooting details.
+
 ## Installation
 
-IaC Code requires Python 3.10 or later. It supports macOS, Linux, and Windows.
+The CLI and Web app below run on Python 3.10 or later, on macOS, Linux, and Windows. If you only use the Desktop app, you can skip this section.
 
-> **Windows note**: On Windows, [Git for Windows](https://gitforwindows.org/) must be installed to provide the bash shell used by the tool execution environment. If Git Bash is installed but not on PATH, set the `IAC_CODE_GIT_BASH_PATH` environment variable.
+> **Windows note**: On Windows, [Git for Windows](https://gitforwindows.org/) must be installed to provide the bash shell used by the tool execution environment. If Git Bash is installed but not on PATH, set the `IAC_CODE_GIT_BASH_PATH` environment variable. If it is not installed yet, run `iac-code install-git-bash` to install Git for Windows automatically (downloaded via the npmmirror mirror).
 
 ```bash
 pip install iac-code
@@ -61,6 +63,10 @@ Run directly to enter the interactive REPL:
 iac-code
 ```
 
+<p align="center">
+  <img src="website/static/img/demo_en.gif" alt="iac-code demo" width="100%">
+</p>
+
 ### Non-Interactive Mode
 
 Pass a one-shot prompt via `--prompt`:
@@ -86,17 +92,9 @@ iac-code web
 
 By default it opens `http://127.0.0.1:8766` in your browser (loopback only). See the [Web App guide](https://aliyun.github.io/iac-code/web-app) for details.
 
-### Desktop App
-
-For an installed native experience, download the package for your platform from [GitHub Releases](https://github.com/aliyun/iac-code/releases):
-
-- macOS Apple Silicon: `.dmg`
-- Windows x64: setup `.exe`
-- Linux x64: `.AppImage` or `.deb`
-
-The Desktop app runs the same IaC Code engine and uses the same providers, cloud credentials, settings, projects, and sessions as the CLI and Web app. On first launch, select the project directory you want IaC Code to work in. Windows also checks for Git Bash and guides you through installation if it is missing.
-
-macOS, Windows, and AppImage builds can check for and apply cryptographically signed updates in the app. The deb package is updated by installing a newer package. Release installers do not yet carry commercial publisher signatures, so macOS or Windows may display an unknown-developer warning; verify the accompanying `SHA256SUMS` before installation. See the [Desktop App guide](https://aliyun.github.io/iac-code/docs/desktop-app) for installation and troubleshooting details.
+<p align="center">
+  <img src="website/static/img/screenshots/iac-code-web-en.jpg" alt="IaC Code Web app" width="100%">
+</p>
 
 ## Contributing
 

{iac_code-0.12.1 → iac_code-0.13.1}/pyproject.toml

@@ -1,8 +1,7 @@
 [project]
 name = "iac_code"
-dynamic = ["version"]
+dynamic = ["version", "readme"]
 description = "Your AI-powered Infrastructure as Code assistant"
-readme = "README.md"
 requires-python = ">=3.10"
 classifiers = [
     "Programming Language :: Python :: 3",

{iac_code-0.12.1 → iac_code-0.13.1}/setup.py

@@ -1,5 +1,6 @@
 """Custom build hook to inject __release_date__ at build time."""
 
+import os
 import platform
 import re
 import shutil
@@ -99,7 +100,19 @@ def _read_version():
 
 def _read_long_description():
     readme = Path("README.md")
-    return readme.read_text(encoding="utf-8") if readme.is_file() else ""
+    if not readme.is_file():
+        return ""
+    text = readme.read_text(encoding="utf-8")
+    # PyPI renders the package description standalone, where the README's
+    # relative image paths have no repository base and show up broken.
+    # Rewrite them to absolute raw URLs at build time so the checked-in
+    # README keeps GitHub-friendly relative paths.
+    # The language switcher links point at in-repo translated READMEs, which
+    # cannot resolve on PyPI's standalone rendering; drop the line there.
+    text = re.sub(r'<p align="center">\s*<strong>Language</strong>.*?</p>\n?', "", text, flags=re.S)
+    ref = os.environ.get("IAC_CODE_README_IMG_REF", "main")
+    base = "https://raw.githubusercontent.com/aliyun/iac-code/{}/website/static/img/".format(ref)
+    return text.replace('src="website/static/img/', 'src="{}'.format(base))
 
 
 def _try_import_babel():

iac_code-0.13.1/src/iac_code/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "0.13.1"
+__release_date__ = "2026-08-21"

{iac_code-0.12.1 → iac_code-0.13.1}/src/iac_code/a2a/app.py

@@ -7,7 +7,9 @@ import hashlib
 import hmac
 import json
 import logging
+import math
 import os
+import signal
 from contextlib import asynccontextmanager, suppress
 from email.utils import formatdate
 from pathlib import Path
@@ -25,6 +27,7 @@ from starlette.requests import Request
 from starlette.responses import JSONResponse, Response
 from starlette.routing import BaseRoute, Route
 
+from iac_code import __version__
 from iac_code.a2a.agent_card import agent_card_to_client_dict
 from iac_code.a2a.jsonrpc_passthrough import (
     install_jsonrpc_error_data_passthrough,
@@ -37,6 +40,8 @@ from iac_code.a2a.projection import (
     resolve_a2a_public_path_roots_for_data,
 )
 from iac_code.i18n import _
+from iac_code.pipeline.config import get_run_mode
+from iac_code.services.configuration_readiness import configuration_readiness
 
 logger = logging.getLogger(__name__)
 _V03_JSONRPC_METHODS = frozenset(
@@ -69,6 +74,58 @@ class _PrincipalUser(User):
         return self._principal
 
 
+class _A2AIdleShutdownController:
+    def __init__(self, timeout_seconds: float, callback: Callable[[], None]) -> None:
+        self._timeout_seconds = timeout_seconds
+        self._callback = callback
+        self._inflight_requests = 0
+        self._last_activity = 0.0
+
+    def touch(self) -> None:
+        self._last_activity = asyncio.get_running_loop().time()
+
+    def request_started(self) -> None:
+        self._inflight_requests += 1
+        self.touch()
+
+    def request_finished(self) -> None:
+        self._inflight_requests = max(0, self._inflight_requests - 1)
+        self.touch()
+
+    async def monitor(self, task_store: Any) -> None:
+        interval = min(1.0, max(0.05, self._timeout_seconds / 10))
+        while True:
+            await asyncio.sleep(interval)
+            if self._inflight_requests:
+                continue
+            now = asyncio.get_running_loop().time()
+            if now - self._last_activity < self._timeout_seconds:
+                continue
+            if await task_store.has_active_work():
+                self._last_activity = asyncio.get_running_loop().time()
+                continue
+            if self._inflight_requests:
+                continue
+            self._callback()
+            return
+
+
+class _A2AIdleActivityMiddleware:
+    def __init__(self, app: Any, *, controller: _A2AIdleShutdownController) -> None:
+        self._app = app
+        self._controller = controller
+
+    async def __call__(self, scope: dict[str, Any], receive: Any, send: Any) -> None:
+        if scope["type"] != "http":
+            await self._app(scope, receive, send)
+            return
+        self._controller.request_started()
+        try:
+            await self._app(scope, receive, send)
+        finally:
+            self._controller.request_finished()
+
+
 def resolve_token(cli_token: str | None) -> str | None:
     return cli_token or os.environ.get("IACCODE_A2A_HTTP_TOKEN")
 
@@ -161,7 +218,7 @@ class A2AProjectionMiddleware(BaseHTTPMiddleware):
         request_data = await _a2a_request_data(request)
         response = await call_next(request)
         request_data = _with_a2a_path_parameters(request, request_data)
-        if request.url.path in {"/health", AGENT_CARD_WELL_KNOWN_PATH}:
+        if request.url.path in {"/health", "/iac-code/readiness", AGENT_CARD_WELL_KNOWN_PATH}:
             return response
 
         content_type = response.headers.get("content-type", "").lower()
@@ -291,7 +348,7 @@ def _take_sse_frame(data: bytes) -> tuple[bytes, bytes | None, bytes]:
 
 
 async def health(request: Request) -> JSONResponse:
-    return JSONResponse({"status": "healthy"})
+    return JSONResponse({"status": "healthy", "version": __version__, "mode": get_run_mode().value})
 
 
 async def normalize_v03_jsonrpc_version(request: Request) -> None:
@@ -336,6 +393,8 @@ def create_app(
     agent_extensions: object | None = None,
     auto_approve_permissions: bool = False,
     thinking_exposure: object | None = None,
+    idle_shutdown_seconds: float = 0,
+    idle_shutdown_callback: Callable[[], None] | None = None,
 ) -> Starlette:
     from iac_code.a2a.transports.dispatcher import create_runtime_components
 
@@ -368,15 +427,31 @@ def create_app(
     )
     from iac_code.a2a.pipeline_recovery import A2APipelineRecoveryService
 
+    idle_controller: _A2AIdleShutdownController | None = None
+    if idle_shutdown_seconds > 0:
+        idle_controller = _A2AIdleShutdownController(
+            idle_shutdown_seconds,
+            idle_shutdown_callback or (lambda: os.kill(os.getpid(), signal.SIGTERM)),
+        )
+
     @asynccontextmanager
     async def lifespan(app: Starlette):
-        await components.task_store.start_cleanup_loop()
         push_worker_task: asyncio.Task[None] | None = None
-        if components.push_worker is not None:
-            push_worker_task = asyncio.create_task(components.push_worker.serve_forever())
+        idle_shutdown_task: asyncio.Task[None] | None = None
+        components.start_background_services()
         try:
+            await components.task_store.start_cleanup_loop()
+            if components.push_worker is not None:
+                push_worker_task = asyncio.create_task(components.push_worker.serve_forever())
+            if idle_controller is not None:
+                idle_controller.touch()
+                idle_shutdown_task = asyncio.create_task(idle_controller.monitor(components.task_store))
             yield
         finally:
+            if idle_shutdown_task is not None:
+                idle_shutdown_task.cancel()
+                with suppress(asyncio.CancelledError):
+                    await idle_shutdown_task
             if push_worker_task is not None:
                 push_worker_task.cancel()
                 with suppress(asyncio.CancelledError):
@@ -397,6 +472,9 @@ def create_app(
             return Response(status_code=304, headers=card_cache_headers)
         return JSONResponse(card_data, headers=card_cache_headers)
 
+    async def get_readiness(request: Request) -> JSONResponse:
+        return JSONResponse(configuration_readiness(model=model))
+
     recovery_service = A2APipelineRecoveryService(task_store=components.task_store)
 
     async def recovery_path_roots(*, context_id: str | None, task_id: str | None) -> list[dict[str, str]]:
@@ -442,6 +520,7 @@ def create_app(
     routes: list[BaseRoute] = [
         Route("/health", health, methods=["GET"]),
         Route(AGENT_CARD_WELL_KNOWN_PATH, get_agent_card, methods=["GET"]),
+        Route("/iac-code/readiness", get_readiness, methods=["GET"]),
         Route("/iac-code/pipeline/state", get_pipeline_state, methods=["GET"]),
     ]
     install_jsonrpc_error_data_passthrough()
@@ -464,6 +543,8 @@ def create_app(
         api_key=api_key,
         api_key_header=api_key_header,
     )
+    if idle_controller is not None:
+        app.add_middleware(_A2AIdleActivityMiddleware, controller=idle_controller)
     return app
 
 
@@ -527,10 +608,20 @@ def run_server(
     push_lease_timeout_ms: int = 300_000,
     auto_approve_permissions: bool = False,
     thinking_exposure: object | None = None,
+    idle_shutdown_seconds: float = 0,
 ) -> None:
     from iac_code.a2a.transports.base import normalize_transport_name, validate_transport_for_platform
 
     normalized_transport = normalize_transport_name(transport)
+    if isinstance(idle_shutdown_seconds, bool) or not isinstance(idle_shutdown_seconds, (int, float)):
+        raise ValueError("idle_shutdown_seconds must be a non-negative number.")
+    idle_shutdown_seconds = float(idle_shutdown_seconds)
+    if not math.isfinite(idle_shutdown_seconds):
+        raise ValueError("idle_shutdown_seconds must be a non-negative number.")
+    if idle_shutdown_seconds < 0:
+        raise ValueError("idle_shutdown_seconds must be a non-negative number.")
+    if idle_shutdown_seconds > 0 and normalized_transport != "http":
+        raise RuntimeError("idle_shutdown_seconds is only supported with the HTTP transport.")
     if persistence_dir is None:
         from iac_code.config import get_config_dir
 
@@ -655,6 +746,13 @@ def run_server(
         )
         return
 
+    idle_server_holder: dict[str, Any] = {}
+
+    def request_idle_shutdown() -> None:
+        server = idle_server_holder.get("server")
+        if server is not None:
+            server.should_exit = True
+
     if normalized_transport == "websocket":
         from iac_code.a2a.transports.websocket import WebSocketA2AServerApp
 
@@ -686,6 +784,8 @@ def run_server(
             supported_interfaces=supported_interfaces,
             auto_approve_permissions=auto_approve_permissions,
             thinking_exposure=thinking_exposure,
+            idle_shutdown_seconds=idle_shutdown_seconds,
+            idle_shutdown_callback=request_idle_shutdown,
         )
 
     try:
@@ -693,20 +793,28 @@ def run_server(
     except ImportError as exc:
         raise RuntimeError("A2A server dependencies are missing. Install with: pip install 'iac-code[a2a]'") from exc
 
-    uvicorn.run(
-        app,
-        host=host,
-        port=port,
-    )
+    if idle_shutdown_seconds > 0:
+        server = uvicorn.Server(uvicorn.Config(app, host=host, port=port))
+        idle_server_holder["server"] = server
+        server.run()
+    else:
+        uvicorn.run(
+            app,
+            host=host,
+            port=port,
+        )
 
 
 async def _serve_async_transport(server, *, components) -> None:
-    await components.task_store.start_cleanup_loop()
     push_worker_task: asyncio.Task[None] | None = None
-    if components.push_worker is not None:
-        push_worker_task = asyncio.create_task(components.push_worker.serve_forever())
-        await asyncio.sleep(0)
+    start_background_services = getattr(components, "start_background_services", None)
+    if start_background_services is not None:
+        start_background_services()
     try:
+        await components.task_store.start_cleanup_loop()
+        if components.push_worker is not None:
+            push_worker_task = asyncio.create_task(components.push_worker.serve_forever())
+            await asyncio.sleep(0)
         await server.serve()
     finally:
         if push_worker_task is not None:

{iac_code-0.12.1 → iac_code-0.13.1}/src/iac_code/a2a/events.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import asyncio
 import copy
 import inspect
 import logging
@@ -162,7 +163,7 @@ def _extract_artifact_metadata(result: Any, artifact_store: Any | None) -> dict[
         if not path.is_file():
             return None
         metadata = artifact_store.save_bytes(filename=filename, content=path.read_bytes(), media_type=str(media_type))
-        return metadata.to_dict()
+        return {**metadata.to_dict(), "sourcePath": str(path.resolve())}
     raw_bytes = raw.get("raw")
     if isinstance(raw_bytes, bytes):
         metadata = artifact_store.save_bytes(filename=filename, content=raw_bytes, media_type=str(media_type))
@@ -219,6 +220,9 @@ def _artifact_update_event(*, task_id: str, context_id: str, metadata: dict[str,
         "byteSize": metadata["byteSize"],
         "sha256": metadata["sha256"],
     }
+    source_path = metadata.get("sourcePath")
+    if isinstance(source_path, str) and source_path:
+        artifact_metadata["sourcePath"] = source_path
     artifact = Artifact(
         artifact_id=str(metadata["artifactId"]),
         name=str(metadata["filename"]),
@@ -280,6 +284,7 @@ async def publish_stream_event(
     event: Any,
     artifact_store: Any | None = None,
     permission_resolver: A2APermissionResolver | None = None,
+    permission_input_registry: Any | None = None,
     auto_approve_permissions: bool = False,
     exposure_types: Any = None,
     iac_code_session_id: str | None = None,
@@ -372,6 +377,8 @@ async def publish_stream_event(
 
     if isinstance(event, ToolResultEvent):
         artifact_metadata = _extract_artifact_metadata(event.result, artifact_store)
+        if artifact_metadata is None:
+            artifact_metadata = _extract_artifact_metadata(event.metadata, artifact_store)
         if A2AExposureType.TOOL_TRACE not in enabled_exposure_types:
             if artifact_metadata is not None:
                 await event_queue.enqueue_event(
@@ -429,6 +436,58 @@ async def publish_stream_event(
 
     permission_event = _permission_request_event(event)
     if permission_event is not None:
+        if permission_input_registry is not None and permission_resolver is None and not auto_approve_permissions:
+            pending = await permission_input_registry.register(
+                permission_event,
+                task_id=task_id,
+                context_id=context_id,
+            )
+            try:
+                await _enqueue_status(
+                    event_queue,
+                    task_id=task_id,
+                    context_id=context_id,
+                    state=TaskState.TASK_STATE_INPUT_REQUIRED,
+                    metadata={
+                        "iac_code": {
+                            "input": pending.envelope(),
+                            "permission": {
+                                "autoApproved": False,
+                                "pending": True,
+                                "toolName": permission_event.tool_name,
+                                "toolUseId": permission_event.tool_use_id,
+                            },
+                        }
+                    },
+                    iac_code_session_id=iac_code_session_id,
+                )
+                future = permission_event.response_future
+                if future is None:
+                    await permission_input_registry.fail(pending)
+                    return None
+                await asyncio.shield(future)
+                await _enqueue_status(
+                    event_queue,
+                    task_id=task_id,
+                    context_id=context_id,
+                    state=TaskState.TASK_STATE_WORKING,
+                    metadata={
+                        "iac_code": {
+                            "inputReceived": {
+                                "kind": "permission",
+                                "inputId": pending.input_id,
+                                "toolUseId": permission_event.tool_use_id,
+                            }
+                        }
+                    },
+                    iac_code_session_id=iac_code_session_id,
+                )
+            except BaseException:
+                await permission_input_registry.fail(pending)
+                raise
+            finally:
+                await permission_input_registry.complete(pending)
+            return None
         approved = auto_approve_permissions
         if permission_resolver is not None:
             decision = permission_resolver(permission_event)