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

package/dist/node/ui/hooks/usePolicySafeKnowledgeAssistant.js

@@ -0,0 +1,154 @@
+// src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+"use client";
+function isCitationLike(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const v = value;
+  return typeof v.kbSnapshotId === "string" && typeof v.sourceId === "string";
+}
+function toCitations(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.filter(isCitationLike).map((c) => ({
+    kbSnapshotId: c.kbSnapshotId,
+    sourceId: c.sourceId,
+    excerpt: c.excerpt
+  }));
+}
+function usePolicySafeKnowledgeAssistant() {
+  const { handlers, projectId } = useTemplateRuntime();
+  const api = handlers.policySafeKnowledgeAssistant;
+  const [state, setState] = useState({
+    context: null,
+    loading: true,
+    error: null,
+    lastAnswer: null,
+    lastRuleId: null,
+    lastRuleVersionId: null,
+    lastSnapshotId: null,
+    lastReviewTaskId: null
+  });
+  const refreshContext = useCallback(async () => {
+    try {
+      setState((s) => ({ ...s, loading: true, error: null }));
+      const ctx = await api.getUserContext({ projectId });
+      setState((s) => ({
+        ...s,
+        context: {
+          locale: ctx.locale,
+          jurisdiction: ctx.jurisdiction,
+          allowedScope: ctx.allowedScope,
+          kbSnapshotId: ctx.kbSnapshotId
+        },
+        loading: false
+      }));
+    } catch (e) {
+      setState((s) => ({
+        ...s,
+        loading: false,
+        error: e instanceof Error ? e : new Error("Unknown error")
+      }));
+    }
+  }, [api, projectId]);
+  useEffect(() => {
+    refreshContext();
+  }, [refreshContext]);
+  const setContext = useCallback(async (input) => {
+    const ctx = await api.setUserContext({ projectId, ...input });
+    setState((s) => ({
+      ...s,
+      context: {
+        locale: ctx.locale,
+        jurisdiction: ctx.jurisdiction,
+        allowedScope: ctx.allowedScope,
+        kbSnapshotId: ctx.kbSnapshotId
+      }
+    }));
+  }, [api, projectId]);
+  const askAssistant = useCallback(async (question) => {
+    const answerUnknown = await api.answer({ projectId, question });
+    const answer = answerUnknown;
+    setState((s) => ({
+      ...s,
+      lastAnswer: {
+        refused: answer.refused,
+        refusalReason: answer.refusalReason,
+        sections: answer.sections,
+        citations: toCitations(answerUnknown.citations)
+      }
+    }));
+  }, [api, projectId]);
+  const createDemoRule = useCallback(async () => {
+    const rule = await api.createRule({
+      projectId,
+      jurisdiction: state.context?.jurisdiction ?? "EU",
+      topicKey: "tax_reporting"
+    });
+    setState((s) => ({ ...s, lastRuleId: rule.id }));
+    return rule.id;
+  }, [api, projectId, state.context?.jurisdiction]);
+  const upsertRuleVersion = useCallback(async (input) => {
+    const rv = await api.upsertRuleVersion({
+      projectId,
+      ruleId: input.ruleId,
+      content: input.content,
+      sourceRefs: [{ sourceDocumentId: "src_demo", excerpt: "demo excerpt" }]
+    });
+    setState((s) => ({ ...s, lastRuleVersionId: rv.id }));
+    return rv.id;
+  }, [api, projectId]);
+  const approveRuleVersion = useCallback(async (ruleVersionId) => {
+    await api.approveRuleVersion({ ruleVersionId, approver: "demo_expert" });
+  }, [api]);
+  const publishSnapshot = useCallback(async () => {
+    const snap = await api.publishSnapshot({
+      projectId,
+      jurisdiction: state.context?.jurisdiction ?? "EU",
+      asOfDate: new Date("2026-02-01T00:00:00.000Z")
+    });
+    setState((s) => ({ ...s, lastSnapshotId: snap.id }));
+    await refreshContext();
+    return snap.id;
+  }, [api, projectId, refreshContext, state.context?.jurisdiction]);
+  const simulateHighRiskChangeAndApprove = useCallback(async (ruleVersionId) => {
+    const cand = await api.createChangeCandidate({
+      projectId,
+      jurisdiction: state.context?.jurisdiction ?? "EU",
+      diffSummary: "Simulated change (demo)",
+      riskLevel: "high",
+      proposedRuleVersionIds: [ruleVersionId]
+    });
+    const review = await api.createReviewTask({ changeCandidateId: cand.id });
+    setState((s) => ({ ...s, lastReviewTaskId: review.id }));
+    await api.submitDecision({
+      reviewTaskId: review.id,
+      decision: "approve",
+      decidedByRole: "expert",
+      decidedBy: "demo_expert"
+    });
+    await api.publishIfReady({
+      jurisdiction: state.context?.jurisdiction ?? "EU"
+    });
+    return review.id;
+  }, [api, projectId, state.context?.jurisdiction]);
+  const derived = useMemo(() => ({ projectId }), [projectId]);
+  return {
+    state,
+    derived,
+    actions: {
+      refreshContext,
+      setContext,
+      askAssistant,
+      createDemoRule,
+      upsertRuleVersion,
+      approveRuleVersion,
+      publishSnapshot,
+      simulateHighRiskChangeAndApprove
+    }
+  };
+}
+export {
+  usePolicySafeKnowledgeAssistant
+};

package/dist/node/ui/index.js

@@ -0,0 +1,420 @@
+// src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+"use client";
+function isCitationLike(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const v = value;
+  return typeof v.kbSnapshotId === "string" && typeof v.sourceId === "string";
+}
+function toCitations(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.filter(isCitationLike).map((c) => ({
+    kbSnapshotId: c.kbSnapshotId,
+    sourceId: c.sourceId,
+    excerpt: c.excerpt
+  }));
+}
+function usePolicySafeKnowledgeAssistant() {
+  const { handlers, projectId } = useTemplateRuntime();
+  const api = handlers.policySafeKnowledgeAssistant;
+  const [state, setState] = useState({
+    context: null,
+    loading: true,
+    error: null,
+    lastAnswer: null,
+    lastRuleId: null,
+    lastRuleVersionId: null,
+    lastSnapshotId: null,
+    lastReviewTaskId: null
+  });
+  const refreshContext = useCallback(async () => {
+    try {
+      setState((s) => ({ ...s, loading: true, error: null }));
+      const ctx = await api.getUserContext({ projectId });
+      setState((s) => ({
+        ...s,
+        context: {
+          locale: ctx.locale,
+          jurisdiction: ctx.jurisdiction,
+          allowedScope: ctx.allowedScope,
+          kbSnapshotId: ctx.kbSnapshotId
+        },
+        loading: false
+      }));
+    } catch (e) {
+      setState((s) => ({
+        ...s,
+        loading: false,
+        error: e instanceof Error ? e : new Error("Unknown error")
+      }));
+    }
+  }, [api, projectId]);
+  useEffect(() => {
+    refreshContext();
+  }, [refreshContext]);
+  const setContext = useCallback(async (input) => {
+    const ctx = await api.setUserContext({ projectId, ...input });
+    setState((s) => ({
+      ...s,
+      context: {
+        locale: ctx.locale,
+        jurisdiction: ctx.jurisdiction,
+        allowedScope: ctx.allowedScope,
+        kbSnapshotId: ctx.kbSnapshotId
+      }
+    }));
+  }, [api, projectId]);
+  const askAssistant = useCallback(async (question) => {
+    const answerUnknown = await api.answer({ projectId, question });
+    const answer = answerUnknown;
+    setState((s) => ({
+      ...s,
+      lastAnswer: {
+        refused: answer.refused,
+        refusalReason: answer.refusalReason,
+        sections: answer.sections,
+        citations: toCitations(answerUnknown.citations)
+      }
+    }));
+  }, [api, projectId]);
+  const createDemoRule = useCallback(async () => {
+    const rule = await api.createRule({
+      projectId,
+      jurisdiction: state.context?.jurisdiction ?? "EU",
+      topicKey: "tax_reporting"
+    });
+    setState((s) => ({ ...s, lastRuleId: rule.id }));
+    return rule.id;
+  }, [api, projectId, state.context?.jurisdiction]);
+  const upsertRuleVersion = useCallback(async (input) => {
+    const rv = await api.upsertRuleVersion({
+      projectId,
+      ruleId: input.ruleId,
+      content: input.content,
+      sourceRefs: [{ sourceDocumentId: "src_demo", excerpt: "demo excerpt" }]
+    });
+    setState((s) => ({ ...s, lastRuleVersionId: rv.id }));
+    return rv.id;
+  }, [api, projectId]);
+  const approveRuleVersion = useCallback(async (ruleVersionId) => {
+    await api.approveRuleVersion({ ruleVersionId, approver: "demo_expert" });
+  }, [api]);
+  const publishSnapshot = useCallback(async () => {
+    const snap = await api.publishSnapshot({
+      projectId,
+      jurisdiction: state.context?.jurisdiction ?? "EU",
+      asOfDate: new Date("2026-02-01T00:00:00.000Z")
+    });
+    setState((s) => ({ ...s, lastSnapshotId: snap.id }));
+    await refreshContext();
+    return snap.id;
+  }, [api, projectId, refreshContext, state.context?.jurisdiction]);
+  const simulateHighRiskChangeAndApprove = useCallback(async (ruleVersionId) => {
+    const cand = await api.createChangeCandidate({
+      projectId,
+      jurisdiction: state.context?.jurisdiction ?? "EU",
+      diffSummary: "Simulated change (demo)",
+      riskLevel: "high",
+      proposedRuleVersionIds: [ruleVersionId]
+    });
+    const review = await api.createReviewTask({ changeCandidateId: cand.id });
+    setState((s) => ({ ...s, lastReviewTaskId: review.id }));
+    await api.submitDecision({
+      reviewTaskId: review.id,
+      decision: "approve",
+      decidedByRole: "expert",
+      decidedBy: "demo_expert"
+    });
+    await api.publishIfReady({
+      jurisdiction: state.context?.jurisdiction ?? "EU"
+    });
+    return review.id;
+  }, [api, projectId, state.context?.jurisdiction]);
+  const derived = useMemo(() => ({ projectId }), [projectId]);
+  return {
+    state,
+    derived,
+    actions: {
+      refreshContext,
+      setContext,
+      askAssistant,
+      createDemoRule,
+      upsertRuleVersion,
+      approveRuleVersion,
+      publishSnapshot,
+      simulateHighRiskChangeAndApprove
+    }
+  };
+}
+
+// src/ui/PolicySafeKnowledgeAssistantDashboard.tsx
+import { useCallback as useCallback2, useMemo as useMemo2, useState as useState2 } from "react";
+import {
+  Button,
+  ErrorState,
+  LoaderBlock,
+  StatCard,
+  StatCardGroup
+} from "@contractspec/lib.design-system";
+import { Card } from "@contractspec/lib.ui-kit-web/ui/card";
+import { Input } from "@contractspec/lib.ui-kit-web/ui/input";
+import { Textarea } from "@contractspec/lib.ui-kit-web/ui/textarea";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue
+} from "@contractspec/lib.ui-kit-web/ui/select";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function PolicySafeKnowledgeAssistantDashboard() {
+  const { state, actions } = usePolicySafeKnowledgeAssistant();
+  const [question, setQuestion] = useState2("reporting obligations");
+  const [content, setContent] = useState2("EU: Reporting obligations v2 (updated)");
+  const [locale, setLocale] = useState2("en-GB");
+  const [jurisdiction, setJurisdiction] = useState2("EU");
+  const [allowedScope, setAllowedScope] = useState2("education_only");
+  const snapshotId = state.context?.kbSnapshotId ?? state.lastSnapshotId ?? null;
+  const stats = useMemo2(() => {
+    return [
+      { label: "Locale", value: state.context?.locale ?? "—" },
+      { label: "Jurisdiction", value: state.context?.jurisdiction ?? "—" },
+      { label: "Scope", value: state.context?.allowedScope ?? "—" },
+      { label: "KB Snapshot", value: snapshotId ?? "—" }
+    ];
+  }, [
+    snapshotId,
+    state.context?.allowedScope,
+    state.context?.jurisdiction,
+    state.context?.locale
+  ]);
+  const handleSetContext = useCallback2(async () => {
+    await actions.setContext({ locale, jurisdiction, allowedScope });
+  }, [actions, allowedScope, jurisdiction, locale]);
+  const handleAsk = useCallback2(async () => {
+    await actions.askAssistant(question);
+  }, [actions, question]);
+  const handleAdminPublishFlow = useCallback2(async () => {
+    const ruleId = state.lastRuleId ?? await actions.createDemoRule();
+    const rvId = await actions.upsertRuleVersion({ ruleId, content });
+    await actions.approveRuleVersion(rvId);
+    await actions.simulateHighRiskChangeAndApprove(rvId);
+    await actions.publishSnapshot();
+  }, [actions, content, state.lastRuleId]);
+  if (state.loading && !state.context) {
+    return /* @__PURE__ */ jsxDEV(LoaderBlock, {
+      label: "Loading demo..."
+    }, undefined, false, undefined, this);
+  }
+  if (state.error) {
+    return /* @__PURE__ */ jsxDEV(ErrorState, {
+      title: "Failed to load demo",
+      description: state.error.message,
+      onRetry: actions.refreshContext,
+      retryLabel: "Retry"
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV(StatCardGroup, {
+        children: stats.map((s) => /* @__PURE__ */ jsxDEV(StatCard, {
+          label: s.label,
+          value: String(s.value)
+        }, s.label, false, undefined, this))
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV(Card, {
+        className: "p-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h3", {
+            className: "text-lg font-semibold",
+            children: "1) Onboarding (explicit locale + jurisdiction)"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "mt-3 grid gap-3 md:grid-cols-3",
+            children: [
+              /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    children: "Locale"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV(Input, {
+                    value: locale,
+                    onChange: (e) => setLocale(e.target.value)
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    children: "Jurisdiction"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV(Input, {
+                    value: jurisdiction,
+                    onChange: (e) => setJurisdiction(e.target.value)
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    children: "Allowed scope"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV(Select, {
+                    value: allowedScope,
+                    onValueChange: (v) => setAllowedScope(v),
+                    children: [
+                      /* @__PURE__ */ jsxDEV(SelectTrigger, {
+                        children: /* @__PURE__ */ jsxDEV(SelectValue, {
+                          placeholder: "Select scope"
+                        }, undefined, false, undefined, this)
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV(SelectContent, {
+                        children: [
+                          /* @__PURE__ */ jsxDEV(SelectItem, {
+                            value: "education_only",
+                            children: "education_only"
+                          }, undefined, false, undefined, this),
+                          /* @__PURE__ */ jsxDEV(SelectItem, {
+                            value: "generic_info",
+                            children: "generic_info"
+                          }, undefined, false, undefined, this),
+                          /* @__PURE__ */ jsxDEV(SelectItem, {
+                            value: "escalation_required",
+                            children: "escalation_required"
+                          }, undefined, false, undefined, this)
+                        ]
+                      }, undefined, true, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "mt-4 flex gap-2",
+            children: [
+              /* @__PURE__ */ jsxDEV(Button, {
+                onPress: handleSetContext,
+                children: "Save context"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV(Button, {
+                variant: "outline",
+                onPress: actions.refreshContext,
+                children: "Refresh"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(Card, {
+        className: "p-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h3", {
+            className: "text-lg font-semibold",
+            children: "2) Ask the assistant (must cite KB snapshot)"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "mt-3 flex flex-col gap-3",
+            children: [
+              /* @__PURE__ */ jsxDEV(Input, {
+                value: question,
+                onChange: (e) => setQuestion(e.target.value)
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "flex gap-2",
+                children: /* @__PURE__ */ jsxDEV(Button, {
+                  onPress: handleAsk,
+                  children: "Ask"
+                }, undefined, false, undefined, this)
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          state.lastAnswer ? /* @__PURE__ */ jsxDEV("div", {
+            className: "mt-4 space-y-3",
+            children: [
+              state.lastAnswer.refused ? /* @__PURE__ */ jsxDEV("div", {
+                className: "text-sm text-red-600",
+                children: [
+                  "Refused: ",
+                  state.lastAnswer.refusalReason ?? "UNKNOWN"
+                ]
+              }, undefined, true, undefined, this) : null,
+              state.lastAnswer.sections.map((s, idx) => /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "text-sm font-semibold",
+                    children: s.heading
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "text-muted-foreground text-sm",
+                    children: s.body
+                  }, undefined, false, undefined, this)
+                ]
+              }, `${s.heading}-${idx}`, true, undefined, this)),
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "text-sm font-semibold",
+                children: "Citations"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("ul", {
+                className: "text-muted-foreground list-disc pl-5 text-sm",
+                children: state.lastAnswer.citations.map((c) => /* @__PURE__ */ jsxDEV("li", {
+                  children: [
+                    c.kbSnapshotId,
+                    " — ",
+                    c.sourceId
+                  ]
+                }, `${c.kbSnapshotId}-${c.sourceId}`, true, undefined, this))
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this) : null
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(Card, {
+        className: "p-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h3", {
+            className: "text-lg font-semibold",
+            children: "3) Admin: publish a new snapshot (HITL)"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "mt-3 space-y-3",
+            children: [
+              /* @__PURE__ */ jsxDEV(Textarea, {
+                value: content,
+                onChange: (e) => setContent(e.target.value)
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV(Button, {
+                onPress: handleAdminPublishFlow,
+                children: "Simulate change → review → approve → publish snapshot"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(Card, {
+        className: "p-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h3", {
+            className: "text-lg font-semibold",
+            children: "4) Learning hub (patterns)"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground mt-2 text-sm",
+            children: "This template includes drills, ambient coach, and quests as reusable Learning Journey tracks. The interactive learning UI is demonstrated in dedicated Learning Journey examples."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  PolicySafeKnowledgeAssistantDashboard
+};

package/dist/orchestrator/buildAnswer.d.ts

@@ -1,53 +1,51 @@
-//#region src/orchestrator/buildAnswer.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 BuildAnswerInput {
-  envelope: {
-    traceId: string;
+export interface AssistantAnswerIR {
     locale: string;
-    kbSnapshotId: string;
-    allowedScope: AllowedScope;
-    regulatoryContext: {
-      jurisdiction: string;
-    };
-  };
-  question: string;
-  kbSearch: (input: {
-    snapshotId: string;
     jurisdiction: string;
-    query: string;
-  }) => Promise<{
-    items: {
-      ruleVersionId: string;
-      excerpt?: 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;
+}
+export interface BuildAnswerInput {
+    envelope: {
+        traceId: string;
+        locale: string;
+        kbSnapshotId: string;
+        allowedScope: AllowedScope;
+        regulatoryContext: {
+            jurisdiction: string;
+        };
+    };
+    question: string;
+    kbSearch: (input: {
+        snapshotId: string;
+        jurisdiction: string;
+        query: string;
+    }) => Promise<{
+        items: {
+            ruleVersionId: string;
+            excerpt?: string;
+        }[];
+    }>;
 }
 /**
  * Build a policy-safe assistant answer derived from KB search results.
  *
  * Deterministic: no LLM calls; if search yields no results, it refuses.
  */
-declare function buildPolicySafeAnswer(input: BuildAnswerInput): Promise<AssistantAnswerIR>;
-//#endregion
-export { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer };
+export declare function buildPolicySafeAnswer(input: BuildAnswerInput): Promise<AssistantAnswerIR>;
+export {};
 //# sourceMappingURL=buildAnswer.d.ts.map

package/dist/orchestrator/buildAnswer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildAnswer.d.ts","names":[],"sources":["../../src/orchestrator/buildAnswer.ts"],"mappings":";KAMK,YAAA;AAAA,UAEY,iBAAA;EACf,MAAA;EACA,YAAA;EACA,YAAA,EAAc,YAAA;EACd,QAAA;IAAY,OAAA;IAAiB,IAAA;EAAA;EAC7B,SAAA;IACE,YAAA;IACA,UAAA;IACA,QAAA;IACA,KAAA;IACA,OAAA;EAAA;EAEF,WAAA;EACA,SAAA;EACA,OAAA;EACA,aAAA;AAAA;AAAA,UAGe,gBAAA;EACf,QAAA;IACE,OAAA;IACA,MAAA;IACA,YAAA;IACA,YAAA,EAAc,YAAA;IACd,iBAAA;MAAqB,YAAA;IAAA;EAAA;EAEvB,QAAA;EACA,QAAA,GAAW,KAAA;IACT,UAAA;IACA,YAAA;IACA,KAAA;EAAA,MACI,OAAA;IAAU,KAAA;MAAS,aAAA;MAAuB,OAAA;IAAA;EAAA;AAAA;;;;;;iBAQ5B,qBAAA,CACpB,KAAA,EAAO,gBAAA,GACN,OAAA,CAAQ,iBAAA"}
+{"version":3,"file":"buildAnswer.d.ts","sourceRoot":"","sources":["../../src/orchestrator/buildAnswer.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GAAG,gBAAgB,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAE9E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IACJ,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,YAAY,CAAC;QAC3B,iBAAiB,EAAE;YAAE,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7C,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;KACf,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE;YAAE,aAAa,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC,CAAC;CACzE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAwE5B"}