@stigmer/react 0.5.1 → 1.0.0

package/dashboard/DashboardKPICards.js

@@ -0,0 +1,80 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { memo } from "react";
+import { cn } from "@stigmer/theme";
+function formatCost(usd) {
+    if (usd >= 1)
+        return `$${usd.toFixed(2)}`;
+    if (usd >= 0.01)
+        return `$${usd.toFixed(3)}`;
+    if (usd > 0)
+        return `<$0.01`;
+    return "$0.00";
+}
+const STAT_CARDS = [
+    {
+        label: "Active",
+        valueClass: "text-foreground",
+        getValue: (s) => String(s.activeCount),
+        getBreakdown: (s) => {
+            const ag = s.agent?.activeCount ?? 0;
+            const wf = s.workflow?.activeCount ?? 0;
+            if (ag === 0 && wf === 0)
+                return null;
+            return `${ag} agent, ${wf} workflow`;
+        },
+    },
+    {
+        label: "Completed",
+        valueClass: "text-success",
+        getValue: (s) => String(s.completedCount),
+        getBreakdown: (s) => {
+            const ag = s.agent?.phaseCounts[3] ?? 0;
+            const wf = s.workflow?.phaseCounts[3] ?? 0;
+            if (ag === 0 && wf === 0)
+                return null;
+            return `${ag} agent, ${wf} workflow`;
+        },
+    },
+    {
+        label: "Failed",
+        valueClass: "text-destructive",
+        getValue: (s) => String(s.failedCount),
+        getBreakdown: (s) => {
+            const ag = s.agent?.phaseCounts[4] ?? 0;
+            const wf = s.workflow?.phaseCounts[4] ?? 0;
+            if (ag === 0 && wf === 0)
+                return null;
+            return `${ag} agent, ${wf} workflow`;
+        },
+    },
+    {
+        label: "Total Cost",
+        valueClass: "text-foreground",
+        getValue: (s) => formatCost(s.totalCostUsd),
+        getBreakdown: () => null,
+    },
+];
+/**
+ * Unified stat cards showing combined agent + workflow execution KPIs.
+ *
+ * Each card shows the combined count with a breakdown tooltip showing
+ * per-source values (e.g., "2 agent, 1 workflow").
+ *
+ * Cost comes from the billing source of truth (getOrgUsageReport),
+ * not from summing per-domain costs. See AD-DASH-005.
+ *
+ * @since Unified Platform Dashboard
+ */
+export const DashboardKPICards = memo(function DashboardKPICards({ summary, isLoading, className, }) {
+    if (isLoading) {
+        return (_jsx("div", { className: cn("space-y-3", className), "aria-busy": "true", children: _jsx("div", { className: "grid gap-3 sm:grid-cols-2 lg:grid-cols-4", children: Array.from({ length: 4 }, (_, i) => (_jsx("div", { className: "h-[72px] animate-pulse rounded-lg border border-border bg-muted/50" }, i))) }) }));
+    }
+    if (!summary)
+        return null;
+    return (_jsx("div", { className: cn("grid gap-3 sm:grid-cols-2 lg:grid-cols-4", className), children: STAT_CARDS.map((card) => {
+            const breakdown = card.getBreakdown(summary);
+            return (_jsxs("div", { className: "rounded-lg border border-border bg-card px-4 py-3", title: breakdown ?? undefined, children: [_jsx("p", { className: "text-xs font-medium text-muted-foreground", children: card.label }), _jsx("p", { className: cn("mt-1 text-2xl font-semibold", card.valueClass), children: card.getValue(summary) }), breakdown && (_jsx("p", { className: "mt-0.5 text-[10px] text-muted-foreground", children: breakdown }))] }, card.label));
+        }) }));
+});
+//# sourceMappingURL=DashboardKPICards.js.map

package/dashboard/DashboardKPICards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardKPICards.js","sourceRoot":"","sources":["../../src/dashboard/DashboardKPICards.tsx"],"names":[],"mappings":"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"}

package/dashboard/OperationalDashboard.d.ts

@@ -0,0 +1,37 @@
+import type { DashboardFailedRun } from "./types";
+export interface OperationalDashboardProps {
+    /** Organization slug for execution summaries and pending approvals. */
+    readonly org: string | null | undefined;
+    /** Organization ID (metadata.id) for the usage report. */
+    readonly orgId: string | null | undefined;
+    /** Called when the user clicks "Review" on a pending approval. */
+    readonly onApprovalClick?: (executionId: string) => void;
+    /** Called when the user clicks "View" on a failed execution. */
+    readonly onFailedRunClick?: (id: string, type: DashboardFailedRun["type"]) => void;
+    readonly className?: string;
+}
+/**
+ * Composed dashboard widget that aggregates operational metrics from both
+ * agent and workflow domains into a unified platform view.
+ *
+ * Layout:
+ * - Row 1: KPI stat cards (Active | Completed | Failed | Total Cost)
+ * - Row 2: Pending Approvals | Recent Failures (2-column grid)
+ *
+ * Cost comes from the billing source of truth (`getOrgUsageReport`),
+ * not from summing agent + workflow costs. See AD-DASH-005.
+ *
+ * @example
+ * ```tsx
+ * <OperationalDashboard
+ *   org="acme"
+ *   orgId={activeOrg?.metadata?.id}
+ *   onApprovalClick={(id) => navigate(`/executions/${id}`)}
+ *   onFailedRunClick={(id, type) => navigate(`/executions/${id}`)}
+ * />
+ * ```
+ *
+ * @since Unified Platform Dashboard
+ */
+export declare const OperationalDashboard: import("react").NamedExoticComponent<OperationalDashboardProps>;
+//# sourceMappingURL=OperationalDashboard.d.ts.map

package/dashboard/OperationalDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationalDashboard.d.ts","sourceRoot":"","sources":["../../src/dashboard/OperationalDashboard.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACxC,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,oBAAoB,iEAgD/B,CAAC"}

package/dashboard/OperationalDashboard.js

@@ -0,0 +1,48 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { memo, useCallback } from "react";
+import { cn } from "@stigmer/theme";
+import { usePendingApprovals } from "../workflow/usePendingApprovals";
+import { PendingApprovalsWidget } from "../workflow/PendingApprovalsWidget";
+import { useDashboardSummary } from "./useDashboardSummary";
+import { useDashboardFailedRuns } from "./useDashboardFailedRuns";
+import { DashboardKPICards } from "./DashboardKPICards";
+import { DashboardFailedRuns } from "./DashboardFailedRuns";
+/**
+ * Composed dashboard widget that aggregates operational metrics from both
+ * agent and workflow domains into a unified platform view.
+ *
+ * Layout:
+ * - Row 1: KPI stat cards (Active | Completed | Failed | Total Cost)
+ * - Row 2: Pending Approvals | Recent Failures (2-column grid)
+ *
+ * Cost comes from the billing source of truth (`getOrgUsageReport`),
+ * not from summing agent + workflow costs. See AD-DASH-005.
+ *
+ * @example
+ * ```tsx
+ * <OperationalDashboard
+ *   org="acme"
+ *   orgId={activeOrg?.metadata?.id}
+ *   onApprovalClick={(id) => navigate(`/executions/${id}`)}
+ *   onFailedRunClick={(id, type) => navigate(`/executions/${id}`)}
+ * />
+ * ```
+ *
+ * @since Unified Platform Dashboard
+ */
+export const OperationalDashboard = memo(function OperationalDashboard({ org, orgId, onApprovalClick, onFailedRunClick, className, }) {
+    const summaryOptions = {
+        org,
+        orgId,
+        refetchInterval: 60_000,
+    };
+    const { summary, isLoading: summaryLoading } = useDashboardSummary(summaryOptions);
+    const { approvals, totalCount: approvalCount, isLoading: approvalsLoading } = usePendingApprovals({ org, refetchInterval: 30_000 });
+    const { failedRuns, isLoading: failedLoading } = useDashboardFailedRuns(org);
+    const handleFailedRunClick = useCallback((id, type) => {
+        onFailedRunClick?.(id, type);
+    }, [onFailedRunClick]);
+    return (_jsxs("section", { "aria-label": "Platform dashboard", className: cn("space-y-6", className), children: [_jsx(DashboardKPICards, { summary: summary, isLoading: summaryLoading }), _jsxs("div", { className: "grid gap-6 lg:grid-cols-2", children: [_jsx(PendingApprovalsWidget, { approvals: approvals, totalCount: approvalCount, isLoading: approvalsLoading, onReviewClick: onApprovalClick }), _jsx(DashboardFailedRuns, { failedRuns: failedRuns, isLoading: failedLoading, onViewClick: handleFailedRunClick })] })] }));
+});
+//# sourceMappingURL=OperationalDashboard.js.map

package/dashboard/OperationalDashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationalDashboard.js","sourceRoot":"","sources":["../../src/dashboard/OperationalDashboard.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAmC,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAe5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,oBAAoB,CAAC,EACrE,GAAG,EACH,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,SAAS,GACiB;IAC1B,MAAM,cAAc,GAA+B;QACjD,GAAG;QACH,KAAK;QACL,eAAe,EAAE,MAAM;KACxB,CAAC;IACF,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAEnF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,GACzE,mBAAmB,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC;IAExD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAE7E,MAAM,oBAAoB,GAAG,WAAW,CACtC,CAAC,EAAU,EAAE,IAAgC,EAAE,EAAE;QAC/C,gBAAgB,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,EACD,CAAC,gBAAgB,CAAC,CACnB,CAAC;IAEF,OAAO,CACL,iCACa,oBAAoB,EAC/B,SAAS,EAAE,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,aAErC,KAAC,iBAAiB,IAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,GAAI,EAElE,eAAK,SAAS,EAAC,2BAA2B,aACxC,KAAC,sBAAsB,IACrB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,aAAa,EACzB,SAAS,EAAE,gBAAgB,EAC3B,aAAa,EAAE,eAAe,GAC9B,EACF,KAAC,mBAAmB,IAClB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,oBAAoB,GACjC,IACE,IACE,CACX,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dashboard/index.d.ts

@@ -0,0 +1,8 @@
+export type { DashboardSummary, DashboardFailedRun } from "./types";
+export { useAgentExecutionSummary, AgentExecutionSummaryTimeWindow, type UseAgentExecutionSummaryOptions, type UseAgentExecutionSummaryReturn, } from "./useAgentExecutionSummary";
+export { useDashboardSummary, type UseDashboardSummaryOptions, type UseDashboardSummaryReturn, } from "./useDashboardSummary";
+export { useDashboardFailedRuns, type UseDashboardFailedRunsReturn, } from "./useDashboardFailedRuns";
+export { DashboardKPICards, type DashboardKPICardsProps, } from "./DashboardKPICards";
+export { DashboardFailedRuns, type DashboardFailedRunsProps, } from "./DashboardFailedRuns";
+export { OperationalDashboard, type OperationalDashboardProps, } from "./OperationalDashboard";
+//# sourceMappingURL=index.d.ts.map

package/dashboard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,GACpC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,GAC/B,MAAM,wBAAwB,CAAC"}

package/dashboard/index.js

@@ -0,0 +1,9 @@
+// ─── Data Hooks ─────────────────────────────────────────────────────────────
+export { useAgentExecutionSummary, AgentExecutionSummaryTimeWindow, } from "./useAgentExecutionSummary";
+export { useDashboardSummary, } from "./useDashboardSummary";
+export { useDashboardFailedRuns, } from "./useDashboardFailedRuns";
+// ─── Styled Components ─────────────────────────────────────────────────────
+export { DashboardKPICards, } from "./DashboardKPICards";
+export { DashboardFailedRuns, } from "./DashboardFailedRuns";
+export { OperationalDashboard, } from "./OperationalDashboard";
+//# sourceMappingURL=index.js.map

package/dashboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAGA,+EAA+E;AAC/E,OAAO,EACL,wBAAwB,EACxB,+BAA+B,GAGhC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,mBAAmB,GAGpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC;AAElC,8EAA8E;AAC9E,OAAO,EACL,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,GAErB,MAAM,wBAAwB,CAAC"}

package/dashboard/types.d.ts

@@ -0,0 +1,49 @@
+import type { AgentExecutionSummary } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import type { GetOrgUsageReportOutput } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import type { ExecutionSummary } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+/**
+ * Unified dashboard summary combining operational metrics from both
+ * agent and workflow execution domains.
+ *
+ * Execution counts (active, completed, failed) are safe to add because
+ * agent executions and workflow executions are distinct resources.
+ *
+ * Cost comes from {@link GetOrgUsageReportOutput} (billing source of truth),
+ * NOT from summing agent + workflow costs. This prevents double-counting
+ * when workflows delegate to agents. See AD-DASH-005.
+ */
+export interface DashboardSummary {
+    /** Combined agent + workflow active execution count. */
+    readonly activeCount: number;
+    /** Combined agent + workflow completed count. */
+    readonly completedCount: number;
+    /** Combined agent + workflow failed count. */
+    readonly failedCount: number;
+    /**
+     * Total platform cost in USD from the billing source of truth.
+     * Sourced from `getOrgUsageReport.total_billable_cost_micros`.
+     */
+    readonly totalCostUsd: number;
+    /** Agent-side execution summary for per-source breakdown in tooltips. */
+    readonly agent: AgentExecutionSummary | null;
+    /** Workflow-side execution summary for per-source breakdown in tooltips. */
+    readonly workflow: ExecutionSummary | null;
+    /** Org-level usage report for cost details. */
+    readonly orgUsage: GetOrgUsageReportOutput | null;
+}
+/** A normalized entry representing a failed execution from either domain. */
+export interface DashboardFailedRun {
+    /** Execution ID (`aex_*` or `wex_*`). */
+    readonly id: string;
+    /** Discriminator for routing navigation. */
+    readonly type: "agent_execution" | "workflow_execution";
+    /** Execution name or subject. */
+    readonly name: string;
+    /** Error message from the failed execution. */
+    readonly error: string;
+    /** When the execution failed. */
+    readonly failedAt: Date;
+    /** The agent or workflow name associated with this execution. */
+    readonly resourceName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dashboard/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dashboard/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+DAA+D,CAAC;AAEtG;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACnD;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;IACxD,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/dashboard/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dashboard/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/dashboard/types.ts"],"names":[],"mappings":""}

package/dashboard/useAgentExecutionSummary.d.ts

@@ -0,0 +1,33 @@
+import type { AgentExecutionSummary } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { AgentExecutionSummaryTimeWindow } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+export { AgentExecutionSummaryTimeWindow };
+/** Options for {@link useAgentExecutionSummary}. */
+export interface UseAgentExecutionSummaryOptions {
+    /** Organization slug. When empty/null, the hook does not fetch. */
+    readonly org: string | null | undefined;
+    /** Time window for aggregation. @default LAST_7D */
+    readonly timeWindow?: AgentExecutionSummaryTimeWindow;
+    /** Refetch interval in milliseconds. `0` or `false` disables. @default 0 */
+    readonly refetchInterval?: number | false;
+}
+/** Return value of {@link useAgentExecutionSummary}. */
+export interface UseAgentExecutionSummaryReturn {
+    readonly summary: AgentExecutionSummary | null;
+    readonly isLoading: boolean;
+    readonly isRefetching: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches aggregated agent execution statistics for an
+ * organization. Returns phase counts, active count, average duration,
+ * and top failing agents.
+ *
+ * Cost is intentionally excluded from this response — the dashboard
+ * sources cost from `useOrgUsageReport` (billing source of truth) to
+ * prevent double-counting. See AD-DASH-005.
+ *
+ * @since Unified Platform Dashboard
+ */
+export declare function useAgentExecutionSummary(options: UseAgentExecutionSummaryOptions): UseAgentExecutionSummaryReturn;
+//# sourceMappingURL=useAgentExecutionSummary.d.ts.map

package/dashboard/useAgentExecutionSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentExecutionSummary.d.ts","sourceRoot":"","sources":["../../src/dashboard/useAgentExecutionSummary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EACL,+BAA+B,EAEhC,MAAM,4DAA4D,CAAC;AAIpE,OAAO,EAAE,+BAA+B,EAAE,CAAC;AAE3C,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,+BAA+B,CAAC;IACtD,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3C;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAyBhC"}

package/dashboard/useAgentExecutionSummary.js

@@ -0,0 +1,32 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { AgentExecutionSummaryTimeWindow, GetAgentExecutionSummaryRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+export { AgentExecutionSummaryTimeWindow };
+/**
+ * Data hook that fetches aggregated agent execution statistics for an
+ * organization. Returns phase counts, active count, average duration,
+ * and top failing agents.
+ *
+ * Cost is intentionally excluded from this response — the dashboard
+ * sources cost from `useOrgUsageReport` (billing source of truth) to
+ * prevent double-counting. See AD-DASH-005.
+ *
+ * @since Unified Platform Dashboard
+ */
+export function useAgentExecutionSummary(options) {
+    const stigmer = useStigmer();
+    const org = options.org ?? "";
+    const timeWindow = options.timeWindow ??
+        AgentExecutionSummaryTimeWindow.LAST_7D;
+    const refetchInterval = options.refetchInterval ?? 0;
+    const fetchFn = org
+        ? async () => {
+            return await stigmer.agentExecution.getExecutionSummary(create(GetAgentExecutionSummaryRequestSchema, { org, timeWindow }));
+        }
+        : null;
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [stigmer, org, timeWindow], null, { refetchInterval: refetchInterval || false });
+    return { summary: data, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useAgentExecutionSummary.js.map

package/dashboard/useAgentExecutionSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentExecutionSummary.js","sourceRoot":"","sources":["../../src/dashboard/useAgentExecutionSummary.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EACL,+BAA+B,EAC/B,qCAAqC,GACtC,MAAM,4DAA4D,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,+BAA+B,EAAE,CAAC;AAqB3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAwC;IAExC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAC9B,MAAM,UAAU,GACd,OAAO,CAAC,UAAU;QAClB,+BAA+B,CAAC,OAAO,CAAC;IAC1C,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,GAAG;QACjB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,OAAO,CAAC,cAAc,CAAC,mBAAmB,CACrD,MAAM,CAAC,qCAAqC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CACnE,CAAC;QACJ,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GACrD,QAAQ,CACN,OAAO,EACP,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,EAC1B,IAAI,EACJ,EAAE,eAAe,EAAE,eAAe,IAAI,KAAK,EAAE,CAC9C,CAAC;IAEJ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACpE,CAAC"}

package/dashboard/useDashboardFailedRuns.d.ts

@@ -0,0 +1,18 @@
+import type { DashboardFailedRun } from "./types";
+/** Return value of {@link useDashboardFailedRuns}. */
+export interface UseDashboardFailedRunsReturn {
+    readonly failedRuns: readonly DashboardFailedRun[];
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+}
+/**
+ * Composition hook that fetches recent failed executions from both
+ * agent and workflow domains, normalizes them into {@link DashboardFailedRun}
+ * entries, and interleaves them by timestamp (newest first).
+ *
+ * Returns at most 5 total entries to keep the widget compact.
+ *
+ * @since Unified Platform Dashboard
+ */
+export declare function useDashboardFailedRuns(org: string | null | undefined): UseDashboardFailedRunsReturn;
+//# sourceMappingURL=useDashboardFailedRuns.d.ts.map

package/dashboard/useDashboardFailedRuns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardFailedRuns.d.ts","sourceRoot":"","sources":["../../src/dashboard/useDashboardFailedRuns.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAOlD,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,4BAA4B,CAmF9B"}

package/dashboard/useDashboardFailedRuns.js

@@ -0,0 +1,86 @@
+"use client";
+import { useMemo } from "react";
+import { create } from "@bufbuild/protobuf";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { ExecutionPhase as AgentPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ExecutionPhase as WorkflowPhase } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { ListAgentExecutionsRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { ListWorkflowExecutionsRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+const EPOCH = new Date(0);
+const EMPTY = [];
+const MAX_TOTAL = 5;
+const PAGE_SIZE = 5;
+/**
+ * Composition hook that fetches recent failed executions from both
+ * agent and workflow domains, normalizes them into {@link DashboardFailedRun}
+ * entries, and interleaves them by timestamp (newest first).
+ *
+ * Returns at most 5 total entries to keep the widget compact.
+ *
+ * @since Unified Platform Dashboard
+ */
+export function useDashboardFailedRuns(org) {
+    const stigmer = useStigmer();
+    const orgVal = org ?? "";
+    const agentFetchFn = useMemo(() => orgVal
+        ? async () => {
+            const resp = await stigmer.agentExecution.list(create(ListAgentExecutionsRequestSchema, {
+                pageSize: PAGE_SIZE,
+                phase: AgentPhase.EXECUTION_FAILED,
+            }));
+            return [...resp.entries];
+        }
+        : null, [stigmer, orgVal]);
+    const workflowFetchFn = useMemo(() => orgVal
+        ? async () => {
+            const resp = await stigmer.workflowExecution.list(create(ListWorkflowExecutionsRequestSchema, {
+                pageSize: PAGE_SIZE,
+                phase: WorkflowPhase.EXECUTION_FAILED,
+            }));
+            return [...resp.entries];
+        }
+        : null, [stigmer, orgVal]);
+    const { data: agentFailed, isLoading: agLoading, error: agError } = useFetch(agentFetchFn, [stigmer, orgVal], [], {
+        refetchInterval: 60_000,
+    });
+    const { data: workflowFailed, isLoading: wfLoading, error: wfError } = useFetch(workflowFetchFn, [stigmer, orgVal], [], {
+        refetchInterval: 60_000,
+    });
+    const failedRuns = useMemo(() => {
+        if (!agentFailed.length && !workflowFailed.length)
+            return EMPTY;
+        const agentEntries = agentFailed.map((exec) => {
+            const ts = exec.status?.audit?.specAudit?.createdAt;
+            return {
+                id: exec.metadata?.id ?? "",
+                type: "agent_execution",
+                name: exec.metadata?.name || "Untitled execution",
+                error: exec.status?.error ?? "",
+                failedAt: ts ? timestampDate(ts) : EPOCH,
+                resourceName: exec.spec?.agentId ?? "",
+            };
+        });
+        const workflowEntries = workflowFailed.map((exec) => {
+            const ts = exec.status?.audit?.specAudit?.createdAt;
+            return {
+                id: exec.metadata?.id ?? "",
+                type: "workflow_execution",
+                name: exec.metadata?.name || "Untitled execution",
+                error: exec.status?.error ?? "",
+                failedAt: ts ? timestampDate(ts) : EPOCH,
+                resourceName: exec.metadata?.slug ?? "",
+            };
+        });
+        const merged = [...agentEntries, ...workflowEntries];
+        merged.sort((a, b) => b.failedAt.getTime() - a.failedAt.getTime());
+        return merged.slice(0, MAX_TOTAL);
+    }, [agentFailed, workflowFailed]);
+    return {
+        failedRuns,
+        isLoading: agLoading || wfLoading,
+        error: agError ?? wfError,
+    };
+}
+//# sourceMappingURL=useDashboardFailedRuns.js.map

package/dashboard/useDashboardFailedRuns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardFailedRuns.js","sourceRoot":"","sources":["../../src/dashboard/useDashboardFailedRuns.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,cAAc,IAAI,aAAa,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,gCAAgC,EAAE,MAAM,4DAA4D,CAAC;AAC9G,OAAO,EAAE,mCAAmC,EAAE,MAAM,+DAA+D,CAAC;AAGpH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;AAC1B,MAAM,KAAK,GAAkC,EAAE,CAAC;AAChD,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,SAAS,GAAG,CAAC,CAAC;AASpB;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAA8B;IAE9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;IAEzB,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CACH,MAAM;QACJ,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,IAAI,CAC5C,MAAM,CAAC,gCAAgC,EAAE;gBACvC,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,UAAU,CAAC,gBAAgB;aACnC,CAAC,CACH,CAAC;YACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAA8B,CAAC;QACxD,CAAC;QACH,CAAC,CAAC,IAAI,EACV,CAAC,OAAO,EAAE,MAAM,CAAC,CAClB,CAAC;IAEF,MAAM,eAAe,GAAG,OAAO,CAC7B,GAAG,EAAE,CACH,MAAM;QACJ,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAC/C,MAAM,CAAC,mCAAmC,EAAE;gBAC1C,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,aAAa,CAAC,gBAAgB;aACtC,CAAC,CACH,CAAC;YACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAiC,CAAC;QAC3D,CAAC;QACH,CAAC,CAAC,IAAI,EACV,CAAC,OAAO,EAAE,MAAM,CAAC,CAClB,CAAC;IAEF,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAC/D,QAAQ,CAA4B,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE;QACvE,eAAe,EAAE,MAAM;KACxB,CAAC,CAAC;IAEL,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAClE,QAAQ,CAA+B,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE;QAC7E,eAAe,EAAE,MAAM;KACxB,CAAC,CAAC;IAEL,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAEhE,MAAM,YAAY,GAAyB,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAClE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC;YACpD,OAAO;gBACL,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE;gBAC3B,IAAI,EAAE,iBAA0B;gBAChC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,oBAAoB;gBACjD,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;gBAC/B,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK;gBACxC,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE;aACvC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,eAAe,GAAyB,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACxE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC;YACpD,OAAO;gBACL,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE;gBAC3B,IAAI,EAAE,oBAA6B;gBACnC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,oBAAoB;gBACjD,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;gBAC/B,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK;gBACxC,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE;aACxC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,eAAe,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;IAElC,OAAO;QACL,UAAU;QACV,SAAS,EAAE,SAAS,IAAI,SAAS;QACjC,KAAK,EAAE,OAAO,IAAI,OAAO;KAC1B,CAAC;AACJ,CAAC"}

package/dashboard/useDashboardSummary.d.ts

@@ -0,0 +1,32 @@
+import type { DashboardSummary } from "./types";
+/** Options for {@link useDashboardSummary}. */
+export interface UseDashboardSummaryOptions {
+    /** Organization slug for execution summaries. */
+    readonly org: string | null | undefined;
+    /** Organization ID (metadata.id) for the usage report. */
+    readonly orgId: string | null | undefined;
+    /** Refetch interval in milliseconds. @default 60_000 */
+    readonly refetchInterval?: number;
+}
+/** Return value of {@link useDashboardSummary}. */
+export interface UseDashboardSummaryReturn {
+    readonly summary: DashboardSummary | null;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Composition hook that merges agent execution summary, workflow execution
+ * summary, and org usage report into a single {@link DashboardSummary}.
+ *
+ * - Execution counts (active, completed, failed) are added across both
+ *   domains — safe because agent and workflow executions are distinct resources.
+ * - Cost comes from `getOrgUsageReport` (billing source of truth). NOT from
+ *   summing agent + workflow costs. See AD-DASH-005.
+ *
+ * Follows the same client-side merge pattern as `useRecentActivity`.
+ *
+ * @since Unified Platform Dashboard
+ */
+export declare function useDashboardSummary(options: UseDashboardSummaryOptions): UseDashboardSummaryReturn;
+//# sourceMappingURL=useDashboardSummary.d.ts.map

package/dashboard/useDashboardSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardSummary.d.ts","sourceRoot":"","sources":["../../src/dashboard/useDashboardSummary.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CA0D3B"}

package/dashboard/useDashboardSummary.js

@@ -0,0 +1,67 @@
+"use client";
+import { useMemo } from "react";
+import { ExecutionPhase as WorkflowPhase } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { ExecutionPhase as AgentPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { useWorkflowDashboardSummary, } from "../workflow/useWorkflowDashboardSummary";
+import { useOrgUsageReport } from "../usage/useOrgUsageReport";
+import { dateRangeFromPreset } from "../usage/date-range";
+import { useAgentExecutionSummary, AgentExecutionSummaryTimeWindow, } from "./useAgentExecutionSummary";
+/**
+ * Composition hook that merges agent execution summary, workflow execution
+ * summary, and org usage report into a single {@link DashboardSummary}.
+ *
+ * - Execution counts (active, completed, failed) are added across both
+ *   domains — safe because agent and workflow executions are distinct resources.
+ * - Cost comes from `getOrgUsageReport` (billing source of truth). NOT from
+ *   summing agent + workflow costs. See AD-DASH-005.
+ *
+ * Follows the same client-side merge pattern as `useRecentActivity`.
+ *
+ * @since Unified Platform Dashboard
+ */
+export function useDashboardSummary(options) {
+    const refetchInterval = options.refetchInterval ?? 60_000;
+    const { summary: workflowSummary, isLoading: wfLoading, error: wfError, refetch: wfRefetch } = useWorkflowDashboardSummary({
+        org: options.org,
+        refetchInterval,
+    });
+    const { summary: agentSummary, isLoading: agLoading, error: agError, refetch: agRefetch } = useAgentExecutionSummary({
+        org: options.org,
+        timeWindow: AgentExecutionSummaryTimeWindow.LAST_7D,
+        refetchInterval,
+    });
+    const dateRange = useMemo(() => dateRangeFromPreset("7d"), []);
+    const { report: orgUsage, isLoading: usageLoading, error: usageError, refetch: usageRefetch } = useOrgUsageReport(options.orgId ?? null, dateRange);
+    const isLoading = wfLoading || agLoading || usageLoading;
+    const error = wfError ?? agError ?? usageError;
+    const summary = useMemo(() => {
+        if (isLoading && !workflowSummary && !agentSummary)
+            return null;
+        const wfActive = workflowSummary?.activeCount ?? 0;
+        const agActive = agentSummary?.activeCount ?? 0;
+        const wfCompleted = workflowSummary?.phaseCounts[WorkflowPhase.EXECUTION_COMPLETED] ?? 0;
+        const agCompleted = agentSummary?.phaseCounts[AgentPhase.EXECUTION_COMPLETED] ?? 0;
+        const wfFailed = workflowSummary?.phaseCounts[WorkflowPhase.EXECUTION_FAILED] ?? 0;
+        const agFailed = agentSummary?.phaseCounts[AgentPhase.EXECUTION_FAILED] ?? 0;
+        const totalCostMicros = Number(orgUsage?.totalBillableCostMicros ?? BigInt(0));
+        const totalCostUsd = totalCostMicros / 1_000_000;
+        return {
+            activeCount: wfActive + agActive,
+            completedCount: wfCompleted + agCompleted,
+            failedCount: wfFailed + agFailed,
+            totalCostUsd,
+            agent: agentSummary,
+            workflow: workflowSummary,
+            orgUsage: orgUsage,
+        };
+    }, [workflowSummary, agentSummary, orgUsage, isLoading]);
+    const refetch = useMemo(() => {
+        return () => {
+            wfRefetch();
+            agRefetch();
+            usageRefetch();
+        };
+    }, [wfRefetch, agRefetch, usageRefetch]);
+    return { summary, isLoading, error, refetch };
+}
+//# sourceMappingURL=useDashboardSummary.js.map

package/dashboard/useDashboardSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardSummary.js","sourceRoot":"","sources":["../../src/dashboard/useDashboardSummary.ts"],"names":[],"mappings":"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"}

package/execution/ContextGauge.d.ts

@@ -0,0 +1,45 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+/** Props for {@link ContextGauge}. */
+export interface ContextGaugeProps {
+    /**
+     * The execution snapshot from `useExecutionStream`, or `null`.
+     * The gauge extracts `context_info` from the execution status.
+     */
+    readonly execution: AgentExecution | null;
+    /**
+     * When `true`, renders a minimal bar without labels.
+     * Use in tight layouts (e.g., inline status indicators).
+     * @default false
+     */
+    readonly compact?: boolean;
+    /** Additional CSS classes for the root element. */
+    readonly className?: string;
+}
+/**
+ * Visual gauge showing context window utilization during agent execution.
+ *
+ * Renders a progress bar with threshold markers, token count labels, and
+ * a health indicator derived from utilization percentage. The gauge updates
+ * in real-time as the execution streams status updates.
+ *
+ * Returns `null` when `context_info` is absent (e.g., Cursor harness
+ * where context is managed externally).
+ *
+ * All visual properties flow through `--stgm-*` tokens. Zero Console
+ * dependencies. Accessible via `role="meter"` with ARIA value attributes.
+ *
+ * @example
+ * ```tsx
+ * const { execution } = useExecutionStream(executionId);
+ * <ContextGauge execution={execution} />
+ * ```
+ *
+ * @example Compact mode in a status bar:
+ * ```tsx
+ * <ContextGauge execution={execution} compact />
+ * ```
+ *
+ * @see {@link useContextWindow} - headless hook for custom rendering
+ */
+export declare const ContextGauge: import("react").NamedExoticComponent<ContextGaugeProps>;
+//# sourceMappingURL=ContextGauge.d.ts.map

package/execution/ContextGauge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextGauge.d.ts","sourceRoot":"","sources":["../../src/execution/ContextGauge.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AASlG,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,YAAY,yDAYvB,CAAC"}