@copilotz/admin 0.9.36 → 0.9.37

package/dist/index.js

@@ -140,12 +140,16 @@ function createAdminClient(options = {}) {
       metric: filters.metric,
       groupBy: filters.groupBy,
       attribution: filters.attribution,
+      kind: filters.kind,
       threadId: filters.threadId,
       participantId: filters.participantId,
       participantType: filters.participantType,
       namespace: filters.namespace,
       provider: filters.provider,
-      model: filters.model
+      model: filters.model,
+      resource: filters.resource,
+      operation: filters.operation,
+      status: filters.status
     }),
     listThreads: async (listOptions = {}) => await requestJson(`${paths.adminBase}/threads`, {
       search: listOptions.search,
@@ -1398,7 +1402,11 @@ var EMPTY_USAGE_TOTALS = {
   reasoningTokens: 0,
   totalCalls: 0,
   totalCostUsd: 0,
-  totalTokens: 0
+  failedCalls: 0,
+  totalCredits: 0,
+  totalDurationMs: 0,
+  totalTokens: 0,
+  unpricedCalls: 0
 };
 var USAGE_CHART_COLORS = [
   "hsl(var(--primary))",
@@ -1409,53 +1417,66 @@ var USAGE_CHART_COLORS = [
   "hsl(var(--muted-foreground))"
 ];
 function addUsageTotals(target, source) {
-  target.cacheCreationInputCostUsd += source.cacheCreationInputCostUsd;
-  target.cacheCreationInputTokens += source.cacheCreationInputTokens;
-  target.cacheReadInputCostUsd += source.cacheReadInputCostUsd;
-  target.cacheReadInputTokens += source.cacheReadInputTokens;
-  target.inputCostUsd += source.inputCostUsd;
-  target.inputTokens += source.inputTokens;
-  target.outputCostUsd += source.outputCostUsd;
-  target.outputTokens += source.outputTokens;
-  target.reasoningCostUsd += source.reasoningCostUsd;
-  target.reasoningTokens += source.reasoningTokens;
-  target.totalCalls += source.totalCalls;
-  target.totalCostUsd += source.totalCostUsd;
-  target.totalTokens += source.totalTokens;
+  target.cacheCreationInputCostUsd += safeUsageNumber(source.cacheCreationInputCostUsd);
+  target.cacheCreationInputTokens += safeUsageNumber(source.cacheCreationInputTokens);
+  target.cacheReadInputCostUsd += safeUsageNumber(source.cacheReadInputCostUsd);
+  target.cacheReadInputTokens += safeUsageNumber(source.cacheReadInputTokens);
+  target.inputCostUsd += safeUsageNumber(source.inputCostUsd);
+  target.inputTokens += safeUsageNumber(source.inputTokens);
+  target.outputCostUsd += safeUsageNumber(source.outputCostUsd);
+  target.outputTokens += safeUsageNumber(source.outputTokens);
+  target.reasoningCostUsd += safeUsageNumber(source.reasoningCostUsd);
+  target.reasoningTokens += safeUsageNumber(source.reasoningTokens);
+  target.totalCalls += safeUsageNumber(source.totalCalls);
+  target.totalCostUsd += safeUsageNumber(source.totalCostUsd);
+  target.failedCalls += safeUsageNumber(source.failedCalls);
+  target.totalCredits += safeUsageNumber(source.totalCredits);
+  target.totalDurationMs += safeUsageNumber(source.totalDurationMs);
+  target.totalTokens += safeUsageNumber(source.totalTokens);
+  target.unpricedCalls += safeUsageNumber(source.unpricedCalls);
+}
+function safeUsageNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function getUsageTotalValue(totals, metricKind, dimension) {
-  if (metricKind === "calls") return totals.totalCalls;
+  if (metricKind === "calls") return safeUsageNumber(totals.totalCalls);
+  if (metricKind === "duration") {
+    return safeUsageNumber(totals.totalDurationMs);
+  }
+  if (metricKind === "credits") return safeUsageNumber(totals.totalCredits);
+  if (metricKind === "failures") return safeUsageNumber(totals.failedCalls);
+  if (metricKind === "unpriced") return safeUsageNumber(totals.unpricedCalls);
   if (metricKind === "cost") {
     switch (dimension) {
       case "input":
-        return totals.inputCostUsd;
+        return safeUsageNumber(totals.inputCostUsd);
       case "output":
-        return totals.outputCostUsd;
+        return safeUsageNumber(totals.outputCostUsd);
       case "reasoning":
-        return totals.reasoningCostUsd;
+        return safeUsageNumber(totals.reasoningCostUsd);
       case "cacheRead":
-        return totals.cacheReadInputCostUsd;
+        return safeUsageNumber(totals.cacheReadInputCostUsd);
       case "cacheWrite":
-        return totals.cacheCreationInputCostUsd;
+        return safeUsageNumber(totals.cacheCreationInputCostUsd);
       case "total":
       default:
-        return totals.totalCostUsd;
+        return safeUsageNumber(totals.totalCostUsd);
     }
   }
   switch (dimension) {
     case "input":
-      return totals.inputTokens;
+      return safeUsageNumber(totals.inputTokens);
     case "output":
-      return totals.outputTokens;
+      return safeUsageNumber(totals.outputTokens);
     case "reasoning":
-      return totals.reasoningTokens;
+      return safeUsageNumber(totals.reasoningTokens);
     case "cacheRead":
-      return totals.cacheReadInputTokens;
+      return safeUsageNumber(totals.cacheReadInputTokens);
     case "cacheWrite":
-      return totals.cacheCreationInputTokens;
+      return safeUsageNumber(totals.cacheCreationInputTokens);
     case "total":
     default:
-      return totals.totalTokens;
+      return safeUsageNumber(totals.totalTokens);
   }
 }
 function aggregateUsageRows(points, metricKind, dimension) {
@@ -1567,6 +1588,14 @@ function getUsageDimensionLabel(dimension) {
 }
 function getUsageGroupLabel(groupBy) {
   switch (groupBy) {
+    case "kind":
+      return "Kind";
+    case "resource":
+      return "Resource";
+    case "operation":
+      return "Operation";
+    case "status":
+      return "Status";
     case "thread":
       return "Thread";
     case "namespace":
@@ -1580,6 +1609,25 @@ function getUsageGroupLabel(groupBy) {
       return "Participant";
   }
 }
+function getUsageMetricLabel(metricKind) {
+  switch (metricKind) {
+    case "cost":
+      return "Spend";
+    case "tokens":
+      return "Tokens";
+    case "duration":
+      return "Duration";
+    case "credits":
+      return "Credits";
+    case "failures":
+      return "Failures";
+    case "unpriced":
+      return "Unpriced";
+    case "calls":
+    default:
+      return "Calls";
+  }
+}
 function formatUsageBucket(bucket, interval) {
   const date = new Date(bucket);
   if (Number.isNaN(date.getTime())) return bucket;
@@ -1622,6 +1670,9 @@ function formatMetricValue(value, metricKind) {
       style: "currency"
     }).format(value);
   }
+  if (metricKind === "duration") {
+    return formatDuration(value);
+  }
   return formatNumber(value);
 }
 function formatCompactMetric(value, metricKind) {
@@ -1634,12 +1685,30 @@ function formatCompactMetric(value, metricKind) {
       style: "currency"
     }).format(value);
   }
+  if (metricKind === "duration") {
+    if (value >= 36e5) return `${(value / 36e5).toFixed(1)}h`;
+    if (value >= 6e4) return `${(value / 6e4).toFixed(1)}m`;
+    if (value >= 1e3) return `${(value / 1e3).toFixed(1)}s`;
+    return `${Math.round(value)}ms`;
+  }
   return new Intl.NumberFormat(void 0, {
     compactDisplay: "short",
     maximumFractionDigits: 1,
     notation: "compact"
   }).format(value);
 }
+function formatDuration(value) {
+  if (value >= 36e5) {
+    return `${new Intl.NumberFormat(void 0, { maximumFractionDigits: 1 }).format(value / 36e5)} h`;
+  }
+  if (value >= 6e4) {
+    return `${new Intl.NumberFormat(void 0, { maximumFractionDigits: 1 }).format(value / 6e4)} min`;
+  }
+  if (value >= 1e3) {
+    return `${new Intl.NumberFormat(void 0, { maximumFractionDigits: 1 }).format(value / 1e3)} sec`;
+  }
+  return `${formatNumber(Math.round(value))} ms`;
+}
 
 // src/modules/agents/index.tsx
 import { jsx as jsx20, jsxs as jsxs12 } from "react/jsx-runtime";
@@ -2963,7 +3032,15 @@ import {
   XAxis,
   YAxis
 } from "recharts";
-import { Activity as Activity3, BarChart3, DollarSign, Sparkles as Sparkles2 } from "lucide-react";
+import {
+  Activity as Activity3,
+  AlertTriangle as AlertTriangle2,
+  BarChart3,
+  Clock,
+  Coins,
+  DollarSign,
+  Sparkles as Sparkles2
+} from "lucide-react";
 
 // src/components/ui/chart.tsx
 import * as React12 from "react";
@@ -3091,6 +3168,22 @@ var USAGE_DIMENSIONS = [
   "cacheRead",
   "cacheWrite"
 ];
+var USAGE_WORKLOADS = [
+  "all",
+  "llm",
+  "tool",
+  "asset",
+  "rag",
+  "embedding"
+];
+var STATUS_OPTIONS = [
+  "all",
+  "completed",
+  "failed",
+  "cancelled",
+  "aborted",
+  "error"
+];
 function usageModule() {
   return {
     group: "operate",
@@ -3117,11 +3210,12 @@ function UsagePage({ context }) {
     "7d"
   );
   const [interval, setInterval] = React13.useState("day");
+  const [workload, setWorkload] = React13.useState("all");
   const [metricKind, setMetricKind] = React13.useState(
-    "cost"
+    "calls"
   );
   const [dimension, setDimension] = React13.useState("total");
-  const [groupBy, setGroupBy] = React13.useState("participant");
+  const [groupBy, setGroupBy] = React13.useState("kind");
   const [attribution, setAttribution] = React13.useState(
     "initiatedBy"
   );
@@ -3130,6 +3224,11 @@ function UsagePage({ context }) {
   const [participantId, setParticipantId] = React13.useState("");
   const [provider, setProvider] = React13.useState("");
   const [model, setModel] = React13.useState("");
+  const [resource, setResource] = React13.useState("");
+  const [operation, setOperation] = React13.useState("");
+  const [status, setStatus] = React13.useState(
+    "all"
+  );
   const [customFrom, setCustomFrom] = React13.useState("");
   const [customTo, setCustomTo] = React13.useState("");
   const [usage, setUsage] = React13.useState(null);
@@ -3139,6 +3238,32 @@ function UsagePage({ context }) {
     () => getUsageRange(period, customFrom, customTo),
     [customFrom, customTo, period]
   );
+  const metricOptions = React13.useMemo(
+    () => getUsageMetricOptions(workload),
+    [workload]
+  );
+  const groupOptions = React13.useMemo(
+    () => getUsageGroupOptions(workload),
+    [workload]
+  );
+  const showLlmFields = workload === "llm";
+  const showResourceFields = workload !== "llm";
+  const showDimension = metricKind === "tokens" || metricKind === "cost" && workload === "llm";
+  React13.useEffect(() => {
+    if (!metricOptions.includes(metricKind)) {
+      setMetricKind(metricOptions[0]);
+    }
+  }, [metricKind, metricOptions]);
+  React13.useEffect(() => {
+    if (!groupOptions.includes(groupBy)) {
+      setGroupBy(groupOptions[0]);
+    }
+  }, [groupBy, groupOptions]);
+  React13.useEffect(() => {
+    if (!showDimension && dimension !== "total") {
+      setDimension("total");
+    }
+  }, [dimension, showDimension]);
   React13.useEffect(() => {
     let active = true;
     setIsLoading(true);
@@ -3147,13 +3272,17 @@ function UsagePage({ context }) {
       attribution,
       from: range.from,
       groupBy,
+      kind: workload,
       interval,
       metric: metricKind,
-      model: emptyToUndefined(model),
+      model: showLlmFields ? emptyToUndefined(model) : void 0,
       namespace: context.scope.namespace || void 0,
+      operation: showResourceFields ? emptyToUndefined(operation) : void 0,
       participantId: emptyToUndefined(participantId),
       participantType,
-      provider: emptyToUndefined(provider),
+      provider: showLlmFields ? emptyToUndefined(provider) : void 0,
+      resource: showResourceFields ? emptyToUndefined(resource) : void 0,
+      status: status === "all" ? void 0 : status,
       threadId: emptyToUndefined(threadId),
       to: range.to
     }).then((next) => {
@@ -3178,12 +3307,18 @@ function UsagePage({ context }) {
     interval,
     metricKind,
     model,
+    operation,
     participantId,
     participantType,
     provider,
     range.from,
     range.to,
-    threadId
+    resource,
+    showLlmFields,
+    showResourceFields,
+    status,
+    threadId,
+    workload
   ]);
   const points = usage?.points ?? [];
   const totals = usage?.totals ?? EMPTY_USAGE_TOTALS;
@@ -3200,9 +3335,10 @@ function UsagePage({ context }) {
       PageHeader,
       {
         title: "Usage",
-        description: "Inspect cost, token, and call attribution across namespaces, models, participants, threads, and providers.",
+        description: "Inspect metered LLM, tool, and resource activity by workload, actor, status, cost, duration, tokens, and credits.",
         badges: [
-          { label: period },
+          { label: workload },
+          { label: getUsageMetricLabel(metricKind), variant: "secondary" },
           { label: getUsageGroupLabel(groupBy), variant: "secondary" },
           ...isLoading ? [{ label: "Loading" }] : []
         ]
@@ -3230,10 +3366,21 @@ function UsagePage({ context }) {
       /* @__PURE__ */ jsx27(
         UsageSelect,
         {
-          label: "Metric",
+          label: "Workload",
+          onValueChange: (value) => setWorkload(value),
+          options: USAGE_WORKLOADS,
+          value: workload,
+          formatOption: getUsageKindLabel
+        }
+      ),
+      /* @__PURE__ */ jsx27(
+        UsageSelect,
+        {
+          label: "Measure",
           onValueChange: (value) => setMetricKind(value),
-          options: ["cost", "tokens", "calls"],
-          value: metricKind
+          options: metricOptions,
+          value: metricKind,
+          formatOption: getUsageMetricLabel
         }
       ),
       /* @__PURE__ */ jsx27(
@@ -3241,20 +3388,22 @@ function UsagePage({ context }) {
         {
           label: "Group",
           onValueChange: (value) => setGroupBy(value),
-          options: ["participant", "thread", "namespace", "provider", "model"],
-          value: groupBy
+          options: groupOptions,
+          value: groupBy,
+          formatOption: getUsageGroupLabel
         }
       ),
       /* @__PURE__ */ jsx27(
         UsageSelect,
         {
-          label: "Attribution",
+          label: "Actor",
           onValueChange: (value) => setAttribution(value),
           options: ["initiatedBy", "generatedBy"],
-          value: attribution
+          value: attribution,
+          formatOption: getUsageAttributionLabel
         }
       ),
-      /* @__PURE__ */ jsx27(
+      showDimension && /* @__PURE__ */ jsx27(
         UsageSelect,
         {
           label: "Dimension",
@@ -3289,12 +3438,21 @@ function UsagePage({ context }) {
       /* @__PURE__ */ jsx27(
         UsageSelect,
         {
-          label: "Type",
+          label: "Actor type",
           onValueChange: (value) => setParticipantType(value),
           options: ["all", "human", "agent", "job"],
           value: participantType
         }
       ),
+      /* @__PURE__ */ jsx27(
+        UsageSelect,
+        {
+          label: "Status",
+          onValueChange: (value) => setStatus(value),
+          options: STATUS_OPTIONS,
+          value: status
+        }
+      ),
       /* @__PURE__ */ jsx27(
         Input,
         {
@@ -3313,46 +3471,86 @@ function UsagePage({ context }) {
           value: participantId
         }
       ),
-      /* @__PURE__ */ jsx27(
-        Input,
-        {
-          className: "h-8 w-[140px]",
-          onChange: (event) => setProvider(event.target.value),
-          placeholder: "Provider",
-          value: provider
-        }
-      ),
-      /* @__PURE__ */ jsx27(
-        Input,
-        {
-          className: "h-8 w-[140px]",
-          onChange: (event) => setModel(event.target.value),
-          placeholder: "Model",
-          value: model
-        }
-      )
+      showResourceFields && /* @__PURE__ */ jsxs19(Fragment2, { children: [
+        /* @__PURE__ */ jsx27(
+          Input,
+          {
+            className: "h-8 w-[170px]",
+            onChange: (event) => setResource(event.target.value),
+            placeholder: "Resource / tool",
+            value: resource
+          }
+        ),
+        /* @__PURE__ */ jsx27(
+          Input,
+          {
+            className: "h-8 w-[150px]",
+            onChange: (event) => setOperation(event.target.value),
+            placeholder: "Operation",
+            value: operation
+          }
+        )
+      ] }),
+      showLlmFields && /* @__PURE__ */ jsxs19(Fragment2, { children: [
+        /* @__PURE__ */ jsx27(
+          Input,
+          {
+            className: "h-8 w-[140px]",
+            onChange: (event) => setProvider(event.target.value),
+            placeholder: "Provider",
+            value: provider
+          }
+        ),
+        /* @__PURE__ */ jsx27(
+          Input,
+          {
+            className: "h-8 w-[140px]",
+            onChange: (event) => setModel(event.target.value),
+            placeholder: "Model",
+            value: model
+          }
+        )
+      ] })
     ] }),
     /* @__PURE__ */ jsx27(
       MetricStrip,
       {
         items: [
           {
-            detail: `${totals.totalCalls} calls`,
+            detail: `${formatMetricValue(totals.unpricedCalls, "unpriced")} unpriced`,
             icon: DollarSign,
-            label: "Cost",
+            label: "Spend",
             value: formatMetricValue(totals.totalCostUsd, "cost")
           },
           {
-            detail: `${formatMetricValue(totals.inputTokens, "tokens")} input`,
+            detail: `${formatMetricValue(totals.failedCalls, "failures")} failed`,
             icon: Activity3,
+            label: "Calls",
+            value: formatMetricValue(totals.totalCalls, "calls")
+          },
+          {
+            detail: "Tool and resource runtime",
+            icon: Clock,
+            label: "Duration",
+            value: formatMetricValue(totals.totalDurationMs, "duration")
+          },
+          {
+            detail: `${formatMetricValue(totals.inputTokens, "tokens")} input`,
+            icon: Sparkles2,
             label: "Tokens",
             value: formatMetricValue(totals.totalTokens, "tokens")
           },
           {
-            detail: `${formatMetricValue(totals.reasoningTokens, "tokens")} reasoning`,
-            icon: Sparkles2,
-            label: "Calls",
-            value: formatMetricValue(totals.totalCalls, "calls")
+            detail: "Custom metering",
+            icon: Coins,
+            label: "Credits",
+            value: formatMetricValue(totals.totalCredits, "credits")
+          },
+          {
+            detail: "Failed or aborted work",
+            icon: AlertTriangle2,
+            label: "Failures",
+            value: formatMetricValue(totals.failedCalls, "failures")
           }
         ]
       }
@@ -3361,7 +3559,7 @@ function UsagePage({ context }) {
       EmptyState,
       {
         title: "No usage",
-        description: "Usage records will appear here when provider-native usage is captured."
+        description: "Metered LLM, tool, and resource records will appear here after work is captured in the usage ledger."
       }
     ) : /* @__PURE__ */ jsxs19(Fragment2, { children: [
       /* @__PURE__ */ jsx27(Card, { className: "h-[320px] py-3", children: /* @__PURE__ */ jsx27(CardContent, { className: "h-full px-3", children: /* @__PURE__ */ jsx27(UsageChart, { chartState, metricKind }) }) }),
@@ -3440,6 +3638,7 @@ function UsageRowsTable({
   totals
 }) {
   const totalValue = getUsageTotalValue(totals, metricKind, dimension);
+  const valueHeader = (metricKind === "tokens" || metricKind === "cost") && dimension !== "total" ? `${getUsageDimensionLabel(dimension)} ${getUsageMetricLabel(metricKind)}` : getUsageMetricLabel(metricKind);
   return /* @__PURE__ */ jsx27(
     ResourceTable,
     {
@@ -3457,7 +3656,7 @@ function UsageRowsTable({
         {
           align: "right",
           id: "value",
-          header: `${getUsageDimensionLabel(dimension)} ${metricKind}`,
+          header: valueHeader,
           render: (row) => formatMetricValue(row.value, metricKind)
         },
         {
@@ -3474,20 +3673,100 @@ function UsageRowsTable({
         },
         {
           align: "right",
-          id: "input",
-          header: "Input",
-          render: (row) => formatMetricValue(getUsageTotalValue(row, metricKind, "input"), metricKind)
+          id: "spend",
+          header: "Spend",
+          render: (row) => formatMetricValue(row.totalCostUsd, "cost")
         },
         {
           align: "right",
-          id: "output",
-          header: "Output",
-          render: (row) => formatMetricValue(getUsageTotalValue(row, metricKind, "output"), metricKind)
+          id: "duration",
+          header: "Duration",
+          render: (row) => formatMetricValue(row.totalDurationMs, "duration")
+        },
+        {
+          align: "right",
+          id: "tokens",
+          header: "Tokens",
+          render: (row) => formatMetricValue(row.totalTokens, "tokens")
+        },
+        {
+          align: "right",
+          id: "failures",
+          header: "Failures",
+          render: (row) => formatMetricValue(row.failedCalls, "failures")
+        },
+        {
+          align: "right",
+          id: "unpriced",
+          header: "Unpriced",
+          render: (row) => formatMetricValue(row.unpricedCalls, "unpriced")
         }
       ]
     }
   );
 }
+function getUsageMetricOptions(workload) {
+  if (workload === "llm") {
+    return ["cost", "tokens", "calls", "failures", "unpriced"];
+  }
+  if (workload === "tool") {
+    return ["calls", "duration", "cost", "credits", "failures", "unpriced"];
+  }
+  return [
+    "calls",
+    "cost",
+    "duration",
+    "tokens",
+    "credits",
+    "failures",
+    "unpriced"
+  ];
+}
+function getUsageGroupOptions(workload) {
+  if (workload === "llm") {
+    return ["participant", "model", "provider", "thread", "namespace", "status"];
+  }
+  if (workload === "tool") {
+    return [
+      "resource",
+      "operation",
+      "status",
+      "participant",
+      "thread",
+      "namespace"
+    ];
+  }
+  return [
+    "kind",
+    "resource",
+    "operation",
+    "status",
+    "participant",
+    "thread",
+    "namespace"
+  ];
+}
+function getUsageKindLabel(kind) {
+  switch (kind) {
+    case "all":
+      return "All";
+    case "llm":
+      return "LLM";
+    case "tool":
+      return "Tools";
+    case "asset":
+      return "Assets";
+    case "rag":
+      return "RAG";
+    case "embedding":
+      return "Embeddings";
+    default:
+      return kind;
+  }
+}
+function getUsageAttributionLabel(attribution) {
+  return attribution === "initiatedBy" ? "Initiator" : "Performer";
+}
 function emptyToUndefined(value) {
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : void 0;
@@ -3975,6 +4254,7 @@ export {
   formatUsageBucket,
   getUsageDimensionLabel,
   getUsageGroupLabel,
+  getUsageMetricLabel,
   getUsageRange,
   getUsageTotalValue,
   mergeAdminConfig,