@zaip-ai/cli 1.3.8 → 1.4.2

package/templates/.agents/dashboard/modules/cost-monitor/src/react/use-cost-run-page.ts

@@ -13,6 +13,7 @@ export function useCostRunPage({
   limit = 10,
   range,
   refresh,
+  revision,
   load,
 }: {
   view: CostView;
@@ -23,6 +24,8 @@ export function useCostRunPage({
   limit?: number;
   range: { from: string; to: string } | undefined;
   refresh: string | null;
+  /** Changes when the host promotes a new immutable dashboard snapshot. */
+  revision: number;
   load: typeof loadCostMonitorRunPage | undefined;
 }) {
   const [offset, setOffset] = useState(0);
@@ -37,7 +40,7 @@ export function useCostRunPage({
   const rangeTo = range?.to;
   const effectiveFilters = { ...filters, query: filters.query || globalQuery };
   const paginationKey = `${Object.values(effectiveFilters).join("\u0000")}\u0000${rangeFrom ?? ""}\u0000${rangeTo ?? ""}`;
-  const requestKey = `${view}\u0000${eligible}\u0000${currency}\u0000${limit}\u0000${paginationKey}\u0000${refresh ?? ""}`;
+  const requestKey = `${view}\u0000${eligible}\u0000${currency}\u0000${limit}\u0000${paginationKey}\u0000${refresh ?? ""}\u0000${revision}`;
   const requestInputRef = useRef({
     view,
     eligible,

package/templates/.agents/dashboard/modules/cost-monitor/src/server/build-cost-summary-projection.ts

@@ -637,10 +637,10 @@ function mergePeriodRows(rows: readonly CostGroupRow[], prefixLength: number): C
         tasksCreated: values.reduce((total, row) => total + (row.tasksCreated ?? 0), 0),
         tasksActive: values.reduce((total, row) => total + (row.tasksActive ?? 0), 0),
         taskDaysActive: values.reduce((total, row) => total + (row.taskDaysActive ?? 0), 0),
-        prd_count: values.reduce((total, row) => total + row.prd_count, 0),
-        spec_count: values.reduce((total, row) => total + row.spec_count, 0),
-        evidence_count: values.reduce((total, row) => total + row.evidence_count, 0),
-        test_count: values.reduce((total, row) => total + row.test_count, 0),
+        prd_count: values.reduce((total, row) => total + (row.prd_count ?? 0), 0),
+        spec_count: values.reduce((total, row) => total + (row.spec_count ?? 0), 0),
+        evidence_count: values.reduce((total, row) => total + (row.evidence_count ?? 0), 0),
+        test_count: values.reduce((total, row) => total + (row.test_count ?? 0), 0),
         event_count: values.reduce((total, row) => total + row.event_count, 0),
         total_tokens: mergeNullableMetric(values.map((row) => row.total_tokens)),
         estimated_usd: mergeNullableMetric(values.map((row) => row.estimated_usd)),

package/templates/.agents/dashboard/modules/operations/src/react/export/ExcelExportAction.test.ts

@@ -2,20 +2,24 @@ import { describe, expect, it } from "vitest";
 import {
   AGENT_INVOCATION_EXPORT_COLUMNS,
   COMPACT_LIFECYCLE_EXPORT_COLUMNS,
+  COST_AGENT_EXPORT_COLUMNS,
   COST_GROUP_EXPORT_COLUMNS,
   DEVELOPER_EXPORT_COLUMNS,
   EXECUTION_EXPORT_COLUMNS,
   EXPORT_SUCCESS_TOAST_MS,
   exportAgentInvocationRows,
   exportCompactLifecycleRows,
+  exportCostAgentRows,
   exportCostGroupRows,
   exportDeveloperRows,
   exportExecutionRows,
   exportHeadersForView,
+  exportModelCostGroupRows,
   exportPageSourceRows,
   exportRowsWithDurationHours,
   exportWorkRows,
   KANBAN_EXPORT_COLUMNS,
+  MODEL_COST_GROUP_EXPORT_COLUMNS,
   WORK_EXPORT_COLUMNS,
 } from "./ExcelExportAction.js";
 
@@ -489,7 +493,7 @@ it("does not append raw keys to any explicitly schema-bound Cost view", () => {
   expect(exportHeadersForView("cost-specs", raw)).toEqual(COMPACT_LIFECYCLE_EXPORT_COLUMNS);
   expect(exportHeadersForView("cost-prds", raw)).toEqual(COMPACT_LIFECYCLE_EXPORT_COLUMNS);
   expect(exportHeadersForView("cost-conversations", raw)).toEqual(COMPACT_LIFECYCLE_EXPORT_COLUMNS);
-  expect(exportHeadersForView("cost-agents", raw)).toEqual(COST_GROUP_EXPORT_COLUMNS);
+  expect(exportHeadersForView("cost-agents", raw)).toEqual(COST_AGENT_EXPORT_COLUMNS);
   expect(exportHeadersForView("cost-agent-calls", raw)).toEqual(AGENT_INVOCATION_EXPORT_COLUMNS);
   expect(exportHeadersForView("operations-conversations", raw)).toEqual(
     expect.not.arrayContaining(["internal_only"]),
@@ -524,6 +528,80 @@ it("exports model, provider, and ZAIP Agent groups with their populated metrics"
   ]);
 });
 
+it("exports model analysis in table order with explicit numeric zeroes", () => {
+  expect(MODEL_COST_GROUP_EXPORT_COLUMNS).toEqual([
+    "model",
+    "prds",
+    "specs",
+    "tasks",
+    "conversations",
+    "runs",
+    "tests",
+    "evidences",
+    "duration_hours",
+    "tokens",
+    "costs",
+  ]);
+  expect(exportHeadersForView("cost-models", [])).toEqual(MODEL_COST_GROUP_EXPORT_COLUMNS);
+  expect(
+    exportModelCostGroupRows([
+      {
+        key: "gpt-6-astra",
+        prd_count: 2,
+        spec_count: 3,
+        task_count: null,
+        conversation_count: null,
+        run_count: 8,
+        test_count: 1,
+        evidence_count: 4,
+        duration_ms: 1_800_000,
+        total_tokens: 7_900_000,
+        estimated_brl: 77.23,
+      },
+    ]),
+  ).toEqual([
+    {
+      model: "gpt-6-astra",
+      prds: 2,
+      specs: 3,
+      tasks: 0,
+      conversations: 0,
+      runs: 8,
+      tests: 1,
+      evidences: 4,
+      duration_hours: 0.5,
+      tokens: 7_900_000,
+      costs: 77.23,
+    },
+  ]);
+});
+
 it("clears pending success when a new export starts", () => {
   expect("running").not.toBe("completed");
 });
+
+it("exports Agent tasks as participations and fills every missing numeric cell with zero", () => {
+  expect(COST_AGENT_EXPORT_COLUMNS).toEqual([
+    "Persona",
+    "Cargo",
+    "Zaip Agentes",
+    "PRDs",
+    "SPECs",
+    "Tarefas",
+    "Runs",
+    "Testes",
+    "Evidências",
+    "Tempo",
+    "Tokens",
+    "Custos",
+  ]);
+  const rows = exportCostAgentRows([
+    { key: "dave", task_count: 2 },
+    { key: "leo", task_count: 2 },
+    {},
+  ]);
+  expect(rows[0]?.Tarefas).toBe(2);
+  expect(rows[1]?.Tarefas).toBe(2);
+  for (const key of COST_AGENT_EXPORT_COLUMNS.slice(3)) expect(rows[2]?.[key]).toBe(0);
+  expect(rows[0]).not.toHaveProperty("tasks_created");
+});

package/templates/.agents/dashboard/modules/operations/src/react/export/ExcelExportAction.tsx

@@ -27,6 +27,7 @@ export const PERIOD_EXPORT_COLUMNS = [
   "prds",
   "specs",
   "tasks",
+  "conversations",
   "runs",
   "tests",
   "evidences",
@@ -118,6 +119,37 @@ export const COST_GROUP_EXPORT_COLUMNS = [
   "duration_hours",
 ] as const;
 
+/** Agent exports count Task participation, including repeated Tasks across agents. */
+export const COST_AGENT_EXPORT_COLUMNS = [
+  "Persona",
+  "Cargo",
+  "Zaip Agentes",
+  "PRDs",
+  "SPECs",
+  "Tarefas",
+  "Runs",
+  "Testes",
+  "Evidências",
+  "Tempo",
+  "Tokens",
+  "Custos",
+] as const;
+
+/** The model audit mirrors its table: entity links precede financial facts. */
+export const MODEL_COST_GROUP_EXPORT_COLUMNS = [
+  "model",
+  "prds",
+  "specs",
+  "tasks",
+  "conversations",
+  "runs",
+  "tests",
+  "evidences",
+  "duration_hours",
+  "tokens",
+  "costs",
+] as const;
+
 // Cost Monitor developer attribution is a factual aggregate with coverage
 // counters. Keep the workbook schema aligned with that table and retain null
 // facts instead of allowing them to be inferred as zero by a spreadsheet.
@@ -354,6 +386,54 @@ export function exportCostGroupRows(
   });
 }
 
+export function exportCostAgentRows(
+  rows: readonly Record<string, unknown>[],
+): Record<string, unknown>[] {
+  return rows.map((row) => {
+    const durationMs = numberValue(row.duration_ms) ?? numberValue(row.total_duration);
+    return {
+      Persona: row.persona ?? null,
+      Cargo: row.job ?? null,
+      "Zaip Agentes": row.label ?? row.key ?? null,
+      PRDs: numberValue(row.prd_count) ?? 0,
+      SPECs: numberValue(row.spec_count) ?? 0,
+      Tarefas: numberValue(row.task_count) ?? 0,
+      Runs: numberValue(row.run_count) ?? numberValue(row.invocation_count) ?? 0,
+      Testes: numberValue(row.test_count) ?? numberValue(row.validation_count) ?? 0,
+      Evidências: numberValue(row.evidence_count) ?? 0,
+      Tempo: (durationMs ?? 0) / 3_600_000,
+      Tokens: numberValue(row.total_tokens) ?? 0,
+      Custos: numberValue(row.estimated_brl) ?? numberValue(row.total_cost_brl) ?? 0,
+    };
+  });
+}
+
+/**
+ * Preserve the factual model-attribution contract in the workbook. In
+ * The requested model-analysis surface is fully numeric, while the raw
+ * projection keeps attribution nulls for auditability.
+ */
+export function exportModelCostGroupRows(
+  rows: readonly Record<string, unknown>[],
+): Record<string, unknown>[] {
+  return rows.map((row) => {
+    const durationMs = numberValue(row.duration_ms) ?? numberValue(row.total_duration);
+    return {
+      model: row.label ?? row.model ?? row.key ?? null,
+      prds: numberValue(row.prd_count) ?? 0,
+      specs: numberValue(row.spec_count) ?? 0,
+      tasks: numberValue(row.task_count) ?? 0,
+      conversations: numberValue(row.conversation_count) ?? 0,
+      runs: numberValue(row.run_count) ?? numberValue(row.invocation_count) ?? 0,
+      tests: numberValue(row.test_count) ?? numberValue(row.validation_count) ?? 0,
+      evidences: numberValue(row.evidence_count) ?? 0,
+      duration_hours: durationMs === null ? 0 : durationMs / 3_600_000,
+      tokens: numberValue(row.total_tokens) ?? 0,
+      costs: numberValue(row.estimated_brl) ?? numberValue(row.total_cost_brl) ?? 0,
+    };
+  });
+}
+
 /** Normalize Cost Monitor developer facts into the fixed XLSX schema. */
 export function exportDeveloperRows(
   rows: readonly Record<string, unknown>[],
@@ -524,6 +604,8 @@ export function exportHeadersForView(
   const isOperationsConversationView = view === "operations-conversations";
   const isCompactLifecycleView =
     /-(?:tasks|specs|prds|conversations)$/.test(view) && !isOperationsConversationView;
+  const isModelCostGroupView = view === "cost-models";
+  const isCostAgentView = view === "cost-agents";
   const isCostGroupView = /-(?:agents|models|providers)$/.test(view);
   const isDeveloperView = view === "cost-developers";
   const isChangeView = view === "operations-changes";
@@ -534,7 +616,9 @@ export function exportHeadersForView(
   if (isCostExecutionView) headers.push(...COMPACT_LIFECYCLE_EXPORT_COLUMNS);
   if (isAgentInvocationView) headers.push(...AGENT_INVOCATION_EXPORT_COLUMNS);
   if (isCompactLifecycleView) headers.push(...COMPACT_LIFECYCLE_EXPORT_COLUMNS);
-  if (isCostGroupView) headers.push(...COST_GROUP_EXPORT_COLUMNS);
+  if (isCostAgentView) headers.push(...COST_AGENT_EXPORT_COLUMNS);
+  else if (isModelCostGroupView) headers.push(...MODEL_COST_GROUP_EXPORT_COLUMNS);
+  else if (isCostGroupView) headers.push(...COST_GROUP_EXPORT_COLUMNS);
   if (isDeveloperView) headers.push(...DEVELOPER_EXPORT_COLUMNS);
   if (isOperationsConversationView) headers.push(...CONVERSATION_EXPORT_COLUMNS);
   if (isChangeView) headers.push(...CHANGE_EXPORT_COLUMNS);
@@ -592,6 +676,8 @@ export function ExcelExportAction({ filters, pageSource, rows, view }: ExcelExpo
   const isOperationsConversationView = view === "operations-conversations";
   const isCompactLifecycleView =
     /-(?:tasks|specs|prds|conversations)$/.test(view) && !isOperationsConversationView;
+  const isModelCostGroupView = view === "cost-models";
+  const isCostAgentView = view === "cost-agents";
   const isCostGroupView = /-(?:agents|models|providers)$/.test(view);
   const isDeveloperView = view === "cost-developers";
   const isChangeView = view === "operations-changes";
@@ -631,11 +717,15 @@ export function ExcelExportAction({ filters, pageSource, rows, view }: ExcelExpo
                           ? exportAgentInvocationRows
                           : isCompactLifecycleView
                             ? exportCompactLifecycleRows
-                            : isCostGroupView
-                              ? exportCostGroupRows
-                              : isDeveloperView
-                                ? exportDeveloperRows
-                                : exportRowsWithDurationHours,
+                            : isCostAgentView
+                              ? exportCostAgentRows
+                              : isModelCostGroupView
+                                ? exportModelCostGroupRows
+                                : isCostGroupView
+                                  ? exportCostGroupRows
+                                  : isDeveloperView
+                                    ? exportDeveloperRows
+                                    : exportRowsWithDurationHours,
           );
           return;
         }
@@ -659,11 +749,15 @@ export function ExcelExportAction({ filters, pageSource, rows, view }: ExcelExpo
                           ? exportAgentInvocationRows
                           : isCompactLifecycleView
                             ? exportCompactLifecycleRows
-                            : isCostGroupView
-                              ? exportCostGroupRows
-                              : isDeveloperView
-                                ? exportDeveloperRows
-                                : exportRowsWithDurationHours
+                            : isCostAgentView
+                              ? exportCostAgentRows
+                              : isModelCostGroupView
+                                ? exportModelCostGroupRows
+                                : isCostGroupView
+                                  ? exportCostGroupRows
+                                  : isDeveloperView
+                                    ? exportDeveloperRows
+                                    : exportRowsWithDurationHours
           )(rows.slice(offset, offset + 500));
       },
     });