@copilotz/admin 0.3.7 → 0.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -3,10 +3,28 @@ import React, { ReactNode } from 'react';
3
3
  type RequestHeadersProvider = () => Record<string, string> | Promise<Record<string, string>>;
4
4
  type AdminDatePreset = "24h" | "7d" | "30d";
5
5
  type AdminActivityInterval = "hour" | "day";
6
- type AdminPage = "dashboard" | "threads" | "thread-detail" | "participants" | "agents" | "events";
6
+ type AdminPage = "dashboard" | "threads" | "thread-detail" | "participants" | "participant-detail" | "agents" | "agent-detail" | "collection-items" | "collection-item-detail" | "events";
7
7
  interface AdminRoute {
8
8
  page: AdminPage;
9
9
  resourceId?: string;
10
+ collection?: string;
11
+ }
12
+ interface AdminUsageBreakdown {
13
+ inputTokens: number;
14
+ outputTokens: number;
15
+ reasoningTokens: number;
16
+ cacheReadInputTokens: number;
17
+ cacheCreationInputTokens: number;
18
+ totalTokens: number;
19
+ inputCostUsd: number;
20
+ outputCostUsd: number;
21
+ reasoningCostUsd: number;
22
+ cacheReadInputCostUsd: number;
23
+ cacheCreationInputCostUsd: number;
24
+ totalCostUsd: number;
25
+ }
26
+ interface AdminUsageTotals extends AdminUsageBreakdown {
27
+ totalCalls: number;
10
28
  }
11
29
  interface AdminOverview {
12
30
  threadTotals: {
@@ -32,22 +50,13 @@ interface AdminOverview {
32
50
  humans: number;
33
51
  agents: number;
34
52
  };
35
- llmTotals: {
36
- totalCalls: number;
37
- inputTokens: number;
38
- outputTokens: number;
39
- reasoningTokens: number;
40
- cacheReadInputTokens: number;
41
- cacheCreationInputTokens: number;
42
- totalTokens: number;
43
- };
53
+ llmTotals: AdminUsageTotals;
44
54
  }
45
- interface AdminActivityPoint {
55
+ interface AdminActivityPoint extends AdminUsageTotals {
46
56
  bucket: string;
47
57
  messageCount: number;
48
- llmCallCount: number;
49
58
  toolCallMessageCount: number;
50
- totalTokens: number;
59
+ llmCallCount: number;
51
60
  }
52
61
  interface AdminThreadSummary {
53
62
  threadId: string;
@@ -81,12 +90,18 @@ interface AdminAgentSummary {
81
90
  messageCount: number;
82
91
  llmCallCount: number;
83
92
  toolCallMessageCount: number;
84
- inputTokens: number;
85
- outputTokens: number;
86
- reasoningTokens: number;
87
- cacheReadInputTokens: number;
88
- cacheCreationInputTokens: number;
89
- totalTokens: number;
93
+ inputTokens: AdminUsageBreakdown["inputTokens"];
94
+ outputTokens: AdminUsageBreakdown["outputTokens"];
95
+ reasoningTokens: AdminUsageBreakdown["reasoningTokens"];
96
+ cacheReadInputTokens: AdminUsageBreakdown["cacheReadInputTokens"];
97
+ cacheCreationInputTokens: AdminUsageBreakdown["cacheCreationInputTokens"];
98
+ totalTokens: AdminUsageBreakdown["totalTokens"];
99
+ inputCostUsd: AdminUsageBreakdown["inputCostUsd"];
100
+ outputCostUsd: AdminUsageBreakdown["outputCostUsd"];
101
+ reasoningCostUsd: AdminUsageBreakdown["reasoningCostUsd"];
102
+ cacheReadInputCostUsd: AdminUsageBreakdown["cacheReadInputCostUsd"];
103
+ cacheCreationInputCostUsd: AdminUsageBreakdown["cacheCreationInputCostUsd"];
104
+ totalCostUsd: AdminUsageBreakdown["totalCostUsd"];
90
105
  lastActivityAt: string | null;
91
106
  }
92
107
  interface AdminThreadDetail {
@@ -126,6 +141,24 @@ interface AdminMessagePage {
126
141
  data: AdminMessage[];
127
142
  pageInfo: AdminMessagePageInfo;
128
143
  }
144
+ type AdminParticipantDetail = Record<string, unknown>;
145
+ type AdminCollectionItem = Record<string, unknown> & {
146
+ id?: string;
147
+ };
148
+ interface AdminQueueEvent {
149
+ id: string;
150
+ threadId: string;
151
+ eventType: string;
152
+ payload: unknown;
153
+ parentEventId: string | null;
154
+ traceId: string | null;
155
+ priority: number | null;
156
+ status: "pending" | "processing" | "completed" | "failed" | "expired" | "overwritten";
157
+ namespace: string | null;
158
+ metadata: Record<string, unknown> | null;
159
+ createdAt: string | null;
160
+ updatedAt: string | null;
161
+ }
129
162
  interface AdminFilters {
130
163
  namespace?: string;
131
164
  range?: AdminDatePreset;
@@ -164,7 +197,21 @@ interface AdminConfig {
164
197
  activeThreadsCard?: string;
165
198
  participantsCard?: string;
166
199
  tokensCard?: string;
200
+ costCard?: string;
167
201
  queueCard?: string;
202
+ llmUsageTitle?: string;
203
+ usageMetricLabel?: string;
204
+ usageDimensionLabel?: string;
205
+ usageMetricTokens?: string;
206
+ usageMetricCost?: string;
207
+ usageTotal?: string;
208
+ usageInput?: string;
209
+ usageOutput?: string;
210
+ usageReasoning?: string;
211
+ usageCacheRead?: string;
212
+ usageCacheWrite?: string;
213
+ usageCallsDetail?: string;
214
+ usageUnavailableDetail?: string;
168
215
  statusActive?: string;
169
216
  statusArchived?: string;
170
217
  scopeGlobal?: string;
@@ -174,6 +221,8 @@ interface AdminConfig {
174
221
  noResults?: string;
175
222
  eventsTitle?: string;
176
223
  dashboardTitle?: string;
224
+ collectionsTitle?: string;
225
+ collectionsEndpoint?: string;
177
226
  };
178
227
  features?: {
179
228
  showOverview?: boolean;
@@ -182,6 +231,7 @@ interface AdminConfig {
182
231
  showParticipants?: boolean;
183
232
  showAgents?: boolean;
184
233
  showEvents?: boolean;
234
+ showCollections?: boolean;
185
235
  };
186
236
  ui?: {
187
237
  compact?: boolean;
@@ -250,8 +300,22 @@ declare function fetchAdminActivity(range: AdminDatePreset, interval: AdminActiv
250
300
  declare function fetchAdminThreads(search?: string, namespace?: string, options?: FetchOptions): Promise<AdminThreadSummary[]>;
251
301
  declare function fetchAdminParticipants(search?: string, namespace?: string, options?: FetchOptions): Promise<AdminParticipantSummary[]>;
252
302
  declare function fetchAdminAgents(search?: string, namespace?: string, options?: FetchOptions): Promise<AdminAgentSummary[]>;
303
+ declare function fetchParticipantDetail(participantId: string, options?: FetchOptions): Promise<AdminParticipantDetail | null>;
304
+ declare function updateParticipant(participantId: string, data: Record<string, unknown>, options?: FetchOptions): Promise<AdminParticipantDetail>;
305
+ declare function fetchCollectionNames(options?: FetchOptions): Promise<string[]>;
306
+ declare function fetchCollectionItems(collection: string, queryOptions?: {
307
+ search?: string;
308
+ namespace?: string;
309
+ limit?: number;
310
+ offset?: number;
311
+ }, options?: FetchOptions): Promise<AdminCollectionItem[]>;
312
+ declare function fetchCollectionItem(collection: string, itemId: string, namespace?: string, options?: FetchOptions): Promise<AdminCollectionItem>;
313
+ declare function createCollectionItem(collection: string, data: Record<string, unknown>, namespace?: string, options?: FetchOptions): Promise<AdminCollectionItem>;
314
+ declare function updateCollectionItem(collection: string, itemId: string, data: Record<string, unknown>, namespace?: string, options?: FetchOptions): Promise<AdminCollectionItem>;
315
+ declare function deleteCollectionItem(collection: string, itemId: string, namespace?: string, options?: FetchOptions): Promise<void>;
316
+ declare function fetchThreadEvents(threadId: string, options?: FetchOptions): Promise<AdminQueueEvent | undefined>;
253
317
 
254
318
  declare const defaultAdminConfig: ResolvedAdminConfig;
255
319
  declare function mergeAdminConfig(_baseConfig: ResolvedAdminConfig, userConfig?: Partial<AdminConfig>): ResolvedAdminConfig;
256
320
 
257
- export { type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminConfig, type AdminDatePreset, type AdminFilters, type AdminMessage, type AdminMessagePage, type AdminMessagePageInfo, type AdminOverview, type AdminPage, type AdminParticipantSummary, type AdminRoute, type AdminSectionState, type AdminThreadDetail, type AdminThreadSummary, CopilotzAdmin, type RequestHeadersProvider, type UseCopilotzAdminOptions, type UseCopilotzAdminResult, defaultAdminConfig, fetchAdminActivity, fetchAdminAgents, fetchAdminOverview, fetchAdminParticipants, fetchAdminThreads, mergeAdminConfig, useCopilotzAdmin };
321
+ export { type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminCollectionItem, type AdminConfig, type AdminDatePreset, type AdminFilters, type AdminMessage, type AdminMessagePage, type AdminMessagePageInfo, type AdminOverview, type AdminPage, type AdminParticipantDetail, type AdminParticipantSummary, type AdminQueueEvent, type AdminRoute, type AdminSectionState, type AdminThreadDetail, type AdminThreadSummary, CopilotzAdmin, type RequestHeadersProvider, type UseCopilotzAdminOptions, type UseCopilotzAdminResult, createCollectionItem, defaultAdminConfig, deleteCollectionItem, fetchAdminActivity, fetchAdminAgents, fetchAdminOverview, fetchAdminParticipants, fetchAdminThreads, fetchCollectionItem, fetchCollectionItems, fetchCollectionNames, fetchParticipantDetail, fetchThreadEvents, mergeAdminConfig, updateCollectionItem, updateParticipant, useCopilotzAdmin };
package/dist/index.d.ts CHANGED
@@ -3,10 +3,28 @@ import React, { ReactNode } from 'react';
3
3
  type RequestHeadersProvider = () => Record<string, string> | Promise<Record<string, string>>;
4
4
  type AdminDatePreset = "24h" | "7d" | "30d";
5
5
  type AdminActivityInterval = "hour" | "day";
6
- type AdminPage = "dashboard" | "threads" | "thread-detail" | "participants" | "agents" | "events";
6
+ type AdminPage = "dashboard" | "threads" | "thread-detail" | "participants" | "participant-detail" | "agents" | "agent-detail" | "collection-items" | "collection-item-detail" | "events";
7
7
  interface AdminRoute {
8
8
  page: AdminPage;
9
9
  resourceId?: string;
10
+ collection?: string;
11
+ }
12
+ interface AdminUsageBreakdown {
13
+ inputTokens: number;
14
+ outputTokens: number;
15
+ reasoningTokens: number;
16
+ cacheReadInputTokens: number;
17
+ cacheCreationInputTokens: number;
18
+ totalTokens: number;
19
+ inputCostUsd: number;
20
+ outputCostUsd: number;
21
+ reasoningCostUsd: number;
22
+ cacheReadInputCostUsd: number;
23
+ cacheCreationInputCostUsd: number;
24
+ totalCostUsd: number;
25
+ }
26
+ interface AdminUsageTotals extends AdminUsageBreakdown {
27
+ totalCalls: number;
10
28
  }
11
29
  interface AdminOverview {
12
30
  threadTotals: {
@@ -32,22 +50,13 @@ interface AdminOverview {
32
50
  humans: number;
33
51
  agents: number;
34
52
  };
35
- llmTotals: {
36
- totalCalls: number;
37
- inputTokens: number;
38
- outputTokens: number;
39
- reasoningTokens: number;
40
- cacheReadInputTokens: number;
41
- cacheCreationInputTokens: number;
42
- totalTokens: number;
43
- };
53
+ llmTotals: AdminUsageTotals;
44
54
  }
45
- interface AdminActivityPoint {
55
+ interface AdminActivityPoint extends AdminUsageTotals {
46
56
  bucket: string;
47
57
  messageCount: number;
48
- llmCallCount: number;
49
58
  toolCallMessageCount: number;
50
- totalTokens: number;
59
+ llmCallCount: number;
51
60
  }
52
61
  interface AdminThreadSummary {
53
62
  threadId: string;
@@ -81,12 +90,18 @@ interface AdminAgentSummary {
81
90
  messageCount: number;
82
91
  llmCallCount: number;
83
92
  toolCallMessageCount: number;
84
- inputTokens: number;
85
- outputTokens: number;
86
- reasoningTokens: number;
87
- cacheReadInputTokens: number;
88
- cacheCreationInputTokens: number;
89
- totalTokens: number;
93
+ inputTokens: AdminUsageBreakdown["inputTokens"];
94
+ outputTokens: AdminUsageBreakdown["outputTokens"];
95
+ reasoningTokens: AdminUsageBreakdown["reasoningTokens"];
96
+ cacheReadInputTokens: AdminUsageBreakdown["cacheReadInputTokens"];
97
+ cacheCreationInputTokens: AdminUsageBreakdown["cacheCreationInputTokens"];
98
+ totalTokens: AdminUsageBreakdown["totalTokens"];
99
+ inputCostUsd: AdminUsageBreakdown["inputCostUsd"];
100
+ outputCostUsd: AdminUsageBreakdown["outputCostUsd"];
101
+ reasoningCostUsd: AdminUsageBreakdown["reasoningCostUsd"];
102
+ cacheReadInputCostUsd: AdminUsageBreakdown["cacheReadInputCostUsd"];
103
+ cacheCreationInputCostUsd: AdminUsageBreakdown["cacheCreationInputCostUsd"];
104
+ totalCostUsd: AdminUsageBreakdown["totalCostUsd"];
90
105
  lastActivityAt: string | null;
91
106
  }
92
107
  interface AdminThreadDetail {
@@ -126,6 +141,24 @@ interface AdminMessagePage {
126
141
  data: AdminMessage[];
127
142
  pageInfo: AdminMessagePageInfo;
128
143
  }
144
+ type AdminParticipantDetail = Record<string, unknown>;
145
+ type AdminCollectionItem = Record<string, unknown> & {
146
+ id?: string;
147
+ };
148
+ interface AdminQueueEvent {
149
+ id: string;
150
+ threadId: string;
151
+ eventType: string;
152
+ payload: unknown;
153
+ parentEventId: string | null;
154
+ traceId: string | null;
155
+ priority: number | null;
156
+ status: "pending" | "processing" | "completed" | "failed" | "expired" | "overwritten";
157
+ namespace: string | null;
158
+ metadata: Record<string, unknown> | null;
159
+ createdAt: string | null;
160
+ updatedAt: string | null;
161
+ }
129
162
  interface AdminFilters {
130
163
  namespace?: string;
131
164
  range?: AdminDatePreset;
@@ -164,7 +197,21 @@ interface AdminConfig {
164
197
  activeThreadsCard?: string;
165
198
  participantsCard?: string;
166
199
  tokensCard?: string;
200
+ costCard?: string;
167
201
  queueCard?: string;
202
+ llmUsageTitle?: string;
203
+ usageMetricLabel?: string;
204
+ usageDimensionLabel?: string;
205
+ usageMetricTokens?: string;
206
+ usageMetricCost?: string;
207
+ usageTotal?: string;
208
+ usageInput?: string;
209
+ usageOutput?: string;
210
+ usageReasoning?: string;
211
+ usageCacheRead?: string;
212
+ usageCacheWrite?: string;
213
+ usageCallsDetail?: string;
214
+ usageUnavailableDetail?: string;
168
215
  statusActive?: string;
169
216
  statusArchived?: string;
170
217
  scopeGlobal?: string;
@@ -174,6 +221,8 @@ interface AdminConfig {
174
221
  noResults?: string;
175
222
  eventsTitle?: string;
176
223
  dashboardTitle?: string;
224
+ collectionsTitle?: string;
225
+ collectionsEndpoint?: string;
177
226
  };
178
227
  features?: {
179
228
  showOverview?: boolean;
@@ -182,6 +231,7 @@ interface AdminConfig {
182
231
  showParticipants?: boolean;
183
232
  showAgents?: boolean;
184
233
  showEvents?: boolean;
234
+ showCollections?: boolean;
185
235
  };
186
236
  ui?: {
187
237
  compact?: boolean;
@@ -250,8 +300,22 @@ declare function fetchAdminActivity(range: AdminDatePreset, interval: AdminActiv
250
300
  declare function fetchAdminThreads(search?: string, namespace?: string, options?: FetchOptions): Promise<AdminThreadSummary[]>;
251
301
  declare function fetchAdminParticipants(search?: string, namespace?: string, options?: FetchOptions): Promise<AdminParticipantSummary[]>;
252
302
  declare function fetchAdminAgents(search?: string, namespace?: string, options?: FetchOptions): Promise<AdminAgentSummary[]>;
303
+ declare function fetchParticipantDetail(participantId: string, options?: FetchOptions): Promise<AdminParticipantDetail | null>;
304
+ declare function updateParticipant(participantId: string, data: Record<string, unknown>, options?: FetchOptions): Promise<AdminParticipantDetail>;
305
+ declare function fetchCollectionNames(options?: FetchOptions): Promise<string[]>;
306
+ declare function fetchCollectionItems(collection: string, queryOptions?: {
307
+ search?: string;
308
+ namespace?: string;
309
+ limit?: number;
310
+ offset?: number;
311
+ }, options?: FetchOptions): Promise<AdminCollectionItem[]>;
312
+ declare function fetchCollectionItem(collection: string, itemId: string, namespace?: string, options?: FetchOptions): Promise<AdminCollectionItem>;
313
+ declare function createCollectionItem(collection: string, data: Record<string, unknown>, namespace?: string, options?: FetchOptions): Promise<AdminCollectionItem>;
314
+ declare function updateCollectionItem(collection: string, itemId: string, data: Record<string, unknown>, namespace?: string, options?: FetchOptions): Promise<AdminCollectionItem>;
315
+ declare function deleteCollectionItem(collection: string, itemId: string, namespace?: string, options?: FetchOptions): Promise<void>;
316
+ declare function fetchThreadEvents(threadId: string, options?: FetchOptions): Promise<AdminQueueEvent | undefined>;
253
317
 
254
318
  declare const defaultAdminConfig: ResolvedAdminConfig;
255
319
  declare function mergeAdminConfig(_baseConfig: ResolvedAdminConfig, userConfig?: Partial<AdminConfig>): ResolvedAdminConfig;
256
320
 
257
- export { type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminConfig, type AdminDatePreset, type AdminFilters, type AdminMessage, type AdminMessagePage, type AdminMessagePageInfo, type AdminOverview, type AdminPage, type AdminParticipantSummary, type AdminRoute, type AdminSectionState, type AdminThreadDetail, type AdminThreadSummary, CopilotzAdmin, type RequestHeadersProvider, type UseCopilotzAdminOptions, type UseCopilotzAdminResult, defaultAdminConfig, fetchAdminActivity, fetchAdminAgents, fetchAdminOverview, fetchAdminParticipants, fetchAdminThreads, mergeAdminConfig, useCopilotzAdmin };
321
+ export { type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminCollectionItem, type AdminConfig, type AdminDatePreset, type AdminFilters, type AdminMessage, type AdminMessagePage, type AdminMessagePageInfo, type AdminOverview, type AdminPage, type AdminParticipantDetail, type AdminParticipantSummary, type AdminQueueEvent, type AdminRoute, type AdminSectionState, type AdminThreadDetail, type AdminThreadSummary, CopilotzAdmin, type RequestHeadersProvider, type UseCopilotzAdminOptions, type UseCopilotzAdminResult, createCollectionItem, defaultAdminConfig, deleteCollectionItem, fetchAdminActivity, fetchAdminAgents, fetchAdminOverview, fetchAdminParticipants, fetchAdminThreads, fetchCollectionItem, fetchCollectionItems, fetchCollectionNames, fetchParticipantDetail, fetchThreadEvents, mergeAdminConfig, updateCollectionItem, updateParticipant, useCopilotzAdmin };