@contractspec/lib.support-bot 2.4.0 → 2.6.0

package/dist/i18n/keys.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Typed message keys for the support-bot i18n system.
+ *
+ * All translatable strings in the package are referenced by these keys.
+ * Organized by domain: prompt, responder, resolver, tool, error, feedback, spec.
+ *
+ * @module i18n/keys
+ */
+export declare const PROMPT_KEYS: {
+    /** Classifier system prompt */
+    readonly 'prompt.classifier.system': "prompt.classifier.system";
+    /** Auto-responder system prompt */
+    readonly 'prompt.autoResponder.system': "prompt.autoResponder.system";
+    /** Auto-responder user prompt template */
+    readonly 'prompt.autoResponder.user': "prompt.autoResponder.user";
+};
+export declare const RESPONDER_KEYS: {
+    /** "We remain available if you need anything else." */
+    readonly 'responder.closing.friendly': "responder.closing.friendly";
+    /** "Please let us know if you require additional assistance." */
+    readonly 'responder.closing.formal': "responder.closing.formal";
+    /** "Hi {name}," */
+    readonly 'responder.greeting.named': "responder.greeting.named";
+    /** "Hi there," */
+    readonly 'responder.greeting.anonymous': "responder.greeting.anonymous";
+    /** 'Thanks for contacting us about "{subject}".' */
+    readonly 'responder.intro.thanks': "responder.intro.thanks";
+    /** "\u2014 ContractSpec Support" */
+    readonly 'responder.signature': "responder.signature";
+    /** "References:" */
+    readonly 'responder.references.header': "responder.references.header";
+    /** "Source {index}" */
+    readonly 'responder.references.sourceLabel': "responder.references.sourceLabel";
+    /** Category intro: billing */
+    readonly 'responder.category.billing': "responder.category.billing";
+    /** Category intro: technical */
+    readonly 'responder.category.technical': "responder.category.technical";
+    /** Category intro: product */
+    readonly 'responder.category.product': "responder.category.product";
+    /** Category intro: account */
+    readonly 'responder.category.account': "responder.category.account";
+    /** Category intro: compliance */
+    readonly 'responder.category.compliance': "responder.category.compliance";
+    /** Category intro: other */
+    readonly 'responder.category.other': "responder.category.other";
+    /** "Re: {subject}" */
+    readonly 'responder.subject.replyPrefix': "responder.subject.replyPrefix";
+};
+export declare const RESOLVER_KEYS: {
+    /** "Subject: {subject}" */
+    readonly 'resolver.question.subjectLabel': "resolver.question.subjectLabel";
+    /** "Channel: {channel}" */
+    readonly 'resolver.question.channelLabel': "resolver.question.channelLabel";
+    /** "Customer: {name}" */
+    readonly 'resolver.question.customerLabel': "resolver.question.customerLabel";
+    /** "Escalate for human review" */
+    readonly 'resolver.action.escalate': "resolver.action.escalate";
+    /** "Send automated response" */
+    readonly 'resolver.action.respond': "resolver.action.respond";
+    /** "Insufficient confidence or missing knowledge references" */
+    readonly 'resolver.escalation.insufficientConfidence': "resolver.escalation.insufficientConfidence";
+};
+export declare const TOOL_KEYS: {
+    /** "support_classify_ticket" */
+    readonly 'tool.classify.title': "tool.classify.title";
+    /** "Classify a ticket for priority, sentiment, and category" */
+    readonly 'tool.classify.description': "tool.classify.description";
+    /** "support_resolve_ticket" */
+    readonly 'tool.resolve.title': "tool.resolve.title";
+    /** "Generate a knowledge-grounded resolution for a ticket" */
+    readonly 'tool.resolve.description': "tool.resolve.description";
+    /** "support_draft_response" */
+    readonly 'tool.draft.title': "tool.draft.title";
+    /** "Draft a user-facing reply based on resolution + classification" */
+    readonly 'tool.draft.description': "tool.draft.description";
+};
+export declare const ERROR_KEYS: {
+    /** "Input must include ticket" */
+    readonly 'error.inputMustIncludeTicket': "error.inputMustIncludeTicket";
+    /** "Ticket is missing id" */
+    readonly 'error.ticketMissingId': "error.ticketMissingId";
+    /** "resolution and classification are required" */
+    readonly 'error.resolutionClassificationRequired': "error.resolutionClassificationRequired";
+};
+export declare const FEEDBACK_KEYS: {
+    /** "No feedback recorded yet." */
+    readonly 'feedback.noRecords': "feedback.noRecords";
+    /** "Escalated" */
+    readonly 'feedback.status.escalated': "feedback.status.escalated";
+    /** "Auto-resolved" */
+    readonly 'feedback.status.autoResolved': "feedback.status.autoResolved";
+};
+export declare const SPEC_KEYS: {
+    /** Instructions appendix for support-bot spec */
+    readonly 'spec.instructionsAppendix': "spec.instructionsAppendix";
+};
+export declare const I18N_KEYS: {
+    /** Instructions appendix for support-bot spec */
+    readonly 'spec.instructionsAppendix': "spec.instructionsAppendix";
+    /** "No feedback recorded yet." */
+    readonly 'feedback.noRecords': "feedback.noRecords";
+    /** "Escalated" */
+    readonly 'feedback.status.escalated': "feedback.status.escalated";
+    /** "Auto-resolved" */
+    readonly 'feedback.status.autoResolved': "feedback.status.autoResolved";
+    /** "Input must include ticket" */
+    readonly 'error.inputMustIncludeTicket': "error.inputMustIncludeTicket";
+    /** "Ticket is missing id" */
+    readonly 'error.ticketMissingId': "error.ticketMissingId";
+    /** "resolution and classification are required" */
+    readonly 'error.resolutionClassificationRequired': "error.resolutionClassificationRequired";
+    /** "support_classify_ticket" */
+    readonly 'tool.classify.title': "tool.classify.title";
+    /** "Classify a ticket for priority, sentiment, and category" */
+    readonly 'tool.classify.description': "tool.classify.description";
+    /** "support_resolve_ticket" */
+    readonly 'tool.resolve.title': "tool.resolve.title";
+    /** "Generate a knowledge-grounded resolution for a ticket" */
+    readonly 'tool.resolve.description': "tool.resolve.description";
+    /** "support_draft_response" */
+    readonly 'tool.draft.title': "tool.draft.title";
+    /** "Draft a user-facing reply based on resolution + classification" */
+    readonly 'tool.draft.description': "tool.draft.description";
+    /** "Subject: {subject}" */
+    readonly 'resolver.question.subjectLabel': "resolver.question.subjectLabel";
+    /** "Channel: {channel}" */
+    readonly 'resolver.question.channelLabel': "resolver.question.channelLabel";
+    /** "Customer: {name}" */
+    readonly 'resolver.question.customerLabel': "resolver.question.customerLabel";
+    /** "Escalate for human review" */
+    readonly 'resolver.action.escalate': "resolver.action.escalate";
+    /** "Send automated response" */
+    readonly 'resolver.action.respond': "resolver.action.respond";
+    /** "Insufficient confidence or missing knowledge references" */
+    readonly 'resolver.escalation.insufficientConfidence': "resolver.escalation.insufficientConfidence";
+    /** "We remain available if you need anything else." */
+    readonly 'responder.closing.friendly': "responder.closing.friendly";
+    /** "Please let us know if you require additional assistance." */
+    readonly 'responder.closing.formal': "responder.closing.formal";
+    /** "Hi {name}," */
+    readonly 'responder.greeting.named': "responder.greeting.named";
+    /** "Hi there," */
+    readonly 'responder.greeting.anonymous': "responder.greeting.anonymous";
+    /** 'Thanks for contacting us about "{subject}".' */
+    readonly 'responder.intro.thanks': "responder.intro.thanks";
+    /** "\u2014 ContractSpec Support" */
+    readonly 'responder.signature': "responder.signature";
+    /** "References:" */
+    readonly 'responder.references.header': "responder.references.header";
+    /** "Source {index}" */
+    readonly 'responder.references.sourceLabel': "responder.references.sourceLabel";
+    /** Category intro: billing */
+    readonly 'responder.category.billing': "responder.category.billing";
+    /** Category intro: technical */
+    readonly 'responder.category.technical': "responder.category.technical";
+    /** Category intro: product */
+    readonly 'responder.category.product': "responder.category.product";
+    /** Category intro: account */
+    readonly 'responder.category.account': "responder.category.account";
+    /** Category intro: compliance */
+    readonly 'responder.category.compliance': "responder.category.compliance";
+    /** Category intro: other */
+    readonly 'responder.category.other': "responder.category.other";
+    /** "Re: {subject}" */
+    readonly 'responder.subject.replyPrefix': "responder.subject.replyPrefix";
+    /** Classifier system prompt */
+    readonly 'prompt.classifier.system': "prompt.classifier.system";
+    /** Auto-responder system prompt */
+    readonly 'prompt.autoResponder.system': "prompt.autoResponder.system";
+    /** Auto-responder user prompt template */
+    readonly 'prompt.autoResponder.user': "prompt.autoResponder.user";
+};
+/** Union type of all valid support-bot i18n keys */
+export type SupportBotMessageKey = keyof typeof I18N_KEYS;

package/dist/i18n/keys.js

@@ -0,0 +1,72 @@
+// @bun
+// 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
+};
+export {
+  TOOL_KEYS,
+  SPEC_KEYS,
+  RESPONDER_KEYS,
+  RESOLVER_KEYS,
+  PROMPT_KEYS,
+  I18N_KEYS,
+  FEEDBACK_KEYS,
+  ERROR_KEYS
+};

package/dist/i18n/locale.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Locale utilities for the support-bot package.
+ *
+ * Re-exported from the shared i18n factory in contracts-spec.
+ *
+ * @module i18n/locale
+ */
+export { DEFAULT_LOCALE, SUPPORTED_LOCALES, resolveLocale, isSupportedLocale, type SupportedLocale, } from '@contractspec/lib.contracts-spec/translations';

package/dist/i18n/locale.js

@@ -0,0 +1,14 @@
+// @bun
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+export {
+  resolveLocale,
+  isSupportedLocale,
+  SUPPORTED_LOCALES,
+  DEFAULT_LOCALE
+};

package/dist/i18n/messages.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Translation helper for the support-bot package.
+ * @module i18n/messages
+ */
+import { type I18nInstance } from '@contractspec/lib.contracts-spec/translations';
+import type { SupportBotMessageKey } from './keys';
+export { interpolate } from '@contractspec/lib.contracts-spec/translations';
+/** I18n instance type for the support-bot package. */
+export type SupportBotI18n = I18nInstance<SupportBotMessageKey>;
+/** Create an i18n instance for a given locale. */
+export declare const createSupportBotI18n: (optionsLocale?: string, runtimeLocale?: string) => I18nInstance<"prompt.classifier.system" | "prompt.autoResponder.system" | "prompt.autoResponder.user" | "responder.closing.friendly" | "responder.closing.formal" | "responder.greeting.named" | "responder.greeting.anonymous" | "responder.intro.thanks" | "responder.signature" | "responder.references.header" | "responder.references.sourceLabel" | "responder.category.billing" | "responder.category.technical" | "responder.category.product" | "responder.category.account" | "responder.category.compliance" | "responder.category.other" | "responder.subject.replyPrefix" | "resolver.question.subjectLabel" | "resolver.question.channelLabel" | "resolver.question.customerLabel" | "resolver.action.escalate" | "resolver.action.respond" | "resolver.escalation.insufficientConfidence" | "tool.classify.title" | "tool.classify.description" | "tool.resolve.title" | "tool.resolve.description" | "tool.draft.title" | "tool.draft.description" | "error.inputMustIncludeTicket" | "error.ticketMissingId" | "error.resolutionClassificationRequired" | "feedback.noRecords" | "feedback.status.escalated" | "feedback.status.autoResolved" | "spec.instructionsAppendix">;
+/** Create a default (English) i18n instance. */
+export declare const getDefaultI18n: () => I18nInstance<"prompt.classifier.system" | "prompt.autoResponder.system" | "prompt.autoResponder.user" | "responder.closing.friendly" | "responder.closing.formal" | "responder.greeting.named" | "responder.greeting.anonymous" | "responder.intro.thanks" | "responder.signature" | "responder.references.header" | "responder.references.sourceLabel" | "responder.category.billing" | "responder.category.technical" | "responder.category.product" | "responder.category.account" | "responder.category.compliance" | "responder.category.other" | "responder.subject.replyPrefix" | "resolver.question.subjectLabel" | "resolver.question.channelLabel" | "resolver.question.customerLabel" | "resolver.action.escalate" | "resolver.action.respond" | "resolver.escalation.insufficientConfidence" | "tool.classify.title" | "tool.classify.description" | "tool.resolve.title" | "tool.resolve.description" | "tool.draft.title" | "tool.draft.description" | "error.inputMustIncludeTicket" | "error.ticketMissingId" | "error.resolutionClassificationRequired" | "feedback.noRecords" | "feedback.status.escalated" | "feedback.status.autoResolved" | "spec.instructionsAppendix">;
+/** Reset the shared registry (useful for testing). @internal */
+export declare const resetI18nRegistry: () => void;