@lssm/example.locale-jurisdiction-gate 0.0.0-canary-20251217062943 → 0.0.0-canary-20251217072406

package/dist/contracts/assistant.d.ts

@@ -1,75 +1,75 @@
-import * as _lssm_lib_schema63 from "@lssm/lib.schema";
+import * as _lssm_lib_schema16 from "@lssm/lib.schema";
 import * as _lssm_lib_contracts2 from "@lssm/lib.contracts";
 
 //#region src/contracts/assistant.d.ts
-declare const AssistantAnswerContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema63.SchemaModel<{
+declare const AssistantAnswerContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema16.SchemaModel<{
   envelope: {
-    type: _lssm_lib_schema63.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       traceId: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       locale: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       regulatoryContext: {
-        type: _lssm_lib_schema63.SchemaModel<{
+        type: _lssm_lib_schema16.SchemaModel<{
           jurisdiction: {
-            type: _lssm_lib_schema63.FieldType<string, string>;
+            type: _lssm_lib_schema16.FieldType<string, string>;
             isOptional: false;
           };
           region: {
-            type: _lssm_lib_schema63.FieldType<string, string>;
+            type: _lssm_lib_schema16.FieldType<string, string>;
             isOptional: true;
           };
           clientType: {
-            type: _lssm_lib_schema63.FieldType<string, string>;
+            type: _lssm_lib_schema16.FieldType<string, string>;
             isOptional: true;
           };
           allowedScope: {
-            type: _lssm_lib_schema63.EnumType<[string, string, string]>;
+            type: _lssm_lib_schema16.EnumType<[string, string, string]>;
             isOptional: false;
           };
         }>;
         isOptional: false;
       };
       kbSnapshotId: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       allowedScope: {
-        type: _lssm_lib_schema63.EnumType<[string, string, string]>;
+        type: _lssm_lib_schema16.EnumType<[string, string, string]>;
         isOptional: false;
       };
     }>;
     isOptional: false;
   };
   question: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema63.SchemaModel<{
+}>, _lssm_lib_schema16.SchemaModel<{
   locale: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   allowedScope: {
-    type: _lssm_lib_schema63.EnumType<[string, string, string]>;
+    type: _lssm_lib_schema16.EnumType<[string, string, string]>;
     isOptional: false;
   };
   sections: {
-    type: _lssm_lib_schema63.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       heading: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       body: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
     }>;
@@ -77,25 +77,25 @@ declare const AssistantAnswerContract: _lssm_lib_contracts2.ContractSpec<_lssm_l
     isOptional: false;
   };
   citations: {
-    type: _lssm_lib_schema63.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       kbSnapshotId: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       sourceType: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       sourceId: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       title: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: true;
       };
       excerpt: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -103,92 +103,92 @@ declare const AssistantAnswerContract: _lssm_lib_contracts2.ContractSpec<_lssm_l
     isOptional: false;
   };
   disclaimers: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isArray: true;
     isOptional: true;
   };
   riskFlags: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isArray: true;
     isOptional: true;
   };
   refused: {
-    type: _lssm_lib_schema63.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema16.FieldType<boolean, boolean>;
     isOptional: true;
   };
   refusalReason: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;
-declare const AssistantExplainConceptContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema63.SchemaModel<{
+declare const AssistantExplainConceptContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema16.SchemaModel<{
   envelope: {
-    type: _lssm_lib_schema63.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       traceId: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       locale: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       regulatoryContext: {
-        type: _lssm_lib_schema63.SchemaModel<{
+        type: _lssm_lib_schema16.SchemaModel<{
           jurisdiction: {
-            type: _lssm_lib_schema63.FieldType<string, string>;
+            type: _lssm_lib_schema16.FieldType<string, string>;
             isOptional: false;
           };
           region: {
-            type: _lssm_lib_schema63.FieldType<string, string>;
+            type: _lssm_lib_schema16.FieldType<string, string>;
             isOptional: true;
           };
           clientType: {
-            type: _lssm_lib_schema63.FieldType<string, string>;
+            type: _lssm_lib_schema16.FieldType<string, string>;
             isOptional: true;
           };
           allowedScope: {
-            type: _lssm_lib_schema63.EnumType<[string, string, string]>;
+            type: _lssm_lib_schema16.EnumType<[string, string, string]>;
             isOptional: false;
           };
         }>;
         isOptional: false;
       };
       kbSnapshotId: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       allowedScope: {
-        type: _lssm_lib_schema63.EnumType<[string, string, string]>;
+        type: _lssm_lib_schema16.EnumType<[string, string, string]>;
         isOptional: false;
       };
     }>;
     isOptional: false;
   };
   conceptKey: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema63.SchemaModel<{
+}>, _lssm_lib_schema16.SchemaModel<{
   locale: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   allowedScope: {
-    type: _lssm_lib_schema63.EnumType<[string, string, string]>;
+    type: _lssm_lib_schema16.EnumType<[string, string, string]>;
     isOptional: false;
   };
   sections: {
-    type: _lssm_lib_schema63.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       heading: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       body: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
     }>;
@@ -196,25 +196,25 @@ declare const AssistantExplainConceptContract: _lssm_lib_contracts2.ContractSpec
     isOptional: false;
   };
   citations: {
-    type: _lssm_lib_schema63.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       kbSnapshotId: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       sourceType: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       sourceId: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       title: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: true;
       };
       excerpt: {
-        type: _lssm_lib_schema63.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -222,21 +222,21 @@ declare const AssistantExplainConceptContract: _lssm_lib_contracts2.ContractSpec
     isOptional: false;
   };
   disclaimers: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isArray: true;
     isOptional: true;
   };
   riskFlags: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isArray: true;
     isOptional: true;
   };
   refused: {
-    type: _lssm_lib_schema63.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema16.FieldType<boolean, boolean>;
     isOptional: true;
   };
   refusalReason: {
-    type: _lssm_lib_schema63.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;

package/dist/contracts/assistant.js

@@ -1 +1,117 @@
-import{t as e}from"../libs/contracts/dist/spec.js";import"../libs/contracts/dist/index.js";import{l as t}from"../libs/schema/dist/ScalarTypeEnum.js";import{n}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";import{AssistantAnswerIRModel as r,LLMCallEnvelopeModel as i}from"../entities/models.js";const a=n({name:`AssistantQuestionInput`,description:`Input for assistant calls with mandatory envelope.`,fields:{envelope:{type:i,isOptional:!1},question:{type:t.String_unsecure(),isOptional:!1}}}),o=n({name:`AssistantConceptInput`,description:`Input for explaining a concept with mandatory envelope.`,fields:{envelope:{type:i,isOptional:!1},conceptKey:{type:t.String_unsecure(),isOptional:!1}}}),s=e({meta:{name:`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:a,output:r,errors:{LOCALE_REQUIRED:{description:`Locale is required and must be supported`,http:400,gqlCode:`LOCALE_REQUIRED`,when:`locale is missing or unsupported`},JURISDICTION_REQUIRED:{description:`Jurisdiction is required`,http:400,gqlCode:`JURISDICTION_REQUIRED`,when:`jurisdiction is missing`},KB_SNAPSHOT_REQUIRED:{description:`KB snapshot id is required`,http:400,gqlCode:`KB_SNAPSHOT_REQUIRED`,when:`kbSnapshotId is missing`},CITATIONS_REQUIRED:{description:`Answers must include citations to a KB snapshot`,http:422,gqlCode:`CITATIONS_REQUIRED`,when:`answer has no citations`},SCOPE_VIOLATION:{description:`Answer violates allowed scope and must be refused/escalated`,http:403,gqlCode:`SCOPE_VIOLATION`,when:`output includes forbidden content under the given allowedScope`}}},policy:{auth:`user`}}),c=e({meta:{name:`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:o,output:r,errors:s.io.errors},policy:{auth:`user`}});export{s as AssistantAnswerContract,c as AssistantExplainConceptContract};
+import { defineCommand } from "../libs/contracts/dist/spec.js";
+import "../libs/contracts/dist/index.js";
+import { ScalarTypeEnum } from "../libs/schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "../libs/schema/dist/SchemaModel.js";
+import "../libs/schema/dist/index.js";
+import { AssistantAnswerIRModel, LLMCallEnvelopeModel } from "../entities/models.js";
+
+//#region src/contracts/assistant.ts
+const AssistantQuestionInput = defineSchemaModel({
+	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({
+	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: {
+		name: "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: {
+		name: "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 };

package/dist/contracts/index.js

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

package/dist/docs/index.js

@@ -1 +1 @@
-import"./locale-jurisdiction-gate.docblock.js";
+import "./locale-jurisdiction-gate.docblock.js";

package/dist/docs/locale-jurisdiction-gate.docblock.js

@@ -1,11 +1,42 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{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 } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
+
+//#region src/docs/locale-jurisdiction-gate.docblock.ts
+registerDocBlocks([{
+	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)
 
@@ -16,4 +47,7 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 ## Events
 - assistant.answer.requested
 - assistant.answer.blocked
-- assistant.answer.delivered`}]);
+- assistant.answer.delivered`
+}]);
+
+//#endregion

package/dist/entities/index.js

@@ -1 +1,3 @@
-import{AllowedScopeEnum as e,AssistantAnswerIRModel as t,AssistantAnswerSectionModel as n,AssistantCitationModel as r,LLMCallEnvelopeModel as i,RegulatoryContextModel as a,UserProfileModel as o}from"./models.js";export{e as AllowedScopeEnum,t as AssistantAnswerIRModel,n as AssistantAnswerSectionModel,r as AssistantCitationModel,i as LLMCallEnvelopeModel,a as RegulatoryContextModel,o as UserProfileModel};
+import { AllowedScopeEnum, AssistantAnswerIRModel, AssistantAnswerSectionModel, AssistantCitationModel, LLMCallEnvelopeModel, RegulatoryContextModel, UserProfileModel } from "./models.js";
+
+export { AllowedScopeEnum, AssistantAnswerIRModel, AssistantAnswerSectionModel, AssistantCitationModel, LLMCallEnvelopeModel, RegulatoryContextModel, UserProfileModel };