@contractspec/lib.support-bot 2.4.0 → 2.5.0

package/dist/index.js

@@ -1,15 +1,667 @@
 // @bun
+// src/i18n/catalogs/en.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var enMessages = defineTranslation({
+  meta: {
+    key: "support-bot.messages",
+    version: "1.0.0",
+    domain: "support-bot",
+    description: "All user-facing, LLM-facing, and developer-facing strings for the support-bot package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "en",
+  fallback: "en",
+  messages: {
+    "prompt.classifier.system": {
+      value: "Classify the support ticket.",
+      description: "Classifier LLM system prompt"
+    },
+    "prompt.autoResponder.system": {
+      value: "Write empathetic, accurate support replies that cite sources when relevant.",
+      description: "Auto-responder LLM system prompt"
+    },
+    "prompt.autoResponder.user": {
+      value: `Ticket #{ticketId} ({category}, {priority}, {sentiment})
+Subject: {subject}
+
+{body}
+
+Knowledge:
+{knowledge}
+
+Respond to the customer.`,
+      description: "Auto-responder user prompt template",
+      placeholders: [
+        { name: "ticketId", type: "string" },
+        { name: "category", type: "string" },
+        { name: "priority", type: "string" },
+        { name: "sentiment", type: "string" },
+        { name: "subject", type: "string" },
+        { name: "body", type: "string" },
+        { name: "knowledge", type: "string" }
+      ]
+    },
+    "responder.closing.friendly": {
+      value: "We remain available if you need anything else.",
+      description: "Friendly closing line for support responses"
+    },
+    "responder.closing.formal": {
+      value: "Please let us know if you require additional assistance.",
+      description: "Formal closing line for support responses"
+    },
+    "responder.greeting.named": {
+      value: "Hi {name},",
+      description: "Greeting with customer name",
+      placeholders: [{ name: "name", type: "string" }]
+    },
+    "responder.greeting.anonymous": {
+      value: "Hi there,",
+      description: "Greeting without customer name"
+    },
+    "responder.intro.thanks": {
+      value: 'Thanks for contacting us about "{subject}".',
+      description: "Thank-you intro referencing the ticket subject",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "responder.signature": {
+      value: "\u2014 ContractSpec Support",
+      description: "Email / response signature"
+    },
+    "responder.references.header": {
+      value: "References:",
+      description: "Header for the references section"
+    },
+    "responder.references.sourceLabel": {
+      value: "Source {index}",
+      description: "Label for a numbered source reference",
+      placeholders: [{ name: "index", type: "number" }]
+    },
+    "responder.category.billing": {
+      value: "I understand billing issues can be stressful, so let me clarify the situation.",
+      description: "Category intro for billing tickets"
+    },
+    "responder.category.technical": {
+      value: "I see you encountered a technical issue. Here is what happened and how to fix it.",
+      description: "Category intro for technical tickets"
+    },
+    "responder.category.product": {
+      value: "Thanks for sharing feedback about the product. Here are the next steps.",
+      description: "Category intro for product tickets"
+    },
+    "responder.category.account": {
+      value: "Account access is critical, so let me walk you through the resolution.",
+      description: "Category intro for account tickets"
+    },
+    "responder.category.compliance": {
+      value: "Compliance questions require precision. See the policy-aligned answer below.",
+      description: "Category intro for compliance tickets"
+    },
+    "responder.category.other": {
+      value: "Here is what we found after reviewing your request.",
+      description: "Category intro for uncategorized tickets"
+    },
+    "responder.subject.replyPrefix": {
+      value: "Re: {subject}",
+      description: "Reply subject line prefix",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "resolver.question.subjectLabel": {
+      value: "Subject: {subject}",
+      description: "Subject label in resolver question context",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "resolver.question.channelLabel": {
+      value: "Channel: {channel}",
+      description: "Channel label in resolver question context",
+      placeholders: [{ name: "channel", type: "string" }]
+    },
+    "resolver.question.customerLabel": {
+      value: "Customer: {name}",
+      description: "Customer label in resolver question context",
+      placeholders: [{ name: "name", type: "string" }]
+    },
+    "resolver.action.escalate": {
+      value: "Escalate for human review",
+      description: "Action label for escalation"
+    },
+    "resolver.action.respond": {
+      value: "Send automated response",
+      description: "Action label for automated response"
+    },
+    "resolver.escalation.insufficientConfidence": {
+      value: "Insufficient confidence or missing knowledge references",
+      description: "Escalation reason when confidence is too low"
+    },
+    "tool.classify.title": {
+      value: "support_classify_ticket",
+      description: "MCP tool title for ticket classification"
+    },
+    "tool.classify.description": {
+      value: "Classify a ticket for priority, sentiment, and category",
+      description: "MCP tool description for ticket classification"
+    },
+    "tool.resolve.title": {
+      value: "support_resolve_ticket",
+      description: "MCP tool title for ticket resolution"
+    },
+    "tool.resolve.description": {
+      value: "Generate a knowledge-grounded resolution for a ticket",
+      description: "MCP tool description for ticket resolution"
+    },
+    "tool.draft.title": {
+      value: "support_draft_response",
+      description: "MCP tool title for response drafting"
+    },
+    "tool.draft.description": {
+      value: "Draft a user-facing reply based on resolution + classification",
+      description: "MCP tool description for response drafting"
+    },
+    "error.inputMustIncludeTicket": {
+      value: "Input must include ticket",
+      description: "Error when input payload is missing the ticket field"
+    },
+    "error.ticketMissingId": {
+      value: "Ticket is missing id",
+      description: "Error when ticket object lacks an id"
+    },
+    "error.resolutionClassificationRequired": {
+      value: "resolution and classification are required",
+      description: "Error when draft endpoint is called without resolution and classification"
+    },
+    "feedback.noRecords": {
+      value: "No feedback recorded yet.",
+      description: "Placeholder when no feedback entries exist"
+    },
+    "feedback.status.escalated": {
+      value: "Escalated",
+      description: "Status label for escalated tickets"
+    },
+    "feedback.status.autoResolved": {
+      value: "Auto-resolved",
+      description: "Status label for auto-resolved tickets"
+    },
+    "spec.instructionsAppendix": {
+      value: "Always cite support knowledge sources and flag compliance/billing issues for human review when unsure.",
+      description: "Instructions appendix appended to agent spec"
+    }
+  }
+});
+
+// src/i18n/catalogs/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  meta: {
+    key: "support-bot.messages",
+    version: "1.0.0",
+    domain: "support-bot",
+    description: "French translations for the support-bot package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "fr",
+  fallback: "en",
+  messages: {
+    "prompt.classifier.system": {
+      value: "Classifiez le ticket de support.",
+      description: "Classifier LLM system prompt"
+    },
+    "prompt.autoResponder.system": {
+      value: "R\xE9digez des r\xE9ponses de support empathiques et pr\xE9cises en citant les sources lorsque c\u2019est pertinent.",
+      description: "Auto-responder LLM system prompt"
+    },
+    "prompt.autoResponder.user": {
+      value: `Ticket #{ticketId} ({category}, {priority}, {sentiment})
+Sujet\xA0: {subject}
+
+{body}
+
+Connaissances\xA0:
+{knowledge}
+
+R\xE9pondez au client.`,
+      description: "Auto-responder user prompt template",
+      placeholders: [
+        { name: "ticketId", type: "string" },
+        { name: "category", type: "string" },
+        { name: "priority", type: "string" },
+        { name: "sentiment", type: "string" },
+        { name: "subject", type: "string" },
+        { name: "body", type: "string" },
+        { name: "knowledge", type: "string" }
+      ]
+    },
+    "responder.closing.friendly": {
+      value: "Nous restons \xE0 votre disposition si vous avez besoin de quoi que ce soit.",
+      description: "Friendly closing line for support responses"
+    },
+    "responder.closing.formal": {
+      value: "Veuillez nous contacter si vous avez besoin d\u2019une assistance suppl\xE9mentaire.",
+      description: "Formal closing line for support responses"
+    },
+    "responder.greeting.named": {
+      value: "Bonjour {name},",
+      description: "Greeting with customer name",
+      placeholders: [{ name: "name", type: "string" }]
+    },
+    "responder.greeting.anonymous": {
+      value: "Bonjour,",
+      description: "Greeting without customer name"
+    },
+    "responder.intro.thanks": {
+      value: "Merci de nous avoir contact\xE9s au sujet de \xAB\xA0{subject}\xA0\xBB.",
+      description: "Thank-you intro referencing the ticket subject",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "responder.signature": {
+      value: "\u2014 Support ContractSpec",
+      description: "Email / response signature"
+    },
+    "responder.references.header": {
+      value: "R\xE9f\xE9rences\xA0:",
+      description: "Header for the references section"
+    },
+    "responder.references.sourceLabel": {
+      value: "Source {index}",
+      description: "Label for a numbered source reference",
+      placeholders: [{ name: "index", type: "number" }]
+    },
+    "responder.category.billing": {
+      value: "Je comprends que les probl\xE8mes de facturation peuvent \xEAtre stressants, laissez-moi clarifier la situation.",
+      description: "Category intro for billing tickets"
+    },
+    "responder.category.technical": {
+      value: "Je vois que vous avez rencontr\xE9 un probl\xE8me technique. Voici ce qui s\u2019est pass\xE9 et comment le r\xE9soudre.",
+      description: "Category intro for technical tickets"
+    },
+    "responder.category.product": {
+      value: "Merci d\u2019avoir partag\xE9 vos retours sur le produit. Voici les prochaines \xE9tapes.",
+      description: "Category intro for product tickets"
+    },
+    "responder.category.account": {
+      value: "L\u2019acc\xE8s au compte est essentiel, laissez-moi vous guider vers la r\xE9solution.",
+      description: "Category intro for account tickets"
+    },
+    "responder.category.compliance": {
+      value: "Les questions de conformit\xE9 exigent de la pr\xE9cision. Consultez la r\xE9ponse conforme aux politiques ci-dessous.",
+      description: "Category intro for compliance tickets"
+    },
+    "responder.category.other": {
+      value: "Voici ce que nous avons trouv\xE9 apr\xE8s examen de votre demande.",
+      description: "Category intro for uncategorized tickets"
+    },
+    "responder.subject.replyPrefix": {
+      value: "Re\xA0: {subject}",
+      description: "Reply subject line prefix",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "resolver.question.subjectLabel": {
+      value: "Sujet\xA0: {subject}",
+      description: "Subject label in resolver question context",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "resolver.question.channelLabel": {
+      value: "Canal\xA0: {channel}",
+      description: "Channel label in resolver question context",
+      placeholders: [{ name: "channel", type: "string" }]
+    },
+    "resolver.question.customerLabel": {
+      value: "Client\xA0: {name}",
+      description: "Customer label in resolver question context",
+      placeholders: [{ name: "name", type: "string" }]
+    },
+    "resolver.action.escalate": {
+      value: "Escalader pour r\xE9vision humaine",
+      description: "Action label for escalation"
+    },
+    "resolver.action.respond": {
+      value: "Envoyer une r\xE9ponse automatique",
+      description: "Action label for automated response"
+    },
+    "resolver.escalation.insufficientConfidence": {
+      value: "Confiance insuffisante ou r\xE9f\xE9rences de connaissances manquantes",
+      description: "Escalation reason when confidence is too low"
+    },
+    "tool.classify.title": {
+      value: "support_classify_ticket",
+      description: "MCP tool title for ticket classification"
+    },
+    "tool.classify.description": {
+      value: "Classifier un ticket par priorit\xE9, sentiment et cat\xE9gorie",
+      description: "MCP tool description for ticket classification"
+    },
+    "tool.resolve.title": {
+      value: "support_resolve_ticket",
+      description: "MCP tool title for ticket resolution"
+    },
+    "tool.resolve.description": {
+      value: "G\xE9n\xE9rer une r\xE9solution fond\xE9e sur la base de connaissances pour un ticket",
+      description: "MCP tool description for ticket resolution"
+    },
+    "tool.draft.title": {
+      value: "support_draft_response",
+      description: "MCP tool title for response drafting"
+    },
+    "tool.draft.description": {
+      value: "R\xE9diger une r\xE9ponse client bas\xE9e sur la r\xE9solution et la classification",
+      description: "MCP tool description for response drafting"
+    },
+    "error.inputMustIncludeTicket": {
+      value: "L\u2019entr\xE9e doit inclure un ticket",
+      description: "Error when input payload is missing the ticket field"
+    },
+    "error.ticketMissingId": {
+      value: "Le ticket n\u2019a pas d\u2019identifiant",
+      description: "Error when ticket object lacks an id"
+    },
+    "error.resolutionClassificationRequired": {
+      value: "la r\xE9solution et la classification sont requises",
+      description: "Error when draft endpoint is called without resolution and classification"
+    },
+    "feedback.noRecords": {
+      value: "Aucun retour enregistr\xE9 pour le moment.",
+      description: "Placeholder when no feedback entries exist"
+    },
+    "feedback.status.escalated": {
+      value: "Escalad\xE9",
+      description: "Status label for escalated tickets"
+    },
+    "feedback.status.autoResolved": {
+      value: "R\xE9solu automatiquement",
+      description: "Status label for auto-resolved tickets"
+    },
+    "spec.instructionsAppendix": {
+      value: "Citez toujours les sources de connaissances du support et signalez les probl\xE8mes de conformit\xE9/facturation pour r\xE9vision humaine en cas de doute.",
+      description: "Instructions appendix appended to agent spec"
+    }
+  }
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  meta: {
+    key: "support-bot.messages",
+    version: "1.0.0",
+    domain: "support-bot",
+    description: "Spanish translations for the support-bot package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "es",
+  fallback: "en",
+  messages: {
+    "prompt.classifier.system": {
+      value: "Clasifica el ticket de soporte.",
+      description: "Classifier LLM system prompt"
+    },
+    "prompt.autoResponder.system": {
+      value: "Redacta respuestas de soporte emp\xE1ticas y precisas citando fuentes cuando sea relevante.",
+      description: "Auto-responder LLM system prompt"
+    },
+    "prompt.autoResponder.user": {
+      value: `Ticket #{ticketId} ({category}, {priority}, {sentiment})
+Asunto: {subject}
+
+{body}
+
+Conocimientos:
+{knowledge}
+
+Responde al cliente.`,
+      description: "Auto-responder user prompt template",
+      placeholders: [
+        { name: "ticketId", type: "string" },
+        { name: "category", type: "string" },
+        { name: "priority", type: "string" },
+        { name: "sentiment", type: "string" },
+        { name: "subject", type: "string" },
+        { name: "body", type: "string" },
+        { name: "knowledge", type: "string" }
+      ]
+    },
+    "responder.closing.friendly": {
+      value: "Quedamos a su disposici\xF3n si necesita cualquier otra cosa.",
+      description: "Friendly closing line for support responses"
+    },
+    "responder.closing.formal": {
+      value: "No dude en contactarnos si requiere asistencia adicional.",
+      description: "Formal closing line for support responses"
+    },
+    "responder.greeting.named": {
+      value: "Hola {name},",
+      description: "Greeting with customer name",
+      placeholders: [{ name: "name", type: "string" }]
+    },
+    "responder.greeting.anonymous": {
+      value: "Hola,",
+      description: "Greeting without customer name"
+    },
+    "responder.intro.thanks": {
+      value: "Gracias por contactarnos sobre \xAB{subject}\xBB.",
+      description: "Thank-you intro referencing the ticket subject",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "responder.signature": {
+      value: "\u2014 Soporte ContractSpec",
+      description: "Email / response signature"
+    },
+    "responder.references.header": {
+      value: "Referencias:",
+      description: "Header for the references section"
+    },
+    "responder.references.sourceLabel": {
+      value: "Fuente {index}",
+      description: "Label for a numbered source reference",
+      placeholders: [{ name: "index", type: "number" }]
+    },
+    "responder.category.billing": {
+      value: "Entiendo que los problemas de facturaci\xF3n pueden ser estresantes, perm\xEDtame aclarar la situaci\xF3n.",
+      description: "Category intro for billing tickets"
+    },
+    "responder.category.technical": {
+      value: "Veo que encontr\xF3 un problema t\xE9cnico. Esto es lo que sucedi\xF3 y c\xF3mo solucionarlo.",
+      description: "Category intro for technical tickets"
+    },
+    "responder.category.product": {
+      value: "Gracias por compartir sus comentarios sobre el producto. Estos son los pr\xF3ximos pasos.",
+      description: "Category intro for product tickets"
+    },
+    "responder.category.account": {
+      value: "El acceso a la cuenta es fundamental, perm\xEDtame guiarle hacia la resoluci\xF3n.",
+      description: "Category intro for account tickets"
+    },
+    "responder.category.compliance": {
+      value: "Las preguntas de cumplimiento requieren precisi\xF3n. Consulte la respuesta alineada con las pol\xEDticas a continuaci\xF3n.",
+      description: "Category intro for compliance tickets"
+    },
+    "responder.category.other": {
+      value: "Esto es lo que encontramos tras revisar su solicitud.",
+      description: "Category intro for uncategorized tickets"
+    },
+    "responder.subject.replyPrefix": {
+      value: "Re: {subject}",
+      description: "Reply subject line prefix",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "resolver.question.subjectLabel": {
+      value: "Asunto: {subject}",
+      description: "Subject label in resolver question context",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "resolver.question.channelLabel": {
+      value: "Canal: {channel}",
+      description: "Channel label in resolver question context",
+      placeholders: [{ name: "channel", type: "string" }]
+    },
+    "resolver.question.customerLabel": {
+      value: "Cliente: {name}",
+      description: "Customer label in resolver question context",
+      placeholders: [{ name: "name", type: "string" }]
+    },
+    "resolver.action.escalate": {
+      value: "Escalar para revisi\xF3n humana",
+      description: "Action label for escalation"
+    },
+    "resolver.action.respond": {
+      value: "Enviar respuesta autom\xE1tica",
+      description: "Action label for automated response"
+    },
+    "resolver.escalation.insufficientConfidence": {
+      value: "Confianza insuficiente o referencias de conocimiento faltantes",
+      description: "Escalation reason when confidence is too low"
+    },
+    "tool.classify.title": {
+      value: "support_classify_ticket",
+      description: "MCP tool title for ticket classification"
+    },
+    "tool.classify.description": {
+      value: "Clasificar un ticket por prioridad, sentimiento y categor\xEDa",
+      description: "MCP tool description for ticket classification"
+    },
+    "tool.resolve.title": {
+      value: "support_resolve_ticket",
+      description: "MCP tool title for ticket resolution"
+    },
+    "tool.resolve.description": {
+      value: "Generar una resoluci\xF3n basada en conocimientos para un ticket",
+      description: "MCP tool description for ticket resolution"
+    },
+    "tool.draft.title": {
+      value: "support_draft_response",
+      description: "MCP tool title for response drafting"
+    },
+    "tool.draft.description": {
+      value: "Redactar una respuesta al cliente basada en la resoluci\xF3n y la clasificaci\xF3n",
+      description: "MCP tool description for response drafting"
+    },
+    "error.inputMustIncludeTicket": {
+      value: "La entrada debe incluir un ticket",
+      description: "Error when input payload is missing the ticket field"
+    },
+    "error.ticketMissingId": {
+      value: "El ticket no tiene identificador",
+      description: "Error when ticket object lacks an id"
+    },
+    "error.resolutionClassificationRequired": {
+      value: "la resoluci\xF3n y la clasificaci\xF3n son obligatorias",
+      description: "Error when draft endpoint is called without resolution and classification"
+    },
+    "feedback.noRecords": {
+      value: "No hay comentarios registrados a\xFAn.",
+      description: "Placeholder when no feedback entries exist"
+    },
+    "feedback.status.escalated": {
+      value: "Escalado",
+      description: "Status label for escalated tickets"
+    },
+    "feedback.status.autoResolved": {
+      value: "Resuelto autom\xE1ticamente",
+      description: "Status label for auto-resolved tickets"
+    },
+    "spec.instructionsAppendix": {
+      value: "Cite siempre las fuentes de conocimiento de soporte y se\xF1ale los problemas de cumplimiento/facturaci\xF3n para revisi\xF3n humana en caso de duda.",
+      description: "Instructions appendix appended to agent spec"
+    }
+  }
+});
+
+// src/i18n/messages.ts
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+import { interpolate } from "@contractspec/lib.contracts-spec/translations";
+var factory = createI18nFactory({
+  specKey: "support-bot.messages",
+  catalogs: [enMessages, frMessages, esMessages]
+});
+var createSupportBotI18n = factory.create;
+var getDefaultI18n = factory.getDefault;
+var resetI18nRegistry = factory.resetRegistry;
+
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+
+// src/i18n/keys.ts
+var PROMPT_KEYS = {
+  "prompt.classifier.system": "prompt.classifier.system",
+  "prompt.autoResponder.system": "prompt.autoResponder.system",
+  "prompt.autoResponder.user": "prompt.autoResponder.user"
+};
+var RESPONDER_KEYS = {
+  "responder.closing.friendly": "responder.closing.friendly",
+  "responder.closing.formal": "responder.closing.formal",
+  "responder.greeting.named": "responder.greeting.named",
+  "responder.greeting.anonymous": "responder.greeting.anonymous",
+  "responder.intro.thanks": "responder.intro.thanks",
+  "responder.signature": "responder.signature",
+  "responder.references.header": "responder.references.header",
+  "responder.references.sourceLabel": "responder.references.sourceLabel",
+  "responder.category.billing": "responder.category.billing",
+  "responder.category.technical": "responder.category.technical",
+  "responder.category.product": "responder.category.product",
+  "responder.category.account": "responder.category.account",
+  "responder.category.compliance": "responder.category.compliance",
+  "responder.category.other": "responder.category.other",
+  "responder.subject.replyPrefix": "responder.subject.replyPrefix"
+};
+var RESOLVER_KEYS = {
+  "resolver.question.subjectLabel": "resolver.question.subjectLabel",
+  "resolver.question.channelLabel": "resolver.question.channelLabel",
+  "resolver.question.customerLabel": "resolver.question.customerLabel",
+  "resolver.action.escalate": "resolver.action.escalate",
+  "resolver.action.respond": "resolver.action.respond",
+  "resolver.escalation.insufficientConfidence": "resolver.escalation.insufficientConfidence"
+};
+var TOOL_KEYS = {
+  "tool.classify.title": "tool.classify.title",
+  "tool.classify.description": "tool.classify.description",
+  "tool.resolve.title": "tool.resolve.title",
+  "tool.resolve.description": "tool.resolve.description",
+  "tool.draft.title": "tool.draft.title",
+  "tool.draft.description": "tool.draft.description"
+};
+var ERROR_KEYS = {
+  "error.inputMustIncludeTicket": "error.inputMustIncludeTicket",
+  "error.ticketMissingId": "error.ticketMissingId",
+  "error.resolutionClassificationRequired": "error.resolutionClassificationRequired"
+};
+var FEEDBACK_KEYS = {
+  "feedback.noRecords": "feedback.noRecords",
+  "feedback.status.escalated": "feedback.status.escalated",
+  "feedback.status.autoResolved": "feedback.status.autoResolved"
+};
+var SPEC_KEYS = {
+  "spec.instructionsAppendix": "spec.instructionsAppendix"
+};
+var I18N_KEYS = {
+  ...PROMPT_KEYS,
+  ...RESPONDER_KEYS,
+  ...RESOLVER_KEYS,
+  ...TOOL_KEYS,
+  ...ERROR_KEYS,
+  ...FEEDBACK_KEYS,
+  ...SPEC_KEYS
+};
 // src/bot/auto-responder.ts
 class AutoResponder {
   llm;
   model;
   tone;
   closing;
+  i18n;
   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.");
+    this.i18n = createSupportBotI18n(options?.locale);
+    const { t } = this.i18n;
+    this.closing = options?.closing ?? (this.tone === "friendly" ? t("responder.closing.friendly") : t("responder.closing.formal"));
   }
   async draft(ticket, resolution, classification) {
     if (this.llm) {
@@ -18,21 +670,23 @@ class AutoResponder {
     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 { t } = this.i18n;
+    const prompt = t("prompt.autoResponder.user", {
+      tone: this.tone,
+      subject: ticket.subject,
+      body: ticket.body,
+      category: classification.category,
+      priority: classification.priority,
+      answer: resolution.answer,
+      citations: resolution.citations.map((c) => c.label).join(", ")
+    });
     const response = await this.llm.chat([
       {
         role: "system",
         content: [
           {
             type: "text",
-            text: "Write empathetic, accurate support replies that cite sources when relevant."
+            text: t("prompt.autoResponder.system")
           }
         ]
       },
@@ -45,17 +699,18 @@ Citations: ${resolution.citations.map((c) => c.label).join(", ")}`;
     return this.buildDraft(ticket, resolution, classification, body);
   }
   generateTemplate(ticket, resolution, classification) {
-    const greeting = ticket.customerName ? `Hi ${ticket.customerName},` : "Hi there,";
+    const { t } = this.i18n;
+    const greeting = ticket.customerName ? t("responder.greeting.named", { name: ticket.customerName }) : t("responder.greeting.anonymous");
     const body = `${greeting}
 
-Thanks for contacting us about "${ticket.subject}". ${this.renderCategoryIntro(classification)}
+${t("responder.intro.thanks", { subject: ticket.subject })} ${this.renderCategoryIntro(classification)}
 
 ${resolution.answer}
 
 ${this.renderCitations(resolution)}
 ${this.closing}
 
-\u2014 ContractSpec Support`;
+${t("responder.signature")}`;
     return this.buildDraft(ticket, resolution, classification, body);
   }
   buildDraft(ticket, resolution, classification, body) {
@@ -69,30 +724,32 @@ ${this.closing}
     };
   }
   renderCategoryIntro(classification) {
+    const { t } = this.i18n;
     switch (classification.category) {
       case "billing":
-        return "I understand billing issues can be stressful, so let me clarify the situation.";
+        return t("responder.category.billing");
       case "technical":
-        return "I see you encountered a technical issue. Here is what happened and how to fix it.";
+        return t("responder.category.technical");
       case "product":
-        return "Thanks for sharing feedback about the product. Here are the next steps.";
+        return t("responder.category.product");
       case "account":
-        return "Account access is critical, so let me walk you through the resolution.";
+        return t("responder.category.account");
       case "compliance":
-        return "Compliance questions require precision. See the policy-aligned answer below.";
+        return t("responder.category.compliance");
       default:
-        return "Here is what we found after reviewing your request.";
+        return t("responder.category.other");
     }
   }
   renderCitations(resolution) {
+    const { t } = this.i18n;
     if (!resolution.citations.length)
       return "";
     const lines = resolution.citations.map((citation, index) => {
-      const label = citation.label || `Source ${index + 1}`;
+      const label = citation.label || t("responder.references.sourceLabel", { index: index + 1 });
       const link = citation.url ? ` (${citation.url})` : "";
       return `- ${label}${link}`;
     });
-    return `References:
+    return `${t("responder.references.header")}
 ${lines.join(`
 `)}`;
   }
@@ -123,11 +780,12 @@ class SupportFeedbackLoop {
     };
   }
   feedbackSummary(limit = 5) {
+    const { t } = getDefaultI18n();
     const recent = this.history.slice(-limit);
     if (!recent.length)
-      return "No feedback recorded yet.";
+      return t("feedback.noRecords");
     return recent.map((entry) => {
-      const status = entry.resolution.actions.some((action) => action.type === "escalate") ? "Escalated" : "Auto-resolved";
+      const status = entry.resolution.actions.some((action) => action.type === "escalate") ? t("feedback.status.escalated") : t("feedback.status.autoResolved");
       return `${entry.ticket.subject} \u2013 ${status} (confidence: ${entry.resolution.confidence})`;
     }).join(`
 `);
@@ -298,10 +956,12 @@ class TicketResolver {
   knowledge;
   minConfidence;
   prependPrompt;
+  i18n;
   constructor(options) {
     this.knowledge = options.knowledge;
     this.minConfidence = options.minConfidence ?? 0.65;
     this.prependPrompt = options.prependPrompt;
+    this.i18n = createSupportBotI18n(options.locale);
   }
   async resolve(ticket) {
     const question = this.buildQuestion(ticket);
@@ -309,9 +969,14 @@ class TicketResolver {
     return this.toResolution(ticket, answer);
   }
   buildQuestion(ticket) {
-    const header = [`Subject: ${ticket.subject}`, `Channel: ${ticket.channel}`];
-    if (ticket.customerName)
-      header.push(`Customer: ${ticket.customerName}`);
+    const { t } = this.i18n;
+    const header = [
+      t("resolver.question.subjectLabel", { subject: ticket.subject }),
+      t("resolver.question.channelLabel", { channel: ticket.channel })
+    ];
+    if (ticket.customerName) {
+      header.push(t("resolver.question.customerLabel", { name: ticket.customerName }));
+    }
     const sections = [
       this.prependPrompt,
       header.join(`
@@ -332,6 +997,7 @@ class TicketResolver {
         score: ref.score
       };
     });
+    const { t } = this.i18n;
     const confidence = this.deriveConfidence(answer);
     const escalate = confidence < this.minConfidence || citations.length === 0;
     return {
@@ -340,9 +1006,9 @@ class TicketResolver {
       confidence,
       citations,
       actions: [
-        escalate ? { type: "escalate", label: "Escalate for human review" } : { type: "respond", label: "Send automated response" }
+        escalate ? { type: "escalate", label: t("resolver.action.escalate") } : { type: "respond", label: t("resolver.action.respond") }
       ],
-      escalationReason: escalate ? "Insufficient confidence or missing knowledge references" : undefined,
+      escalationReason: escalate ? t("resolver.escalation.insufficientConfidence") : undefined,
       knowledgeUpdates: escalate ? [ticket.body.slice(0, 200)] : undefined
     };
   }
@@ -357,35 +1023,193 @@ class TicketResolver {
 }
 // src/tickets/classifier.ts
 var CATEGORY_KEYWORDS = {
-  billing: ["invoice", "payout", "refund", "charge", "billing", "payment"],
-  technical: ["bug", "error", "crash", "issue", "failed", "timeout"],
-  product: ["feature", "roadmap", "idea", "request", "feedback"],
-  account: ["login", "password", "2fa", "account", "profile", "email change"],
-  compliance: ["kyc", "aml", "compliance", "regulation", "gdpr"],
-  other: []
+  en: {
+    billing: ["invoice", "payout", "refund", "charge", "billing", "payment"],
+    technical: ["bug", "error", "crash", "issue", "failed", "timeout"],
+    product: ["feature", "roadmap", "idea", "request", "feedback"],
+    account: ["login", "password", "2fa", "account", "profile", "email change"],
+    compliance: ["kyc", "aml", "compliance", "regulation", "gdpr"],
+    other: []
+  },
+  fr: {
+    billing: [
+      "facture",
+      "versement",
+      "remboursement",
+      "frais",
+      "facturation",
+      "paiement"
+    ],
+    technical: [
+      "bogue",
+      "erreur",
+      "plantage",
+      "probl\xE8me",
+      "\xE9chou\xE9",
+      "d\xE9lai d\xE9pass\xE9"
+    ],
+    product: [
+      "fonctionnalit\xE9",
+      "feuille de route",
+      "id\xE9e",
+      "demande",
+      "retour"
+    ],
+    account: [
+      "connexion",
+      "mot de passe",
+      "2fa",
+      "compte",
+      "profil",
+      "changement email"
+    ],
+    compliance: ["kyc", "aml", "conformit\xE9", "r\xE9glementation", "rgpd"],
+    other: []
+  },
+  es: {
+    billing: [
+      "factura",
+      "desembolso",
+      "reembolso",
+      "cargo",
+      "facturaci\xF3n",
+      "pago"
+    ],
+    technical: [
+      "error",
+      "fallo",
+      "ca\xEDda",
+      "problema",
+      "fallido",
+      "tiempo agotado"
+    ],
+    product: [
+      "funcionalidad",
+      "hoja de ruta",
+      "idea",
+      "solicitud",
+      "comentario"
+    ],
+    account: [
+      "inicio de sesi\xF3n",
+      "contrase\xF1a",
+      "2fa",
+      "cuenta",
+      "perfil",
+      "cambio de email"
+    ],
+    compliance: ["kyc", "aml", "cumplimiento", "regulaci\xF3n", "rgpd"],
+    other: []
+  }
 };
 var PRIORITY_HINTS = {
-  urgent: ["urgent", "asap", "immediately", "today", "right away"],
-  high: ["high priority", "blocking", "major", "critical"],
-  medium: ["soon", "next few days"],
-  low: ["nice to have", "when possible", "later"]
+  en: {
+    urgent: ["urgent", "asap", "immediately", "today", "right away"],
+    high: ["high priority", "blocking", "major", "critical"],
+    medium: ["soon", "next few days"],
+    low: ["nice to have", "when possible", "later"]
+  },
+  fr: {
+    urgent: [
+      "urgent",
+      "d\xE8s que possible",
+      "imm\xE9diatement",
+      "aujourd'hui",
+      "tout de suite"
+    ],
+    high: ["haute priorit\xE9", "bloquant", "majeur", "critique"],
+    medium: ["bient\xF4t", "prochains jours"],
+    low: ["ce serait bien", "quand possible", "plus tard"]
+  },
+  es: {
+    urgent: [
+      "urgente",
+      "lo antes posible",
+      "inmediatamente",
+      "hoy",
+      "ahora mismo"
+    ],
+    high: ["alta prioridad", "bloqueante", "mayor", "cr\xEDtico"],
+    medium: ["pronto", "pr\xF3ximos d\xEDas"],
+    low: ["ser\xEDa bueno", "cuando sea posible", "m\xE1s tarde"]
+  }
 };
 var SENTIMENT_HINTS = {
-  positive: ["love", "great", "awesome", "thank you"],
-  neutral: ["question", "wonder", "curious"],
-  negative: ["unhappy", "bad", "terrible", "awful", "angry"],
-  frustrated: ["furious", "frustrated", "fed up", "ridiculous"]
+  en: {
+    positive: ["love", "great", "awesome", "thank you"],
+    neutral: ["question", "wonder", "curious"],
+    negative: ["unhappy", "bad", "terrible", "awful", "angry"],
+    frustrated: ["furious", "frustrated", "fed up", "ridiculous"]
+  },
+  fr: {
+    positive: ["adore", "super", "formidable", "merci"],
+    neutral: ["question", "demande", "curieux"],
+    negative: ["m\xE9content", "mauvais", "terrible", "affreux", "en col\xE8re"],
+    frustrated: ["furieux", "frustr\xE9", "ras le bol", "ridicule"]
+  },
+  es: {
+    positive: ["encanta", "genial", "incre\xEDble", "gracias"],
+    neutral: ["pregunta", "duda", "curioso"],
+    negative: ["descontento", "malo", "terrible", "horrible", "enojado"],
+    frustrated: ["furioso", "frustrado", "harto", "rid\xEDculo"]
+  }
+};
+var INTENT_KEYWORDS = {
+  en: [
+    { keyword: "refund", intent: "refund" },
+    { keyword: "chargeback", intent: "refund" },
+    { keyword: "payout", intent: "payout" },
+    { keyword: "login", intent: "login-help" },
+    { keyword: "feature", intent: "feature-request" },
+    { keyword: "bug", intent: "bug-report" },
+    { keyword: "error", intent: "bug-report" }
+  ],
+  fr: [
+    { keyword: "remboursement", intent: "refund" },
+    { keyword: "r\xE9trofacturation", intent: "refund" },
+    { keyword: "versement", intent: "payout" },
+    { keyword: "connexion", intent: "login-help" },
+    { keyword: "fonctionnalit\xE9", intent: "feature-request" },
+    { keyword: "bogue", intent: "bug-report" },
+    { keyword: "erreur", intent: "bug-report" }
+  ],
+  es: [
+    { keyword: "reembolso", intent: "refund" },
+    { keyword: "contracargo", intent: "refund" },
+    { keyword: "desembolso", intent: "payout" },
+    { keyword: "inicio de sesi\xF3n", intent: "login-help" },
+    { keyword: "funcionalidad", intent: "feature-request" },
+    { keyword: "error", intent: "bug-report" },
+    { keyword: "fallo", intent: "bug-report" }
+  ]
 };
+function resolveBaseLocale(locale) {
+  if (!locale)
+    return "en";
+  const base = locale.split("-")[0]?.toLowerCase() ?? "en";
+  if (base === "en" || base === "fr" || base === "es") {
+    return base;
+  }
+  return "en";
+}
 
 class TicketClassifier {
   keywords;
+  priorityHints;
+  sentimentHints;
+  intentKeywords;
   llm;
   llmModel;
+  locale;
   constructor(options) {
+    this.locale = resolveBaseLocale(options?.locale);
     this.keywords = {
-      ...CATEGORY_KEYWORDS,
+      ...CATEGORY_KEYWORDS[this.locale],
       ...options?.keywords ?? {}
     };
+    this.priorityHints = PRIORITY_HINTS[this.locale];
+    this.sentimentHints = SENTIMENT_HINTS[this.locale];
+    this.intentKeywords = INTENT_KEYWORDS[this.locale];
     this.llm = options?.llm;
     this.llmModel = options?.llmModel;
   }
@@ -397,7 +1221,12 @@ class TicketClassifier {
       const llmResult = await this.llm.chat([
         {
           role: "system",
-          content: [{ type: "text", text: "Classify the support ticket." }]
+          content: [
+            {
+              type: "text",
+              text: createSupportBotI18n(this.locale).t("prompt.classifier.system")
+            }
+          ]
         },
         {
           role: "user",
@@ -464,7 +1293,8 @@ ${ticket.body}`.toLowerCase();
       "medium",
       "low"
     ]) {
-      if (PRIORITY_HINTS[priority].some((word) => text.includes(word))) {
+      const hints = this.priorityHints[priority];
+      if (hints?.some((word) => text.includes(word))) {
         return priority;
       }
     }
@@ -477,25 +1307,21 @@ ${ticket.body}`.toLowerCase();
       "neutral",
       "positive"
     ]) {
-      if (SENTIMENT_HINTS[sentiment].some((word) => text.includes(word))) {
+      const hints = this.sentimentHints[sentiment];
+      if (hints?.some((word) => text.includes(word))) {
         return sentiment;
       }
     }
     return "neutral";
   }
   extractIntents(text) {
-    const intents = [];
-    if (text.includes("refund") || text.includes("chargeback"))
-      intents.push("refund");
-    if (text.includes("payout"))
-      intents.push("payout");
-    if (text.includes("login"))
-      intents.push("login-help");
-    if (text.includes("feature"))
-      intents.push("feature-request");
-    if (text.includes("bug") || text.includes("error"))
-      intents.push("bug-report");
-    return intents.length ? intents : ["general"];
+    const intents = new Set;
+    for (const { keyword, intent } of this.intentKeywords) {
+      if (text.includes(keyword)) {
+        intents.add(intent);
+      }
+    }
+    return intents.size > 0 ? [...intents] : ["general"];
   }
   estimateConfidence(category, priority, sentiment) {
     let base = 0.6;