amd-gaia 0.14.1__py3-none-any.whl → 0.14.3__py3-none-any.whl

gaia/agents/code/agent.py

@@ -332,7 +332,9 @@ class CodeAgent(
                     logger.error(f"Failed to write trace file: {e}")
 
             # Return dict matching app.py's expected format
-            project_dir = workspace_root or os.getcwd()
+            project_dir = execution_result.outputs.get(
+                "project_dir", workspace_root or os.getcwd()
+            )
             return {
                 "status": "success" if execution_result.success else "error",
                 "result": execution_result.summary,

gaia/agents/code/orchestration/__init__.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Orchestration framework for Code Agent.

gaia/agents/code/orchestration/checklist_executor.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """Checklist Executor for LLM-Driven Code Generation.
 
@@ -107,6 +107,12 @@ TEMPLATE_METADATA: Dict[str, Dict[str, Any]] = {
             ],
             "file_pattern": "src/app/{resource}s/[id]/page.tsx",
         },
+        "artifact-timer": {
+            "requires_client": True,
+            "expected_classes": [
+                "glass-card",
+            ],
+        },
     },
     "generate_api_route": {
         "collection": {
@@ -891,6 +897,7 @@ Return raw CSS starting with @tailwind base;"""
                 APP_GLOBALS_CSS,
                 CLIENT_COMPONENT_FORM,
                 CLIENT_COMPONENT_NEW_PAGE,
+                CLIENT_COMPONENT_TIMER,
                 SERVER_COMPONENT_DETAIL,
                 SERVER_COMPONENT_LIST,
             )
@@ -975,6 +982,7 @@ export default function Home() {
                 "form": CLIENT_COMPONENT_FORM,
                 "new": CLIENT_COMPONENT_NEW_PAGE,
                 "detail": SERVER_COMPONENT_DETAIL,
+                "artifact-timer": CLIENT_COMPONENT_TIMER,
             },
             "generate_api_route": {
                 "collection": api_route_collection,
@@ -1030,6 +1038,12 @@ export default function Home() {
 
         if template == "generate_react_component":
             variant = params.get("variant", "list")
+            component_name = params.get("component_name")
+            if component_name:
+                safe_name = "".join(
+                    ch for ch in component_name if ch.isalnum() or ch == "_"
+                )
+                component_name = safe_name or component_name
 
             if variant == "list":
                 return f"src/app/{resource}s/page.tsx"
@@ -1039,7 +1053,12 @@ export default function Home() {
                 return f"src/app/{resource}s/new/page.tsx"
             elif variant == "detail":
                 return f"src/app/{resource}s/[id]/page.tsx"
+            elif variant == "artifact-timer":
+                file_component = component_name or f"{resource_cap}Timer"
+                return f"src/components/{file_component}.tsx"
             else:
+                if component_name:
+                    return f"src/components/{component_name}.tsx"
                 return f"src/components/{resource_cap}{variant.capitalize()}.tsx"
 
         elif template == "generate_api_route":
@@ -1604,12 +1623,15 @@ if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = prisma;
         variant = template_params.get("variant", "list")
 
         # Generate component_name from resource + variant
-        # e.g., "todo" + "list" -> "TodoList"
+        # Allow caller to provide an explicit component_name (used for timers)
         resource_capitalized = resource.capitalize() if resource else "Item"
         variant_capitalized = variant.capitalize() if variant else "List"
+        explicit_component = template_params.get("component_name")
 
         # Build component name based on variant
-        if variant == "list":
+        if explicit_component:
+            component_name = explicit_component
+        elif variant == "list":
             component_name = f"{resource_capitalized}List"
         elif variant == "form":
             component_name = f"{resource_capitalized}Form"
@@ -1619,6 +1641,8 @@ if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = prisma;
             component_name = f"{resource_capitalized}Detail"
         elif variant == "actions":
             component_name = f"{resource_capitalized}Actions"
+        elif variant == "artifact-timer":
+            component_name = f"{resource_capitalized}Timer"
         else:
             component_name = f"{resource_capitalized}{variant_capitalized}"
 

gaia/agents/code/orchestration/checklist_generator.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """Checklist Generator for LLM-Driven Code Generation.
 
@@ -137,6 +137,8 @@ CHECKLIST_SYSTEM_PROMPT = """You are a code generation planner. Your task is to
 5. Ensure dependencies are satisfied (run setup before data, data before API, API before UI)
 6. Generate a complete checklist that creates a working application
 7. When follow-up fixes are requested, use `fix_code` to repair the specific files called out by validation/test logs. Extract the precise file paths and line numbers from the errors (see the Raw Validation Logs) and pass those line numbers inside the error description so the fixer knows exactly where to focus. Always reference the latest findings to decide which fixes to schedule before running validations again.
+8. If the user explicitly requests an additional UI artifact (countdown display, stats badge, etc.), schedule a `generate_react_component` step with the appropriate `artifact-*` variant (e.g., `"artifact-timer"`) and a descriptive `component_name`. Keep the artifact's logic inside that client component—server components like `page.tsx` should only render the artifact and pass any required props.
+9. **Route pairing requirement:** Whenever you schedule `{{"template": "generate_api_route", "params": {{"type": "collection", ...}}}}`, you MUST also include a matching `generate_api_route` item with `"type": "item"` for the same resource so detail pages can call `/api/<resource>/[id]`.
 
 This workflow repeats until all validations pass, so each checklist should either advance new functionality or explicitly repair the failures reported in the latest validation logs.
 
@@ -144,12 +146,13 @@ This workflow repeats until all validations pass, so each checklist should eithe
 
 For any app that manages resources (todos, posts, users, etc.), you MUST generate ALL of these UI components:
 
-1. **List page** (variant: "list") - Main page showing all items at /resources
-2. **Form component** (variant: "form") - Reusable form for create
+1. **Form component** (variant: "form") - Reusable form for create (generate this first so other pages can import it)
+2. **Artifact components** (variant: "artifact-*") - Any additional UI artifacts requested by the user (e.g., countdown display, stats badge). Generate these before any page that consumes them.
 3. **New page** (variant: "new") - Create new item at /resources/new
 4. **Edit page** (variant: "detail") - Edit single item at /resources/[id] with pre-populated form
+5. **List page** (variant: "list") - Main page showing all items at /resources
 
-Missing any of these will result in broken navigation! Always include all 4 variants.
+Missing any of the required components (form, new, detail, list) will result in broken navigation! When artifacts are requested, they must also be generated or the UI will be incomplete.
 
 ## REQUIRED: Setup and Validation Commands
 
@@ -181,6 +184,7 @@ Important:
 - Use exact template names from the catalog
 - Provide all required parameters
 - Order items by dependency (setup first, then data, then API, then UI)
+- REQUIRED ordering for `generate_react_component`: emit all non-`list` variants (form, new, detail, actions, artifact-*) before the `variant: "list"` call so the list can import previously generated components
 - Add semantic enhancements that make the app intuitive (e.g., checkboxes for todos)
 - For CRUD apps, ALWAYS include all 4 UI variants: list, form, new, detail
 - REQUIRED: Include `setup_app_styling` after `create_next_app`

gaia/agents/code/orchestration/factories/__init__.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """Factory implementations for workflow creation."""
 

gaia/agents/code/orchestration/factories/base.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Base factory for creating project workflows.

gaia/agents/code/orchestration/factories/nextjs_factory.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Next.js project factory.

gaia/agents/code/orchestration/factories/python_factory.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Python project factory.

gaia/agents/code/orchestration/orchestrator.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Orchestrator for LLM-driven workflow execution.
@@ -17,9 +17,11 @@ Features:
 
 import json
 import logging
+import os
 import re
 import subprocess
 from dataclasses import dataclass, field
+from pathlib import Path
 from typing import Any, Callable, Dict, List, Optional, Protocol
 
 from gaia.agents.base.console import AgentConsole
@@ -30,6 +32,10 @@ from .steps.error_handler import ErrorHandler
 logger = logging.getLogger(__name__)
 
 
+class ProjectDirectoryError(Exception):
+    """Raised when the project directory cannot be prepared safely."""
+
+
 def _estimate_token_count(text: str) -> int:
     """Lightweight token estimate assuming ~4 characters per token."""
     avg_chars_per_token = 4
@@ -198,6 +204,30 @@ class Orchestrator:
         steps_failed = 0
         success = False
 
+        try:
+            context.project_dir = self._prepare_project_directory(context)
+        except ProjectDirectoryError as exc:
+            error_message = str(exc)
+            logger.error(error_message)
+            if self.console:
+                self.console.print_error(error_message)
+            return ExecutionResult(
+                success=False,
+                phases_completed=[],
+                phases_failed=["project_directory"],
+                total_steps=1,
+                steps_succeeded=0,
+                steps_failed=1,
+                steps_skipped=0,
+                errors=[error_message],
+                outputs={
+                    "iterations": [],
+                    "validation_logs": [],
+                    "fix_feedback": [],
+                    "project_dir": context.project_dir,
+                },
+            )
+
         for iteration in range(1, self.max_checklist_loops + 1):
             logger.debug("Starting checklist iteration %d", iteration)
 
@@ -367,6 +397,7 @@ class Orchestrator:
             "iterations": iteration_outputs,
             "validation_logs": [log.to_dict() for log in aggregated_validation_logs],
             "fix_feedback": fix_feedback,
+            "project_dir": context.project_dir,
         }
 
         if latest_execution:
@@ -445,7 +476,7 @@ class Orchestrator:
         )
 
         try:
-            response = self.llm_client.send(prompt, timeout=1200, no_history=True)
+            response = self.llm_client.send(prompt, timeout=1200)
             data = self._parse_checkpoint_response(response)
             return CheckpointAssessment(
                 status=data.get("status", "needs_fix"),
@@ -472,7 +503,9 @@ class Orchestrator:
         validation_history: List[Any],
     ) -> str:
         """Build the prompt for the checkpoint reviewer."""
-        validation_summary = self._format_validation_history(validation_history)
+        validation_summary = self._format_validation_history(
+            validation_history, getattr(execution_result, "validation_logs", None)
+        )
 
         outstanding = (
             "\n".join(f"- {item}" for item in context.fix_feedback)
@@ -530,52 +563,250 @@ class Orchestrator:
             logger.exception("Failed to summarize conversation history: %s", exc)
             return None
 
-    def _format_validation_history(self, validation_history: List[Any]) -> str:
-        """Format validation logs for the checkpoint prompt."""
-        if not validation_history:
-            return "No validation or test commands have been executed yet."
+    def _prepare_project_directory(self, context: UserContext) -> str:
+        """
+        Ensure the project directory is ready for creation workflows.
 
-        lines: List[str] = []
-        recent = validation_history[-5:]
-        for entry in recent:
-            if hasattr(entry, "to_dict"):
-                entry_data = entry.to_dict()
-            elif isinstance(entry, dict):
-                entry_data = entry
+        If the provided path exists and is non-empty without an existing project,
+        pick a unique subdirectory via the LLM to avoid create-next-app failures.
+        """
+        base_path = Path(context.project_dir).expanduser()
+        if base_path.exists() and not base_path.is_dir():
+            raise ProjectDirectoryError(
+                f"Provided path is not a directory: {base_path}"
+            )
+
+        if not base_path.exists():
+            base_path.mkdir(parents=True, exist_ok=True)
+            logger.info("Created project directory: %s", base_path)
+            return str(base_path)
+
+        existing_entries = [p.name for p in base_path.iterdir()]
+        if not existing_entries:
+            return str(base_path)
+
+        if self.console:
+            self.console.print_warning(
+                f"Target directory {base_path} is not empty; selecting a new subdirectory."
+            )
+
+        suggested = self._choose_subdirectory_name(
+            base_path, existing_entries, context.user_request
+        )
+        if not suggested:
+            raise ProjectDirectoryError(
+                f"Unable to find an available project name under {base_path}. "
+                "Provide one explicitly with --path."
+            )
+
+        new_dir = base_path / suggested
+        new_dir.mkdir(parents=False, exist_ok=False)
+        logger.info("Using nested project directory: %s", new_dir)
+        # Align process cwd with the newly created project directory.
+        try:
+            os.chdir(new_dir)
+        except OSError as exc:
+            logger.warning("Failed to chdir to %s: %s", new_dir, exc)
+        if self.console:
+            self.console.print_info(f"Using project directory: {new_dir}")
+        return str(new_dir)
+
+    def _choose_subdirectory_name(
+        self, base_path: Path, existing_entries: List[str], user_request: str
+    ) -> Optional[str]:
+        """Ask the LLM for a unique subdirectory name, retrying on conflicts."""
+        existing_lower = {name.lower() for name in existing_entries}
+        prompt = self._build_directory_prompt(
+            base_path, existing_entries, user_request, None
+        )
+        last_reason = None
+
+        system_prompt = "You suggest concise folder names for new projects."
+
+        for attempt in range(1, 4):
+            try:
+                response = self._send_prompt_without_history(
+                    prompt, timeout=120, system_prompt=system_prompt
+                )
+            except Exception as exc:  # pylint: disable=broad-exception-caught
+                last_reason = f"LLM error on attempt {attempt}: {exc}"
+                logger.warning(last_reason)
+                prompt = self._build_directory_prompt(
+                    base_path, existing_entries, user_request, last_reason
+                )
+                continue
+
+            raw_response = self._extract_response_text(response)
+            candidate = self._sanitize_directory_name(raw_response)
+            if not candidate:
+                last_reason = "LLM returned an empty or invalid directory name."
+            elif candidate.lower() in existing_lower:
+                last_reason = f"Name '{candidate}' already exists in {base_path}."
+            elif "/" in candidate or "\\" in candidate or ".." in candidate:
+                last_reason = "Directory name contained path separators or traversal."
+            elif len(candidate) > 64:
+                last_reason = "Directory name exceeded 64 characters."
             else:
-                entry_data = {}
+                candidate_path = base_path / candidate
+                if candidate_path.exists():
+                    last_reason = f"Directory '{candidate}' already exists."
+                else:
+                    return candidate
+
+            logger.warning(
+                "Directory name attempt %d rejected: %s", attempt, last_reason
+            )
+            prompt = self._build_directory_prompt(
+                base_path, existing_entries, user_request, last_reason
+            )
+
+        return None
+
+    @staticmethod
+    def _sanitize_directory_name(raw: str) -> str:
+        """Normalize LLM output to a filesystem-safe directory name."""
+        if not raw:
+            return ""
+        candidate = raw.strip().strip("`'\"")
+        candidate = candidate.splitlines()[0].strip()
+        candidate = re.sub(r"[^A-Za-z0-9_-]+", "-", candidate)
+        return candidate.strip("-_").lower()
+
+    def _send_prompt_without_history(
+        self, prompt: str, timeout: int = 120, system_prompt: Optional[str] = None
+    ) -> Any:
+        """
+        Send a prompt without reading from or writing to chat history.
+
+        Prefers the underlying LLM client's `generate` API when available,
+        falling back to `send(..., no_history=True)` for compatibility.
+        """
+        # If the ChatSDK exposes the underlying LLM client, use it directly with chat messages
+        # to avoid any stored history and ensure system prompts are applied cleanly.
+        llm_client = getattr(self.llm_client, "llm_client", None)
+        if llm_client and hasattr(llm_client, "generate"):
+            model = getattr(getattr(self.llm_client, "config", None), "model", None)
+            messages = []
+            if system_prompt:
+                messages.append({"role": "system", "content": system_prompt})
+            messages.append({"role": "user", "content": prompt})
+            return llm_client.generate(
+                prompt=prompt,
+                messages=messages,
+                model=model,
+                timeout=timeout,
+                endpoint="chat",
+            )
 
-            template = getattr(entry, "template", None) or entry_data.get("template")
-            description = getattr(entry, "description", None) or entry_data.get(
-                "description", ""
+        # Fallback: use send with no_history to avoid persisting messages.
+        if hasattr(self.llm_client, "send"):
+            return self.llm_client.send(
+                prompt, timeout=timeout, no_history=True, system_prompt=system_prompt
             )
-            success = getattr(entry, "success", None)
-            if success is None:
-                success = entry_data.get("success", True)
-            status = "PASS" if success else "FAIL"
-            error = getattr(entry, "error", None) or entry_data.get("error")
-            output = getattr(entry, "output", None) or entry_data.get("output", {})
-
-            lines.append(f"- [{status}] {template}: {description}")
-            if error:
-                lines.append(f"  Error: {error}")
-
-            snippet = ""
-            if isinstance(output, dict):
-                for key in ("stdout", "stderr", "message", "log", "details"):
-                    if output.get(key):
-                        snippet = str(output[key])
-                        break
-                if not snippet and output:
-                    snippet = json.dumps(output)[:400]
-            elif output:
-                snippet = str(output)[:400]
-
-            snippet = snippet.strip()
-            if snippet:
-                lines.append(f"  Output: {snippet[:400]}")
-
-        return "\n".join(lines)
+
+        raise ValueError("LLM client does not support generate or send APIs")
+
+    @staticmethod
+    def _build_directory_prompt(
+        base_path: Path,
+        existing_entries: List[str],
+        user_request: Optional[str],
+        rejection_reason: Optional[str],
+    ) -> str:
+        """Construct the LLM prompt for picking a safe project subdirectory."""
+        entries = sorted(existing_entries)
+        max_list = 50
+        if len(entries) > max_list:
+            entries_display = "\n".join(f"- {name}" for name in entries[:max_list])
+            entries_display += f"\n- ...and {len(entries) - max_list} more"
+        else:
+            entries_display = "\n".join(f"- {name}" for name in entries)
+
+        prompt_sections = [
+            "You must choose a new folder name for a project because the target path is not empty.",
+            f"Base path: {base_path}",
+            "Existing files and folders you MUST avoid (do not reuse any of these names):",
+            entries_display or "- <empty>",
+            "User request driving this project:",
+            user_request or "<no request provided>",
+            "Rules:",
+            "- Return a single folder name only. Do NOT echo the instructions. No paths, quotes, JSON, or extra text.",
+            "- Use lowercase kebab-case or snake_case; ASCII letters, numbers, hyphens, and underscores only.",
+            "- Do not use any existing names above. Avoid dots, spaces, or slashes.",
+            "- Keep it under 40 characters.",
+        ]
+
+        if rejection_reason:
+            prompt_sections.append(
+                f"Previous suggestion was rejected: {rejection_reason}. Try a different unique name."
+            )
+
+        return "\n".join(prompt_sections)
+
+    def _format_validation_history(
+        self, validation_history: List[Any], latest_plan_logs: Optional[List[Any]]
+    ) -> str:
+        """Format validation logs, splitting latest plan from historical ones."""
+
+        if not validation_history:
+            return "No validation or test commands have been executed yet."
+
+        latest_logs = latest_plan_logs or []
+        latest_count = len(latest_logs)
+        historical_logs = (
+            validation_history[:-latest_count] if latest_count else validation_history
+        )
+
+        def normalize(entry: Any) -> Dict[str, Any]:
+            if hasattr(entry, "to_dict"):
+                return entry.to_dict()
+            if isinstance(entry, dict):
+                return entry
+            return {}
+
+        def render(entries: List[Any], limit: Optional[int] = None) -> List[str]:
+            if not entries:
+                return ["None"]
+
+            selected = entries if limit is None else entries[-limit:]
+            lines: List[str] = []
+            for entry in selected:
+                data = normalize(entry)
+                template = data.get("template", "unknown")
+                description = data.get("description", "")
+                success = data.get("success", True)
+                status = "PASS" if success else "FAIL"
+                error = data.get("error")
+                output = data.get("output", {})
+
+                lines.append(f"- [{status}] {template}: {description}")
+                if error:
+                    lines.append(f"  Error: {error}")
+
+                snippet = ""
+                if isinstance(output, dict):
+                    for key in ("stdout", "stderr", "message", "log", "details"):
+                        if output.get(key):
+                            snippet = str(output[key])
+                            break
+                    if not snippet and output:
+                        snippet = json.dumps(output)[:400]
+                elif output:
+                    snippet = str(output)[:400]
+
+                snippet = snippet.strip()
+                if snippet:
+                    lines.append(f"  Output: {snippet[:400]}")
+            return lines
+
+        sections: List[str] = []
+        sections.append("### Latest Plan Results")
+        sections.extend(render(list(latest_logs)))
+        sections.append("")
+        sections.append("### Previous Plan History")
+        sections.extend(render(list(historical_logs), limit=5))
+
+        return "\n".join(sections).strip()
 
     def _parse_checkpoint_response(self, response: Any) -> Dict[str, Any]:
         """Parse JSON output from the checkpoint reviewer."""

gaia/agents/code/orchestration/project_analyzer.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """Project Analyzer for Understanding Current Project State.
 

gaia/agents/code/orchestration/steps/__init__.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """Step implementations for orchestration workflows."""
 

gaia/agents/code/orchestration/steps/base.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Base step classes for orchestration workflows.

gaia/agents/code/orchestration/steps/error_handler.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Three-tier error recovery for orchestration workflows.
@@ -72,7 +72,7 @@ ERROR_PATTERNS: List[ErrorPattern] = [
         pattern=r"ModuleNotFoundError:\s+No module named '([^']+)'",
         category=ErrorCategory.DEPENDENCY,
         action=RecoveryAction.FIX_AND_RETRY,
-        fix_command="pip install {module}",
+        fix_command="uv pip install {module}",
         max_retries=2,
     ),
     # TypeScript compilation - escalate to LLM

gaia/agents/code/orchestration/steps/nextjs.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Next.js step implementations.

gaia/agents/code/orchestration/steps/python.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Python step implementations.

gaia/agents/code/orchestration/template_catalog.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """Template Catalog for LLM-Driven Checklist Generation.
 
@@ -257,9 +257,14 @@ TEMPLATE_CATALOG: Dict[str, TemplateDefinition] = {
             ),
             "variant": ParameterSpec(
                 type=ParameterType.STRING,
-                description="Component variant: list|form|new|detail|actions",
+                description="Component variant: list|form|new|detail|actions|artifact-timer",
                 example="list",
             ),
+            "component_name": ParameterSpec(
+                type=ParameterType.STRING,
+                description="Optional explicit component name (e.g., CountdownTimer)",
+                required=False,
+            ),
             "with_checkboxes": ParameterSpec(
                 type=ParameterType.BOOLEAN,
                 description="Add checkbox UI for boolean fields (e.g., todo completion)",
@@ -275,6 +280,7 @@ TEMPLATE_CATALOG: Dict[str, TemplateDefinition] = {
             "Use 'form' for reusable create/edit form component",
             "Use 'new' for /resource/new page",
             "Use 'detail' for /resource/[id] EDIT page with pre-populated form",
+            "Use 'artifact-timer' when the user requests a countdown; supply component_name (e.g., CountdownTimer) so pages can import the client-side timer widget",
             "Add with_checkboxes=true for todo apps",
         ],
     ),

gaia/agents/code/orchestration/workflows/__init__.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """Workflow definitions for orchestration."""
 

gaia/agents/code/orchestration/workflows/base.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 """
 Base workflow definitions for orchestration.