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

package/dist/browser/index.js

@@ -1,32 +1,11 @@
-// src/docs/locale-jurisdiction-gate.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var docBlocks = [
-  {
-    id: "docs.examples.locale-jurisdiction-gate.goal",
-    title: "Locale/Jurisdiction Gate — Goal",
-    summary: "Fail-closed gate that forces locale + jurisdiction + kbSnapshotId + allowedScope for assistant calls.",
-    kind: "goal",
-    visibility: "public",
-    route: "/docs/examples/locale-jurisdiction-gate/goal",
-    tags: ["assistant", "policy", "locale", "jurisdiction", "knowledge"],
-    body: `## Why it matters
+import{registerDocBlocks as H}from"@contractspec/lib.contracts-spec/docs";var J=[{id:"docs.examples.locale-jurisdiction-gate.goal",title:"Locale/Jurisdiction Gate — Goal",summary:"Fail-closed gate that forces locale + jurisdiction + kbSnapshotId + allowedScope for assistant calls.",kind:"goal",visibility:"public",route:"/docs/examples/locale-jurisdiction-gate/goal",tags:["assistant","policy","locale","jurisdiction","knowledge"],body:`## Why it matters
 - Forces all assistant behavior to be bound to explicit inputs (no guessing).
 - Requires KB snapshot citations to make answers traceable and regenerable.
 
 ## Guardrails
 - Missing locale/jurisdiction/snapshot/scope => refuse (structured).
 - Missing citations => refuse.
-- Scope violations under education_only => refuse/escalate.`
-  },
-  {
-    id: "docs.examples.locale-jurisdiction-gate.reference",
-    title: "Locale/Jurisdiction Gate — Reference",
-    summary: "Contracts, models, and events exposed by the gate example.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/examples/locale-jurisdiction-gate",
-    tags: ["assistant", "policy", "reference"],
-    body: `## Contracts
+- Scope violations under education_only => refuse/escalate.`},{id:"docs.examples.locale-jurisdiction-gate.reference",title:"Locale/Jurisdiction Gate — Reference",summary:"Contracts, models, and events exposed by the gate example.",kind:"reference",visibility:"public",route:"/docs/examples/locale-jurisdiction-gate",tags:["assistant","policy","reference"],body:`## Contracts
 - assistant.answer (v1)
 - assistant.explainConcept (v1)
 
@@ -37,824 +16,5 @@ var docBlocks = [
 ## Events
 - assistant.answer.requested
 - assistant.answer.blocked
-- assistant.answer.delivered`
-  }
-];
-registerDocBlocks(docBlocks);
-// 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/events.ts
-import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var AssistantAnswerRequestedPayload = defineSchemaModel2({
-  name: "AssistantAnswerRequestedPayload",
-  description: "Emitted when an assistant answer is requested (pre-gate).",
-  fields: {
-    traceId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    locale: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    kbSnapshotId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    allowedScope: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var AssistantAnswerRequestedEvent = defineEvent({
-  meta: {
-    key: "assistant.answer.requested",
-    version: "1.0.0",
-    description: "Assistant answer requested (policy gate will run).",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["assistant", "policy"]
-  },
-  payload: AssistantAnswerRequestedPayload
-});
-var AssistantAnswerBlockedPayload = defineSchemaModel2({
-  name: "AssistantAnswerBlockedPayload",
-  description: "Emitted when a request is blocked by the gate.",
-  fields: {
-    traceId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    reasonCode: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    reason: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-  }
-});
-var AssistantAnswerBlockedEvent = defineEvent({
-  meta: {
-    key: "assistant.answer.blocked",
-    version: "1.0.0",
-    description: "Assistant answer blocked (fail-closed).",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["assistant", "policy", "blocked"]
-  },
-  payload: AssistantAnswerBlockedPayload
-});
-var AssistantAnswerDeliveredPayload = defineSchemaModel2({
-  name: "AssistantAnswerDeliveredPayload",
-  description: "Emitted when a structured, cited answer is delivered.",
-  fields: {
-    traceId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    locale: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    kbSnapshotId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    allowedScope: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    citationsCount: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false }
-  }
-});
-var AssistantAnswerDeliveredEvent = defineEvent({
-  meta: {
-    key: "assistant.answer.delivered",
-    version: "1.0.0",
-    description: "Assistant answer delivered (must include KB snapshot citations).",
-    stability: "experimental",
-    owners: ["@examples"],
-    tags: ["assistant", "policy", "delivered"]
-  },
-  payload: AssistantAnswerDeliveredPayload
-});
-
-// src/example.ts
-import { defineExample } from "@contractspec/lib.contracts-spec";
-var example = defineExample({
-  meta: {
-    key: "locale-jurisdiction-gate",
-    version: "1.0.0",
-    title: "Locale / Jurisdiction Gate",
-    description: "Fail-closed gating for assistant calls: locale + jurisdiction + kbSnapshotId + allowedScope must be explicit, answers must cite a snapshot.",
-    kind: "knowledge",
-    visibility: "public",
-    stability: "experimental",
-    owners: ["@platform.core"],
-    tags: ["policy", "locale", "jurisdiction", "assistant", "gating"]
-  },
-  docs: {
-    rootDocId: "docs.examples.locale-jurisdiction-gate"
-  },
-  entrypoints: {
-    packageName: "@contractspec/example.locale-jurisdiction-gate",
-    feature: "./feature",
-    contracts: "./contracts",
-    handlers: "./handlers",
-    docs: "./docs"
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ["markdown", "specs"] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true }
-  }
-});
-var example_default = example;
-
-// 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 defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
-var AssistantContextFormModel = defineSchemaModel3({
-  name: "AssistantContextFormModel",
-  description: "Form values required before a policy-gated assistant request can be executed.",
-  fields: {
-    locale: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
-    kbSnapshotId: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
-    allowedScope: { type: AllowedScopeEnum, isOptional: false },
-    question: { type: ScalarTypeEnum3.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"
-  }
-});
-// 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/handlers/demo.handlers.ts
-function createDemoAssistantHandlers() {
-  async function answer(input) {
-    const env = validateEnvelope(input.envelope);
-    if (!env.ok) {
-      return {
-        locale: input.envelope.locale ?? "en-US",
-        jurisdiction: input.envelope.regulatoryContext?.jurisdiction ?? "UNKNOWN",
-        allowedScope: input.envelope.allowedScope ?? "education_only",
-        sections: [
-          {
-            heading: "Request blocked",
-            body: env.error.message
-          }
-        ],
-        citations: [],
-        disclaimers: [
-          "This system refuses to answer without a valid envelope."
-        ],
-        riskFlags: [env.error.code],
-        refused: true,
-        refusalReason: env.error.code
-      };
-    }
-    const draft = {
-      locale: env.value.locale,
-      jurisdiction: env.value.regulatoryContext?.jurisdiction ?? "UNKNOWN",
-      allowedScope: env.value.allowedScope ?? "education_only",
-      sections: [
-        {
-          heading: "Answer (demo)",
-          body: `You asked: "${input.question}". This demo answer is derived from the KB snapshot only.`
-        }
-      ],
-      citations: [
-        {
-          kbSnapshotId: env.value.kbSnapshotId ?? "unknown",
-          sourceType: "ruleVersion",
-          sourceId: "rv_demo",
-          title: "Demo rule version",
-          excerpt: "Demo excerpt"
-        }
-      ],
-      disclaimers: ["Educational demo only."],
-      riskFlags: []
-    };
-    const scope = enforceAllowedScope(env.value.allowedScope, draft);
-    if (!scope.ok) {
-      return {
-        ...draft,
-        sections: [
-          { heading: "Escalation required", body: scope.error.message }
-        ],
-        citations: draft.citations,
-        refused: true,
-        refusalReason: scope.error.code,
-        riskFlags: [...draft.riskFlags ?? [], scope.error.code]
-      };
-    }
-    const cited = enforceCitations(draft);
-    if (!cited.ok) {
-      return {
-        ...draft,
-        sections: [{ heading: "Request blocked", body: cited.error.message }],
-        citations: [],
-        refused: true,
-        refusalReason: cited.error.code,
-        riskFlags: [...draft.riskFlags ?? [], cited.error.code]
-      };
-    }
-    return draft;
-  }
-  async function explainConcept(input) {
-    return await answer({
-      envelope: input.envelope,
-      question: `Explain concept: ${input.conceptKey}`
-    });
-  }
-  return { answer, explainConcept };
-}
-// src/policy/assistant-gate.policy.ts
-import {
-  OwnersEnum as OwnersEnum2,
-  StabilityEnum as StabilityEnum2,
-  TagsEnum as TagsEnum2
-} 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: [OwnersEnum2.PlatformFinance],
-    tags: [TagsEnum2.I18n, "assistant", "policy", "jurisdiction"],
-    stability: StabilityEnum2.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
-  }
-});
-
-// src/locale-jurisdiction-gate.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LocaleJurisdictionGateFeature = defineFeature({
-  meta: {
-    key: "locale-jurisdiction-gate",
-    version: "1.0.0",
-    title: "Locale + Jurisdiction Gate",
-    description: "Fail-closed gating for assistant calls requiring locale/jurisdiction/snapshot/scope and citations.",
-    domain: "knowledge",
-    owners: ["@examples"],
-    tags: ["assistant", "policy", "locale", "jurisdiction", "knowledge"],
-    stability: "experimental"
-  },
-  operations: [
-    { key: "assistant.answer", version: "1.0.0" },
-    { key: "assistant.explainConcept", version: "1.0.0" }
-  ],
-  events: [
-    { key: "assistant.answer.requested", version: "1.0.0" },
-    { key: "assistant.answer.blocked", version: "1.0.0" },
-    { key: "assistant.answer.delivered", version: "1.0.0" }
-  ],
-  presentations: [],
-  opToPresentation: [],
-  presentationsTargets: [],
-  capabilities: {
-    requires: [{ key: "knowledge", version: "1.0.0" }]
-  },
-  policies: [
-    {
-      key: AssistantGatePolicy.meta.key,
-      version: AssistantGatePolicy.meta.version
-    }
-  ],
-  knowledge: [
-    { key: "locale-jurisdiction-gate.knowledge.rules", version: "1.0.0" }
-  ],
-  docs: [
-    "docs.examples.locale-jurisdiction-gate.goal",
-    "docs.examples.locale-jurisdiction-gate.reference"
-  ]
-});
-
-// src/operations/assistant.ts
-import { defineCommand } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel4, ScalarTypeEnum as ScalarTypeEnum4 } from "@contractspec/lib.schema";
-var AssistantQuestionInput = defineSchemaModel4({
-  name: "AssistantQuestionInput",
-  description: "Input for assistant calls with mandatory envelope.",
-  fields: {
-    envelope: { type: LLMCallEnvelopeModel, isOptional: false },
-    question: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false }
-  }
-});
-var AssistantConceptInput = defineSchemaModel4({
-  name: "AssistantConceptInput",
-  description: "Input for explaining a concept with mandatory envelope.",
-  fields: {
-    envelope: { type: LLMCallEnvelopeModel, isOptional: false },
-    conceptKey: { type: ScalarTypeEnum4.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" }
-});
-// src/translations/assistant-gate.en-GB.translation.ts
-import {
-  OwnersEnum as OwnersEnum3,
-  StabilityEnum as StabilityEnum3,
-  TagsEnum as TagsEnum3
-} 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: [OwnersEnum3.PlatformFinance],
-    stability: StabilityEnum3.Experimental,
-    tags: [TagsEnum3.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 OwnersEnum4,
-  StabilityEnum as StabilityEnum4,
-  TagsEnum as TagsEnum4
-} 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: [OwnersEnum4.PlatformFinance],
-    stability: StabilityEnum4.Experimental,
-    tags: [TagsEnum4.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 OwnersEnum5,
-  StabilityEnum as StabilityEnum5,
-  TagsEnum as TagsEnum5
-} 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: [OwnersEnum5.PlatformFinance],
-    stability: StabilityEnum5.Experimental,
-    tags: [TagsEnum5.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 {
-  validateEnvelope,
-  example_default as example,
-  enforceCitations,
-  enforceAllowedScope,
-  createDemoAssistantHandlers,
-  UserProfileModel,
-  RegulatoryContextModel,
-  LocaleJurisdictionGateFeature,
-  LLMCallEnvelopeModel,
-  AssistantGatePolicy,
-  AssistantGateMessagesFrFr,
-  AssistantGateMessagesEnUs,
-  AssistantGateMessagesEnGb,
-  AssistantExplainConceptContract,
-  AssistantContextForm,
-  AssistantCitationModel,
-  AssistantAnswerSectionModel,
-  AssistantAnswerRequestedEvent,
-  AssistantAnswerIRModel,
-  AssistantAnswerDeliveredEvent,
-  AssistantAnswerContract,
-  AssistantAnswerBlockedEvent,
-  AllowedScopeEnum
-};
+- assistant.answer.delivered`}];H(J);import{defineEnum as L,defineSchemaModel as x,ScalarTypeEnum as r}from"@contractspec/lib.schema";var f=L("AllowedScope",["education_only","generic_info","escalation_required"]),sr=x({name:"UserProfile",description:"User profile inputs used to derive regulatory context.",fields:{preferredLocale:{type:r.String_unsecure(),isOptional:!0},residencyCountry:{type:r.String_unsecure(),isOptional:!0},taxResidenceCountry:{type:r.String_unsecure(),isOptional:!0},clientType:{type:r.String_unsecure(),isOptional:!0}}}),V=x({name:"RegulatoryContext",description:"Explicit regulatory context (no guessing).",fields:{jurisdiction:{type:r.String_unsecure(),isOptional:!1},region:{type:r.String_unsecure(),isOptional:!0},clientType:{type:r.String_unsecure(),isOptional:!0},allowedScope:{type:f,isOptional:!1}}}),s=x({name:"LLMCallEnvelope",description:"Mandatory envelope for assistant calls. All fields are explicit and required for policy gating.",fields:{traceId:{type:r.String_unsecure(),isOptional:!1},locale:{type:r.String_unsecure(),isOptional:!1},regulatoryContext:{type:V,isOptional:!1},kbSnapshotId:{type:r.String_unsecure(),isOptional:!1},allowedScope:{type:f,isOptional:!1}}}),z=x({name:"AssistantCitation",description:"Citation referencing a KB snapshot + a specific item within it.",fields:{kbSnapshotId:{type:r.String_unsecure(),isOptional:!1},sourceType:{type:r.String_unsecure(),isOptional:!1},sourceId:{type:r.String_unsecure(),isOptional:!1},title:{type:r.String_unsecure(),isOptional:!0},excerpt:{type:r.String_unsecure(),isOptional:!0}}}),A=x({name:"AssistantAnswerSection",description:"Structured answer section.",fields:{heading:{type:r.String_unsecure(),isOptional:!1},body:{type:r.String_unsecure(),isOptional:!1}}}),R=x({name:"AssistantAnswerIR",description:"Structured assistant answer with mandatory citations and explicit locale/jurisdiction.",fields:{locale:{type:r.String_unsecure(),isOptional:!1},jurisdiction:{type:r.String_unsecure(),isOptional:!1},allowedScope:{type:f,isOptional:!1},sections:{type:A,isArray:!0,isOptional:!1},citations:{type:z,isArray:!0,isOptional:!1},disclaimers:{type:r.String_unsecure(),isArray:!0,isOptional:!0},riskFlags:{type:r.String_unsecure(),isArray:!0,isOptional:!0},refused:{type:r.Boolean(),isOptional:!0},refusalReason:{type:r.String_unsecure(),isOptional:!0}}});import{defineEvent as p}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as U,ScalarTypeEnum as t}from"@contractspec/lib.schema";var N=U({name:"AssistantAnswerRequestedPayload",description:"Emitted when an assistant answer is requested (pre-gate).",fields:{traceId:{type:t.String_unsecure(),isOptional:!1},locale:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},kbSnapshotId:{type:t.String_unsecure(),isOptional:!1},allowedScope:{type:t.String_unsecure(),isOptional:!1}}}),qr=p({meta:{key:"assistant.answer.requested",version:"1.0.0",description:"Assistant answer requested (policy gate will run).",stability:"experimental",owners:["@examples"],tags:["assistant","policy"]},payload:N}),S=U({name:"AssistantAnswerBlockedPayload",description:"Emitted when a request is blocked by the gate.",fields:{traceId:{type:t.String_unsecure(),isOptional:!1},reasonCode:{type:t.String_unsecure(),isOptional:!1},reason:{type:t.String_unsecure(),isOptional:!1}}}),Kr=p({meta:{key:"assistant.answer.blocked",version:"1.0.0",description:"Assistant answer blocked (fail-closed).",stability:"experimental",owners:["@examples"],tags:["assistant","policy","blocked"]},payload:S}),W=U({name:"AssistantAnswerDeliveredPayload",description:"Emitted when a structured, cited answer is delivered.",fields:{traceId:{type:t.String_unsecure(),isOptional:!1},locale:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},kbSnapshotId:{type:t.String_unsecure(),isOptional:!1},allowedScope:{type:t.String_unsecure(),isOptional:!1},citationsCount:{type:t.Int_unsecure(),isOptional:!1}}}),jr=p({meta:{key:"assistant.answer.delivered",version:"1.0.0",description:"Assistant answer delivered (must include KB snapshot citations).",stability:"experimental",owners:["@examples"],tags:["assistant","policy","delivered"]},payload:W});import{defineExample as X}from"@contractspec/lib.contracts-spec";var Z=X({meta:{key:"locale-jurisdiction-gate",version:"1.0.0",title:"Locale / Jurisdiction Gate",description:"Fail-closed gating for assistant calls: locale + jurisdiction + kbSnapshotId + allowedScope must be explicit, answers must cite a snapshot.",kind:"knowledge",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["policy","locale","jurisdiction","assistant","gating"]},docs:{rootDocId:"docs.examples.locale-jurisdiction-gate"},entrypoints:{packageName:"@contractspec/example.locale-jurisdiction-gate",feature:"./feature",contracts:"./contracts",handlers:"./handlers",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["markdown","specs"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),$=Z;import{defineFormSpec as B}from"@contractspec/lib.contracts-spec/forms";import{OwnersEnum as D,StabilityEnum as Y,TagsEnum as l}from"@contractspec/lib.contracts-spec/ownership";import{defineSchemaModel as h,ScalarTypeEnum as I}from"@contractspec/lib.schema";var M=h({name:"AssistantContextFormModel",description:"Form values required before a policy-gated assistant request can be executed.",fields:{locale:{type:I.String_unsecure(),isOptional:!1},jurisdiction:{type:I.String_unsecure(),isOptional:!1},kbSnapshotId:{type:I.String_unsecure(),isOptional:!1},allowedScope:{type:f,isOptional:!1},question:{type:I.String_unsecure(),isOptional:!1}}}),Ar=B({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:[D.PlatformFinance],tags:[l.I18n,"assistant","form","policy"],stability:Y.Experimental},model:M,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:!0},{kind:"text",name:"jurisdiction",labelI18n:"assistantGate.jurisdiction.label",placeholderI18n:"assistantGate.jurisdiction.placeholder",required:!0},{kind:"text",name:"kbSnapshotId",labelI18n:"assistantGate.kbSnapshotId.label",placeholderI18n:"assistantGate.kbSnapshotId.placeholder",required:!0},{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:!0},{kind:"textarea",name:"question",labelI18n:"assistantGate.question.label",placeholderI18n:"assistantGate.question.placeholder",required:!0}],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"}});var F=new Set(["en-US","en-GB","fr-FR"]);function O(i,o){return{code:i,message:o}}function Q(i){if(!i.locale||!F.has(i.locale))return{ok:!1,error:O("LOCALE_REQUIRED","locale is required and must be supported")};if(!i.regulatoryContext?.jurisdiction)return{ok:!1,error:O("JURISDICTION_REQUIRED","jurisdiction is required")};if(!i.kbSnapshotId)return{ok:!1,error:O("KB_SNAPSHOT_REQUIRED","kbSnapshotId is required")};if(!i.allowedScope)return{ok:!1,error:O("SCOPE_VIOLATION","allowedScope is required")};return{ok:!0,value:i}}function q(i){let o=i.citations??[];if(!Array.isArray(o)||o.length===0)return{ok:!1,error:O("CITATIONS_REQUIRED","answers must include at least one citation")};return{ok:!0,value:i}}var P=[/\b(buy|sell)\b/i,/\b(should\s+buy|should\s+sell)\b/i,/\b(guarantee(d)?|promise(d)?)\b/i];function K(i,o){if(!i)return{ok:!1,error:O("SCOPE_VIOLATION","allowedScope is required")};if(i!=="education_only")return{ok:!0,value:o};let _=(o.sections??[]).map((u)=>u.body).join(`
+`);if(P.some((u)=>u.test(_)))return{ok:!1,error:O("SCOPE_VIOLATION","answer violates education_only scope (contains actionable or promotional language)")};return{ok:!0,value:o}}function $r(){async function i(_){let g=Q(_.envelope);if(!g.ok)return{locale:_.envelope.locale??"en-US",jurisdiction:_.envelope.regulatoryContext?.jurisdiction??"UNKNOWN",allowedScope:_.envelope.allowedScope??"education_only",sections:[{heading:"Request blocked",body:g.error.message}],citations:[],disclaimers:["This system refuses to answer without a valid envelope."],riskFlags:[g.error.code],refused:!0,refusalReason:g.error.code};let u={locale:g.value.locale,jurisdiction:g.value.regulatoryContext?.jurisdiction??"UNKNOWN",allowedScope:g.value.allowedScope??"education_only",sections:[{heading:"Answer (demo)",body:`You asked: "${_.question}". This demo answer is derived from the KB snapshot only.`}],citations:[{kbSnapshotId:g.value.kbSnapshotId??"unknown",sourceType:"ruleVersion",sourceId:"rv_demo",title:"Demo rule version",excerpt:"Demo excerpt"}],disclaimers:["Educational demo only."],riskFlags:[]},e=K(g.value.allowedScope,u);if(!e.ok)return{...u,sections:[{heading:"Escalation required",body:e.error.message}],citations:u.citations,refused:!0,refusalReason:e.error.code,riskFlags:[...u.riskFlags??[],e.error.code]};let y=q(u);if(!y.ok)return{...u,sections:[{heading:"Request blocked",body:y.error.message}],citations:[],refused:!0,refusalReason:y.error.code,riskFlags:[...u.riskFlags??[],y.error.code]};return u}async function o(_){return await i({envelope:_.envelope,question:`Explain concept: ${_.conceptKey}`})}return{answer:i,explainConcept:o}}import{OwnersEnum as d,StabilityEnum as w,TagsEnum as b}from"@contractspec/lib.contracts-spec/ownership";import{definePolicy as T}from"@contractspec/lib.contracts-spec/policy";var C=T({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:[d.PlatformFinance],tags:[b.I18n,"assistant","policy","jurisdiction"],stability:w.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}});import{defineFeature as v}from"@contractspec/lib.contracts-spec";var dr=v({meta:{key:"locale-jurisdiction-gate",version:"1.0.0",title:"Locale + Jurisdiction Gate",description:"Fail-closed gating for assistant calls requiring locale/jurisdiction/snapshot/scope and citations.",domain:"knowledge",owners:["@examples"],tags:["assistant","policy","locale","jurisdiction","knowledge"],stability:"experimental"},operations:[{key:"assistant.answer",version:"1.0.0"},{key:"assistant.explainConcept",version:"1.0.0"}],events:[{key:"assistant.answer.requested",version:"1.0.0"},{key:"assistant.answer.blocked",version:"1.0.0"},{key:"assistant.answer.delivered",version:"1.0.0"}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{requires:[{key:"knowledge",version:"1.0.0"}]},policies:[{key:C.meta.key,version:C.meta.version}],knowledge:[{key:"locale-jurisdiction-gate.knowledge.rules",version:"1.0.0"}],docs:["docs.examples.locale-jurisdiction-gate.goal","docs.examples.locale-jurisdiction-gate.reference"]});import{defineCommand as j}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as k,ScalarTypeEnum as G}from"@contractspec/lib.schema";var n=k({name:"AssistantQuestionInput",description:"Input for assistant calls with mandatory envelope.",fields:{envelope:{type:s,isOptional:!1},question:{type:G.String_unsecure(),isOptional:!1}}}),E=k({name:"AssistantConceptInput",description:"Input for explaining a concept with mandatory envelope.",fields:{envelope:{type:s,isOptional:!1},conceptKey:{type:G.String_unsecure(),isOptional:!1}}}),m=j({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:n,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"}}),nr=j({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:E,output:R,errors:m.io.errors},policy:{auth:"user"}});import{OwnersEnum as a,StabilityEnum as c,TagsEnum as rr}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as ir}from"@contractspec/lib.contracts-spec/translations/spec";var _i=ir({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:[a.PlatformFinance],stability:c.Experimental,tags:[rr.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 tr,StabilityEnum as ur,TagsEnum as or}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as _r}from"@contractspec/lib.contracts-spec/translations/spec";var fi=_r({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:[tr.PlatformFinance],stability:ur.Experimental,tags:[or.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 gr,StabilityEnum as Or,TagsEnum as xr}from"@contractspec/lib.contracts-spec/ownership";import{defineTranslation as fr}from"@contractspec/lib.contracts-spec/translations/spec";var si=fr({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:[gr.PlatformFinance],stability:Or.Experimental,tags:[xr.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{Q as validateEnvelope,$ as example,q as enforceCitations,K as enforceAllowedScope,$r as createDemoAssistantHandlers,sr as UserProfileModel,V as RegulatoryContextModel,dr as LocaleJurisdictionGateFeature,s as LLMCallEnvelopeModel,C as AssistantGatePolicy,si as AssistantGateMessagesFrFr,fi as AssistantGateMessagesEnUs,_i as AssistantGateMessagesEnGb,nr as AssistantExplainConceptContract,Ar as AssistantContextForm,z as AssistantCitationModel,A as AssistantAnswerSectionModel,qr as AssistantAnswerRequestedEvent,R as AssistantAnswerIRModel,jr as AssistantAnswerDeliveredEvent,m as AssistantAnswerContract,Kr as AssistantAnswerBlockedEvent,f as AllowedScopeEnum};