@zaip-ai/cli 1.0.7 → 1.0.8

package/templates/.agents/dashboard/apps/frontend/src/use-app-cost-loaders.ts

@@ -0,0 +1,190 @@
+import type {
+  LoadCompactCostPage,
+  CompactLifecycleCostPage,
+  LoadCostMonitorDetail,
+  LoadCostRunPage,
+} from "@zaip-ai/dashboard-cost-monitor/react";
+import { useCallback } from "react";
+import type { CostMonitorProjection } from "@zaip-ai/dashboard-cost-monitor/contracts";
+export type LoadCostGroupPage = import("@zaip-ai/dashboard-cost-monitor/react").LoadCostGroupPage;
+import type { DashboardApiClient, SqliteViewPage } from "./dashboard-api.js";
+import { costGroupDuration, legacyKnownMetric, nullableSqlNumber, requiredSqlNumber } from "./sqlite-cost-adapters.js";
+
+type CostGroupLoadRequest = Parameters<LoadCostGroupPage>[0];
+
+function costGroupQueryOptions(request: CostGroupLoadRequest, offset: number, limit: number) {
+  const { filters, query } = request;
+  return { offset, limit, ...(query === undefined || query === "" ? {} : { query }), ...(filters.provider ? { provider: filters.provider } : {}), ...(filters.model ? { model: filters.model } : {}), ...(filters.agent ? { agent: filters.agent } : {}), ...(filters.phase ? { phase: filters.phase } : {}), ...(filters.status ? { status: filters.status } : {}), ...(filters.origin ? { origin: filters.origin } : {}), ...(filters.workType ? { workType: filters.workType } : {}), ...(filters.priority ? { priority: filters.priority } : {}), ...(filters.risk ? { risk: filters.risk } : {}) };
+}
+
+function adaptSqliteCostGroup(row: Record<string, unknown>) {
+  const duration = costGroupDuration(row);
+  const durationUnknown = Number(row.duration_unknown ?? (duration === null ? 1 : 0));
+  const durationKnown = nullableSqlNumber(row.duration_known) ?? duration ?? 0;
+  return { key: String(row.key ?? row.period_key ?? "total"), label: String(row.label ?? row.key ?? row.period_key ?? ""), latest_started_at: typeof row.latest_started_at === "string" ? row.latest_started_at : "", persona: typeof row.persona === "string" ? row.persona : null, job: typeof row.job === "string" ? row.job : null, run_count: Number(row.total_run_count ?? row.invocation_count ?? 0), task_count: nullableSqlNumber(row.task_count), prd_count: Number(row.prd_count ?? 0), spec_count: Number(row.spec_count ?? 0), evidence_count: Number(row.evidence_count ?? 0), test_count: Number(row.validation_count ?? 0), event_count: Number(row.source_event_count ?? 0), total_tokens: nullableSqlNumber(row.total_tokens), estimated_usd: nullableSqlNumber(row.total_cost_usd), estimated_brl: nullableSqlNumber(row.total_cost_brl), duration_ms: duration, duration: { known_sum: durationKnown, unknown: durationUnknown, complete: durationUnknown === 0, coverage_ratio: durationUnknown === 0 ? 1 : 0 }, coverage: { events: 0, tokens: 0, usd: 0, brl: 0 } };
+}
+
+export async function loadSqliteCostGroupPage(api: DashboardApiClient, request: CostGroupLoadRequest) {
+  const { from, limit, offset, signal, to, view } = request;
+  const selectedRange = from === undefined || to === undefined ? undefined : { from, to };
+  if (view === "daily") {
+    const page = await api.sqliteViewPage("cost_monitor_daily", selectedRange, costGroupQueryOptions(request, offset, limit), signal);
+    return { offset: page.offset, limit: page.limit, total_count: page.total_count, has_more: page.has_more, rows: page.rows.map(adaptSqliteCostGroup), ...(page.totals === undefined ? {} : { totals: adaptSqliteCostGroup(page.totals) }) };
+  }
+  const sqlView = ({ monthly: "cost_monitor_monthly", annual: "cost_monitor_annual", agents: "cost_monitor_zaip_agents", models: "cost_monitor_models", providers: "cost_monitor_providers" } as const)[view];
+  const page = await api.sqliteViewPage(sqlView, selectedRange, costGroupQueryOptions(request, offset, limit), signal);
+  return { offset: page.offset, limit: page.limit, total_count: page.total_count, has_more: page.has_more, rows: page.rows.map(adaptSqliteCostGroup), ...(page.totals === undefined ? {} : { totals: adaptSqliteCostGroup(page.totals) }) };
+}
+
+/** Adapts a sparse SQLite invocation row to the complete CostRunRow contract. */
+export function adaptSqliteCostRun(row: Record<string, unknown>): CostMonitorProjection["runs"][number] {
+  const text = (value: unknown, fallback: string) => (typeof value === "string" ? value : fallback);
+  const nullableNumber = (value: unknown) => (typeof value === "number" ? value : null);
+  const invocationId = text(row.agent_invocation_id, "unavailable");
+  const taskId = typeof row.task_id === "string" ? row.task_id : null;
+  const specId = typeof row.spec_id === "string" ? row.spec_id : null;
+  const prdId = typeof row.prd_id === "string" ? row.prd_id : null;
+  const phase = text(row.phase, "execution");
+  const durationProvenance =
+    row.duration_provenance === "observed" || row.duration_provenance === "reconciled" ||
+    row.duration_provenance === "estimated" || row.duration_provenance === "legacy_inferred"
+      ? row.duration_provenance
+      : "unavailable";
+  const calculatedUsd = Object.hasOwn(row, "calculated_cost_usd")
+    ? nullableNumber(row.calculated_cost_usd)
+    : nullableNumber(row.cost_usd);
+  const currentFxRate = nullableNumber(row.current_fx_rate) ?? nullableNumber(row.fx_rate);
+  const recordedUsd = nullableNumber(row.recorded_cost_usd) ?? nullableNumber(row.recorded_usd);
+  const recordedFxRate = Object.hasOwn(row, "recorded_fx_rate")
+    ? nullableNumber(row.recorded_fx_rate)
+    : nullableNumber(row.fx_rate);
+  const recordedBrl =
+    nullableNumber(row.recorded_brl) ??
+    (!Object.hasOwn(row, "recorded_brl") && recordedUsd !== null
+      ? nullableNumber(row.cost_brl)
+      : null);
+  const currentBrl =
+    calculatedUsd !== null && currentFxRate !== null
+      ? Math.round(calculatedUsd * currentFxRate * 1_000_000) / 1_000_000
+      : null;
+  return {
+    run_id: invocationId,
+    execution_id: typeof row.execution_id === "string" ? row.execution_id : null,
+    conversation_id: text(row.run_id, invocationId),
+    task_id: taskId,
+    // A missing relationship is an explicitly unscoped run, not unavailable telemetry.
+    task_title: text(row.task_title, taskId ?? "Tarefa avulsa"),
+    task_status: text(row.task_status, "unavailable"),
+    priority: text(row.priority, "unavailable"),
+    risk: text(row.risk, "unavailable"),
+    spec_id: specId,
+    prd_id: prdId,
+    change_id: typeof row.change_id === "string" ? row.change_id : null,
+    parent_run_id: typeof row.parent_agent_invocation_id === "string" ? row.parent_agent_invocation_id : null,
+    run_role: row.invocation_kind === "subagent" ? "subagent" : "orchestrator",
+    run_kind: row.run_kind === "subrun" ? "subrun" : "run",
+    run_purpose: "execution",
+    requires_finalizer: false,
+    client: text(row.client, "unavailable"),
+    agent: text(row.zaip_agent, "unavailable"),
+    agent_name: text(row.zaip_agent, "unavailable"),
+    provider: typeof row.provider === "string" ? row.provider : null,
+    model: text(row.model, "unavailable"),
+    requested_model: text(row.requested_model, "unavailable"),
+    reasoning_effort: typeof row.reasoning_effort === "string" ? row.reasoning_effort : null,
+    effective_reasoning_effort: typeof row.effective_reasoning_effort === "string" ? row.effective_reasoning_effort : null,
+    service_tier: typeof row.service_tier === "string" ? row.service_tier : null,
+    call_count: nullableNumber(row.llm_call_count),
+    status: text(row.status, "completed"),
+    phase,
+    origin: prdId !== null ? "prd" : specId !== null ? "spec" : taskId !== null ? "task" : "conversation",
+    work_type: row.work_type === "rework" ? "rework" : "new",
+    started_at: text(row.occurred_at, ""),
+    finished_at: typeof row.finished_at === "string" ? row.finished_at : null,
+    duration_ms: nullableNumber(row.duration_ms),
+    duration_provenance: durationProvenance,
+    estimation_basis: typeof row.estimation_basis === "string" ? row.estimation_basis : null,
+    source_started_at: typeof row.source_started_at === "string" ? row.source_started_at : null,
+    source_finished_at: typeof row.source_finished_at === "string" ? row.source_finished_at : null,
+    capture_lag_ms: nullableNumber(row.capture_lag_ms),
+    event_count: nullableNumber(row.source_event_count),
+    input_tokens: nullableNumber(row.input_tokens),
+    cached_input_tokens: nullableNumber(row.cached_input_tokens),
+    output_tokens: nullableNumber(row.output_tokens),
+    reasoning_tokens: nullableNumber(row.reasoning_tokens),
+    total_tokens: nullableNumber(row.total_tokens),
+    uncached_input_tokens: nullableNumber(row.uncached_input_tokens),
+    visible_output_tokens: nullableNumber(row.visible_output_tokens),
+    input_rate_usd_per_million: nullableNumber(row.input_rate_usd_per_million),
+    cached_input_rate_usd_per_million: nullableNumber(row.cached_input_rate_usd_per_million),
+    output_rate_usd_per_million: nullableNumber(row.output_rate_usd_per_million),
+    reasoning_rate_usd_per_million: nullableNumber(row.reasoning_rate_usd_per_million),
+    context_input_multiplier: nullableNumber(row.context_input_multiplier),
+    context_output_multiplier: nullableNumber(row.context_output_multiplier),
+    speed_cost_multiplier: nullableNumber(row.speed_cost_multiplier),
+    standard_cost_usd: nullableNumber(row.standard_cost_usd),
+    speed_uplift_usd: nullableNumber(row.speed_uplift_usd),
+    input_cost_usd: nullableNumber(row.input_cost_usd),
+    cached_input_cost_usd: nullableNumber(row.cached_input_cost_usd),
+    output_cost_usd: nullableNumber(row.output_cost_usd),
+    reasoning_cost_usd: nullableNumber(row.reasoning_cost_usd),
+    fx_rate: currentFxRate,
+    estimated_usd: calculatedUsd,
+    estimated_brl: currentBrl,
+    recorded_usd: recordedUsd,
+    recorded_brl: recordedBrl,
+    recorded_fx_rate: recordedFxRate,
+    coverage: { events: 0, tokens: 0, usd: 0, brl: 0 },
+    artifact_path: `.agents/records/runs/${invocationId}`,
+  };
+}
+
+export function adaptSqliteCompactLifecyclePage(
+  kind: CompactLifecycleCostPage["kind"],
+  page: SqliteViewPage,
+): CompactLifecycleCostPage {
+  const totals = page.totals;
+  const subtotalMetric = (key: string) => legacyKnownMetric(totals?.[key]);
+  return {
+    data_source: "lifecycle_daily_read_models", snapshot_id: null, source_latest_at: null, kind, offset: page.offset, limit: page.limit, total: page.total_count, has_more: page.has_more, next_cursor: null,
+    subtotal: {
+      entity_count: typeof totals?.entity_count === "number" ? totals.entity_count : page.total_count,
+      run_count: subtotalMetric("invocation_count"),
+      metrics: {
+        duration: subtotalMetric("total_duration"),
+        total_tokens: subtotalMetric("total_tokens"),
+        cost_brl: subtotalMetric("total_cost_brl"),
+        cost_usd: subtotalMetric("total_cost_usd"),
+      },
+    },
+    rows: page.rows.map((row) => ({ id: String(row.task_id ?? row.spec_id ?? row.prd_id ?? row.execution_id ?? row.conversation_id ?? row.id ?? "unavailable"), title: String(row.title ?? row.task_id ?? row.spec_id ?? row.prd_id ?? row.execution_id ?? row.conversation_id ?? "Unavailable"), kind: kind === "tasks" ? "task" : kind === "specs" ? "spec" : kind === "prds" ? "prd" : kind === "executions" ? "execution" : "conversation", status: typeof row.status === "string" ? row.status : null, risk: typeof row.risk === "string" ? row.risk : null, occurred_at: typeof row.occurred_at === "string" ? row.occurred_at : typeof row.started_at === "string" ? row.started_at : typeof row.last_day === "string" ? `${row.last_day}T12:00:00.000Z` : "", parent_id: null, run_count: Number(row.invocation_count ?? 0), cost_currency: "BRL", metrics: { duration: legacyKnownMetric(row.total_duration), total_tokens: legacyKnownMetric(row.total_tokens), cost: legacyKnownMetric(row.total_cost_brl) } })),
+  };
+}
+
+export function useAppCostLoaders(api: DashboardApiClient) {
+  const loadCostDetail = useCallback<LoadCostMonitorDetail>(
+    async () => { throw new Error("SQLite Cost Monitor loads the selected paginated view; full detail is disabled."); },
+    [api],
+  );
+  const loadCostReadModelPage = useCallback<LoadCompactCostPage>(
+    async ({ filters, from, kind, limit, offset, query, signal, to }) => {
+      const view = ({ tasks: "cost_monitor_tasks", specs: "cost_monitor_specs", prds: "cost_monitor_prds", executions: "cost_monitor_executions", conversations: "cost_monitor_conversations" } as const)[kind];
+      const page = await api.sqliteViewPage(view, from === undefined || to === undefined ? undefined : { from, to }, { offset, limit, ...(query === undefined || query === "" ? {} : { query }), ...(filters.provider ? { provider: filters.provider } : {}), ...(filters.model ? { model: filters.model } : {}), ...(filters.agent ? { agent: filters.agent } : {}), ...(filters.phase ? { phase: filters.phase } : {}), ...(filters.status ? { status: filters.status } : {}), ...(filters.origin ? { origin: filters.origin } : {}), ...(filters.workType ? { workType: filters.workType } : {}), ...(filters.priority ? { priority: filters.priority } : {}), ...(filters.risk ? { risk: filters.risk } : {}) }, signal);
+      return adaptSqliteCompactLifecyclePage(kind, page);
+    },
+    [api],
+  );
+  const loadCostRunPage = useCallback<LoadCostRunPage>(
+    async ({ filters, from, offset, signal, to }) => {
+      const page = await api.sqliteViewPage("cost_monitor_agent_invocations", from === undefined || to === undefined ? undefined : { from, to }, { offset, limit: 100, ...(filters?.query ? { query: filters.query } : {}), ...(filters?.provider ? { provider: filters.provider } : {}), ...(filters?.model ? { model: filters.model } : {}), ...(filters?.agent ? { agent: filters.agent } : {}), ...(filters?.phase ? { phase: filters.phase } : {}), ...(filters?.status ? { status: filters.status } : {}) }, signal);
+      return {
+        page_only: true,
+        runs: page.rows.map(adaptSqliteCostRun),
+        run_page: { offset: page.offset, limit: page.limit, total: page.total_count, has_more: page.has_more },
+      };
+    },
+    [api],
+  );
+  const loadCostGroupPage = useCallback<LoadCostGroupPage>((request) => loadSqliteCostGroupPage(api, request), [api]);
+  return { loadCostDetail, loadCostReadModelPage, loadCostRunPage, loadCostGroupPage };
+}

package/templates/.agents/dashboard/apps/frontend/src/use-app-effects.ts

@@ -0,0 +1,121 @@
+import type { CostCurrency, CostLocale } from "@zaip-ai/dashboard-cost-monitor/react";
+import type { OperationsProjection } from "@zaip-ai/dashboard-operations/contracts";
+import { type Dispatch, type MutableRefObject, type SetStateAction, useEffect } from "react";
+import { pricingSetupPath, projectSetupPath } from "./AppSetupRoutes.js";
+import { currencyKey, localeKey } from "./app-preferences.js";
+import type { DashboardView } from "./DashboardCapabilityNav.js";
+import type { DashboardApiClient, PricingCatalog } from "./dashboard-api.js";
+import {
+  scheduleOperationsDetail,
+  shouldHydrateOperationsDetails,
+} from "./operations-detail-hydration.js";
+
+export function useAppEffects({
+  api,
+  costLocale,
+  currency,
+  dashboardView,
+  loadOperationsDetails,
+  operations,
+  operationsDetailAbortRef,
+  operationsDetailCancelRef,
+  operationsPageAbortRef,
+  pathname,
+  pricing,
+  refresh,
+  refreshVersion,
+  setError,
+  setFxRate,
+  setPathname,
+  setPricing,
+}: {
+  api: DashboardApiClient;
+  costLocale: CostLocale;
+  currency: CostCurrency;
+  dashboardView: DashboardView | null;
+  loadOperationsDetails: (signal?: AbortSignal) => Promise<OperationsProjection | null>;
+  operations: OperationsProjection | null;
+  operationsDetailAbortRef: MutableRefObject<AbortController | null>;
+  operationsDetailCancelRef: MutableRefObject<(() => void) | null>;
+  operationsPageAbortRef: MutableRefObject<AbortController | null>;
+  pathname: string;
+  pricing: PricingCatalog | null;
+  refresh: (visible?: boolean, reconcileOpenWork?: boolean) => Promise<void>;
+  refreshVersion: MutableRefObject<number>;
+  setError: Dispatch<SetStateAction<string | null>>;
+  setFxRate: Dispatch<SetStateAction<Awaited<ReturnType<DashboardApiClient["fxRate"]>> | null>>;
+  setPathname: Dispatch<SetStateAction<string>>;
+  setPricing: Dispatch<SetStateAction<PricingCatalog | null>>;
+}) {
+  useEffect(() => {
+    void refresh();
+    return () => {
+      operationsDetailCancelRef.current?.();
+      operationsDetailCancelRef.current = null;
+      operationsDetailAbortRef.current?.abort();
+      operationsDetailAbortRef.current = null;
+      operationsPageAbortRef.current?.abort();
+      operationsPageAbortRef.current = null;
+      ++refreshVersion.current;
+    };
+  }, [
+    operationsDetailAbortRef,
+    operationsDetailCancelRef,
+    operationsPageAbortRef,
+    refresh,
+    refreshVersion,
+  ]);
+
+  useEffect(() => {
+    if (
+      !shouldHydrateOperationsDetails(
+        dashboardView,
+        operations?.summary.overview_metrics?.partial === true,
+      )
+    )
+      return;
+    const cancel = scheduleOperationsDetail(async (signal) => {
+      await loadOperationsDetails(signal);
+    });
+    operationsDetailCancelRef.current = cancel;
+    return () => {
+      if (operationsDetailCancelRef.current === cancel) operationsDetailCancelRef.current = null;
+      cancel();
+    };
+  }, [
+    dashboardView,
+    loadOperationsDetails,
+    operations?.summary.overview_metrics?.partial,
+    operationsDetailCancelRef,
+  ]);
+
+  useEffect(() => window.localStorage.setItem(localeKey, costLocale), [costLocale]);
+  useEffect(() => window.localStorage.setItem(currencyKey, currency), [currency]);
+
+  useEffect(() => {
+    if (
+      !["/", pricingSetupPath, projectSetupPath].includes(
+        window.location.pathname,
+      )
+    ) {
+      window.history.replaceState(null, "", `/${window.location.search}${window.location.hash}`);
+      setPathname("/");
+    }
+  }, [setPathname]);
+
+  useEffect(() => {
+    const syncPathname = () => setPathname(window.location.pathname);
+    window.addEventListener("popstate", syncPathname);
+    return () => window.removeEventListener("popstate", syncPathname);
+  }, [setPathname]);
+
+  useEffect(() => {
+    if (pathname !== pricingSetupPath || pricing !== null) return;
+    void Promise.all([api.pricing(), api.fxRate()])
+      .then(([catalog, rate]) => {
+        setPricing(catalog);
+        setFxRate(rate);
+      })
+      .catch((cause) => setError(String(cause)));
+  }, [api, pathname, pricing, setError, setFxRate, setPricing]);
+}