@lssm/example.ai-support-bot 0.0.0-canary-20251217083314 → 1.41.0

package/dist/libs/logger/dist/timer.js

@@ -1,126 +0,0 @@
-//#region ../../libs/logger/dist/timer.mjs
-var Timer = class {
-	id;
-	startTime;
-	laps = [];
-	stopped = false;
-	stopTime;
-	constructor(id) {
-		this.id = id || crypto.randomUUID();
-		this.startTime = performance.now();
-	}
-	/**
-	* Stop the timer and return elapsed time in milliseconds
-	*/
-	stop() {
-		if (this.stopped) return this.getElapsed();
-		this.stopTime = performance.now();
-		this.stopped = true;
-		const elapsed = this.stopTime - this.startTime;
-		this.laps.push({
-			label: "stop",
-			time: this.stopTime,
-			elapsed
-		});
-		return elapsed;
-	}
-	/**
-	* Record a lap time and return elapsed time since start
-	*/
-	lap(label) {
-		if (this.stopped) return this.getElapsed();
-		const now = performance.now();
-		const elapsed = now - this.startTime;
-		this.laps.push({
-			label: label || `lap-${this.laps.length + 1}`,
-			time: now,
-			elapsed
-		});
-		return elapsed;
-	}
-	/**
-	* Get elapsed time without stopping the timer
-	*/
-	getElapsed() {
-		if (this.stopped && this.stopTime) return this.stopTime - this.startTime;
-		return performance.now() - this.startTime;
-	}
-	/**
-	* Get all recorded laps
-	*/
-	getLaps() {
-		return [...this.laps];
-	}
-	/**
-	* Get timer summary with total time and laps
-	*/
-	getSummary() {
-		return {
-			id: this.id,
-			totalTime: this.getElapsed(),
-			isRunning: !this.stopped,
-			laps: this.getLaps()
-		};
-	}
-	/**
-	* Reset the timer (starts a new timing session)
-	*/
-	reset() {
-		this.startTime = performance.now();
-		this.laps = [];
-		this.stopped = false;
-		this.stopTime = void 0;
-	}
-};
-/**
-* Utility class for managing multiple timers
-*/
-var TimerManager = class {
-	timers = /* @__PURE__ */ new Map();
-	/**
-	* Start a new timer
-	*/
-	start(id) {
-		const timer = new Timer(id);
-		this.timers.set(timer.id, timer);
-		return timer;
-	}
-	/**
-	* Get an existing timer
-	*/
-	get(id) {
-		return this.timers.get(id);
-	}
-	/**
-	* Stop and remove a timer
-	*/
-	stop(id) {
-		const timer = this.timers.get(id);
-		if (timer) {
-			const elapsed = timer.stop();
-			this.timers.delete(id);
-			return elapsed;
-		}
-	}
-	/**
-	* Get all active timers
-	*/
-	getActive() {
-		return Array.from(this.timers.values()).filter((timer) => !timer.getSummary().isRunning === false);
-	}
-	/**
-	* Clear all timers
-	*/
-	clear() {
-		this.timers.clear();
-	}
-	/**
-	* Get summary of all timers
-	*/
-	getSummary() {
-		return Array.from(this.timers.values()).map((timer) => timer.getSummary());
-	}
-};
-
-//#endregion
-export { Timer, TimerManager };

package/dist/libs/logger/dist/tracer.node.js

@@ -1,115 +0,0 @@
-import { LogContext } from "./context.node.js";
-import { Timer } from "./timer.js";
-
-//#region ../../libs/logger/dist/tracer.node.mjs
-var Tracer = class {
-	context;
-	activeSpans = /* @__PURE__ */ new Map();
-	constructor() {
-		this.context = LogContext.getInstance();
-	}
-	/**
-	* Start a new trace span
-	*/
-	startSpan(options) {
-		const parentTrace = this.context.getCurrentTrace();
-		const span = {
-			traceId: parentTrace?.traceId || this.generateTraceId(),
-			parentId: parentTrace?.spanId,
-			spanId: this.generateSpanId(),
-			operationType: options.operationType,
-			operationName: options.operationName,
-			startTime: performance.now(),
-			metadata: { ...options.metadata },
-			tags: [...options.tags || []]
-		};
-		this.activeSpans.set(span.spanId, span);
-		this.context.setTrace(span);
-		return span;
-	}
-	/**
-	* Finish a trace span
-	*/
-	finishSpan(spanId) {
-		const span = this.activeSpans.get(spanId);
-		if (!span) return;
-		const duration = performance.now() - span.startTime;
-		this.activeSpans.delete(spanId);
-		if (this.context.getCurrentTrace()?.spanId === spanId && span.parentId) {
-			const parentSpan = this.findSpanById(span.parentId);
-			if (parentSpan) this.context.setTrace(parentSpan);
-		}
-		return duration;
-	}
-	/**
-	* Execute a function within a trace span
-	*/
-	async trace(options, fn) {
-		const span = this.startSpan(options);
-		const timer = options.autoTiming !== false ? new Timer(`trace-${span.spanId}`) : void 0;
-		try {
-			const result = await fn();
-			const duration = this.finishSpan(span.spanId);
-			if (timer) timer.stop();
-			if (duration !== void 0) span.metadata.duration = duration;
-			return result;
-		} catch (error) {
-			span.metadata.error = {
-				name: error.name || "Unknown",
-				message: error.message || "Unknown error",
-				stack: error.stack
-			};
-			const duration = this.finishSpan(span.spanId);
-			span.metadata.duration = duration;
-			if (timer) timer.stop();
-			throw error;
-		}
-	}
-	/**
-	* Add metadata to current span
-	*/
-	addMetadata(key, value) {
-		const currentTrace = this.context.getCurrentTrace();
-		if (currentTrace) currentTrace.metadata[key] = value;
-	}
-	/**
-	* Add tags to current span
-	*/
-	addTags(...tags) {
-		const currentTrace = this.context.getCurrentTrace();
-		if (currentTrace) currentTrace.tags.push(...tags);
-	}
-	/**
-	* Get current trace context
-	*/
-	getCurrentTrace() {
-		return this.context.getCurrentTrace();
-	}
-	/**
-	* Get all active spans
-	*/
-	getActiveSpans() {
-		return Array.from(this.activeSpans.values());
-	}
-	/**
-	* Find a span by ID
-	*/
-	findSpanById(spanId) {
-		return this.activeSpans.get(spanId);
-	}
-	/**
-	* Generate a unique trace ID
-	*/
-	generateTraceId() {
-		return crypto.randomUUID().replace(/-/g, "");
-	}
-	/**
-	* Generate a unique span ID
-	*/
-	generateSpanId() {
-		return crypto.randomUUID().replace(/-/g, "").substring(0, 16);
-	}
-};
-
-//#endregion
-export { Tracer };

package/dist/libs/logger/dist/types.js

@@ -1,13 +0,0 @@
-//#region ../../libs/logger/dist/types.mjs
-let LogLevel = /* @__PURE__ */ function(LogLevel$1) {
-	LogLevel$1[LogLevel$1["TRACE"] = 0] = "TRACE";
-	LogLevel$1[LogLevel$1["DEBUG"] = 1] = "DEBUG";
-	LogLevel$1[LogLevel$1["INFO"] = 2] = "INFO";
-	LogLevel$1[LogLevel$1["WARN"] = 3] = "WARN";
-	LogLevel$1[LogLevel$1["ERROR"] = 4] = "ERROR";
-	LogLevel$1[LogLevel$1["FATAL"] = 5] = "FATAL";
-	return LogLevel$1;
-}({});
-
-//#endregion
-export { LogLevel };

package/dist/libs/support-bot/dist/bot/auto-responder.js

@@ -1,83 +0,0 @@
-//#region ../../libs/support-bot/dist/bot/auto-responder.js
-var AutoResponder = class {
-	llm;
-	model;
-	tone;
-	closing;
-	constructor(options) {
-		this.llm = options?.llm;
-		this.model = options?.model;
-		this.tone = options?.tone ?? "friendly";
-		this.closing = options?.closing ?? (this.tone === "friendly" ? "We remain available if you need anything else." : "Please let us know if you require additional assistance.");
-	}
-	async draft(ticket, resolution, classification) {
-		if (this.llm) return this.generateWithLLM(ticket, resolution, classification);
-		return this.generateTemplate(ticket, resolution, classification);
-	}
-	async generateWithLLM(ticket, resolution, classification) {
-		const prompt = `You are a ${this.tone} support agent. Draft an email response.
-Ticket Subject: ${ticket.subject}
-Ticket Body: ${ticket.body}
-Detected Category: ${classification.category}
-Detected Priority: ${classification.priority}
-Resolution:
-${resolution.answer}
-Citations: ${resolution.citations.map((c) => c.label).join(", ")}`;
-		const body = (await this.llm.chat([{
-			role: "system",
-			content: [{
-				type: "text",
-				text: "Write empathetic, accurate support replies that cite sources when relevant."
-			}]
-		}, {
-			role: "user",
-			content: [{
-				type: "text",
-				text: prompt
-			}]
-		}], { model: this.model })).message.content.map((part) => "text" in part ? part.text : "").join("").trim();
-		return this.buildDraft(ticket, resolution, classification, body);
-	}
-	generateTemplate(ticket, resolution, classification) {
-		const body = `${ticket.customerName ? `Hi ${ticket.customerName},` : "Hi there,"}
-
-Thanks for contacting us about "${ticket.subject}". ${this.renderCategoryIntro(classification)}
-
-${resolution.answer}
-
-${this.renderCitations(resolution)}
-${this.closing}
-
-— ContractSpec Support`;
-		return this.buildDraft(ticket, resolution, classification, body);
-	}
-	buildDraft(ticket, resolution, classification, body) {
-		return {
-			ticketId: ticket.id,
-			subject: ticket.subject.startsWith("Re:") ? ticket.subject : `Re: ${ticket.subject}`,
-			body,
-			confidence: Math.min(resolution.confidence, classification.confidence),
-			requiresEscalation: resolution.actions.some((action) => action.type === "escalate") || Boolean(classification.escalationRequired),
-			citations: resolution.citations
-		};
-	}
-	renderCategoryIntro(classification) {
-		switch (classification.category) {
-			case "billing": return "I understand billing issues can be stressful, so let me clarify the situation.";
-			case "technical": return "I see you encountered a technical issue. Here is what happened and how to fix it.";
-			case "product": return "Thanks for sharing feedback about the product. Here are the next steps.";
-			case "account": return "Account access is critical, so let me walk you through the resolution.";
-			case "compliance": return "Compliance questions require precision. See the policy-aligned answer below.";
-			default: return "Here is what we found after reviewing your request.";
-		}
-	}
-	renderCitations(resolution) {
-		if (!resolution.citations.length) return "";
-		return `References:\n${resolution.citations.map((citation, index) => {
-			return `- ${citation.label || `Source ${index + 1}`}${citation.url ? ` (${citation.url})` : ""}`;
-		}).join("\n")}`;
-	}
-};
-
-//#endregion
-export { AutoResponder };

package/dist/libs/support-bot/dist/bot/index.js

@@ -1,2 +0,0 @@
-import { AutoResponder } from "./auto-responder.js";
-import "./tools.js";

package/dist/libs/support-bot/dist/bot/tools.js

@@ -1,71 +0,0 @@
-import * as z from "zod";
-
-//#region ../../libs/support-bot/dist/bot/tools.js
-const ticketSchema = z.object({
-	id: z.string(),
-	subject: z.string(),
-	body: z.string(),
-	channel: z.enum([
-		"email",
-		"chat",
-		"phone",
-		"portal"
-	]),
-	customerName: z.string().optional(),
-	customerEmail: z.string().optional(),
-	metadata: z.object().optional()
-});
-const supportCitationSchema = z.object({
-	label: z.string(),
-	url: z.string().optional(),
-	snippet: z.string().optional(),
-	score: z.number().optional()
-});
-const supportActionSchema = z.object({
-	type: z.enum([
-		"respond",
-		"escalate",
-		"refund",
-		"manual"
-	]),
-	label: z.string(),
-	payload: z.record(z.string(), z.string())
-});
-const supportResolutionSchema = z.object({
-	ticketId: z.string(),
-	answer: z.string(),
-	confidence: z.number(),
-	citations: supportCitationSchema.array(),
-	actions: supportActionSchema.array(),
-	escalationReason: z.string().optional(),
-	knowledgeUpdates: z.array(z.string()).optional()
-});
-const ticketClassificationSchema = z.object({
-	ticketId: z.string(),
-	category: z.enum([
-		"billing",
-		"technical",
-		"product",
-		"account",
-		"compliance",
-		"other"
-	]),
-	priority: z.enum([
-		"urgent",
-		"high",
-		"medium",
-		"low"
-	]),
-	sentiment: z.enum([
-		"positive",
-		"neutral",
-		"negative",
-		"frustrated"
-	]),
-	intents: z.array(z.string()),
-	tags: z.array(z.string()),
-	confidence: z.number(),
-	escalationRequired: z.boolean().optional()
-});
-
-//#endregion

package/dist/libs/support-bot/dist/rag/ticket-resolver.js

@@ -1,63 +0,0 @@
-//#region ../../libs/support-bot/dist/rag/ticket-resolver.js
-var TicketResolver = class {
-	knowledge;
-	minConfidence;
-	prependPrompt;
-	constructor(options) {
-		this.knowledge = options.knowledge;
-		this.minConfidence = options.minConfidence ?? .65;
-		this.prependPrompt = options.prependPrompt;
-	}
-	async resolve(ticket) {
-		const question = this.buildQuestion(ticket);
-		const answer = await this.knowledge.query(question);
-		return this.toResolution(ticket, answer);
-	}
-	buildQuestion(ticket) {
-		const header = [`Subject: ${ticket.subject}`, `Channel: ${ticket.channel}`];
-		if (ticket.customerName) header.push(`Customer: ${ticket.customerName}`);
-		return [
-			this.prependPrompt,
-			header.join("\n"),
-			"---",
-			ticket.body
-		].filter(Boolean).join("\n");
-	}
-	toResolution(ticket, answer) {
-		const citations = answer.references.map((ref) => {
-			return {
-				label: typeof ref.payload?.title === "string" ? ref.payload.title : typeof ref.payload?.documentId === "string" ? ref.payload.documentId : ref.id,
-				url: typeof ref.payload?.url === "string" ? ref.payload.url : void 0,
-				snippet: typeof ref.payload?.text === "string" ? ref.payload.text.slice(0, 280) : void 0,
-				score: ref.score
-			};
-		});
-		const confidence = this.deriveConfidence(answer);
-		const escalate = confidence < this.minConfidence || citations.length === 0;
-		return {
-			ticketId: ticket.id,
-			answer: answer.answer,
-			confidence,
-			citations,
-			actions: [escalate ? {
-				type: "escalate",
-				label: "Escalate for human review"
-			} : {
-				type: "respond",
-				label: "Send automated response"
-			}],
-			escalationReason: escalate ? "Insufficient confidence or missing knowledge references" : void 0,
-			knowledgeUpdates: escalate ? [ticket.body.slice(0, 200)] : void 0
-		};
-	}
-	deriveConfidence(answer) {
-		if (!answer.references.length) return .3;
-		const topScore = answer.references[0]?.score ?? .4;
-		const normalized = Math.min(1, Math.max(0, topScore));
-		const tokenPenalty = answer.usage?.completionTokens ? Math.min(answer.usage.completionTokens / 1e3, .2) : 0;
-		return Number((normalized - tokenPenalty).toFixed(2));
-	}
-};
-
-//#endregion
-export { TicketResolver };

package/dist/libs/support-bot/dist/tickets/classifier.js

@@ -1,198 +0,0 @@
-//#region ../../libs/support-bot/dist/tickets/classifier.js
-const CATEGORY_KEYWORDS = {
-	billing: [
-		"invoice",
-		"payout",
-		"refund",
-		"charge",
-		"billing",
-		"payment"
-	],
-	technical: [
-		"bug",
-		"error",
-		"crash",
-		"issue",
-		"failed",
-		"timeout"
-	],
-	product: [
-		"feature",
-		"roadmap",
-		"idea",
-		"request",
-		"feedback"
-	],
-	account: [
-		"login",
-		"password",
-		"2fa",
-		"account",
-		"profile",
-		"email change"
-	],
-	compliance: [
-		"kyc",
-		"aml",
-		"compliance",
-		"regulation",
-		"gdpr"
-	],
-	other: []
-};
-const PRIORITY_HINTS = {
-	urgent: [
-		"urgent",
-		"asap",
-		"immediately",
-		"today",
-		"right away"
-	],
-	high: [
-		"high priority",
-		"blocking",
-		"major",
-		"critical"
-	],
-	medium: ["soon", "next few days"],
-	low: [
-		"nice to have",
-		"when possible",
-		"later"
-	]
-};
-const SENTIMENT_HINTS = {
-	positive: [
-		"love",
-		"great",
-		"awesome",
-		"thank you"
-	],
-	neutral: [
-		"question",
-		"wonder",
-		"curious"
-	],
-	negative: [
-		"unhappy",
-		"bad",
-		"terrible",
-		"awful",
-		"angry"
-	],
-	frustrated: [
-		"furious",
-		"frustrated",
-		"fed up",
-		"ridiculous"
-	]
-};
-var TicketClassifier = class {
-	keywords;
-	llm;
-	llmModel;
-	constructor(options) {
-		this.keywords = {
-			...CATEGORY_KEYWORDS,
-			...options?.keywords ?? {}
-		};
-		this.llm = options?.llm;
-		this.llmModel = options?.llmModel;
-	}
-	async classify(ticket) {
-		const heuristics = this.heuristicClassification(ticket);
-		if (!this.llm) return heuristics;
-		try {
-			const content = (await this.llm.chat([{
-				role: "system",
-				content: [{
-					type: "text",
-					text: "Classify the support ticket."
-				}]
-			}, {
-				role: "user",
-				content: [{
-					type: "text",
-					text: JSON.stringify({
-						subject: ticket.subject,
-						body: ticket.body,
-						channel: ticket.channel
-					})
-				}]
-			}], {
-				responseFormat: "json",
-				model: this.llmModel
-			})).message.content.find((part) => "text" in part);
-			if (content && "text" in content) {
-				const parsed = JSON.parse(content.text);
-				return {
-					...heuristics,
-					...parsed,
-					intents: parsed.intents ?? heuristics.intents,
-					tags: parsed.tags ?? heuristics.tags
-				};
-			}
-		} catch {}
-		return heuristics;
-	}
-	heuristicClassification(ticket) {
-		const text = `${ticket.subject}\n${ticket.body}`.toLowerCase();
-		const category = this.detectCategory(text);
-		const priority = this.detectPriority(text);
-		const sentiment = this.detectSentiment(text);
-		const intents = this.extractIntents(text);
-		const tags = intents.slice(0, 3);
-		const confidence = this.estimateConfidence(category, priority, sentiment);
-		return {
-			ticketId: ticket.id,
-			category,
-			priority,
-			sentiment,
-			intents,
-			tags,
-			confidence,
-			escalationRequired: priority === "urgent" || category === "compliance"
-		};
-	}
-	detectCategory(text) {
-		for (const [category, keywords] of Object.entries(this.keywords)) if (keywords.some((keyword) => text.includes(keyword))) return category;
-		return "other";
-	}
-	detectPriority(text) {
-		for (const priority of [
-			"urgent",
-			"high",
-			"medium",
-			"low"
-		]) if (PRIORITY_HINTS[priority].some((word) => text.includes(word))) return priority;
-		return "medium";
-	}
-	detectSentiment(text) {
-		for (const sentiment of [
-			"frustrated",
-			"negative",
-			"neutral",
-			"positive"
-		]) if (SENTIMENT_HINTS[sentiment].some((word) => text.includes(word))) return sentiment;
-		return "neutral";
-	}
-	extractIntents(text) {
-		const intents = [];
-		if (text.includes("refund") || text.includes("chargeback")) intents.push("refund");
-		if (text.includes("payout")) intents.push("payout");
-		if (text.includes("login")) intents.push("login-help");
-		if (text.includes("feature")) intents.push("feature-request");
-		if (text.includes("bug") || text.includes("error")) intents.push("bug-report");
-		return intents.length ? intents : ["general"];
-	}
-	estimateConfidence(category, priority, sentiment) {
-		let base = .6;
-		if (category !== "other") base += .1;
-		if (priority === "urgent" || priority === "low") base += .05;
-		if (sentiment === "frustrated") base -= .05;
-		return Math.min(.95, Math.max(.4, Number(base.toFixed(2))));
-	}
-};
-
-//#endregion
-export { TicketClassifier };

package/dist/setup.d.ts

@@ -1,4 +0,0 @@
-//#region src/setup.d.ts
-declare function runAiSupportBotExample(): Promise<void>;
-//#endregion
-export { runAiSupportBotExample };