f9f6bc01fd
CI / test (push) Canceled after 0s
## Summary epic r04 - begin refactor ## Change Type - [x] Cowork feature - [ ] Bug fix - [ ] Core AI contribution - [ ] Test / hardening - [ ] Performance - [ ] Documentation ## Related Work Cowork Task: Core Repo: http://34.143.229.138/gitea-admin/fsg-ai-core-assets Core AI Issue: Core Task: Related PR: ## Scope What is intentionally included? What is intentionally NOT included? ## Validation - [ ] Unit tests - [ ] Integration tests - [ ] Manual verification - [ ] Regression check Commands / evidence: ## Security Impact Permission / credential / network / customer data impact: ## Compatibility - [ ] No breaking change - [ ] Breaking change documented ## Reviewer Notes Anything Cowork reviewers should pay attention to. --------- Co-authored-by: Anh Tran Nguyen Minh <anhtnm1@fpt.com> Co-authored-by: Huong Le Thi Thien <huongltt35@fpt.com> Co-authored-by: Nam Pham Dinh Thanh <nampdt@fpt.com> Co-authored-by: Vu Dam Tuan <vudt15@fpt.com> Co-authored-by: Hiep Ha Van <hiephv3@fpt.com> Co-authored-by: Lam Hoang Van <lamhv7@fpt.com> Reviewed-on: #7 Co-authored-by: Duy Le Huu <duylh19@fpt.com>
71 lines
2.3 KiB
Python
71 lines
2.3 KiB
Python
"""Member A work package: get_project_issue_context."""
|
|
|
|
# ruff: noqa: UP045 -- Optional keeps Pydantic model evaluation compatible with Python 3.9.
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any, Literal, Optional
|
|
|
|
from pydantic import Field
|
|
|
|
from ..foundation import ContractModel, SourceCitation, ToolTemplate
|
|
|
|
|
|
class IssueContextInput(ContractModel):
|
|
"""Tham số vào của ``get_project_issue_context``: project và mã issue.
|
|
|
|
``detail`` chọn độ dài kết quả, ``cursor`` để lấy trang tiếp khi bị cắt bớt.
|
|
"""
|
|
project_id: str = Field(min_length=1, max_length=128)
|
|
issue_key: str = Field(min_length=1, max_length=128)
|
|
detail: Literal["summary", "standard", "full"] = "standard"
|
|
cursor: Optional[str] = Field(default=None, max_length=2048)
|
|
|
|
|
|
class RelatedItem(ContractModel):
|
|
"""Một mục liên quan tới issue (issue khác, PR, tài liệu) kèm loại quan hệ."""
|
|
item_id: str
|
|
relation: str
|
|
title: str
|
|
url: str
|
|
|
|
|
|
class IssueContextOutput(ContractModel):
|
|
"""Kết quả trả về: tiêu đề, trạng thái, mô tả, tiêu chí nghiệm thu và các mục liên quan.
|
|
|
|
``source`` là trích dẫn nguồn bắt buộc; ``truncated``/``next_cursor`` cho
|
|
Agent biết còn dữ liệu chưa lấy hết.
|
|
"""
|
|
correlation_id: str
|
|
project_id: str
|
|
issue_key: str
|
|
title: str
|
|
status: str
|
|
description: str
|
|
acceptance_criteria: tuple[str, ...]
|
|
related: tuple[RelatedItem, ...]
|
|
source: SourceCitation
|
|
truncated: bool
|
|
returned: int = Field(ge=0)
|
|
remaining: int = Field(ge=0)
|
|
next_cursor: Optional[str] = None
|
|
|
|
|
|
def _handle(arguments: ContractModel, provider: Any) -> dict[str, Any]:
|
|
"""Kiểm tham số theo schema rồi chuyển sang provider đã được cấp cho lượt gọi này."""
|
|
request = IssueContextInput.model_validate(arguments)
|
|
return provider.get_issue_context(**request.model_dump())
|
|
|
|
|
|
TOOL = ToolTemplate(
|
|
name="get_project_issue_context",
|
|
description=(
|
|
"Returns one authorized work item's title, state, description, acceptance criteria, "
|
|
"related items, and pinned source. Use when an exact issue key is known. Do not use for "
|
|
"free-text knowledge search or Git change review."
|
|
),
|
|
input_model=IssueContextInput,
|
|
output_model=IssueContextOutput,
|
|
handler=_handle,
|
|
)
|