@contractspec/example.locale-jurisdiction-gate 3.7.17 → 3.7.19

package/dist/node/policy/index.js

@@ -1,134 +1,2 @@
-// src/policy/guard.ts
-var SUPPORTED_LOCALES = new Set(["en-US", "en-GB", "fr-FR"]);
-function err(code, message) {
-  return { code, message };
-}
-function validateEnvelope(envelope) {
-  if (!envelope.locale || !SUPPORTED_LOCALES.has(envelope.locale)) {
-    return {
-      ok: false,
-      error: err("LOCALE_REQUIRED", "locale is required and must be supported")
-    };
-  }
-  if (!envelope.regulatoryContext?.jurisdiction) {
-    return {
-      ok: false,
-      error: err("JURISDICTION_REQUIRED", "jurisdiction is required")
-    };
-  }
-  if (!envelope.kbSnapshotId) {
-    return {
-      ok: false,
-      error: err("KB_SNAPSHOT_REQUIRED", "kbSnapshotId is required")
-    };
-  }
-  if (!envelope.allowedScope) {
-    return {
-      ok: false,
-      error: err("SCOPE_VIOLATION", "allowedScope is required")
-    };
-  }
-  return { ok: true, value: envelope };
-}
-function enforceCitations(answer) {
-  const citations = answer.citations ?? [];
-  if (!Array.isArray(citations) || citations.length === 0) {
-    return {
-      ok: false,
-      error: err("CITATIONS_REQUIRED", "answers must include at least one citation")
-    };
-  }
-  return { ok: true, value: answer };
-}
-var EDUCATION_ONLY_FORBIDDEN_PATTERNS = [
-  /\b(buy|sell)\b/i,
-  /\b(should\s+buy|should\s+sell)\b/i,
-  /\b(guarantee(d)?|promise(d)?)\b/i
-];
-function enforceAllowedScope(allowedScope, answer) {
-  if (!allowedScope) {
-    return {
-      ok: false,
-      error: err("SCOPE_VIOLATION", "allowedScope is required")
-    };
-  }
-  if (allowedScope !== "education_only") {
-    return { ok: true, value: answer };
-  }
-  const bodies = (answer.sections ?? []).map((s) => s.body).join(`
-`);
-  const violations = EDUCATION_ONLY_FORBIDDEN_PATTERNS.some((re) => re.test(bodies));
-  if (violations) {
-    return {
-      ok: false,
-      error: err("SCOPE_VIOLATION", "answer violates education_only scope (contains actionable or promotional language)")
-    };
-  }
-  return { ok: true, value: answer };
-}
-
-// src/policy/assistant-gate.policy.ts
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec/ownership";
-import { definePolicy } from "@contractspec/lib.contracts-spec/policy";
-var AssistantGatePolicy = definePolicy({
-  meta: {
-    key: "locale-jurisdiction-gate.policy.gate",
-    version: "1.0.0",
-    title: "Assistant Locale and Jurisdiction Gate",
-    description: "Requires explicit locale, jurisdiction, knowledge snapshot, and allowed scope before assistant requests may proceed.",
-    domain: "assistant",
-    scope: "operation",
-    owners: [OwnersEnum.PlatformFinance],
-    tags: [TagsEnum.I18n, "assistant", "policy", "jurisdiction"],
-    stability: StabilityEnum.Experimental
-  },
-  rules: [
-    {
-      effect: "deny",
-      actions: ["assistant.answer", "assistant.explainConcept"],
-      resource: { type: "assistant-call" },
-      conditions: [
-        {
-          expression: "!context.locale || !context.jurisdiction || !context.kbSnapshotId || !context.allowedScope"
-        }
-      ],
-      reason: "Assistant requests fail closed until locale, jurisdiction, kbSnapshotId, and allowedScope are explicit."
-    },
-    {
-      effect: "deny",
-      actions: ["assistant.answer", "assistant.explainConcept"],
-      resource: { type: "assistant-call" },
-      conditions: [
-        {
-          expression: "!['en-US', 'en-GB', 'fr-FR'].includes(context.locale ?? '')"
-        }
-      ],
-      reason: "Only the explicitly reviewed assistant locales are permitted."
-    },
-    {
-      effect: "allow",
-      actions: ["assistant.answer", "assistant.explainConcept"],
-      resource: { type: "assistant-call" },
-      conditions: [
-        {
-          expression: "['en-US', 'en-GB', 'fr-FR'].includes(context.locale ?? '') && !!context.jurisdiction && !!context.kbSnapshotId && !!context.allowedScope"
-        }
-      ],
-      reason: "Explicit context is present, so the request may continue to citation and scope validation."
-    }
-  ],
-  pii: {
-    fields: ["kbSnapshotId"],
-    retentionDays: 30
-  }
-});
-export {
-  validateEnvelope,
-  enforceCitations,
-  enforceAllowedScope,
-  AssistantGatePolicy
-};
+var f=new Set(["en-US","en-GB","fr-FR"]);function t(r,I){return{code:r,message:I}}function u(r){if(!r.locale||!f.has(r.locale))return{ok:!1,error:t("LOCALE_REQUIRED","locale is required and must be supported")};if(!r.regulatoryContext?.jurisdiction)return{ok:!1,error:t("JURISDICTION_REQUIRED","jurisdiction is required")};if(!r.kbSnapshotId)return{ok:!1,error:t("KB_SNAPSHOT_REQUIRED","kbSnapshotId is required")};if(!r.allowedScope)return{ok:!1,error:t("SCOPE_VIOLATION","allowedScope is required")};return{ok:!0,value:r}}function A(r){let I=r.citations??[];if(!Array.isArray(I)||I.length===0)return{ok:!1,error:t("CITATIONS_REQUIRED","answers must include at least one citation")};return{ok:!0,value:r}}var _=[/\b(buy|sell)\b/i,/\b(should\s+buy|should\s+sell)\b/i,/\b(guarantee(d)?|promise(d)?)\b/i];function C(r,I){if(!r)return{ok:!1,error:t("SCOPE_VIOLATION","allowedScope is required")};if(r!=="education_only")return{ok:!0,value:I};let x=(I.sections??[]).map((R)=>R.body).join(`
+`);if(_.some((R)=>R.test(x)))return{ok:!1,error:t("SCOPE_VIOLATION","answer violates education_only scope (contains actionable or promotional language)")};return{ok:!0,value:I}}import{OwnersEnum as E,StabilityEnum as Q,TagsEnum as G}from"@contractspec/lib.contracts-spec/ownership";import{definePolicy as U}from"@contractspec/lib.contracts-spec/policy";var H=U({meta:{key:"locale-jurisdiction-gate.policy.gate",version:"1.0.0",title:"Assistant Locale and Jurisdiction Gate",description:"Requires explicit locale, jurisdiction, knowledge snapshot, and allowed scope before assistant requests may proceed.",domain:"assistant",scope:"operation",owners:[E.PlatformFinance],tags:[G.I18n,"assistant","policy","jurisdiction"],stability:Q.Experimental},rules:[{effect:"deny",actions:["assistant.answer","assistant.explainConcept"],resource:{type:"assistant-call"},conditions:[{expression:"!context.locale || !context.jurisdiction || !context.kbSnapshotId || !context.allowedScope"}],reason:"Assistant requests fail closed until locale, jurisdiction, kbSnapshotId, and allowedScope are explicit."},{effect:"deny",actions:["assistant.answer","assistant.explainConcept"],resource:{type:"assistant-call"},conditions:[{expression:"!['en-US', 'en-GB', 'fr-FR'].includes(context.locale ?? '')"}],reason:"Only the explicitly reviewed assistant locales are permitted."},{effect:"allow",actions:["assistant.answer","assistant.explainConcept"],resource:{type:"assistant-call"},conditions:[{expression:"['en-US', 'en-GB', 'fr-FR'].includes(context.locale ?? '') && !!context.jurisdiction && !!context.kbSnapshotId && !!context.allowedScope"}],reason:"Explicit context is present, so the request may continue to citation and scope validation."}],pii:{fields:["kbSnapshotId"],retentionDays:30}});export{u as validateEnvelope,A as enforceCitations,C as enforceAllowedScope,H as AssistantGatePolicy};

package/dist/node/translations/assistant-gate.en-GB.translation.js

@@ -1,48 +1 @@
-// src/translations/assistant-gate.en-GB.translation.ts
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec/ownership";
-import { defineTranslation } from "@contractspec/lib.contracts-spec/translations/spec";
-var AssistantGateMessagesEnGb = defineTranslation({
-  meta: {
-    key: "locale-jurisdiction-gate.translation.assistant-gate.en-GB",
-    version: "1.0.0",
-    domain: "assistant",
-    description: "British English messages for the assistant locale and jurisdiction gate.",
-    owners: [OwnersEnum.PlatformFinance],
-    stability: StabilityEnum.Experimental,
-    tags: [TagsEnum.I18n, "assistant", "policy"]
-  },
-  locale: "en-GB",
-  fallback: "en-US",
-  messages: {
-    "assistantGate.locale.label": { value: "Locale" },
-    "assistantGate.locale.description": {
-      value: "Select the reviewed locale for the assistant response."
-    },
-    "assistantGate.jurisdiction.label": { value: "Jurisdiction" },
-    "assistantGate.jurisdiction.placeholder": { value: "UK-FCA" },
-    "assistantGate.kbSnapshotId.label": { value: "Knowledge snapshot ID" },
-    "assistantGate.kbSnapshotId.placeholder": {
-      value: "kb_2026_03_20_policy_reviewed"
-    },
-    "assistantGate.allowedScope.label": { value: "Permitted scope" },
-    "assistantGate.allowedScope.educationOnly": {
-      value: "Educational content only"
-    },
-    "assistantGate.allowedScope.genericInfo": { value: "General information" },
-    "assistantGate.allowedScope.escalationRequired": {
-      value: "Escalation required"
-    },
-    "assistantGate.question.label": { value: "Question" },
-    "assistantGate.question.placeholder": {
-      value: "What may I say about this product in the selected jurisdiction?"
-    },
-    "assistantGate.submit.label": { value: "Generate response" }
-  }
-});
-export {
-  AssistantGateMessagesEnGb
-};
+import{OwnersEnum as h,StabilityEnum as j,TagsEnum as k}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as q}from"@contractspec/lib.contracts-spec/translations/spec";var z=q({meta:{key:"locale-jurisdiction-gate.translation.assistant-gate.en-GB",version:"1.0.0",domain:"assistant",description:"British English messages for the assistant locale and jurisdiction gate.",owners:[h.PlatformFinance],stability:j.Experimental,tags:[k.I18n,"assistant","policy"]},locale:"en-GB",fallback:"en-US",messages:{"assistantGate.locale.label":{value:"Locale"},"assistantGate.locale.description":{value:"Select the reviewed locale for the assistant response."},"assistantGate.jurisdiction.label":{value:"Jurisdiction"},"assistantGate.jurisdiction.placeholder":{value:"UK-FCA"},"assistantGate.kbSnapshotId.label":{value:"Knowledge snapshot ID"},"assistantGate.kbSnapshotId.placeholder":{value:"kb_2026_03_20_policy_reviewed"},"assistantGate.allowedScope.label":{value:"Permitted scope"},"assistantGate.allowedScope.educationOnly":{value:"Educational content only"},"assistantGate.allowedScope.genericInfo":{value:"General information"},"assistantGate.allowedScope.escalationRequired":{value:"Escalation required"},"assistantGate.question.label":{value:"Question"},"assistantGate.question.placeholder":{value:"What may I say about this product in the selected jurisdiction?"},"assistantGate.submit.label":{value:"Generate response"}}});export{z as AssistantGateMessagesEnGb};

package/dist/node/translations/assistant-gate.en-US.translation.js

@@ -1,50 +1 @@
-// src/translations/assistant-gate.en-US.translation.ts
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec/ownership";
-import { defineTranslation } from "@contractspec/lib.contracts-spec/translations/spec";
-var AssistantGateMessagesEnUs = defineTranslation({
-  meta: {
-    key: "locale-jurisdiction-gate.translation.assistant-gate.en-US",
-    version: "1.0.0",
-    domain: "assistant",
-    description: "US English messages for the assistant locale and jurisdiction gate.",
-    owners: [OwnersEnum.PlatformFinance],
-    stability: StabilityEnum.Experimental,
-    tags: [TagsEnum.I18n, "assistant", "policy"]
-  },
-  locale: "en-US",
-  messages: {
-    "assistantGate.locale.label": { value: "Locale" },
-    "assistantGate.locale.description": {
-      value: "Choose the reviewed locale for the assistant answer."
-    },
-    "assistantGate.locale.enUs": { value: "English (United States)" },
-    "assistantGate.locale.enGb": { value: "English (United Kingdom)" },
-    "assistantGate.locale.frFr": { value: "French (France)" },
-    "assistantGate.jurisdiction.label": { value: "Jurisdiction" },
-    "assistantGate.jurisdiction.placeholder": { value: "US-SEC" },
-    "assistantGate.kbSnapshotId.label": { value: "Knowledge snapshot ID" },
-    "assistantGate.kbSnapshotId.placeholder": {
-      value: "kb_2026_03_20_policy_reviewed"
-    },
-    "assistantGate.allowedScope.label": { value: "Allowed scope" },
-    "assistantGate.allowedScope.educationOnly": {
-      value: "Educational content only"
-    },
-    "assistantGate.allowedScope.genericInfo": { value: "Generic information" },
-    "assistantGate.allowedScope.escalationRequired": {
-      value: "Escalation required"
-    },
-    "assistantGate.question.label": { value: "Question" },
-    "assistantGate.question.placeholder": {
-      value: "What can I say about this product in the selected jurisdiction?"
-    },
-    "assistantGate.submit.label": { value: "Generate answer" }
-  }
-});
-export {
-  AssistantGateMessagesEnUs
-};
+import{OwnersEnum as h,StabilityEnum as j,TagsEnum as k}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as q}from"@contractspec/lib.contracts-spec/translations/spec";var z=q({meta:{key:"locale-jurisdiction-gate.translation.assistant-gate.en-US",version:"1.0.0",domain:"assistant",description:"US English messages for the assistant locale and jurisdiction gate.",owners:[h.PlatformFinance],stability:j.Experimental,tags:[k.I18n,"assistant","policy"]},locale:"en-US",messages:{"assistantGate.locale.label":{value:"Locale"},"assistantGate.locale.description":{value:"Choose the reviewed locale for the assistant answer."},"assistantGate.locale.enUs":{value:"English (United States)"},"assistantGate.locale.enGb":{value:"English (United Kingdom)"},"assistantGate.locale.frFr":{value:"French (France)"},"assistantGate.jurisdiction.label":{value:"Jurisdiction"},"assistantGate.jurisdiction.placeholder":{value:"US-SEC"},"assistantGate.kbSnapshotId.label":{value:"Knowledge snapshot ID"},"assistantGate.kbSnapshotId.placeholder":{value:"kb_2026_03_20_policy_reviewed"},"assistantGate.allowedScope.label":{value:"Allowed scope"},"assistantGate.allowedScope.educationOnly":{value:"Educational content only"},"assistantGate.allowedScope.genericInfo":{value:"Generic information"},"assistantGate.allowedScope.escalationRequired":{value:"Escalation required"},"assistantGate.question.label":{value:"Question"},"assistantGate.question.placeholder":{value:"What can I say about this product in the selected jurisdiction?"},"assistantGate.submit.label":{value:"Generate answer"}}});export{z as AssistantGateMessagesEnUs};

package/dist/node/translations/assistant-gate.fr-FR.translation.js

@@ -1,52 +1 @@
-// src/translations/assistant-gate.fr-FR.translation.ts
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec/ownership";
-import { defineTranslation } from "@contractspec/lib.contracts-spec/translations/spec";
-var AssistantGateMessagesFrFr = defineTranslation({
-  meta: {
-    key: "locale-jurisdiction-gate.translation.assistant-gate.fr-FR",
-    version: "1.0.0",
-    domain: "assistant",
-    description: "French messages for the assistant locale and jurisdiction gate.",
-    owners: [OwnersEnum.PlatformFinance],
-    stability: StabilityEnum.Experimental,
-    tags: [TagsEnum.I18n, "assistant", "policy"]
-  },
-  locale: "fr-FR",
-  fallback: "en-US",
-  messages: {
-    "assistantGate.locale.label": { value: "Langue" },
-    "assistantGate.locale.description": {
-      value: "Sélectionnez la langue validée pour la réponse de l'assistant."
-    },
-    "assistantGate.jurisdiction.label": { value: "Juridiction" },
-    "assistantGate.jurisdiction.placeholder": { value: "FR-AMF" },
-    "assistantGate.kbSnapshotId.label": {
-      value: "Identifiant du snapshot documentaire"
-    },
-    "assistantGate.kbSnapshotId.placeholder": {
-      value: "kb_2026_03_20_policy_reviewed"
-    },
-    "assistantGate.allowedScope.label": { value: "Périmètre autorisé" },
-    "assistantGate.allowedScope.educationOnly": {
-      value: "Contenu éducatif uniquement"
-    },
-    "assistantGate.allowedScope.genericInfo": {
-      value: "Information générale"
-    },
-    "assistantGate.allowedScope.escalationRequired": {
-      value: "Escalade obligatoire"
-    },
-    "assistantGate.question.label": { value: "Question" },
-    "assistantGate.question.placeholder": {
-      value: "Que puis-je dire sur ce produit dans la juridiction sélectionnée ?"
-    },
-    "assistantGate.submit.label": { value: "Générer la réponse" }
-  }
-});
-export {
-  AssistantGateMessagesFrFr
-};
+import{OwnersEnum as h,StabilityEnum as j,TagsEnum as k}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as q}from"@contractspec/lib.contracts-spec/translations/spec";var z=q({meta:{key:"locale-jurisdiction-gate.translation.assistant-gate.fr-FR",version:"1.0.0",domain:"assistant",description:"French messages for the assistant locale and jurisdiction gate.",owners:[h.PlatformFinance],stability:j.Experimental,tags:[k.I18n,"assistant","policy"]},locale:"fr-FR",fallback:"en-US",messages:{"assistantGate.locale.label":{value:"Langue"},"assistantGate.locale.description":{value:"Sélectionnez la langue validée pour la réponse de l'assistant."},"assistantGate.jurisdiction.label":{value:"Juridiction"},"assistantGate.jurisdiction.placeholder":{value:"FR-AMF"},"assistantGate.kbSnapshotId.label":{value:"Identifiant du snapshot documentaire"},"assistantGate.kbSnapshotId.placeholder":{value:"kb_2026_03_20_policy_reviewed"},"assistantGate.allowedScope.label":{value:"Périmètre autorisé"},"assistantGate.allowedScope.educationOnly":{value:"Contenu éducatif uniquement"},"assistantGate.allowedScope.genericInfo":{value:"Information générale"},"assistantGate.allowedScope.escalationRequired":{value:"Escalade obligatoire"},"assistantGate.question.label":{value:"Question"},"assistantGate.question.placeholder":{value:"Que puis-je dire sur ce produit dans la juridiction sélectionnée ?"},"assistantGate.submit.label":{value:"Générer la réponse"}}});export{z as AssistantGateMessagesFrFr};

package/dist/node/translations/index.js

@@ -1,148 +1 @@
-// src/translations/assistant-gate.en-GB.translation.ts
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec/ownership";
-import { defineTranslation } from "@contractspec/lib.contracts-spec/translations/spec";
-var AssistantGateMessagesEnGb = defineTranslation({
-  meta: {
-    key: "locale-jurisdiction-gate.translation.assistant-gate.en-GB",
-    version: "1.0.0",
-    domain: "assistant",
-    description: "British English messages for the assistant locale and jurisdiction gate.",
-    owners: [OwnersEnum.PlatformFinance],
-    stability: StabilityEnum.Experimental,
-    tags: [TagsEnum.I18n, "assistant", "policy"]
-  },
-  locale: "en-GB",
-  fallback: "en-US",
-  messages: {
-    "assistantGate.locale.label": { value: "Locale" },
-    "assistantGate.locale.description": {
-      value: "Select the reviewed locale for the assistant response."
-    },
-    "assistantGate.jurisdiction.label": { value: "Jurisdiction" },
-    "assistantGate.jurisdiction.placeholder": { value: "UK-FCA" },
-    "assistantGate.kbSnapshotId.label": { value: "Knowledge snapshot ID" },
-    "assistantGate.kbSnapshotId.placeholder": {
-      value: "kb_2026_03_20_policy_reviewed"
-    },
-    "assistantGate.allowedScope.label": { value: "Permitted scope" },
-    "assistantGate.allowedScope.educationOnly": {
-      value: "Educational content only"
-    },
-    "assistantGate.allowedScope.genericInfo": { value: "General information" },
-    "assistantGate.allowedScope.escalationRequired": {
-      value: "Escalation required"
-    },
-    "assistantGate.question.label": { value: "Question" },
-    "assistantGate.question.placeholder": {
-      value: "What may I say about this product in the selected jurisdiction?"
-    },
-    "assistantGate.submit.label": { value: "Generate response" }
-  }
-});
-
-// src/translations/assistant-gate.en-US.translation.ts
-import {
-  OwnersEnum as OwnersEnum2,
-  StabilityEnum as StabilityEnum2,
-  TagsEnum as TagsEnum2
-} from "@contractspec/lib.contracts-spec/ownership";
-import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations/spec";
-var AssistantGateMessagesEnUs = defineTranslation2({
-  meta: {
-    key: "locale-jurisdiction-gate.translation.assistant-gate.en-US",
-    version: "1.0.0",
-    domain: "assistant",
-    description: "US English messages for the assistant locale and jurisdiction gate.",
-    owners: [OwnersEnum2.PlatformFinance],
-    stability: StabilityEnum2.Experimental,
-    tags: [TagsEnum2.I18n, "assistant", "policy"]
-  },
-  locale: "en-US",
-  messages: {
-    "assistantGate.locale.label": { value: "Locale" },
-    "assistantGate.locale.description": {
-      value: "Choose the reviewed locale for the assistant answer."
-    },
-    "assistantGate.locale.enUs": { value: "English (United States)" },
-    "assistantGate.locale.enGb": { value: "English (United Kingdom)" },
-    "assistantGate.locale.frFr": { value: "French (France)" },
-    "assistantGate.jurisdiction.label": { value: "Jurisdiction" },
-    "assistantGate.jurisdiction.placeholder": { value: "US-SEC" },
-    "assistantGate.kbSnapshotId.label": { value: "Knowledge snapshot ID" },
-    "assistantGate.kbSnapshotId.placeholder": {
-      value: "kb_2026_03_20_policy_reviewed"
-    },
-    "assistantGate.allowedScope.label": { value: "Allowed scope" },
-    "assistantGate.allowedScope.educationOnly": {
-      value: "Educational content only"
-    },
-    "assistantGate.allowedScope.genericInfo": { value: "Generic information" },
-    "assistantGate.allowedScope.escalationRequired": {
-      value: "Escalation required"
-    },
-    "assistantGate.question.label": { value: "Question" },
-    "assistantGate.question.placeholder": {
-      value: "What can I say about this product in the selected jurisdiction?"
-    },
-    "assistantGate.submit.label": { value: "Generate answer" }
-  }
-});
-
-// src/translations/assistant-gate.fr-FR.translation.ts
-import {
-  OwnersEnum as OwnersEnum3,
-  StabilityEnum as StabilityEnum3,
-  TagsEnum as TagsEnum3
-} from "@contractspec/lib.contracts-spec/ownership";
-import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations/spec";
-var AssistantGateMessagesFrFr = defineTranslation3({
-  meta: {
-    key: "locale-jurisdiction-gate.translation.assistant-gate.fr-FR",
-    version: "1.0.0",
-    domain: "assistant",
-    description: "French messages for the assistant locale and jurisdiction gate.",
-    owners: [OwnersEnum3.PlatformFinance],
-    stability: StabilityEnum3.Experimental,
-    tags: [TagsEnum3.I18n, "assistant", "policy"]
-  },
-  locale: "fr-FR",
-  fallback: "en-US",
-  messages: {
-    "assistantGate.locale.label": { value: "Langue" },
-    "assistantGate.locale.description": {
-      value: "Sélectionnez la langue validée pour la réponse de l'assistant."
-    },
-    "assistantGate.jurisdiction.label": { value: "Juridiction" },
-    "assistantGate.jurisdiction.placeholder": { value: "FR-AMF" },
-    "assistantGate.kbSnapshotId.label": {
-      value: "Identifiant du snapshot documentaire"
-    },
-    "assistantGate.kbSnapshotId.placeholder": {
-      value: "kb_2026_03_20_policy_reviewed"
-    },
-    "assistantGate.allowedScope.label": { value: "Périmètre autorisé" },
-    "assistantGate.allowedScope.educationOnly": {
-      value: "Contenu éducatif uniquement"
-    },
-    "assistantGate.allowedScope.genericInfo": {
-      value: "Information générale"
-    },
-    "assistantGate.allowedScope.escalationRequired": {
-      value: "Escalade obligatoire"
-    },
-    "assistantGate.question.label": { value: "Question" },
-    "assistantGate.question.placeholder": {
-      value: "Que puis-je dire sur ce produit dans la juridiction sélectionnée ?"
-    },
-    "assistantGate.submit.label": { value: "Générer la réponse" }
-  }
-});
-export {
-  AssistantGateMessagesFrFr,
-  AssistantGateMessagesEnUs,
-  AssistantGateMessagesEnGb
-};
+import{OwnersEnum as h,StabilityEnum as j,TagsEnum as k}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as q}from"@contractspec/lib.contracts-spec/translations/spec";var J=q({meta:{key:"locale-jurisdiction-gate.translation.assistant-gate.en-GB",version:"1.0.0",domain:"assistant",description:"British English messages for the assistant locale and jurisdiction gate.",owners:[h.PlatformFinance],stability:j.Experimental,tags:[k.I18n,"assistant","policy"]},locale:"en-GB",fallback:"en-US",messages:{"assistantGate.locale.label":{value:"Locale"},"assistantGate.locale.description":{value:"Select the reviewed locale for the assistant response."},"assistantGate.jurisdiction.label":{value:"Jurisdiction"},"assistantGate.jurisdiction.placeholder":{value:"UK-FCA"},"assistantGate.kbSnapshotId.label":{value:"Knowledge snapshot ID"},"assistantGate.kbSnapshotId.placeholder":{value:"kb_2026_03_20_policy_reviewed"},"assistantGate.allowedScope.label":{value:"Permitted scope"},"assistantGate.allowedScope.educationOnly":{value:"Educational content only"},"assistantGate.allowedScope.genericInfo":{value:"General information"},"assistantGate.allowedScope.escalationRequired":{value:"Escalation required"},"assistantGate.question.label":{value:"Question"},"assistantGate.question.placeholder":{value:"What may I say about this product in the selected jurisdiction?"},"assistantGate.submit.label":{value:"Generate response"}}});import{OwnersEnum as v,StabilityEnum as x,TagsEnum as z}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as A}from"@contractspec/lib.contracts-spec/translations/spec";var N=A({meta:{key:"locale-jurisdiction-gate.translation.assistant-gate.en-US",version:"1.0.0",domain:"assistant",description:"US English messages for the assistant locale and jurisdiction gate.",owners:[v.PlatformFinance],stability:x.Experimental,tags:[z.I18n,"assistant","policy"]},locale:"en-US",messages:{"assistantGate.locale.label":{value:"Locale"},"assistantGate.locale.description":{value:"Choose the reviewed locale for the assistant answer."},"assistantGate.locale.enUs":{value:"English (United States)"},"assistantGate.locale.enGb":{value:"English (United Kingdom)"},"assistantGate.locale.frFr":{value:"French (France)"},"assistantGate.jurisdiction.label":{value:"Jurisdiction"},"assistantGate.jurisdiction.placeholder":{value:"US-SEC"},"assistantGate.kbSnapshotId.label":{value:"Knowledge snapshot ID"},"assistantGate.kbSnapshotId.placeholder":{value:"kb_2026_03_20_policy_reviewed"},"assistantGate.allowedScope.label":{value:"Allowed scope"},"assistantGate.allowedScope.educationOnly":{value:"Educational content only"},"assistantGate.allowedScope.genericInfo":{value:"Generic information"},"assistantGate.allowedScope.escalationRequired":{value:"Escalation required"},"assistantGate.question.label":{value:"Question"},"assistantGate.question.placeholder":{value:"What can I say about this product in the selected jurisdiction?"},"assistantGate.submit.label":{value:"Generate answer"}}});import{OwnersEnum as B,StabilityEnum as C,TagsEnum as D}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as G}from"@contractspec/lib.contracts-spec/translations/spec";var V=G({meta:{key:"locale-jurisdiction-gate.translation.assistant-gate.fr-FR",version:"1.0.0",domain:"assistant",description:"French messages for the assistant locale and jurisdiction gate.",owners:[B.PlatformFinance],stability:C.Experimental,tags:[D.I18n,"assistant","policy"]},locale:"fr-FR",fallback:"en-US",messages:{"assistantGate.locale.label":{value:"Langue"},"assistantGate.locale.description":{value:"Sélectionnez la langue validée pour la réponse de l'assistant."},"assistantGate.jurisdiction.label":{value:"Juridiction"},"assistantGate.jurisdiction.placeholder":{value:"FR-AMF"},"assistantGate.kbSnapshotId.label":{value:"Identifiant du snapshot documentaire"},"assistantGate.kbSnapshotId.placeholder":{value:"kb_2026_03_20_policy_reviewed"},"assistantGate.allowedScope.label":{value:"Périmètre autorisé"},"assistantGate.allowedScope.educationOnly":{value:"Contenu éducatif uniquement"},"assistantGate.allowedScope.genericInfo":{value:"Information générale"},"assistantGate.allowedScope.escalationRequired":{value:"Escalade obligatoire"},"assistantGate.question.label":{value:"Question"},"assistantGate.question.placeholder":{value:"Que puis-je dire sur ce produit dans la juridiction sélectionnée ?"},"assistantGate.submit.label":{value:"Générer la réponse"}}});export{V as AssistantGateMessagesFrFr,N as AssistantGateMessagesEnUs,J as AssistantGateMessagesEnGb};

package/dist/operations/assistant.js

@@ -1,193 +1,2 @@
 // @bun
-// src/entities/models.ts
-import {
-  defineEnum,
-  defineSchemaModel,
-  ScalarTypeEnum
-} from "@contractspec/lib.schema";
-var AllowedScopeEnum = defineEnum("AllowedScope", [
-  "education_only",
-  "generic_info",
-  "escalation_required"
-]);
-var UserProfileModel = defineSchemaModel({
-  name: "UserProfile",
-  description: "User profile inputs used to derive regulatory context.",
-  fields: {
-    preferredLocale: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: true
-    },
-    residencyCountry: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: true
-    },
-    taxResidenceCountry: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: true
-    },
-    clientType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var RegulatoryContextModel = defineSchemaModel({
-  name: "RegulatoryContext",
-  description: "Explicit regulatory context (no guessing).",
-  fields: {
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    region: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    clientType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    allowedScope: { type: AllowedScopeEnum, isOptional: false }
-  }
-});
-var LLMCallEnvelopeModel = defineSchemaModel({
-  name: "LLMCallEnvelope",
-  description: "Mandatory envelope for assistant calls. All fields are explicit and required for policy gating.",
-  fields: {
-    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    regulatoryContext: { type: RegulatoryContextModel, isOptional: false },
-    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    allowedScope: { type: AllowedScopeEnum, isOptional: false }
-  }
-});
-var AssistantCitationModel = defineSchemaModel({
-  name: "AssistantCitation",
-  description: "Citation referencing a KB snapshot + a specific item within it.",
-  fields: {
-    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    sourceType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    sourceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var AssistantAnswerSectionModel = defineSchemaModel({
-  name: "AssistantAnswerSection",
-  description: "Structured answer section.",
-  fields: {
-    heading: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    body: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var AssistantAnswerIRModel = defineSchemaModel({
-  name: "AssistantAnswerIR",
-  description: "Structured assistant answer with mandatory citations and explicit locale/jurisdiction.",
-  fields: {
-    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    allowedScope: { type: AllowedScopeEnum, isOptional: false },
-    sections: {
-      type: AssistantAnswerSectionModel,
-      isArray: true,
-      isOptional: false
-    },
-    citations: {
-      type: AssistantCitationModel,
-      isArray: true,
-      isOptional: false
-    },
-    disclaimers: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    },
-    riskFlags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    },
-    refused: { type: ScalarTypeEnum.Boolean(), isOptional: true },
-    refusalReason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-
-// src/operations/assistant.ts
-import { defineCommand } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var AssistantQuestionInput = defineSchemaModel2({
-  name: "AssistantQuestionInput",
-  description: "Input for assistant calls with mandatory envelope.",
-  fields: {
-    envelope: { type: LLMCallEnvelopeModel, isOptional: false },
-    question: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var AssistantConceptInput = defineSchemaModel2({
-  name: "AssistantConceptInput",
-  description: "Input for explaining a concept with mandatory envelope.",
-  fields: {
-    envelope: { type: LLMCallEnvelopeModel, isOptional: false },
-    conceptKey: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var AssistantAnswerContract = defineCommand({
-  meta: {
-    key: "assistant.answer",
-    version: "1.0.0",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["assistant", "policy", "locale", "jurisdiction", "knowledge"],
-    description: "Answer a user question using a KB snapshot with strict locale/jurisdiction gating.",
-    goal: "Provide policy-safe answers that cite a KB snapshot or refuse.",
-    context: "Called by UI or workflows; must fail-closed if envelope is invalid or citations are missing."
-  },
-  io: {
-    input: AssistantQuestionInput,
-    output: AssistantAnswerIRModel,
-    errors: {
-      LOCALE_REQUIRED: {
-        description: "Locale is required and must be supported",
-        http: 400,
-        gqlCode: "LOCALE_REQUIRED",
-        when: "locale is missing or unsupported"
-      },
-      JURISDICTION_REQUIRED: {
-        description: "Jurisdiction is required",
-        http: 400,
-        gqlCode: "JURISDICTION_REQUIRED",
-        when: "jurisdiction is missing"
-      },
-      KB_SNAPSHOT_REQUIRED: {
-        description: "KB snapshot id is required",
-        http: 400,
-        gqlCode: "KB_SNAPSHOT_REQUIRED",
-        when: "kbSnapshotId is missing"
-      },
-      CITATIONS_REQUIRED: {
-        description: "Answers must include citations to a KB snapshot",
-        http: 422,
-        gqlCode: "CITATIONS_REQUIRED",
-        when: "answer has no citations"
-      },
-      SCOPE_VIOLATION: {
-        description: "Answer violates allowed scope and must be refused/escalated",
-        http: 403,
-        gqlCode: "SCOPE_VIOLATION",
-        when: "output includes forbidden content under the given allowedScope"
-      }
-    }
-  },
-  policy: { auth: "user" }
-});
-var AssistantExplainConceptContract = defineCommand({
-  meta: {
-    key: "assistant.explainConcept",
-    version: "1.0.0",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["assistant", "policy", "knowledge", "concepts"],
-    description: "Explain a concept using a KB snapshot with strict locale/jurisdiction gating.",
-    goal: "Explain concepts with citations or refuse.",
-    context: "Same constraints as assistant.answer."
-  },
-  io: {
-    input: AssistantConceptInput,
-    output: AssistantAnswerIRModel,
-    errors: AssistantAnswerContract.io.errors
-  },
-  policy: { auth: "user" }
-});
-export {
-  AssistantExplainConceptContract,
-  AssistantAnswerContract
-};
+import{defineEnum as l,defineSchemaModel as t,ScalarTypeEnum as e}from"@contractspec/lib.schema";var i=l("AllowedScope",["education_only","generic_info","escalation_required"]),S=t({name:"UserProfile",description:"User profile inputs used to derive regulatory context.",fields:{preferredLocale:{type:e.String_unsecure(),isOptional:!0},residencyCountry:{type:e.String_unsecure(),isOptional:!0},taxResidenceCountry:{type:e.String_unsecure(),isOptional:!0},clientType:{type:e.String_unsecure(),isOptional:!0}}}),p=t({name:"RegulatoryContext",description:"Explicit regulatory context (no guessing).",fields:{jurisdiction:{type:e.String_unsecure(),isOptional:!1},region:{type:e.String_unsecure(),isOptional:!0},clientType:{type:e.String_unsecure(),isOptional:!0},allowedScope:{type:i,isOptional:!1}}}),n=t({name:"LLMCallEnvelope",description:"Mandatory envelope for assistant calls. All fields are explicit and required for policy gating.",fields:{traceId:{type:e.String_unsecure(),isOptional:!1},locale:{type:e.String_unsecure(),isOptional:!1},regulatoryContext:{type:p,isOptional:!1},kbSnapshotId:{type:e.String_unsecure(),isOptional:!1},allowedScope:{type:i,isOptional:!1}}}),u=t({name:"AssistantCitation",description:"Citation referencing a KB snapshot + a specific item within it.",fields:{kbSnapshotId:{type:e.String_unsecure(),isOptional:!1},sourceType:{type:e.String_unsecure(),isOptional:!1},sourceId:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!0},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),c=t({name:"AssistantAnswerSection",description:"Structured answer section.",fields:{heading:{type:e.String_unsecure(),isOptional:!1},body:{type:e.String_unsecure(),isOptional:!1}}}),r=t({name:"AssistantAnswerIR",description:"Structured assistant answer with mandatory citations and explicit locale/jurisdiction.",fields:{locale:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},allowedScope:{type:i,isOptional:!1},sections:{type:c,isArray:!0,isOptional:!1},citations:{type:u,isArray:!0,isOptional:!1},disclaimers:{type:e.String_unsecure(),isArray:!0,isOptional:!0},riskFlags:{type:e.String_unsecure(),isArray:!0,isOptional:!0},refused:{type:e.Boolean(),isOptional:!0},refusalReason:{type:e.String_unsecure(),isOptional:!0}}});import{defineCommand as s}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as o,ScalarTypeEnum as a}from"@contractspec/lib.schema";var y=o({name:"AssistantQuestionInput",description:"Input for assistant calls with mandatory envelope.",fields:{envelope:{type:n,isOptional:!1},question:{type:a.String_unsecure(),isOptional:!1}}}),d=o({name:"AssistantConceptInput",description:"Input for explaining a concept with mandatory envelope.",fields:{envelope:{type:n,isOptional:!1},conceptKey:{type:a.String_unsecure(),isOptional:!1}}}),g=s({meta:{key:"assistant.answer",version:"1.0.0",stability:"experimental",owners:["@examples"],tags:["assistant","policy","locale","jurisdiction","knowledge"],description:"Answer a user question using a KB snapshot with strict locale/jurisdiction gating.",goal:"Provide policy-safe answers that cite a KB snapshot or refuse.",context:"Called by UI or workflows; must fail-closed if envelope is invalid or citations are missing."},io:{input:y,output:r,errors:{LOCALE_REQUIRED:{description:"Locale is required and must be supported",http:400,gqlCode:"LOCALE_REQUIRED",when:"locale is missing or unsupported"},JURISDICTION_REQUIRED:{description:"Jurisdiction is required",http:400,gqlCode:"JURISDICTION_REQUIRED",when:"jurisdiction is missing"},KB_SNAPSHOT_REQUIRED:{description:"KB snapshot id is required",http:400,gqlCode:"KB_SNAPSHOT_REQUIRED",when:"kbSnapshotId is missing"},CITATIONS_REQUIRED:{description:"Answers must include citations to a KB snapshot",http:422,gqlCode:"CITATIONS_REQUIRED",when:"answer has no citations"},SCOPE_VIOLATION:{description:"Answer violates allowed scope and must be refused/escalated",http:403,gqlCode:"SCOPE_VIOLATION",when:"output includes forbidden content under the given allowedScope"}}},policy:{auth:"user"}}),A=s({meta:{key:"assistant.explainConcept",version:"1.0.0",stability:"experimental",owners:["@examples"],tags:["assistant","policy","knowledge","concepts"],description:"Explain a concept using a KB snapshot with strict locale/jurisdiction gating.",goal:"Explain concepts with citations or refuse.",context:"Same constraints as assistant.answer."},io:{input:d,output:r,errors:g.io.errors},policy:{auth:"user"}});export{A as AssistantExplainConceptContract,g as AssistantAnswerContract};