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

package/dist/locale-jurisdiction-gate.feature.js

@@ -1,106 +1,2 @@
 // @bun
-// 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
-  }
-});
-
-// 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"
-  ]
-});
-export {
-  LocaleJurisdictionGateFeature
-};
+import{OwnersEnum as j,StabilityEnum as k,TagsEnum as q}from"@contractspec/lib.contracts-spec/ownership";import{definePolicy as v}from"@contractspec/lib.contracts-spec/policy";var h=v({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:[j.PlatformFinance],tags:[q.I18n,"assistant","policy","jurisdiction"],stability:k.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 x}from"@contractspec/lib.contracts-spec";var I=x({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:h.meta.key,version:h.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"]});export{I as LocaleJurisdictionGateFeature};

package/dist/node/docs/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 f}from"@contractspec/lib.contracts-spec/docs";var h=[{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,7 +16,4 @@ var docBlocks = [
 ## Events
 - assistant.answer.requested
 - assistant.answer.blocked
-- assistant.answer.delivered`
-  }
-];
-registerDocBlocks(docBlocks);
+- assistant.answer.delivered`}];f(h);

package/dist/node/docs/locale-jurisdiction-gate.docblock.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 f}from"@contractspec/lib.contracts-spec/docs";var h=[{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,7 +16,4 @@ var docBlocks = [
 ## Events
 - assistant.answer.requested
 - assistant.answer.blocked
-- assistant.answer.delivered`
-  }
-];
-registerDocBlocks(docBlocks);
+- assistant.answer.delivered`}];f(h);

package/dist/node/entities/index.js

@@ -1,110 +1 @@
-// 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 }
-  }
-});
-export {
-  UserProfileModel,
-  RegulatoryContextModel,
-  LLMCallEnvelopeModel,
-  AssistantCitationModel,
-  AssistantAnswerSectionModel,
-  AssistantAnswerIRModel,
-  AllowedScopeEnum
-};
+import{defineEnum as n,defineSchemaModel as t,ScalarTypeEnum as e}from"@contractspec/lib.schema";var i=n("AllowedScope",["education_only","generic_info","escalation_required"]),l=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}}}),s=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}}}),p=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:s,isOptional:!1},kbSnapshotId:{type:e.String_unsecure(),isOptional:!1},allowedScope:{type:i,isOptional:!1}}}),r=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}}}),o=t({name:"AssistantAnswerSection",description:"Structured answer section.",fields:{heading:{type:e.String_unsecure(),isOptional:!1},body:{type:e.String_unsecure(),isOptional:!1}}}),u=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:o,isArray:!0,isOptional:!1},citations:{type:r,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}}});export{l as UserProfileModel,s as RegulatoryContextModel,p as LLMCallEnvelopeModel,r as AssistantCitationModel,o as AssistantAnswerSectionModel,u as AssistantAnswerIRModel,i as AllowedScopeEnum};

package/dist/node/entities/models.js

@@ -1,110 +1 @@
-// 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 }
-  }
-});
-export {
-  UserProfileModel,
-  RegulatoryContextModel,
-  LLMCallEnvelopeModel,
-  AssistantCitationModel,
-  AssistantAnswerSectionModel,
-  AssistantAnswerIRModel,
-  AllowedScopeEnum
-};
+import{defineEnum as n,defineSchemaModel as t,ScalarTypeEnum as e}from"@contractspec/lib.schema";var i=n("AllowedScope",["education_only","generic_info","escalation_required"]),l=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}}}),s=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}}}),p=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:s,isOptional:!1},kbSnapshotId:{type:e.String_unsecure(),isOptional:!1},allowedScope:{type:i,isOptional:!1}}}),r=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}}}),o=t({name:"AssistantAnswerSection",description:"Structured answer section.",fields:{heading:{type:e.String_unsecure(),isOptional:!1},body:{type:e.String_unsecure(),isOptional:!1}}}),u=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:o,isArray:!0,isOptional:!1},citations:{type:r,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}}});export{l as UserProfileModel,s as RegulatoryContextModel,p as LLMCallEnvelopeModel,r as AssistantCitationModel,o as AssistantAnswerSectionModel,u as AssistantAnswerIRModel,i as AllowedScopeEnum};

package/dist/node/events.js

@@ -1,73 +1 @@
-// src/events.ts
-import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var AssistantAnswerRequestedPayload = defineSchemaModel({
-  name: "AssistantAnswerRequestedPayload",
-  description: "Emitted when an assistant answer is requested (pre-gate).",
-  fields: {
-    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    allowedScope: { type: ScalarTypeEnum.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 = defineSchemaModel({
-  name: "AssistantAnswerBlockedPayload",
-  description: "Emitted when a request is blocked by the gate.",
-  fields: {
-    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    reasonCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    reason: { type: ScalarTypeEnum.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 = defineSchemaModel({
-  name: "AssistantAnswerDeliveredPayload",
-  description: "Emitted when a structured, cited answer is delivered.",
-  fields: {
-    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    allowedScope: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    citationsCount: { type: ScalarTypeEnum.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
-});
-export {
-  AssistantAnswerRequestedEvent,
-  AssistantAnswerDeliveredEvent,
-  AssistantAnswerBlockedEvent
-};
+import{defineEvent as j}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as x,ScalarTypeEnum as g}from"@contractspec/lib.schema";var z=x({name:"AssistantAnswerRequestedPayload",description:"Emitted when an assistant answer is requested (pre-gate).",fields:{traceId:{type:g.String_unsecure(),isOptional:!1},locale:{type:g.String_unsecure(),isOptional:!1},jurisdiction:{type:g.String_unsecure(),isOptional:!1},kbSnapshotId:{type:g.String_unsecure(),isOptional:!1},allowedScope:{type:g.String_unsecure(),isOptional:!1}}}),I=j({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:z}),C=x({name:"AssistantAnswerBlockedPayload",description:"Emitted when a request is blocked by the gate.",fields:{traceId:{type:g.String_unsecure(),isOptional:!1},reasonCode:{type:g.String_unsecure(),isOptional:!1},reason:{type:g.String_unsecure(),isOptional:!1}}}),J=j({meta:{key:"assistant.answer.blocked",version:"1.0.0",description:"Assistant answer blocked (fail-closed).",stability:"experimental",owners:["@examples"],tags:["assistant","policy","blocked"]},payload:C}),F=x({name:"AssistantAnswerDeliveredPayload",description:"Emitted when a structured, cited answer is delivered.",fields:{traceId:{type:g.String_unsecure(),isOptional:!1},locale:{type:g.String_unsecure(),isOptional:!1},jurisdiction:{type:g.String_unsecure(),isOptional:!1},kbSnapshotId:{type:g.String_unsecure(),isOptional:!1},allowedScope:{type:g.String_unsecure(),isOptional:!1},citationsCount:{type:g.Int_unsecure(),isOptional:!1}}}),K=j({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:F});export{I as AssistantAnswerRequestedEvent,K as AssistantAnswerDeliveredEvent,J as AssistantAnswerBlockedEvent};

package/dist/node/example.js

@@ -1,35 +1 @@
-// 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;
-export {
-  example_default as default
-};
+import{defineExample as g}from"@contractspec/lib.contracts-spec";var h=g({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}}}),q=h;export{q as default};