@contractspec/example.locale-jurisdiction-gate 1.44.0

package/dist/entities/models.js

@@ -0,0 +1,168 @@
+import { ScalarTypeEnum, defineEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/entities/models.ts
+const AllowedScopeEnum = defineEnum("AllowedScope", [
+	"education_only",
+	"generic_info",
+	"escalation_required"
+]);
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const AssistantAnswerSectionModel = defineSchemaModel({
+	name: "AssistantAnswerSection",
+	description: "Structured answer section.",
+	fields: {
+		heading: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		body: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const 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
+		}
+	}
+});
+
+//#endregion
+export { AllowedScopeEnum, AssistantAnswerIRModel, AssistantAnswerSectionModel, AssistantCitationModel, LLMCallEnvelopeModel, RegulatoryContextModel, UserProfileModel };
+//# sourceMappingURL=models.js.map

package/dist/entities/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","names":[],"sources":["../../src/entities/models.ts"],"sourcesContent":["import {\n  ScalarTypeEnum,\n  defineEnum,\n  defineSchemaModel,\n} from '@contractspec/lib.schema';\n\nexport const AllowedScopeEnum = defineEnum('AllowedScope', [\n  'education_only',\n  'generic_info',\n  'escalation_required',\n]);\n\nexport const UserProfileModel = defineSchemaModel({\n  name: 'UserProfile',\n  description: 'User profile inputs used to derive regulatory context.',\n  fields: {\n    preferredLocale: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    residencyCountry: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    taxResidenceCountry: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    clientType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nexport const RegulatoryContextModel = defineSchemaModel({\n  name: 'RegulatoryContext',\n  description: 'Explicit regulatory context (no guessing).',\n  fields: {\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    region: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    clientType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    allowedScope: { type: AllowedScopeEnum, isOptional: false },\n  },\n});\n\nexport const LLMCallEnvelopeModel = defineSchemaModel({\n  name: 'LLMCallEnvelope',\n  description:\n    'Mandatory envelope for assistant calls. All fields are explicit and required for policy gating.',\n  fields: {\n    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    regulatoryContext: { type: RegulatoryContextModel, isOptional: false },\n    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    allowedScope: { type: AllowedScopeEnum, isOptional: false },\n  },\n});\n\nexport const AssistantCitationModel = defineSchemaModel({\n  name: 'AssistantCitation',\n  description:\n    'Citation referencing a KB snapshot + a specific item within it.',\n  fields: {\n    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nexport const AssistantAnswerSectionModel = defineSchemaModel({\n  name: 'AssistantAnswerSection',\n  description: 'Structured answer section.',\n  fields: {\n    heading: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    body: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const AssistantAnswerIRModel = defineSchemaModel({\n  name: 'AssistantAnswerIR',\n  description:\n    'Structured assistant answer with mandatory citations and explicit locale/jurisdiction.',\n  fields: {\n    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    allowedScope: { type: AllowedScopeEnum, isOptional: false },\n    sections: {\n      type: AssistantAnswerSectionModel,\n      isArray: true,\n      isOptional: false,\n    },\n    citations: {\n      type: AssistantCitationModel,\n      isArray: true,\n      isOptional: false,\n    },\n    disclaimers: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isArray: true,\n      isOptional: true,\n    },\n    riskFlags: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isArray: true,\n      isOptional: true,\n    },\n    refused: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n    refusalReason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n"],"mappings":";;;AAMA,MAAa,mBAAmB,WAAW,gBAAgB;CACzD;CACA;CACA;CACD,CAAC;AAEF,MAAa,mBAAmB,kBAAkB;CAChD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,iBAAiB;GACf,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,kBAAkB;GAChB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,qBAAqB;GACnB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACzE;CACF,CAAC;AAEF,MAAa,yBAAyB,kBAAkB;CACtD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACpE,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACxE,cAAc;GAAE,MAAM;GAAkB,YAAY;GAAO;EAC5D;CACF,CAAC;AAEF,MAAa,uBAAuB,kBAAkB;CACpD,MAAM;CACN,aACE;CACF,QAAQ;EACN,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,mBAAmB;GAAE,MAAM;GAAwB,YAAY;GAAO;EACtE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,cAAc;GAAE,MAAM;GAAkB,YAAY;GAAO;EAC5D;CACF,CAAC;AAEF,MAAa,yBAAyB,kBAAkB;CACtD,MAAM;CACN,aACE;CACF,QAAQ;EACN,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACvE,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACnE,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACtE;CACF,CAAC;AAEF,MAAa,8BAA8B,kBAAkB;CAC3D,MAAM;CACN,aAAa;CACb,QAAQ;EACN,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE;CACF,CAAC;AAEF,MAAa,yBAAyB,kBAAkB;CACtD,MAAM;CACN,aACE;CACF,QAAQ;EACN,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,cAAc;GAAE,MAAM;GAAkB,YAAY;GAAO;EAC3D,UAAU;GACR,MAAM;GACN,SAAS;GACT,YAAY;GACb;EACD,WAAW;GACT,MAAM;GACN,SAAS;GACT,YAAY;GACb;EACD,aAAa;GACX,MAAM,eAAe,iBAAiB;GACtC,SAAS;GACT,YAAY;GACb;EACD,WAAW;GACT,MAAM,eAAe,iBAAiB;GACtC,SAAS;GACT,YAAY;GACb;EACD,SAAS;GAAE,MAAM,eAAe,SAAS;GAAE,YAAY;GAAM;EAC7D,eAAe;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EAC5E;CACF,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,69 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
+
+//#region src/events.d.ts
+declare const AssistantAnswerRequestedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  traceId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  locale: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  kbSnapshotId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  allowedScope: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>>;
+declare const AssistantAnswerBlockedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  traceId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  reasonCode: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  reason: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>>;
+declare const AssistantAnswerDeliveredEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  traceId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  locale: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  kbSnapshotId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  allowedScope: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  citationsCount: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+}>>;
+//#endregion
+export { AssistantAnswerBlockedEvent, AssistantAnswerDeliveredEvent, AssistantAnswerRequestedEvent };
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";;;;cAea,+BAA6B,4BAAA,CAAA,oCAAA;;UAUxC,yBAAA,CAAA;;EAVW,CAAA;EAUX,MAAA,EAAA;;;;;6CAVwC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAsB7B,YAAA,EAAA;IAUX,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;IAVsC,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAyB3B,CAAA;CAWX,CAAA,CAAA;cApCW,6BAA2B,4BAAA,CAAA,oCAAA;;UAUtC,yBAAA,CAAA;;;;IAewC,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;cAA7B,+BAA6B,4BAAA,CAAA,oCAAA;;UAWxC,yBAAA,CAAA"}

package/dist/events.js

@@ -0,0 +1,123 @@
+import { defineEvent, defineSchemaModel } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum } from "@contractspec/lib.schema";
+
+//#region src/events.ts
+const 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
+		}
+	}
+});
+const AssistantAnswerRequestedEvent = defineEvent({
+	meta: {
+		key: "assistant.answer.requested",
+		version: 1,
+		description: "Assistant answer requested (policy gate will run).",
+		stability: "experimental",
+		owners: ["@examples"],
+		tags: ["assistant", "policy"]
+	},
+	payload: AssistantAnswerRequestedPayload
+});
+const 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
+		}
+	}
+});
+const AssistantAnswerBlockedEvent = defineEvent({
+	meta: {
+		key: "assistant.answer.blocked",
+		version: 1,
+		description: "Assistant answer blocked (fail-closed).",
+		stability: "experimental",
+		owners: ["@examples"],
+		tags: [
+			"assistant",
+			"policy",
+			"blocked"
+		]
+	},
+	payload: AssistantAnswerBlockedPayload
+});
+const 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
+		}
+	}
+});
+const AssistantAnswerDeliveredEvent = defineEvent({
+	meta: {
+		key: "assistant.answer.delivered",
+		version: 1,
+		description: "Assistant answer delivered (must include KB snapshot citations).",
+		stability: "experimental",
+		owners: ["@examples"],
+		tags: [
+			"assistant",
+			"policy",
+			"delivered"
+		]
+	},
+	payload: AssistantAnswerDeliveredPayload
+});
+
+//#endregion
+export { AssistantAnswerBlockedEvent, AssistantAnswerDeliveredEvent, AssistantAnswerRequestedEvent };
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import { defineEvent, defineSchemaModel } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum } from '@contractspec/lib.schema';\n\nconst AssistantAnswerRequestedPayload = defineSchemaModel({\n  name: 'AssistantAnswerRequestedPayload',\n  description: 'Emitted when an assistant answer is requested (pre-gate).',\n  fields: {\n    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    allowedScope: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const AssistantAnswerRequestedEvent = defineEvent({\n  meta: {\n    key: 'assistant.answer.requested',\n    version: 1,\n    description: 'Assistant answer requested (policy gate will run).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['assistant', 'policy'],\n  },\n  payload: AssistantAnswerRequestedPayload,\n});\n\nconst AssistantAnswerBlockedPayload = defineSchemaModel({\n  name: 'AssistantAnswerBlockedPayload',\n  description: 'Emitted when a request is blocked by the gate.',\n  fields: {\n    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    reasonCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const AssistantAnswerBlockedEvent = defineEvent({\n  meta: {\n    key: 'assistant.answer.blocked',\n    version: 1,\n    description: 'Assistant answer blocked (fail-closed).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['assistant', 'policy', 'blocked'],\n  },\n  payload: AssistantAnswerBlockedPayload,\n});\n\nconst AssistantAnswerDeliveredPayload = defineSchemaModel({\n  name: 'AssistantAnswerDeliveredPayload',\n  description: 'Emitted when a structured, cited answer is delivered.',\n  fields: {\n    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    allowedScope: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    citationsCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n  },\n});\n\nexport const AssistantAnswerDeliveredEvent = defineEvent({\n  meta: {\n    key: 'assistant.answer.delivered',\n    version: 1,\n    description:\n      'Assistant answer delivered (must include KB snapshot citations).',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['assistant', 'policy', 'delivered'],\n  },\n  payload: AssistantAnswerDeliveredPayload,\n});\n"],"mappings":";;;;AAGA,MAAM,kCAAkC,kBAAkB;CACxD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC5E;CACF,CAAC;AAEF,MAAa,gCAAgC,YAAY;CACvD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,aAAa,SAAS;EAC9B;CACD,SAAS;CACV,CAAC;AAEF,MAAM,gCAAgC,kBAAkB;CACtD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE;CACF,CAAC;AAEF,MAAa,8BAA8B,YAAY;CACrD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAU;GAAU;EACzC;CACD,SAAS;CACV,CAAC;AAEF,MAAM,kCAAkC,kBAAkB;CACxD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,gBAAgB;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAO;EAC3E;CACF,CAAC;AAEF,MAAa,gCAAgC,YAAY;CACvD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aACE;EACF,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAU;GAAY;EAC3C;CACD,SAAS;CACV,CAAC"}

package/dist/example.d.ts

@@ -0,0 +1,36 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "locale-jurisdiction-gate";
+  readonly title: "Locale / Jurisdiction Gate";
+  readonly summary: "Fail-closed gating for assistant calls: locale + jurisdiction + kbSnapshotId + allowedScope must be explicit, answers must cite a snapshot.";
+  readonly tags: readonly ["policy", "locale", "jurisdiction", "assistant", "gating"];
+  readonly kind: "knowledge";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.locale-jurisdiction-gate";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.locale-jurisdiction-gate";
+    readonly feature: "./feature";
+    readonly contracts: "./contracts";
+    readonly handlers: "./handlers";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["markdown", "specs"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAwBI,EAAA,0BAAA"}

package/dist/example.js

@@ -0,0 +1,40 @@
+//#region src/example.ts
+const example = {
+	id: "locale-jurisdiction-gate",
+	title: "Locale / Jurisdiction Gate",
+	summary: "Fail-closed gating for assistant calls: locale + jurisdiction + kbSnapshotId + allowedScope must be explicit, answers must cite a snapshot.",
+	tags: [
+		"policy",
+		"locale",
+		"jurisdiction",
+		"assistant",
+		"gating"
+	],
+	kind: "knowledge",
+	visibility: "public",
+	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;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'locale-jurisdiction-gate',\n  title: 'Locale / Jurisdiction Gate',\n  summary:\n    'Fail-closed gating for assistant calls: locale + jurisdiction + kbSnapshotId + allowedScope must be explicit, answers must cite a snapshot.',\n  tags: ['policy', 'locale', 'jurisdiction', 'assistant', 'gating'],\n  kind: 'knowledge',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.locale-jurisdiction-gate',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.locale-jurisdiction-gate',\n    feature: './feature',\n    contracts: './contracts',\n    handlers: './handlers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAU;EAAU;EAAgB;EAAa;EAAS;CACjE,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,WAAW,0CACZ;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/handlers/demo.handlers.d.ts

@@ -0,0 +1,59 @@
+//#region src/handlers/demo.handlers.d.ts
+type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
+interface AssistantAnswerIR {
+  locale: string;
+  jurisdiction: string;
+  allowedScope: AllowedScope;
+  sections: {
+    heading: string;
+    body: string;
+  }[];
+  citations: {
+    kbSnapshotId: string;
+    sourceType: string;
+    sourceId: string;
+    title?: string;
+    excerpt?: string;
+  }[];
+  disclaimers?: string[];
+  riskFlags?: string[];
+  refused?: boolean;
+  refusalReason?: string;
+}
+interface DemoAssistantHandlers {
+  answer(input: {
+    envelope: {
+      traceId: string;
+      locale: string;
+      kbSnapshotId: string;
+      allowedScope: AllowedScope;
+      regulatoryContext: {
+        jurisdiction: string;
+      };
+    };
+    question: string;
+  }): Promise<AssistantAnswerIR>;
+  explainConcept(input: {
+    envelope: {
+      traceId: string;
+      locale: string;
+      kbSnapshotId: string;
+      allowedScope: AllowedScope;
+      regulatoryContext: {
+        jurisdiction: string;
+      };
+    };
+    conceptKey: string;
+  }): Promise<AssistantAnswerIR>;
+}
+/**
+ * Deterministic demo assistant handlers (no LLM).
+ *
+ * - Validates envelope
+ * - Requires citations
+ * - Enforces allowedScope (education_only blocks actionable language)
+ */
+declare function createDemoAssistantHandlers(): DemoAssistantHandlers;
+//#endregion
+export { DemoAssistantHandlers, createDemoAssistantHandlers };
+//# sourceMappingURL=demo.handlers.d.ts.map

package/dist/handlers/demo.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.handlers.d.ts","names":[],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":[],"mappings":";KAMK,YAAA;UAEK,iBAAA,CAFO;EAEP,MAAA,EAAA,MAAA;EAkBO,YAAA,EAAA,MAAA;EAMG,YAAA,EArBJ,YAqBI;EAIN,QAAA,EAAA;IAAR,OAAA,EAAA,MAAA;IAOc,IAAA,EAAA,MAAA;EAIN,CAAA,EAAA;EAAR,SAAA,EAAA;IAAO,YAAA,EAAA,MAAA;IAUG,UAAA,EAAA,MAAA;;;;;;;;;;UA/BC,qBAAA;;;;;;oBAMG;;;;;;MAId,QAAQ;;;;;;oBAOM;;;;;;MAId,QAAQ;;;;;;;;;iBAUE,2BAAA,CAAA,GAA+B"}

package/dist/handlers/demo.handlers.js

@@ -0,0 +1,86 @@
+import { enforceAllowedScope, enforceCitations, validateEnvelope } from "../policy/guard.js";
+
+//#region src/handlers/demo.handlers.ts
+/**
+* Deterministic demo assistant handlers (no LLM).
+*
+* - Validates envelope
+* - Requires citations
+* - Enforces allowedScope (education_only blocks actionable language)
+*/
+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
+	};
+}
+
+//#endregion
+export { createDemoAssistantHandlers };
+//# sourceMappingURL=demo.handlers.js.map

package/dist/handlers/demo.handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.handlers.js","names":["draft: AssistantAnswerIR"],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":["import {\n  enforceAllowedScope,\n  enforceCitations,\n  validateEnvelope,\n} from '../policy/guard';\n\ntype AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';\n\ninterface AssistantAnswerIR {\n  locale: string;\n  jurisdiction: string;\n  allowedScope: AllowedScope;\n  sections: { heading: string; body: string }[];\n  citations: {\n    kbSnapshotId: string;\n    sourceType: string;\n    sourceId: string;\n    title?: string;\n    excerpt?: string;\n  }[];\n  disclaimers?: string[];\n  riskFlags?: string[];\n  refused?: boolean;\n  refusalReason?: string;\n}\n\nexport interface DemoAssistantHandlers {\n  answer(input: {\n    envelope: {\n      traceId: string;\n      locale: string;\n      kbSnapshotId: string;\n      allowedScope: AllowedScope;\n      regulatoryContext: { jurisdiction: string };\n    };\n    question: string;\n  }): Promise<AssistantAnswerIR>;\n\n  explainConcept(input: {\n    envelope: {\n      traceId: string;\n      locale: string;\n      kbSnapshotId: string;\n      allowedScope: AllowedScope;\n      regulatoryContext: { jurisdiction: string };\n    };\n    conceptKey: string;\n  }): Promise<AssistantAnswerIR>;\n}\n\n/**\n * Deterministic demo assistant handlers (no LLM).\n *\n * - Validates envelope\n * - Requires citations\n * - Enforces allowedScope (education_only blocks actionable language)\n */\nexport function createDemoAssistantHandlers(): DemoAssistantHandlers {\n  async function answer(input: {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    envelope: DemoAssistantHandlers['answer'] extends (a: infer A) => any\n      ? A extends { envelope: infer E }\n        ? E\n        : never\n      : never;\n    question: string;\n  }): Promise<AssistantAnswerIR> {\n    const env = validateEnvelope(input.envelope);\n    if (!env.ok) {\n      return {\n        locale: input.envelope.locale ?? 'en-US',\n        jurisdiction:\n          input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n        allowedScope: input.envelope.allowedScope ?? 'education_only',\n        sections: [\n          {\n            heading: 'Request blocked',\n            body: env.error.message,\n          },\n        ],\n        citations: [],\n        disclaimers: [\n          'This system refuses to answer without a valid envelope.',\n        ],\n        riskFlags: [env.error.code],\n        refused: true,\n        refusalReason: env.error.code,\n      };\n    }\n\n    const draft: AssistantAnswerIR = {\n      locale: env.value.locale,\n      jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n      allowedScope: env.value.allowedScope ?? 'education_only',\n      sections: [\n        {\n          heading: 'Answer (demo)',\n          body: `You asked: \"${input.question}\". This demo answer is derived from the KB snapshot only.`,\n        },\n      ],\n      citations: [\n        {\n          kbSnapshotId: env.value.kbSnapshotId ?? 'unknown',\n          sourceType: 'ruleVersion',\n          sourceId: 'rv_demo',\n          title: 'Demo rule version',\n          excerpt: 'Demo excerpt',\n        },\n      ],\n      disclaimers: ['Educational demo only.'],\n      riskFlags: [],\n    };\n\n    const scope = enforceAllowedScope(env.value.allowedScope, draft);\n    if (!scope.ok) {\n      return {\n        ...draft,\n        sections: [\n          { heading: 'Escalation required', body: scope.error.message },\n        ],\n        citations: draft.citations,\n        refused: true,\n        refusalReason: scope.error.code,\n        riskFlags: [...(draft.riskFlags ?? []), scope.error.code],\n      };\n    }\n\n    const cited = enforceCitations(draft);\n    if (!cited.ok) {\n      return {\n        ...draft,\n        sections: [{ heading: 'Request blocked', body: cited.error.message }],\n        citations: [],\n        refused: true,\n        refusalReason: cited.error.code,\n        riskFlags: [...(draft.riskFlags ?? []), cited.error.code],\n      };\n    }\n\n    return draft;\n  }\n\n  async function explainConcept(input: {\n    envelope: DemoAssistantHandlers['explainConcept'] extends (\n      a: infer A\n    ) => any // eslint-disable-line @typescript-eslint/no-explicit-any\n      ? A extends { envelope: infer E }\n        ? E\n        : never\n      : never;\n    conceptKey: string;\n  }): Promise<AssistantAnswerIR> {\n    return await answer({\n      envelope: input.envelope,\n      question: `Explain concept: ${input.conceptKey}`,\n    });\n  }\n\n  return { answer, explainConcept };\n}\n"],"mappings":";;;;;;;;;;AAyDA,SAAgB,8BAAqD;CACnE,eAAe,OAAO,OAQS;EAC7B,MAAM,MAAM,iBAAiB,MAAM,SAAS;AAC5C,MAAI,CAAC,IAAI,GACP,QAAO;GACL,QAAQ,MAAM,SAAS,UAAU;GACjC,cACE,MAAM,SAAS,mBAAmB,gBAAgB;GACpD,cAAc,MAAM,SAAS,gBAAgB;GAC7C,UAAU,CACR;IACE,SAAS;IACT,MAAM,IAAI,MAAM;IACjB,CACF;GACD,WAAW,EAAE;GACb,aAAa,CACX,0DACD;GACD,WAAW,CAAC,IAAI,MAAM,KAAK;GAC3B,SAAS;GACT,eAAe,IAAI,MAAM;GAC1B;EAGH,MAAMA,QAA2B;GAC/B,QAAQ,IAAI,MAAM;GAClB,cAAc,IAAI,MAAM,mBAAmB,gBAAgB;GAC3D,cAAc,IAAI,MAAM,gBAAgB;GACxC,UAAU,CACR;IACE,SAAS;IACT,MAAM,eAAe,MAAM,SAAS;IACrC,CACF;GACD,WAAW,CACT;IACE,cAAc,IAAI,MAAM,gBAAgB;IACxC,YAAY;IACZ,UAAU;IACV,OAAO;IACP,SAAS;IACV,CACF;GACD,aAAa,CAAC,yBAAyB;GACvC,WAAW,EAAE;GACd;EAED,MAAM,QAAQ,oBAAoB,IAAI,MAAM,cAAc,MAAM;AAChE,MAAI,CAAC,MAAM,GACT,QAAO;GACL,GAAG;GACH,UAAU,CACR;IAAE,SAAS;IAAuB,MAAM,MAAM,MAAM;IAAS,CAC9D;GACD,WAAW,MAAM;GACjB,SAAS;GACT,eAAe,MAAM,MAAM;GAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;GAC1D;EAGH,MAAM,QAAQ,iBAAiB,MAAM;AACrC,MAAI,CAAC,MAAM,GACT,QAAO;GACL,GAAG;GACH,UAAU,CAAC;IAAE,SAAS;IAAmB,MAAM,MAAM,MAAM;IAAS,CAAC;GACrE,WAAW,EAAE;GACb,SAAS;GACT,eAAe,MAAM,MAAM;GAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;GAC1D;AAGH,SAAO;;CAGT,eAAe,eAAe,OASC;AAC7B,SAAO,MAAM,OAAO;GAClB,UAAU,MAAM;GAChB,UAAU,oBAAoB,MAAM;GACrC,CAAC;;AAGJ,QAAO;EAAE;EAAQ;EAAgB"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,2 @@
+import { DemoAssistantHandlers, createDemoAssistantHandlers } from "./demo.handlers.js";
+export { DemoAssistantHandlers, createDemoAssistantHandlers };

package/dist/handlers/index.js

@@ -0,0 +1,3 @@
+import { createDemoAssistantHandlers } from "./demo.handlers.js";
+
+export { createDemoAssistantHandlers };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { AllowedScopeEnum, AssistantAnswerIRModel, AssistantAnswerSectionModel, AssistantCitationModel, LLMCallEnvelopeModel, RegulatoryContextModel, UserProfileModel } from "./entities/models.js";
+import "./entities/index.js";
+import { AssistantAnswerBlockedEvent, AssistantAnswerDeliveredEvent, AssistantAnswerRequestedEvent } from "./events.js";
+import example from "./example.js";
+import { DemoAssistantHandlers, createDemoAssistantHandlers } from "./handlers/demo.handlers.js";
+import { AssistantAnswerContract, AssistantExplainConceptContract } from "./operations/assistant.js";
+import "./operations/index.js";
+import { AllowedScope, GateError, GateResult } from "./policy/types.js";
+import { enforceAllowedScope, enforceCitations, validateEnvelope } from "./policy/guard.js";
+import { LocaleJurisdictionGateFeature } from "./locale-jurisdiction-gate.feature.js";
+export { AllowedScope, AllowedScopeEnum, AssistantAnswerBlockedEvent, AssistantAnswerContract, AssistantAnswerDeliveredEvent, AssistantAnswerIRModel, AssistantAnswerRequestedEvent, AssistantAnswerSectionModel, AssistantCitationModel, AssistantExplainConceptContract, DemoAssistantHandlers, GateError, GateResult, LLMCallEnvelopeModel, LocaleJurisdictionGateFeature, RegulatoryContextModel, UserProfileModel, createDemoAssistantHandlers, enforceAllowedScope, enforceCitations, example, validateEnvelope };