@contractspec/example.locale-jurisdiction-gate 3.7.7 → 3.7.10

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

@@ -0,0 +1,50 @@
+// 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
+};

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

@@ -0,0 +1,52 @@
+// 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
+};

package/dist/browser/translations/index.js

@@ -0,0 +1,148 @@
+// 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
+};

package/dist/contracts.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/forms/assistant-context.form.d.ts

@@ -0,0 +1,22 @@
+export declare const AssistantContextForm: import("@contractspec/lib.contracts-spec").FormSpec<import("@contractspec/lib.schema").SchemaModel<{
+    locale: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    jurisdiction: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    kbSnapshotId: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    allowedScope: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string]>;
+        isOptional: false;
+    };
+    question: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>>;

package/dist/forms/assistant-context.form.js

@@ -0,0 +1,214 @@
+// @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/forms/assistant-context.form.ts
+import { defineFormSpec } from "@contractspec/lib.contracts-spec/forms";
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
+var AssistantContextFormModel = defineSchemaModel2({
+  name: "AssistantContextFormModel",
+  description: "Form values required before a policy-gated assistant request can be executed.",
+  fields: {
+    locale: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    kbSnapshotId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false },
+    question: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
+  }
+});
+var AssistantContextForm = defineFormSpec({
+  meta: {
+    key: "locale-jurisdiction-gate.form.assistant-context",
+    version: "1.0.0",
+    title: "Assistant Context Gate",
+    description: "Collects the explicit locale, jurisdiction, scope, and knowledge snapshot required by the assistant gate.",
+    domain: "assistant",
+    owners: [OwnersEnum.PlatformFinance],
+    tags: [TagsEnum.I18n, "assistant", "form", "policy"],
+    stability: StabilityEnum.Experimental
+  },
+  model: AssistantContextFormModel,
+  fields: [
+    {
+      kind: "select",
+      name: "locale",
+      labelI18n: "assistantGate.locale.label",
+      descriptionI18n: "assistantGate.locale.description",
+      options: {
+        kind: "static",
+        options: [
+          { labelI18n: "assistantGate.locale.enUs", value: "en-US" },
+          { labelI18n: "assistantGate.locale.enGb", value: "en-GB" },
+          { labelI18n: "assistantGate.locale.frFr", value: "fr-FR" }
+        ]
+      },
+      required: true
+    },
+    {
+      kind: "text",
+      name: "jurisdiction",
+      labelI18n: "assistantGate.jurisdiction.label",
+      placeholderI18n: "assistantGate.jurisdiction.placeholder",
+      required: true
+    },
+    {
+      kind: "text",
+      name: "kbSnapshotId",
+      labelI18n: "assistantGate.kbSnapshotId.label",
+      placeholderI18n: "assistantGate.kbSnapshotId.placeholder",
+      required: true
+    },
+    {
+      kind: "radio",
+      name: "allowedScope",
+      labelI18n: "assistantGate.allowedScope.label",
+      options: {
+        kind: "static",
+        options: [
+          {
+            labelI18n: "assistantGate.allowedScope.educationOnly",
+            value: "education_only"
+          },
+          {
+            labelI18n: "assistantGate.allowedScope.genericInfo",
+            value: "generic_info"
+          },
+          {
+            labelI18n: "assistantGate.allowedScope.escalationRequired",
+            value: "escalation_required"
+          }
+        ]
+      },
+      required: true
+    },
+    {
+      kind: "textarea",
+      name: "question",
+      labelI18n: "assistantGate.question.label",
+      placeholderI18n: "assistantGate.question.placeholder",
+      required: true
+    }
+  ],
+  actions: [
+    {
+      key: "submit",
+      labelI18n: "assistantGate.submit.label",
+      op: { name: "assistant.answer", version: "1.0.0" }
+    }
+  ],
+  policy: {
+    flags: [],
+    pii: ["kbSnapshotId", "question"]
+  },
+  renderHints: {
+    ui: "custom",
+    form: "react-hook-form"
+  }
+});
+export {
+  AssistantContextForm
+};

package/dist/forms/index.d.ts

@@ -0,0 +1 @@
+export * from './assistant-context.form';