gaard-api 0.2.16__tar.gz → 0.2.17__tar.gz

{gaard_api-0.2.16/src/gaard_api.egg-info → gaard_api-0.2.17}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: gaard-api
-Version: 0.2.16
+Version: 0.2.17
 Summary: GAARD backend web services providing admin interface
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: gaard-core==0.2.11
-Requires-Dist: gaard-connectors==0.2.11
-Requires-Dist: gaard-llm==0.2.11
-Requires-Dist: gaard-plugin-api<0.3.0,>=0.2.11
+Requires-Dist: gaard-core==0.2.17
+Requires-Dist: gaard-connectors==0.2.17
+Requires-Dist: gaard-llm==0.2.17
+Requires-Dist: gaard-plugin-api<0.3.0,>=0.2.17
 Requires-Dist: fastapi>=0.111.0
 Requires-Dist: uvicorn[standard]>=0.30.0
 Requires-Dist: pydantic>=2.7.0

{gaard_api-0.2.16 → gaard_api-0.2.17}/pyproject.toml

@@ -4,16 +4,16 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gaard-api"
-version = "0.2.16"
+version = "0.2.17"
 description = "GAARD backend web services providing admin interface"
 readme = "README.md"
 requires-python = ">=3.11"
 
 dependencies = [
-    "gaard-core==0.2.11",
-    "gaard-connectors==0.2.11",
-    "gaard-llm==0.2.11",
-    "gaard-plugin-api>=0.2.11,<0.3.0",
+    "gaard-core==0.2.17",
+    "gaard-connectors==0.2.17",
+    "gaard-llm==0.2.17",
+    "gaard-plugin-api>=0.2.17,<0.3.0",
     "fastapi>=0.111.0",
     "uvicorn[standard]>=0.30.0",
     "pydantic>=2.7.0",

{gaard_api-0.2.16 → gaard_api-0.2.17}/src/gaard_api/api/v1/analysis.py

@@ -81,6 +81,27 @@ EVIDENCE_REFERENCE_RE = re.compile(r"^[A-Za-z][A-Za-z0-9_.-]{0,63}:[^\s]{1,190}$
 ACTIVE_WORKING_KNOWLEDGE_STATUSES = {"running", "waiting_for_user"}
 
 
+def normalize_planner_text_list(value: Any) -> list[str]:
+    if value is None:
+        return []
+
+    items = value if isinstance(value, list) else [value]
+    normalized: list[str] = []
+    seen: set[str] = set()
+    for item in items:
+        if item is None or isinstance(item, bool):
+            continue
+        if not isinstance(item, (str, int, float)):
+            continue
+        text = str(item).strip()
+        if not text or text in seen:
+            continue
+        seen.add(text)
+        normalized.append(text)
+
+    return normalized
+
+
 class AnalysisAction(StrEnum):
     ANSWER_FROM_CONTEXT = "answer_from_context"
     ASK_USER = "ask_user"
@@ -101,6 +122,11 @@ class AnalysisBusinessLogicFinding(BaseModel):
     terms: list[str] = Field(default_factory=list)
     confidence: float = Field(default=0.0, ge=0.0, le=1.0)
 
+    @field_validator("evidence_refs", "terms", mode="before")
+    @classmethod
+    def normalize_text_lists(cls, value: Any) -> list[str]:
+        return normalize_planner_text_list(value)
+
 
 class AnalysisFindingEvidenceUpdate(BaseModel):
     finding_id: str = Field(min_length=1, max_length=64)
@@ -109,6 +135,11 @@ class AnalysisFindingEvidenceUpdate(BaseModel):
     summary: str = Field(min_length=1, max_length=4_000)
     evidence_refs: list[str] = Field(default_factory=list, max_length=100)
 
+    @field_validator("evidence_refs", mode="before")
+    @classmethod
+    def normalize_evidence_refs(cls, value: Any) -> list[str]:
+        return normalize_planner_text_list(value)
+
 
 class AnalysisFindingUsage(BaseModel):
     finding_id: str = Field(min_length=1, max_length=64)
@@ -118,6 +149,11 @@ class AnalysisFindingUsage(BaseModel):
     statement: str = Field(min_length=1, max_length=4_000)
     evidence_refs: list[str] = Field(default_factory=list, max_length=100)
 
+    @field_validator("evidence_refs", mode="before")
+    @classmethod
+    def normalize_evidence_refs(cls, value: Any) -> list[str]:
+        return normalize_planner_text_list(value)
+
 
 class AnalysisPlannerDecision(BaseModel):
     action: AnalysisAction
@@ -1004,7 +1040,7 @@ Business logic learning:
 - If the latest database observation reveals durable knowledge such as dictionary values, terminology meaning, table meaning, column meaning, or stable domain rules, include business_logic.create_suggestion=true.
 - Distinct values, enumerations, statuses, categories, and table/column meaning discovered through ask_database should be saved as business logic findings unless they are clearly one-off metrics for the current answer.
 - Do not create business logic for one-off answer values that are only useful for the current final answer.
-- statement must be a short, self-contained semantic claim. critique must state its main limitation or counterargument. Cite supporting query references in evidence_refs. Never include private chain-of-thought.
+- statement must be a short, self-contained semantic claim. critique must state its main limitation or counterargument. Cite supporting query references as JSON strings in evidence_refs; use the form "query:<audit_id>" for query audit references. Never include private chain-of-thought.
 
 Investigation-scoped working knowledge:
 - session_context.working_knowledge contains externally reviewed semantic evidence for this investigation only.

{gaard_api-0.2.16 → gaard_api-0.2.17}/src/gaard_api/main.py

@@ -40,7 +40,7 @@ async def lifespan(app: FastAPI) -> AsyncIterator[None]:
 
 app = FastAPI(
     title="GAARD API",
-    version="0.2.16",
+    version="0.2.17",
     description="Self-hosted AI SQL Gateway for governed natural-language access to relational data.",
     lifespan=lifespan,
 )

{gaard_api-0.2.16 → gaard_api-0.2.17/src/gaard_api.egg-info}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: gaard-api
-Version: 0.2.16
+Version: 0.2.17
 Summary: GAARD backend web services providing admin interface
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: gaard-core==0.2.11
-Requires-Dist: gaard-connectors==0.2.11
-Requires-Dist: gaard-llm==0.2.11
-Requires-Dist: gaard-plugin-api<0.3.0,>=0.2.11
+Requires-Dist: gaard-core==0.2.17
+Requires-Dist: gaard-connectors==0.2.17
+Requires-Dist: gaard-llm==0.2.17
+Requires-Dist: gaard-plugin-api<0.3.0,>=0.2.17
 Requires-Dist: fastapi>=0.111.0
 Requires-Dist: uvicorn[standard]>=0.30.0
 Requires-Dist: pydantic>=2.7.0

{gaard_api-0.2.16 → gaard_api-0.2.17}/src/gaard_api.egg-info/requires.txt

@@ -1,7 +1,7 @@
-gaard-core==0.2.11
-gaard-connectors==0.2.11
-gaard-llm==0.2.11
-gaard-plugin-api<0.3.0,>=0.2.11
+gaard-core==0.2.17
+gaard-connectors==0.2.17
+gaard-llm==0.2.17
+gaard-plugin-api<0.3.0,>=0.2.17
 fastapi>=0.111.0
 uvicorn[standard]>=0.30.0
 pydantic>=2.7.0

{gaard_api-0.2.16 → gaard_api-0.2.17}/tests/test_analysis_api.py

@@ -134,6 +134,42 @@ def create_active_default_datasource() -> DatasourceConnector:
         return connector
 
 
+def test_analysis_planner_normalizes_model_generated_text_lists() -> None:
+    decision = analysis_module.parse_analysis_decision(
+        json.dumps(
+            {
+                "action": "answer_from_context",
+                "business_logic": {
+                    "evidence_refs": [156, " 157 ", 156, None, False, {"audit_id": 158}],
+                    "terms": [" cardiology ", 23, "cardiology", None],
+                },
+                "finding_updates": [
+                    {
+                        "finding_id": "finding-1",
+                        "effect": "strengthened",
+                        "confidence": 0.9,
+                        "summary": "Confirmed by another query.",
+                        "evidence_refs": 158,
+                    }
+                ],
+                "finding_usages": [
+                    {
+                        "finding_id": "finding-1",
+                        "usage": "used_for_query",
+                        "statement": "Used to constrain the query.",
+                        "evidence_refs": "query:159",
+                    }
+                ],
+            }
+        )
+    )
+
+    assert decision.business_logic.evidence_refs == ["156", "157"]
+    assert decision.business_logic.terms == ["cardiology", "23"]
+    assert decision.finding_updates[0].evidence_refs == ["158"]
+    assert decision.finding_usages[0].evidence_refs == ["query:159"]
+
+
 def test_analysis_stream_runs_final_query_and_persists_session(
     analysis_client: TestClient,
 ) -> None: