@lssm/lib.support-bot 0.0.0-canary-20251206160926

package/README.md

@@ -0,0 +1,46 @@
+# @lssm/lib.support-bot
+
+Production-ready building blocks for AI-first support desks powered by ContractSpec. The library wires knowledge-grounded responses, ticket classification, auto-resolutions, and performance telemetry into `@lssm/lib.ai-agent`.
+
+## Highlights
+
+- **TicketClassifier** – fast heuristics + optional LLM validation for category, priority, urgency, and sentiment.
+- **TicketResolver** – multi-space RAG pipeline that cites references and surfaces confidence scores.
+- **AutoResponder** – generates tone-aware replies, adds policy disclaimers, and escalates when risky.
+- **FeedbackLoop** – records outcomes, tunes confidence thresholds, and syncs new knowledge back.
+- **Agent Tools** – helpers to expose the above capabilities as `AgentRunner` tools in one line.
+
+## Quickstart
+
+```ts
+import { defineSupportBot, TicketResolver, TicketClassifier, createSupportTools } from '@lssm/lib.support-bot';
+import { AgentRegistry, AgentRunner, ToolExecutor } from '@lssm/lib.ai-agent';
+
+const SupportBot = defineSupportBot({
+  base: {
+    meta: { name: 'support.bot', version: 1, owners: ['team-support'], domain: 'operations' },
+    instructions: 'Resolve support tickets with empathy. Escalate if billing or compliance risk.',
+    tools: [{ name: 'resolve_ticket' }, { name: 'escalate_ticket' }],
+  },
+  escalation: { confidenceThreshold: 0.75 },
+});
+
+const resolver = new TicketResolver({ knowledge: knowledgeQueryService });
+const classifier = new TicketClassifier();
+const tools = createSupportTools({ resolver, classifier });
+
+const registry = new AgentRegistry().register(SupportBot);
+const runner = new AgentRunner({
+  registry,
+  llm: mistralProvider,
+  toolExecutor: new ToolExecutor({ tools }),
+});
+
+const outcome = await runner.run({
+  agent: 'support.bot',
+  input: 'My payout failed yesterday and it is urgent',
+  tenantId: 'acme',
+});
+```
+
+See `/packages/contractspec/examples/ai-support-bot` for an end-to-end integration with ticket ingestion, review queues, and analytics.

package/dist/ai-agent/dist/agent/agent-factory.js

@@ -0,0 +1 @@
+import"./contract-spec-agent.js";

package/dist/ai-agent/dist/agent/contract-spec-agent.js

@@ -0,0 +1 @@
+import"../tools/tool-adapter.js";import"../tools/knowledge-tool.js";import{z as e}from"zod";import"ai";e.object({tenantId:e.string().optional(),actorId:e.string().optional(),sessionId:e.string().optional(),metadata:e.record(e.string(),e.unknown()).optional()});

package/dist/ai-agent/dist/agent/index.js

@@ -0,0 +1 @@
+import"./contract-spec-agent.js";import"./agent-factory.js";

package/dist/ai-agent/dist/approval/index.js

@@ -0,0 +1 @@
+import"./workflow.js";

package/dist/ai-agent/dist/approval/workflow.js

@@ -0,0 +1 @@
+import"node:crypto";

package/dist/ai-agent/dist/index.js

@@ -0,0 +1 @@
+import"./schema/json-schema-to-zod.js";import"./tools/tool-adapter.js";import"./tools/knowledge-tool.js";import{e}from"./spec/spec.js";import"./agent/contract-spec-agent.js";import"./agent/agent-factory.js";import"./agent/index.js";import"./tools/mcp-client.js";import"./tools/mcp-server.js";import"./tools/index.js";import"./schema/schema-output.js";import"./schema/index.js";import"./approval/workflow.js";import"./approval/index.js";import"ai";

package/dist/ai-agent/dist/schema/index.js

@@ -0,0 +1 @@
+import"./json-schema-to-zod.js";import"./schema-output.js";

package/dist/ai-agent/dist/schema/json-schema-to-zod.js

@@ -0,0 +1 @@
+import{z as e}from"zod";

package/dist/ai-agent/dist/schema/schema-output.js

@@ -0,0 +1 @@
+import"./json-schema-to-zod.js";import{z as e}from"zod";import"ai";

package/dist/ai-agent/dist/spec/spec.js

@@ -0,0 +1 @@
+function e(e){if(!e.meta?.name)throw Error(`Agent name is required`);if(!Number.isFinite(e.meta.version))throw Error(`Agent ${e.meta.name} is missing a numeric version`);if(!e.instructions?.trim())throw Error(`Agent ${e.meta.name} requires instructions`);if(!e.tools?.length)throw Error(`Agent ${e.meta.name} must expose at least one tool`);let t=new Set;for(let n of e.tools){if(t.has(n.name))throw Error(`Agent ${e.meta.name} has duplicate tool name: ${n.name}`);t.add(n.name)}return Object.freeze(e)}export{e};

package/dist/ai-agent/dist/tools/index.js

@@ -0,0 +1 @@
+import"./tool-adapter.js";import"./knowledge-tool.js";import"./mcp-client.js";import"./mcp-server.js";

package/dist/ai-agent/dist/tools/knowledge-tool.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import"ai";

package/dist/ai-agent/dist/tools/mcp-client.js

@@ -0,0 +1 @@
+import"@ai-sdk/mcp";import"@ai-sdk/mcp/mcp-stdio";

package/dist/ai-agent/dist/tools/mcp-server.js

@@ -0,0 +1 @@
+import"../schema/json-schema-to-zod.js";import{z as e}from"zod";import"@modelcontextprotocol/sdk/server/mcp.js";

package/dist/ai-agent/dist/tools/tool-adapter.js

@@ -0,0 +1 @@
+import"../schema/json-schema-to-zod.js";import"ai";

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/auto-responder.js

@@ -0,0 +1,18 @@
+var e=class{llm;model;tone;closing;constructor(e){this.llm=e?.llm,this.model=e?.model,this.tone=e?.tone??`friendly`,this.closing=e?.closing??(this.tone===`friendly`?`We remain available if you need anything else.`:`Please let us know if you require additional assistance.`)}async draft(e,t,n){return this.llm?this.generateWithLLM(e,t,n):this.generateTemplate(e,t,n)}async generateWithLLM(e,t,n){let r=`You are a ${this.tone} support agent. Draft an email response.
+Ticket Subject: ${e.subject}
+Ticket Body: ${e.body}
+Detected Category: ${n.category}
+Detected Priority: ${n.priority}
+Resolution:
+${t.answer}
+Citations: ${t.citations.map(e=>e.label).join(`, `)}`,i=(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:r}]}],{model:this.model})).message.content.map(e=>`text`in e?e.text:``).join(``).trim();return this.buildDraft(e,t,n,i)}generateTemplate(e,t,n){let r=`${e.customerName?`Hi ${e.customerName},`:`Hi there,`}
+
+Thanks for contacting us about "${e.subject}". ${this.renderCategoryIntro(n)}
+
+${t.answer}
+
+${this.renderCitations(t)}
+${this.closing}
+
+— ContractSpec Support`;return this.buildDraft(e,t,n,r)}buildDraft(e,t,n,r){return{ticketId:e.id,subject:e.subject.startsWith(`Re:`)?e.subject:`Re: ${e.subject}`,body:r,confidence:Math.min(t.confidence,n.confidence),requiresEscalation:t.actions.some(e=>e.type===`escalate`)||!!n.escalationRequired,citations:t.citations}}renderCategoryIntro(e){switch(e.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(e){return e.citations.length?`References:\n${e.citations.map((e,t)=>`- ${e.label||`Source ${t+1}`}${e.url?` (${e.url})`:``}`).join(`
+`)}`:``}};export{e as AutoResponder};

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/feedback-loop.js

@@ -0,0 +1,2 @@
+var e=class{history=[];responseTimes=new Map;recordResolution(e,t){this.history.push(e),t!=null&&this.responseTimes.set(e.ticket.id,t)}metrics(){let e=this.history.length,t=this.history.filter(e=>!e.resolution.actions.some(e=>e.type===`escalate`)).length,n=e-t,r=e===0?0:this.history.reduce((e,t)=>e+t.resolution.confidence,0)/e,i=this.responseTimes.size===0?0:[...this.responseTimes.values()].reduce((e,t)=>e+t,0)/this.responseTimes.size;return{totalTickets:e,autoResolved:t,escalated:n,avgConfidence:Number(r.toFixed(2)),avgResponseTimeMs:Math.round(i)}}feedbackSummary(e=5){let t=this.history.slice(-e);return t.length?t.map(e=>{let t=e.resolution.actions.some(e=>e.type===`escalate`)?`Escalated`:`Auto-resolved`;return`${e.ticket.subject} – ${t} (confidence: ${e.resolution.confidence})`}).join(`
+`):`No feedback recorded yet.`}};export{e as 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/index.js

@@ -0,0 +1 @@
+import{AutoResponder as e}from"./auto-responder.js";import{SupportFeedbackLoop as t}from"./feedback-loop.js";import{createSupportTools as n}from"./tools.js";export{e as AutoResponder,t as SupportFeedbackLoop,n as 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/bot/tools.js

@@ -0,0 +1 @@
+import{z as e}from"zod";const t=e.object({id:e.string(),subject:e.string(),body:e.string(),channel:e.enum([`email`,`chat`,`phone`,`portal`]),customerName:e.string().optional(),customerEmail:e.string().optional(),metadata:e.object().optional()}),n=e.object({label:e.string(),url:e.string().optional(),snippet:e.string().optional(),score:e.number().optional()}),r=e.object({type:e.enum([`respond`,`escalate`,`refund`,`manual`]),label:e.string(),payload:e.record(e.string(),e.string())}),i=e.object({ticketId:e.string(),answer:e.string(),confidence:e.number(),citations:n.array(),actions:r.array(),escalationReason:e.string().optional(),knowledgeUpdates:e.array(e.string()).optional()}),a=e.object({ticketId:e.string(),category:e.enum([`billing`,`technical`,`product`,`account`,`compliance`,`other`]),priority:e.enum([`urgent`,`high`,`medium`,`low`]),sentiment:e.enum([`positive`,`neutral`,`negative`,`frustrated`]),intents:e.array(e.string()),tags:e.array(e.string()),confidence:e.number(),escalationRequired:e.boolean().optional()});function o(e){if(!e||typeof e!=`object`||!(`ticket`in e))throw Error(`Input must include ticket`);let t=e.ticket;if(!t?.id)throw Error(`Ticket is missing id`);return t}function s(e){if(!(!e||typeof e!=`object`||!(`resolution`in e)))return e.resolution}function c(e){if(!(!e||typeof e!=`object`||!(`classification`in e)))return e.classification}function l(n){return[{title:`support_classify_ticket`,description:`Classify a ticket for priority, sentiment, and category`,inputSchema:e.object({ticket:t}),execute:async e=>{let t=o(e),r=await n.classifier.classify(t);return{content:JSON.stringify(r),metadata:{ticketId:t.id}}}},{title:`support_resolve_ticket`,description:`Generate a knowledge-grounded resolution for a ticket`,inputSchema:e.object({ticket:t}),execute:async e=>{let t=o(e),r=await n.resolver.resolve(t);return{content:JSON.stringify(r),metadata:{ticketId:t.id}}}},{title:`support_draft_response`,description:`Draft a user-facing reply based on resolution + classification`,inputSchema:e.object({ticket:t,resolution:i,classification:a}),execute:async e=>{let t=o(e),r=s(e),i=c(e);if(!r||!i)throw Error(`resolution and classification are required`);let a=await n.responder.draft(t,r,i);return{content:JSON.stringify(a),metadata:{ticketId:t.id}}}}]}export{l as createSupportTools};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+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 { SupportBotDefinition, defineSupportBot } from "./spec.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/index.js

@@ -0,0 +1 @@
+import{defineSupportBot as e}from"./spec.js";import{TicketResolver as t}from"./rag/ticket-resolver.js";import{TicketClassifier as n}from"./tickets/classifier.js";import{AutoResponder as r}from"./bot/auto-responder.js";import{SupportFeedbackLoop as i}from"./bot/feedback-loop.js";import{createSupportTools as a}from"./bot/tools.js";import"./bot/index.js";export{r as AutoResponder,i as SupportFeedbackLoop,n as TicketClassifier,t as TicketResolver,a as createSupportTools,e as 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/index.js

@@ -0,0 +1 @@
+import{TicketResolver as e}from"./ticket-resolver.js";export{e as TicketResolver};

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

@@ -0,0 +1,24 @@
+import { SupportResolution, SupportTicket } from "../types.js";
+import { KnowledgeAnswer } from "@lssm/lib.contracts/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/rag/ticket-resolver.js

@@ -0,0 +1,3 @@
+var e=class{knowledge;minConfidence;prependPrompt;constructor(e){this.knowledge=e.knowledge,this.minConfidence=e.minConfidence??.65,this.prependPrompt=e.prependPrompt}async resolve(e){let t=this.buildQuestion(e),n=await this.knowledge.query(t);return this.toResolution(e,n)}buildQuestion(e){let t=[`Subject: ${e.subject}`,`Channel: ${e.channel}`];return e.customerName&&t.push(`Customer: ${e.customerName}`),[this.prependPrompt,t.join(`
+`),`---`,e.body].filter(Boolean).join(`
+`)}toResolution(e,t){let n=t.references.map(e=>({label:typeof e.payload?.title==`string`?e.payload.title:typeof e.payload?.documentId==`string`?e.payload.documentId:e.id,url:typeof e.payload?.url==`string`?e.payload.url:void 0,snippet:typeof e.payload?.text==`string`?e.payload.text.slice(0,280):void 0,score:e.score})),r=this.deriveConfidence(t),i=r<this.minConfidence||n.length===0;return{ticketId:e.id,answer:t.answer,confidence:r,citations:n,actions:[i?{type:`escalate`,label:`Escalate for human review`}:{type:`respond`,label:`Send automated response`}],escalationReason:i?`Insufficient confidence or missing knowledge references`:void 0,knowledgeUpdates:i?[e.body.slice(0,200)]:void 0}}deriveConfidence(e){if(!e.references.length)return .3;let t=e.references[0]?.score??.4,n=Math.min(1,Math.max(0,t)),r=e.usage?.completionTokens?Math.min(e.usage.completionTokens/1e3,.2):0;return Number((n-r).toFixed(2))}};export{e as TicketResolver};

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/spec.js

@@ -0,0 +1 @@
+import{e}from"./ai-agent/dist/spec/spec.js";import"./ai-agent/dist/index.js";function t(t){return{...e({...t.base,policy:{...t.base.policy,confidence:{min:t.base.policy?.confidence?.min??.7,default:t.base.policy?.confidence?.default??.6},escalation:{confidenceThreshold:t.autoEscalateThreshold??t.base.policy?.escalation?.confidenceThreshold??t.base.policy?.confidence?.min??.7,...t.base.policy?.escalation}},memory:t.base.memory??{maxEntries:120,ttlMinutes:120},tools:t.tools??t.base.tools,instructions:`${t.base.instructions}\n\nAlways cite support knowledge sources and flag compliance/billing issues for human review when unsure.`}),thresholds:{autoResolveMinConfidence:t.autoEscalateThreshold??.75,maxIterations:6}}}export{t as 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/classifier.js

@@ -0,0 +1 @@
+const e={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:[]},t={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`]},n={positive:[`love`,`great`,`awesome`,`thank you`],neutral:[`question`,`wonder`,`curious`],negative:[`unhappy`,`bad`,`terrible`,`awful`,`angry`],frustrated:[`furious`,`frustrated`,`fed up`,`ridiculous`]};var r=class{keywords;llm;llmModel;constructor(t){this.keywords={...e,...t?.keywords??{}},this.llm=t?.llm,this.llmModel=t?.llmModel}async classify(e){let t=this.heuristicClassification(e);if(!this.llm)return t;try{let n=(await this.llm.chat([{role:`system`,content:[{type:`text`,text:`Classify the support ticket.`}]},{role:`user`,content:[{type:`text`,text:JSON.stringify({subject:e.subject,body:e.body,channel:e.channel})}]}],{responseFormat:`json`,model:this.llmModel})).message.content.find(e=>`text`in e);if(n&&`text`in n){let e=JSON.parse(n.text);return{...t,...e,intents:e.intents??t.intents,tags:e.tags??t.tags}}}catch{}return t}heuristicClassification(e){let t=`${e.subject}\n${e.body}`.toLowerCase(),n=this.detectCategory(t),r=this.detectPriority(t),i=this.detectSentiment(t),a=this.extractIntents(t),o=a.slice(0,3),s=this.estimateConfidence(n,r,i);return{ticketId:e.id,category:n,priority:r,sentiment:i,intents:a,tags:o,confidence:s,escalationRequired:r===`urgent`||n===`compliance`}}detectCategory(e){for(let[t,n]of Object.entries(this.keywords))if(n.some(t=>e.includes(t)))return t;return`other`}detectPriority(e){for(let n of[`urgent`,`high`,`medium`,`low`])if(t[n].some(t=>e.includes(t)))return n;return`medium`}detectSentiment(e){for(let t of[`frustrated`,`negative`,`neutral`,`positive`])if(n[t].some(t=>e.includes(t)))return t;return`neutral`}extractIntents(e){let t=[];return(e.includes(`refund`)||e.includes(`chargeback`))&&t.push(`refund`),e.includes(`payout`)&&t.push(`payout`),e.includes(`login`)&&t.push(`login-help`),e.includes(`feature`)&&t.push(`feature-request`),(e.includes(`bug`)||e.includes(`error`))&&t.push(`bug-report`),t.length?t:[`general`]}estimateConfidence(e,t,n){let r=.6;return e!==`other`&&(r+=.1),(t===`urgent`||t===`low`)&&(r+=.05),n===`frustrated`&&(r-=.05),Math.min(.95,Math.max(.4,Number(r.toFixed(2))))}};export{r as TicketClassifier};

package/dist/tickets/index.d.ts

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

package/dist/tickets/index.js

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

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

@@ -0,0 +1,51 @@
+{
+  "name": "@lssm/lib.support-bot",
+  "version": "0.0.0-canary-20251206160926",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun run"
+  },
+  "dependencies": {
+    "@lssm/lib.ai-agent": "workspace:*",
+    "@lssm/lib.contracts": "workspace:*"
+  },
+  "devDependencies": {
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "tsdown": "^0.17.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./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": {
+    "access": "public"
+  }
+}