@wutiankai/npc-dialogue 1.0.0-alpha.1

package/dist/index.cjs

@@ -0,0 +1,883 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuditLog: () => AuditLog,
+  DialogueEngine: () => DialogueEngine,
+  OpenAICompatibleProvider: () => OpenAICompatibleProvider,
+  PassthroughProvider: () => PassthroughProvider,
+  buildNpcDialoguePrompt: () => buildNpcDialoguePrompt,
+  expandKeywordsBilingually: () => expandKeywordsBilingually,
+  loadConfigFromEnv: () => loadConfigFromEnv,
+  parseAiJson: () => parseAiJson,
+  reviewGateTrigger: () => reviewGateTrigger,
+  validateDialogueResponse: () => validateDialogueResponse
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/provider.ts
+var PassthroughProvider = class {
+  id = "passthrough";
+  status = {
+    state: "ready",
+    providerId: "passthrough",
+    lastHealthCheck: 0,
+    consecutiveFailures: 0,
+    configRedacted: { baseUrl: "(none)", model: "(none)" }
+  };
+  async initialize() {
+    this.status.state = "ready";
+    this.status.lastHealthCheck = Date.now();
+  }
+  async dispose() {
+    this.status.state = "disposed";
+  }
+  getStatus() {
+    return { ...this.status };
+  }
+  async healthCheck() {
+    return true;
+  }
+  async call(request, _systemPrompt, _userPrompt) {
+    const text = request.type === "dialogue" && request.dialogueContext ? request.dialogueContext.topicResponse : request.commandMessage;
+    return {
+      text,
+      model: "(passthrough)",
+      latencyMs: 0
+    };
+  }
+};
+
+// src/providers/openai-compatible.ts
+var MAX_CONSECUTIVE_FAILURES = 3;
+function normalizeBaseUrl(url) {
+  return url.replace(/\/+$/, "");
+}
+var OpenAICompatibleProvider = class {
+  constructor(config) {
+    this.config = config;
+  }
+  config;
+  id = "openai-compat";
+  state = "uninitialized";
+  consecutiveFailures = 0;
+  lastHealthCheck = 0;
+  lastError;
+  async initialize() {
+    this.state = "initializing";
+    try {
+      if (!this.config.apiKey) {
+        throw new Error("API key is required");
+      }
+      if (!this.config.baseUrl) {
+        throw new Error("Base URL is required");
+      }
+      this.state = "ready";
+      this.lastHealthCheck = Date.now();
+    } catch (err) {
+      this.state = "failed";
+      this.lastError = err instanceof Error ? err.message : String(err);
+      throw err;
+    }
+  }
+  async dispose() {
+    this.state = "disposed";
+  }
+  getStatus() {
+    return {
+      state: this.state,
+      providerId: this.id,
+      lastHealthCheck: this.lastHealthCheck,
+      consecutiveFailures: this.consecutiveFailures,
+      lastError: this.lastError,
+      configRedacted: {
+        baseUrl: this.config.baseUrl,
+        model: this.config.model
+      }
+    };
+  }
+  async healthCheck() {
+    try {
+      const response = await fetch(`${normalizeBaseUrl(this.config.baseUrl)}/chat/completions`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.config.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          model: this.config.model,
+          messages: [{ role: "user", content: "ping" }],
+          max_tokens: 1
+        })
+      });
+      this.lastHealthCheck = Date.now();
+      if (response.ok) {
+        this.consecutiveFailures = 0;
+        if (this.state === "degraded" || this.state === "failed") {
+          this.state = "ready";
+        }
+        return true;
+      }
+      this.recordFailure(`Health check failed: ${response.status}`);
+      return false;
+    } catch (err) {
+      this.recordFailure(
+        `Health check error: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return false;
+    }
+  }
+  async call(_request, systemPrompt, userPrompt) {
+    if (this.state === "disposed") {
+      throw new Error("Provider is disposed");
+    }
+    const start = Date.now();
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 12e3);
+    let response;
+    try {
+      response = await fetch(`${normalizeBaseUrl(this.config.baseUrl)}/chat/completions`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.config.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          model: this.config.model,
+          messages: [
+            { role: "system", content: systemPrompt },
+            { role: "user", content: userPrompt }
+          ],
+          temperature: this.config.temperature,
+          max_tokens: this.config.maxTokens
+        }),
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timeout);
+      this.recordFailure(err instanceof Error ? err.message : String(err));
+      if (err.name === "AbortError") {
+        throw new Error("AI request timed out after 12 seconds");
+      }
+      throw err;
+    }
+    clearTimeout(timeout);
+    const latencyMs = Date.now() - start;
+    if (!response.ok) {
+      const body = await response.text().catch(() => "");
+      this.recordFailure(`API error ${response.status}: ${body.slice(0, 200)}`);
+      throw new Error(`AI request failed: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    const text = data.choices?.[0]?.message?.content?.trim() ?? "";
+    if (!text) {
+      this.recordFailure("Empty response from AI");
+      throw new Error("AI returned empty response");
+    }
+    this.consecutiveFailures = 0;
+    if (this.state === "degraded") {
+      this.state = "ready";
+    }
+    this.lastHealthCheck = Date.now();
+    return {
+      text,
+      model: this.config.model,
+      latencyMs,
+      promptTokenCount: data.usage?.prompt_tokens,
+      completionTokenCount: data.usage?.completion_tokens
+    };
+  }
+  // ─── Internal ──────────────────────────────────────────────────────
+  recordFailure(error) {
+    this.consecutiveFailures++;
+    this.lastError = error;
+    if (this.consecutiveFailures >= MAX_CONSECUTIVE_FAILURES) {
+      this.state = "failed";
+    } else {
+      this.state = "degraded";
+    }
+  }
+};
+
+// src/providers/config.ts
+function loadConfigFromEnv() {
+  return {
+    apiKey: process.env.OPENAI_API_KEY || process.env.AI_API_KEY || void 0,
+    baseUrl: process.env.AI_BASE_URL || "https://api.openai.com/v1",
+    model: process.env.AI_MODEL || "gpt-4o-mini",
+    maxTokens: parseInt(process.env.AI_MAX_TOKENS || "300", 10),
+    temperature: parseFloat(process.env.AI_TEMPERATURE || "0.7")
+  };
+}
+
+// src/audit.ts
+var AuditLog = class {
+  entries = [];
+  maxEntries;
+  constructor(maxEntries = 1e3) {
+    this.maxEntries = maxEntries > 0 ? maxEntries : Infinity;
+  }
+  append(record) {
+    this.entries.push(record);
+    while (this.entries.length > this.maxEntries) {
+      this.entries.shift();
+    }
+  }
+  query(filter) {
+    if (!filter) return [...this.entries];
+    return this.entries.filter((r) => {
+      if (filter.source !== void 0 && r.responseSource !== filter.source)
+        return false;
+      if (filter.requestType !== void 0 && r.requestType !== filter.requestType)
+        return false;
+      if (filter.minTurnIndex !== void 0 && r.turnIndex < filter.minTurnIndex)
+        return false;
+      if (filter.maxTurnIndex !== void 0 && r.turnIndex > filter.maxTurnIndex)
+        return false;
+      if (filter.validationPassed !== void 0 && r.validationPassed !== filter.validationPassed)
+        return false;
+      return true;
+    });
+  }
+  stats() {
+    let totalRequests = 0;
+    let aiSuccessCount = 0;
+    let passthroughCount = 0;
+    let aiFailureCount = 0;
+    let validationFailureCount = 0;
+    let constraintViolationCount = 0;
+    let totalLatency = 0;
+    const byProvider = {};
+    for (const r of this.entries) {
+      totalRequests++;
+      totalLatency += r.latencyMs;
+      if (r.responseSource === "ai") {
+        aiSuccessCount++;
+      } else {
+        passthroughCount++;
+      }
+      if (!r.validationPassed) {
+        validationFailureCount++;
+      }
+      if (r.constraintViolations.length > 0) {
+        constraintViolationCount++;
+      }
+      if (!byProvider[r.providerId]) {
+        byProvider[r.providerId] = { calls: 0, failures: 0 };
+      }
+      byProvider[r.providerId].calls++;
+      if (r.responseSource === "passthrough" && r.providerId !== "passthrough") {
+        byProvider[r.providerId].failures++;
+      }
+    }
+    return {
+      totalRequests,
+      aiSuccessCount,
+      passthroughCount,
+      aiFailureCount,
+      validationFailureCount,
+      constraintViolationCount,
+      averageLatencyMs: totalRequests > 0 ? Math.round(totalLatency / totalRequests) : 0,
+      byProvider
+    };
+  }
+  clear() {
+    this.entries = [];
+  }
+  export() {
+    return [...this.entries];
+  }
+  get length() {
+    return this.entries.length;
+  }
+};
+
+// src/dialogue/prompt/gated-secrets.ts
+function formatGatedSecretsEn(script, validTopicGateIds) {
+  const available = script.gatedSecrets.filter(
+    (s) => validTopicGateIds.includes(s.topicGateId)
+  );
+  if (available.length === 0) {
+    return "  (none currently available)";
+  }
+  return available.map(
+    (s) => {
+      const keywords = [
+        ...s.triggerKeywords ?? [],
+        ...s.triggerPhrases ?? []
+      ];
+      const keywordLine = keywords.length > 0 ? `
+    Trigger keywords: ${keywords.join(", ")}` : "";
+      return `  [${s.topicGateId}] ${s.description}
+    Reveal conditions: ${s.revealConditions}${keywordLine}
+    If pressed on this: ${s.reactionWhenPressed}`;
+    }
+  ).join("\n");
+}
+function formatGatedSecretsZh(script, validTopicGateIds) {
+  const available = script.gatedSecrets.filter(
+    (s) => validTopicGateIds.includes(s.topicGateId)
+  );
+  if (available.length === 0) {
+    return "  \uFF08\u5F53\u524D\u65E0\u53EF\u89E6\u53D1\u7684\u95E8\u63A7\u79D8\u5BC6\uFF09";
+  }
+  return available.map(
+    (s) => {
+      const keywords = [
+        ...s.triggerKeywords ?? [],
+        ...s.triggerPhrases ?? []
+      ];
+      const keywordLine = keywords.length > 0 ? `
+    \u89E6\u53D1\u5173\u952E\u8BCD\uFF1A${keywords.join(", ")}` : "";
+      return `  [${s.topicGateId}] ${s.description}
+    \u89E6\u53D1\u6761\u4EF6\uFF1A${s.revealConditions}${keywordLine}
+    \u88AB\u8FFD\u95EE\u65F6\uFF1A${s.reactionWhenPressed}`;
+    }
+  ).join("\n");
+}
+
+// src/dialogue/prompt/system-prompt.ts
+function buildSystemPromptEn(script, validTopicGateIds, currentTrust) {
+  const p = script.persona;
+  const privateKnowledge = currentTrust >= 1 ? script.privateKnowledge : [];
+  const setting = script.worldSetting ?? "a mystery investigation game";
+  let prompt = `You are ${script.name}, ${script.role}. You are a character in ${setting}.
+
+HARD RULES \u2014 VIOLATION OF ANY RULE WILL BREAK THE GAME:
+1. You are NOT a narrator, system, detective assistant, or omniscient AI.
+2. You can ONLY know what is explicitly written in your character script below.
+3. If the player asks about something outside your knowledge, you MUST respond as your character would: show ignorance, deflect, misunderstand, or guess incorrectly.
+4. You MUST NOT reveal the content of any GATED SECRETS listed below. Setting candidateGateId is NOT revealing \u2014 it is a review signal for the system to decide.
+5. Set candidateGateId as a REVIEW SIGNAL when the player's input is PLAUSIBLY RELATED to the revealConditions or triggerKeywords of a gated secret. The system reviews this signal \u2014 a false positive is harmless; a missed signal loses an opportunity.
+6. You MUST output ONLY valid JSON \u2014 absolutely no text before or after the JSON object.
+7. Your "dialogue" field must be in your character's own voice \u2014 first person, in-character, authentic to your personality.
+8. Private knowledge is only included below when your current trust allows it. If it is not listed, you do not know it for this exchange.
+
+YOUR PERSONA:
+- Personality: ${p.personality}
+- Background: ${p.background}
+- Speech patterns: ${p.speechPatterns}`;
+  if (p.emotionalBaseline) {
+    prompt += `
+- Emotional baseline: ${p.emotionalBaseline}`;
+  }
+  if (p.forbiddenTone) {
+    prompt += `
+- Forbidden tone: ${p.forbiddenTone}`;
+  }
+  prompt += `
+
+WHAT YOU KNOW (public knowledge \u2014 you may share this freely):
+${script.publicKnowledge.map((k) => `  [${k.topic}] ${k.content}`).join("\n")}
+
+WHAT YOU KNOW (private knowledge \u2014 you know this but will NOT volunteer it unless asked directly):
+${formatKnowledgeList(privateKnowledge, "  (none available at current trust)")}
+
+GATED SECRETS (keep their content hidden \u2014 but when the player's input is plausibly related, signal the system by setting candidateGateId):
+${formatGatedSecretsEn(script, validTopicGateIds)}
+
+THINGS YOU DO NOT KNOW (you must not demonstrate knowledge of these):
+${script.ignorance.map((i) => `  - ${i}`).join("\n")}
+
+YOUR RELATIONSHIPS WITH OTHER CHARACTERS:
+${script.relationships.map((r) => `  - ${r.npcId}: ${r.attitude} (${r.notes})`).join("\n")}
+
+OUTPUT FORMAT \u2014 you MUST return ONLY this JSON object, nothing else:
+{
+  "dialogue": "Your in-character response as ${script.name}",
+  "candidateGateId": null,
+  "gateEvidence": "",
+  "gateConfidence": "low",
+  "candidateActionHint": null
+}
+
+Rules for the JSON fields:
+- dialogue: string, 1-1000 characters. Your response in character.
+- candidateGateId: string (a valid topicGateId) or null. A REVIEW SIGNAL \u2014 set when the player's input is plausibly related to a secret's revealConditions or triggerKeywords. Setting this does NOT reveal the secret; the system decides whether to accept it.
+- gateEvidence: string. What part of the player's input matched the secret's conditions, or "" if no gate triggered.
+- gateConfidence: "low" | "medium" | "high". How confident you are that a gate should trigger.
+EXAMPLES:
+
+POSITIVE (player input plausibly relates \u2192 set candidateGateId):
+  Player: \u201CI found a strange letter hidden in the desk.\u201D
+  \u2192 candidateGateId: \u201Ctopic_suspect_secret_letter\u201D (letter mentioned; plausibly related)
+
+  Player: \u201C\u4F60\u770B\u5230\u90A3\u665A\u7684\u8E2A\u8FF9\u4E86\u5417\uFF1F\u201D
+  \u2192 candidateGateId: \u201Ctopic_witness_footprints\u201D (footprints mentioned; plausibly related)
+
+NEGATIVE (nothing relates \u2192 leave null):
+  Player: "How's the weather today?"
+  \u2192 candidateGateId: null (no secret's topic is mentioned)
+
+  Player: \u201C\u665A\u996D\u5403\u4EC0\u4E48\uFF1F\u201D
+  \u2192 candidateGateId: null (not related to any gate)
+
+- candidateActionHint: string or null. If your dialogue implies an action like giving an item or granting access, describe it here (e.g., "item_given", "access_granted"). The system decides whether the action actually happens.`;
+  return prompt;
+}
+function buildSystemPromptZh(script, validTopicGateIds, currentTrust) {
+  const p = script.persona;
+  const privateKnowledge = currentTrust >= 1 ? script.privateKnowledge : [];
+  const setting = script.worldSetting ?? "\u4E00\u573A\u795E\u79D8\u7684\u8C03\u67E5\u63A8\u7406\u6E38\u620F";
+  let prompt = `\u4F60\u662F${script.name}\uFF0C${script.role}\u3002\u4F60\u662F${setting}\u4E2D\u7684\u89D2\u8272\u3002
+
+\u786C\u6027\u89C4\u5219 \u2014 \u8FDD\u53CD\u4EFB\u4F55\u89C4\u5219\u5C06\u5BFC\u81F4\u6E38\u620F\u51FA\u9519\uFF1A
+1. \u4F60\u4E0D\u662F\u65C1\u767D\u3001\u7CFB\u7EDF\u3001\u4FA6\u63A2\u52A9\u624B\u6216\u5168\u77E5 AI\u3002
+2. \u4F60\u53EA\u80FD\u77E5\u9053\u89D2\u8272\u5267\u672C\u4E2D\u660E\u786E\u5199\u660E\u7684\u4FE1\u606F\u3002
+3. \u5982\u679C\u73A9\u5BB6\u95EE\u8D85\u51FA\u4F60\u77E5\u8BC6\u8303\u56F4\u7684\u4E8B\uFF0C\u4F60\u5FC5\u987B\u4EE5\u89D2\u8272\u8EAB\u4EFD\u8868\u793A\u4E0D\u77E5\u9053\u3001\u56DE\u907F\u3001\u8BEF\u89E3\u6216\u731C\u6D4B\u3002
+4. \u4F60\u4E0D\u5F97\u4E3B\u52A8\u6CC4\u9732\u300C\u95E8\u63A7\u79D8\u5BC6\u300D\u7684\u5185\u5BB9\u3002\u8BBE\u7F6E candidateGateId \u4E0D\u662F\u6CC4\u9732\u2014\u2014\u8FD9\u662F\u53D1\u7ED9\u7CFB\u7EDF\u7684\u5BA1\u67E5\u4FE1\u53F7\uFF0C\u7531\u7CFB\u7EDF\u51B3\u5B9A\u662F\u5426\u89E6\u53D1\u3002
+5. \u5C06 candidateGateId \u89C6\u4E3A\u5BA1\u67E5\u4FE1\u53F7\uFF1A\u5F53\u73A9\u5BB6\u8F93\u5165\u4E0E\u67D0\u4E2A\u95E8\u63A7\u79D8\u5BC6\u7684\u89E6\u53D1\u6761\u4EF6\u6216\u89E6\u53D1\u5173\u952E\u8BCD\u5408\u7406\u76F8\u5173\u65F6\uFF0C\u8BBE\u7F6E\u8BE5\u4FE1\u53F7\u3002\u7CFB\u7EDF\u5BA1\u67E5\u540E\u624D\u51B3\u5B9A\u662F\u5426\u89E6\u53D1\u2014\u2014\u8BEF\u62A5\u65E0\u5BB3\uFF0C\u6F0F\u62A5\u9519\u5931\u673A\u4F1A\u3002
+6. \u4F60\u5FC5\u987B\u53EA\u8F93\u51FA\u5408\u6CD5\u7684 JSON\uFF0C\u4E0D\u80FD\u5728 JSON \u524D\u540E\u8F93\u51FA\u4EFB\u4F55\u6587\u672C\u3002
+7. dialogue \u5FC5\u987B\u662F\u4F60\u672C\u4EBA\u7684\u53E3\u543B\uFF0C\u7B2C\u4E00\u4EBA\u79F0\uFF0C\u7B26\u5408\u4F60\u7684\u6027\u683C\u3002
+8. \u79C1\u5BC6\u77E5\u8BC6\u53EA\u4F1A\u5728\u5F53\u524D\u4FE1\u4EFB\u5141\u8BB8\u65F6\u5217\u5728\u4E0B\u65B9\u3002\u5982\u679C\u6CA1\u6709\u5217\u51FA\uFF0C\u672C\u8F6E\u5BF9\u8BDD\u4F60\u4E0D\u80FD\u4F7F\u7528\u8FD9\u4E9B\u4FE1\u606F\u3002
+
+\u4F60\u7684\u6027\u683C\uFF1A
+- \u6027\u683C\u7279\u70B9\uFF1A${p.personality}
+- \u80CC\u666F\u6545\u4E8B\uFF1A${p.background}
+- \u8BF4\u8BDD\u65B9\u5F0F\uFF1A${p.speechPatterns}`;
+  if (p.emotionalBaseline) {
+    prompt += `
+- \u60C5\u7EEA\u57FA\u8C03\uFF1A${p.emotionalBaseline}`;
+  }
+  if (p.forbiddenTone) {
+    prompt += `
+- \u7981\u6B62\u8BED\u8C03\uFF1A${p.forbiddenTone}`;
+  }
+  prompt += `
+
+\u4F60\u77E5\u9053\u7684\u4E8B\u60C5\uFF08\u516C\u5F00\u77E5\u8BC6 \u2014 \u53EF\u4EE5\u81EA\u7531\u5206\u4EAB\uFF09\uFF1A
+${script.publicKnowledge.map((k) => `  [${k.topic}] ${k.content}`).join("\n")}
+
+\u4F60\u77E5\u9053\u4F46\u4E0D\u4E3B\u52A8\u63D0\u8D77\u7684\u4E8B\u60C5\uFF08\u79C1\u5BC6\u77E5\u8BC6 \u2014 \u9664\u975E\u88AB\u76F4\u63A5\u95EE\u8D77\u5426\u5219\u4E0D\u4F1A\u4E3B\u52A8\u8BF4\uFF09\uFF1A
+${formatKnowledgeList(privateKnowledge, "  \uFF08\u5F53\u524D\u4FE1\u4EFB\u4E0B\u65E0\u53EF\u7528\u79C1\u5BC6\u77E5\u8BC6\uFF09")}
+
+\u95E8\u63A7\u79D8\u5BC6\uFF08\u5185\u5BB9\u4E0D\u5F97\u900F\u9732\u2014\u2014\u4F46\u5F53\u73A9\u5BB6\u8F93\u5165\u5408\u7406\u76F8\u5173\u65F6\uFF0C\u8BF7\u8BBE\u7F6E candidateGateId \u901A\u77E5\u7CFB\u7EDF\u5BA1\u67E5\uFF09\uFF1A
+${formatGatedSecretsZh(script, validTopicGateIds)}
+
+\u4F60\u4E0D\u77E5\u9053\u7684\u4E8B\u60C5\uFF08\u4E0D\u80FD\u8868\u73B0\u51FA\u4E86\u89E3\uFF09\uFF1A
+${script.ignorance.map((i) => `  - ${i}`).join("\n")}
+
+\u4F60\u4E0E\u5176\u4ED6\u89D2\u8272\u7684\u5173\u7CFB\uFF1A
+${script.relationships.map((r) => `  - ${r.npcId}\uFF1A${r.attitude}\uFF08${r.notes}\uFF09`).join("\n")}
+
+\u8F93\u51FA\u683C\u5F0F \u2014 \u4F60\u5FC5\u987B\u53EA\u8FD4\u56DE\u4EE5\u4E0B JSON \u5BF9\u8C61\uFF0C\u4E0D\u5F97\u6709\u5176\u4ED6\u6587\u672C\uFF1A
+{
+  "dialogue": "\u4F60\u4F5C\u4E3A${script.name}\u7684\u89D2\u8272\u5316\u56DE\u7B54",
+  "candidateGateId": null,
+  "gateEvidence": "",
+  "gateConfidence": "low",
+  "candidateActionHint": null
+}
+
+JSON \u5B57\u6BB5\u89C4\u5219\uFF1A
+- dialogue\uFF1A\u5B57\u7B26\u4E32\uFF0C1-1000 \u5B57\u3002\u4F60\u7684\u89D2\u8272\u5316\u56DE\u7B54\u3002
+- candidateGateId\uFF1A\u5B57\u7B26\u4E32\uFF08\u5408\u6CD5\u7684 topicGateId\uFF09\u6216 null\u3002\u5BA1\u67E5\u4FE1\u53F7\u2014\u2014\u5F53\u73A9\u5BB6\u8F93\u5165\u4E0E\u79D8\u5BC6\u7684\u89E6\u53D1\u6761\u4EF6\u6216\u89E6\u53D1\u5173\u952E\u8BCD\u5408\u7406\u76F8\u5173\u65F6\u8BBE\u7F6E\u3002\u8BBE\u7F6E\u6B64\u9879\u4E0D\u7B49\u4E8E\u6CC4\u9732\u79D8\u5BC6\uFF1B\u7CFB\u7EDF\u51B3\u5B9A\u662F\u5426\u91C7\u7EB3\u3002
+- gateEvidence\uFF1A\u5B57\u7B26\u4E32\u3002\u73A9\u5BB6\u8F93\u5165\u4E2D\u5339\u914D\u89E6\u53D1\u6761\u4EF6\u7684\u90E8\u5206\uFF0C\u672A\u89E6\u53D1\u5219\u4E3A ""\u3002
+- gateConfidence\uFF1A"low" | "medium" | "high"\u3002\u4F60\u5BF9\u89E6\u53D1\u95E8\u63A7\u7684\u4FE1\u5FC3\u3002
+\u793A\u4F8B\uFF1A
+
+\u6B63\u4F8B\uFF08\u73A9\u5BB6\u8F93\u5165\u5408\u7406\u76F8\u5173 \u2192 \u8BBE\u7F6E candidateGateId\uFF09\uFF1A
+  \u73A9\u5BB6\uFF1A"\u6211\u5728\u4E66\u684C\u91CC\u53D1\u73B0\u4E86\u4E00\u5C01\u5947\u602A\u7684\u4FE1\u3002"
+  \u2192 candidateGateId: "topic_suspect_secret_letter"\uFF08\u63D0\u5230\u4E86\u4FE1\u4EF6\uFF0C\u5408\u7406\u76F8\u5173\uFF09
+
+  \u73A9\u5BB6\uFF1A"Did you see the footprints that night?"
+  \u2192 candidateGateId: "topic_witness_footprints"\uFF08\u63D0\u5230\u4E86\u8DB3\u8FF9\uFF0C\u5408\u7406\u76F8\u5173\uFF09
+
+\u8D1F\u4F8B\uFF08\u5B8C\u5168\u4E0D\u76F8\u5173 \u2192 \u4FDD\u6301 null\uFF09\uFF1A
+  \u73A9\u5BB6\uFF1A"\u4ECA\u5929\u5929\u6C14\u600E\u4E48\u6837\uFF1F"
+  \u2192 candidateGateId: null\uFF08\u4E0E\u4EFB\u4F55\u79D8\u5BC6\u65E0\u5173\uFF09
+
+  \u73A9\u5BB6\uFF1A"What's for dinner tonight?"
+  \u2192 candidateGateId: null\uFF08\u4E0E\u4EFB\u4F55\u79D8\u5BC6\u65E0\u5173\uFF09
+
+- candidateActionHint\uFF1A\u5B57\u7B26\u4E32\u6216 null\u3002\u5982\u679C\u4F60\u7684\u5BF9\u8BDD\u6697\u793A\u4E86\u67D0\u4E2A\u52A8\u4F5C\uFF08\u5982\u7ED9\u4E88\u7269\u54C1\u3001\u6388\u6743\u8FDB\u5165\uFF09\uFF0C\u5728\u6B64\u63CF\u8FF0\uFF08\u5982 "item_given"\u3001"access_granted"\uFF09\u3002\u7CFB\u7EDF\u51B3\u5B9A\u8BE5\u52A8\u4F5C\u662F\u5426\u5B9E\u9645\u53D1\u751F\u3002`;
+  return prompt;
+}
+function formatKnowledgeList(entries, emptyText) {
+  if (entries.length === 0) return emptyText;
+  return entries.map((k) => `  [${k.topic}] ${k.content}`).join("\n");
+}
+
+// src/dialogue/prompt/user-prompt.ts
+function buildUserPrompt(script, playerInput, context, recentExchanges, lang) {
+  const isZh = lang === "zh";
+  const npcName = script.name;
+  const langInstruction = isZh ? "\u4F60\u5FC5\u987B\u7528\u4E2D\u6587\u56DE\u590D\u3002" : "You must respond in English.";
+  let prompt = `${langInstruction}
+
+CURRENT SITUATION:
+- Room: ${context.currentRoom}
+- Investigation turns remaining: ${context.turnsRemaining}
+- Player's inventory: ${context.playerInventory.length > 0 ? context.playerInventory.join(", ") : "(empty)"}
+- Discovered clues: ${context.discoveredClues.length > 0 ? context.discoveredClues.join(", ") : "(none)"}
+- Your trust toward the player: ${context.currentTrust}/2
+- Topics already discussed: ${context.exhaustedTopicGateIds.length > 0 ? context.exhaustedTopicGateIds.join(", ") : "(none)"}
+- Available topic gates that could be triggered: ${context.validTopicGateIds.length > 0 ? context.validTopicGateIds.join(", ") : "(none)"}`;
+  if (recentExchanges.length > 0) {
+    prompt += `
+
+RECENT CONVERSATION (last ${recentExchanges.length} exchanges):`;
+    for (const ex of recentExchanges) {
+      prompt += `
+Player: "${ex.playerInput}"
+${npcName}: "${ex.npcResponse}"`;
+      if (ex.triggeredTopicGateId) {
+        prompt += ` [triggered: ${ex.triggeredTopicGateId}]`;
+      }
+    }
+  }
+  prompt += `
+
+PLAYER SAYS:
+"${playerInput}"
+
+Respond as ${npcName} in valid JSON.`;
+  return prompt;
+}
+
+// src/dialogue/prompts.ts
+function buildNpcDialoguePrompt(npcScript, playerInput, context, recentExchanges, lang) {
+  const isZh = lang === "zh";
+  const validGateIds = context.validTopicGateIds;
+  const system = isZh ? buildSystemPromptZh(npcScript, validGateIds, context.currentTrust) : buildSystemPromptEn(npcScript, validGateIds, context.currentTrust);
+  const user = buildUserPrompt(npcScript, playerInput, context, recentExchanges, lang);
+  return { system, user };
+}
+
+// src/dialogue/parse.ts
+function parseAiJson(rawText) {
+  let jsonStr = rawText.trim();
+  const codeBlockMatch = jsonStr.match(/```(?:json)?\s*([\s\S]*?)```/);
+  if (codeBlockMatch) {
+    jsonStr = codeBlockMatch[1].trim();
+  }
+  const jsonMatch = jsonStr.match(/\{[\s\S]*\}/);
+  if (jsonMatch) {
+    try {
+      const parsed = JSON.parse(jsonMatch[0]);
+      return buildResponse(parsed);
+    } catch {
+    }
+  }
+  const dialogueMatch = jsonStr.match(/"dialogue"\s*:\s*"((?:[^"\\]|\\.)*)"/);
+  const dialogue = dialogueMatch ? unescapeJsonString(dialogueMatch[1]) : "";
+  let candidateGateId = null;
+  const newGateMatch = jsonStr.match(/"candidateGateId"\s*:\s*"([^"]+)"/);
+  const oldGateMatch = jsonStr.match(/"triggeredTopicGateId"\s*:\s*"([^"]+)"/);
+  if (newGateMatch) {
+    candidateGateId = newGateMatch[1];
+  } else if (oldGateMatch) {
+    candidateGateId = oldGateMatch[1];
+  }
+  let gateConfidence = "low";
+  if (jsonStr.includes('"gateConfidence"') || jsonStr.includes('"confidence"')) {
+    if (jsonStr.includes('"high"')) gateConfidence = "high";
+    else if (jsonStr.includes('"medium"')) gateConfidence = "medium";
+  }
+  let gateEvidence = "";
+  const newEvidenceMatch = jsonStr.match(/"gateEvidence"\s*:\s*"((?:[^"\\]|\\.)*)"/);
+  const oldEvidenceMatch = jsonStr.match(/"matchedEvidence"\s*:\s*"((?:[^"\\]|\\.)*)"/);
+  if (newEvidenceMatch) {
+    gateEvidence = unescapeJsonString(newEvidenceMatch[1]);
+  } else if (oldEvidenceMatch) {
+    gateEvidence = unescapeJsonString(oldEvidenceMatch[1]);
+  }
+  if (!dialogue && !candidateGateId) {
+    throw new Error("No JSON object found in AI response");
+  }
+  return {
+    dialogue,
+    candidateGateId,
+    gateEvidence,
+    gateConfidence,
+    candidateActionHint: null
+  };
+}
+function unescapeJsonString(s) {
+  return s.replace(/\\n/g, "\n").replace(/\\t/g, "	").replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+}
+function buildResponse(parsed) {
+  const dialogue = typeof parsed.dialogue === "string" ? parsed.dialogue : String(parsed.dialogue ?? "");
+  const candidateGateId = typeof parsed.candidateGateId === "string" ? parsed.candidateGateId : typeof parsed.triggeredTopicGateId === "string" ? parsed.triggeredTopicGateId : null;
+  const gateEvidence = typeof parsed.gateEvidence === "string" ? parsed.gateEvidence : typeof parsed.matchedEvidence === "string" ? parsed.matchedEvidence : "";
+  const rawConfidence = parsed.gateConfidence ?? parsed.confidence;
+  const gateConfidence = rawConfidence === "low" || rawConfidence === "medium" || rawConfidence === "high" ? rawConfidence : "low";
+  const candidateActionHint = typeof parsed.candidateActionHint === "string" ? parsed.candidateActionHint : null;
+  return {
+    dialogue,
+    candidateGateId,
+    gateEvidence,
+    gateConfidence,
+    candidateActionHint
+  };
+}
+
+// src/dialogue/schema.ts
+function validateDialogueResponse(parsed) {
+  const result = { ...parsed };
+  if (typeof result.dialogue !== "string" || result.dialogue.length < 1) {
+    result.dialogue = "...";
+  }
+  if (result.dialogue.length > 1e3) {
+    result.dialogue = result.dialogue.slice(0, 1e3);
+  }
+  if (typeof result.candidateGateId !== "string") {
+    result.candidateGateId = null;
+  }
+  if (typeof result.gateEvidence !== "string") {
+    result.gateEvidence = "";
+  }
+  if (result.gateConfidence !== "low" && result.gateConfidence !== "medium" && result.gateConfidence !== "high") {
+    result.gateConfidence = "low";
+  }
+  if (typeof result.candidateActionHint !== "string") {
+    result.candidateActionHint = null;
+  }
+  return result;
+}
+
+// src/dialogue/gate-review.ts
+function expandKeywordsBilingually(englishKeywords, bilingualMap) {
+  if (!bilingualMap || Object.keys(bilingualMap).length === 0) {
+    return [...englishKeywords];
+  }
+  const expanded = [...englishKeywords];
+  for (const kw of englishKeywords) {
+    const lower = kw.toLowerCase();
+    if (bilingualMap[lower]) {
+      expanded.push(...bilingualMap[lower]);
+    }
+    for (const [engKey, zhValues] of Object.entries(bilingualMap)) {
+      if (lower.includes(engKey) || engKey.includes(lower)) {
+        expanded.push(...zhValues);
+      }
+    }
+  }
+  return expanded;
+}
+function reviewGateTrigger(validated, playerInput, npcScript, _context, options) {
+  if (validated.candidateGateId === null) {
+    return validated;
+  }
+  const playerLower = playerInput.trim().toLowerCase();
+  const secret = npcScript.gatedSecrets.find(
+    (s) => s.topicGateId === validated.candidateGateId
+  );
+  if (!secret) {
+    return { ...validated, candidateGateId: null };
+  }
+  const triggerTerms = [
+    ...secret.triggerKeywords ?? [],
+    ...secret.triggerPhrases ?? []
+  ].filter((term) => term.trim().length > 0);
+  const expandedTerms = expandKeywordsBilingually(triggerTerms, options?.bilingualKeywordMap);
+  const hasExplicitTerms = expandedTerms.length > 0;
+  const hasRelevance = expandedTerms.some((kw) => playerLower.includes(kw.toLowerCase()));
+  if (hasExplicitTerms && !hasRelevance) {
+    return { ...validated, candidateGateId: null };
+  }
+  const hasGateEvidence = validated.gateEvidence && validated.gateEvidence.trim().length > 0;
+  const hasConfidence = validated.gateConfidence === "medium" || validated.gateConfidence === "high";
+  if (!hasGateEvidence && !hasConfidence) {
+    return { ...validated, candidateGateId: null };
+  }
+  return validated;
+}
+
+// src/dialogue/engine.ts
+var DEFAULT_DIALOGUE_CONFIG = {
+  lang: "en",
+  maxConversationHistory: 5,
+  failOpen: true
+};
+var DialogueEngine = class {
+  provider;
+  auditLog;
+  config;
+  lang;
+  initialized = false;
+  constructor(provider, config) {
+    this.provider = provider;
+    this.config = { ...DEFAULT_DIALOGUE_CONFIG, ...config };
+    this.lang = this.config.lang;
+    this.auditLog = new AuditLog(1e3);
+  }
+  // ─── Lifecycle ─────────────────────────────────────────────────────
+  async initialize() {
+    if (this.initialized) return;
+    this.initialized = true;
+  }
+  async dispose() {
+    this.initialized = false;
+  }
+  isAiAvailable() {
+    if (this.provider.id === "passthrough") return false;
+    const status = this.provider.getStatus();
+    return status.state === "ready" || status.state === "degraded";
+  }
+  // ─── Core API ──────────────────────────────────────────────────────
+  async handleFreeFormDialogue(request) {
+    const startTime = Date.now();
+    const passthroughResult = {
+      dialogue: "",
+      candidateGateId: null,
+      gateEvidence: "",
+      gateConfidence: "low",
+      candidateActionHint: null,
+      triggeredTopicGateId: null,
+      source: "passthrough",
+      latencyMs: Date.now() - startTime,
+      rawAiText: "",
+      model: "",
+      systemPrompt: "",
+      userPrompt: ""
+    };
+    if (!this.isAiAvailable()) {
+      return passthroughResult;
+    }
+    const { system, user } = buildNpcDialoguePrompt(
+      request.npcScript,
+      request.playerInput,
+      request.context,
+      request.context.recentExchanges.slice(-this.config.maxConversationHistory),
+      this.lang
+    );
+    let rawText;
+    let rawModel = "";
+    let rawPromptTokens;
+    let rawCompletionTokens;
+    try {
+      const narrativeRequest = this.buildMinimalRequest(request);
+      const raw = await this.provider.call(narrativeRequest, system, user);
+      rawText = raw.text;
+      rawModel = raw.model;
+      rawPromptTokens = raw.promptTokenCount;
+      rawCompletionTokens = raw.completionTokenCount;
+    } catch (err) {
+      console.error("[DialogueEngine] provider.call failed:", err);
+      return passthroughResult;
+    }
+    let parsed;
+    try {
+      parsed = parseAiJson(rawText);
+    } catch {
+      return {
+        dialogue: rawText.slice(0, 1e3) || "...",
+        candidateGateId: null,
+        gateEvidence: "",
+        gateConfidence: "low",
+        candidateActionHint: null,
+        triggeredTopicGateId: null,
+        source: "ai",
+        latencyMs: Date.now() - startTime,
+        rawAiText: rawText,
+        model: rawModel,
+        systemPrompt: system,
+        userPrompt: user
+      };
+    }
+    const validated = validateDialogueResponse(parsed);
+    const reviewed = reviewGateTrigger(
+      validated,
+      request.playerInput,
+      request.npcScript,
+      request.context,
+      { bilingualKeywordMap: this.config.bilingualKeywordMap }
+    );
+    this.recordAudit(request, reviewed, startTime);
+    return {
+      dialogue: reviewed.dialogue,
+      candidateGateId: reviewed.candidateGateId,
+      gateEvidence: reviewed.gateEvidence,
+      gateConfidence: reviewed.gateConfidence,
+      candidateActionHint: reviewed.candidateActionHint,
+      source: "ai",
+      latencyMs: Date.now() - startTime,
+      rawAiText: rawText,
+      model: rawModel,
+      promptTokens: rawPromptTokens,
+      completionTokens: rawCompletionTokens,
+      systemPrompt: system,
+      userPrompt: user,
+      // Backward compatibility
+      triggeredTopicGateId: reviewed.candidateGateId
+    };
+  }
+  // ─── Helpers ───────────────────────────────────────────────────────
+  buildMinimalRequest(request) {
+    return {
+      id: `dlg_${Date.now().toString(36)}`,
+      type: "dialogue",
+      turnIndex: request.context.currentTurn,
+      events: [],
+      commandMessage: request.playerInput,
+      visibleState: {},
+      grounding: {
+        currentRoomName: request.context.currentRoom,
+        visibleExits: [],
+        presentNpcNames: [],
+        inventoryItemNames: request.context.playerInventory,
+        discoveredClueNames: request.context.discoveredClues,
+        knownConsequences: [],
+        turnsRemaining: request.context.turnsRemaining
+      },
+      timestamp: Date.now(),
+      lang: this.lang
+    };
+  }
+  recordAudit(request, result, startTime) {
+    const record = {
+      requestId: `dlg_audit_${Date.now().toString(36)}`,
+      turnIndex: request.context.currentTurn,
+      requestType: "dialogue",
+      eventTypes: [],
+      commandVerb: "talk",
+      responseSource: "ai",
+      responseTextPreview: result.dialogue.slice(0, 100),
+      validationPassed: true,
+      constraintViolations: [],
+      providerState: this.provider.getStatus().state,
+      providerId: this.provider.id,
+      promptStructure: {
+        systemPromptHash: "",
+        groundingFactCount: 0,
+        eventCount: 0
+      },
+      latencyMs: Date.now() - startTime,
+      timestamp: Date.now()
+    };
+    this.auditLog.append(record);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuditLog,
+  DialogueEngine,
+  OpenAICompatibleProvider,
+  PassthroughProvider,
+  buildNpcDialoguePrompt,
+  expandKeywordsBilingually,
+  loadConfigFromEnv,
+  parseAiJson,
+  reviewGateTrigger,
+  validateDialogueResponse
+});
+//# sourceMappingURL=index.cjs.map