@lssm/example.locale-jurisdiction-gate 0.0.0-canary-20251220041653 → 0.0.0-canary-20251221114240

package/dist/contracts/assistant.d.ts

@@ -1,245 +0,0 @@
-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_schema16.SchemaModel<{
-  envelope: {
-    type: _lssm_lib_schema16.SchemaModel<{
-      traceId: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      locale: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      regulatoryContext: {
-        type: _lssm_lib_schema16.SchemaModel<{
-          jurisdiction: {
-            type: _lssm_lib_schema16.FieldType<string, string>;
-            isOptional: false;
-          };
-          region: {
-            type: _lssm_lib_schema16.FieldType<string, string>;
-            isOptional: true;
-          };
-          clientType: {
-            type: _lssm_lib_schema16.FieldType<string, string>;
-            isOptional: true;
-          };
-          allowedScope: {
-            type: _lssm_lib_schema16.EnumType<[string, string, string]>;
-            isOptional: false;
-          };
-        }>;
-        isOptional: false;
-      };
-      kbSnapshotId: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      allowedScope: {
-        type: _lssm_lib_schema16.EnumType<[string, string, string]>;
-        isOptional: false;
-      };
-    }>;
-    isOptional: false;
-  };
-  question: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isOptional: false;
-  };
-}>, _lssm_lib_schema16.SchemaModel<{
-  locale: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isOptional: false;
-  };
-  jurisdiction: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isOptional: false;
-  };
-  allowedScope: {
-    type: _lssm_lib_schema16.EnumType<[string, string, string]>;
-    isOptional: false;
-  };
-  sections: {
-    type: _lssm_lib_schema16.SchemaModel<{
-      heading: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      body: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-    }>;
-    isArray: true;
-    isOptional: false;
-  };
-  citations: {
-    type: _lssm_lib_schema16.SchemaModel<{
-      kbSnapshotId: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      sourceType: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      sourceId: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      title: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: true;
-      };
-      excerpt: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: true;
-      };
-    }>;
-    isArray: true;
-    isOptional: false;
-  };
-  disclaimers: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isArray: true;
-    isOptional: true;
-  };
-  riskFlags: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isArray: true;
-    isOptional: true;
-  };
-  refused: {
-    type: _lssm_lib_schema16.FieldType<boolean, boolean>;
-    isOptional: true;
-  };
-  refusalReason: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isOptional: true;
-  };
-}>, undefined>;
-declare const AssistantExplainConceptContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema16.SchemaModel<{
-  envelope: {
-    type: _lssm_lib_schema16.SchemaModel<{
-      traceId: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      locale: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      regulatoryContext: {
-        type: _lssm_lib_schema16.SchemaModel<{
-          jurisdiction: {
-            type: _lssm_lib_schema16.FieldType<string, string>;
-            isOptional: false;
-          };
-          region: {
-            type: _lssm_lib_schema16.FieldType<string, string>;
-            isOptional: true;
-          };
-          clientType: {
-            type: _lssm_lib_schema16.FieldType<string, string>;
-            isOptional: true;
-          };
-          allowedScope: {
-            type: _lssm_lib_schema16.EnumType<[string, string, string]>;
-            isOptional: false;
-          };
-        }>;
-        isOptional: false;
-      };
-      kbSnapshotId: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      allowedScope: {
-        type: _lssm_lib_schema16.EnumType<[string, string, string]>;
-        isOptional: false;
-      };
-    }>;
-    isOptional: false;
-  };
-  conceptKey: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isOptional: false;
-  };
-}>, _lssm_lib_schema16.SchemaModel<{
-  locale: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isOptional: false;
-  };
-  jurisdiction: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isOptional: false;
-  };
-  allowedScope: {
-    type: _lssm_lib_schema16.EnumType<[string, string, string]>;
-    isOptional: false;
-  };
-  sections: {
-    type: _lssm_lib_schema16.SchemaModel<{
-      heading: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      body: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-    }>;
-    isArray: true;
-    isOptional: false;
-  };
-  citations: {
-    type: _lssm_lib_schema16.SchemaModel<{
-      kbSnapshotId: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      sourceType: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      sourceId: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: false;
-      };
-      title: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: true;
-      };
-      excerpt: {
-        type: _lssm_lib_schema16.FieldType<string, string>;
-        isOptional: true;
-      };
-    }>;
-    isArray: true;
-    isOptional: false;
-  };
-  disclaimers: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isArray: true;
-    isOptional: true;
-  };
-  riskFlags: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isArray: true;
-    isOptional: true;
-  };
-  refused: {
-    type: _lssm_lib_schema16.FieldType<boolean, boolean>;
-    isOptional: true;
-  };
-  refusalReason: {
-    type: _lssm_lib_schema16.FieldType<string, string>;
-    isOptional: true;
-  };
-}>, undefined>;
-//#endregion
-export { AssistantAnswerContract, AssistantExplainConceptContract };
-//# sourceMappingURL=assistant.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"assistant.d.ts","names":[],"sources":["../../src/contracts/assistant.ts"],"sourcesContent":[],"mappings":";;;;cA0Ba,8CAAuB,gCAAA;;;;QAAvB,IAAA,EAmDX,kBAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,KAAA;;;;;;;;;;;UAnDkC,CAAA;UAAA,MAAA,EAAA;;;;;;;;;;;;;;;;;kBAAA,EAAA,KAAA;MAAA,CAAA;MAqDvB,YAAA,EAAA;QAkBX,IAAA,6BAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;;;;;;;;;;;;IAlB0C,IAAA,EArDR,kBAAA,CAAA,SAqDQ,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;QAAA,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAA/B,sDAA+B,gCAAA;;;;cAkB1C,kBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAlB0C,kBAAA,CAAA"}

package/dist/contracts/assistant.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"assistant.js","names":["defineSchemaModel","ScalarTypeEnum"],"sources":["../../src/contracts/assistant.ts"],"sourcesContent":["import { defineCommand } from '@lssm/lib.contracts';\nimport { ScalarTypeEnum, defineSchemaModel } from '@lssm/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    name: '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    name: '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,GAAkB;CAC/C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,UAAU;GAAE,MAAM;GAAsB,YAAY;GAAO;EAC3D,UAAU;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE;CACF,CAAC;AAEF,MAAM,wBAAwBD,GAAkB;CAC9C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,UAAU;GAAE,MAAM;GAAsB,YAAY;GAAO;EAC3D,YAAY;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EAC1E;CACF,CAAC;AAEF,MAAa,0BAA0B,cAAc;CACnD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,WAAW;EACpB,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,MAAM;EACN,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,WAAW;EACpB,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/libs/contracts/dist/spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec.js","names":[],"sources":["../../../../../../libs/contracts/dist/spec.js"],"sourcesContent":["//#region src/spec.ts\nconst isEmitDeclRef = (e) => \"ref\" in e;\n/**\n* Helper to define a Command (write operation).\n* Sets `kind: 'command'` and defaults `idempotent: false`.\n*/\nconst defineCommand = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"command\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: spec.policy?.[\"policy\"]?.idempotent ?? false\n\t}\n});\n/**\n* Helper to define a Query (read-only operation).\n* Sets `kind: 'query'` and forces `idempotent: true`.\n*/\nconst defineQuery = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"query\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: true\n\t}\n});\n\n//#endregion\nexport { defineCommand, defineQuery, isEmitDeclRef };"],"mappings":";;;;;AAMA,MAAM,iBAAiB,UAAU;CAChC,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY,KAAK,SAAS,WAAW,cAAc;EACnD;CACD;;;;;AAKD,MAAM,eAAe,UAAU;CAC9B,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY;EACZ;CACD"}