@copilotz/admin 0.9.38 → 0.9.40

package/dist/index.d.cts

@@ -137,6 +137,112 @@ interface AdminEventFilters {
     limit?: number;
     offset?: number;
 }
+type AdminBrainLayer = "all" | "knowledge" | "working" | (string & {});
+type AdminBrainStatus = "all" | "active" | "superseded" | "archived" | (string & {});
+type AdminBrainSearchMode = "keyword" | "semantic" | "hybrid";
+interface AdminBrainFilters {
+    namespace?: string;
+    memorySpaceId?: string;
+    checkpointId?: string;
+    agentId?: string;
+    threadId?: string;
+    layer?: AdminBrainLayer;
+    kind?: string;
+    status?: AdminBrainStatus;
+    search?: string;
+    searchMode?: AdminBrainSearchMode;
+    focusNodeId?: string;
+    includeRelated?: boolean;
+    includeSimilar?: boolean;
+    similarLimit?: number;
+    minSimilarity?: number;
+    relationDepth?: 1;
+    relationTypes?: string[];
+    limit?: number;
+    offset?: number;
+}
+interface AdminBrainNode {
+    id: string;
+    namespace: string;
+    name: string;
+    content: string;
+    layer: string;
+    kind: string;
+    status: string;
+    memorySpaceId: string | null;
+    checkpointId: string | null;
+    agentId: string | null;
+    threadId: string | null;
+    confidence: number | null;
+    sourceMessageIds: string[];
+    sourceField: string | null;
+    sourceType: string | null;
+    sourceId: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    clusterId: string;
+    x: number;
+    y: number;
+    data: Record<string, unknown>;
+}
+interface AdminBrainMatch {
+    keyword?: boolean;
+    similarity?: number;
+    relationDistance?: number;
+    reasons: string[];
+}
+interface AdminBrainEdge {
+    id: string;
+    sourceNodeId: string;
+    targetNodeId: string;
+    type: string;
+    weight: number | null;
+    createdAt: string | null;
+    data: Record<string, unknown> | null;
+}
+interface AdminBrainCluster {
+    id: string;
+    label: string;
+    layer: string;
+    kind: string;
+    count: number;
+    x: number;
+    y: number;
+}
+interface AdminBrainStats {
+    total: number;
+    byLayer: Record<string, number>;
+    byKind: Record<string, number>;
+    byStatus: Record<string, number>;
+}
+interface AdminBrainRelated {
+    node: AdminBrainNode;
+    edge: AdminBrainEdge;
+    direction: "in" | "out";
+}
+interface AdminBrainSimilar {
+    node: AdminBrainNode;
+    similarity: number;
+}
+interface AdminBrainResponse {
+    nodes: AdminBrainNode[];
+    edges: AdminBrainEdge[];
+    clusters: AdminBrainCluster[];
+    stats: AdminBrainStats;
+    matches?: Record<string, AdminBrainMatch>;
+    related?: AdminBrainRelated[];
+    similar?: AdminBrainSimilar[];
+    semantic?: {
+        requested: boolean;
+        available: boolean;
+        error: string | null;
+    };
+    pageInfo: {
+        limit: number;
+        offset: number;
+        returned: number;
+    };
+}
 interface AdminThreadDetail {
     id: string;
     name: string;
@@ -248,6 +354,7 @@ interface CopilotzAdminClient {
     }): Promise<AdminMessagePage>;
     listEvents(options?: AdminEventFilters): Promise<AdminQueueEvent[]>;
     getThreadEvent(threadId: string): Promise<AdminQueueEvent | undefined>;
+    getBrain(filters?: AdminBrainFilters): Promise<AdminBrainResponse>;
     listCollections(): Promise<string[]>;
     listCollectionItems(collection: string, options?: AdminListOptions): Promise<AdminCollectionItem[]>;
     getCollectionItem(collection: string, itemId: string, options?: {
@@ -387,6 +494,8 @@ declare function firstAccessibleRoute(modules: AdminModule[], permissions?: Admi
 
 declare function agentsModule(): AdminModule;
 
+declare function brainModule(): AdminModule;
+
 declare function collectionsModule(): AdminModule;
 
 declare function eventsModule(): AdminModule;
@@ -544,4 +653,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 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 };
+export { ADMIN_GROUP_LABELS, ADMIN_GROUP_ORDER, type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminBrainCluster, type AdminBrainEdge, type AdminBrainFilters, type AdminBrainLayer, type AdminBrainMatch, type AdminBrainNode, type AdminBrainRelated, type AdminBrainResponse, type AdminBrainSearchMode, type AdminBrainSimilar, type AdminBrainStats, type AdminBrainStatus, 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, brainModule, 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

@@ -137,6 +137,112 @@ interface AdminEventFilters {
     limit?: number;
     offset?: number;
 }
+type AdminBrainLayer = "all" | "knowledge" | "working" | (string & {});
+type AdminBrainStatus = "all" | "active" | "superseded" | "archived" | (string & {});
+type AdminBrainSearchMode = "keyword" | "semantic" | "hybrid";
+interface AdminBrainFilters {
+    namespace?: string;
+    memorySpaceId?: string;
+    checkpointId?: string;
+    agentId?: string;
+    threadId?: string;
+    layer?: AdminBrainLayer;
+    kind?: string;
+    status?: AdminBrainStatus;
+    search?: string;
+    searchMode?: AdminBrainSearchMode;
+    focusNodeId?: string;
+    includeRelated?: boolean;
+    includeSimilar?: boolean;
+    similarLimit?: number;
+    minSimilarity?: number;
+    relationDepth?: 1;
+    relationTypes?: string[];
+    limit?: number;
+    offset?: number;
+}
+interface AdminBrainNode {
+    id: string;
+    namespace: string;
+    name: string;
+    content: string;
+    layer: string;
+    kind: string;
+    status: string;
+    memorySpaceId: string | null;
+    checkpointId: string | null;
+    agentId: string | null;
+    threadId: string | null;
+    confidence: number | null;
+    sourceMessageIds: string[];
+    sourceField: string | null;
+    sourceType: string | null;
+    sourceId: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    clusterId: string;
+    x: number;
+    y: number;
+    data: Record<string, unknown>;
+}
+interface AdminBrainMatch {
+    keyword?: boolean;
+    similarity?: number;
+    relationDistance?: number;
+    reasons: string[];
+}
+interface AdminBrainEdge {
+    id: string;
+    sourceNodeId: string;
+    targetNodeId: string;
+    type: string;
+    weight: number | null;
+    createdAt: string | null;
+    data: Record<string, unknown> | null;
+}
+interface AdminBrainCluster {
+    id: string;
+    label: string;
+    layer: string;
+    kind: string;
+    count: number;
+    x: number;
+    y: number;
+}
+interface AdminBrainStats {
+    total: number;
+    byLayer: Record<string, number>;
+    byKind: Record<string, number>;
+    byStatus: Record<string, number>;
+}
+interface AdminBrainRelated {
+    node: AdminBrainNode;
+    edge: AdminBrainEdge;
+    direction: "in" | "out";
+}
+interface AdminBrainSimilar {
+    node: AdminBrainNode;
+    similarity: number;
+}
+interface AdminBrainResponse {
+    nodes: AdminBrainNode[];
+    edges: AdminBrainEdge[];
+    clusters: AdminBrainCluster[];
+    stats: AdminBrainStats;
+    matches?: Record<string, AdminBrainMatch>;
+    related?: AdminBrainRelated[];
+    similar?: AdminBrainSimilar[];
+    semantic?: {
+        requested: boolean;
+        available: boolean;
+        error: string | null;
+    };
+    pageInfo: {
+        limit: number;
+        offset: number;
+        returned: number;
+    };
+}
 interface AdminThreadDetail {
     id: string;
     name: string;
@@ -248,6 +354,7 @@ interface CopilotzAdminClient {
     }): Promise<AdminMessagePage>;
     listEvents(options?: AdminEventFilters): Promise<AdminQueueEvent[]>;
     getThreadEvent(threadId: string): Promise<AdminQueueEvent | undefined>;
+    getBrain(filters?: AdminBrainFilters): Promise<AdminBrainResponse>;
     listCollections(): Promise<string[]>;
     listCollectionItems(collection: string, options?: AdminListOptions): Promise<AdminCollectionItem[]>;
     getCollectionItem(collection: string, itemId: string, options?: {
@@ -387,6 +494,8 @@ declare function firstAccessibleRoute(modules: AdminModule[], permissions?: Admi
 
 declare function agentsModule(): AdminModule;
 
+declare function brainModule(): AdminModule;
+
 declare function collectionsModule(): AdminModule;
 
 declare function eventsModule(): AdminModule;
@@ -544,4 +653,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 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 };
+export { ADMIN_GROUP_LABELS, ADMIN_GROUP_ORDER, type AdminActivityInterval, type AdminActivityPoint, type AdminAgentSummary, type AdminBrainCluster, type AdminBrainEdge, type AdminBrainFilters, type AdminBrainLayer, type AdminBrainMatch, type AdminBrainNode, type AdminBrainRelated, type AdminBrainResponse, type AdminBrainSearchMode, type AdminBrainSimilar, type AdminBrainStats, type AdminBrainStatus, 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, brainModule, 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 };