@zaip-ai/cli 2.2.0 → 3.0.0

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

@@ -1,10 +1,5 @@
-import {
-  DataTable,
-  formatCompactNumber,
-  formatCurrency,
-  formatDurationMs,
-} from "@zaip-ai/dashboard-ui";
-import type { CostGroupRow, CostRunRow, DurationCoverage } from "../contracts.js";
+import { DataTable } from "@zaip-ai/dashboard-ui";
+import type { CostRunRow } from "../contracts.js";
 import { invocationMetricDescription } from "./CostTableDisplay.js";
 import { MoreVerticalIcon } from "./CostTableIcons.js";
 import { type CostRunPagination, CostRunServerPagination } from "./CostTableLoading.js";
@@ -16,21 +11,13 @@ import {
   sumNumbers,
 } from "./cost-table-metrics.js";
 import {
-  costGroupsScrollLabel,
-  costPeriodTotalAriaLabel,
   costRunsDurationTotal,
   costRunsScrollLabel,
-  formatBrlRate,
-  formatCostPeriodLabel,
   formatDateTime,
-  formatMultiplierPair,
-  formatRate,
   formatReasoningEffort,
   formatServiceTier,
-  formatUsd,
   isCompactRunColumnVisible,
 } from "./cost-table-presentation.js";
-import type { CostGroupTotals } from "./use-cost-group-page.js";
 
 export {
   type CostDeveloperAttributionRow,
@@ -64,110 +51,32 @@ export {
   isCompactRunColumnVisible,
 } from "./cost-table-presentation.js";
 
-export function displayCostGroupLabel(label: string, locale: CostLocale): string {
-  const normalized = label.trim().toLowerCase();
-  return normalized.length === 0 || normalized === "unknown"
-    ? locale === "pt-BR"
-      ? "Sem modelo/provedor atribuído"
-      : "No model/provider assigned"
-    : label;
-}
-
-export function formatAuditableNumber(value: number | null, locale: CostLocale): string {
-  return new Intl.NumberFormat(locale, { maximumFractionDigits: 0 }).format(value ?? 0);
-}
-
-function formatFactualCount(value: number | null, locale: CostLocale): string {
-  return value === null
-    ? locale === "pt-BR"
-      ? "Indisponível"
-      : "Unavailable"
-    : formatAuditableNumber(value, locale);
-}
-
-export function formatAuditableCompactNumber(value: number | null, locale: CostLocale): string {
-  return formatCompactNumber(value ?? 0, locale);
-}
-
-export function formatAuditableCurrency(
-  value: number | null,
-  currency: CostCurrency,
-  locale: CostLocale,
-): string {
-  if (value === null) return locale === "pt-BR" ? "Indispon\u00edvel" : "Unavailable";
-  return formatCurrency(value, currency, locale);
-}
-
-export function formatAuditableDuration(value: number | null, locale: CostLocale): string {
-  if (value === null) return locale === "pt-BR" ? "Indisponível" : "Unavailable";
-  return value === 0 ? "0" : formatDurationMs(value, locale);
-}
-
-const formatInvocationNumber = (value: number | null, locale: CostLocale) =>
-  formatAuditableNumber(value, locale);
-const formatInvocationCurrency = (
-  value: number | null,
-  currency: CostCurrency,
-  locale: CostLocale,
-) => formatAuditableCurrency(value, currency, locale);
-const formatInvocationDuration = (value: number | null, locale: CostLocale) =>
-  formatAuditableDuration(value, locale);
-const formatInvocationRate = (value: number | null, locale: CostLocale) =>
-  formatRate(value, locale);
-const formatInvocationUsd = (value: number | null, locale: CostLocale) => formatUsd(value, locale);
-const formatInvocationBrlRate = (value: number | null, locale: CostLocale) =>
-  formatBrlRate(value, locale);
-const formatInvocationMultiplierPair = (
-  input: number | null,
-  output: number | null,
-  locale: CostLocale,
-) => formatMultiplierPair(input, output, locale);
-
-export function formatDurationCoverage(value: DurationCoverage, locale: CostLocale): string {
-  // `known_sum` is a factual elapsed-time observation even when another
-  // activity in the population is unavailable.  Keep completeness and the
-  // unknown count as coverage metadata; hiding the known portion would turn a
-  // true observation into an indistinguishable absence.
-  if (value.known_sum <= 0 && !value.complete)
-    return locale === "pt-BR" ? "Indisponível" : "Unavailable";
-  return value.known_sum <= 0 ? "0" : formatDurationMs(value.known_sum, locale);
-}
-
-export function hasKnownDuration(value: DurationCoverage): boolean {
-  return value.known_sum > 0 || value.coverage_ratio > 0;
-}
-
-export function formatTokenBackedDuration(
-  value: DurationCoverage,
-  _totalTokens: number | null,
-  locale: CostLocale,
-): string {
-  // Token presence is a financial observation, not evidence of elapsed time.
-  return formatDurationCoverage(value, locale);
-}
-
-export function costRunsFooterLabel(locale: CostLocale, pageOnly: boolean): string {
-  if (!pageOnly) return locale === "pt-BR" ? "Total" : "Total";
-  return locale === "pt-BR" ? "Subtotal da página" : "Page subtotal";
-}
-
-/** Keeps table ordering tied to the raw monetary value, not its localized label. */
-export function sortCostValue(
-  currency: CostCurrency,
-  brl: number | null,
-  usd: number | null,
-): number | null {
-  return currency === "BRL" ? brl : usd;
-}
+import {
+  costRunsFooterLabel,
+  formatInvocationBrlRate,
+  formatInvocationCurrency,
+  formatInvocationDuration,
+  formatInvocationMultiplierPair,
+  formatInvocationNumber,
+  formatInvocationRate,
+  formatInvocationUsd,
+  runOriginBadge,
+  sortCostValue,
+} from "./cost-table-formatters.js";
 
-export function runOriginBadge(row: Pick<CostRunRow, "prd_id" | "spec_id" | "task_id">): {
-  label: "PRD" | "SPEC" | "Tarefa avulsa";
-  tone: "prd" | "spec" | "task";
-} {
-  if (row.prd_id !== null) return { label: "PRD", tone: "prd" };
-  if (row.spec_id !== null) return { label: "SPEC", tone: "spec" };
-  return { label: "Tarefa avulsa", tone: "task" };
-}
+export {
+  costRunsFooterLabel,
+  displayCostGroupLabel,
+  formatAuditableCompactNumber,
+  formatAuditableCurrency,
+  formatAuditableDuration,
+  formatAuditableNumber,
+  formatDurationCoverage,
+  formatTokenBackedDuration,
+  hasKnownDuration,
+  runOriginBadge,
+  sortCostValue,
+} from "./cost-table-formatters.js";
 
 export function CostRunsTable({
   rows,
@@ -503,399 +412,14 @@ function inclusiveTokenTotal(
     : row.total_tokens;
 }
 
-function costPeriodHeading(period: "daily" | "monthly" | "annual", locale: CostLocale): string {
+export function costPeriodHeading(
+  period: "daily" | "monthly" | "annual",
+  locale: CostLocale,
+): string {
   if (locale === "en-US") {
     return period === "daily" ? "Day" : period === "monthly" ? "Month" : "Year";
   }
   return period === "daily" ? "Dia" : period === "monthly" ? "Mês" : "Ano";
 }
 
-export function CostGroupsTable({
-  rows,
-  currency,
-  locale,
-  onOpenTrace,
-  period,
-  showDateTime = true,
-  showAgentIdentity = false,
-  showInvocationTasks = false,
-  showModelLifecycleDetails = false,
-  dateHeading,
-  labelHeading,
-  totals: suppliedTotals,
-  loading = false,
-}: {
-  rows: readonly CostGroupRow[];
-  currency: CostCurrency;
-  locale: CostLocale;
-  onOpenTrace?: (taskId: string) => void;
-  period?: "daily" | "monthly" | "annual";
-  showDateTime?: boolean;
-  showAgentIdentity?: boolean;
-  showInvocationTasks?: boolean;
-  showModelLifecycleDetails?: boolean;
-  dateHeading?: string;
-  labelHeading?: string;
-  totals?: CostGroupTotals;
-  loading?: boolean;
-}) {
-  const displayCount = (value: number | null) =>
-    formatFactualCount(
-      showAgentIdentity || showModelLifecycleDetails ? (value ?? 0) : value,
-      locale,
-    );
-  const displayDuration = (value: DurationCoverage) =>
-    (showAgentIdentity || showModelLifecycleDetails) && value.known_sum <= 0
-      ? "0"
-      : formatDurationCoverage(value, locale);
-  const displayCurrency = (value: number | null) =>
-    formatAuditableCurrency(
-      showAgentIdentity || showModelLifecycleDetails ? (value ?? 0) : value,
-      currency,
-      locale,
-    );
-  const conversationCount = (row: unknown): number | null =>
-    (row as { conversation_count?: number | null }).conversation_count ?? null;
-  const pageTotals = {
-    runs: rows.reduce((sum, row) => sum + row.run_count, 0),
-    tasks: sumNumbers(rows.map((row) => row.task_count)),
-    prds: sumNumbers(rows.map((row) => row.prd_count)),
-    specs: sumNumbers(rows.map((row) => row.spec_count)),
-    evidences: sumNumbers(rows.map((row) => row.evidence_count)),
-    tests: sumNumbers(rows.map((row) => row.test_count)),
-    conversations: sumNumbers(rows.map(conversationCount)),
-    durationKnownMs: rows.reduce((sum, row) => sum + row.duration.known_sum, 0),
-    durationPartial: rows.some((row) => !row.duration.complete),
-    tokens: sumNumbers(rows.map((row) => row.total_tokens)),
-    usd: sumNumbers(rows.map((row) => row.estimated_usd)),
-    brl: sumNumbers(rows.map((row) => row.estimated_brl)),
-  };
-  const totals =
-    suppliedTotals === undefined
-      ? pageTotals
-      : {
-          runs: suppliedTotals.run_count,
-          tasks: suppliedTotals.task_count,
-          prds: suppliedTotals.prd_count,
-          specs: suppliedTotals.spec_count,
-          evidences: suppliedTotals.evidence_count,
-          tests: suppliedTotals.test_count,
-          conversations: conversationCount(suppliedTotals) ?? pageTotals.conversations,
-          durationKnownMs: suppliedTotals.duration.known_sum,
-          durationPartial: !suppliedTotals.duration.complete,
-          tokens: suppliedTotals.total_tokens,
-          usd: suppliedTotals.estimated_usd,
-          brl: suppliedTotals.estimated_brl,
-        };
-  const totalDurationDisplay = displayDuration(
-    suppliedTotals?.duration ?? {
-      known_sum: totals.durationKnownMs,
-      unknown: totals.durationPartial ? 1 : 0,
-      complete: !totals.durationPartial,
-      // Group-level coverage is intentionally preserved separately from the
-      // factual known sum. Individual rows retain their original provenance.
-      coverage_ratio: totals.durationPartial ? 0 : 1,
-    },
-  );
-  const totalTokensDisplay = formatAuditableCompactNumber(
-    showModelLifecycleDetails ? (totals.tokens ?? 0) : totals.tokens,
-    locale,
-  );
-  const totalCostDisplay = displayCurrency(currency === "BRL" ? totals.brl : totals.usd);
-  const totalAriaLabel = costPeriodTotalAriaLabel({
-    locale,
-    duration: totalDurationDisplay,
-    tokens: totalTokensDisplay,
-    cost: totalCostDisplay,
-    currency,
-  });
-  const totalLabel = locale === "pt-BR" ? "Total geral" : "Grand total";
-  return (
-    <DataTable
-      columns={[
-        {
-          key: "latestStartedAt",
-          label: dateHeading ?? (locale === "pt-BR" ? "Data e hora" : "Date and time"),
-          render: (row) => formatDateTime(row.latest_started_at, locale),
-          hidden: !showDateTime,
-          footer: showDateTime ? <output aria-label={totalLabel}>Total</output> : undefined,
-        },
-        ...(showAgentIdentity
-          ? [
-              {
-                key: "persona",
-                label: locale === "pt-BR" ? "Persona" : "Persona",
-                render: (row: CostGroupRow) => row.persona ?? "",
-              },
-              {
-                key: "job",
-                label: locale === "pt-BR" ? "Cargo" : "Job",
-                render: (row: CostGroupRow) => row.job ?? "",
-              },
-            ]
-          : []),
-        {
-          key: "label",
-          label:
-            period === undefined
-              ? (labelHeading ?? (locale === "pt-BR" ? "Grupo" : "Group"))
-              : costPeriodHeading(period, locale),
-          render: (row) => {
-            if (period !== undefined) {
-              return <strong>{formatCostPeriodLabel(row.key, period, locale)}</strong>;
-            }
-            const displayLabel = displayCostGroupLabel(row.label, locale);
-            const unavailableLabel = displayLabel !== row.label;
-            return (
-              <>
-                <strong>{displayLabel}</strong>
-                {unavailableLabel || row.key === row.label ? null : <small>{row.key}</small>}
-              </>
-            );
-          },
-          sortValue: (row) => row.key,
-          footer: showDateTime ? undefined : <output aria-label={totalLabel}>Total</output>,
-        },
-        ...(period === undefined && !showAgentIdentity && !showModelLifecycleDetails
-          ? [
-              {
-                key: "runs",
-                label: locale === "pt-BR" ? "Invocações" : "Agent invocations",
-                render: (row: CostGroupRow) => row.run_count,
-                align: "right" as const,
-                footer: totals.runs,
-              },
-              ...(showAgentIdentity
-                ? []
-                : [
-                    {
-                      key: "tasks",
-                      label:
-                        showAgentIdentity || showInvocationTasks
-                          ? locale === "pt-BR"
-                            ? "Tarefas com invocação"
-                            : "Tasks with invocations"
-                          : locale === "pt-BR"
-                            ? "Tarefas criadas"
-                            : "Tasks created",
-                      render: (row: CostGroupRow) => row.task_count ?? 0,
-                      align: "right" as const,
-                      footer: totals.tasks,
-                    },
-                  ]),
-            ]
-          : [
-              {
-                key: "prds",
-                label: "PRDs",
-                render: (row: CostGroupRow) => displayCount(row.prd_count),
-                sortValue: (row: CostGroupRow) => row.prd_count ?? 0,
-                align: "right" as const,
-                footer: displayCount(totals.prds),
-                description: localizedDescription(
-                  locale,
-                  showAgentIdentity
-                    ? "PRDs com criação atribuída ao agente por Run registrado. Conta apenas vínculos observados, sem duplicar IDs."
-                    : "PRDs criados por vínculo canônico com um único modelo financeiro observado. Sem essa prova, o indicador exibido é 0.",
-                  "PRDs created through a canonical link to one observed financial model. Without that evidence, the displayed indicator is 0.",
-                ),
-              },
-              {
-                key: "specs",
-                label: "SPECs",
-                render: (row: CostGroupRow) => displayCount(row.spec_count),
-                sortValue: (row: CostGroupRow) => row.spec_count ?? 0,
-                align: "right" as const,
-                footer: displayCount(totals.specs),
-                description: localizedDescription(
-                  locale,
-                  showAgentIdentity
-                    ? "SPECs com criação atribuída ao agente por Run registrado. Conta apenas vínculos observados, sem duplicar IDs."
-                    : "SPECs criadas por vínculo canônico com um único modelo financeiro observado. Sem essa prova, o indicador exibido é 0.",
-                  "SPECs created through a canonical link to one observed financial model. Without that evidence, the displayed indicator is 0.",
-                ),
-              },
-              {
-                key: "tasks",
-                label: showAgentIdentity
-                  ? locale === "pt-BR"
-                    ? "Tarefas"
-                    : "Tasks"
-                  : showModelLifecycleDetails
-                    ? "Tasks"
-                    : locale === "pt-BR"
-                      ? "Tarefas criadas"
-                      : "Tasks created",
-                render: (row: CostGroupRow) => displayCount(row.task_count),
-                sortValue: (row: CostGroupRow) => row.task_count ?? 0,
-                align: "right" as const,
-                footer: displayCount(totals.tasks),
-                description: localizedDescription(
-                  locale,
-                  showAgentIdentity
-                    ? "Tasks distintas em que o agente participou no período. Uma Task pode contar em vários agentes; o total soma essas participações entre agentes. Sem participação, mostra 0."
-                    : "Tasks contam apenas quando creation_run_id tem um único modelo financeiro observável. Participação posterior não é criação; ausência ou multi-modelo exibe 0.",
-                  "Tasks count only when creation_run_id has one observed financial model. Later participation is not creation; missing or multi-model linkage displays 0.",
-                ),
-              },
-              ...(showModelLifecycleDetails
-                ? [
-                    {
-                      key: "conversations",
-                      label: "Conversations",
-                      render: (row: CostGroupRow) => displayCount(conversationCount(row)),
-                      sortValue: (row: CostGroupRow) => conversationCount(row) ?? 0,
-                      align: "right" as const,
-                      footer: displayCount(totals.conversations),
-                      description: localizedDescription(
-                        locale,
-                        "Conversas canônicas, incluindo turns unassisted legados. Cada ID conta uma vez por modelo; um modelo múltiplo pode repetir. Run com Task e conversa de origem não cria Task adicional.",
-                        "Canonical conversations, including legacy unassisted turns. Each ID counts once per model; a multi-model conversation may repeat. A Run with a Task and source conversation does not create an additional Task.",
-                      ),
-                    },
-                  ]
-                : []),
-              {
-                key: "runs",
-                label: "Runs",
-                render: (row: CostGroupRow) => row.run_count,
-                sortValue: (row: CostGroupRow) => row.run_count,
-                align: "right" as const,
-                footer: totals.runs,
-                description: localizedDescription(
-                  locale,
-                  showAgentIdentity
-                    ? "Chamadas observadas atribuídas ao agente no período selecionado."
-                    : "Runs financeiros observados neste modelo, sem distribuir ou duplicar custo, tokens e tempo entre modelos.",
-                  "Observed financial Runs for this model, without allocating or duplicating cost, tokens, or time across models.",
-                ),
-              },
-              {
-                key: "tests",
-                label: locale === "pt-BR" ? "Testes" : "Tests",
-                render: (row: CostGroupRow) => displayCount(row.test_count),
-                sortValue: (row: CostGroupRow) => row.test_count ?? 0,
-                align: "right" as const,
-                footer: displayCount(totals.tests),
-                description: localizedDescription(
-                  locale,
-                  showAgentIdentity
-                    ? "Registros de testes distintos vinculados ao Run do agente no período. Revisões e outras validações não são contadas como testes."
-                    : "Validações canônicas cuja artifact_run_id coincide com a Run registradora deste modelo; ausência de prova exibe 0.",
-                  "Canonical validations whose artifact_run_id matches this model's registering Run; missing evidence displays 0.",
-                ),
-              },
-              {
-                key: "evidences",
-                label: locale === "pt-BR" ? "Evidências" : "Evidence",
-                render: (row: CostGroupRow) => displayCount(row.evidence_count),
-                sortValue: (row: CostGroupRow) => row.evidence_count ?? 0,
-                align: "right" as const,
-                footer: displayCount(totals.evidences),
-                description: localizedDescription(
-                  locale,
-                  showAgentIdentity
-                    ? "Evidências distintas vinculadas ao Run do agente no período. Conta apenas vínculos registrados."
-                    : "Evidências canônicas cuja artifact_run_id coincide com a Run registradora deste modelo; o total não duplica a mesma evidência. Sem prova, exibe 0.",
-                  "Canonical evidence whose artifact_run_id matches this model's registering Run; the total does not duplicate the same evidence. Missing proof displays 0.",
-                ),
-              },
-            ]),
-        {
-          key: "duration",
-          label: "Tempo",
-          render: (row) => displayDuration(row.duration),
-          sortValue: (row) =>
-            hasKnownDuration(row.duration)
-              ? row.duration.known_sum
-              : showModelLifecycleDetails
-                ? 0
-                : null,
-          align: "right",
-          footer: <output aria-label={totalAriaLabel}>{totalDurationDisplay}</output>,
-        },
-        {
-          key: "tokens",
-          label: "Tokens",
-          render: (row) =>
-            formatAuditableCompactNumber(
-              showModelLifecycleDetails ? (row.total_tokens ?? 0) : row.total_tokens,
-              locale,
-            ),
-          sortValue: (row) =>
-            showModelLifecycleDetails ? (row.total_tokens ?? 0) : row.total_tokens,
-          align: "right",
-          footer: <output aria-label={totalAriaLabel}>{totalTokensDisplay}</output>,
-        },
-        {
-          key: "cost",
-          label:
-            showAgentIdentity || showModelLifecycleDetails || period !== undefined
-              ? locale === "pt-BR"
-                ? "Custos"
-                : "Costs"
-              : period === undefined
-                ? locale === "pt-BR"
-                  ? "Custo"
-                  : "Cost"
-                : locale === "pt-BR"
-                  ? "Custos"
-                  : "Costs",
-          render: (row) =>
-            displayCurrency(currency === "BRL" ? row.estimated_brl : row.estimated_usd),
-          sortValue: (row) =>
-            showModelLifecycleDetails
-              ? (sortCostValue(currency, row.estimated_brl, row.estimated_usd) ?? 0)
-              : sortCostValue(currency, row.estimated_brl, row.estimated_usd),
-          align: "right",
-          footer: <output aria-label={totalAriaLabel}>{totalCostDisplay}</output>,
-        },
-        ...(onOpenTrace
-          ? [
-              {
-                key: "trace",
-                label: "",
-                render: (row: CostGroupRow) => (
-                  <button
-                    aria-label="Abrir detalhes"
-                    className="cost-row-action"
-                    onClick={(event) => {
-                      event.stopPropagation();
-                      onOpenTrace(row.key);
-                    }}
-                    type="button"
-                  >
-                    <MoreVerticalIcon />
-                  </button>
-                ),
-              },
-            ]
-          : []),
-      ]}
-      defaultSort={
-        showAgentIdentity
-          ? { key: "cost", direction: "desc" }
-          : period === undefined
-            ? null
-            : { key: "label", direction: "desc" }
-      }
-      locale={locale}
-      emptyMessage={
-        loading
-          ? locale === "pt-BR"
-            ? "Carregando…"
-            : "Loading…"
-          : locale === "pt-BR"
-            ? "Nenhum dado disponível."
-            : "No data available."
-      }
-      pageSize={100}
-      rowKey={(row) => row.key}
-      onRowClick={onOpenTrace === undefined ? undefined : (row) => onOpenTrace(row.key)}
-      rows={rows}
-      scrollLabel={costGroupsScrollLabel(locale)}
-      showColumnInfo
-      sortable
-    />
-  );
-}
+export { CostGroupsTable } from "./CostGroupsTable.js";

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

@@ -0,0 +1,74 @@
+import { loadCostDeveloperAttribution } from "./CostDeveloperAttributionPanel.js";
+
+export function buildCostMonitorExportSources(context: Record<string, any>) {
+  const { developerAttributionRange, filters, globalFilters, groupPageRange, loadGroupPage, view } =
+    context;
+  // The developer table is paginated only by the DataTable in the browser.
+  // Its API response is the full attributed population, so export from the
+  // same endpoint and exact active period instead of the visible ten rows.
+  const developerExportSource =
+    view === "developers"
+      ? {
+          prepare: async () => {
+            const developerRows = await loadCostDeveloperAttribution({
+              ...(developerAttributionRange === undefined ? {} : developerAttributionRange),
+            });
+            return {
+              totalRows: developerRows.length,
+              pages: async function* () {
+                yield developerRows as readonly Record<string, unknown>[];
+              },
+            };
+          },
+        }
+      : undefined;
+  // Period views are paginated SQLite projections too.  Exporting their
+  // already-rendered group rows truncates the workbook to the visible page
+  // (and can lose the projection's factual duration).  Capture the same
+  // paged query used by the table so an All Time selection keeps its unbound
+  // range and every other selection retains its exact range and filters.
+  const costGroupExportSource =
+    (view === "daily" ||
+      view === "monthly" ||
+      view === "annual" ||
+      view === "agents" ||
+      view === "models" ||
+      view === "providers") &&
+    loadGroupPage !== undefined
+      ? {
+          prepare: async () => {
+            const query = filters.query || globalFilters?.query || "";
+            const firstPage = await loadGroupPage({
+              view,
+              offset: 0,
+              limit: 50,
+              filters,
+              ...(query ? { query } : {}),
+              ...(groupPageRange === undefined ? {} : groupPageRange),
+            });
+            return {
+              totalRows: firstPage.total_count,
+              pages: async function* () {
+                let page = firstPage;
+                while (true) {
+                  if (page.rows.length === 0) return;
+                  yield page.rows as unknown as readonly Record<string, unknown>[];
+                  const nextOffset = page.offset + page.rows.length;
+                  if (nextOffset >= page.total_count || !page.has_more) return;
+                  page = await loadGroupPage({
+                    view,
+                    offset: nextOffset,
+                    limit: page.limit,
+                    filters,
+                    ...(query ? { query } : {}),
+                    ...(groupPageRange === undefined ? {} : groupPageRange),
+                  });
+                }
+              },
+            };
+          },
+        }
+      : undefined;
+
+  return { developerExportSource, costGroupExportSource };
+}

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

@@ -0,0 +1,19 @@
+import type { RunProjection } from "@zaip-ai/dashboard-operations/contracts";
+import { type CostCurrency, type CostLocale, localeCurrency } from "./cost-monitor-copy.js";
+import { findRunDetails } from "./cost-monitor-page-helpers.js";
+export function changeCostLocale(
+  next: CostLocale,
+  onLocaleChange: (value: CostLocale) => void,
+  setCurrency: (value: CostCurrency) => void,
+) {
+  onLocaleChange(next);
+  setCurrency(localeCurrency(next));
+}
+export function openCostRunDetails(
+  runId: string,
+  runs: readonly RunProjection[],
+  setSelectedRun: (run: RunProjection) => void,
+) {
+  const run = findRunDetails(runs, runId);
+  if (run) setSelectedRun(run);
+}