feat: sort analyses by updated_at, render data_used in traceability

- Sort analysis list by updated_at (desc) on load, select, create, and data-bind update
- Add data_used field to traceability response type and render it in a dedicated section
- Move tool calls behind a collapsible "Details" section instead of showing inline
- Update API contract docs for soft-delete analysis behavior and traceability data_used/tool_calls fields

docs/API_CONTRACT_BE_GOLANG.md

@@ -1,6 +1,6 @@
 # Backend Go API Contract
 
-**Last updated**: 2026-07-09
+**Last updated**: 2026-07-13
 
 Dokumen ini merangkum endpoint Orchestration Agent Service yang dipakai oleh frontend. Fokus flow:
 
@@ -764,7 +764,7 @@ Errors: `400`, `401`, `404`.
 
 ### `DELETE /api/v1/analyses/{id}`
 
-Hapus analysis milik user.
+Soft-delete analysis milik user: mengubah `status` menjadi `inactive`, bukan menghapus row dari database. Record analysis dan seluruh data terkait (reports, messages, report_inputs, dll) tetap ada di database, hanya tidak muncul lagi di `GET /api/v1/analyses` dengan filter default (`status=active`).
 
 Success `204` tanpa response body.
 

docs/API_CONTRACT_BE_PYTHON.md

@@ -1,5 +1,7 @@
 # Backend Agentic Service API Contract
 
+**Last updated**: 2026-07-13
+
 This document describes the Python agentic backend used by the frontend for AI chat, help/report tools, and traceability data shown alongside chat answers.
 
 Base path examples use relative URLs. Configure the frontend with the deployed Python service base URL.
@@ -422,6 +424,7 @@ Response `200` for `structured_flow`:
       "order": 1,
       "task_id": null,
       "name": "check_data",
+      "summary": "Inspected your data source structure",
       "input": { "source_hint": "structured" },
       "output": {
         "kind": "table",
@@ -436,6 +439,7 @@ Response `200` for `structured_flow`:
       "order": 2,
       "task_id": null,
       "name": "retrieve_data",
+      "summary": "Retrieved 4 rows across 2 columns from orders",
       "input": { "ir": { "source_id": "src_sales_db", "table_id": "orders", "select": ["region", "amount"], "group_by": ["region"] } },
       "output": {
         "kind": "table",
@@ -447,11 +451,34 @@ Response `200` for `structured_flow`:
       "error": null
     }
   ],
+  "data_used": [
+    {
+      "source": { "id": "src_sales_db", "name": "sales db", "type": "schema" },
+      "tables": [ { "id": "orders", "name": "orders", "role": "base" } ],
+      "joins": [],
+      "columns_read": [
+        { "id": "c_region", "name": "region", "table": "orders", "data_type": "string",  "pii": false, "roles": ["selected", "grouped"] },
+        { "id": "c_amount", "name": "amount", "table": "orders", "data_type": "decimal", "pii": false, "roles": ["aggregated"] }
+      ],
+      "output_columns": [
+        { "name": "region", "kind": "column",   "from": "orders.region" },
+        { "name": "total",  "kind": "computed", "from": "orders.amount", "formula": "SUM(orders.amount)" }
+      ],
+      "filters": [],
+      "group_by": ["orders.region"],
+      "order_by": [],
+      "limit": null,
+      "rows_returned": 4,
+      "query": "SELECT region, SUM(amount) AS total FROM orders GROUP BY region"
+    }
+  ],
   "sources": [
     {
       "type": "database",
       "source_id": "src_sales_db",
+      "source_name": "sales db",
       "name": "orders",
+      "tables": ["orders"],
       "query": "SELECT region, SUM(amount) AS total FROM orders GROUP BY region",
       "detail": {
         "table": "orders",

src/app/components/analysis/AnalysisShell.tsx

@@ -47,6 +47,10 @@ function toUiMessage(message: AnalysisMessage): UiMessage {
 }
 
 
+function sortByUpdatedAtDesc(items: Analysis[]) {
+  return [...items].sort((a, b) => new Date(b.updated_at).getTime() - new Date(a.updated_at).getTime());
+}
+
 function normalizeAssistantContent(content: string) {
   return content
     .replace(/([A-Za-z0-9])(?=\*\*)/g, "$1 ")
@@ -81,7 +85,7 @@ export function AnalysisShell() {
     try {
       const [detail, history] = await Promise.all([getAnalysis(analysis.id), getAnalysisMessages(analysis.id)]);
       setActiveAnalysis(detail);
-      setAnalyses((prev) => prev.map((item) => (item.id === detail.id ? detail : item)));
+      setAnalyses((prev) => sortByUpdatedAtDesc(prev.map((item) => (item.id === detail.id ? detail : item))));
       setMessages(history.map(toUiMessage));
     } catch (err) {
       toast.error(err instanceof Error ? err.message : "Failed to open analysis");
@@ -95,7 +99,7 @@ export function AnalysisShell() {
     setLoadingAnalyses(true);
     try {
       const result = await listAnalyses({ status: "active", page: 1, limit: 50 });
-      setAnalyses(result.analyses);
+      setAnalyses(sortByUpdatedAtDesc(result.analyses));
       if (!activeAnalysis && result.analyses.length > 0) {
         await selectAnalysis(result.analyses[0]);
       }
@@ -288,7 +292,7 @@ export function AnalysisShell() {
   };
 
   const handleCreated = (analysis: Analysis) => {
-    setAnalyses((prev) => [analysis, ...prev.filter((item) => item.id !== analysis.id)]);
+    setAnalyses((prev) => sortByUpdatedAtDesc([analysis, ...prev.filter((item) => item.id !== analysis.id)]));
     setActiveMenu("analysis-agent");
     selectAnalysis(analysis);
   };
@@ -314,7 +318,7 @@ export function AnalysisShell() {
     if (!activeAnalysis) return;
     const updated = await updateAnalysisDataBind(activeAnalysis.id, activeAnalysis.data_bind_version, items);
     setActiveAnalysis(updated);
-    setAnalyses((prev) => prev.map((item) => (item.id === updated.id ? updated : item)));
+    setAnalyses((prev) => sortByUpdatedAtDesc(prev.map((item) => (item.id === updated.id ? updated : item))));
     setStaleSources([]);
   };
 

src/app/components/analysis/MessageTraceability.tsx

@@ -1,6 +1,6 @@
 import { useState } from "react";
-import { ChevronDown, ChevronRight, Loader2, Route, Wrench } from "lucide-react";
-import type { Observability } from "@/services/agenticApi";
+import { ChevronDown, ChevronRight, Database, Loader2, Route, Wrench } from "lucide-react";
+import type { Observability, ObservabilityDataUsed } from "@/services/agenticApi";
 import { formatDateTime } from "./utils";
 
 interface MessageTraceabilityProps {
@@ -28,14 +28,55 @@ function sourceLabel(source: unknown, index: number) {
   return String(source ?? `Source ${index + 1}`);
 }
 
+function DataUsedCard({ item, index }: { item: ObservabilityDataUsed; index: number }) {
+  return (
+    <div className="rounded-md border border-slate-200 bg-white p-2">
+      <div className="flex items-center justify-between gap-2">
+        <p className="font-medium text-slate-900">{item.source?.name ?? `Data source ${index + 1}`}</p>
+        {item.source?.type && <span className="rounded bg-slate-100 px-1.5 py-0.5 text-[10px] uppercase text-slate-500">{item.source.type}</span>}
+      </div>
+
+      {item.tables && item.tables.length > 0 && (
+        <p className="mt-1.5 text-slate-600">
+          Tables: {item.tables.map((table) => table.name).join(", ")}
+        </p>
+      )}
+
+      {item.columns_read && item.columns_read.length > 0 && (
+        <div className="mt-1.5 flex flex-wrap gap-1">
+          {item.columns_read.map((column) => (
+            <span key={column.id} className="rounded border border-slate-200 bg-slate-50 px-1.5 py-0.5 text-[11px] text-slate-600">
+              {column.table ? `${column.table}.${column.name}` : column.name}
+            </span>
+          ))}
+        </div>
+      )}
+
+      {item.group_by && item.group_by.length > 0 && (
+        <p className="mt-1.5 text-slate-600">Grouped by: {item.group_by.join(", ")}</p>
+      )}
+
+      {typeof item.rows_returned === "number" && (
+        <p className="mt-1.5 text-slate-600">Rows returned: {item.rows_returned}</p>
+      )}
+
+      {item.query && (
+        <pre className="mt-2 max-h-40 overflow-auto rounded bg-slate-950 p-2 text-[11px] leading-4 text-slate-100">{item.query}</pre>
+      )}
+    </div>
+  );
+}
+
 export function MessageTraceability({ observability, loading, error, sources = [] }: MessageTraceabilityProps) {
   const [open, setOpen] = useState(false);
+  const [detailsOpen, setDetailsOpen] = useState(false);
   const traceSources = observability?.sources?.length ? observability.sources : sources;
   const hasTrace = Boolean(observability || loading || error || traceSources.length > 0);
 
   if (!hasTrace) return null;
 
   const toolCalls = observability?.tool_calls ?? [];
+  const dataUsed = observability?.data_used ?? [];
 
   return (
     <div className="mt-3 border-t border-slate-200 pt-3">
@@ -95,31 +136,59 @@ export function MessageTraceability({ observability, loading, error, sources = [
 
           <div>
             <div className="flex items-center gap-2 font-semibold text-slate-900">
-              <Wrench className="h-3.5 w-3.5" />
-              Tool calls
+              <Database className="h-3.5 w-3.5" />
+              Data used
             </div>
-            {toolCalls.length === 0 ? (
-              <p className="mt-1 text-slate-500">No tool call recorded for this answer.</p>
+            {dataUsed.length === 0 ? (
+              <p className="mt-1 text-slate-500">No data usage recorded for this answer.</p>
             ) : (
               <div className="mt-2 space-y-2">
-                {toolCalls.map((tool, index) => (
-                  <div key={`${tool.name}-${index}`} className="rounded-md border border-slate-200 bg-white p-2">
-                    <div className="flex items-center justify-between gap-2">
-                      <p className="font-medium text-slate-900">{tool.name}</p>
-                      {tool.status && <span className="rounded bg-slate-100 px-1.5 py-0.5 text-[10px] uppercase text-slate-500">{tool.status}</span>}
-                    </div>
-                    {tool.input !== undefined && (
-                      <pre className="mt-2 max-h-40 overflow-auto rounded bg-slate-950 p-2 text-[11px] leading-4 text-slate-100">{renderUnknown(tool.input)}</pre>
-                    )}
-                    {tool.output !== undefined && (
-                      <pre className="mt-2 max-h-40 overflow-auto rounded bg-white p-2 text-[11px] leading-4 text-slate-600 ring-1 ring-slate-200">{renderUnknown(tool.output)}</pre>
-                    )}
-                  </div>
+                {dataUsed.map((item, index) => (
+                  <DataUsedCard key={`${item.source?.id ?? "source"}-${index}`} item={item} index={index} />
                 ))}
               </div>
             )}
           </div>
 
+          <div>
+            <button
+              type="button"
+              title="Show tool call details"
+              aria-expanded={detailsOpen}
+              onClick={() => setDetailsOpen((current) => !current)}
+              className="inline-flex items-center gap-2 rounded-md px-1.5 py-1 text-xs font-semibold text-slate-900 hover:bg-slate-100"
+            >
+              {detailsOpen ? <ChevronDown className="h-3.5 w-3.5" /> : <ChevronRight className="h-3.5 w-3.5" />}
+              <Wrench className="h-3.5 w-3.5" />
+              Details
+            </button>
+
+            {detailsOpen && (
+              toolCalls.length === 0 ? (
+                <p className="mt-1 pl-1.5 text-slate-500">No tool call recorded for this answer.</p>
+              ) : (
+                <div className="mt-2 space-y-2 pl-1.5">
+                  {toolCalls.map((tool, index) => (
+                    <div key={`${tool.name}-${index}`} className="rounded-md border border-slate-200 bg-white p-2">
+                      <div className="flex items-center justify-between gap-2">
+                        <p className="font-medium text-slate-900">{tool.name}</p>
+                        {tool.status && <span className="rounded bg-slate-100 px-1.5 py-0.5 text-[10px] uppercase text-slate-500">{tool.status}</span>}
+                      </div>
+                      {tool.summary && <p className="mt-1 text-slate-600">{tool.summary}</p>}
+                      {tool.input !== undefined && (
+                        <pre className="mt-2 max-h-40 overflow-auto rounded bg-slate-950 p-2 text-[11px] leading-4 text-slate-100">{renderUnknown(tool.input)}</pre>
+                      )}
+                      {tool.output !== undefined && (
+                        <pre className="mt-2 max-h-40 overflow-auto rounded bg-white p-2 text-[11px] leading-4 text-slate-600 ring-1 ring-slate-200">{renderUnknown(tool.output)}</pre>
+                      )}
+                      {tool.error && <p className="mt-2 text-red-600">{tool.error}</p>}
+                    </div>
+                  ))}
+                </div>
+              )
+            )}
+          </div>
+
           {traceSources.length > 0 && (
             <div>
               <p className="font-semibold text-slate-900">Citations and sources</p>

src/services/agenticApi.ts

@@ -48,10 +48,55 @@ export interface ObservabilityPlanning {
 
 export interface ObservabilityToolCall {
   order?: number;
+  task_id?: string | null;
   name: string;
+  summary?: string;
   input?: unknown;
   output?: unknown;
   status?: string;
+  error?: string | null;
+}
+
+export interface ObservabilityDataUsedSource {
+  id: string;
+  name: string;
+  type: string;
+}
+
+export interface ObservabilityDataUsedTable {
+  id: string;
+  name: string;
+  role?: string;
+}
+
+export interface ObservabilityDataUsedColumn {
+  id: string;
+  name: string;
+  table?: string;
+  data_type?: string;
+  pii?: boolean;
+  roles?: string[];
+}
+
+export interface ObservabilityDataUsedOutputColumn {
+  name: string;
+  kind?: string;
+  from?: string;
+  formula?: string;
+}
+
+export interface ObservabilityDataUsed {
+  source: ObservabilityDataUsedSource;
+  tables?: ObservabilityDataUsedTable[];
+  joins?: unknown[];
+  columns_read?: ObservabilityDataUsedColumn[];
+  output_columns?: ObservabilityDataUsedOutputColumn[];
+  filters?: unknown[];
+  group_by?: string[];
+  order_by?: unknown[];
+  limit?: number | null;
+  rows_returned?: number;
+  query?: string;
 }
 
 export interface Observability {
@@ -62,6 +107,7 @@ export interface Observability {
   planning: ObservabilityPlanning | null;
   thinking: string | null;
   tool_calls: ObservabilityToolCall[];
+  data_used?: ObservabilityDataUsed[];
   sources: unknown[];
 }