@fcg-labs/cx-agent-hook 0.2.0 → 0.2.2

package/index.d.ts

@@ -51,6 +51,8 @@ export interface CxHook {
     setDraft: (text: string) => void;
     setStatus?: (text: string) => void;
     confirmOverwrite?: () => boolean;
+    /** 호칭 개인화용 고객 이름 — LLM 미반출, 인사말에만 클라 치환 */
+    customerName?: string;
   }): { promise: Promise<AnswerResult>; abort: () => void };
 
   /** 제안을 에디터에 넣었다 (패널이 부른다) */

package/index.js

@@ -123,7 +123,7 @@ export function createCxHook(config = {}) {
      * @returns {{promise: Promise<object>, abort: ()=>void}}
      */
     composeDraft({ inquiry, context, getDraft, setDraft, setStatus,
-                   confirmOverwrite } = {}) {
+                   confirmOverwrite, customerName } = {}) {
       const status = (text) => { if (setStatus) setStatus(text || ""); };
       const noop = { promise: Promise.resolve(NOT_CONFIGURED), abort: () => {} };
       if (!client || !inquiry || typeof setDraft !== "function") {
@@ -140,10 +140,28 @@ export function createCxHook(config = {}) {
       // 새 스트림 = 이전 채택 무효 (문의가 같아도 초안이 바뀐다)
       adoptedAnswerId = null;
 
+      // 호칭 개인화 — 0.2.2: 이름을 context 로도 보낸다. 서버가 사설
+      // 서빙(AI_CS_LLM_PRIVATE)이면 인사말을 처음부터 이름으로 굽고,
+      // **저장은 하지 않는다**(로그에는 name_provided 마커만 — 서버 계약).
+      // 아래 클라 치환은 안전망으로 유지: 구 서버·클라우드 폴백처럼 이름
+      // 없이 "안녕하세요 고객님"으로 온 초안에만 작동하고, 서버가 이미
+      // 이름을 넣었으면 패턴이 안 맞아 no-op 이다.
+      const name = String(customerName || "").trim();
+      const contextWithName = name
+        ? { ...(context || {}), customerName: name }
+        : context;
+      const personalize = (text) =>
+        name
+          ? String(text).replace(
+              /안녕하세요[,]?\s*고객님/,
+              (m) => m.replace("고객님", `${name} 고객님`),
+            )
+          : text;
+
       const controller = new AbortController();
       let accumulated = "";
       let pending = null;
-      const flushDraft = () => { pending = null; setDraft(accumulated); };
+      const flushDraft = () => { pending = null; setDraft(personalize(accumulated)); };
       const queueDraft = () => {
         // trailing 스로틀 — 청크마다 리렌더하면 큰 화면이 버벅인다
         if (pending === null) pending = setTimeout(flushDraft, 80);
@@ -154,7 +172,7 @@ export function createCxHook(config = {}) {
 
       status(messages.ui_requesting);
       setDraft("");
-      const promise = client.getAnswerStream(inquiry, context, {
+      const promise = client.getAnswerStream(inquiry, contextWithName, {
         signal: controller.signal,
         onDelta(text) { accumulated += text; queueDraft(); },
         onRestart() {
@@ -170,7 +188,7 @@ export function createCxHook(config = {}) {
       }).then((result) => {
         clearPending();
         if (result.answered) {
-          setDraft(result.answer);          // 정본으로 확정 (strip 반영)
+          setDraft(personalize(result.answer)); // 정본 확정 (strip+호칭 반영)
           adoptedAnswerId = result.answerId ?? null;
           status("");
         } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fcg-labs/cx-agent-hook",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "FCG CX Agent 후킹 SDK — 서빙 답변 수신 + CS팀 교정(점수·수정·발송) 후킹. 의존성 0, CMS에 install만으로 이식",
   "type": "module",
   "main": "index.js",
@@ -100,4 +100,4 @@
     "access": "public"
   },
   "//name": "스코프는 @fcg-labs — org 소유이고 @fcg-labs/tlm 과 같은 자리다. @fcg 는 우리 것이 아니다(발행 불가)."
-}
+}