@contractspec/example.locale-jurisdiction-gate 1.44.0

package/dist/index.js

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

package/dist/locale-jurisdiction-gate.feature.d.ts

@@ -0,0 +1,7 @@
+import { FeatureModuleSpec } from "@contractspec/lib.contracts";
+
+//#region src/locale-jurisdiction-gate.feature.d.ts
+declare const LocaleJurisdictionGateFeature: FeatureModuleSpec;
+//#endregion
+export { LocaleJurisdictionGateFeature };
+//# sourceMappingURL=locale-jurisdiction-gate.feature.d.ts.map

package/dist/locale-jurisdiction-gate.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-jurisdiction-gate.feature.d.ts","names":[],"sources":["../src/locale-jurisdiction-gate.feature.ts"],"sourcesContent":[],"mappings":";;;cAEa,+BAA+B"}

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

@@ -0,0 +1,51 @@
+//#region src/locale-jurisdiction-gate.feature.ts
+const LocaleJurisdictionGateFeature = {
+	meta: {
+		key: "locale-jurisdiction-gate",
+		version: 1,
+		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
+	}, {
+		key: "assistant.explainConcept",
+		version: 1
+	}],
+	events: [
+		{
+			key: "assistant.answer.requested",
+			version: 1
+		},
+		{
+			key: "assistant.answer.blocked",
+			version: 1
+		},
+		{
+			key: "assistant.answer.delivered",
+			version: 1
+		}
+	],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: { requires: [{
+		key: "knowledge",
+		version: 1
+	}] }
+};
+
+//#endregion
+export { LocaleJurisdictionGateFeature };
+//# sourceMappingURL=locale-jurisdiction-gate.feature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locale-jurisdiction-gate.feature.js","names":["LocaleJurisdictionGateFeature: FeatureModuleSpec"],"sources":["../src/locale-jurisdiction-gate.feature.ts"],"sourcesContent":["import type { FeatureModuleSpec } from '@contractspec/lib.contracts';\n\nexport const LocaleJurisdictionGateFeature: FeatureModuleSpec = {\n  meta: {\n    key: 'locale-jurisdiction-gate',\n    version: 1,\n    title: 'Locale + Jurisdiction Gate',\n    description:\n      'Fail-closed gating for assistant calls requiring locale/jurisdiction/snapshot/scope and citations.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['assistant', 'policy', 'locale', 'jurisdiction', 'knowledge'],\n    stability: 'experimental',\n  },\n  operations: [\n    { key: 'assistant.answer', version: 1 },\n    { key: 'assistant.explainConcept', version: 1 },\n  ],\n  events: [\n    { key: 'assistant.answer.requested', version: 1 },\n    { key: 'assistant.answer.blocked', version: 1 },\n    { key: 'assistant.answer.delivered', version: 1 },\n  ],\n  presentations: [],\n  opToPresentation: [],\n  presentationsTargets: [],\n  capabilities: {\n    requires: [{ key: 'knowledge', version: 1 }],\n  },\n};\n"],"mappings":";AAEA,MAAaA,gCAAmD;CAC9D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAU;GAAU;GAAgB;GAAY;EACpE,WAAW;EACZ;CACD,YAAY,CACV;EAAE,KAAK;EAAoB,SAAS;EAAG,EACvC;EAAE,KAAK;EAA4B,SAAS;EAAG,CAChD;CACD,QAAQ;EACN;GAAE,KAAK;GAA8B,SAAS;GAAG;EACjD;GAAE,KAAK;GAA4B,SAAS;GAAG;EAC/C;GAAE,KAAK;GAA8B,SAAS;GAAG;EAClD;CACD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CACxB,cAAc,EACZ,UAAU,CAAC;EAAE,KAAK;EAAa,SAAS;EAAG,CAAC,EAC7C;CACF"}

package/dist/operations/assistant.d.ts

@@ -0,0 +1,245 @@
+import * as _contractspec_lib_contracts2 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema63 from "@contractspec/lib.schema";
+
+//#region src/operations/assistant.d.ts
+declare const AssistantAnswerContract: _contractspec_lib_contracts2.OperationSpec<_contractspec_lib_schema63.SchemaModel<{
+  envelope: {
+    type: _contractspec_lib_schema63.SchemaModel<{
+      traceId: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      locale: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      regulatoryContext: {
+        type: _contractspec_lib_schema63.SchemaModel<{
+          jurisdiction: {
+            type: _contractspec_lib_schema63.FieldType<string, string>;
+            isOptional: false;
+          };
+          region: {
+            type: _contractspec_lib_schema63.FieldType<string, string>;
+            isOptional: true;
+          };
+          clientType: {
+            type: _contractspec_lib_schema63.FieldType<string, string>;
+            isOptional: true;
+          };
+          allowedScope: {
+            type: _contractspec_lib_schema63.EnumType<[string, string, string]>;
+            isOptional: false;
+          };
+        }>;
+        isOptional: false;
+      };
+      kbSnapshotId: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      allowedScope: {
+        type: _contractspec_lib_schema63.EnumType<[string, string, string]>;
+        isOptional: false;
+      };
+    }>;
+    isOptional: false;
+  };
+  question: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema63.SchemaModel<{
+  locale: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isOptional: false;
+  };
+  allowedScope: {
+    type: _contractspec_lib_schema63.EnumType<[string, string, string]>;
+    isOptional: false;
+  };
+  sections: {
+    type: _contractspec_lib_schema63.SchemaModel<{
+      heading: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      body: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  citations: {
+    type: _contractspec_lib_schema63.SchemaModel<{
+      kbSnapshotId: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      sourceType: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      sourceId: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      title: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: true;
+      };
+      excerpt: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  disclaimers: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+  riskFlags: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+  refused: {
+    type: _contractspec_lib_schema63.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  refusalReason: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const AssistantExplainConceptContract: _contractspec_lib_contracts2.OperationSpec<_contractspec_lib_schema63.SchemaModel<{
+  envelope: {
+    type: _contractspec_lib_schema63.SchemaModel<{
+      traceId: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      locale: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      regulatoryContext: {
+        type: _contractspec_lib_schema63.SchemaModel<{
+          jurisdiction: {
+            type: _contractspec_lib_schema63.FieldType<string, string>;
+            isOptional: false;
+          };
+          region: {
+            type: _contractspec_lib_schema63.FieldType<string, string>;
+            isOptional: true;
+          };
+          clientType: {
+            type: _contractspec_lib_schema63.FieldType<string, string>;
+            isOptional: true;
+          };
+          allowedScope: {
+            type: _contractspec_lib_schema63.EnumType<[string, string, string]>;
+            isOptional: false;
+          };
+        }>;
+        isOptional: false;
+      };
+      kbSnapshotId: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      allowedScope: {
+        type: _contractspec_lib_schema63.EnumType<[string, string, string]>;
+        isOptional: false;
+      };
+    }>;
+    isOptional: false;
+  };
+  conceptKey: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema63.SchemaModel<{
+  locale: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isOptional: false;
+  };
+  jurisdiction: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isOptional: false;
+  };
+  allowedScope: {
+    type: _contractspec_lib_schema63.EnumType<[string, string, string]>;
+    isOptional: false;
+  };
+  sections: {
+    type: _contractspec_lib_schema63.SchemaModel<{
+      heading: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      body: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  citations: {
+    type: _contractspec_lib_schema63.SchemaModel<{
+      kbSnapshotId: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      sourceType: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      sourceId: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: false;
+      };
+      title: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: true;
+      };
+      excerpt: {
+        type: _contractspec_lib_schema63.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  disclaimers: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+  riskFlags: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+  refused: {
+    type: _contractspec_lib_schema63.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  refusalReason: {
+    type: _contractspec_lib_schema63.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+//#endregion
+export { AssistantAnswerContract, AssistantExplainConceptContract };
+//# sourceMappingURL=assistant.d.ts.map

package/dist/operations/assistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.d.ts","names":[],"sources":["../../src/operations/assistant.ts"],"sourcesContent":[],"mappings":";;;;cA0Ba,sDAAuB,yCAAA;;;;QAAvB,IAAA,EAmDX,0BAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,KAAA;;;;;;;;;;;;UAnDkC,MAAA,EAAA;;;;;;;;;;;;;;;;;yBAAA;MAAA,CAAA;MAqDvB,YAAA,EAAA;QAkBX,IAAA,qCAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;;;;;;;;;;;;IAlB0C,IAAA,EArDR,0BAAA,CAAA,SAqDQ,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;QAAA,IAAA,sCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAA/B,8DAA+B,yCAAA;;;;cAkB1C,0BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAlB0C,0BAAA,CAAA"}

package/dist/operations/assistant.js

@@ -0,0 +1,115 @@
+import { AssistantAnswerIRModel, LLMCallEnvelopeModel } from "../entities/models.js";
+import { defineCommand } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum, defineSchemaModel as defineSchemaModel$1 } from "@contractspec/lib.schema";
+
+//#region src/operations/assistant.ts
+const AssistantQuestionInput = defineSchemaModel$1({
+	name: "AssistantQuestionInput",
+	description: "Input for assistant calls with mandatory envelope.",
+	fields: {
+		envelope: {
+			type: LLMCallEnvelopeModel,
+			isOptional: false
+		},
+		question: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const AssistantConceptInput = defineSchemaModel$1({
+	name: "AssistantConceptInput",
+	description: "Input for explaining a concept with mandatory envelope.",
+	fields: {
+		envelope: {
+			type: LLMCallEnvelopeModel,
+			isOptional: false
+		},
+		conceptKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const AssistantAnswerContract = defineCommand({
+	meta: {
+		key: "assistant.answer",
+		version: 1,
+		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" }
+});
+const AssistantExplainConceptContract = defineCommand({
+	meta: {
+		key: "assistant.explainConcept",
+		version: 1,
+		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" }
+});
+
+//#endregion
+export { AssistantAnswerContract, AssistantExplainConceptContract };
+//# sourceMappingURL=assistant.js.map

package/dist/operations/assistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.js","names":["defineSchemaModel"],"sources":["../../src/operations/assistant.ts"],"sourcesContent":["import { defineCommand } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\n\nimport {\n  AssistantAnswerIRModel,\n  LLMCallEnvelopeModel,\n} from '../entities/models';\n\nconst AssistantQuestionInput = defineSchemaModel({\n  name: 'AssistantQuestionInput',\n  description: 'Input for assistant calls with mandatory envelope.',\n  fields: {\n    envelope: { type: LLMCallEnvelopeModel, isOptional: false },\n    question: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst AssistantConceptInput = defineSchemaModel({\n  name: 'AssistantConceptInput',\n  description: 'Input for explaining a concept with mandatory envelope.',\n  fields: {\n    envelope: { type: LLMCallEnvelopeModel, isOptional: false },\n    conceptKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const AssistantAnswerContract = defineCommand({\n  meta: {\n    key: 'assistant.answer',\n    version: 1,\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['assistant', 'policy', 'locale', 'jurisdiction', 'knowledge'],\n    description:\n      'Answer a user question using a KB snapshot with strict locale/jurisdiction gating.',\n    goal: 'Provide policy-safe answers that cite a KB snapshot or refuse.',\n    context:\n      'Called by UI or workflows; must fail-closed if envelope is invalid or citations are missing.',\n  },\n  io: {\n    input: AssistantQuestionInput,\n    output: AssistantAnswerIRModel,\n    errors: {\n      LOCALE_REQUIRED: {\n        description: 'Locale is required and must be supported',\n        http: 400,\n        gqlCode: 'LOCALE_REQUIRED',\n        when: 'locale is missing or unsupported',\n      },\n      JURISDICTION_REQUIRED: {\n        description: 'Jurisdiction is required',\n        http: 400,\n        gqlCode: 'JURISDICTION_REQUIRED',\n        when: 'jurisdiction is missing',\n      },\n      KB_SNAPSHOT_REQUIRED: {\n        description: 'KB snapshot id is required',\n        http: 400,\n        gqlCode: 'KB_SNAPSHOT_REQUIRED',\n        when: 'kbSnapshotId is missing',\n      },\n      CITATIONS_REQUIRED: {\n        description: 'Answers must include citations to a KB snapshot',\n        http: 422,\n        gqlCode: 'CITATIONS_REQUIRED',\n        when: 'answer has no citations',\n      },\n      SCOPE_VIOLATION: {\n        description:\n          'Answer violates allowed scope and must be refused/escalated',\n        http: 403,\n        gqlCode: 'SCOPE_VIOLATION',\n        when: 'output includes forbidden content under the given allowedScope',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n});\n\nexport const AssistantExplainConceptContract = defineCommand({\n  meta: {\n    key: 'assistant.explainConcept',\n    version: 1,\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['assistant', 'policy', 'knowledge', 'concepts'],\n    description:\n      'Explain a concept using a KB snapshot with strict locale/jurisdiction gating.',\n    goal: 'Explain concepts with citations or refuse.',\n    context: 'Same constraints as assistant.answer.',\n  },\n  io: {\n    input: AssistantConceptInput,\n    output: AssistantAnswerIRModel,\n    errors: AssistantAnswerContract.io.errors,\n  },\n  policy: { auth: 'user' },\n});\n"],"mappings":";;;;;AAQA,MAAM,yBAAyBA,oBAAkB;CAC/C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,UAAU;GAAE,MAAM;GAAsB,YAAY;GAAO;EAC3D,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE;CACF,CAAC;AAEF,MAAM,wBAAwBA,oBAAkB;CAC9C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,UAAU;GAAE,MAAM;GAAsB,YAAY;GAAO;EAC3D,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC1E;CACF,CAAC;AAEF,MAAa,0BAA0B,cAAc;CACnD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAU;GAAU;GAAgB;GAAY;EACpE,aACE;EACF,MAAM;EACN,SACE;EACH;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACR,QAAQ;GACN,iBAAiB;IACf,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACD,uBAAuB;IACrB,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACD,sBAAsB;IACpB,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACD,oBAAoB;IAClB,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACD,iBAAiB;IACf,aACE;IACF,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACF;EACF;CACD,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC;AAEF,MAAa,kCAAkC,cAAc;CAC3D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAU;GAAa;GAAW;EACtD,aACE;EACF,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACR,QAAQ,wBAAwB,GAAG;EACpC;CACD,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC"}

package/dist/operations/index.d.ts

@@ -0,0 +1,2 @@
+import { AssistantAnswerContract, AssistantExplainConceptContract } from "./assistant.js";
+export { AssistantAnswerContract, AssistantExplainConceptContract };

package/dist/operations/index.js

@@ -0,0 +1,3 @@
+import { AssistantAnswerContract, AssistantExplainConceptContract } from "./assistant.js";
+
+export { AssistantAnswerContract, AssistantExplainConceptContract };

package/dist/policy/guard.d.ts

@@ -0,0 +1,27 @@
+import { GateResult } from "./types.js";
+
+//#region src/policy/guard.d.ts
+interface EnvelopeLike {
+  locale?: string;
+  kbSnapshotId?: string;
+  allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
+  regulatoryContext?: {
+    jurisdiction?: string;
+  };
+}
+interface AnswerLike {
+  citations?: unknown[];
+  sections?: {
+    heading: string;
+    body: string;
+  }[];
+  refused?: boolean;
+  refusalReason?: string;
+  allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
+}
+declare function validateEnvelope(envelope: EnvelopeLike): GateResult<Required<EnvelopeLike>>;
+declare function enforceCitations(answer: AnswerLike): GateResult<AnswerLike>;
+declare function enforceAllowedScope(allowedScope: EnvelopeLike['allowedScope'], answer: AnswerLike): GateResult<AnswerLike>;
+//#endregion
+export { enforceAllowedScope, enforceCitations, validateEnvelope };
+//# sourceMappingURL=guard.d.ts.map

package/dist/policy/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","names":[],"sources":["../../src/policy/guard.ts"],"sourcesContent":[],"mappings":";;;UAEU,YAAA;;EAAA,YAAA,CAAA,EAAY,MAAA;EAOZ,YAAA,CAAU,EAAA,gBAAA,GAAA,cAAA,GAAA,qBAAA;EAcJ,iBAAA,CAAA,EAAgB;IACpB,YAAA,CAAA,EAAA,MAAA;EACW,CAAA;;UAhBb,UAAA,CAgBP;EAAU,SAAA,CAAA,EAAA,OAAA,EAAA;EA4BG,QAAA,CAAA,EAAA;IAAyB,OAAA,EAAA,MAAA;IAAwB,IAAA,EAAA,MAAA;EAAX,CAAA,EAAA;EAAU,OAAA,CAAA,EAAA,OAAA;EAoBhD,aAAA,CAAA,EAAA,MAAmB;EACnB,YAAA,CAAA,EAAA,gBAAA,GAAA,cAAA,GAAA,qBAAA;;AAEF,iBArDE,gBAAA,CAqDF,QAAA,EApDF,YAoDE,CAAA,EAnDX,UAmDW,CAnDA,QAmDA,CAnDS,YAmDT,CAAA,CAAA;AAAX,iBAvBa,gBAAA,CAuBb,MAAA,EAvBsC,UAuBtC,CAAA,EAvBmD,UAuBnD,CAvB8D,UAuB9D,CAAA;AAAU,iBAHG,mBAAA,CAGH,YAAA,EAFG,YAEH,CAAA,cAAA,CAAA,EAAA,MAAA,EADH,UACG,CAAA,EAAV,UAAU,CAAC,UAAD,CAAA"}

package/dist/policy/guard.js

@@ -0,0 +1,73 @@
+//#region src/policy/guard.ts
+const 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
+	};
+}
+const 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("\n");
+	if (EDUCATION_ONLY_FORBIDDEN_PATTERNS.some((re) => re.test(bodies))) return {
+		ok: false,
+		error: err("SCOPE_VIOLATION", "answer violates education_only scope (contains actionable or promotional language)")
+	};
+	return {
+		ok: true,
+		value: answer
+	};
+}
+
+//#endregion
+export { enforceAllowedScope, enforceCitations, validateEnvelope };
+//# sourceMappingURL=guard.js.map

package/dist/policy/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","names":["EDUCATION_ONLY_FORBIDDEN_PATTERNS: RegExp[]"],"sources":["../../src/policy/guard.ts"],"sourcesContent":["import type { GateError, GateResult } from './types';\n\ninterface EnvelopeLike {\n  locale?: string;\n  kbSnapshotId?: string;\n  allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';\n  regulatoryContext?: { jurisdiction?: string };\n}\n\ninterface AnswerLike {\n  citations?: unknown[];\n  sections?: { heading: string; body: string }[];\n  refused?: boolean;\n  refusalReason?: string;\n  allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';\n}\n\nconst SUPPORTED_LOCALES = new Set<string>(['en-US', 'en-GB', 'fr-FR']);\n\nfunction err(code: GateError['code'], message: string): GateError {\n  return { code, message };\n}\n\nexport function validateEnvelope(\n  envelope: EnvelopeLike\n): GateResult<Required<EnvelopeLike>> {\n  if (!envelope.locale || !SUPPORTED_LOCALES.has(envelope.locale)) {\n    return {\n      ok: false,\n      error: err('LOCALE_REQUIRED', 'locale is required and must be supported'),\n    };\n  }\n  if (!envelope.regulatoryContext?.jurisdiction) {\n    return {\n      ok: false,\n      error: err('JURISDICTION_REQUIRED', 'jurisdiction is required'),\n    };\n  }\n  if (!envelope.kbSnapshotId) {\n    return {\n      ok: false,\n      error: err('KB_SNAPSHOT_REQUIRED', 'kbSnapshotId is required'),\n    };\n  }\n  if (!envelope.allowedScope) {\n    return {\n      ok: false,\n      error: err('SCOPE_VIOLATION', 'allowedScope is required'),\n    };\n  }\n  return { ok: true, value: envelope as Required<EnvelopeLike> };\n}\n\nexport function enforceCitations(answer: AnswerLike): GateResult<AnswerLike> {\n  const citations = answer.citations ?? [];\n  if (!Array.isArray(citations) || citations.length === 0) {\n    return {\n      ok: false,\n      error: err(\n        'CITATIONS_REQUIRED',\n        'answers must include at least one citation'\n      ),\n    };\n  }\n  return { ok: true, value: answer };\n}\n\nconst EDUCATION_ONLY_FORBIDDEN_PATTERNS: RegExp[] = [\n  /\\b(buy|sell)\\b/i,\n  /\\b(should\\s+buy|should\\s+sell)\\b/i,\n  /\\b(guarantee(d)?|promise(d)?)\\b/i,\n];\n\nexport function enforceAllowedScope(\n  allowedScope: EnvelopeLike['allowedScope'],\n  answer: AnswerLike\n): GateResult<AnswerLike> {\n  if (!allowedScope) {\n    return {\n      ok: false,\n      error: err('SCOPE_VIOLATION', 'allowedScope is required'),\n    };\n  }\n  if (allowedScope !== 'education_only') {\n    return { ok: true, value: answer };\n  }\n\n  const bodies = (answer.sections ?? []).map((s) => s.body).join('\\n');\n  const violations = EDUCATION_ONLY_FORBIDDEN_PATTERNS.some((re) =>\n    re.test(bodies)\n  );\n  if (violations) {\n    return {\n      ok: false,\n      error: err(\n        'SCOPE_VIOLATION',\n        'answer violates education_only scope (contains actionable or promotional language)'\n      ),\n    };\n  }\n  return { ok: true, value: answer };\n}\n"],"mappings":";AAiBA,MAAM,oBAAoB,IAAI,IAAY;CAAC;CAAS;CAAS;CAAQ,CAAC;AAEtE,SAAS,IAAI,MAAyB,SAA4B;AAChE,QAAO;EAAE;EAAM;EAAS;;AAG1B,SAAgB,iBACd,UACoC;AACpC,KAAI,CAAC,SAAS,UAAU,CAAC,kBAAkB,IAAI,SAAS,OAAO,CAC7D,QAAO;EACL,IAAI;EACJ,OAAO,IAAI,mBAAmB,2CAA2C;EAC1E;AAEH,KAAI,CAAC,SAAS,mBAAmB,aAC/B,QAAO;EACL,IAAI;EACJ,OAAO,IAAI,yBAAyB,2BAA2B;EAChE;AAEH,KAAI,CAAC,SAAS,aACZ,QAAO;EACL,IAAI;EACJ,OAAO,IAAI,wBAAwB,2BAA2B;EAC/D;AAEH,KAAI,CAAC,SAAS,aACZ,QAAO;EACL,IAAI;EACJ,OAAO,IAAI,mBAAmB,2BAA2B;EAC1D;AAEH,QAAO;EAAE,IAAI;EAAM,OAAO;EAAoC;;AAGhE,SAAgB,iBAAiB,QAA4C;CAC3E,MAAM,YAAY,OAAO,aAAa,EAAE;AACxC,KAAI,CAAC,MAAM,QAAQ,UAAU,IAAI,UAAU,WAAW,EACpD,QAAO;EACL,IAAI;EACJ,OAAO,IACL,sBACA,6CACD;EACF;AAEH,QAAO;EAAE,IAAI;EAAM,OAAO;EAAQ;;AAGpC,MAAMA,oCAA8C;CAClD;CACA;CACA;CACD;AAED,SAAgB,oBACd,cACA,QACwB;AACxB,KAAI,CAAC,aACH,QAAO;EACL,IAAI;EACJ,OAAO,IAAI,mBAAmB,2BAA2B;EAC1D;AAEH,KAAI,iBAAiB,iBACnB,QAAO;EAAE,IAAI;EAAM,OAAO;EAAQ;CAGpC,MAAM,UAAU,OAAO,YAAY,EAAE,EAAE,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,KAAK;AAIpE,KAHmB,kCAAkC,MAAM,OACzD,GAAG,KAAK,OAAO,CAChB,CAEC,QAAO;EACL,IAAI;EACJ,OAAO,IACL,mBACA,qFACD;EACF;AAEH,QAAO;EAAE,IAAI;EAAM,OAAO;EAAQ"}

package/dist/policy/index.d.ts

@@ -0,0 +1,3 @@
+import { AllowedScope, GateError, GateResult } from "./types.js";
+import { enforceAllowedScope, enforceCitations, validateEnvelope } from "./guard.js";
+export { AllowedScope, GateError, GateResult, enforceAllowedScope, enforceCitations, validateEnvelope };

package/dist/policy/index.js

@@ -0,0 +1,3 @@
+import { enforceAllowedScope, enforceCitations, validateEnvelope } from "./guard.js";
+
+export { enforceAllowedScope, enforceCitations, validateEnvelope };

package/dist/policy/types.d.ts

@@ -0,0 +1,16 @@
+//#region src/policy/types.d.ts
+type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
+interface GateError {
+  code: 'LOCALE_REQUIRED' | 'JURISDICTION_REQUIRED' | 'KB_SNAPSHOT_REQUIRED' | 'CITATIONS_REQUIRED' | 'SCOPE_VIOLATION';
+  message: string;
+}
+type GateResult<T> = {
+  ok: true;
+  value: T;
+} | {
+  ok: false;
+  error: GateError;
+};
+//#endregion
+export { AllowedScope, GateError, GateResult };
+//# sourceMappingURL=types.d.ts.map

package/dist/policy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/policy/types.ts"],"sourcesContent":[],"mappings":";KAAY,YAAA;AAAA,UAKK,SAAA,CALO;EAKP,IAAA,EAAA,iBAAS,GAAA,uBAAA,GAAA,sBAAA,GAAA,oBAAA,GAAA,iBAAA;EAUd,OAAA,EAAA,MAAU;;KAAV;;SACW;;;SACC"}

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';