@contractspec/lib.support-bot 0.0.0-canary-20260113170453

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# @contractspec/lib.support-bot
+
+Website: https://contractspec.io/
+
+
+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 `@contractspec/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 '@contractspec/lib.support-bot';
+import { AgentRegistry, AgentRunner, ToolExecutor } from '@contractspec/lib.ai-agent';
+
+const SupportBot = defineSupportBot({
+  base: {
+    meta: { name: 'support.bot', version: '1.0.0', 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/examples/ai-support-bot` for an end-to-end integration with ticket ingestion, review queues, and analytics.

package/dist/ai-agent/src/agent/contract-spec-agent.d.ts

@@ -0,0 +1,5 @@
+import "../spec/spec.js";
+import "../types.js";
+import "../session/store.js";
+import "../telemetry/adapter.js";
+import "ai";

package/dist/ai-agent/src/agent/index.d.ts

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

package/dist/ai-agent/src/agent/unified-agent.d.ts

@@ -0,0 +1,3 @@
+import "../spec/spec.js";
+import "../types.js";
+import "../providers/types.js";

package/dist/ai-agent/src/approval/index.d.ts

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

package/dist/ai-agent/src/approval/workflow.d.ts

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

package/dist/ai-agent/src/exporters/claude-agent-exporter.d.ts

@@ -0,0 +1,2 @@
+import "../spec/spec.js";
+import "./types.js";

package/dist/ai-agent/src/exporters/index.d.ts

@@ -0,0 +1,3 @@
+import "./types.js";
+import "./claude-agent-exporter.js";
+import "./opencode-exporter.js";

package/dist/ai-agent/src/exporters/opencode-exporter.d.ts

@@ -0,0 +1,2 @@
+import "../spec/spec.js";
+import "./types.js";

package/dist/ai-agent/src/exporters/types.d.ts

@@ -0,0 +1,2 @@
+import "../spec/spec.js";
+import "../providers/types.js";

package/dist/ai-agent/src/index.d.ts

@@ -0,0 +1,14 @@
+import { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig } from "./spec/spec.js";
+import "./types.js";
+import "./agent/index.js";
+import "./spec/index.js";
+import "./tools/index.js";
+import "./schema/index.js";
+import "./knowledge/index.js";
+import "./session/index.js";
+import "./telemetry/index.js";
+import "./approval/index.js";
+import "./providers/index.js";
+import "./exporters/index.js";
+import "./interop/index.js";
+import "ai";

package/dist/ai-agent/src/interop/index.d.ts

@@ -0,0 +1,3 @@
+import "./types.js";
+import "./spec-consumer.js";
+import "./tool-consumer.js";

package/dist/ai-agent/src/interop/spec-consumer.d.ts

@@ -0,0 +1,2 @@
+import "../spec/spec.js";
+import "./types.js";

package/dist/ai-agent/src/interop/tool-consumer.d.ts

@@ -0,0 +1,3 @@
+import "../spec/spec.js";
+import "../types.js";
+import "./types.js";

package/dist/ai-agent/src/interop/types.d.ts

@@ -0,0 +1,2 @@
+import "../spec/spec.js";
+import "../types.js";

package/dist/ai-agent/src/knowledge/index.d.ts

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

package/dist/ai-agent/src/knowledge/injector.d.ts

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

package/dist/ai-agent/src/providers/claude-agent-sdk/adapter.d.ts

@@ -0,0 +1,2 @@
+import "../../spec/spec.js";
+import "../types.js";

package/dist/ai-agent/src/providers/claude-agent-sdk/index.d.ts

@@ -0,0 +1,3 @@
+import "./adapter.js";
+import "./tool-bridge.js";
+import "./session-bridge.js";

package/dist/ai-agent/src/providers/claude-agent-sdk/session-bridge.d.ts

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

package/dist/ai-agent/src/providers/claude-agent-sdk/tool-bridge.d.ts

@@ -0,0 +1,3 @@
+import "../../spec/spec.js";
+import "../../types.js";
+import "../types.js";

package/dist/ai-agent/src/providers/index.d.ts

@@ -0,0 +1,4 @@
+import "./types.js";
+import "./claude-agent-sdk/index.js";
+import "./opencode-sdk/index.js";
+import "./registry.js";

package/dist/ai-agent/src/providers/opencode-sdk/adapter.d.ts

@@ -0,0 +1,2 @@
+import "../../spec/spec.js";
+import "../types.js";

package/dist/ai-agent/src/providers/opencode-sdk/agent-bridge.d.ts

@@ -0,0 +1,3 @@
+import "../../spec/spec.js";
+import "../types.js";
+import "./tool-bridge.js";

package/dist/ai-agent/src/providers/opencode-sdk/index.d.ts

@@ -0,0 +1,3 @@
+import "./adapter.js";
+import "./tool-bridge.js";
+import "./agent-bridge.js";

package/dist/ai-agent/src/providers/opencode-sdk/tool-bridge.d.ts

@@ -0,0 +1,3 @@
+import "../../spec/spec.js";
+import "../../types.js";
+import "../types.js";

package/dist/ai-agent/src/providers/registry.d.ts

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

package/dist/ai-agent/src/providers/types.d.ts

@@ -0,0 +1,3 @@
+import "../spec/spec.js";
+import "../types.js";
+import "../tools/mcp-client.js";

package/dist/ai-agent/src/schema/index.d.ts

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

package/dist/ai-agent/src/schema/json-schema-to-zod.d.ts

@@ -0,0 +1 @@
+import "zod";

package/dist/ai-agent/src/schema/schema-output.d.ts

@@ -0,0 +1,2 @@
+import "zod";
+import "ai";

package/dist/ai-agent/src/session/index.d.ts

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

package/dist/ai-agent/src/session/store.d.ts

@@ -0,0 +1,2 @@
+import "../types.js";
+import "ai";

package/dist/ai-agent/src/spec/index.d.ts

@@ -0,0 +1,2 @@
+import { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig } from "./spec.js";
+import "./registry.js";

package/dist/ai-agent/src/spec/registry.d.ts

@@ -0,0 +1,2 @@
+import "../../../contracts/src/registry.js";
+import "./spec.js";

package/dist/ai-agent/src/spec/spec.d.ts

@@ -0,0 +1,115 @@
+import { OwnerShipMeta } from "../../../contracts/src/ownership.js";
+import { PolicyRef } from "../../../contracts/src/policy/spec.js";
+import { KnowledgeCategory } from "../../../contracts/src/knowledge/spec.js";
+
+//#region ../ai-agent/src/spec/spec.d.ts
+
+/**
+ * Metadata for an agent specification.
+ */
+type AgentMeta = OwnerShipMeta;
+/**
+ * Configuration for a tool that an agent can use.
+ */
+interface AgentToolConfig {
+  /** Tool name (unique within the agent) */
+  name: string;
+  /** Human-readable description for the LLM */
+  description?: string;
+  /** JSON Schema fragment for tool parameters */
+  schema?: Record<string, unknown>;
+  /** Optional cooldown in milliseconds between invocations */
+  cooldownMs?: number;
+  /** Maximum execution time before timeout */
+  timeoutMs?: number;
+  /** Whether the tool can be executed without human approval (AI SDK needsApproval = !automationSafe) */
+  automationSafe?: boolean;
+  /** Explicit approval requirement (overrides automationSafe) */
+  requiresApproval?: boolean;
+  /** Optional policy guard that must evaluate to allow the tool call */
+  policy?: PolicyRef;
+}
+/**
+ * Reference to a knowledge space that the agent can access.
+ */
+interface AgentKnowledgeRef {
+  /** Knowledge space key */
+  key: string;
+  /** Optional specific version */
+  version?: number;
+  /** Filter by knowledge category */
+  category?: KnowledgeCategory;
+  /** Whether the knowledge is required (static injection) or optional (dynamic RAG) */
+  required?: boolean;
+  /** Additional instructions appended when the space is available */
+  instructions?: string;
+}
+/**
+ * Memory configuration for agent session persistence.
+ */
+interface AgentMemoryConfig {
+  /** Maximum entries to keep in memory */
+  maxEntries?: number;
+  /** Time-to-live in minutes */
+  ttlMinutes?: number;
+  /** Number of messages before triggering summarization */
+  summaryTrigger?: number;
+  /** Whether to persist to long-term storage */
+  persistLongTerm?: boolean;
+}
+/**
+ * Confidence policy for agent responses.
+ */
+interface AgentConfidencePolicy {
+  /** Minimum acceptable confidence before escalation. Defaults to 0.7 */
+  min?: number;
+  /** Default value used when provider does not report confidence */
+  default?: number;
+}
+/**
+ * Escalation policy for handling uncertain or failed agent responses.
+ */
+interface AgentEscalationPolicy {
+  /** Auto escalate when confidence < threshold */
+  confidenceThreshold?: number;
+  /** Escalate when a tool throws irrecoverable errors */
+  onToolFailure?: boolean;
+  /** Escalate when iteration budget exceeded */
+  onTimeout?: boolean;
+  /** Optional human approval workflow ID */
+  approvalWorkflow?: string;
+}
+/**
+ * Combined policy configuration for an agent.
+ */
+interface AgentPolicy {
+  confidence?: AgentConfidencePolicy;
+  escalation?: AgentEscalationPolicy;
+  /** Feature flags to apply to this agent */
+  flags?: string[];
+}
+/**
+ * Complete specification for a ContractSpec agent.
+ */
+interface AgentSpec {
+  meta: AgentMeta;
+  /** System instructions for the agent */
+  instructions: string;
+  /** Human-readable description */
+  description?: string;
+  /** Tags for categorization */
+  tags?: string[];
+  /** Tools the agent can use */
+  tools: AgentToolConfig[];
+  /** Memory/session configuration */
+  memory?: AgentMemoryConfig;
+  /** Knowledge spaces the agent can access */
+  knowledge?: AgentKnowledgeRef[];
+  /** Policy configuration */
+  policy?: AgentPolicy;
+  /** Maximum steps per generation (defaults to 10) */
+  maxSteps?: number;
+}
+//#endregion
+export { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig };
+//# sourceMappingURL=spec.d.ts.map

package/dist/ai-agent/src/spec/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../ai-agent/src/spec/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAOA;AAKiB,KALL,SAAA,GAAY,aAWb;AAgBX;AAgBA;AAcA;AAUiB,UA9DA,eAAA,CA8DqB;EAcrB;EAUA,IAAA,EAAA,MAAS;EAClB;EAQC,WAAA,CAAA,EAAA,MAAA;EAEE;EAEG,MAAA,CAAA,EA7FH,MA6FG,CAAA,MAAA,EAAA,OAAA,CAAA;EAEH;EAAW,UAAA,CAAA,EAAA,MAAA;;;;;;;;WArFX;;;;;UAMM,iBAAA;;;;;;aAMJ;;;;;;;;;UAUI,iBAAA;;;;;;;;;;;;;UAcA,qBAAA;;;;;;;;;UAUA,qBAAA;;;;;;;;;;;;;UAcA,WAAA;eACF;eACA;;;;;;;UAQE,SAAA;QACT;;;;;;;;SAQC;;WAEE;;cAEG;;WAEH"}

package/dist/ai-agent/src/telemetry/adapter.d.ts

@@ -0,0 +1 @@
+import "ai";

package/dist/ai-agent/src/telemetry/index.d.ts

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

package/dist/ai-agent/src/tools/index.d.ts

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

package/dist/ai-agent/src/tools/knowledge-tool.d.ts

@@ -0,0 +1,2 @@
+import "../spec/spec.js";
+import "ai";

package/dist/ai-agent/src/tools/mcp-client.d.ts

@@ -0,0 +1 @@
+import "ai";

package/dist/ai-agent/src/tools/mcp-server.d.ts

@@ -0,0 +1,3 @@
+import "../spec/spec.js";
+import "../agent/contract-spec-agent.js";
+import "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/ai-agent/src/tools/tool-adapter.d.ts

@@ -0,0 +1,3 @@
+import "../spec/spec.js";
+import "../types.js";
+import "ai";

package/dist/ai-agent/src/types.d.ts

@@ -0,0 +1 @@
+import "ai";

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

@@ -0,0 +1,26 @@
+import { LLMProvider } from "../contracts/src/integrations/providers/llm.js";
+import { SupportResolution, SupportResponseDraft, SupportTicket, TicketClassification } from "../types.js";
+
+//#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 };
+//# sourceMappingURL=auto-responder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-responder.d.ts","names":[],"sources":["../../src/bot/auto-responder.ts"],"sourcesContent":[],"mappings":";;;;UAQiB,oBAAA;QACT;EADS,KAAA,CAAA,EAAA,MAAA;EAOJ,IAAA,CAAA,EAAA,UAAa,GAAA,QAAA;EAMF,OAAA,CAAA,EAAA,MAAA;;AAaR,cAnBH,aAAA,CAmBG;EACI,iBAAA,GAAA;EACP,iBAAA,KAAA;EAAR,iBAAA,IAAA;EAAO,iBAAA,OAAA;wBAfY;gBAYZ,2BACI,mCACI,uBACf,QAAQ"}

package/dist/bot/auto-responder.js

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

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,20 @@
+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 };
+//# sourceMappingURL=feedback-loop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-loop.d.ts","names":[],"sources":["../../src/bot/feedback-loop.ts"],"sourcesContent":[],"mappings":";;;UAEiB,eAAA;;EAAA,YAAA,EAAA,MAAe;EAQnB,SAAA,EAAA,MAAA;;;;cAAA,mBAAA;;;4BAIe;aAOf"}

package/dist/bot/feedback-loop.js

@@ -0,0 +1,35 @@
+//#region src/bot/feedback-loop.ts
+var SupportFeedbackLoop = class {
+	history = [];
+	responseTimes = /* @__PURE__ */ new Map();
+	recordResolution(payload, responseTimeMs) {
+		this.history.push(payload);
+		if (responseTimeMs != null) this.responseTimes.set(payload.ticket.id, responseTimeMs);
+	}
+	metrics() {
+		const total = this.history.length;
+		const autoResolved = this.history.filter((entry) => !entry.resolution.actions.some((action) => action.type === "escalate")).length;
+		const escalated = total - autoResolved;
+		const avgConfidence = total === 0 ? 0 : this.history.reduce((sum, entry) => sum + entry.resolution.confidence, 0) / total;
+		const avgResponseTimeMs = this.responseTimes.size === 0 ? 0 : [...this.responseTimes.values()].reduce((a, b) => a + b, 0) / this.responseTimes.size;
+		return {
+			totalTickets: total,
+			autoResolved,
+			escalated,
+			avgConfidence: Number(avgConfidence.toFixed(2)),
+			avgResponseTimeMs: Math.round(avgResponseTimeMs)
+		};
+	}
+	feedbackSummary(limit = 5) {
+		const recent = this.history.slice(-limit);
+		if (!recent.length) return "No feedback recorded yet.";
+		return recent.map((entry) => {
+			const status = entry.resolution.actions.some((action) => action.type === "escalate") ? "Escalated" : "Auto-resolved";
+			return `${entry.ticket.subject} – ${status} (confidence: ${entry.resolution.confidence})`;
+		}).join("\n");
+	}
+};
+
+//#endregion
+export { SupportFeedbackLoop };
+//# sourceMappingURL=feedback-loop.js.map

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

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

package/dist/bot/tools.d.ts

@@ -0,0 +1,15 @@
+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 };
+//# sourceMappingURL=tools.d.ts.map

package/dist/bot/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","names":[],"sources":["../../src/bot/tools.ts"],"sourcesContent":[],"mappings":";;;;;;UAgGiB,qBAAA;YACL;EADK,UAAA,EAEH,gBAFwB;EAC1B,SAAA,EAEC,aAFD;;AAEC,iBAGG,kBAAA,CAHH,OAAA,EAG+B,qBAH/B,CAAA,EAGuD,IAHvD,EAAA"}