@zaip-ai/cli 3.3.0 → 3.5.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;
+}

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

@@ -0,0 +1,173 @@
+import type { CostMonitorProjection } from "../contracts.js";
+import type { CostFilterState } from "./CostFilters.js";
+import type { CostCurrency } from "./cost-monitor-copy.js";
+
+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],
+      ["query", filters.query],
+      ["priority", filters.priority],
+      ["risk", filters.risk],
+      ["origin", filters.origin],
+      ["workType", filters.workType],
+    ] 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;
+}

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

@@ -0,0 +1,47 @@
+import type { OperationsProjection } from "@zaip-ai/dashboard-operations/contracts";
+import type { ReactNode } from "react";
+import type { CostMonitorProjection } from "../contracts.js";
+import type {
+  loadCostMonitorDetail,
+  loadCostMonitorPeriod,
+  loadCostMonitorRunPage,
+} from "./CostFilters.js";
+import type { CostCurrency, CostLocale } from "./cost-monitor-copy.js";
+import type { LoadCompactCostPage } from "./use-compact-cost-page.js";
+import type { LoadCostGroupPage } from "./use-cost-group-page.js";
+
+type LoadCostMonitorDetail = typeof loadCostMonitorDetail;
+type LoadCostRunPage = typeof loadCostMonitorRunPage;
+
+export interface CostMonitorPageProps {
+  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;
+}

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

@@ -39,11 +39,5 @@ export function visibleExecutionRows<T extends { id: string }>(
 
 /** Only filters represented by the partial Runs endpoint may use page-only data. */
 export function isServerCostRunPagingEligible(filters: CostFilterState, globalQuery = ""): boolean {
-  return (
-    (globalQuery === "" || filters.query === "") &&
-    filters.priority === "" &&
-    filters.risk === "" &&
-    filters.origin === "" &&
-    filters.workType === ""
-  );
+  return globalQuery === "" || filters.query === "";
 }

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

@@ -4,12 +4,11 @@ export type CostPageDateRange = { from: string; to: string };
 
 /**
  * Embedded pages use the host's all-time atomic snapshot until an explicit
- * period, date range, or local Cost filter narrows the population.
+ * period or date range narrows the population. Metadata never changes dates.
  */
 export function resolveCostGroupPageRange({
   embedded,
   globalDateRange,
-  hasLocalCostFilters,
   period,
   runPageRange,
 }: {
@@ -19,13 +18,8 @@ export function resolveCostGroupPageRange({
   period: CostPeriod;
   runPageRange: CostPageDateRange | undefined;
 }): CostPageDateRange | undefined {
-  if (
-    embedded &&
-    globalDateRange === undefined &&
-    period === defaultCostPeriod &&
-    !hasLocalCostFilters
-  )
-    return undefined;
+  // The visible host period owns the range. Metadata filters never change it.
+  if (embedded && globalDateRange === undefined && period === defaultCostPeriod) return undefined;
   return runPageRange;
 }