@lssm/lib.support-bot 0.0.0-canary-20251217054315 → 0.0.0-canary-20251217060804

package/dist/bot/auto-responder.d.ts

@@ -0,0 +1,25 @@
+import { SupportResolution, SupportResponseDraft, SupportTicket, TicketClassification } from "../types.js";
+import { LLMProvider } from "@lssm/lib.contracts/integrations/providers/llm";
+
+//#region src/bot/auto-responder.d.ts
+interface AutoResponderOptions {
+  llm?: LLMProvider;
+  model?: string;
+  tone?: 'friendly' | 'formal';
+  closing?: string;
+}
+declare class AutoResponder {
+  private readonly llm?;
+  private readonly model?;
+  private readonly tone;
+  private readonly closing;
+  constructor(options?: AutoResponderOptions);
+  draft(ticket: SupportTicket, resolution: SupportResolution, classification: TicketClassification): Promise<SupportResponseDraft>;
+  private generateWithLLM;
+  private generateTemplate;
+  private buildDraft;
+  private renderCategoryIntro;
+  private renderCitations;
+}
+//#endregion
+export { AutoResponder, AutoResponderOptions };

package/dist/bot/feedback-loop.d.ts

@@ -0,0 +1,19 @@
+import { ResolutionResultPayload } from "../types.js";
+
+//#region src/bot/feedback-loop.d.ts
+interface FeedbackMetrics {
+  totalTickets: number;
+  autoResolved: number;
+  escalated: number;
+  avgConfidence: number;
+  avgResponseTimeMs: number;
+}
+declare class SupportFeedbackLoop {
+  private readonly history;
+  private readonly responseTimes;
+  recordResolution(payload: ResolutionResultPayload, responseTimeMs?: number): void;
+  metrics(): FeedbackMetrics;
+  feedbackSummary(limit?: number): string;
+}
+//#endregion
+export { FeedbackMetrics, SupportFeedbackLoop };

package/dist/bot/index.d.ts

@@ -0,0 +1,4 @@
+import { AutoResponder, AutoResponderOptions } from "./auto-responder.js";
+import { FeedbackMetrics, SupportFeedbackLoop } from "./feedback-loop.js";
+import { SupportToolsetOptions, createSupportTools } from "./tools.js";
+export { AutoResponder, AutoResponderOptions, FeedbackMetrics, SupportFeedbackLoop, SupportToolsetOptions, createSupportTools };

package/dist/bot/tools.d.ts

@@ -0,0 +1,14 @@
+import { AutoResponder } from "./auto-responder.js";
+import { TicketResolver } from "../rag/ticket-resolver.js";
+import { TicketClassifier } from "../tickets/classifier.js";
+import { Tool } from "@ai-sdk/provider-utils";
+
+//#region src/bot/tools.d.ts
+interface SupportToolsetOptions {
+  resolver: TicketResolver;
+  classifier: TicketClassifier;
+  responder: AutoResponder;
+}
+declare function createSupportTools(options: SupportToolsetOptions): Tool[];
+//#endregion
+export { SupportToolsetOptions, createSupportTools };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { ClassificationResultPayload, ResolutionResultPayload, SupportAction, SupportBotSpec, SupportCitation, SupportResolution, SupportResponseDraft, SupportTicket, TicketCategory, TicketChannel, TicketClassification, TicketPriority, TicketSentiment } from "./types.js";
+import { AutoResponder, AutoResponderOptions } from "./bot/auto-responder.js";
+import { FeedbackMetrics, SupportFeedbackLoop } from "./bot/feedback-loop.js";
+import { KnowledgeRetriever, TicketResolver, TicketResolverOptions } from "./rag/ticket-resolver.js";
+import { TicketClassifier, TicketClassifierOptions } from "./tickets/classifier.js";
+import { SupportToolsetOptions, createSupportTools } from "./bot/tools.js";
+import "./bot/index.js";
+import { SupportBotDefinition, defineSupportBot } from "./spec.js";
+import "./rag/index.js";
+import "./tickets/index.js";
+export { AutoResponder, AutoResponderOptions, ClassificationResultPayload, FeedbackMetrics, KnowledgeRetriever, ResolutionResultPayload, SupportAction, SupportBotDefinition, SupportBotSpec, SupportCitation, SupportFeedbackLoop, SupportResolution, SupportResponseDraft, SupportTicket, SupportToolsetOptions, TicketCategory, TicketChannel, TicketClassification, TicketClassifier, TicketClassifierOptions, TicketPriority, TicketResolver, TicketResolverOptions, TicketSentiment, createSupportTools, defineSupportBot };

package/dist/rag/index.d.ts

@@ -0,0 +1,2 @@
+import { KnowledgeRetriever, TicketResolver, TicketResolverOptions } from "./ticket-resolver.js";
+export { KnowledgeRetriever, TicketResolver, TicketResolverOptions };

package/dist/rag/ticket-resolver.d.ts

@@ -0,0 +1,24 @@
+import { SupportResolution, SupportTicket } from "../types.js";
+import { KnowledgeAnswer } from "@lssm/lib.knowledge/query/service";
+
+//#region src/rag/ticket-resolver.d.ts
+interface KnowledgeRetriever {
+  query(question: string): Promise<KnowledgeAnswer>;
+}
+interface TicketResolverOptions {
+  knowledge: KnowledgeRetriever;
+  minConfidence?: number;
+  prependPrompt?: string;
+}
+declare class TicketResolver {
+  private readonly knowledge;
+  private readonly minConfidence;
+  private readonly prependPrompt?;
+  constructor(options: TicketResolverOptions);
+  resolve(ticket: SupportTicket): Promise<SupportResolution>;
+  private buildQuestion;
+  private toResolution;
+  private deriveConfidence;
+}
+//#endregion
+export { KnowledgeRetriever, TicketResolver, TicketResolverOptions };

package/dist/spec.d.ts

@@ -0,0 +1,12 @@
+import { SupportBotSpec } from "./types.js";
+import { AgentSpec, AgentToolConfig } from "@lssm/lib.ai-agent";
+
+//#region src/spec.d.ts
+interface SupportBotDefinition {
+  base: AgentSpec;
+  tools?: AgentToolConfig[];
+  autoEscalateThreshold?: number;
+}
+declare function defineSupportBot(definition: SupportBotDefinition): SupportBotSpec;
+//#endregion
+export { SupportBotDefinition, defineSupportBot };

package/dist/tickets/classifier.d.ts

@@ -0,0 +1,24 @@
+import { SupportTicket, TicketCategory, TicketClassification } from "../types.js";
+import { LLMProvider } from "@lssm/lib.contracts/integrations/providers/llm";
+
+//#region src/tickets/classifier.d.ts
+interface TicketClassifierOptions {
+  keywords?: Partial<Record<TicketCategory, string[]>>;
+  llm?: LLMProvider;
+  llmModel?: string;
+}
+declare class TicketClassifier {
+  private readonly keywords;
+  private readonly llm?;
+  private readonly llmModel?;
+  constructor(options?: TicketClassifierOptions);
+  classify(ticket: SupportTicket): Promise<TicketClassification>;
+  private heuristicClassification;
+  private detectCategory;
+  private detectPriority;
+  private detectSentiment;
+  private extractIntents;
+  private estimateConfidence;
+}
+//#endregion
+export { TicketClassifier, TicketClassifierOptions };

package/dist/tickets/index.d.ts

@@ -0,0 +1,2 @@
+import { TicketClassifier, TicketClassifierOptions } from "./classifier.js";
+export { TicketClassifier, TicketClassifierOptions };

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+import { AgentSpec } from "@lssm/lib.ai-agent";
+
+//#region src/types.d.ts
+type TicketPriority = 'low' | 'medium' | 'high' | 'urgent';
+type TicketCategory = 'billing' | 'technical' | 'product' | 'account' | 'compliance' | 'other';
+type TicketChannel = 'email' | 'chat' | 'phone' | 'portal';
+type TicketSentiment = 'positive' | 'neutral' | 'negative' | 'frustrated';
+interface SupportTicket {
+  id: string;
+  subject: string;
+  body: string;
+  channel: TicketChannel;
+  locale?: string;
+  customerEmail?: string;
+  customerName?: string;
+  metadata?: Record<string, string>;
+}
+interface TicketClassification {
+  ticketId: string;
+  category: TicketCategory;
+  priority: TicketPriority;
+  sentiment: TicketSentiment;
+  intents: string[];
+  tags: string[];
+  confidence: number;
+  escalationRequired?: boolean;
+}
+interface SupportCitation {
+  label: string;
+  url?: string;
+  snippet?: string;
+  score?: number;
+}
+interface SupportAction {
+  type: 'respond' | 'escalate' | 'refund' | 'manual';
+  label: string;
+  payload?: Record<string, string>;
+}
+interface SupportResolution {
+  ticketId: string;
+  answer: string;
+  confidence: number;
+  citations: SupportCitation[];
+  actions: SupportAction[];
+  escalationReason?: string;
+  knowledgeUpdates?: string[];
+}
+interface SupportResponseDraft {
+  ticketId: string;
+  subject: string;
+  body: string;
+  confidence: number;
+  requiresEscalation: boolean;
+  citations: SupportCitation[];
+}
+interface SupportBotSpec extends AgentSpec {
+  thresholds?: {
+    autoResolveMinConfidence?: number;
+    maxIterations?: number;
+  };
+  review?: {
+    queueName?: string;
+    approvalWorkflow?: string;
+  };
+}
+interface ClassificationResultPayload {
+  ticket: SupportTicket;
+  classification: TicketClassification;
+}
+interface ResolutionResultPayload extends ClassificationResultPayload {
+  resolution: SupportResolution;
+  draft: SupportResponseDraft;
+}
+//#endregion
+export { ClassificationResultPayload, ResolutionResultPayload, SupportAction, SupportBotSpec, SupportCitation, SupportResolution, SupportResponseDraft, SupportTicket, TicketCategory, TicketChannel, TicketClassification, TicketPriority, TicketSentiment };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.support-bot",
-  "version": "0.0.0-canary-20251217054315",
+  "version": "0.0.0-canary-20251217060804",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,27 +23,27 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.ai-agent": "0.0.0-canary-20251217054315",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217054315"
+    "@lssm/lib.ai-agent": "0.0.0-canary-20251217060804",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060804"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217054315",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217054315",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060804",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060804",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
-    "./bot": "./src/bot/index.ts",
-    "./bot/auto-responder": "./src/bot/auto-responder.ts",
-    "./bot/feedback-loop": "./src/bot/feedback-loop.ts",
-    "./bot/tools": "./src/bot/tools.ts",
-    "./rag": "./src/rag/index.ts",
-    "./rag/ticket-resolver": "./src/rag/ticket-resolver.ts",
-    "./spec": "./src/spec.ts",
-    "./tickets": "./src/tickets/index.ts",
-    "./tickets/classifier": "./src/tickets/classifier.ts",
-    "./types": "./src/types.ts",
+    ".": "./dist/index.js",
+    "./bot": "./dist/bot/index.js",
+    "./bot/auto-responder": "./dist/bot/auto-responder.js",
+    "./bot/feedback-loop": "./dist/bot/feedback-loop.js",
+    "./bot/tools": "./dist/bot/tools.js",
+    "./rag": "./dist/rag/index.js",
+    "./rag/ticket-resolver": "./dist/rag/ticket-resolver.js",
+    "./spec": "./dist/spec.js",
+    "./tickets": "./dist/tickets/index.js",
+    "./tickets/classifier": "./dist/tickets/classifier.js",
+    "./types": "./dist/types.js",
     "./*": "./*"
   },
   "publishConfig": {