iac-code 0.12.0__tar.gz → 0.13.0__tar.gz

{iac_code-0.12.0 → iac_code-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iac_code
-Version: 0.12.0
+Version: 0.13.0
 Summary: Your AI-powered Infrastructure as Code assistant
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -36,14 +36,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 +83,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 +112,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.0 → iac_code-0.13.0}/README.md

@@ -16,14 +16,36 @@
 > **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
@@ -41,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`:
@@ -66,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.13.0/src/iac_code/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "0.13.0"
+__release_date__ = "2026-08-19"

{iac_code-0.12.0 → iac_code-0.13.0}/src/iac_code/a2a/app.py

@@ -25,6 +25,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 +38,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(
@@ -161,7 +164,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 +294,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:
@@ -370,11 +373,12 @@ def create_app(
 
     @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())
+        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())
             yield
         finally:
             if push_worker_task is not None:
@@ -397,6 +401,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 +449,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()
@@ -701,12 +709,15 @@ def run_server(
 
 
 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.0 → iac_code-0.13.0}/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)