@contractspec/lib.support-bot 1.57.0 → 1.58.0

package/dist/types.d.ts

@@ -1,76 +1,72 @@
-import { AgentSpec } from "@contractspec/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>;
+import type { AgentSpec } from '@contractspec/lib.ai-agent';
+export type TicketPriority = 'low' | 'medium' | 'high' | 'urgent';
+export type TicketCategory = 'billing' | 'technical' | 'product' | 'account' | 'compliance' | 'other';
+export type TicketChannel = 'email' | 'chat' | 'phone' | 'portal';
+export type TicketSentiment = 'positive' | 'neutral' | 'negative' | 'frustrated';
+export 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;
+export 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;
+export interface SupportCitation {
+    label: string;
+    url?: string;
+    snippet?: string;
+    score?: number;
 }
-interface SupportAction {
-  type: 'respond' | 'escalate' | 'refund' | 'manual';
-  label: string;
-  payload?: Record<string, string>;
+export 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[];
+export 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[];
+export 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;
-  };
+export interface SupportBotSpec extends AgentSpec {
+    thresholds?: {
+        autoResolveMinConfidence?: number;
+        maxIterations?: number;
+    };
+    review?: {
+        queueName?: string;
+        approvalWorkflow?: string;
+    };
 }
-interface ClassificationResultPayload {
-  ticket: SupportTicket;
-  classification: TicketClassification;
+export interface ClassificationResultPayload {
+    ticket: SupportTicket;
+    classification: TicketClassification;
 }
-interface ResolutionResultPayload extends ClassificationResultPayload {
-  resolution: SupportResolution;
-  draft: SupportResponseDraft;
+export interface ResolutionResultPayload extends ClassificationResultPayload {
+    resolution: SupportResolution;
+    draft: SupportResponseDraft;
 }
-//#endregion
-export { ClassificationResultPayload, ResolutionResultPayload, SupportAction, SupportBotSpec, SupportCitation, SupportResolution, SupportResponseDraft, SupportTicket, TicketCategory, TicketChannel, TicketClassification, TicketPriority, TicketSentiment };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;KAEY,cAAA;AAAA,KACA,cAAA;AAAA,KAOA,aAAA;AAAA,KACA,eAAA;AAAA,UAMK,aAAA;EACf,EAAA;EACA,OAAA;EACA,IAAA;EACA,OAAA,EAAS,aAAA;EACT,MAAA;EACA,aAAA;EACA,YAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,oBAAA;EACf,QAAA;EACA,QAAA,EAAU,cAAA;EACV,QAAA,EAAU,cAAA;EACV,SAAA,EAAW,eAAA;EACX,OAAA;EACA,IAAA;EACA,UAAA;EACA,kBAAA;AAAA;AAAA,UAGe,eAAA;EACf,KAAA;EACA,GAAA;EACA,OAAA;EACA,KAAA;AAAA;AAAA,UAGe,aAAA;EACf,IAAA;EACA,KAAA;EACA,OAAA,GAAU,MAAA;AAAA;AAAA,UAGK,iBAAA;EACf,QAAA;EACA,MAAA;EACA,UAAA;EACA,SAAA,EAAW,eAAA;EACX,OAAA,EAAS,aAAA;EACT,gBAAA;EACA,gBAAA;AAAA;AAAA,UAGe,oBAAA;EACf,QAAA;EACA,OAAA;EACA,IAAA;EACA,UAAA;EACA,kBAAA;EACA,SAAA,EAAW,eAAA;AAAA;AAAA,UAGI,cAAA,SAAuB,SAAA;EACtC,UAAA;IACE,wBAAA;IACA,aAAA;EAAA;EAEF,MAAA;IACE,SAAA;IACA,gBAAA;EAAA;AAAA;AAAA,UAIa,2BAAA;EACf,MAAA,EAAQ,aAAA;EACR,cAAA,EAAgB,oBAAA;AAAA;AAAA,UAGD,uBAAA,SAAgC,2BAAA;EAC/C,UAAA,EAAY,iBAAA;EACZ,KAAA,EAAO,oBAAA;AAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAClE,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,WAAW,GACX,SAAS,GACT,SAAS,GACT,YAAY,GACZ,OAAO,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAClE,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,SAAS,GACT,UAAU,GACV,YAAY,CAAC;AAEjB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,UAAU,CAAC,EAAE;QACX,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,uBAAwB,SAAQ,2BAA2B;IAC1E,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,oBAAoB,CAAC;CAC7B"}

package/dist/types.js

@@ -0,0 +1 @@
+// @bun

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.support-bot",
-  "version": "1.57.0",
+  "version": "1.58.0",
   "description": "AI support bot framework with RAG and ticket management",
   "keywords": [
     "contractspec",
@@ -19,59 +19,148 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun test"
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@ai-sdk/provider-utils": "^4.0.4",
-    "@contractspec/lib.ai-agent": "1.57.0",
-    "@contractspec/lib.contracts": "1.57.0",
-    "@contractspec/lib.knowledge": "1.57.0",
-    "@contractspec/lib.schema": "1.57.0",
+    "@contractspec/lib.ai-agent": "1.58.0",
+    "@contractspec/lib.contracts": "1.58.0",
+    "@contractspec/lib.knowledge": "1.58.0",
+    "@contractspec/lib.schema": "1.58.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.57.0",
-    "@contractspec/tool.typescript": "1.57.0",
-    "tsdown": "^0.20.3",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.58.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.57.0"
   },
   "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/index": "./src/bot/index.ts",
+    "./bot/tools": "./src/bot/tools.ts",
+    "./rag": "./src/rag/index.ts",
+    "./rag/index": "./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",
+    "./tickets/index": "./src/tickets/index.ts",
+    "./types": "./src/types.ts"
   },
   "publishConfig": {
     "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",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "browser": "./dist/browser/index.js",
+        "default": "./dist/index.js"
+      },
+      "./bot": {
+        "types": "./dist/bot/index.d.ts",
+        "bun": "./dist/bot/index.js",
+        "node": "./dist/node/bot/index.mjs",
+        "browser": "./dist/browser/bot/index.js",
+        "default": "./dist/bot/index.js"
+      },
+      "./bot/auto-responder": {
+        "types": "./dist/bot/auto-responder.d.ts",
+        "bun": "./dist/bot/auto-responder.js",
+        "node": "./dist/node/bot/auto-responder.mjs",
+        "browser": "./dist/browser/bot/auto-responder.js",
+        "default": "./dist/bot/auto-responder.js"
+      },
+      "./bot/feedback-loop": {
+        "types": "./dist/bot/feedback-loop.d.ts",
+        "bun": "./dist/bot/feedback-loop.js",
+        "node": "./dist/node/bot/feedback-loop.mjs",
+        "browser": "./dist/browser/bot/feedback-loop.js",
+        "default": "./dist/bot/feedback-loop.js"
+      },
+      "./bot/index": {
+        "types": "./dist/bot/index.d.ts",
+        "bun": "./dist/bot/index.js",
+        "node": "./dist/node/bot/index.mjs",
+        "browser": "./dist/browser/bot/index.js",
+        "default": "./dist/bot/index.js"
+      },
+      "./bot/tools": {
+        "types": "./dist/bot/tools.d.ts",
+        "bun": "./dist/bot/tools.js",
+        "node": "./dist/node/bot/tools.mjs",
+        "browser": "./dist/browser/bot/tools.js",
+        "default": "./dist/bot/tools.js"
+      },
+      "./rag": {
+        "types": "./dist/rag/index.d.ts",
+        "bun": "./dist/rag/index.js",
+        "node": "./dist/node/rag/index.mjs",
+        "browser": "./dist/browser/rag/index.js",
+        "default": "./dist/rag/index.js"
+      },
+      "./rag/index": {
+        "types": "./dist/rag/index.d.ts",
+        "bun": "./dist/rag/index.js",
+        "node": "./dist/node/rag/index.mjs",
+        "browser": "./dist/browser/rag/index.js",
+        "default": "./dist/rag/index.js"
+      },
+      "./rag/ticket-resolver": {
+        "types": "./dist/rag/ticket-resolver.d.ts",
+        "bun": "./dist/rag/ticket-resolver.js",
+        "node": "./dist/node/rag/ticket-resolver.mjs",
+        "browser": "./dist/browser/rag/ticket-resolver.js",
+        "default": "./dist/rag/ticket-resolver.js"
+      },
+      "./spec": {
+        "types": "./dist/spec.d.ts",
+        "bun": "./dist/spec.js",
+        "node": "./dist/node/spec.mjs",
+        "browser": "./dist/browser/spec.js",
+        "default": "./dist/spec.js"
+      },
+      "./tickets": {
+        "types": "./dist/tickets/index.d.ts",
+        "bun": "./dist/tickets/index.js",
+        "node": "./dist/node/tickets/index.mjs",
+        "browser": "./dist/browser/tickets/index.js",
+        "default": "./dist/tickets/index.js"
+      },
+      "./tickets/classifier": {
+        "types": "./dist/tickets/classifier.d.ts",
+        "bun": "./dist/tickets/classifier.js",
+        "node": "./dist/node/tickets/classifier.mjs",
+        "browser": "./dist/browser/tickets/classifier.js",
+        "default": "./dist/tickets/classifier.js"
+      },
+      "./tickets/index": {
+        "types": "./dist/tickets/index.d.ts",
+        "bun": "./dist/tickets/index.js",
+        "node": "./dist/node/tickets/index.mjs",
+        "browser": "./dist/browser/tickets/index.js",
+        "default": "./dist/tickets/index.js"
+      },
+      "./types": {
+        "types": "./dist/types.d.ts",
+        "bun": "./dist/types.js",
+        "node": "./dist/node/types.mjs",
+        "browser": "./dist/browser/types.js",
+        "default": "./dist/types.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/dist/bot/auto-responder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto-responder.js","names":[],"sources":["../../src/bot/auto-responder.ts"],"sourcesContent":["import type { LLMProvider } from '@contractspec/lib.contracts/integrations/providers/llm';\nimport type {\n  SupportResponseDraft,\n  SupportResolution,\n  SupportTicket,\n  TicketClassification,\n} from '../types';\n\nexport interface AutoResponderOptions {\n  llm?: LLMProvider;\n  model?: string;\n  tone?: 'friendly' | 'formal';\n  closing?: string;\n}\n\nexport class AutoResponder {\n  private readonly llm?: LLMProvider;\n  private readonly model?: string;\n  private readonly tone: 'friendly' | 'formal';\n  private readonly closing: string;\n\n  constructor(options?: AutoResponderOptions) {\n    this.llm = options?.llm;\n    this.model = options?.model;\n    this.tone = options?.tone ?? 'friendly';\n    this.closing =\n      options?.closing ??\n      (this.tone === 'friendly'\n        ? 'We remain available if you need anything else.'\n        : 'Please let us know if you require additional assistance.');\n  }\n\n  async draft(\n    ticket: SupportTicket,\n    resolution: SupportResolution,\n    classification: TicketClassification\n  ): Promise<SupportResponseDraft> {\n    if (this.llm) {\n      return this.generateWithLLM(ticket, resolution, classification);\n    }\n    return this.generateTemplate(ticket, resolution, classification);\n  }\n\n  private async generateWithLLM(\n    ticket: SupportTicket,\n    resolution: SupportResolution,\n    classification: TicketClassification\n  ): Promise<SupportResponseDraft> {\n    const prompt = `You are a ${this.tone} support agent. Draft an email response.\nTicket Subject: ${ticket.subject}\nTicket Body: ${ticket.body}\nDetected Category: ${classification.category}\nDetected Priority: ${classification.priority}\nResolution:\n${resolution.answer}\nCitations: ${resolution.citations.map((c) => c.label).join(', ')}`;\n\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    const response = await this.llm!.chat(\n      [\n        {\n          role: 'system',\n          content: [\n            {\n              type: 'text',\n              text: 'Write empathetic, accurate support replies that cite sources when relevant.',\n            },\n          ],\n        },\n        {\n          role: 'user',\n          content: [{ type: 'text', text: prompt }],\n        },\n      ],\n      { model: this.model }\n    );\n\n    const body = response.message.content\n      .map((part) => ('text' in part ? part.text : ''))\n      .join('')\n      .trim();\n\n    return this.buildDraft(ticket, resolution, classification, body);\n  }\n\n  private generateTemplate(\n    ticket: SupportTicket,\n    resolution: SupportResolution,\n    classification: TicketClassification\n  ): SupportResponseDraft {\n    const greeting = ticket.customerName\n      ? `Hi ${ticket.customerName},`\n      : 'Hi there,';\n    const body = `${greeting}\n\nThanks for contacting us about \"${ticket.subject}\". ${this.renderCategoryIntro(\n      classification\n    )}\n\n${resolution.answer}\n\n${this.renderCitations(resolution)}\n${this.closing}\n\n— ContractSpec Support`;\n\n    return this.buildDraft(ticket, resolution, classification, body);\n  }\n\n  private buildDraft(\n    ticket: SupportTicket,\n    resolution: SupportResolution,\n    classification: TicketClassification,\n    body: string\n  ): SupportResponseDraft {\n    return {\n      ticketId: ticket.id,\n      subject: ticket.subject.startsWith('Re:')\n        ? ticket.subject\n        : `Re: ${ticket.subject}`,\n      body,\n      confidence: Math.min(resolution.confidence, classification.confidence),\n      requiresEscalation:\n        resolution.actions.some((action) => action.type === 'escalate') ||\n        Boolean(classification.escalationRequired),\n      citations: resolution.citations,\n    };\n  }\n\n  private renderCategoryIntro(classification: TicketClassification) {\n    switch (classification.category) {\n      case 'billing':\n        return 'I understand billing issues can be stressful, so let me clarify the situation.';\n      case 'technical':\n        return 'I see you encountered a technical issue. Here is what happened and how to fix it.';\n      case 'product':\n        return 'Thanks for sharing feedback about the product. Here are the next steps.';\n      case 'account':\n        return 'Account access is critical, so let me walk you through the resolution.';\n      case 'compliance':\n        return 'Compliance questions require precision. See the policy-aligned answer below.';\n      default:\n        return 'Here is what we found after reviewing your request.';\n    }\n  }\n\n  private renderCitations(resolution: SupportResolution) {\n    if (!resolution.citations.length) return '';\n    const lines = resolution.citations.map((citation, index) => {\n      const label = citation.label || `Source ${index + 1}`;\n      const link = citation.url ? ` (${citation.url})` : '';\n      return `- ${label}${link}`;\n    });\n    return `References:\\n${lines.join('\\n')}`;\n  }\n}\n"],"mappings":";AAeA,IAAa,gBAAb,MAA2B;CACzB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAgC;AAC1C,OAAK,MAAM,SAAS;AACpB,OAAK,QAAQ,SAAS;AACtB,OAAK,OAAO,SAAS,QAAQ;AAC7B,OAAK,UACH,SAAS,YACR,KAAK,SAAS,aACX,mDACA;;CAGR,MAAM,MACJ,QACA,YACA,gBAC+B;AAC/B,MAAI,KAAK,IACP,QAAO,KAAK,gBAAgB,QAAQ,YAAY,eAAe;AAEjE,SAAO,KAAK,iBAAiB,QAAQ,YAAY,eAAe;;CAGlE,MAAc,gBACZ,QACA,YACA,gBAC+B;EAC/B,MAAM,SAAS,aAAa,KAAK,KAAK;kBACxB,OAAO,QAAQ;eAClB,OAAO,KAAK;qBACN,eAAe,SAAS;qBACxB,eAAe,SAAS;;EAE3C,WAAW,OAAO;aACP,WAAW,UAAU,KAAK,MAAM,EAAE,MAAM,CAAC,KAAK,KAAK;EAsB5D,MAAM,QAnBW,MAAM,KAAK,IAAK,KAC/B,CACE;GACE,MAAM;GACN,SAAS,CACP;IACE,MAAM;IACN,MAAM;IACP,CACF;GACF,EACD;GACE,MAAM;GACN,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;IAAQ,CAAC;GAC1C,CACF,EACD,EAAE,OAAO,KAAK,OAAO,CACtB,EAEqB,QAAQ,QAC3B,KAAK,SAAU,UAAU,OAAO,KAAK,OAAO,GAAI,CAChD,KAAK,GAAG,CACR,MAAM;AAET,SAAO,KAAK,WAAW,QAAQ,YAAY,gBAAgB,KAAK;;CAGlE,AAAQ,iBACN,QACA,YACA,gBACsB;EAItB,MAAM,OAAO,GAHI,OAAO,eACpB,MAAM,OAAO,aAAa,KAC1B,YACqB;;kCAEK,OAAO,QAAQ,KAAK,KAAK,oBACrD,eACD,CAAC;;EAEJ,WAAW,OAAO;;EAElB,KAAK,gBAAgB,WAAW,CAAC;EACjC,KAAK,QAAQ;;;AAIX,SAAO,KAAK,WAAW,QAAQ,YAAY,gBAAgB,KAAK;;CAGlE,AAAQ,WACN,QACA,YACA,gBACA,MACsB;AACtB,SAAO;GACL,UAAU,OAAO;GACjB,SAAS,OAAO,QAAQ,WAAW,MAAM,GACrC,OAAO,UACP,OAAO,OAAO;GAClB;GACA,YAAY,KAAK,IAAI,WAAW,YAAY,eAAe,WAAW;GACtE,oBACE,WAAW,QAAQ,MAAM,WAAW,OAAO,SAAS,WAAW,IAC/D,QAAQ,eAAe,mBAAmB;GAC5C,WAAW,WAAW;GACvB;;CAGH,AAAQ,oBAAoB,gBAAsC;AAChE,UAAQ,eAAe,UAAvB;GACE,KAAK,UACH,QAAO;GACT,KAAK,YACH,QAAO;GACT,KAAK,UACH,QAAO;GACT,KAAK,UACH,QAAO;GACT,KAAK,aACH,QAAO;GACT,QACE,QAAO;;;CAIb,AAAQ,gBAAgB,YAA+B;AACrD,MAAI,CAAC,WAAW,UAAU,OAAQ,QAAO;AAMzC,SAAO,gBALO,WAAW,UAAU,KAAK,UAAU,UAAU;AAG1D,UAAO,KAFO,SAAS,SAAS,UAAU,QAAQ,MACrC,SAAS,MAAM,KAAK,SAAS,IAAI,KAAK;IAEnD,CAC2B,KAAK,KAAK"}

package/dist/bot/feedback-loop.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"feedback-loop.js","names":[],"sources":["../../src/bot/feedback-loop.ts"],"sourcesContent":["import type { ResolutionResultPayload } from '../types';\n\nexport interface FeedbackMetrics {\n  totalTickets: number;\n  autoResolved: number;\n  escalated: number;\n  avgConfidence: number;\n  avgResponseTimeMs: number;\n}\n\nexport class SupportFeedbackLoop {\n  private readonly history: ResolutionResultPayload[] = [];\n  private readonly responseTimes = new Map<string, number>();\n\n  recordResolution(payload: ResolutionResultPayload, responseTimeMs?: number) {\n    this.history.push(payload);\n    if (responseTimeMs != null) {\n      this.responseTimes.set(payload.ticket.id, responseTimeMs);\n    }\n  }\n\n  metrics(): FeedbackMetrics {\n    const total = this.history.length;\n    const autoResolved = this.history.filter(\n      (entry) =>\n        !entry.resolution.actions.some((action) => action.type === 'escalate')\n    ).length;\n    const escalated = total - autoResolved;\n    const avgConfidence =\n      total === 0\n        ? 0\n        : this.history.reduce(\n            (sum, entry) => sum + entry.resolution.confidence,\n            0\n          ) / total;\n    const avgResponseTimeMs =\n      this.responseTimes.size === 0\n        ? 0\n        : [...this.responseTimes.values()].reduce((a, b) => a + b, 0) /\n          this.responseTimes.size;\n\n    return {\n      totalTickets: total,\n      autoResolved,\n      escalated,\n      avgConfidence: Number(avgConfidence.toFixed(2)),\n      avgResponseTimeMs: Math.round(avgResponseTimeMs),\n    };\n  }\n\n  feedbackSummary(limit = 5): string {\n    const recent = this.history.slice(-limit);\n    if (!recent.length) return 'No feedback recorded yet.';\n    return recent\n      .map((entry) => {\n        const status = entry.resolution.actions.some(\n          (action) => action.type === 'escalate'\n        )\n          ? 'Escalated'\n          : 'Auto-resolved';\n        return `${entry.ticket.subject} – ${status} (confidence: ${entry.resolution.confidence})`;\n      })\n      .join('\\n');\n  }\n}\n"],"mappings":";AAUA,IAAa,sBAAb,MAAiC;CAC/B,AAAiB,UAAqC,EAAE;CACxD,AAAiB,gCAAgB,IAAI,KAAqB;CAE1D,iBAAiB,SAAkC,gBAAyB;AAC1E,OAAK,QAAQ,KAAK,QAAQ;AAC1B,MAAI,kBAAkB,KACpB,MAAK,cAAc,IAAI,QAAQ,OAAO,IAAI,eAAe;;CAI7D,UAA2B;EACzB,MAAM,QAAQ,KAAK,QAAQ;EAC3B,MAAM,eAAe,KAAK,QAAQ,QAC/B,UACC,CAAC,MAAM,WAAW,QAAQ,MAAM,WAAW,OAAO,SAAS,WAAW,CACzE,CAAC;EACF,MAAM,YAAY,QAAQ;EAC1B,MAAM,gBACJ,UAAU,IACN,IACA,KAAK,QAAQ,QACV,KAAK,UAAU,MAAM,MAAM,WAAW,YACvC,EACD,GAAG;EACV,MAAM,oBACJ,KAAK,cAAc,SAAS,IACxB,IACA,CAAC,GAAG,KAAK,cAAc,QAAQ,CAAC,CAAC,QAAQ,GAAG,MAAM,IAAI,GAAG,EAAE,GAC3D,KAAK,cAAc;AAEzB,SAAO;GACL,cAAc;GACd;GACA;GACA,eAAe,OAAO,cAAc,QAAQ,EAAE,CAAC;GAC/C,mBAAmB,KAAK,MAAM,kBAAkB;GACjD;;CAGH,gBAAgB,QAAQ,GAAW;EACjC,MAAM,SAAS,KAAK,QAAQ,MAAM,CAAC,MAAM;AACzC,MAAI,CAAC,OAAO,OAAQ,QAAO;AAC3B,SAAO,OACJ,KAAK,UAAU;GACd,MAAM,SAAS,MAAM,WAAW,QAAQ,MACrC,WAAW,OAAO,SAAS,WAC7B,GACG,cACA;AACJ,UAAO,GAAG,MAAM,OAAO,QAAQ,KAAK,OAAO,gBAAgB,MAAM,WAAW,WAAW;IACvF,CACD,KAAK,KAAK"}

package/dist/bot/tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.js","names":[],"sources":["../../src/bot/tools.ts"],"sourcesContent":["import type { TicketResolver } from '../rag/ticket-resolver';\nimport type { TicketClassifier } from '../tickets/classifier';\nimport type { AutoResponder } from './auto-responder';\nimport type {\n  SupportAction,\n  SupportCitation,\n  SupportResolution,\n  SupportTicket,\n  TicketCategory,\n  TicketClassification,\n  TicketPriority,\n  TicketSentiment,\n} from '../types';\nimport type { Tool } from '@ai-sdk/provider-utils';\nimport * as z from 'zod';\n\nconst ticketSchema = z.object({\n  id: z.string(),\n  subject: z.string(),\n  body: z.string(),\n  channel: z.enum(['email', 'chat', 'phone', 'portal']),\n  customerName: z.string().optional(),\n  customerEmail: z.string().optional(),\n  metadata: z.object().optional(),\n}) satisfies z.ZodType<SupportTicket>;\nconst supportCitationSchema = z.object({\n  label: z.string(),\n  url: z.string().optional(),\n  snippet: z.string().optional(),\n  score: z.number().optional(),\n}) satisfies z.ZodType<SupportCitation>;\nconst supportActionSchema = z.object({\n  type: z.enum(['respond', 'escalate', 'refund', 'manual']),\n  label: z.string(),\n  payload: z.record(z.string(), z.string()),\n}) satisfies z.ZodType<SupportAction>;\nconst supportResolutionSchema = z.object({\n  ticketId: z.string(),\n  answer: z.string(),\n  confidence: z.number(),\n  citations: supportCitationSchema.array(),\n  actions: supportActionSchema.array(),\n  escalationReason: z.string().optional(),\n  knowledgeUpdates: z.array(z.string()).optional(),\n}) satisfies z.ZodType<SupportResolution>;\nconst ticketClassificationSchema = z.object({\n  ticketId: z.string(),\n  category: z.enum([\n    'billing',\n    'technical',\n    'product',\n    'account',\n    'compliance',\n    'other',\n  ]) satisfies z.ZodType<TicketCategory>,\n  priority: z.enum([\n    'urgent',\n    'high',\n    'medium',\n    'low',\n  ]) satisfies z.ZodType<TicketPriority>,\n  sentiment: z.enum([\n    'positive',\n    'neutral',\n    'negative',\n    'frustrated',\n  ]) satisfies z.ZodType<TicketSentiment>,\n  intents: z.array(z.string()),\n  tags: z.array(z.string()),\n  confidence: z.number(),\n  escalationRequired: z.boolean().optional(),\n}) satisfies z.ZodType<TicketClassification>;\n\nfunction ensureTicket(input: unknown): SupportTicket {\n  if (!input || typeof input !== 'object' || !('ticket' in input)) {\n    throw new Error('Input must include ticket');\n  }\n  const ticket = (input as { ticket: SupportTicket }).ticket;\n  if (!ticket?.id) throw new Error('Ticket is missing id');\n  return ticket;\n}\n\nfunction extractResolution(input: unknown): SupportResolution | undefined {\n  if (!input || typeof input !== 'object' || !('resolution' in input))\n    return undefined;\n  return (input as { resolution?: SupportResolution }).resolution;\n}\n\nfunction extractClassification(\n  input: unknown\n): TicketClassification | undefined {\n  if (!input || typeof input !== 'object' || !('classification' in input))\n    return undefined;\n  return (input as { classification?: TicketClassification }).classification;\n}\n\nexport interface SupportToolsetOptions {\n  resolver: TicketResolver;\n  classifier: TicketClassifier;\n  responder: AutoResponder;\n}\n\nexport function createSupportTools(options: SupportToolsetOptions): Tool[] {\n  const classifyTool: Tool = {\n    title: 'support_classify_ticket',\n    description: 'Classify a ticket for priority, sentiment, and category',\n    inputSchema: z.object({ ticket: ticketSchema }),\n    execute: async (input: unknown) => {\n      const ticket = ensureTicket(input);\n      const classification = await options.classifier.classify(ticket);\n      return {\n        content: JSON.stringify(classification),\n        metadata: { ticketId: ticket.id },\n      };\n    },\n  };\n\n  const resolveTool: Tool = {\n    title: 'support_resolve_ticket',\n    description: 'Generate a knowledge-grounded resolution for a ticket',\n    inputSchema: z.object({ ticket: ticketSchema }),\n    execute: async (input: unknown) => {\n      const ticket = ensureTicket(input);\n      const resolution = await options.resolver.resolve(ticket);\n      return {\n        content: JSON.stringify(resolution),\n        metadata: { ticketId: ticket.id },\n      };\n    },\n  };\n\n  const responderTool: Tool = {\n    title: 'support_draft_response',\n    description:\n      'Draft a user-facing reply based on resolution + classification',\n    inputSchema: z.object({\n      ticket: ticketSchema,\n      resolution: supportResolutionSchema,\n      classification: ticketClassificationSchema,\n    }),\n    execute: async (input: unknown) => {\n      const ticket = ensureTicket(input);\n      const resolution = extractResolution(input);\n      const classification = extractClassification(input);\n      if (!resolution || !classification) {\n        throw new Error('resolution and classification are required');\n      }\n      const draft = await options.responder.draft(\n        ticket,\n        resolution,\n        classification\n      );\n      return {\n        content: JSON.stringify(draft),\n        metadata: { ticketId: ticket.id },\n      };\n    },\n  };\n\n  return [classifyTool, resolveTool, responderTool];\n}\n"],"mappings":";;;AAgBA,MAAM,eAAe,EAAE,OAAO;CAC5B,IAAI,EAAE,QAAQ;CACd,SAAS,EAAE,QAAQ;CACnB,MAAM,EAAE,QAAQ;CAChB,SAAS,EAAE,KAAK;EAAC;EAAS;EAAQ;EAAS;EAAS,CAAC;CACrD,cAAc,EAAE,QAAQ,CAAC,UAAU;CACnC,eAAe,EAAE,QAAQ,CAAC,UAAU;CACpC,UAAU,EAAE,QAAQ,CAAC,UAAU;CAChC,CAAC;AACF,MAAM,wBAAwB,EAAE,OAAO;CACrC,OAAO,EAAE,QAAQ;CACjB,KAAK,EAAE,QAAQ,CAAC,UAAU;CAC1B,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC9B,OAAO,EAAE,QAAQ,CAAC,UAAU;CAC7B,CAAC;AACF,MAAM,sBAAsB,EAAE,OAAO;CACnC,MAAM,EAAE,KAAK;EAAC;EAAW;EAAY;EAAU;EAAS,CAAC;CACzD,OAAO,EAAE,QAAQ;CACjB,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC;CAC1C,CAAC;AACF,MAAM,0BAA0B,EAAE,OAAO;CACvC,UAAU,EAAE,QAAQ;CACpB,QAAQ,EAAE,QAAQ;CAClB,YAAY,EAAE,QAAQ;CACtB,WAAW,sBAAsB,OAAO;CACxC,SAAS,oBAAoB,OAAO;CACpC,kBAAkB,EAAE,QAAQ,CAAC,UAAU;CACvC,kBAAkB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACjD,CAAC;AACF,MAAM,6BAA6B,EAAE,OAAO;CAC1C,UAAU,EAAE,QAAQ;CACpB,UAAU,EAAE,KAAK;EACf;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;CACF,UAAU,EAAE,KAAK;EACf;EACA;EACA;EACA;EACD,CAAC;CACF,WAAW,EAAE,KAAK;EAChB;EACA;EACA;EACA;EACD,CAAC;CACF,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC;CAC5B,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;CACzB,YAAY,EAAE,QAAQ;CACtB,oBAAoB,EAAE,SAAS,CAAC,UAAU;CAC3C,CAAC;AAEF,SAAS,aAAa,OAA+B;AACnD,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,EAAE,YAAY,OACvD,OAAM,IAAI,MAAM,4BAA4B;CAE9C,MAAM,SAAU,MAAoC;AACpD,KAAI,CAAC,QAAQ,GAAI,OAAM,IAAI,MAAM,uBAAuB;AACxD,QAAO;;AAGT,SAAS,kBAAkB,OAA+C;AACxE,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,EAAE,gBAAgB,OAC3D,QAAO;AACT,QAAQ,MAA6C;;AAGvD,SAAS,sBACP,OACkC;AAClC,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,EAAE,oBAAoB,OAC/D,QAAO;AACT,QAAQ,MAAoD;;AAS9D,SAAgB,mBAAmB,SAAwC;AAyDzE,QAAO;EAxDoB;GACzB,OAAO;GACP,aAAa;GACb,aAAa,EAAE,OAAO,EAAE,QAAQ,cAAc,CAAC;GAC/C,SAAS,OAAO,UAAmB;IACjC,MAAM,SAAS,aAAa,MAAM;IAClC,MAAM,iBAAiB,MAAM,QAAQ,WAAW,SAAS,OAAO;AAChE,WAAO;KACL,SAAS,KAAK,UAAU,eAAe;KACvC,UAAU,EAAE,UAAU,OAAO,IAAI;KAClC;;GAEJ;EAEyB;GACxB,OAAO;GACP,aAAa;GACb,aAAa,EAAE,OAAO,EAAE,QAAQ,cAAc,CAAC;GAC/C,SAAS,OAAO,UAAmB;IACjC,MAAM,SAAS,aAAa,MAAM;IAClC,MAAM,aAAa,MAAM,QAAQ,SAAS,QAAQ,OAAO;AACzD,WAAO;KACL,SAAS,KAAK,UAAU,WAAW;KACnC,UAAU,EAAE,UAAU,OAAO,IAAI;KAClC;;GAEJ;EAE2B;GAC1B,OAAO;GACP,aACE;GACF,aAAa,EAAE,OAAO;IACpB,QAAQ;IACR,YAAY;IACZ,gBAAgB;IACjB,CAAC;GACF,SAAS,OAAO,UAAmB;IACjC,MAAM,SAAS,aAAa,MAAM;IAClC,MAAM,aAAa,kBAAkB,MAAM;IAC3C,MAAM,iBAAiB,sBAAsB,MAAM;AACnD,QAAI,CAAC,cAAc,CAAC,eAClB,OAAM,IAAI,MAAM,6CAA6C;IAE/D,MAAM,QAAQ,MAAM,QAAQ,UAAU,MACpC,QACA,YACA,eACD;AACD,WAAO;KACL,SAAS,KAAK,UAAU,MAAM;KAC9B,UAAU,EAAE,UAAU,OAAO,IAAI;KAClC;;GAEJ;EAEgD"}

package/dist/rag/ticket-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ticket-resolver.js","names":[],"sources":["../../src/rag/ticket-resolver.ts"],"sourcesContent":["import type { KnowledgeAnswer } from '@contractspec/lib.knowledge/query/service';\nimport type { SupportResolution, SupportTicket } from '../types';\n\nexport interface KnowledgeRetriever {\n  query(question: string): Promise<KnowledgeAnswer>;\n}\n\nexport interface TicketResolverOptions {\n  knowledge: KnowledgeRetriever;\n  minConfidence?: number;\n  prependPrompt?: string;\n}\n\nexport class TicketResolver {\n  private readonly knowledge: KnowledgeRetriever;\n  private readonly minConfidence: number;\n  private readonly prependPrompt?: string;\n\n  constructor(options: TicketResolverOptions) {\n    this.knowledge = options.knowledge;\n    this.minConfidence = options.minConfidence ?? 0.65;\n    this.prependPrompt = options.prependPrompt;\n  }\n\n  async resolve(ticket: SupportTicket): Promise<SupportResolution> {\n    const question = this.buildQuestion(ticket);\n    const answer = await this.knowledge.query(question);\n    return this.toResolution(ticket, answer);\n  }\n\n  private buildQuestion(ticket: SupportTicket): string {\n    const header = [`Subject: ${ticket.subject}`, `Channel: ${ticket.channel}`];\n    if (ticket.customerName) header.push(`Customer: ${ticket.customerName}`);\n    const sections = [\n      this.prependPrompt,\n      header.join('\\n'),\n      '---',\n      ticket.body,\n    ].filter(Boolean);\n    return sections.join('\\n');\n  }\n\n  private toResolution(\n    ticket: SupportTicket,\n    answer: KnowledgeAnswer\n  ): SupportResolution {\n    const citations = answer.references.map((ref) => {\n      const label =\n        typeof ref.payload?.title === 'string'\n          ? ref.payload.title\n          : typeof ref.payload?.documentId === 'string'\n            ? ref.payload.documentId\n            : ref.id;\n      return {\n        label,\n        url: typeof ref.payload?.url === 'string' ? ref.payload.url : undefined,\n        snippet:\n          typeof ref.payload?.text === 'string'\n            ? ref.payload.text.slice(0, 280)\n            : undefined,\n        score: ref.score,\n      };\n    });\n\n    const confidence = this.deriveConfidence(answer);\n    const escalate = confidence < this.minConfidence || citations.length === 0;\n\n    return {\n      ticketId: ticket.id,\n      answer: answer.answer,\n      confidence,\n      citations,\n      actions: [\n        escalate\n          ? { type: 'escalate', label: 'Escalate for human review' }\n          : { type: 'respond', label: 'Send automated response' },\n      ],\n      escalationReason: escalate\n        ? 'Insufficient confidence or missing knowledge references'\n        : undefined,\n      knowledgeUpdates: escalate ? [ticket.body.slice(0, 200)] : undefined,\n    };\n  }\n\n  private deriveConfidence(answer: KnowledgeAnswer): number {\n    if (!answer.references.length) return 0.3;\n    const topScore = answer.references[0]?.score ?? 0.4;\n    const normalized = Math.min(1, Math.max(0, topScore));\n    const tokenPenalty = answer.usage?.completionTokens\n      ? Math.min(answer.usage.completionTokens / 1000, 0.2)\n      : 0;\n    return Number((normalized - tokenPenalty).toFixed(2));\n  }\n}\n"],"mappings":";AAaA,IAAa,iBAAb,MAA4B;CAC1B,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAgC;AAC1C,OAAK,YAAY,QAAQ;AACzB,OAAK,gBAAgB,QAAQ,iBAAiB;AAC9C,OAAK,gBAAgB,QAAQ;;CAG/B,MAAM,QAAQ,QAAmD;EAC/D,MAAM,WAAW,KAAK,cAAc,OAAO;EAC3C,MAAM,SAAS,MAAM,KAAK,UAAU,MAAM,SAAS;AACnD,SAAO,KAAK,aAAa,QAAQ,OAAO;;CAG1C,AAAQ,cAAc,QAA+B;EACnD,MAAM,SAAS,CAAC,YAAY,OAAO,WAAW,YAAY,OAAO,UAAU;AAC3E,MAAI,OAAO,aAAc,QAAO,KAAK,aAAa,OAAO,eAAe;AAOxE,SANiB;GACf,KAAK;GACL,OAAO,KAAK,KAAK;GACjB;GACA,OAAO;GACR,CAAC,OAAO,QAAQ,CACD,KAAK,KAAK;;CAG5B,AAAQ,aACN,QACA,QACmB;EACnB,MAAM,YAAY,OAAO,WAAW,KAAK,QAAQ;AAO/C,UAAO;IACL,OANA,OAAO,IAAI,SAAS,UAAU,WAC1B,IAAI,QAAQ,QACZ,OAAO,IAAI,SAAS,eAAe,WACjC,IAAI,QAAQ,aACZ,IAAI;IAGV,KAAK,OAAO,IAAI,SAAS,QAAQ,WAAW,IAAI,QAAQ,MAAM;IAC9D,SACE,OAAO,IAAI,SAAS,SAAS,WACzB,IAAI,QAAQ,KAAK,MAAM,GAAG,IAAI,GAC9B;IACN,OAAO,IAAI;IACZ;IACD;EAEF,MAAM,aAAa,KAAK,iBAAiB,OAAO;EAChD,MAAM,WAAW,aAAa,KAAK,iBAAiB,UAAU,WAAW;AAEzE,SAAO;GACL,UAAU,OAAO;GACjB,QAAQ,OAAO;GACf;GACA;GACA,SAAS,CACP,WACI;IAAE,MAAM;IAAY,OAAO;IAA6B,GACxD;IAAE,MAAM;IAAW,OAAO;IAA2B,CAC1D;GACD,kBAAkB,WACd,4DACA;GACJ,kBAAkB,WAAW,CAAC,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG;GAC5D;;CAGH,AAAQ,iBAAiB,QAAiC;AACxD,MAAI,CAAC,OAAO,WAAW,OAAQ,QAAO;EACtC,MAAM,WAAW,OAAO,WAAW,IAAI,SAAS;EAChD,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,SAAS,CAAC;EACrD,MAAM,eAAe,OAAO,OAAO,mBAC/B,KAAK,IAAI,OAAO,MAAM,mBAAmB,KAAM,GAAI,GACnD;AACJ,SAAO,QAAQ,aAAa,cAAc,QAAQ,EAAE,CAAC"}

package/dist/spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec.js","names":[],"sources":["../src/spec.ts"],"sourcesContent":["import type { AgentSpec, AgentToolConfig } from '@contractspec/lib.ai-agent';\nimport { defineAgent } from '@contractspec/lib.ai-agent';\nimport type { SupportBotSpec } from './types';\n\nexport interface SupportBotDefinition {\n  base: AgentSpec;\n  tools?: AgentToolConfig[];\n  autoEscalateThreshold?: number;\n}\n\nexport function defineSupportBot(\n  definition: SupportBotDefinition\n): SupportBotSpec {\n  const base = defineAgent({\n    ...definition.base,\n    policy: {\n      ...definition.base.policy,\n      confidence: {\n        min: definition.base.policy?.confidence?.min ?? 0.7,\n        default: definition.base.policy?.confidence?.default ?? 0.6,\n      },\n      escalation: {\n        confidenceThreshold:\n          definition.autoEscalateThreshold ??\n          definition.base.policy?.escalation?.confidenceThreshold ??\n          definition.base.policy?.confidence?.min ??\n          0.7,\n        ...definition.base.policy?.escalation,\n      },\n    },\n    memory: definition.base.memory ?? { maxEntries: 120, ttlMinutes: 120 },\n    tools: definition.tools ?? definition.base.tools,\n    instructions: `${definition.base.instructions}\\n\\nAlways cite support knowledge sources and flag compliance/billing issues for human review when unsure.`,\n  });\n\n  return {\n    ...base,\n    thresholds: {\n      autoResolveMinConfidence: definition.autoEscalateThreshold ?? 0.75,\n      maxIterations: 6,\n    },\n  };\n}\n"],"mappings":";;;AAUA,SAAgB,iBACd,YACgB;AAuBhB,QAAO;EACL,GAvBW,YAAY;GACvB,GAAG,WAAW;GACd,QAAQ;IACN,GAAG,WAAW,KAAK;IACnB,YAAY;KACV,KAAK,WAAW,KAAK,QAAQ,YAAY,OAAO;KAChD,SAAS,WAAW,KAAK,QAAQ,YAAY,WAAW;KACzD;IACD,YAAY;KACV,qBACE,WAAW,yBACX,WAAW,KAAK,QAAQ,YAAY,uBACpC,WAAW,KAAK,QAAQ,YAAY,OACpC;KACF,GAAG,WAAW,KAAK,QAAQ;KAC5B;IACF;GACD,QAAQ,WAAW,KAAK,UAAU;IAAE,YAAY;IAAK,YAAY;IAAK;GACtE,OAAO,WAAW,SAAS,WAAW,KAAK;GAC3C,cAAc,GAAG,WAAW,KAAK,aAAa;GAC/C,CAAC;EAIA,YAAY;GACV,0BAA0B,WAAW,yBAAyB;GAC9D,eAAe;GAChB;EACF"}

package/dist/tickets/classifier.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"classifier.js","names":[],"sources":["../../src/tickets/classifier.ts"],"sourcesContent":["import type { LLMProvider } from '@contractspec/lib.contracts/integrations/providers/llm';\nimport type {\n  SupportTicket,\n  TicketCategory,\n  TicketPriority,\n  TicketSentiment,\n  TicketClassification,\n} from '../types';\n\nconst CATEGORY_KEYWORDS: Record<TicketCategory, string[]> = {\n  billing: ['invoice', 'payout', 'refund', 'charge', 'billing', 'payment'],\n  technical: ['bug', 'error', 'crash', 'issue', 'failed', 'timeout'],\n  product: ['feature', 'roadmap', 'idea', 'request', 'feedback'],\n  account: ['login', 'password', '2fa', 'account', 'profile', 'email change'],\n  compliance: ['kyc', 'aml', 'compliance', 'regulation', 'gdpr'],\n  other: [],\n};\n\nconst PRIORITY_HINTS: Record<TicketPriority, string[]> = {\n  urgent: ['urgent', 'asap', 'immediately', 'today', 'right away'],\n  high: ['high priority', 'blocking', 'major', 'critical'],\n  medium: ['soon', 'next few days'],\n  low: ['nice to have', 'when possible', 'later'],\n};\n\nconst SENTIMENT_HINTS: Record<TicketSentiment, string[]> = {\n  positive: ['love', 'great', 'awesome', 'thank you'],\n  neutral: ['question', 'wonder', 'curious'],\n  negative: ['unhappy', 'bad', 'terrible', 'awful', 'angry'],\n  frustrated: ['furious', 'frustrated', 'fed up', 'ridiculous'],\n};\n\nexport interface TicketClassifierOptions {\n  keywords?: Partial<Record<TicketCategory, string[]>>;\n  llm?: LLMProvider;\n  llmModel?: string;\n}\n\nexport class TicketClassifier {\n  private readonly keywords: Record<TicketCategory, string[]>;\n  private readonly llm?: LLMProvider;\n  private readonly llmModel?: string;\n\n  constructor(options?: TicketClassifierOptions) {\n    this.keywords = {\n      ...CATEGORY_KEYWORDS,\n      ...(options?.keywords ?? {}),\n    } as Record<TicketCategory, string[]>;\n    this.llm = options?.llm;\n    this.llmModel = options?.llmModel;\n  }\n\n  async classify(ticket: SupportTicket): Promise<TicketClassification> {\n    const heuristics = this.heuristicClassification(ticket);\n    if (!this.llm) return heuristics;\n\n    try {\n      const llmResult = await this.llm.chat(\n        [\n          {\n            role: 'system',\n            content: [{ type: 'text', text: 'Classify the support ticket.' }],\n          },\n          {\n            role: 'user',\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify({\n                  subject: ticket.subject,\n                  body: ticket.body,\n                  channel: ticket.channel,\n                }),\n              },\n            ],\n          },\n        ],\n        {\n          responseFormat: 'json',\n          model: this.llmModel,\n        }\n      );\n      const content = llmResult.message.content.find((part) => 'text' in part);\n      if (content && 'text' in content) {\n        const parsed = JSON.parse(\n          content.text\n        ) as Partial<TicketClassification>;\n        return {\n          ...heuristics,\n          ...parsed,\n          intents: parsed.intents ?? heuristics.intents,\n          tags: parsed.tags ?? heuristics.tags,\n        };\n      }\n    } catch {\n      // fallback to heuristics\n    }\n\n    return heuristics;\n  }\n\n  private heuristicClassification(ticket: SupportTicket): TicketClassification {\n    const text = `${ticket.subject}\\n${ticket.body}`.toLowerCase();\n    const category = this.detectCategory(text);\n    const priority = this.detectPriority(text);\n    const sentiment = this.detectSentiment(text);\n    const intents = this.extractIntents(text);\n    const tags = intents.slice(0, 3);\n    const confidence = this.estimateConfidence(category, priority, sentiment);\n\n    return {\n      ticketId: ticket.id,\n      category,\n      priority,\n      sentiment,\n      intents,\n      tags,\n      confidence,\n      escalationRequired: priority === 'urgent' || category === 'compliance',\n    };\n  }\n\n  private detectCategory(text: string): TicketCategory {\n    for (const [category, keywords] of Object.entries(this.keywords) as [\n      TicketCategory,\n      string[],\n    ][]) {\n      if (keywords.some((keyword) => text.includes(keyword))) {\n        return category;\n      }\n    }\n    return 'other';\n  }\n\n  private detectPriority(text: string): TicketPriority {\n    for (const priority of [\n      'urgent',\n      'high',\n      'medium',\n      'low',\n    ] as TicketPriority[]) {\n      if (PRIORITY_HINTS[priority].some((word) => text.includes(word))) {\n        return priority;\n      }\n    }\n    return 'medium';\n  }\n\n  private detectSentiment(text: string): TicketSentiment {\n    for (const sentiment of [\n      'frustrated',\n      'negative',\n      'neutral',\n      'positive',\n    ] as TicketSentiment[]) {\n      if (SENTIMENT_HINTS[sentiment].some((word) => text.includes(word))) {\n        return sentiment;\n      }\n    }\n    return 'neutral';\n  }\n\n  private extractIntents(text: string): string[] {\n    const intents: string[] = [];\n    if (text.includes('refund') || text.includes('chargeback'))\n      intents.push('refund');\n    if (text.includes('payout')) intents.push('payout');\n    if (text.includes('login')) intents.push('login-help');\n    if (text.includes('feature')) intents.push('feature-request');\n    if (text.includes('bug') || text.includes('error'))\n      intents.push('bug-report');\n    return intents.length ? intents : ['general'];\n  }\n\n  private estimateConfidence(\n    category: TicketCategory,\n    priority: TicketPriority,\n    sentiment: TicketSentiment\n  ): number {\n    let base = 0.6;\n    if (category !== 'other') base += 0.1;\n    if (priority === 'urgent' || priority === 'low') base += 0.05;\n    if (sentiment === 'frustrated') base -= 0.05;\n    return Math.min(0.95, Math.max(0.4, Number(base.toFixed(2))));\n  }\n}\n"],"mappings":"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"}