xai-review 0.26.0__py3-none-any.whl → 0.28.0__py3-none-any.whl

ai_review/clients/gitlab/mr/client.py

@@ -2,20 +2,27 @@ from httpx import Response, QueryParams
 
 from ai_review.clients.gitlab.mr.schema.changes import GitLabGetMRChangesResponseSchema
 from ai_review.clients.gitlab.mr.schema.discussions import (
+    GitLabDiscussionSchema,
     GitLabGetMRDiscussionsQuerySchema,
     GitLabGetMRDiscussionsResponseSchema,
     GitLabCreateMRDiscussionRequestSchema,
-    GitLabCreateMRDiscussionResponseSchema
+    GitLabCreateMRDiscussionResponseSchema,
+    GitLabCreateMRDiscussionReplyRequestSchema,
+    GitLabCreateMRDiscussionReplyResponseSchema
 )
 from ai_review.clients.gitlab.mr.schema.notes import (
+    GitLabNoteSchema,
     GitLabGetMRNotesQuerySchema,
     GitLabGetMRNotesResponseSchema,
     GitLabCreateMRNoteRequestSchema,
     GitLabCreateMRNoteResponseSchema,
 )
 from ai_review.clients.gitlab.mr.types import GitLabMergeRequestsHTTPClientProtocol
+from ai_review.clients.gitlab.tools import gitlab_has_next_page
+from ai_review.config import settings
 from ai_review.libs.http.client import HTTPClient
 from ai_review.libs.http.handlers import handle_http_error, HTTPClientError
+from ai_review.libs.http.paginate import paginate
 
 
 class GitLabMergeRequestsHTTPClientError(HTTPClientError):
@@ -77,6 +84,19 @@ class GitLabMergeRequestsHTTPClient(HTTPClient, GitLabMergeRequestsHTTPClientPro
             json=request.model_dump(),
         )
 
+    @handle_http_error(client="GitLabMergeRequestsHTTPClient", exception=GitLabMergeRequestsHTTPClientError)
+    async def create_discussion_reply_api(
+            self,
+            project_id: str,
+            merge_request_id: str,
+            discussion_id: str,
+            request: GitLabCreateMRDiscussionReplyRequestSchema,
+    ) -> Response:
+        return await self.post(
+            f"/api/v4/projects/{project_id}/merge_requests/{merge_request_id}/discussions/{discussion_id}/notes",
+            json=request.model_dump(),
+        )
+
     async def get_changes(self, project_id: str, merge_request_id: str) -> GitLabGetMRChangesResponseSchema:
         response = await self.get_changes_api(project_id, merge_request_id)
         return GitLabGetMRChangesResponseSchema.model_validate_json(response.text)
@@ -86,18 +106,42 @@ class GitLabMergeRequestsHTTPClient(HTTPClient, GitLabMergeRequestsHTTPClientPro
             project_id: str,
             merge_request_id: str
     ) -> GitLabGetMRNotesResponseSchema:
-        query = GitLabGetMRNotesQuerySchema(per_page=100)
-        response = await self.get_notes_api(project_id, merge_request_id, query)
-        return GitLabGetMRNotesResponseSchema.model_validate_json(response.text)
+        async def fetch_page(page: int) -> Response:
+            query = GitLabGetMRNotesQuerySchema(page=page, per_page=settings.vcs.pagination.per_page)
+            return await self.get_notes_api(project_id, merge_request_id, query)
+
+        def extract_items(response: Response) -> list[GitLabNoteSchema]:
+            result = GitLabGetMRNotesResponseSchema.model_validate_json(response.text)
+            return result.root
+
+        items = await paginate(
+            max_pages=settings.vcs.pagination.max_pages,
+            fetch_page=fetch_page,
+            extract_items=extract_items,
+            has_next_page=gitlab_has_next_page
+        )
+        return GitLabGetMRNotesResponseSchema(root=items)
 
     async def get_discussions(
             self,
             project_id: str,
             merge_request_id: str
     ) -> GitLabGetMRDiscussionsResponseSchema:
-        query = GitLabGetMRDiscussionsQuerySchema(per_page=100)
-        response = await self.get_discussions_api(project_id, merge_request_id, query)
-        return GitLabGetMRDiscussionsResponseSchema.model_validate_json(response.text)
+        async def fetch_page(page: int) -> Response:
+            query = GitLabGetMRDiscussionsQuerySchema(page=page, per_page=settings.vcs.pagination.per_page)
+            return await self.get_discussions_api(project_id, merge_request_id, query)
+
+        def extract_items(response: Response) -> list[GitLabDiscussionSchema]:
+            result = GitLabGetMRDiscussionsResponseSchema.model_validate_json(response.text)
+            return result.root
+
+        items = await paginate(
+            max_pages=settings.vcs.pagination.max_pages,
+            fetch_page=fetch_page,
+            extract_items=extract_items,
+            has_next_page=gitlab_has_next_page
+        )
+        return GitLabGetMRDiscussionsResponseSchema(root=items)
 
     async def create_note(
             self,
@@ -125,3 +169,19 @@ class GitLabMergeRequestsHTTPClient(HTTPClient, GitLabMergeRequestsHTTPClientPro
             merge_request_id=merge_request_id
         )
         return GitLabCreateMRDiscussionResponseSchema.model_validate_json(response.text)
+
+    async def create_discussion_reply(
+            self,
+            project_id: str,
+            merge_request_id: str,
+            discussion_id: str,
+            body: str,
+    ) -> GitLabCreateMRDiscussionReplyResponseSchema:
+        request = GitLabCreateMRDiscussionReplyRequestSchema(body=body)
+        response = await self.create_discussion_reply_api(
+            project_id=project_id,
+            merge_request_id=merge_request_id,
+            discussion_id=discussion_id,
+            request=request,
+        )
+        return GitLabCreateMRDiscussionReplyResponseSchema.model_validate_json(response.text)

ai_review/clients/gitlab/mr/schema/changes.py

@@ -1,10 +1,6 @@
 from pydantic import BaseModel, Field
 
-
-class GitLabUserSchema(BaseModel):
-    id: int
-    name: str
-    username: str
+from ai_review.clients.gitlab.mr.schema.user import GitLabUserSchema
 
 
 class GitLabDiffRefsSchema(BaseModel):

ai_review/clients/gitlab/mr/schema/discussions.py

@@ -1,13 +1,8 @@
-from pydantic import BaseModel, RootModel
+from pydantic import BaseModel, RootModel, Field
 
 from ai_review.clients.gitlab.mr.schema.notes import GitLabNoteSchema
 
 
-class GitLabDiscussionSchema(BaseModel):
-    id: str
-    notes: list[GitLabNoteSchema]
-
-
 class GitLabDiscussionPositionSchema(BaseModel):
     position_type: str = "text"
     base_sha: str
@@ -17,8 +12,15 @@ class GitLabDiscussionPositionSchema(BaseModel):
     new_line: int
 
 
+class GitLabDiscussionSchema(BaseModel):
+    id: str
+    notes: list[GitLabNoteSchema]
+    position: GitLabDiscussionPositionSchema | None = None
+
+
 class GitLabGetMRDiscussionsQuerySchema(BaseModel):
-    per_page: int
+    page: int = 1
+    per_page: int = 100
 
 
 class GitLabGetMRDiscussionsResponseSchema(RootModel[list[GitLabDiscussionSchema]]):
@@ -32,4 +34,13 @@ class GitLabCreateMRDiscussionRequestSchema(BaseModel):
 
 class GitLabCreateMRDiscussionResponseSchema(BaseModel):
     id: str
-    body: str | None = None
+    notes: list[GitLabNoteSchema] = Field(default_factory=list)
+
+
+class GitLabCreateMRDiscussionReplyRequestSchema(BaseModel):
+    body: str
+
+
+class GitLabCreateMRDiscussionReplyResponseSchema(BaseModel):
+    id: int
+    body: str

ai_review/clients/gitlab/mr/schema/notes.py

@@ -1,13 +1,17 @@
 from pydantic import BaseModel, RootModel
 
+from ai_review.clients.gitlab.mr.schema.user import GitLabUserSchema
+
 
 class GitLabNoteSchema(BaseModel):
     id: int
     body: str
+    author: GitLabUserSchema | None = None
 
 
 class GitLabGetMRNotesQuerySchema(BaseModel):
-    per_page: int
+    page: int = 1
+    per_page: int = 100
 
 
 class GitLabGetMRNotesResponseSchema(RootModel[list[GitLabNoteSchema]]):

ai_review/clients/gitlab/mr/schema/user.py

@@ -0,0 +1,7 @@
+from pydantic import BaseModel
+
+
+class GitLabUserSchema(BaseModel):
+    id: int
+    name: str
+    username: str

ai_review/clients/gitlab/mr/types.py

@@ -3,8 +3,9 @@ from typing import Protocol
 from ai_review.clients.gitlab.mr.schema.changes import GitLabGetMRChangesResponseSchema
 from ai_review.clients.gitlab.mr.schema.discussions import (
     GitLabGetMRDiscussionsResponseSchema,
-    GitLabCreateMRDiscussionResponseSchema,
     GitLabCreateMRDiscussionRequestSchema,
+    GitLabCreateMRDiscussionResponseSchema,
+    GitLabCreateMRDiscussionReplyResponseSchema
 )
 from ai_review.clients.gitlab.mr.schema.notes import GitLabGetMRNotesResponseSchema, GitLabCreateMRNoteResponseSchema
 
@@ -14,12 +15,6 @@ class GitLabMergeRequestsHTTPClientProtocol(Protocol):
 
     async def get_notes(self, project_id: str, merge_request_id: str) -> GitLabGetMRNotesResponseSchema: ...
 
-    async def get_discussions(
-            self,
-            project_id: str,
-            merge_request_id: str
-    ) -> GitLabGetMRDiscussionsResponseSchema: ...
-
     async def create_note(
             self,
             body: str,
@@ -27,9 +22,23 @@ class GitLabMergeRequestsHTTPClientProtocol(Protocol):
             merge_request_id: str,
     ) -> GitLabCreateMRNoteResponseSchema: ...
 
+    async def get_discussions(
+            self,
+            project_id: str,
+            merge_request_id: str
+    ) -> GitLabGetMRDiscussionsResponseSchema: ...
+
     async def create_discussion(
             self,
             project_id: str,
             merge_request_id: str,
             request: GitLabCreateMRDiscussionRequestSchema,
     ) -> GitLabCreateMRDiscussionResponseSchema: ...
+
+    async def create_discussion_reply(
+            self,
+            project_id: str,
+            merge_request_id: str,
+            discussion_id: str,
+            body: str,
+    ) -> GitLabCreateMRDiscussionReplyResponseSchema: ...

ai_review/clients/gitlab/tools.py

@@ -0,0 +1,5 @@
+from httpx import Response
+
+
+def gitlab_has_next_page(response: Response) -> bool:
+    return bool(response.headers.get("X-Next-Page"))

ai_review/libs/config/prompt.py

@@ -6,104 +6,123 @@ from pydantic import BaseModel, FilePath, Field
 from ai_review.libs.resources import load_resource
 
 
+def resolve_prompt_files(files: list[FilePath] | None, default_file: str) -> list[Path]:
+    return files or [
+        load_resource(
+            package="ai_review.prompts",
+            filename=default_file,
+            fallback=f"ai_review/prompts/{default_file}"
+        )
+    ]
+
+
+def resolve_system_prompt_files(files: list[FilePath] | None, include: bool, default_file: str) -> list[Path]:
+    global_files = [
+        load_resource(
+            package="ai_review.prompts",
+            filename=default_file,
+            fallback=f"ai_review/prompts/{default_file}"
+        )
+    ]
+
+    if files is None:
+        return global_files
+
+    if include:
+        return global_files + files
+
+    return files
+
+
 class PromptConfig(BaseModel):
     context: dict[str, str] = Field(default_factory=dict)
     normalize_prompts: bool = True
     context_placeholder: str = "<<{value}>>"
+
+    # --- Prompts ---
     inline_prompt_files: list[FilePath] | None = None
     context_prompt_files: list[FilePath] | None = None
     summary_prompt_files: list[FilePath] | None = None
+    inline_reply_prompt_files: list[FilePath] | None = None
+    summary_reply_prompt_files: list[FilePath] | None = None
+
+    # --- System Prompts ---
     system_inline_prompt_files: list[FilePath] | None = None
     system_context_prompt_files: list[FilePath] | None = None
     system_summary_prompt_files: list[FilePath] | None = None
+    system_inline_reply_prompt_files: list[FilePath] | None = None
+    system_summary_reply_prompt_files: list[FilePath] | None = None
+
+    # --- Include System Prompts ---
     include_inline_system_prompts: bool = True
     include_context_system_prompts: bool = True
     include_summary_system_prompts: bool = True
+    include_inline_reply_system_prompts: bool = True
+    include_summary_reply_system_prompts: bool = True
 
+    # --- Prompts ---
     @cached_property
     def inline_prompt_files_or_default(self) -> list[Path]:
-        return self.inline_prompt_files or [
-            load_resource(
-                package="ai_review.prompts",
-                filename="default_inline.md",
-                fallback="ai_review/prompts/default_inline.md"
-            )
-        ]
+        return resolve_prompt_files(self.inline_prompt_files, "default_inline.md")
 
     @cached_property
     def context_prompt_files_or_default(self) -> list[Path]:
-        return self.context_prompt_files or [
-            load_resource(
-                package="ai_review.prompts",
-                filename="default_context.md",
-                fallback="ai_review/prompts/default_context.md"
-            )
-        ]
+        return resolve_prompt_files(self.context_prompt_files, "default_context.md")
 
     @cached_property
     def summary_prompt_files_or_default(self) -> list[Path]:
-        return self.summary_prompt_files or [
-            load_resource(
-                package="ai_review.prompts",
-                filename="default_summary.md",
-                fallback="ai_review/prompts/default_summary.md"
-            )
-        ]
+        return resolve_prompt_files(self.summary_prompt_files, "default_summary.md")
 
     @cached_property
-    def system_inline_prompt_files_or_default(self) -> list[Path]:
-        global_files = [
-            load_resource(
-                package="ai_review.prompts",
-                filename="default_system_inline.md",
-                fallback="ai_review/prompts/default_system_inline.md"
-            )
-        ]
-
-        if self.system_inline_prompt_files is None:
-            return global_files
+    def inline_reply_prompt_files_or_default(self) -> list[Path]:
+        return resolve_prompt_files(self.inline_reply_prompt_files, "default_inline_reply.md")
 
-        if self.include_inline_system_prompts:
-            return global_files + self.system_inline_prompt_files
+    @cached_property
+    def summary_reply_prompt_files_or_default(self) -> list[Path]:
+        return resolve_prompt_files(self.summary_reply_prompt_files, "default_summary_reply.md")
 
-        return self.system_inline_prompt_files
+    # --- System Prompts ---
+    @cached_property
+    def system_inline_prompt_files_or_default(self) -> list[Path]:
+        return resolve_system_prompt_files(
+            files=self.system_inline_prompt_files,
+            include=self.include_inline_system_prompts,
+            default_file="default_system_inline.md"
+        )
 
     @cached_property
     def system_context_prompt_files_or_default(self) -> list[Path]:
-        global_files = [
-            load_resource(
-                package="ai_review.prompts",
-                filename="default_system_context.md",
-                fallback="ai_review/prompts/default_system_context.md"
-            )
-        ]
-
-        if self.system_context_prompt_files is None:
-            return global_files
-
-        if self.include_context_system_prompts:
-            return global_files + self.system_context_prompt_files
-
-        return self.system_context_prompt_files
+        return resolve_system_prompt_files(
+            files=self.system_context_prompt_files,
+            include=self.include_context_system_prompts,
+            default_file="default_system_context.md"
+        )
 
     @cached_property
     def system_summary_prompt_files_or_default(self) -> list[Path]:
-        global_files = [
-            load_resource(
-                package="ai_review.prompts",
-                filename="default_system_summary.md",
-                fallback="ai_review/prompts/default_system_summary.md"
-            )
-        ]
-
-        if self.system_summary_prompt_files is None:
-            return global_files
-
-        if self.include_summary_system_prompts:
-            return global_files + self.system_summary_prompt_files
+        return resolve_system_prompt_files(
+            files=self.system_summary_prompt_files,
+            include=self.include_summary_system_prompts,
+            default_file="default_system_summary.md"
+        )
 
-        return self.system_summary_prompt_files
+    @cached_property
+    def system_inline_reply_prompt_files_or_default(self) -> list[Path]:
+        return resolve_system_prompt_files(
+            files=self.system_inline_reply_prompt_files,
+            include=self.include_inline_reply_system_prompts,
+            default_file="default_system_inline_reply.md"
+        )
 
+    @cached_property
+    def system_summary_reply_prompt_files_or_default(self) -> list[Path]:
+        return resolve_system_prompt_files(
+            files=self.system_summary_reply_prompt_files,
+            include=self.include_summary_reply_system_prompts,
+            default_file="default_system_summary_reply.md"
+        )
+
+    # --- Load Prompts ---
     def load_inline(self) -> list[str]:
         return [file.read_text(encoding="utf-8") for file in self.inline_prompt_files_or_default]
 
@@ -113,6 +132,13 @@ class PromptConfig(BaseModel):
     def load_summary(self) -> list[str]:
         return [file.read_text(encoding="utf-8") for file in self.summary_prompt_files_or_default]
 
+    def load_inline_reply(self) -> list[str]:
+        return [file.read_text(encoding="utf-8") for file in self.inline_reply_prompt_files_or_default]
+
+    def load_summary_reply(self) -> list[str]:
+        return [file.read_text(encoding="utf-8") for file in self.summary_reply_prompt_files_or_default]
+
+    # --- Load System Prompts ---
     def load_system_inline(self) -> list[str]:
         return [file.read_text(encoding="utf-8") for file in self.system_inline_prompt_files_or_default]
 
@@ -121,3 +147,9 @@ class PromptConfig(BaseModel):
 
     def load_system_summary(self) -> list[str]:
         return [file.read_text(encoding="utf-8") for file in self.system_summary_prompt_files_or_default]
+
+    def load_system_inline_reply(self) -> list[str]:
+        return [file.read_text(encoding="utf-8") for file in self.system_inline_reply_prompt_files_or_default]
+
+    def load_system_summary_reply(self) -> list[str]:
+        return [file.read_text(encoding="utf-8") for file in self.system_summary_reply_prompt_files_or_default]

ai_review/libs/config/review.py

@@ -20,7 +20,9 @@ class ReviewMode(StrEnum):
 class ReviewConfig(BaseModel):
     mode: ReviewMode = ReviewMode.FULL_FILE_DIFF
     inline_tag: str = Field(default="#ai-review-inline")
+    inline_reply_tag: str = Field(default="#ai-review-inline-reply")
     summary_tag: str = Field(default="#ai-review-summary")
+    summary_reply_tag: str = Field(default="#ai-review-summary-reply")
     context_lines: int = Field(default=10, ge=0)
     allow_changes: list[str] = Field(default_factory=list)
     ignore_changes: list[str] = Field(default_factory=list)

ai_review/libs/config/vcs/base.py

@@ -5,11 +5,13 @@ from pydantic import BaseModel, Field
 from ai_review.libs.config.vcs.bitbucket import BitbucketPipelineConfig, BitbucketHTTPClientConfig
 from ai_review.libs.config.vcs.github import GitHubPipelineConfig, GitHubHTTPClientConfig
 from ai_review.libs.config.vcs.gitlab import GitLabPipelineConfig, GitLabHTTPClientConfig
+from ai_review.libs.config.vcs.pagination import VCSPaginationConfig
 from ai_review.libs.constants.vcs_provider import VCSProvider
 
 
 class VCSConfigBase(BaseModel):
     provider: VCSProvider
+    pagination: VCSPaginationConfig = VCSPaginationConfig()
 
 
 class GitLabVCSConfig(VCSConfigBase):

ai_review/libs/config/vcs/pagination.py

@@ -0,0 +1,6 @@
+from pydantic import BaseModel, Field
+
+
+class VCSPaginationConfig(BaseModel):
+    per_page: int = Field(default=100, ge=1, le=100)
+    max_pages: int = Field(default=5, ge=1)

ai_review/libs/http/paginate.py

@@ -0,0 +1,43 @@
+from typing import Awaitable, Callable, TypeVar
+
+from httpx import Response
+from pydantic import BaseModel
+
+from ai_review.libs.logger import get_logger
+
+T = TypeVar("T", bound=BaseModel)
+
+logger = get_logger("PAGINATE")
+
+
+async def paginate(
+        fetch_page: Callable[[int], Awaitable[Response]],
+        extract_items: Callable[[Response], list[T]],
+        has_next_page: Callable[[Response], bool],
+        max_pages: int | None = None,
+) -> list[T]:
+    page = 1
+    items: list[T] = []
+
+    while True:
+        response = await fetch_page(page)
+
+        try:
+            extracted = extract_items(response)
+        except Exception as error:
+            logger.error(f"Failed to extract items on {page=}")
+            raise RuntimeError(f"Failed to extract items on {page=}") from error
+
+        logger.debug(f"Page {page}: extracted {len(extracted)} items (total={len(items) + len(extracted)})")
+        items.extend(extracted)
+
+        if not has_next_page(response):
+            logger.debug(f"Pagination finished after {page} page(s), total items={len(items)}")
+            break
+
+        page += 1
+        if max_pages and (page > max_pages):
+            logger.error(f"Pagination exceeded {max_pages=}")
+            raise RuntimeError(f"Pagination exceeded {max_pages=}")
+
+    return items

ai_review/libs/llm/output_json_parser.py

@@ -0,0 +1,60 @@
+import re
+from typing import TypeVar, Generic, Type
+
+from pydantic import BaseModel, ValidationError
+
+from ai_review.libs.json import sanitize_json_string
+from ai_review.libs.logger import get_logger
+
+logger = get_logger("LLM_JSON_PARSER")
+
+T = TypeVar("T", bound=BaseModel)
+
+CLEAN_JSON_BLOCK_RE = re.compile(r"```(?:json)?(.*?)```", re.DOTALL | re.IGNORECASE)
+
+
+class LLMOutputJSONParser(Generic[T]):
+    """Reusable JSON parser for LLM responses."""
+
+    def __init__(self, model: Type[T]):
+        self.model = model
+        self.model_name = self.model.__name__
+
+    def try_parse(self, raw: str) -> T | None:
+        logger.debug(f"[{self.model_name}] Attempting JSON parse (len={len(raw)})")
+
+        try:
+            return self.model.model_validate_json(raw)
+        except ValidationError as error:
+            logger.warning(f"[{self.model_name}] Raw JSON parse failed: {error}")
+            cleaned = sanitize_json_string(raw)
+
+            if cleaned != raw:
+                logger.debug(f"[{self.model_name}] Sanitized JSON differs, retrying parse...")
+                try:
+                    return self.model.model_validate_json(cleaned)
+                except ValidationError as error:
+                    logger.warning(f"[{self.model_name}] Sanitized JSON still invalid: {error}")
+                    return None
+            else:
+                logger.debug(f"[{self.model_name}] Sanitized JSON identical — skipping retry")
+                return None
+
+    def parse_output(self, output: str) -> T | None:
+        output = (output or "").strip()
+        if not output:
+            logger.warning(f"[{self.model_name}] Empty LLM output")
+            return None
+
+        logger.debug(f"[{self.model_name}] Parsing output (len={len(output)})")
+
+        if match := CLEAN_JSON_BLOCK_RE.search(output):
+            logger.debug(f"[{self.model_name}] Found fenced JSON block, extracting...")
+            output = match.group(1).strip()
+
+        if parsed := self.try_parse(output):
+            logger.info(f"[{self.model_name}] Successfully parsed")
+            return parsed
+
+        logger.error(f"[{self.model_name}] No valid JSON found in output")
+        return None

ai_review/prompts/default_inline_reply.md

@@ -0,0 +1,10 @@
+You are an AI assistant replying to a specific inline code review comment.
+
+Use the conversation (`## Conversation`) and code diff (`## Diff`) to continue the discussion constructively.
+
+Guidelines:
+
+- Focus only on the latest comment and relevant code context.
+- Keep your tone concise, professional, and technical (1–2 sentences).
+- If a code change is needed, include it in "suggestion" — provide only the replacement code.
+- If no further action or clarification is required, output exactly: No reply.

ai_review/prompts/default_summary_reply.md

@@ -0,0 +1,14 @@
+You are an AI assistant participating in a summary code review discussion.
+
+Use the previous conversation (`## Conversation`) and code changes (`## Changes`) to continue the discussion
+constructively.
+
+Guidelines:
+
+- Act as a **technical reviewer**, not the code author.
+- Keep your tone concise, professional, and focused (1–3 sentences).
+- Address the latest user comment directly, providing clarification, reasoning, or an actionable suggestion.
+- If the comment contains a request or implies an action (e.g. adding tests, refactoring, or improving validation),
+  provide a clear recommendation or short illustrative code snippet.
+- Avoid greetings, acknowledgements, or repeating earlier feedback.
+- If no reply is needed, write exactly: `No reply`.

ai_review/prompts/default_system_inline_reply.md

@@ -0,0 +1,31 @@
+You are an AI assistant participating in a code review discussion.
+
+Return ONLY a valid JSON object representing a single inline reply to the current comment thread.
+
+Format:
+
+```json
+{
+  "message": "<short reply message to the comment thread>",
+  "suggestion": "<replacement code block without markdown, or null if not applicable>"
+}
+```
+
+Guidelines:
+
+- Output must be exactly one JSON object, not an array or text block.
+- "message" — required, non-empty, short (1–2 sentences), professional, and focused on the specific comment.
+- "suggestion" — optional:
+    - If suggesting a fix or refactor, provide only the replacement code (no markdown, no explanations).
+    - Maintain indentation and style consistent with the surrounding diff.
+    - If no code change is appropriate, use null.
+- Do not quote previous comments or restate context.
+- Never include any extra text outside the JSON object.
+- If no meaningful reply is needed, return:
+
+```json
+{
+  "message": "No reply.",
+  "suggestion": null
+}
+```