@fcg-labs/cx-agent-hook 0.5.0 → 0.6.0

package/MIGRATION.md

@@ -1,3 +1,28 @@
+# 0.5.x → 0.6.0 마이그레이션
+
+## 요약 — 대상 확정(더블체크, 계약 §B.10)이 추가된다. **깨지는 것 없음** (additive)
+
+문의 컨텍스트 값(예: subUserId)이 PK 라는 보장이 없다 — 오타깃 실행은 다른 유저
+데이터 손상이다. 0.6.0 부터 절차 자산이 `verify`(대상 확정)를 들고 오면 SDK 가
+쓰기 전에 **읽기 전용 API 로 대상을 확인**한다. `verify` 없는 offer 는 0.5.x 와
+바이트 동일하게 동작한다. 고객사 코드 변경 0 — `adminApi` 그대로.
+
+## 새로 생긴 것
+
+- `offer.verify` — `{action_key(읽기), execution(GET 사양), display_fields[{path,label}],
+  preconditions[], resolution}`. 서버(asset v6)가 동봉한다.
+- 실행 흐름: 선점 → **verify 읽기(GET 강제·재시도 0)** → precondition 결정적 평가 →
+  쓰기(읽기 직후 즉시) → 보고. 차단은 전부 `failed` 로 허브 원장에 남는다 —
+  reasonCode `precondition_failed`(deny_copy 가 메시지) · `verify_unavailable` ·
+  `verify_not_readonly` · `verify_manual`.
+- 확인 패널: 열릴 때 같은 읽기로 **대상 확인 블록**(`fcx-act-verify*`)을 렌더하고,
+  확인이 ok 되기 전에는 실행 버튼이 나오지 않는다 (위험도 무관).
+- `session.verifyAction(offer)`(패널 미리보기) · `session.actionVerifies()`,
+  순수 함수 `pluck`·`evaluatePreconditions`·`verifyViaAdminApi` (actions.js).
+- 로케일 키 4종: `ui_action_verify_title/loading/blocked/failed` (ko·en·ja·zh-TW).
+
+---
+
 # 0.4.0 → 0.5.0 마이그레이션
 
 ## 요약 — 처리 액션 표면만 바뀐다 (0.3.0 표면은 그대로)

package/actions.js

@@ -133,6 +133,82 @@ function normalizeResponse(res) {
   return { httpStatus: 200, body: res };
 }
 
+/** 응답 JSON 경로 추출 — `pluck(body, "data.gender")`. 없으면 undefined (결정적). */
+export function pluck(obj, path) {
+  let cur = obj;
+  for (const part of String(path || "").split(".")) {
+    if (!part) continue;
+    if (cur === null || cur === undefined || typeof cur !== "object") return undefined;
+    cur = cur[part];
+  }
+  return cur;
+}
+
+/**
+ * 대상 확정 precondition 의 결정적 평가 — 계약 §B.10. LLM 판정 없음.
+ *   not_equals_param: 응답값 === 바인딩값 이면 차단 (예: 현재 성별 === 요청 성별 → 변경 불요)
+ *   equals_param:     응답값 !== 바인딩값 이면 차단 (대상 동일성 확인)
+ *   equals_value:     응답값 !== 리터럴 이면 차단
+ * @returns {{blocked:boolean, path:string, denyCopy:string}}
+ */
+export function evaluatePreconditions(preconditions, body, paramsBound) {
+  const bound = paramsBound && typeof paramsBound === "object" ? paramsBound : {};
+  for (const p of Array.isArray(preconditions) ? preconditions : []) {
+    if (!p || typeof p !== "object" || !p.path) continue;
+    const val = pluck(body, p.path);
+    let blocked = false;
+    if (p.not_equals_param) blocked = String(val) === String(bound[p.not_equals_param]);
+    else if (p.equals_param) blocked = String(val) !== String(bound[p.equals_param]);
+    else if (p.equals_value !== undefined && p.equals_value !== "") blocked = String(val) !== String(p.equals_value);
+    if (blocked) return { blocked: true, path: String(p.path), denyCopy: String(p.deny_copy || "") };
+  }
+  return { blocked: false, path: "", denyCopy: "" };
+}
+
+/**
+ * 대상 확정(더블체크) 읽기 — 계약 §B.10 (T2.7). 쓰기 전에 offer.verify 의 **읽기 전용**
+ * API 로 대상을 조회해 ① 표시 항목(display_fields)을 뽑고 ② precondition 을 결정적으로
+ * 평가한다. 문의 컨텍스트 값이 PK 라는 보장이 없다 — 오타깃 실행은 타인 데이터 손상이라
+ * 읽기 실패·비 2xx·GET 아님은 전부 **실행 차단**(fail-closed)이다.
+ * @returns {Promise<{ok:boolean, skipped?:boolean, reasonCode?:string, message?:string,
+ *                    denyCopy?:string, display:Array<{label:string,value:string}>, httpStatus?:number}>}
+ */
+export async function verifyViaAdminApi(adminApi, offer) {
+  const v = offer && offer.verify;
+  if (!v || typeof v !== "object") return { ok: true, skipped: true, display: [] };
+  if (v.resolution === "manual") {
+    // 단건 조회로 대상 확정 불가 선언 — 자동 실행 경로가 아예 아니다 (서버 조립도 막지만 이중 방어)
+    return { ok: false, reasonCode: "verify_manual", display: [] };
+  }
+  const resolved = resolveExecution(v.execution, offer && offer.params_bound, adminApi && adminApi.endpoints);
+  if (!resolved.ok) return { ok: false, reasonCode: "verify_unavailable", message: resolved.error || "", display: [] };
+  if (resolved.method !== "get") {
+    // 검증이 부작용을 내면 안 된다 — 읽기 전용 강제
+    return { ok: false, reasonCode: "verify_not_readonly", display: [] };
+  }
+  let httpStatus = 0; let body;
+  try {
+    const res = await adminApi.request({ method: resolved.method, url: resolved.url,
+                                         path: resolved.path, query: resolved.query, data: resolved.data });
+    ({ httpStatus, body } = normalizeResponse(res));
+  } catch (err) {
+    const resp = err && err.response;
+    if (resp && typeof resp.status === "number") { httpStatus = resp.status; body = resp.data; }
+    else return { ok: false, reasonCode: "verify_unavailable", message: "transport", display: [] };
+  }
+  if (httpStatus < 200 || httpStatus >= 300) {
+    return { ok: false, reasonCode: "verify_unavailable", message: `HTTP ${httpStatus}`, httpStatus, display: [] };
+  }
+  const display = (Array.isArray(v.display_fields) ? v.display_fields : []).map((f) => {
+    const val = pluck(body, f && f.path);
+    return { label: String((f && (f.label || f.path)) || ""),
+             value: val === undefined || val === null ? "—" : String(val) };
+  });
+  const pre = evaluatePreconditions(v.preconditions, body, offer && offer.params_bound);
+  if (pre.blocked) return { ok: false, reasonCode: "precondition_failed", denyCopy: pre.denyCopy, display, httpStatus };
+  return { ok: true, display, httpStatus };
+}
+
 /**
  * CMS API 1회 호출 + 판정. **재시도 0.** adminApi.request({method,url,path,query,data}) 는
  * CMS 의 기존 헬퍼(예: TempAdminApi.request) 참조 — 세션 인증·화이트리스트·진행바는

package/element.js

@@ -204,10 +204,19 @@ function createActionsClass() {
       this.replaceChildren();
       if (!this.#agent || !this.#session) return;
       const tree = actionOffersTree({ offers: this.#offers, pending: this.#pending,
-        enabled: Boolean(this.#agent.actionsEnabled), confirming: this.#confirming, messages: this.#agent.messages });
+        enabled: Boolean(this.#agent.actionsEnabled), confirming: this.#confirming,
+        verifies: typeof this.#session.actionVerifies === "function" ? this.#session.actionVerifies() : {},
+        messages: this.#agent.messages });
       if (!tree) return;
       const actions = {
-        confirm: (e) => { this.#confirming = e.currentTarget.dataset.offer || null; this.#ackedOffer = null; this.#render(); },
+        confirm: (e) => {
+          const id = e.currentTarget.dataset.offer || null;
+          this.#confirming = id; this.#ackedOffer = null;
+          // 대상 확정 (T2.7) — 패널이 열리면 읽기 확인을 시동한다 (결과는 notify 로 재렌더)
+          const offer = this.#offers.find((o) => o.offer_id === id);
+          if (offer && offer.verify && typeof this.#session.verifyAction === "function") this.#session.verifyAction(offer);
+          this.#render();
+        },
         cancel: () => { this.#confirming = null; this.#ackedOffer = null; this.#render(); },
         ack: (e) => { const id = e.currentTarget.dataset.offer; this.#ackedOffer = this.#ackedOffer === id ? null : id; this.#render(); },
         execute: (e) => this.#execute(e.currentTarget.dataset.offer),

package/locales.js

@@ -48,6 +48,10 @@ const en = {
   ui_action_risk_low: "low risk",
   ui_action_risk_medium: "medium risk",
   ui_action_risk_high: "high risk",
+  ui_action_verify_title: "Confirm the target before running",
+  ui_action_verify_loading: "Checking the target…",
+  ui_action_verify_blocked: "Blocked by a pre-run check.",
+  ui_action_verify_failed: "Could not confirm the target — this action will not run.",
   ui_overwrite_confirm: "Replace your current draft with the AI draft?",
   // 거절·오류 사유
   not_configured: "AI reply suggestions are not connected yet.",
@@ -91,6 +95,10 @@ const ko = {
   ui_action_risk_low: "위험 낮음",
   ui_action_risk_medium: "위험 보통",
   ui_action_risk_high: "위험 높음",
+  ui_action_verify_title: "실행 전 대상 확인",
+  ui_action_verify_loading: "대상 확인 중…",
+  ui_action_verify_blocked: "실행 전 확인에서 차단되었습니다.",
+  ui_action_verify_failed: "대상을 확인할 수 없습니다 — 실행하지 않습니다.",
   ui_overwrite_confirm: "작성 중인 답변을 지우고 AI 초안으로 바꿀까요?",
   not_configured: "AI 답변 제안이 아직 연결되지 않았습니다.",
   unsupported_api: "AI 답변 제안이 아직 연결되지 않았습니다.",
@@ -129,6 +137,10 @@ const ja = {
   ui_action_risk_low: "リスク低",
   ui_action_risk_medium: "リスク中",
   ui_action_risk_high: "リスク高",
+  ui_action_verify_title: "実行前に対象を確認",
+  ui_action_verify_loading: "対象を確認しています…",
+  ui_action_verify_blocked: "実行前チェックでブロックされました。",
+  ui_action_verify_failed: "対象を確認できません — 実行しません。",
   ui_overwrite_confirm: "作成中の回答を消してAI下書きに置き換えますか？",
   not_configured: "AI 返信案はまだ接続されていません。",
   unsupported_api: "AI 返信案はまだ接続されていません。",
@@ -167,6 +179,10 @@ const zhTW = {
   ui_action_risk_low: "風險低",
   ui_action_risk_medium: "風險中",
   ui_action_risk_high: "風險高",
+  ui_action_verify_title: "執行前確認對象",
+  ui_action_verify_loading: "正在確認對象…",
+  ui_action_verify_blocked: "已被執行前檢查擋下。",
+  ui_action_verify_failed: "無法確認對象 — 不會執行。",
   ui_overwrite_confirm: "要清除目前草稿並以 AI 草稿取代嗎？",
   not_configured: "AI 回覆建議尚未連接。",
   unsupported_api: "AI 回覆建議尚未連接。",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fcg-labs/cx-agent-hook",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "FCG CX Agent 후킹 SDK — 서빙 답변 수신 + CS팀 교정(점수·수정·발송) 후킹. 의존성 0, CMS에 install만으로 이식",
   "type": "module",
   "main": "index.js",

package/react.js

@@ -144,11 +144,18 @@ export function ActionOffersPanel({ session, agent, actorClaimed, onResult, clas
   }, [offers, ackedOffer, session, onResult]);
 
   if (!session || !agent) return null;
-  const tree = actionOffersTree({ offers, pending, enabled: Boolean(agent.actionsEnabled), confirming, messages: agent.messages });
+  const tree = actionOffersTree({ offers, pending, enabled: Boolean(agent.actionsEnabled), confirming,
+    verifies: typeof session.actionVerifies === "function" ? session.actionVerifies() : {},
+    messages: agent.messages });
   if (!tree) return null;
 
   const actions = {
-    confirm: (e) => { setConfirming(e.currentTarget.dataset.offer || null); setAckedOffer(null); },
+    confirm: (e) => {
+      const id = e.currentTarget.dataset.offer || null;
+      setConfirming(id); setAckedOffer(null);
+      const offer = offers.find((o) => o.offer_id === id);
+      if (offer && offer.verify && typeof session.verifyAction === "function") session.verifyAction(offer); // T2.7 — 결과는 notify 재렌더
+    },
     cancel: () => { setConfirming(null); setAckedOffer(null); },
     ack: (e) => { const id = e.currentTarget.dataset.offer; setAckedOffer((v) => (v === id ? null : id)); },
     execute: (e) => execute(e.currentTarget.dataset.offer),

package/session.js

@@ -24,7 +24,7 @@
  * **수명이 다르다**: 요청은 전송 **전에** 남고, 종단 뒤 24h 까지 살아 새로고침·
  * 재진입 시 "이미 눌렀던 것" 을 안다. 정본은 허브 원장이다 — 브라우저 소실은
  * 기록 손실이 아니라 표시 손실일 뿐. localStorage 부재면 메모리로만 산다. */
-import { executeViaAdminApi } from "./actions.js";
+import { executeViaAdminApi, verifyViaAdminApi } from "./actions.js";
 
 export class ActionLedger {
   constructor({ impl, prefix = "cx-agent-actions", terminalTtlMs = 24 * 60 * 60 * 1000 } = {}) {
@@ -156,6 +156,7 @@ export class InquirySession {
     this._offers = [];              // 마지막 답변의 처리 선택지 (actions/1 §4)
     this._actionUi = null;
     this._locks = {};               // action_key\x00target_key → 잠금 조회 결과 (세션 캐시)
+    this._verify = {};              // offer_id → 대상 확정(더블체크) 결과 (T2.7, 화면 표시용 캐시)
 
     // 영속 복원 — TTL 만료분은 store 가 이미 걸렀다
     if (this._id && deps.store) {
@@ -263,6 +264,27 @@ export class InquirySession {
       return { requestId, ...r };
     }
     if (d.actionLedger) d.actionLedger.put(requestId, { ...rec, state: "received" });
+    // ②-a 대상 확정 (T2.7, 계약 §B.10) — verify 동봉 offer 는 **쓰기 직전에 읽기 재검**.
+    // 패널의 verifyAction 표시와 별개로 여기서 다시 읽는다 (TOCTOU 최소화 — 읽기
+    // 직후 즉시 쓰기). 읽기 실패·precondition 불통과 = 실행 차단 + 원장 보고.
+    if (offer.verify) {
+      const vr = await verifyViaAdminApi(d.adminApi, offer);
+      this._verify[offer.offer_id] = { state: vr.ok ? "ok" : "blocked", reasonCode: vr.reasonCode || "",
+                                       denyCopy: vr.denyCopy || "", message: vr.message || "", display: vr.display || [] };
+      if (!vr.ok) {
+        const reasonCode = vr.reasonCode || "verify_unavailable";
+        const message = vr.denyCopy || vr.message || "";
+        const report = { state: "failed", reasonCode, message, httpStatus: vr.httpStatus || 0, latencyMs: 0 };
+        const rep = await d.client.reportActionResult(requestId, report);
+        const unreported = !rep.ok && rep.httpStatus === 0;
+        if (d.actionLedger) {
+          d.actionLedger.put(requestId, { ...rec, state: "failed", reasonCode, message,
+                                          unreported, pendingReport: unreported ? report : undefined });
+        }
+        this._notifyActions();
+        return { requestId, ok: true, state: "failed", reasonCode, message, reported: !unreported, error: null };
+      }
+    }
     // ② CMS 자기 API — 재시도 0
     const out = await executeViaAdminApi(d.adminApi, offer);
     if (out.authExpired && typeof d.adminApi.onAuthExpired === "function") {
@@ -285,6 +307,25 @@ export class InquirySession {
     return { requestId, ok: true, state: out.state, reasonCode: out.reasonCode, message: out.message,
              reported: !unreported, error: null };
   }
+  /**
+   * 대상 확정 미리보기 (T2.7) — 확인 패널이 열릴 때 UI 가 부른다. 결과는 캐시돼
+   * 카드의 "대상 확인" 블록에 표시되고, 실행 버튼은 ok 일 때만 나온다.
+   * 실제 실행(executeAction)은 이 캐시를 믿지 않고 쓰기 직전에 다시 읽는다.
+   */
+  async verifyAction(offer) {
+    const d = this._d;
+    if (!offer || !offer.offer_id || !offer.verify) return { ok: true, skipped: true, display: [] };
+    if (!d.adminApi || typeof d.adminApi.request !== "function") return { ok: false, reasonCode: "admin_api_missing", display: [] };
+    this._verify[offer.offer_id] = { state: "loading", reasonCode: "", denyCopy: "", message: "", display: [] };
+    this._notifyActions();
+    const out = await verifyViaAdminApi(d.adminApi, offer);
+    this._verify[offer.offer_id] = { state: out.ok ? "ok" : "blocked", reasonCode: out.reasonCode || "",
+                                     denyCopy: out.denyCopy || "", message: out.message || "", display: out.display || [] };
+    this._notifyActions();
+    return out;
+  }
+  /** offer_id → 대상 확정 상태 스냅샷 — view 의 `verifies` 입력. */
+  actionVerifies() { return { ...this._verify }; }
   /** 미보고 결과 재보고 — 재실행이 아니다. ledger 의 pendingReport 만 다시 보낸다. */
   async resendResult(requestId) {
     const d = this._d;

package/styles.css

@@ -139,6 +139,15 @@
   background: var(--fcx-surface-2, #e8eef7); border-radius: var(--fcx-radius, 10px);
 }
 .fcx-act-confirm-text { font-weight: 600; }
+/* 대상 확인 블록 (T2.7 §B.10) — 실행 전 읽기 검증 표시 */
+.fcx-act-verify {
+  display: grid; gap: 2px; padding: 6px 8px;
+  border: 1px dashed var(--fcx-accent, #2f6fed); border-radius: 6px;
+  background: var(--fcx-surface, #fff);
+}
+.fcx-act-verify-title { font-weight: 600; font-size: 0.92em; }
+.fcx-act-verify-line { font-variant-numeric: tabular-nums; }
+.fcx-act-verify-status { color: var(--fcx-warn, #6b4a0b); font-size: 0.92em; }
 .fcx-act-ack {
   justify-self: start; cursor: pointer; font: inherit;
   padding: 2px 4px; border: 0; background: transparent; border-radius: 4px;
@@ -151,6 +160,8 @@
 .fcx-act-status[data-state="failed"] { color: var(--fcx-danger, #b42318); }
 .fcx-act-status[data-state="unknown"] { color: var(--fcx-warn, #9a6a12); }
 .fcx-act-status[data-state="unavailable"] { color: var(--fcx-muted, #5b6b7d); font-style: italic; }
+.fcx-act-success-copy { margin-top: 4px; padding: 6px 8px; font-size: 13px; border-radius: 6px;
+  background: var(--fcx-success-bg, #e8f5ec); color: var(--fcx-success, #1f7a3f); }
 .fcx-act-locked {
   color: var(--fcx-success, #1f7a3f);
   padding: 4px 8px; border-radius: 6px;
@@ -161,6 +172,7 @@
 [data-fcx-theme="dark"] .fcx-act { color: var(--fcx-text, #dbe6f3); }
 [data-fcx-theme="dark"] .fcx-act-params, [data-fcx-theme="dark"] .fcx-act-status { color: var(--fcx-muted, #8ba0b8); }
 [data-fcx-theme="dark"] .fcx-act-risk, [data-fcx-theme="dark"] .fcx-act-confirm { background: var(--fcx-surface-2, #182238); }
+[data-fcx-theme="dark"] .fcx-act-verify { background: var(--fcx-surface, #0f1626); }
 [data-fcx-theme="dark"] .fcx-act-locked { background: var(--fcx-success-bg, #12301c); }
 
 @media (prefers-reduced-motion: reduce) {

package/view.js

@@ -126,10 +126,15 @@ export const ACTION_CLS = {
   button: "fcx-act-button",
   confirm: "fcx-act-confirm",
   confirmText: "fcx-act-confirm-text",
+  verify: "fcx-act-verify",
+  verifyTitle: "fcx-act-verify-title",
+  verifyLine: "fcx-act-verify-line",
+  verifyStatus: "fcx-act-verify-status",
   ack: "fcx-act-ack",
   status: "fcx-act-status",
   locked: "fcx-act-locked",
   resend: "fcx-act-resend",
+  successCopy: "fcx-act-success-copy",
 };
 
 const RISK_KEY = { low: "ui_action_risk_low", medium: "ui_action_risk_medium", high: "ui_action_risk_high" };
@@ -147,9 +152,10 @@ function fmtWhen(iso) {
  * @param {Array} pending session.pendingActions()  [{requestId, offerId, state, reasonCode, message, label, unreported}]
  * @param {boolean} enabled  agent.actionsEnabled
  * @param {string|null} confirming  확인 패널이 열린 offer_id
+ * @param {Record<string,object>} verifies  session.actionVerifies() — offer_id → 대상 확정 상태 (T2.7)
  * @param {Record<string,string>} messages
  */
-export function actionOffersView({ offers = [], pending = [], enabled = true, confirming = null, messages = {} }) {
+export function actionOffersView({ offers = [], pending = [], enabled = true, confirming = null, verifies = {}, messages = {} }) {
   const byOffer = new Map();
   for (const p of pending) byOffer.set(p.offerId, p);
   const items = offers.map((o) => {
@@ -164,6 +170,19 @@ export function actionOffersView({ offers = [], pending = [], enabled = true, co
     else if (state === "failed") statusText = `${messages.ui_action_failed}${p && p.message ? " — " + p.message : ""}`;
     else if (state === "unknown") statusText = messages.ui_action_unknown;
     if (p && p.unreported) statusText = `${statusText} · ${messages.ui_action_unreported}`;
+    // success_copy 는 실행이 실제로 성공한 뒤에만 — 절차 자산의 "실행 성공 후 문구"
+    // (실행 전 카드·답변에 실으면 완료 사칭이 된다. 서버도 같은 이유로 승인 게이트를 둔다.)
+    const successCopy = state === "succeeded" ? String(o.success_copy || "") : "";
+    const needsVerify = Boolean(o.verify);
+    const vr = needsVerify ? (verifies[o.offer_id] || null) : null;
+    const verifyState = !needsVerify ? "" : (vr ? vr.state : "none");
+    let verifyText = "";
+    if (needsVerify && (verifyState === "none" || verifyState === "loading")) {
+      verifyText = messages.ui_action_verify_loading;
+    } else if (verifyState === "blocked") {
+      verifyText = (vr && vr.denyCopy)
+        || (vr && vr.reasonCode === "precondition_failed" ? messages.ui_action_verify_blocked : messages.ui_action_verify_failed);
+    }
     let lockedText = "";
     if (locked) {
       const who = o.lock && o.lock.actorClaimed ? ` · ${o.lock.actorClaimed}` : "";
@@ -180,11 +199,17 @@ export function actionOffersView({ offers = [], pending = [], enabled = true, co
       buttonLabel: messages.ui_action_execute,
       confirming: confirming === o.offer_id,
       confirmText: o.confirm || messages.ui_action_confirm_default,
+      // 대상 확정 (T2.7) — verify 동봉 offer 는 읽기 확인이 ok 여야 실행 버튼이 나온다 (위험도 무관)
+      needsVerify,
+      verifyOk: !needsVerify || verifyState === "ok",
+      verifyTitle: messages.ui_action_verify_title,
+      verifyLines: vr && Array.isArray(vr.display) ? vr.display.map((f) => `${f.label}: ${f.value}`) : [],
+      verifyText,
       needsAck: o.risk_level === "high",
       ackLabel: messages.ui_action_ack,
       okLabel: messages.ui_action_confirm_ok,
       cancelLabel: messages.ui_action_confirm_cancel,
-      state, statusText, terminal,
+      state, statusText, terminal, successCopy,
       // 미보고만 "결과 다시 보고" — 재실행 버튼은 없다 (unknown 은 확인 필요로 남는다)
       canResend: Boolean(p && p.unreported),
       resendLabel: messages.ui_action_resend,
@@ -214,9 +239,17 @@ export function actionOffersTree(input) {
       children.push({
         tag: "div", cls: ACTION_CLS.confirm, children: [
           { tag: "div", cls: ACTION_CLS.confirmText, text: it.confirmText },
+          // 대상 확인 블록 (T2.7) — 읽기 결과를 상담사 눈으로 확인한 뒤에만 실행 버튼이 나온다
+          ...(it.needsVerify ? [{
+            tag: "div", cls: ACTION_CLS.verify, children: [
+              { tag: "div", cls: ACTION_CLS.verifyTitle, text: it.verifyTitle },
+              ...it.verifyLines.map((t) => ({ tag: "div", cls: ACTION_CLS.verifyLine, text: t })),
+              ...(it.verifyText ? [{ tag: "div", cls: ACTION_CLS.verifyStatus, text: it.verifyText, live: true }] : []),
+            ],
+          }] : []),
           // 고위험 2단 확인 — 토글 **버튼**(aria-pressed): 포커스·Space/Enter 가 되어야 키보드 사용자도 실행할 수 있다
           ...(it.needsAck ? [{ tag: "button", type: "button", cls: ACTION_CLS.ack, text: it.ackLabel, action: "ack", offerId: it.offerId, pressed: true }] : []),
-          { tag: "button", cls: ACTION_CLS.button, type: "button", text: it.okLabel, action: "execute", offerId: it.offerId },
+          ...(it.verifyOk ? [{ tag: "button", cls: ACTION_CLS.button, type: "button", text: it.okLabel, action: "execute", offerId: it.offerId }] : []),
           { tag: "button", cls: ACTION_CLS.button, type: "button", text: it.cancelLabel, action: "cancel", offerId: it.offerId },
         ],
       });
@@ -224,6 +257,7 @@ export function actionOffersTree(input) {
       children.push({ tag: "button", cls: ACTION_CLS.button, type: "button", text: it.buttonLabel, action: "confirm", offerId: it.offerId });
     }
     if (it.statusText) children.push({ tag: "div", cls: ACTION_CLS.status, text: it.statusText, state: it.state, live: true });
+    if (it.successCopy) children.push({ tag: "div", cls: ACTION_CLS.successCopy, text: it.successCopy });
     if (it.canResend) {
       children.push({ tag: "button", cls: ACTION_CLS.resend, type: "button", text: it.resendLabel, action: "resend", requestId: it.requestId });
     }

package/vue.js

@@ -147,7 +147,12 @@ export const ActionOffersPanel = defineComponent({
       emit("result", r);
     };
     const actions = {
-      confirm: (e) => { confirming.value = e.currentTarget.dataset.offer || null; ackedOffer.value = null; },
+      confirm: (e) => {
+        const id = e.currentTarget.dataset.offer || null;
+        confirming.value = id; ackedOffer.value = null;
+        const offer = offers.value.find((o) => o.offer_id === id);
+        if (offer && offer.verify && typeof props.session.verifyAction === "function") props.session.verifyAction(offer); // T2.7
+      },
       cancel: () => { confirming.value = null; ackedOffer.value = null; },
       ack: (e) => { const id = e.currentTarget.dataset.offer; ackedOffer.value = ackedOffer.value === id ? null : id; },
       execute: (e) => execute(e.currentTarget.dataset.offer),
@@ -155,7 +160,9 @@ export const ActionOffersPanel = defineComponent({
     };
     const tree = computed(() => actionOffersTree({
       offers: offers.value, pending: pending.value, enabled: Boolean(props.agent && props.agent.actionsEnabled),
-      confirming: confirming.value, messages: props.agent ? props.agent.messages : {},
+      confirming: confirming.value,
+      verifies: props.session && typeof props.session.actionVerifies === "function" ? props.session.actionVerifies() : {},
+      messages: props.agent ? props.agent.messages : {},
     }));
     const render = (node) => {
       const p = { class: node.cls };