@contractspec/example.policy-safe-knowledge-assistant 1.57.0 → 1.58.0

package/dist/handlers/policy-safe-knowledge-assistant.handlers.d.ts

@@ -1,126 +1,129 @@
-import { AssistantAnswerIR } from "../orchestrator/buildAnswer.js";
-import "../index.js";
-import { DatabasePort } from "@contractspec/lib.runtime-sandbox";
-
-//#region src/handlers/policy-safe-knowledge-assistant.handlers.d.ts
+/**
+ * Runtime-local handlers for the Policy-safe Knowledge Assistant template.
+ *
+ * These handlers are intentionally minimal and deterministic:
+ * - No external LLM calls
+ * - No web fetching as primary truth
+ * - Answers are derived from KB snapshots and must include citations
+ */
+import type { DatabasePort } from '@contractspec/lib.runtime-sandbox';
 type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
 type RiskLevel = 'low' | 'medium' | 'high';
 type ReviewRole = 'curator' | 'expert';
-declare function createPolicySafeKnowledgeAssistantHandlers(db: DatabasePort): {
-  getUserContext: (input: {
-    projectId: string;
-  }) => Promise<{
-    projectId: string;
-    locale: string;
-    jurisdiction: string;
-    allowedScope: AllowedScope;
-    kbSnapshotId: string | null;
-  }>;
-  setUserContext: (input: {
-    projectId: string;
-    locale: string;
-    jurisdiction: string;
-    allowedScope: AllowedScope;
-  }) => Promise<{
-    projectId: string;
-    locale: string;
-    jurisdiction: string;
-    allowedScope: AllowedScope;
-    kbSnapshotId: string | null;
-  }>;
-  createRule: (input: {
-    projectId: string;
-    jurisdiction: string;
-    topicKey: string;
-  }) => Promise<{
-    projectId: string;
-    jurisdiction: string;
-    topicKey: string;
-    id: string;
-  }>;
-  upsertRuleVersion: (input: {
-    projectId: string;
-    ruleId: string;
-    content: string;
-    sourceRefs: {
-      sourceDocumentId: string;
-      excerpt?: string;
-    }[];
-  }) => Promise<{
-    id: string;
-    ruleId: string;
-    jurisdiction: string;
-    topicKey: string;
-    version: number;
-    content: string;
-    status: string;
-    sourceRefs: {
-      sourceDocumentId: string;
-      excerpt?: string;
-    }[];
-    createdAt: Date;
-  }>;
-  approveRuleVersion: (input: {
-    ruleVersionId: string;
-    approver: string;
-  }) => Promise<{
-    ruleVersionId: string;
-    status: "approved";
-  }>;
-  publishSnapshot: (input: {
-    projectId: string;
-    jurisdiction: string;
-    asOfDate: Date;
-  }) => Promise<{
-    id: string;
-    jurisdiction: string;
-    includedRuleVersionIds: string[];
-  }>;
-  searchKb: (input: {
-    snapshotId: string;
-    jurisdiction: string;
-    query: string;
-  }) => Promise<{
-    items: {
-      ruleVersionId: string;
-      excerpt?: string;
-    }[];
-  }>;
-  answer: (input: {
-    projectId: string;
-    question: string;
-  }) => Promise<AssistantAnswerIR>;
-  createChangeCandidate: (input: {
-    projectId: string;
-    jurisdiction: string;
-    diffSummary: string;
-    riskLevel: RiskLevel;
-    proposedRuleVersionIds: string[];
-  }) => Promise<{
-    id: string;
-  }>;
-  createReviewTask: (input: {
-    changeCandidateId: string;
-  }) => Promise<{
-    id: string;
-    assignedRole: ReviewRole;
-  }>;
-  submitDecision: (input: {
-    reviewTaskId: string;
-    decision: "approve" | "reject";
-    decidedByRole: ReviewRole;
-    decidedBy: string;
-  }) => Promise<{
-    id: string;
-    status: "decided";
-  }>;
-  publishIfReady: (input: {
-    jurisdiction: string;
-  }) => Promise<{
-    published: true;
-  }>;
+export declare function createPolicySafeKnowledgeAssistantHandlers(db: DatabasePort): {
+    getUserContext: (input: {
+        projectId: string;
+    }) => Promise<{
+        projectId: string;
+        locale: string;
+        jurisdiction: string;
+        allowedScope: AllowedScope;
+        kbSnapshotId: string | null;
+    }>;
+    setUserContext: (input: {
+        projectId: string;
+        locale: string;
+        jurisdiction: string;
+        allowedScope: AllowedScope;
+    }) => Promise<{
+        projectId: string;
+        locale: string;
+        jurisdiction: string;
+        allowedScope: AllowedScope;
+        kbSnapshotId: string | null;
+    }>;
+    createRule: (input: {
+        projectId: string;
+        jurisdiction: string;
+        topicKey: string;
+    }) => Promise<{
+        projectId: string;
+        jurisdiction: string;
+        topicKey: string;
+        id: string;
+    }>;
+    upsertRuleVersion: (input: {
+        projectId: string;
+        ruleId: string;
+        content: string;
+        sourceRefs: {
+            sourceDocumentId: string;
+            excerpt?: string;
+        }[];
+    }) => Promise<{
+        id: string;
+        ruleId: string;
+        jurisdiction: string;
+        topicKey: string;
+        version: number;
+        content: string;
+        status: string;
+        sourceRefs: {
+            sourceDocumentId: string;
+            excerpt?: string;
+        }[];
+        createdAt: Date;
+    }>;
+    approveRuleVersion: (input: {
+        ruleVersionId: string;
+        approver: string;
+    }) => Promise<{
+        ruleVersionId: string;
+        status: "approved";
+    }>;
+    publishSnapshot: (input: {
+        projectId: string;
+        jurisdiction: string;
+        asOfDate: Date;
+    }) => Promise<{
+        id: string;
+        jurisdiction: string;
+        includedRuleVersionIds: string[];
+    }>;
+    searchKb: (input: {
+        snapshotId: string;
+        jurisdiction: string;
+        query: string;
+    }) => Promise<{
+        items: {
+            ruleVersionId: string;
+            excerpt?: string;
+        }[];
+    }>;
+    answer: (input: {
+        projectId: string;
+        question: string;
+    }) => Promise<import("..").AssistantAnswerIR>;
+    createChangeCandidate: (input: {
+        projectId: string;
+        jurisdiction: string;
+        diffSummary: string;
+        riskLevel: RiskLevel;
+        proposedRuleVersionIds: string[];
+    }) => Promise<{
+        id: string;
+    }>;
+    createReviewTask: (input: {
+        changeCandidateId: string;
+    }) => Promise<{
+        id: string;
+        assignedRole: ReviewRole;
+    }>;
+    submitDecision: (input: {
+        reviewTaskId: string;
+        decision: "approve" | "reject";
+        decidedByRole: ReviewRole;
+        decidedBy: string;
+    }) => Promise<{
+        id: string;
+        status: "decided";
+    }>;
+    publishIfReady: (input: {
+        jurisdiction: string;
+    }) => Promise<{
+        published: true;
+    }>;
 };
-type PolicySafeKnowledgeAssistantHandlers = ReturnType<typeof createPolicySafeKnowledgeAssistantHandlers>;
-//#endregion
-export { PolicySafeKnowledgeAssistantHandlers, createPolicySafeKnowledgeAssistantHandlers };
+export type PolicySafeKnowledgeAssistantHandlers = ReturnType<typeof createPolicySafeKnowledgeAssistantHandlers>;
+export {};
 //# sourceMappingURL=policy-safe-knowledge-assistant.handlers.d.ts.map

package/dist/handlers/policy-safe-knowledge-assistant.handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-safe-knowledge-assistant.handlers.d.ts","names":[],"sources":["../../src/handlers/policy-safe-knowledge-assistant.handlers.ts"],"mappings":";;;;;KAcK,YAAA;AAAA,KACA,SAAA;AAAA,KACA,UAAA;AAAA,iBA2EW,0CAAA,CAA2C,EAAA,EAAI,YAAA;;IACtB,SAAA;EAAA,MAAmB,OAAA;;;;;;;;IAyBxD,SAAA;IACA,MAAA;IACA,YAAA;IACA,YAAA,EAAc,YAAA;EAAA,MACf,OAAA;;;;;;;;IA0BC,SAAA;IACA,YAAA;IACA,QAAA;EAAA,MACD,OAAA;;;;;;;IAUC,SAAA;IACA,MAAA;IACA,OAAA;IACA,UAAA;MAAc,gBAAA;MAA0B,OAAA;IAAA;EAAA,MACzC,OAAA;;;;;;;;;;;;;;;IAkDC,aAAA;IACA,QAAA;EAAA,MACD,OAAA;;;;;IAUC,SAAA;IACA,YAAA;IACA,QAAA,EAAU,IAAA;EAAA,MACX,OAAA;;;;;;IAmCC,UAAA;IACA,YAAA;IACA,KAAA;EAAA,MACD,OAAA;;;;;;;IAiC8B,SAAA;IAAmB,QAAA;EAAA,MAAkB,OAAA,CAjCnE,iBAAA;;IAgEC,SAAA;IACA,YAAA;IACA,WAAA;IACA,SAAA,EAAW,SAAA;IACX,sBAAA;EAAA,MACD,OAAA;;;;IAkBwC,iBAAA;EAAA,MAA2B,OAAA;;;;;IAmBlE,YAAA;IACA,QAAA;IACA,aAAA,EAAe,UAAA;IACf,SAAA;EAAA,MACD,OAAA;;;;;IAoCsC,YAAA;EAAA,MAAsB,OAAA;;;;KA4DnD,oCAAA,GAAuC,UAAA,QAC1C,0CAAA"}
+{"version":3,"file":"policy-safe-knowledge-assistant.handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/policy-safe-knowledge-assistant.handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAS,MAAM,mCAAmC,CAAC;AAM7E,KAAK,YAAY,GAAG,gBAAgB,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAC9E,KAAK,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC3C,KAAK,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AA2EvC,wBAAgB,0CAA0C,CAAC,EAAE,EAAE,YAAY;4BACpC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE;;;;;;;4BAwBrB;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,YAAY,CAAC;KAC5B;;;;;;;wBAyBgC;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB;mBAHY,MAAM;sBACH,MAAM;kBACV,MAAM;;;+BAUsB;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE;YAAE,gBAAgB,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC9D;;;;;;;;;8BADiC,MAAM;sBAAY,MAAM;;;;gCAkDjB;QACvC,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB;;;;6BASqC;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,IAAI,CAAC;KAChB;;;;;sBAkC8B;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;KACf;;2BAiB+B,MAAM;sBAAY,MAAM;;;oBAgB3B;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;mCA8BxB;QAC1C,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,SAAS,CAAC;QACrB,sBAAsB,EAAE,MAAM,EAAE,CAAC;KAClC;;;8BAkBsC;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE;;;;4BAkB/B;QACnC,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;QAC/B,aAAa,EAAE,UAAU,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;KACnB;;;;4BAoCoC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE;;;EA0D9D;AAED,MAAM,MAAM,oCAAoC,GAAG,UAAU,CAC3D,OAAO,0CAA0C,CAClD,CAAC"}