@dsh-edge/dsh-edge-agent 0.0.0-stage → 0.1.1

package/lib/dsh-adapter/intent-prompts.d.ts

@@ -0,0 +1,77 @@
+/**
+ * intent-prompts — the PROMPT TEMPLATES for the intent router.
+ *
+ * §7.123 (2026-10-27): these templates lived inline in `intent-router.ts`
+ * (2923 lines). They are pure string construction over the operator's
+ * taxonomy, so they belong with the strategy data (see `./intent-signals.ts`),
+ * not with the classifier machinery. Keeping them here makes the two prompt
+ * surfaces — the local LLM classifier and the Bailian decision-model —
+ * reviewable side by side, which matters because they MUST agree (the LOCAL
+ * catch-all wording is deliberately verbatim-identical in both).
+ *
+ * @module dsh-edge-agent/intent-prompts
+ */
+import type { IntentCategory } from './privacy-policy.js';
+import { LOCAL_CATCHALL_DESCRIPTION } from './intent-signals.js';
+export { LOCAL_CATCHALL_DESCRIPTION };
+/** The instruction shown above the category list in the LLM classifier. */
+export declare const CLASSIFIER_HEADER = "\u5224\u65AD\u4EE5\u4E0B\u7528\u6237\u8BF7\u6C42\u5C5E\u4E8E\u54EA\u7C7B\uFF1A";
+/**
+ * Confidence calibration legend.
+ *
+ * 2026-08-25: qwen3-4b tends to always output 0.98-0.99 regardless of
+ * actual certainty, making the 0.6 gate ineffective. The explicit legend
+ * teaches the model to differentiate clear vs ambiguous requests.
+ */
+export declare const CONFIDENCE_LEGEND = "confidence \u542B\u4E49\uFF1A\n- 1.0 = \u975E\u5E38\u786E\u5B9A\uFF08\u8BF7\u6C42\u660E\u786E\u5C5E\u4E8E\u8BE5\u7C7B\u522B\uFF0C\u65E0\u6B67\u4E49\uFF09\n- 0.7 = \u8F83\u786E\u5B9A\uFF08\u8BF7\u6C42\u5927\u6982\u7387\u5C5E\u4E8E\u8BE5\u7C7B\u522B\uFF0C\u4F46\u6709\u5C11\u8BB8\u6A21\u7CCA\uFF09\n- 0.5 = \u4E0D\u786E\u5B9A\uFF08\u8BF7\u6C42\u6A21\u7CCA\uFF0C\u53EF\u80FD\u662F LOCAL \u4E5F\u53EF\u80FD\u662F CLOUD\uFF09\n- <0.5 = \u5B8C\u5168\u4E0D\u786E\u5B9A\uFF08\u65E0\u6CD5\u5224\u65AD\u7C7B\u522B\uFF09";
+/** The Bailian decision-model's intent question instructions. */
+export declare const JEV_INTENT_INSTRUCTIONS = "\u8FD9\u4E2A\u7528\u6237\u8BF7\u6C42\u5E94\u8BE5\u8DEF\u7531\u5230\u54EA\u4E2A\u5904\u7406\u57DF\uFF1F\u53EA\u9009\u4E00\u4E2A\u6700\u5408\u9002\u7684\u3002";
+/** The Bailian decision-model's risk question instructions. */
+export declare const JEV_RISK_INSTRUCTIONS = "\u8FD9\u4E2A\u8BF7\u6C42\u7684\u5371\u9669\u7A0B\u5EA6\u5982\u4F55\uFF1F";
+/** The 4 danger levels the decision-model scores against (score/3 → 0..1). */
+export declare const JEV_RISK_CRITERIA: readonly string[];
+export interface ClassificationPromptInput {
+    /** The operator's taxonomy (from the privacy policy, hot-reloadable). */
+    categories: readonly IntentCategory[];
+    /** Pre-rendered recent-conversation block ('' when there is no history). */
+    historyBlock: string;
+    /** The user request to classify (already truncated to `maxInput`). */
+    promptText: string;
+}
+export interface ClassificationPrompt {
+    /** The full prompt handed to the local classifier model. */
+    prompt: string;
+    /** The category union the model may answer with, e.g. `LOCAL|CLOUD`. */
+    categoryUnion: string;
+    /** The rendered category lines (debug / audit visibility). */
+    categoryLines: string;
+}
+/**
+ * Build the local-LLM classifier prompt.
+ *
+ * §7.92.3 (2026-09-23): the category list is built from the policy's
+ * `categories[]` (hot-reloadable) — the LLM sees ALL of LOCAL/CLOUD/
+ * SANITIZED/REJECT, giving it a path to surface SANITIZED/REJECT verdicts
+ * without a separate rules pass. Order matches the policy file so
+ * operators control priority by reordering rows.
+ *
+ * §7.110 (2026-10-24): 默认本地 — the operator's taxonomy only needs to
+ * POSITIVELY define the exceptions (CLOUD / REJECT); LOCAL is the catch-all
+ * default and may ship no row at all. When the policy has no LOCAL row, a
+ * fixed catch-all line is appended and LOCAL is included in the output
+ * union so the model can express "neither of the above".
+ */
+export declare function buildClassificationPrompt(input: ClassificationPromptInput): ClassificationPrompt;
+/**
+ * Build the Bailian decision-model's intent criteria.
+ *
+ * §7.110 alignment (§7.115.1 fix): after the taxonomy was simplified to
+ * "default LOCAL", a policy without a LOCAL row would leave the
+ * decision-model choosing between CLOUD/REJECT only — pushing everyday
+ * questions into CLOUD (and, at ≥ the semantic threshold, out to the
+ * network). The LOCAL catch-all must therefore be present here too, with
+ * wording VERBATIM identical to the LLM prompt's catch-all line so the two
+ * backends cannot drift.
+ */
+export declare function buildJevIntentCriteria(categories: readonly IntentCategory[]): Record<string, string>;
+//# sourceMappingURL=intent-prompts.d.ts.map

package/lib/dsh-adapter/intent-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-prompts.d.ts","sourceRoot":"","sources":["../../src/dsh-adapter/intent-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAKhE,OAAO,EAAE,0BAA0B,EAAE,CAAA;AAErC,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,mFAAkB,CAAA;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kgBAIP,CAAA;AAEvB,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,iKACN,CAAA;AAE9B,+DAA+D;AAC/D,eAAO,MAAM,qBAAqB,6EAAiB,CAAA;AAEnD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAK9C,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;IACrC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAA;IACd,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,yBAAyB,GAAG,oBAAoB,CAoBhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,cAAc,EAAE,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB"}

package/lib/dsh-adapter/intent-prompts.js

@@ -0,0 +1,97 @@
+/**
+ * intent-prompts — the PROMPT TEMPLATES for the intent router.
+ *
+ * §7.123 (2026-10-27): these templates lived inline in `intent-router.ts`
+ * (2923 lines). They are pure string construction over the operator's
+ * taxonomy, so they belong with the strategy data (see `./intent-signals.ts`),
+ * not with the classifier machinery. Keeping them here makes the two prompt
+ * surfaces — the local LLM classifier and the Bailian decision-model —
+ * reviewable side by side, which matters because they MUST agree (the LOCAL
+ * catch-all wording is deliberately verbatim-identical in both).
+ *
+ * @module dsh-edge-agent/intent-prompts
+ */
+import { LOCAL_CATCHALL_DESCRIPTION } from './intent-signals.js';
+// Re-exported: the catch-all wording is part of this module's public
+// contract — the two prompt surfaces must use it verbatim, and a test that
+// pins "both surfaces agree" needs to name it.
+export { LOCAL_CATCHALL_DESCRIPTION };
+/** The instruction shown above the category list in the LLM classifier. */
+export const CLASSIFIER_HEADER = '判断以下用户请求属于哪类：';
+/**
+ * Confidence calibration legend.
+ *
+ * 2026-08-25: qwen3-4b tends to always output 0.98-0.99 regardless of
+ * actual certainty, making the 0.6 gate ineffective. The explicit legend
+ * teaches the model to differentiate clear vs ambiguous requests.
+ */
+export const CONFIDENCE_LEGEND = `confidence 含义：
+- 1.0 = 非常确定（请求明确属于该类别，无歧义）
+- 0.7 = 较确定（请求大概率属于该类别，但有少许模糊）
+- 0.5 = 不确定（请求模糊，可能是 LOCAL 也可能是 CLOUD）
+- <0.5 = 完全不确定（无法判断类别）`;
+/** The Bailian decision-model's intent question instructions. */
+export const JEV_INTENT_INSTRUCTIONS = '这个用户请求应该路由到哪个处理域？只选一个最合适的。';
+/** The Bailian decision-model's risk question instructions. */
+export const JEV_RISK_INSTRUCTIONS = '这个请求的危险程度如何？';
+/** The 4 danger levels the decision-model scores against (score/3 → 0..1). */
+export const JEV_RISK_CRITERIA = [
+    '正常请求，无风险',
+    '轻微可疑，需要留意',
+    '明显危险操作',
+    '高危/违法/破坏性请求',
+];
+/**
+ * Build the local-LLM classifier prompt.
+ *
+ * §7.92.3 (2026-09-23): the category list is built from the policy's
+ * `categories[]` (hot-reloadable) — the LLM sees ALL of LOCAL/CLOUD/
+ * SANITIZED/REJECT, giving it a path to surface SANITIZED/REJECT verdicts
+ * without a separate rules pass. Order matches the policy file so
+ * operators control priority by reordering rows.
+ *
+ * §7.110 (2026-10-24): 默认本地 — the operator's taxonomy only needs to
+ * POSITIVELY define the exceptions (CLOUD / REJECT); LOCAL is the catch-all
+ * default and may ship no row at all. When the policy has no LOCAL row, a
+ * fixed catch-all line is appended and LOCAL is included in the output
+ * union so the model can express "neither of the above".
+ */
+export function buildClassificationPrompt(input) {
+    const hasLocalRow = input.categories.some((c) => c.id === 'LOCAL');
+    const categoryLines = input.categories.map((c) => `- ${c.id}：${c.description}`).join('\n')
+        + (hasLocalRow ? '' : `\n- LOCAL：${LOCAL_CATCHALL_DESCRIPTION}`);
+    const categoryUnion = Array.from(new Set([
+        ...input.categories.map((c) => c.id),
+        'LOCAL',
+    ])).join('|');
+    const prompt = `${CLASSIFIER_HEADER}
+${categoryLines}
+${input.historyBlock}
+Respond ONLY with a single JSON object — no prose, no Markdown:
+{ "category": ${categoryUnion}, "confidence": <0.0-1.0> }
+
+${CONFIDENCE_LEGEND}
+
+用户请求：${input.promptText}`;
+    return { prompt, categoryUnion, categoryLines };
+}
+/**
+ * Build the Bailian decision-model's intent criteria.
+ *
+ * §7.110 alignment (§7.115.1 fix): after the taxonomy was simplified to
+ * "default LOCAL", a policy without a LOCAL row would leave the
+ * decision-model choosing between CLOUD/REJECT only — pushing everyday
+ * questions into CLOUD (and, at ≥ the semantic threshold, out to the
+ * network). The LOCAL catch-all must therefore be present here too, with
+ * wording VERBATIM identical to the LLM prompt's catch-all line so the two
+ * backends cannot drift.
+ */
+export function buildJevIntentCriteria(categories) {
+    const criteria = {};
+    for (const cat of categories)
+        criteria[cat.id] = cat.description;
+    if (!categories.some((c) => c.id === 'LOCAL')) {
+        criteria.LOCAL = LOCAL_CATCHALL_DESCRIPTION;
+    }
+    return criteria;
+}