@lssm/lib.support-bot 0.4.1 → 1.41.1

package/README.md

@@ -43,4 +43,4 @@ const outcome = await runner.run({
 });
 ```
 
-See `/packages/contractspec/examples/ai-support-bot` for an end-to-end integration with ticket ingestion, review queues, and analytics.
+See `/packages/examples/ai-support-bot` for an end-to-end integration with ticket ingestion, review queues, and analytics.

package/dist/bot/tools.js

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

package/dist/index.js

@@ -1 +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";export{r as AutoResponder,i as SupportFeedbackLoop,n as TicketClassifier,t as TicketResolver,a as createSupportTools,e as defineSupportBot};
+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/spec.js

@@ -1 +1 @@
-import{t as e}from"./ai-agent/dist/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};
+import{defineAgent as e}from"@lssm/lib.ai-agent";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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.support-bot",
-  "version": "0.4.1",
+  "version": "1.41.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -11,6 +11,7 @@
   ],
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
     "build": "bun build:bundle && bun build:types",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
@@ -22,30 +23,44 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.ai-agent": "^0.4.1",
-    "@lssm/lib.contracts": "^1.11.1"
+    "@lssm/lib.ai-agent": "1.41.1",
+    "@lssm/lib.contracts": "1.41.1"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.12.1",
-    "@lssm/tool.typescript": "0.11.1",
-    "tsdown": "^0.16.6",
+    "@lssm/tool.tsdown": "1.41.1",
+    "@lssm/tool.typescript": "1.41.1",
+    "tsdown": "^0.17.4",
     "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",
+    ".": "./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",
     "./*": "./*"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "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",
+      "./*": "./*"
+    }
   }
 }

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

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

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

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

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

@@ -1 +0,0 @@
-import{t as e}from"./spec.js";import"./tools/executor.js";import"./memory/manager.js";import"./runner.js";import"./memory/in-memory.js";import"./memory/index.js";import"./tools/index.js";import"./approval/workflow.js";import"./approval/index.js";

package/dist/ai-agent/dist/memory/in-memory.js

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

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

@@ -1 +0,0 @@
-import"./manager.js";import"./in-memory.js";

package/dist/ai-agent/dist/memory/manager.js

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

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

@@ -1 +0,0 @@
-import"./tools/executor.js";import"./memory/manager.js";import"node:crypto";

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

@@ -1 +0,0 @@
-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`);return Object.freeze(e)}export{e as t};

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

@@ -1 +0,0 @@
-import"node:timers/promises";

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

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

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

@@ -1,25 +0,0 @@
-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

@@ -1,19 +0,0 @@
-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

@@ -1,4 +0,0 @@
-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

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

package/dist/index.d.ts

@@ -1,8 +0,0 @@
-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/rag/index.d.ts

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

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

@@ -1,24 +0,0 @@
-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/spec.d.ts

@@ -1,12 +0,0 @@
-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

@@ -1,24 +0,0 @@
-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

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

package/dist/types.d.ts

@@ -1,75 +0,0 @@
-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 };