@zaip-ai/cli 3.3.0 → 3.4.0

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostFilters.tsx

@@ -3,6 +3,15 @@ import { useEffect, useRef, useState } from "react";
 import type { CostMonitorProjection } from "../contracts.js";
 import type { CostCurrency, CostLocale } from "./cost-monitor-copy.js";
 
+export {
+  type CostRunPage,
+  loadCostMonitorDetail,
+  loadCostMonitorPeriod,
+  loadCostMonitorRunPage,
+} from "./cost-monitor-loaders.js";
+
+import type { loadCostMonitorPeriod } from "./cost-monitor-loaders.js";
+
 export type CostPeriod = "all" | "7" | "30" | "90" | "month";
 /** Cost Monitor opens on the current Sao Paulo month, matching Operations. */
 export const defaultCostPeriod: CostPeriod = "month";
@@ -21,171 +30,6 @@ export function costPeriodDateRange(
   return { from: saoPauloPeriodKey(from.toISOString(), "day") ?? to, to };
 }
 
-export async function loadCostMonitorPeriod({
-  currency,
-  filters,
-  from,
-  refresh,
-  to,
-  signal,
-  fetcher = fetch,
-}: {
-  currency: CostCurrency;
-  filters?: CostFilterState;
-  from?: string;
-  refresh?: string | null;
-  to?: string;
-  signal?: AbortSignal;
-  fetcher?: typeof fetch;
-}): Promise<CostMonitorProjection> {
-  const query = new URLSearchParams({ currency });
-  // Period and filter changes hydrate aggregate read models only. Entity
-  // detail is loaded through its dedicated bounded page route.
-  query.set("scope", "summary");
-  if (from !== undefined) query.set("from", from);
-  if (to !== undefined) query.set("to", to);
-  if (filters) {
-    const manifestFilters = [
-      ["provider", filters.provider],
-      ["phase", filters.phase],
-      ["agent", filters.agent],
-      ["model", filters.model],
-      ["status", filters.status],
-    ] as const;
-    for (const [key, value] of manifestFilters) {
-      if (value) query.set(key, value);
-    }
-  }
-  if (refresh) query.set("refresh", refresh);
-  const response = await fetcher(`/api/v2/cost-monitor?${query.toString()}`, {
-    ...(signal === undefined ? {} : { signal }),
-  });
-  if (!response.ok) {
-    const detail = (await response.text()).trim();
-    throw new Error(detail || `Cost Monitor period request failed (${response.status})`);
-  }
-  return (await response.json()) as CostMonitorProjection;
-}
-
-/** Exact dimensional projection, requested only after a dimensional tab opens. */
-export async function loadCostMonitorDetail({
-  currency,
-  filters,
-  from,
-  refresh,
-  to,
-  signal,
-  fetcher = fetch,
-}: {
-  currency: CostCurrency;
-  filters?: CostFilterState;
-  from?: string;
-  refresh?: string | null;
-  to?: string;
-  signal?: AbortSignal;
-  fetcher?: typeof fetch;
-}): Promise<CostMonitorProjection> {
-  const query = costMonitorQuery({
-    currency,
-    ...(filters === undefined ? {} : { filters }),
-    ...(from === undefined ? {} : { from }),
-    ...(refresh === undefined ? {} : { refresh }),
-    ...(to === undefined ? {} : { to }),
-  });
-  query.set("scope", "detail");
-  const response = await fetcher(`/api/v2/cost-monitor?${query.toString()}`, {
-    ...(signal === undefined ? {} : { signal }),
-  });
-  if (!response.ok)
-    throw new Error(
-      (await response.text()).trim() || `Cost Monitor detail request failed (${response.status})`,
-    );
-  return (await response.json()) as CostMonitorProjection;
-}
-
-export async function loadCostMonitorRunPage({
-  currency,
-  filters,
-  from,
-  limit = 10,
-  offset,
-  refresh,
-  to,
-  signal,
-  fetcher = fetch,
-}: {
-  currency: CostCurrency;
-  filters?: CostFilterState;
-  from?: string;
-  limit?: number;
-  offset: number;
-  refresh?: string | null;
-  to?: string;
-  signal?: AbortSignal;
-  fetcher?: typeof fetch;
-}): Promise<CostRunPage> {
-  const query = costMonitorQuery({
-    currency,
-    ...(filters === undefined ? {} : { filters }),
-    ...(from === undefined ? {} : { from }),
-    ...(refresh === undefined ? {} : { refresh }),
-    ...(to === undefined ? {} : { to }),
-  });
-  query.set("scope", "runs");
-  query.set("offset", String(Math.max(0, offset)));
-  query.set("limit", String(Math.max(1, limit)));
-  const response = await fetcher(`/api/v2/cost-monitor?${query.toString()}`, {
-    ...(signal === undefined ? {} : { signal }),
-  });
-  if (!response.ok) {
-    const detail = (await response.text()).trim();
-    throw new Error(detail || `Cost Monitor run page request failed (${response.status})`);
-  }
-  const payload = (await response.json()) as Pick<CostMonitorProjection, "runs" | "run_page">;
-  return {
-    page_only: true,
-    runs: payload.runs,
-    run_page: payload.run_page ?? { offset, limit, total: null, has_more: false },
-  };
-}
-
-/** Complete contract for the incremental Run endpoint; it is not a summary projection. */
-export interface CostRunPage {
-  page_only: true;
-  runs: CostMonitorProjection["runs"];
-  run_page: { offset: number; limit: number; total: number | null; has_more: boolean };
-}
-
-function costMonitorQuery({
-  currency,
-  filters,
-  from,
-  refresh,
-  to,
-}: {
-  currency: CostCurrency;
-  filters?: CostFilterState;
-  from?: string;
-  refresh?: string | null;
-  to?: string;
-}): URLSearchParams {
-  const query = new URLSearchParams({ currency });
-  if (from !== undefined) query.set("from", from);
-  if (to !== undefined) query.set("to", to);
-  if (filters) {
-    const manifestFilters = [
-      ["provider", filters.provider],
-      ["phase", filters.phase],
-      ["agent", filters.agent],
-      ["model", filters.model],
-      ["status", filters.status],
-    ] as const;
-    for (const [key, value] of manifestFilters) if (value) query.set(key, value);
-  }
-  if (refresh) query.set("refresh", refresh);
-  return query;
-}
-
 export function useCostMonitorPeriod({
   currency,
   data,
@@ -219,7 +63,9 @@ export function useCostMonitorPeriod({
   loadPeriodRef.current = loadPeriod;
   const requestedRange =
     dateRange === undefined
-      ? costPeriodDateRange(period)
+      ? snapshotBacked && period === defaultCostPeriod
+        ? undefined
+        : costPeriodDateRange(period)
       : { from: dateRange.start, to: dateRange.end };
   const requestedFrom = requestedRange?.from;
   const requestedTo = requestedRange?.to;
@@ -471,7 +317,7 @@ function Select({
   return (
     <label>
       <span>{label}</span>
-      <select onChange={(event) => onChange(event.target.value)} value={value}>
+      <select aria-label={label} onChange={(event) => onChange(event.target.value)} value={value}>
         <option value="">{allLabel}</option>
         {options.map((option) => (
           <option key={option} value={option}>

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostGroupsTable.tsx

@@ -102,16 +102,9 @@ export function CostGroupsTable({
       showAgentIdentity || showModelLifecycleDetails ? (value ?? 0) : value,
       locale,
     );
-  const displayDuration = (value: DurationCoverage) =>
-    (showAgentIdentity || showModelLifecycleDetails) && value.known_sum <= 0
-      ? "0"
-      : formatDurationCoverage(value, locale);
+  const displayDuration = (value: DurationCoverage) => formatDurationCoverage(value, locale);
   const displayCurrency = (value: number | null) =>
-    formatAuditableCurrency(
-      showAgentIdentity || showModelLifecycleDetails ? (value ?? 0) : value,
-      currency,
-      locale,
-    );
+    formatAuditableCurrency(value, currency, locale);
   const conversationCount = (row: unknown): number | null =>
     (row as { conversation_count?: number | null }).conversation_count ?? null;
   const pageTotals = {

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorPage.test.ts

@@ -177,7 +177,7 @@ describe("cost monitor navigation", () => {
         period: defaultCostPeriod,
         runPageRange: monthRange,
       }),
-    ).toEqual(monthRange);
+    ).toBeUndefined();
   });
 
   it("keeps compact SPEC and PRD pages and their export source on the all-time snapshot", () => {
@@ -282,7 +282,7 @@ describe("cost monitor navigation", () => {
       duration_ms: 619_958_763,
     });
   });
-  it("fills token-backed compact duration without a visible missing-data count", () => {
+  it("renders factual compact duration without a visible missing-data count", () => {
     const table = readFileSync(new URL("./CompactLifecycleCostTable.tsx", import.meta.url), "utf8");
     const summary = readFileSync(new URL("./CostSummary.tsx", import.meta.url), "utf8");
     expect(table).toContain("compactLifecycleDurationMs(row)");
@@ -292,7 +292,7 @@ describe("cost monitor navigation", () => {
     expect(summary).not.toContain("formatPercent(");
   });
 
-  it("estimates a paginated lifecycle row whenever it has tokens but no time", () => {
+  it("preserves unavailable timing and coverage when a paginated row has only tokens", () => {
     const metric = (known_sum: number, unknown: number) => ({
       known_sum,
       unknown,
@@ -306,12 +306,12 @@ describe("cost monitor navigation", () => {
         cost: metric(0, 1),
       },
     } as never;
-    expect(compactLifecycleDurationMs(row)).toBe(3_600_000);
+    expect(compactLifecycleDurationMs(row)).toBeNull();
     expect(withTokenBackedCompactDuration(row).metrics.duration).toEqual({
-      known_sum: 3_600_000,
-      unknown: 0,
-      complete: true,
-      coverage_ratio: 1,
+      known_sum: 0,
+      unknown: 1,
+      complete: false,
+      coverage_ratio: 0,
     });
   });
 

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostMonitorPage.tsx

@@ -1,11 +1,7 @@
-import {
-  type OperationsProjection,
-  type RunProjection,
-  saoPauloPeriodKey,
-} from "@zaip-ai/dashboard-operations/contracts";
+import { type RunProjection, saoPauloPeriodKey } from "@zaip-ai/dashboard-operations/contracts";
 import { ExcelExportAction } from "@zaip-ai/dashboard-operations/react";
 import { DashboardHeader } from "@zaip-ai/dashboard-ui";
-import { type ReactNode, useEffect, useMemo, useRef, useState } from "react";
+import { useEffect, useMemo, useRef, useState } from "react";
 import { includeConfiguredAgentGroups } from "../agent-groups.js";
 import type { CostMonitorProjection } from "../contracts.js";
 import { normalizeCostProvider } from "../provider.js";
@@ -27,6 +23,7 @@ import { CostMonitorContent } from "./CostMonitorContent.js";
 import { CostMonitorLoadErrors } from "./CostMonitorLoadErrors.js";
 import { CostMonitorNavigation, type CostNavigationPopup } from "./CostMonitorNavigation.js";
 import { CostSummary } from "./CostSummary.js";
+import type { CostMonitorPageProps } from "./cost-monitor-page-props.js";
 import {
   groupRows,
   matches,
@@ -50,12 +47,8 @@ import { summarizeCostRows } from "./cost-monitor-summary.js";
 import { COST_VIEW_ORDER, type CostView, DEFAULT_COST_VIEW } from "./cost-monitor-views.js";
 import { resolveCompactCostPageRange, resolveCostGroupPageRange } from "./cost-page-range.js";
 import { enrichPeriodCostGroups } from "./period-cost-groups.js";
-import {
-  compactReadModelKind,
-  type LoadCompactCostPage,
-  useCompactCostPage,
-} from "./use-compact-cost-page.js";
-import { type LoadCostGroupPage, useCostGroupPage } from "./use-cost-group-page.js";
+import { compactReadModelKind, useCompactCostPage } from "./use-compact-cost-page.js";
+import { useCostGroupPage } from "./use-cost-group-page.js";
 import { useCostRunPage } from "./use-cost-run-page.js";
 import "./cost-monitor.css";
 import "./cost-monitor-responsive.css";
@@ -110,38 +103,7 @@ export function CostMonitorPage({
   repositoryName,
   currency: controlledCurrency,
   onCurrencyChange,
-}: {
-  capabilityNavigation?: ReactNode;
-  data: CostMonitorProjection;
-  dashboardTitle?: string;
-  embedded?: boolean;
-  globalFilters?: { query: string; datePreset: string; dateRange?: { start: string; end: string } };
-  lastUpdatedAt: string | null;
-  locale: CostLocale;
-  loading: boolean;
-  onLoadingChange?: (loading: boolean) => void;
-  onLocaleChange: (locale: CostLocale) => void;
-  onOpenTrace: (taskId: string) => void;
-  onActiveDataChange?: (data: CostMonitorProjection) => void;
-  /**
-   * Retained for host compatibility. Cost views must use bounded summary or
-   * page routes; activating a tab never requests the historical detail blob.
-   */
-  onDetailDataRequest?: () => void;
-  onRefresh: () => void;
-  loadDetail?: LoadCostMonitorDetail;
-  loadRunPage?: LoadCostRunPage;
-  loadReadModelPage?: LoadCompactCostPage;
-  loadGroupPage?: LoadCostGroupPage;
-  loadPeriod?: typeof loadCostMonitorPeriod;
-  operations?: Pick<
-    OperationsProjection,
-    "runs" | "specs" | "tasks" | "executions" | "evidences" | "validations" | "summary"
-  >;
-  repositoryName?: string;
-  currency?: CostCurrency;
-  onCurrencyChange?: (currency: CostCurrency) => void;
-}) {
+}: CostMonitorPageProps) {
   const [view, setView] = useState<CostView>(DEFAULT_COST_VIEW);
   const [filters, setFilters] = useState<CostFilterState>(emptyCostFilters);
   const [localCurrency, setLocalCurrency] = useState<CostCurrency>("BRL");
@@ -168,11 +130,15 @@ export function CostMonitorPage({
   const loadDetailRef = useRef(loadDetail);
   loadDetailRef.current = loadDetail;
   const text = costCopy[locale];
+  const summaryFilters = useMemo(
+    () => ({ ...filters, query: filters.query || globalFilters?.query || "" }),
+    [filters, globalFilters?.query],
+  );
   const { activeData, periodError, periodLoading } = useCostMonitorPeriod({
     currency,
     data,
     ...(globalFilters === undefined ? {} : { dateRange: globalFilters.dateRange }),
-    filters,
+    filters: summaryFilters,
     lastUpdatedAt,
     loadPeriod,
     period,
@@ -353,10 +319,10 @@ export function CostMonitorPage({
   }, [currency, detailAttempt, filters, lastUpdatedAt, runPageFrom, runPageTo]);
   const pagedRunRows = useMemo(
     () =>
-      (runPageData?.runs ?? []).filter(
-        (row) => matches(row, filters) && matchesGlobalFilters(row, globalFilters),
-      ),
-    [filters, globalFilters, runPageData?.runs],
+      // The endpoint filters before pagination, including usage segments.
+      // Filtering its page again by a sparse display row loses valid matches.
+      runPageData?.runs ?? [],
+    [runPageData?.runs],
   );
   const dimensionalRows = useMemo(
     () =>
@@ -395,8 +361,7 @@ export function CostMonitorPage({
   );
   const visiblePrds = periodEntities.prds;
   const visibleSpecs = periodEntities.specs;
-  const useAggregateGroups =
-    activeData.aggregate_only === true && dimensionalRows.length === 0 && !hasLocalCostFilters;
+  const useAggregateGroups = activeData.aggregate_only === true && dimensionalRows.length === 0;
   const groups = useMemo(() => {
     if (useAggregateGroups) return activeData.groups;
     return {
@@ -730,7 +695,7 @@ export function CostMonitorPage({
           <div className="cost-tab-export">
             {" "}
             <ExcelExportAction
-              filters={{ ...filters, ...globalFilters, period }}
+              filters={{ ...globalFilters, ...summaryFilters, period }}
               pageSource={
                 compactExportSource ??
                 agentInvocationExportSource ??
@@ -743,6 +708,18 @@ export function CostMonitorPage({
           </div>
         ) : null}
       </div>{" "}
+      {embedded && view !== "developers" ? (
+        <details className="cost-embedded-filters">
+          <summary>{locale === "pt-BR" ? "Filtros de custos" : "Cost filters"}</summary>
+          <CostFilters
+            available={data.filters_available}
+            hideQuery
+            locale={locale}
+            onChange={setFilters}
+            value={filters}
+          />
+        </details>
+      ) : null}
       {/* CostMonitorContent owns `view === "models" && useAggregateGroups ? (` and `rows={groups.models}`. */}{" "}
       <CostMonitorContent
         canonicalDurationTotal={canonicalDurationTotal}

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTableLoading.test.ts

@@ -105,7 +105,7 @@ describe("period-driven Cost Monitor loading", () => {
         url:
           "/api/v2/cost-monitor?currency=BRL&scope=summary&from=2026-07-01&to=2026-07-26" +
           "&provider=openai&phase=execution&agent=zaip-agent-builder" +
-          "&model=gpt-5.6-terra&status=completed",
+          "&model=gpt-5.6-terra&status=completed&query=TASK-1&priority=high&risk=standard&origin=spec&workType=rework",
         signal: controller.signal,
       },
     ]);

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables-keeps-legacy-codex-identity-fields-blank.test.ts

@@ -176,10 +176,10 @@ describe("grouped cost availability", () => {
           ...model,
           duration: { known_sum: 0, unknown: 1, complete: false, coverage_ratio: 0 },
         }),
-    ).toBe("0");
+    ).toBe("Indisponível");
     expect(
       columns.find((column) => column.key === "cost")?.render?.({ ...model, estimated_brl: null }),
-    ).toContain("0,00");
+    ).toBe("Indisponível");
     expect(
       columns
         .find((column) => column.key === "tokens")

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables.test.ts

@@ -1,7 +1,6 @@
 import { describe, expect, it } from "vitest";
 import type { CostGroupRow } from "../contracts.js";
 import {
-  agentRunModelPresentation,
   type CostDeveloperAttributionRow,
   CostDeveloperAttributionTable,
   CostGroupsTable,
@@ -27,29 +26,6 @@ import {
   runOriginBadge,
 } from "./CostTables.js";
 
-describe("Agent Run model presentation", () => {
-  it("shows only the effective model and its provider", () => {
-    expect(
-      agentRunModelPresentation({
-        requested_model: "gpt-5.6-terra",
-        model: "gpt-5.6-sol",
-        provider: "openai",
-      }),
-    ).toEqual({ primary: "gpt-5.6-sol", detail: "openai" });
-  });
-  it("does not mention an unavailable planned configuration", () => {
-    expect(
-      agentRunModelPresentation({
-        requested_model: "unknown",
-        model: "gpt-5.6-sol",
-        provider: "openai",
-      }),
-    ).toEqual({
-      primary: "gpt-5.6-sol",
-      detail: "openai",
-    });
-  });
-});
 describe("period formatting", () => {
   it("renders daily dates and keeps monthly periods numerically sortable", () => {
     expect(formatCostPeriodLabel("2026-07-16", "daily", "pt-BR")).toBe("16/07/2026");
@@ -456,7 +432,7 @@ describe("grouped cost availability", () => {
     expect(columns.find((column) => column.key === "tasks")?.label).toBe("Tarefas");
     expect(table.props.defaultSort).toEqual({ key: "cost", direction: "desc" });
   });
-  it("renders missing Agent numeric metrics as zero, keeping model rendering independent", () => {
+  it("preserves unavailable Agent duration and cost independently of entity counts", () => {
     const missing: CostGroupRow = {
       ...unavailableGroup,
       task_count: null,
@@ -476,9 +452,10 @@ describe("grouped cost availability", () => {
       render?: (row: CostGroupRow) => unknown;
       footer?: unknown;
     }>;
-    for (const key of ["tasks", "prds", "specs", "tests", "evidences", "duration", "tokens"]) {
+    for (const key of ["tasks", "prds", "specs", "tests", "evidences", "tokens"]) {
       expect(columns.find((c) => c.key === key)?.render?.(missing)).toBe("0");
     }
-    expect(columns.find((c) => c.key === "cost")?.render?.(missing)).not.toContain("Indisponível");
+    expect(columns.find((c) => c.key === "duration")?.render?.(missing)).toBe("Indisponível");
+    expect(columns.find((c) => c.key === "cost")?.render?.(missing)).toBe("Indisponível");
   });
 });

package/templates/.agents/dashboard/modules/cost-monitor/src/react/MacroCostTable.test.ts

@@ -32,7 +32,7 @@ describe("macroCostDuration", () => {
     expect(operationalMacroDuration({ duration_ms: 2_686_869 } as never)).toBeNull();
   });
 
-  it("accepts factual values and estimates a tokenized Run without lifecycle elapsed time", () => {
+  it("accepts factual values and leaves time unavailable for a tokenized Run without timing", () => {
     expect(
       macroCostDuration({
         source_duration_ms: null,
@@ -46,7 +46,7 @@ describe("macroCostDuration", () => {
         duration_ms: null,
         usage: { total: { tokens: { total: 4_000_000 } } },
       } as never),
-    ).toBe(3_600_000);
+    ).toBeNull();
   });
 
   it("uses only the root execution analytical duration, never lifecycle elapsed time or a subrun", () => {

package/templates/.agents/dashboard/modules/cost-monitor/src/react/MacroCostTable.tsx

@@ -11,7 +11,6 @@ import {
   formatPercent,
 } from "@zaip-ai/dashboard-ui";
 import { useState } from "react";
-import { estimatedDurationMs } from "../duration-estimate.js";
 import { formatDateTime, sortCostValue } from "./CostTables.js";
 import type { CostCurrency, CostLocale } from "./cost-monitor-copy.js";
 
@@ -200,11 +199,13 @@ export function macroCostDuration(
 ): number | null {
   if (typeof run.source_duration_ms === "number") return run.source_duration_ms;
   if (
-    (run.duration_provenance === "legacy_inferred" || run.duration_provenance === "reconciled") &&
+    (run.duration_provenance === "observed" ||
+      run.duration_provenance === "legacy_inferred" ||
+      run.duration_provenance === "reconciled") &&
     typeof run.duration_ms === "number"
   )
     return run.duration_ms;
-  return estimatedDurationMs(run.usage?.total.tokens.total ?? null);
+  return null;
 }
 
 export function macroCoverageProvenanceLabel(

package/templates/.agents/dashboard/modules/cost-monitor/src/react/agent-model-presentation.test.ts

@@ -0,0 +1,26 @@
+import { describe, expect, it } from "vitest";
+import { agentRunModelPresentation } from "./CostTables.js";
+
+describe("Agent Run model presentation", () => {
+  it("shows only the effective model and its provider", () => {
+    expect(
+      agentRunModelPresentation({
+        requested_model: "gpt-5.6-terra",
+        model: "gpt-5.6-sol",
+        provider: "openai",
+      }),
+    ).toEqual({ primary: "gpt-5.6-sol", detail: "openai" });
+  });
+  it("does not mention an unavailable planned configuration", () => {
+    expect(
+      agentRunModelPresentation({
+        requested_model: "unknown",
+        model: "gpt-5.6-sol",
+        provider: "openai",
+      }),
+    ).toEqual({
+      primary: "gpt-5.6-sol",
+      detail: "openai",
+    });
+  });
+});

package/templates/.agents/dashboard/modules/cost-monitor/src/react/cost-monitor-embedded.css

@@ -9,3 +9,10 @@
   color: var(--text-primary);
   font-size: 1rem;
 }
+.cost-embedded-filters {
+  margin-block: 12px;
+}
+.cost-embedded-filters summary {
+  cursor: pointer;
+  padding-block: 8px;
+}