@copilotz/admin 0.9.36 → 0.9.38

package/dist/index.d.cts

@@ -6,8 +6,9 @@ type RequestHeadersProvider = () => Record<string, string> | Promise<Record<stri
 type AdminDatePreset = "24h" | "7d" | "30d";
 type AdminActivityInterval = "hour" | "day";
 type AdminUsageInterval = "minute" | "hour" | "day" | "week" | "month";
-type AdminUsageMetricKind = "tokens" | "cost" | "calls";
-type AdminUsageGroupBy = "thread" | "participant" | "namespace" | "provider" | "model";
+type AdminUsageKind = "all" | "llm" | "tool" | "asset" | "rag" | "embedding" | (string & {});
+type AdminUsageMetricKind = "tokens" | "cost" | "calls" | "duration" | "credits" | "failures" | "unpriced";
+type AdminUsageGroupBy = "kind" | "resource" | "operation" | "status" | "thread" | "participant" | "namespace" | "provider" | "model";
 type AdminUsageAttribution = "generatedBy" | "initiatedBy";
 type AdminUsageDimension = "total" | "input" | "output" | "reasoning" | "cacheRead" | "cacheWrite";
 interface AdminUsageBreakdown {
@@ -26,6 +27,10 @@ interface AdminUsageBreakdown {
 }
 interface AdminUsageTotals extends AdminUsageBreakdown {
     totalCalls: number;
+    failedCalls: number;
+    unpricedCalls: number;
+    totalDurationMs: number;
+    totalCredits: number;
 }
 interface AdminOverview {
     threadTotals: {
@@ -111,12 +116,26 @@ interface AdminUsageFilters {
     metric?: AdminUsageMetricKind;
     groupBy?: AdminUsageGroupBy;
     attribution?: AdminUsageAttribution;
+    kind?: AdminUsageKind;
     threadId?: string;
     participantId?: string;
     participantType?: "all" | "human" | "agent" | "job";
     namespace?: string;
     provider?: string;
     model?: string;
+    resource?: string;
+    operation?: string;
+    status?: string;
+}
+interface AdminEventFilters {
+    namespace?: string;
+    threadId?: string;
+    status?: string;
+    eventType?: string;
+    traceId?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
 }
 interface AdminThreadDetail {
     id: string;
@@ -227,6 +246,7 @@ interface CopilotzAdminClient {
         limit?: number;
         before?: string;
     }): Promise<AdminMessagePage>;
+    listEvents(options?: AdminEventFilters): Promise<AdminQueueEvent[]>;
     getThreadEvent(threadId: string): Promise<AdminQueueEvent | undefined>;
     listCollections(): Promise<string[]>;
     listCollectionItems(collection: string, options?: AdminListOptions): Promise<AdminCollectionItem[]>;
@@ -415,7 +435,8 @@ declare function getUsageRange(period: "24h" | "7d" | "30d" | "custom", customFr
     to: string | undefined;
 };
 declare function getUsageDimensionLabel(dimension: AdminUsageDimension): "Input" | "Output" | "Reasoning" | "Cache read" | "Cache write" | "Total";
-declare function getUsageGroupLabel(groupBy: string): "Thread" | "Namespace" | "Provider" | "Model" | "Participant";
+declare function getUsageGroupLabel(groupBy: string): "Kind" | "Resource" | "Operation" | "Status" | "Thread" | "Namespace" | "Provider" | "Model" | "Participant";
+declare function getUsageMetricLabel(metricKind: AdminUsageMetricKind): "Spend" | "Tokens" | "Duration" | "Credits" | "Failures" | "Unpriced" | "Calls";
 declare function formatUsageBucket(bucket: string, interval: AdminUsageInterval): string;
 declare function formatNumber(value: number): string;
 declare function formatPercent(value: number): string;
@@ -523,4 +544,4 @@ declare function StatusBadge({ status }: {
     status?: string | null;
 }): react_jsx_runtime.JSX.Element;
 
-export { ADMIN_GROUP_LABELS, ADMIN_GROUP_ORDER, type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminBranding, type AdminClientConfig, type AdminClientOptions, type AdminClientPaths, type AdminCollectionItem, type AdminCollectionPage, type AdminDatePreset, type AdminDetailPanel, type AdminMessage, type AdminMessagePage, type AdminMessagePageInfo, type AdminModule, type AdminModuleGroup, type AdminNavItem, type AdminOverview, type AdminParticipantDetail, type AdminParticipantSummary, type AdminPermissions, type AdminQueueEvent, type AdminRouteDefinition, type AdminRouteState, type AdminRuntimeContext, type AdminScope, type AdminThreadDetail, type AdminThreadSummary, type AdminUsageAttribution, type AdminUsageBreakdown, type AdminUsageDimension, type AdminUsageFilters, type AdminUsageGroupBy, type AdminUsageInterval, type AdminUsageMetricKind, type AdminUsagePoint, type AdminUsageResponse, type AdminUsageTotals, type AggregatedUsageRow, type CollectionEditor, type CollectionEditorProps, CopilotzAdmin, type CopilotzAdminClient, type CopilotzAdminProps, EMPTY_USAGE_TOTALS, EmptyState, FilterBar, InspectorPanel, JsonPanel, type LegacyAdminConfig, MetricStrip, type MetricStripItem, PageHeader, type RequestHeadersProvider, ResourceTable, type ResourceTableColumn, StatusBadge, type UsageCalculationOptions, type UsageChartSeries, type UsageChartState, type UseCopilotzAdminOptions, type UseCopilotzAdminResult, addUsageTotals, agentsModule, aggregateUsageRows, buildUsageChartState, canAccessAdminPermission, collectAdminNavItems, collectAdminRoutes, collectCollectionEditors, collectionsModule, createAdminClient, defaultAdminConfig, defaultCopilotzModules, eventsModule, firstAccessibleRoute, formatCompactMetric, formatMetricValue, formatNumber, formatPercent, formatUsageBucket, getUsageDimensionLabel, getUsageGroupLabel, getUsageRange, getUsageTotalValue, mergeAdminConfig, overviewModule, participantsModule, threadsModule, usageModule, useAdmin, useCopilotzAdmin };
+export { ADMIN_GROUP_LABELS, ADMIN_GROUP_ORDER, type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminBranding, type AdminClientConfig, type AdminClientOptions, type AdminClientPaths, type AdminCollectionItem, type AdminCollectionPage, type AdminDatePreset, type AdminDetailPanel, type AdminEventFilters, type AdminMessage, type AdminMessagePage, type AdminMessagePageInfo, type AdminModule, type AdminModuleGroup, type AdminNavItem, type AdminOverview, type AdminParticipantDetail, type AdminParticipantSummary, type AdminPermissions, type AdminQueueEvent, type AdminRouteDefinition, type AdminRouteState, type AdminRuntimeContext, type AdminScope, type AdminThreadDetail, type AdminThreadSummary, type AdminUsageAttribution, type AdminUsageBreakdown, type AdminUsageDimension, type AdminUsageFilters, type AdminUsageGroupBy, type AdminUsageInterval, type AdminUsageKind, type AdminUsageMetricKind, type AdminUsagePoint, type AdminUsageResponse, type AdminUsageTotals, type AggregatedUsageRow, type CollectionEditor, type CollectionEditorProps, CopilotzAdmin, type CopilotzAdminClient, type CopilotzAdminProps, EMPTY_USAGE_TOTALS, EmptyState, FilterBar, InspectorPanel, JsonPanel, type LegacyAdminConfig, MetricStrip, type MetricStripItem, PageHeader, type RequestHeadersProvider, ResourceTable, type ResourceTableColumn, StatusBadge, type UsageCalculationOptions, type UsageChartSeries, type UsageChartState, type UseCopilotzAdminOptions, type UseCopilotzAdminResult, addUsageTotals, agentsModule, aggregateUsageRows, buildUsageChartState, canAccessAdminPermission, collectAdminNavItems, collectAdminRoutes, collectCollectionEditors, collectionsModule, createAdminClient, defaultAdminConfig, defaultCopilotzModules, eventsModule, firstAccessibleRoute, formatCompactMetric, formatMetricValue, formatNumber, formatPercent, formatUsageBucket, getUsageDimensionLabel, getUsageGroupLabel, getUsageMetricLabel, getUsageRange, getUsageTotalValue, mergeAdminConfig, overviewModule, participantsModule, threadsModule, usageModule, useAdmin, useCopilotzAdmin };

package/dist/index.d.ts

@@ -6,8 +6,9 @@ type RequestHeadersProvider = () => Record<string, string> | Promise<Record<stri
 type AdminDatePreset = "24h" | "7d" | "30d";
 type AdminActivityInterval = "hour" | "day";
 type AdminUsageInterval = "minute" | "hour" | "day" | "week" | "month";
-type AdminUsageMetricKind = "tokens" | "cost" | "calls";
-type AdminUsageGroupBy = "thread" | "participant" | "namespace" | "provider" | "model";
+type AdminUsageKind = "all" | "llm" | "tool" | "asset" | "rag" | "embedding" | (string & {});
+type AdminUsageMetricKind = "tokens" | "cost" | "calls" | "duration" | "credits" | "failures" | "unpriced";
+type AdminUsageGroupBy = "kind" | "resource" | "operation" | "status" | "thread" | "participant" | "namespace" | "provider" | "model";
 type AdminUsageAttribution = "generatedBy" | "initiatedBy";
 type AdminUsageDimension = "total" | "input" | "output" | "reasoning" | "cacheRead" | "cacheWrite";
 interface AdminUsageBreakdown {
@@ -26,6 +27,10 @@ interface AdminUsageBreakdown {
 }
 interface AdminUsageTotals extends AdminUsageBreakdown {
     totalCalls: number;
+    failedCalls: number;
+    unpricedCalls: number;
+    totalDurationMs: number;
+    totalCredits: number;
 }
 interface AdminOverview {
     threadTotals: {
@@ -111,12 +116,26 @@ interface AdminUsageFilters {
     metric?: AdminUsageMetricKind;
     groupBy?: AdminUsageGroupBy;
     attribution?: AdminUsageAttribution;
+    kind?: AdminUsageKind;
     threadId?: string;
     participantId?: string;
     participantType?: "all" | "human" | "agent" | "job";
     namespace?: string;
     provider?: string;
     model?: string;
+    resource?: string;
+    operation?: string;
+    status?: string;
+}
+interface AdminEventFilters {
+    namespace?: string;
+    threadId?: string;
+    status?: string;
+    eventType?: string;
+    traceId?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
 }
 interface AdminThreadDetail {
     id: string;
@@ -227,6 +246,7 @@ interface CopilotzAdminClient {
         limit?: number;
         before?: string;
     }): Promise<AdminMessagePage>;
+    listEvents(options?: AdminEventFilters): Promise<AdminQueueEvent[]>;
     getThreadEvent(threadId: string): Promise<AdminQueueEvent | undefined>;
     listCollections(): Promise<string[]>;
     listCollectionItems(collection: string, options?: AdminListOptions): Promise<AdminCollectionItem[]>;
@@ -415,7 +435,8 @@ declare function getUsageRange(period: "24h" | "7d" | "30d" | "custom", customFr
     to: string | undefined;
 };
 declare function getUsageDimensionLabel(dimension: AdminUsageDimension): "Input" | "Output" | "Reasoning" | "Cache read" | "Cache write" | "Total";
-declare function getUsageGroupLabel(groupBy: string): "Thread" | "Namespace" | "Provider" | "Model" | "Participant";
+declare function getUsageGroupLabel(groupBy: string): "Kind" | "Resource" | "Operation" | "Status" | "Thread" | "Namespace" | "Provider" | "Model" | "Participant";
+declare function getUsageMetricLabel(metricKind: AdminUsageMetricKind): "Spend" | "Tokens" | "Duration" | "Credits" | "Failures" | "Unpriced" | "Calls";
 declare function formatUsageBucket(bucket: string, interval: AdminUsageInterval): string;
 declare function formatNumber(value: number): string;
 declare function formatPercent(value: number): string;
@@ -523,4 +544,4 @@ declare function StatusBadge({ status }: {
     status?: string | null;
 }): react_jsx_runtime.JSX.Element;
 
-export { ADMIN_GROUP_LABELS, ADMIN_GROUP_ORDER, type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminBranding, type AdminClientConfig, type AdminClientOptions, type AdminClientPaths, type AdminCollectionItem, type AdminCollectionPage, type AdminDatePreset, type AdminDetailPanel, type AdminMessage, type AdminMessagePage, type AdminMessagePageInfo, type AdminModule, type AdminModuleGroup, type AdminNavItem, type AdminOverview, type AdminParticipantDetail, type AdminParticipantSummary, type AdminPermissions, type AdminQueueEvent, type AdminRouteDefinition, type AdminRouteState, type AdminRuntimeContext, type AdminScope, type AdminThreadDetail, type AdminThreadSummary, type AdminUsageAttribution, type AdminUsageBreakdown, type AdminUsageDimension, type AdminUsageFilters, type AdminUsageGroupBy, type AdminUsageInterval, type AdminUsageMetricKind, type AdminUsagePoint, type AdminUsageResponse, type AdminUsageTotals, type AggregatedUsageRow, type CollectionEditor, type CollectionEditorProps, CopilotzAdmin, type CopilotzAdminClient, type CopilotzAdminProps, EMPTY_USAGE_TOTALS, EmptyState, FilterBar, InspectorPanel, JsonPanel, type LegacyAdminConfig, MetricStrip, type MetricStripItem, PageHeader, type RequestHeadersProvider, ResourceTable, type ResourceTableColumn, StatusBadge, type UsageCalculationOptions, type UsageChartSeries, type UsageChartState, type UseCopilotzAdminOptions, type UseCopilotzAdminResult, addUsageTotals, agentsModule, aggregateUsageRows, buildUsageChartState, canAccessAdminPermission, collectAdminNavItems, collectAdminRoutes, collectCollectionEditors, collectionsModule, createAdminClient, defaultAdminConfig, defaultCopilotzModules, eventsModule, firstAccessibleRoute, formatCompactMetric, formatMetricValue, formatNumber, formatPercent, formatUsageBucket, getUsageDimensionLabel, getUsageGroupLabel, getUsageRange, getUsageTotalValue, mergeAdminConfig, overviewModule, participantsModule, threadsModule, usageModule, useAdmin, useCopilotzAdmin };
+export { ADMIN_GROUP_LABELS, ADMIN_GROUP_ORDER, type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminBranding, type AdminClientConfig, type AdminClientOptions, type AdminClientPaths, type AdminCollectionItem, type AdminCollectionPage, type AdminDatePreset, type AdminDetailPanel, type AdminEventFilters, type AdminMessage, type AdminMessagePage, type AdminMessagePageInfo, type AdminModule, type AdminModuleGroup, type AdminNavItem, type AdminOverview, type AdminParticipantDetail, type AdminParticipantSummary, type AdminPermissions, type AdminQueueEvent, type AdminRouteDefinition, type AdminRouteState, type AdminRuntimeContext, type AdminScope, type AdminThreadDetail, type AdminThreadSummary, type AdminUsageAttribution, type AdminUsageBreakdown, type AdminUsageDimension, type AdminUsageFilters, type AdminUsageGroupBy, type AdminUsageInterval, type AdminUsageKind, type AdminUsageMetricKind, type AdminUsagePoint, type AdminUsageResponse, type AdminUsageTotals, type AggregatedUsageRow, type CollectionEditor, type CollectionEditorProps, CopilotzAdmin, type CopilotzAdminClient, type CopilotzAdminProps, EMPTY_USAGE_TOTALS, EmptyState, FilterBar, InspectorPanel, JsonPanel, type LegacyAdminConfig, MetricStrip, type MetricStripItem, PageHeader, type RequestHeadersProvider, ResourceTable, type ResourceTableColumn, StatusBadge, type UsageCalculationOptions, type UsageChartSeries, type UsageChartState, type UseCopilotzAdminOptions, type UseCopilotzAdminResult, addUsageTotals, agentsModule, aggregateUsageRows, buildUsageChartState, canAccessAdminPermission, collectAdminNavItems, collectAdminRoutes, collectCollectionEditors, collectionsModule, createAdminClient, defaultAdminConfig, defaultCopilotzModules, eventsModule, firstAccessibleRoute, formatCompactMetric, formatMetricValue, formatNumber, formatPercent, formatUsageBucket, getUsageDimensionLabel, getUsageGroupLabel, getUsageMetricLabel, getUsageRange, getUsageTotalValue, mergeAdminConfig, overviewModule, participantsModule, threadsModule, usageModule, useAdmin, useCopilotzAdmin };