@copilotz/admin 0.9.34 → 0.9.36

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, ComponentType } from 'react';
+import React, { ReactNode, ComponentType } from 'react';
+import { LucideIcon } from 'lucide-react';
 
 type RequestHeadersProvider = () => Record<string, string> | Promise<Record<string, string>>;
 type AdminDatePreset = "24h" | "7d" | "30d";
@@ -455,4 +456,71 @@ interface UseCopilotzAdminResult {
 /** @deprecated Prefer the module-based CopilotzAdmin shell and createAdminClient. */
 declare function useCopilotzAdmin(options?: UseCopilotzAdminOptions): UseCopilotzAdminResult;
 
-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, type LegacyAdminConfig, type RequestHeadersProvider, 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 };
+declare function EmptyState({ action, description, icon: Icon, title, }: {
+    action?: React.ReactNode;
+    description?: React.ReactNode;
+    icon?: LucideIcon;
+    title: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare function FilterBar({ actions, children, onSearchChange, searchPlaceholder, searchValue, }: {
+    actions?: React.ReactNode;
+    children?: React.ReactNode;
+    onSearchChange?: (value: string) => void;
+    searchPlaceholder?: string;
+    searchValue?: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare function InspectorPanel({ children, className, side, }: {
+    children: React.ReactNode;
+    className?: string;
+    side?: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare function JsonPanel({ minHeight, onSave, title, value, }: {
+    minHeight?: number;
+    onSave?: (value: Record<string, unknown>) => Promise<void> | void;
+    title?: string;
+    value: unknown;
+}): react_jsx_runtime.JSX.Element;
+
+interface MetricStripItem {
+    label: string;
+    value: React.ReactNode;
+    detail?: React.ReactNode;
+    icon?: LucideIcon;
+}
+declare function MetricStrip({ items }: {
+    items: MetricStripItem[];
+}): react_jsx_runtime.JSX.Element;
+
+declare function PageHeader({ actions, badges, description, title, }: {
+    actions?: React.ReactNode;
+    badges?: Array<{
+        label: string;
+        variant?: "default" | "secondary" | "outline" | "destructive";
+    }>;
+    description?: React.ReactNode;
+    title: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+interface ResourceTableColumn<T> {
+    id: string;
+    header: React.ReactNode;
+    align?: "left" | "right";
+    className?: string;
+    render: (row: T) => React.ReactNode;
+}
+declare function ResourceTable<T>({ columns, empty, getRowKey, onRowClick, rows, }: {
+    columns: Array<ResourceTableColumn<T>>;
+    empty?: React.ReactNode;
+    getRowKey: (row: T, index: number) => string;
+    onRowClick?: (row: T) => void;
+    rows: T[];
+}): react_jsx_runtime.JSX.Element;
+
+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 };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, ComponentType } from 'react';
+import React, { ReactNode, ComponentType } from 'react';
+import { LucideIcon } from 'lucide-react';
 
 type RequestHeadersProvider = () => Record<string, string> | Promise<Record<string, string>>;
 type AdminDatePreset = "24h" | "7d" | "30d";
@@ -455,4 +456,71 @@ interface UseCopilotzAdminResult {
 /** @deprecated Prefer the module-based CopilotzAdmin shell and createAdminClient. */
 declare function useCopilotzAdmin(options?: UseCopilotzAdminOptions): UseCopilotzAdminResult;
 
-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, type LegacyAdminConfig, type RequestHeadersProvider, 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 };
+declare function EmptyState({ action, description, icon: Icon, title, }: {
+    action?: React.ReactNode;
+    description?: React.ReactNode;
+    icon?: LucideIcon;
+    title: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare function FilterBar({ actions, children, onSearchChange, searchPlaceholder, searchValue, }: {
+    actions?: React.ReactNode;
+    children?: React.ReactNode;
+    onSearchChange?: (value: string) => void;
+    searchPlaceholder?: string;
+    searchValue?: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare function InspectorPanel({ children, className, side, }: {
+    children: React.ReactNode;
+    className?: string;
+    side?: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare function JsonPanel({ minHeight, onSave, title, value, }: {
+    minHeight?: number;
+    onSave?: (value: Record<string, unknown>) => Promise<void> | void;
+    title?: string;
+    value: unknown;
+}): react_jsx_runtime.JSX.Element;
+
+interface MetricStripItem {
+    label: string;
+    value: React.ReactNode;
+    detail?: React.ReactNode;
+    icon?: LucideIcon;
+}
+declare function MetricStrip({ items }: {
+    items: MetricStripItem[];
+}): react_jsx_runtime.JSX.Element;
+
+declare function PageHeader({ actions, badges, description, title, }: {
+    actions?: React.ReactNode;
+    badges?: Array<{
+        label: string;
+        variant?: "default" | "secondary" | "outline" | "destructive";
+    }>;
+    description?: React.ReactNode;
+    title: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+interface ResourceTableColumn<T> {
+    id: string;
+    header: React.ReactNode;
+    align?: "left" | "right";
+    className?: string;
+    render: (row: T) => React.ReactNode;
+}
+declare function ResourceTable<T>({ columns, empty, getRowKey, onRowClick, rows, }: {
+    columns: Array<ResourceTableColumn<T>>;
+    empty?: React.ReactNode;
+    getRowKey: (row: T, index: number) => string;
+    onRowClick?: (row: T) => void;
+    rows: T[];
+}): react_jsx_runtime.JSX.Element;
+
+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 };

package/dist/index.js

@@ -43,11 +43,44 @@ async function mergeHeaders(headers, getRequestHeaders) {
 async function parseJsonResponse(response) {
   const payload = await response.json().catch(() => null);
   if (!response.ok) {
-    const message = payload?.message ?? payload?.data?.message ?? `Admin request failed (${response.status})`;
+    const message = payload?.message ?? payload?.data?.message ?? payload?.error?.message ?? `Admin request failed (${response.status})`;
     throw new Error(message);
   }
   return payload?.data ?? payload;
 }
+async function parseJsonEnvelopeResponse(response) {
+  const payload = await response.json().catch(() => null);
+  if (!response.ok) {
+    const message = payload?.message ?? payload?.data?.message ?? payload?.error?.message ?? `Admin request failed (${response.status})`;
+    throw new Error(message);
+  }
+  return payload;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeMessagePageInfo(value, messages) {
+  const oldestFromData = messages[0]?.id ?? null;
+  const newestFromData = messages[messages.length - 1]?.id ?? null;
+  if (!isRecord(value)) {
+    return {
+      hasMoreBefore: false,
+      oldestMessageId: oldestFromData,
+      newestMessageId: newestFromData
+    };
+  }
+  return {
+    hasMoreBefore: value.hasMoreBefore === true,
+    oldestMessageId: typeof value.oldestMessageId === "string" ? value.oldestMessageId : oldestFromData,
+    newestMessageId: typeof value.newestMessageId === "string" ? value.newestMessageId : newestFromData
+  };
+}
+function normalizeMessagePage(payload) {
+  const candidate = isRecord(payload) && isRecord(payload.data) && Array.isArray(payload.data.data) ? payload.data : payload;
+  const data = isRecord(candidate) && Array.isArray(candidate.data) ? candidate.data : Array.isArray(candidate) ? candidate : [];
+  const pageInfo = isRecord(candidate) ? normalizeMessagePageInfo(candidate.pageInfo, data) : normalizeMessagePageInfo(void 0, data);
+  return { data, pageInfo };
+}
 function createAdminClient(options = {}) {
   const baseUrl = resolveBaseUrl(options.baseUrl);
   const paths = { ...DEFAULT_PATHS, ...options.paths };
@@ -58,6 +91,13 @@ function createAdminClient(options = {}) {
     });
     return await parseJsonResponse(response);
   };
+  const requestEnvelopeJson = async (path, params) => {
+    const url = buildUrl(baseUrl, path, params);
+    const response = await fetch(url.toString(), {
+      headers: await mergeHeaders({}, options.getRequestHeaders)
+    });
+    return await parseJsonEnvelopeResponse(response);
+  };
   const writeJson = async (method, path, data, params) => {
     const url = buildUrl(baseUrl, path, params);
     const response = await fetch(url.toString(), {
@@ -133,13 +173,16 @@ function createAdminClient(options = {}) {
     getThread: async (threadId) => await requestJson(
       `${paths.threadsBase}/${encodeURIComponent(threadId)}`
     ),
-    getThreadMessages: async (threadId, messageOptions = {}) => await requestJson(
-      `${paths.threadsBase}/${encodeURIComponent(threadId)}/messages`,
-      {
-        limit: messageOptions.limit ? String(messageOptions.limit) : void 0,
-        before: messageOptions.before
-      }
-    ),
+    getThreadMessages: async (threadId, messageOptions = {}) => {
+      const payload = await requestEnvelopeJson(
+        `${paths.threadsBase}/${encodeURIComponent(threadId)}/messages`,
+        {
+          limit: messageOptions.limit ? String(messageOptions.limit) : void 0,
+          before: messageOptions.before
+        }
+      );
+      return normalizeMessagePage(payload);
+    },
     getThreadEvent: async (threadId) => await requestJson(
       `${paths.threadsBase}/${encodeURIComponent(threadId)}/events`
     ),
@@ -2704,7 +2747,9 @@ function ThreadsPage({ context }) {
             align: "right",
             id: "participants",
             header: "Participants",
-            render: (thread) => formatNumber(thread.participantIds.length)
+            render: (thread) => formatNumber(
+              Array.isArray(thread.participantIds) ? thread.participantIds.length : 0
+            )
           },
           {
             align: "right",
@@ -2755,8 +2800,8 @@ function ThreadInspector({
     ]).then(([nextThread, page]) => {
       if (!active) return;
       setThread(nextThread);
-      setMessages(page.data);
-      setPageInfo(page.pageInfo);
+      setMessages(Array.isArray(page?.data) ? page.data : []);
+      setPageInfo(page?.pageInfo ?? null);
     }).catch((cause) => {
       if (active) setError(cause instanceof Error ? cause.message : "Failed to load thread");
     }).finally(() => {
@@ -2776,8 +2821,11 @@ function ThreadInspector({
         before: pageInfo.oldestMessageId,
         limit: MESSAGE_PAGE_SIZE
       });
-      setMessages((current) => [...page.data, ...current]);
-      setPageInfo(page.pageInfo);
+      setMessages((current) => [
+        ...Array.isArray(page?.data) ? page.data : [],
+        ...current
+      ]);
+      setPageInfo(page?.pageInfo ?? null);
     } finally {
       setIsLoadingMore(false);
     }
@@ -3898,6 +3946,14 @@ export {
   ADMIN_GROUP_ORDER,
   CopilotzAdmin,
   EMPTY_USAGE_TOTALS,
+  EmptyState,
+  FilterBar,
+  InspectorPanel,
+  JsonPanel,
+  MetricStrip,
+  PageHeader,
+  ResourceTable,
+  StatusBadge,
   addUsageTotals,
   agentsModule,
   aggregateUsageRows,