@copilotz/admin 0.9.37 → 0.9.38

package/dist/index.d.cts

@@ -127,6 +127,16 @@ interface AdminUsageFilters {
     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;
     name: string;
@@ -236,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[]>;
@@ -533,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 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 };
+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

@@ -127,6 +127,16 @@ interface AdminUsageFilters {
     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;
     name: string;
@@ -236,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[]>;
@@ -533,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 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 };
+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.js

@@ -81,6 +81,21 @@ function normalizeMessagePage(payload) {
   const pageInfo = isRecord(candidate) ? normalizeMessagePageInfo(candidate.pageInfo, data) : normalizeMessagePageInfo(void 0, data);
   return { data, pageInfo };
 }
+function isQueueEvent(value) {
+  return isRecord(value) && typeof value.id === "string" && typeof value.threadId === "string" && typeof value.eventType === "string";
+}
+function normalizeQueueEvent(value) {
+  if (isQueueEvent(value)) return value;
+  if (isRecord(value) && isQueueEvent(value.data)) return value.data;
+  return void 0;
+}
+function normalizeQueueEvents(value) {
+  if (Array.isArray(value)) return value.filter(isQueueEvent);
+  if (isRecord(value) && Array.isArray(value.data)) {
+    return value.data.filter(isQueueEvent);
+  }
+  return [];
+}
 function createAdminClient(options = {}) {
   const baseUrl = resolveBaseUrl(options.baseUrl);
   const paths = { ...DEFAULT_PATHS, ...options.paths };
@@ -187,9 +202,25 @@ function createAdminClient(options = {}) {
       );
       return normalizeMessagePage(payload);
     },
-    getThreadEvent: async (threadId) => await requestJson(
-      `${paths.threadsBase}/${encodeURIComponent(threadId)}/events`
-    ),
+    listEvents: async (eventOptions = {}) => {
+      const payload = await requestJson(`${paths.adminBase}/events`, {
+        namespace: eventOptions.namespace,
+        threadId: eventOptions.threadId,
+        status: eventOptions.status,
+        eventType: eventOptions.eventType,
+        traceId: eventOptions.traceId,
+        search: eventOptions.search,
+        limit: String(eventOptions.limit ?? 50),
+        offset: eventOptions.offset ? String(eventOptions.offset) : void 0
+      });
+      return normalizeQueueEvents(payload);
+    },
+    getThreadEvent: async (threadId) => {
+      const payload = await requestJson(
+        `${paths.threadsBase}/${encodeURIComponent(threadId)}/events`
+      );
+      return normalizeQueueEvent(payload);
+    },
     listCollections: async () => await requestJson(paths.collectionsBase),
     listCollectionItems: async (collection, listOptions = {}) => await requestJson(
       `${paths.collectionsBase}/${encodeURIComponent(collection)}`,
@@ -2186,33 +2217,61 @@ function eventsModule() {
     }]
   };
 }
+var EVENT_STATUSES = [
+  "all",
+  "pending",
+  "processing",
+  "completed",
+  "failed",
+  "expired",
+  "overwritten"
+];
 function EventsPage({ context }) {
   const [threadId, setThreadId] = React8.useState("");
-  const [status, setStatus] = React8.useState("");
-  const [type, setType] = React8.useState("");
+  const [status, setStatus] = React8.useState(
+    "all"
+  );
+  const [eventType, setEventType] = React8.useState("");
   const [traceId, setTraceId] = React8.useState("");
-  const [event, setEvent] = React8.useState(null);
+  const [events, setEvents] = React8.useState([]);
+  const [selectedEvent, setSelectedEvent] = React8.useState(null);
   const [error, setError] = React8.useState(null);
-  const [hasSearched, setHasSearched] = React8.useState(false);
+  const [loading, setLoading] = React8.useState(false);
+  const [hasLoaded, setHasLoaded] = React8.useState(false);
   const inspect = async () => {
-    if (!threadId.trim()) return;
-    setHasSearched(true);
+    setHasLoaded(true);
+    setLoading(true);
     setError(null);
     try {
-      const next = await context.client.getThreadEvent(threadId.trim());
-      setEvent(next ?? null);
+      const next = await context.client.listEvents({
+        namespace: context.scope.namespace || void 0,
+        threadId: threadId.trim() || void 0,
+        status: status === "all" ? void 0 : status,
+        eventType: eventType.trim() || void 0,
+        traceId: traceId.trim() || void 0,
+        limit: 50
+      });
+      setEvents(next);
+      setSelectedEvent(
+        (current) => current && next.some((event) => event.id === current.id) ? current : next[0] ?? null
+      );
     } catch (cause) {
       setError(cause instanceof Error ? cause.message : "Failed to load event");
-      setEvent(null);
+      setEvents([]);
+      setSelectedEvent(null);
+    } finally {
+      setLoading(false);
     }
   };
-  const rows = event && (!status || event.status.includes(status)) && (!type || event.eventType.includes(type)) && (!traceId || event.traceId?.includes(traceId)) ? [event] : [];
+  React8.useEffect(() => {
+    void inspect();
+  }, [context.client, context.refreshKey, context.scope.namespace]);
   return /* @__PURE__ */ jsxs14("div", { className: "space-y-4", children: [
     /* @__PURE__ */ jsx22(
       PageHeader,
       {
         title: "Events",
-        description: "Queue and event inspection. Current backend support is thread-focused; filters are ready for broader event listing."
+        description: "Queue and event inspection across the active namespace."
       }
     ),
     /* @__PURE__ */ jsxs14(
@@ -2221,13 +2280,13 @@ function EventsPage({ context }) {
         actions: /* @__PURE__ */ jsxs14(
           Button,
           {
-            disabled: !threadId.trim(),
+            disabled: loading,
             onClick: () => void inspect(),
             size: "sm",
             type: "button",
             children: [
               /* @__PURE__ */ jsx22(Search2, { className: "size-3" }),
-              "Inspect"
+              loading ? "Loading" : "Inspect"
             ]
           }
         ),
@@ -2236,37 +2295,45 @@ function EventsPage({ context }) {
             Input,
             {
               className: "h-8 w-[220px]",
-              onChange: (event2) => setThreadId(event2.target.value),
-              onKeyDown: (event2) => {
-                if (event2.key === "Enter") void inspect();
+              onChange: (event) => setThreadId(event.target.value),
+              onKeyDown: (event) => {
+                if (event.key === "Enter") void inspect();
               },
               placeholder: "Thread ID",
               value: threadId
             }
           ),
-          /* @__PURE__ */ jsx22(
-            Input,
+          /* @__PURE__ */ jsxs14(
+            Select,
             {
-              className: "h-8 w-[150px]",
-              onChange: (event2) => setStatus(event2.target.value),
-              placeholder: "Status",
-              value: status
+              value: status,
+              onValueChange: (value) => setStatus(value),
+              children: [
+                /* @__PURE__ */ jsx22(SelectTrigger, { className: "h-8 w-[150px] text-xs", "aria-label": "Status", children: /* @__PURE__ */ jsx22(SelectValue, {}) }),
+                /* @__PURE__ */ jsx22(SelectContent, { children: EVENT_STATUSES.map((option) => /* @__PURE__ */ jsx22(SelectItem, { value: option, children: option === "all" ? "All statuses" : option }, option)) })
+              ]
             }
           ),
           /* @__PURE__ */ jsx22(
             Input,
             {
               className: "h-8 w-[180px]",
-              onChange: (event2) => setType(event2.target.value),
+              onChange: (event) => setEventType(event.target.value),
+              onKeyDown: (event) => {
+                if (event.key === "Enter") void inspect();
+              },
               placeholder: "Event type",
-              value: type
+              value: eventType
             }
           ),
           /* @__PURE__ */ jsx22(
             Input,
             {
               className: "h-8 w-[180px]",
-              onChange: (event2) => setTraceId(event2.target.value),
+              onChange: (event) => setTraceId(event.target.value),
+              onKeyDown: (event) => {
+                if (event.key === "Enter") void inspect();
+              },
               placeholder: "Trace ID",
               value: traceId
             }
@@ -2274,27 +2341,34 @@ function EventsPage({ context }) {
         ]
       }
     ),
-    error ? /* @__PURE__ */ jsx22(EmptyState, { title: "Unable to inspect event", description: error }) : !hasSearched ? /* @__PURE__ */ jsx22(
+    error ? /* @__PURE__ */ jsx22(EmptyState, { title: "Unable to inspect event", description: error }) : !hasLoaded && loading ? /* @__PURE__ */ jsx22(
       EmptyState,
       {
         icon: Activity,
-        title: "Choose a thread",
-        description: "Enter a thread ID to inspect its next pending event."
+        title: "Loading events",
+        description: "Fetching recent queue events for the active namespace."
       }
     ) : /* @__PURE__ */ jsxs14("div", { className: "grid gap-4 xl:grid-cols-[1fr_420px]", children: [
       /* @__PURE__ */ jsx22(
         ResourceTable,
         {
-          rows,
+          rows: events,
           getRowKey: (row) => row.id,
+          onRowClick: setSelectedEvent,
           empty: /* @__PURE__ */ jsx22(
             EmptyState,
             {
-              title: "No matching event",
-              description: "No pending event matched the current filters."
+              title: "No matching events",
+              description: "No event rows matched the current filters."
             }
           ),
           columns: [
+            {
+              id: "thread",
+              header: "Thread",
+              className: "max-w-[180px] truncate font-mono text-xs",
+              render: (row) => row.threadId
+            },
             {
               id: "type",
               header: "Type",
@@ -2318,7 +2392,20 @@ function EventsPage({ context }) {
           ]
         }
       ),
-      /* @__PURE__ */ jsx22(JsonPanel, { title: "Event JSON", value: event, minHeight: 420 })
+      selectedEvent ? /* @__PURE__ */ jsx22(
+        JsonPanel,
+        {
+          title: "Event JSON",
+          value: selectedEvent,
+          minHeight: 420
+        }
+      ) : /* @__PURE__ */ jsx22(
+        EmptyState,
+        {
+          title: "No event selected",
+          description: "Select an event row to inspect its payload."
+        }
+      )
     ] })
   ] });
 }