@operor/copilot 0.1.0

package/src/index.ts

@@ -0,0 +1,8 @@
+export * from './types.js';
+export { SQLiteCopilotStore } from './SQLiteCopilotStore.js';
+export { InMemoryCopilotStore } from './InMemoryCopilotStore.js';
+export { UnansweredQueryTracker } from './UnansweredQueryTracker.js';
+export { QueryClusterer } from './QueryClusterer.js';
+export { SuggestionEngine } from './SuggestionEngine.js';
+export { CopilotCommandHandler } from './CopilotCommandHandler.js';
+export { DigestScheduler } from './DigestScheduler.js';

package/src/types.ts

@@ -0,0 +1,131 @@
+/**
+ * Training Copilot types
+ */
+
+/** Status of an unanswered query through the review lifecycle */
+export type QueryStatus = 'pending' | 'taught' | 'dismissed';
+
+/** A customer query that the KB couldn't confidently answer */
+export interface UnansweredQuery {
+  id: string;
+  query: string;
+  normalizedQuery: string;
+  channel: string;
+  customerPhone: string;
+  kbTopScore: number;
+  kbIsFaqMatch: boolean;
+  kbTopChunkContent?: string;
+  kbResultCount: number;
+  status: QueryStatus;
+  clusterId?: string;
+  timesAsked: number;
+  uniqueCustomers: string[];
+  embedding?: number[];
+  suggestedAnswer?: string;
+  taughtAnswer?: string;
+  createdAt: number;
+  updatedAt: number;
+}
+
+/** A cluster of semantically similar unanswered queries */
+export interface QueryCluster {
+  id: string;
+  label?: string;
+  representativeQuery: string;
+  centroid?: number[];
+  queryCount: number;
+  uniqueCustomers: string[];
+  status: QueryStatus;
+  createdAt: number;
+  updatedAt: number;
+}
+
+/** Aggregate metrics for the copilot dashboard / digest */
+export interface ImpactMetrics {
+  pendingCount: number;
+  taughtCount: number;
+  dismissedCount: number;
+  totalCustomersAffected: number;
+  totalTimesAsked: number;
+  topPendingQueries: UnansweredQuery[];
+}
+
+/** Configuration for the copilot subsystem */
+export interface CopilotConfig {
+  enabled: boolean;
+  trackingThreshold: number;
+  clusterThreshold: number;
+  digestIntervalMs: number;
+  digestMaxItems: number;
+  autoSuggest: boolean;
+}
+
+/** Default copilot configuration values */
+export const DEFAULT_COPILOT_CONFIG: CopilotConfig = {
+  enabled: false,
+  trackingThreshold: 0.70,
+  clusterThreshold: 0.87,
+  digestIntervalMs: 86_400_000, // 24h
+  digestMaxItems: 10,
+  autoSuggest: true,
+};
+
+/** Embedding service interface — decouples copilot from specific embedding providers */
+export interface EmbeddingService {
+  embed(text: string): Promise<number[]>;
+  dimensions: number;
+}
+
+/** AI provider interface for suggestion generation */
+export interface AIProviderLike {
+  generateText(options: {
+    model?: string;
+    system?: string;
+    prompt: string;
+    maxTokens?: number;
+    temperature?: number;
+  }): Promise<{ text: string }>;
+}
+
+/** Store interface for copilot persistence */
+export interface CopilotStore {
+  initialize(): Promise<void>;
+  close(): Promise<void>;
+
+  // Queries
+  addQuery(query: UnansweredQuery): Promise<void>;
+  getQuery(id: string): Promise<UnansweredQuery | null>;
+  updateQuery(id: string, updates: Partial<UnansweredQuery>): Promise<void>;
+  getPendingQueries(limit?: number): Promise<UnansweredQuery[]>;
+  findSimilarQuery(normalizedQuery: string): Promise<UnansweredQuery | null>;
+  getQueriesByCluster(clusterId: string): Promise<UnansweredQuery[]>;
+
+  // Clusters
+  addCluster(cluster: QueryCluster): Promise<void>;
+  getCluster(id: string): Promise<QueryCluster | null>;
+  updateCluster(id: string, updates: Partial<QueryCluster>): Promise<void>;
+  getOpenClusters(): Promise<QueryCluster[]>;
+
+  // Metrics
+  getImpactMetrics(topN?: number): Promise<ImpactMetrics>;
+
+  // Digest tracking
+  getLastDigestTime(): Promise<number>;
+  setLastDigestTime(time: number): Promise<void>;
+}
+
+/** Event emitted after a message is processed by the agent pipeline */
+export interface MessageProcessedEvent {
+  query: string;
+  channel: string;
+  customerPhone: string;
+  response: {
+    text: string;
+    metadata?: {
+      kbTopScore?: number;
+      kbIsFaqMatch?: boolean;
+      kbTopChunkContent?: string;
+      kbResultCount?: number;
+    };
+  };
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsdown.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  outExtensions: () => ({ js: '.js', dts: '.d.ts' }),
+});