@things-factory/ai-assistant 10.1.26 → 10.1.28

package/dist-client/components/assistant-chat.js

@@ -43,7 +43,8 @@ import { buildMentionCandidates, buildCatalogCandidates, buildSlashCandidates, b
  * 뜨지 않는 것이 맞다.
  */
 import { chatDefaults } from './chat-defaults.js';
-import { isDifferentConversation, resolveConversation } from './assistant-mode.js';
+import { isDifferentConversation, resolveConversation, pickInitialMode } from './assistant-mode.js';
+import { parseProposalOutcomeLine } from './proposal-outcome-line.js';
 import { availableTriggers } from './chat-triggers.js';
 function formatFileSize(bytes) {
     if (!bytes || bytes < 1024)
@@ -91,9 +92,75 @@ const ASSISTANT_CHAT_MUTATION = gql `
       offeredTools
       proposals
       groundingWarnings
+      historyFolded
+    }
+  }
+`;
+/*
+ * What this conversation offers on screen, in this person's language.
+ *
+ * The `/` sentences, the `@` catalog and the two notices are declared with the mode on the server
+ * (ADR-0061 decision 7) and translated there, so the panel and the door cannot describe different
+ * conversations, and a host does not carry a second copy of the words.
+ */
+/*
+ * 이 화면에 설 수 있는 대화들 — ADR-0072 A17 ①.
+ *
+ * 화면은 자기가 무엇을 보여 주는지만 말하고, 그 위에 어느 대화가 서는지는 앱 서버가 답한다.
+ */
+const ASSISTANT_MODES_QUERY = gql `
+  query AssistantModes($subject: String!) {
+    assistantModes(subject: $subject) {
+      kind
+      label
+      isDefault
+    }
+  }
+`;
+const ASSISTANT_MODE_QUERY = gql `
+  query AssistantMode($kind: String!) {
+    assistantMode(kind: $kind) {
+      kind
+      slashTemplates {
+        name
+        description
+        template
+      }
+      catalogEntries
+      proposalChoices
+      placeholder
+      footerNotice
+      stagedNotice
     }
   }
 `;
+/*
+ * 방에 말하는 문 — 사람에게 하는 말이고 모델을 부르지 않는다(ADR-0070 A15).
+ *
+ * 이 문이 서기 전에는 화면에서 나가는 모든 말이 어시스턴트를 향했다. 옆 사람에게 한마디 하려면
+ * 어시스턴트가 반드시 대답했고, 그 대답이 다시 대화에 남았다.
+ */
+/*
+ * `@` 가 고를 수 있는 사람들 — 이 도메인의 사용자.
+ *
+ * 호스트가 `userProvider` 를 주지 않으면 여기서 직접 묻는다. 주지 않는 것이 기본이었고, 그래서 앱 셋
+ * 어디에서도 `@이름` 을 **고를 수가 없었다** — 멘션이 사람을 불러들이는 기전(ADR-0071 결정 1)을 세워
+ * 놓고 부르는 자리가 없는 상태였다. 이 문은 `ai-assistant` 의 것이고 대화창이 그 문의 화면이다.
+ */
+const DOMAIN_USERS_FOR_MENTION_QUERY = gql `
+  query DomainUsersForMention($query: String) {
+    domainUsersForMention(query: $query) {
+      id
+      name
+      email
+    }
+  }
+`;
+const SAY_TO_ROOM_MUTATION = gql `
+  mutation SayToRoom($sessionId: String!, $content: String!) {
+    sayToRoom(sessionId: $sessionId, content: $content)
+  }
+`;
 const CHAT_MESSAGES_QUERY = gql `
   query ChatMessages($sessionId: String!, $limit: Int, $offset: Int) {
     chatMessages(sessionId: $sessionId, limit: $limit, offset: $offset) {
@@ -104,6 +171,7 @@ const CHAT_MESSAGES_QUERY = gql `
       toolUsagesJson
       groundingWarningsJson
       createdAt
+      redacted
       creator {
         name
         email
@@ -123,6 +191,7 @@ const CHAT_MESSAGE_SUBSCRIPTION = gql `
       toolUsagesJson
       groundingWarningsJson
       createdAt
+      redacted
       creator {
         name
         email
@@ -186,22 +255,6 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
         this.selectedRefids = [];
         /** 코어 보드 편집 도구 사용 여부. 기본 true. 보드를 고칠 이유가 없는 면에서 false. */
         this.boardTools = true;
-        /*
-         * Which server operation this surface talks to. A closed set of two, named after the operations
-         * themselves so a reader can grep either way.
-         *
-         *   boardAIChat    board authoring — lives in @things-factory/board-ai, carries the board model,
-         *                  returns patches and scene actions
-         *   assistantChat  a surface with no document of its own — lives here, runs registered tools only
-         *
-         * Default stays `boardAIChat`: every existing consumer is a board surface, and a default that
-         * changed under them would move their conversation to a door with no board tools behind it.
-         *
-         * A host that has no board must pass `assistantChat` **and** `systemPrompt`. Until it does, the
-         * chat calls a mutation that lives in a package it may not even load — which is how
-         * operato-figure got `Cannot query field "boardAIChat" on type "Mutation"` (2026-09-11).
-         */
-        this.chatEndpoint = 'boardAIChat';
         /**
          * 라이브 상태를 다루는 대화면인가 — true 면 **첫 턴에 도구 호출을 강제**한다.
          *
@@ -209,7 +262,6 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
          * 그건 도구를 부르지 않고 답한 경우이므로, 조회를 먼저 하게 만들어 원천을 막는다.
          */
         this.requireGroundingTools = false;
-        this.placeholder = '자연어로 명령하세요 (Shift+Enter 줄바꿈, Enter 전송)';
         this.lines = [];
         this.input = '';
         /** 되돌려진 patch id 들 — 한 번 revert 한 patch 는 버튼 비활성 */
@@ -260,6 +312,10 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
          *  textarea 에는 @username 만 보이지만 server 한테는 정확한 userId 전달.
          *  send 시 mutation input.userMentions 로 함께 전송. */
         this.pickedUserMentions = new Map();
+        this.modeViewToken = 0;
+        /** 이 subject 에 설 수 있는 대화들 — 기본이 먼저. 하나뿐이면 고르개를 그리지 않는다. */
+        this.modeChoices = [];
+        this.modeChoicesToken = 0;
         /*
          * The `@` and `/` candidates, built once per mode.
          *
@@ -318,6 +374,17 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
             this.foldNoticeDismissed = true;
             this.dispatchEvent(new CustomEvent('assistant-start-new-session', { bubbles: true, composed: true }));
         };
+        /**
+         * 실행은 호스트가 한다 — 이 컴포넌트는 도메인(트윈 명령 채널)을 모른다.
+         * 확인 대화·명령 전송·결과 기록은 호스트의 몫이고, 여기서는 중복 클릭만 막는다.
+         */
+        /**
+         * 누른 시각 — 「보내는 중」 옆의 경과 시간용.
+         *
+         * 시간으로 실패를 판정하지 않는다(ADR-0070 A12-a 결정 ②). 아는 사실은 「아직 답을 받지 못했다」
+         * 하나이고, 시간이 지났다고 실패로 바꾸면 그것이 지어낸 원인이다.
+         */
+        this.proposalSentAt = new Map();
     }
     static { OxAssistantChat_1 = this; }
     async onAttachFiles(files) {
@@ -422,10 +489,11 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
           The screen still shows nothing either way. There is no sentence to show, and inventing one is
           what this whole correction removed.
         */
-        if (!this.conversation.stagedNoticeKey && !OxAssistantChat_1.warnedMissingStagedNotice) {
+        if (!this.conversation.stagedNotice && !OxAssistantChat_1.warnedMissingStagedNotice) {
             OxAssistantChat_1.warnedMissingStagedNotice = true;
-            console.warn('[assistant-chat] a host reported a proposal staged but registered no `stagedNoticeKey`, ' +
-                'so the card can say nothing. Pass one to `registerChatDefaults` from the host.');
+            console.warn('[assistant-chat] a host reported a proposal staged but declared no staged notice, so the card can ' +
+                'say nothing. Declare `stagedNoticeKey` on the mode (the server translates it), or pass one to ' +
+                '`registerChatDefaults` from a host with no mode.');
         }
         this.stagedProposals = new Set(this.stagedProposals).add(this.proposalKey(proposal));
     }
@@ -437,6 +505,9 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
     get _myEmail() {
         return auth.credential?.email;
     }
+    get _myUserId() {
+        return auth.credential?.id;
+    }
     /*
      * ── What this conversation is, resolved ──────────────────────────────────────────────
      *
@@ -446,11 +517,100 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
      */
     get conversation() {
         return resolveConversation(this.mode, {
-            systemPrompt: this.systemPrompt,
-            toolCategories: this.toolCategories,
             hostContext: this.hostContext,
-            chatEndpoint: this.chatEndpoint
-        }, chatDefaults);
+            chatEndpoint: this.chatEndpoint,
+            /* A host with no mode still registers its wording as keys; it is translated here. */
+            footerNotice: chatDefaults.footerNoticeKey ? i18next.t(chatDefaults.footerNoticeKey) : undefined,
+            stagedNotice: chatDefaults.stagedNoticeKey ? i18next.t(chatDefaults.stagedNoticeKey) : undefined
+        }, chatDefaults, this.modeView);
+    }
+    /**
+     * 이 화면에 설 수 있는 대화를 서버에 묻는다.
+     *
+     * 화면이 종류 목록을 손에 들고 있으면, 대화를 하나 더 세운 날 그 화면만 모른 채로 남는다. 목록은
+     * 앱 서버의 선언에서 나온다(ADR-0072 A17 ①).
+     */
+    async loadModeChoices() {
+        const subject = this.subject;
+        if (!subject) {
+            this.modeChoices = [];
+            return;
+        }
+        const token = ++this.modeChoicesToken;
+        try {
+            const result = await client.query({
+                query: ASSISTANT_MODES_QUERY,
+                variables: { subject },
+                fetchPolicy: 'cache-first'
+            });
+            if (token !== this.modeChoicesToken)
+                return;
+            this.modeChoices = result.data?.assistantModes ?? [];
+        }
+        catch {
+            /*
+             * 못 물어봤다고 화면을 막지 않는다 — host 가 준 대화는 그대로 산다. 고르개만 안 나온다.
+             * 여기서 오류 문구를 띄우면 고를 것이 하나뿐인 화면에서도 빨간 줄이 뜬다.
+             */
+            if (token !== this.modeChoicesToken)
+                return;
+            this.modeChoices = [];
+        }
+    }
+    /**
+     * 사람이 다른 대화를 골랐다.
+     *
+     * 고른 것은 **이 subject 종류에 대해** 기억한다 — 보드를 열 때마다 저작 대화로 돌아가면, 현장을
+     * 물으려던 사람은 화면을 열 때마다 같은 손질을 다시 해야 한다. 기억은 이 브라우저에만 남는다
+     * (서버에 칸을 만들지 않는다 — A17 ①). 세션 자체는 자기가 어느 대화였는지 이미 안다.
+     */
+    onModePick(kind) {
+        if (!this.mode || kind === this.mode.kind)
+            return;
+        this.mode = { ...this.mode, kind };
+        try {
+            if (this.subject)
+                localStorage.setItem(`assistant-mode:${this.subject}`, kind);
+        }
+        catch {
+            /* 저장이 막힌 브라우저에서도 고르기 자체는 된다 — 다음에 다시 고르면 될 뿐이다. */
+        }
+        this.dispatchEvent(new CustomEvent('assistant-mode-change', { detail: { kind, subject: this.subject }, bubbles: true, composed: true }));
+    }
+    /** 이 subject 에서 지난번에 고른 대화 — 없으면 undefined. */
+    rememberedMode(subject) {
+        try {
+            return localStorage.getItem(`assistant-mode:${subject}`) ?? undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async loadModeView() {
+        const mode = this.mode;
+        if (!mode?.kind) {
+            this.modeView = undefined;
+            return;
+        }
+        const token = ++this.modeViewToken;
+        try {
+            const result = await client.query({ query: ASSISTANT_MODE_QUERY, variables: { kind: mode.kind }, fetchPolicy: 'cache-first' });
+            /* A late answer for a conversation the person has already left is dropped. */
+            if (token !== this.modeViewToken)
+                return;
+            this.modeView = result.data?.assistantMode;
+            this.rebuildMentionCaches();
+        }
+        catch (error) {
+            if (token !== this.modeViewToken)
+                return;
+            this.modeView = undefined;
+            /*
+             * A kind this server does not have is a mismatched deployment, and the person should read it
+             * rather than watch an empty `/` list.
+             */
+            this.errorMessage = error instanceof Error ? error.message : String(error);
+        }
     }
     rebuildMentionCaches() {
         this.cachedCatalogCandidates = buildCatalogCandidates(this.conversation.catalogEntries);
@@ -484,6 +644,52 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
     }
 
     /* ── C4 Roster (participants + presence) ───────────── */
+    /* 이 대화의 주어 — 같은 화면 위에 두 대화가 설 때만 나온다(ADR-0072 A17 ①).
+       지금 대화가 제목 굵기로 서고, 바꿀 자리가 그 옆에 붙는다. 세션 탭과 같은 무게로 그리지 않는다
+       (UX 레인, 2026-09-18) — 한쪽은 화제를 바꾸고 한쪽은 실타래를 바꾼다. */
+    .mode-subject {
+      display: flex;
+      align-items: baseline;
+      gap: 8px;
+      padding: 6px 12px;
+      border-bottom: 1px solid var(--md-sys-color-outline-variant, #e2e8f0);
+    }
+    .mode-now {
+      /* 고른 상태의 색은 세션 탭과 같은 계열이다 — 한 패널 안에서 「골랐다」가 두 색으로 나오면 읽는
+         사람은 두 색이 서로 다른 뜻인 줄 안다.
+
+         12px 이었다가 한 단 내렸다. 도크 제목(figure 의 .scope-title 이 12.5px / 650)과 0.5px ·
+         굵기 50 차이는 눈에 닿지 않아서, 거의 같은 제목 줄이 둘 포개졌다. 도크 제목은 그 도크 전체를
+         거느리고 이 줄은 그 안 대화 하나의 성질이다 — 11px 이면 이 패널의 다른 조작부와 같은 단이고,
+         「이것이 주어다」는 색이 계속 진다(UX 레인, 2026-09-18). */
+      color: var(--primary-color, #007f87);
+      font-size: 11px;
+      font-weight: 600;
+    }
+    .mode-switch,
+    .mode-select {
+      appearance: none;
+      background: transparent;
+      border: 1px solid var(--md-sys-color-outline-variant, #cbd5e1);
+      border-radius: 999px;
+      color: var(--md-sys-color-on-surface-variant, #475569);
+      cursor: pointer;
+      font: inherit;
+      font-size: 11px;
+      padding: 2px 10px;
+      white-space: nowrap;
+    }
+    .mode-switch:hover:not([disabled]) {
+      background: color-mix(in srgb, var(--primary-color, #007f87) 7%, transparent);
+      color: var(--primary-color, #007f87);
+    }
+    /* 답하는 동안에도 「내가 지금 무엇에 대해 말하고 있나」는 또렷해야 한다 — 흐려지는 것은 바꿀
+       자리뿐이다. 지금 대화까지 흐리면 그 한 줄이 가장 안 보인다. */
+    .mode-subject [disabled] {
+      cursor: default;
+      opacity: 0.5;
+    }
+
     .roster {
       display: flex;
       align-items: center;
@@ -1034,6 +1240,29 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
       overflow: visible;
     }
 
+    /* 값이 안 온 줄 — ADR-0073 판정 1.
+       말풍선의 자리와 「AI」 딱지는 지킨다 — 그 줄은 어시스턴트의 답이 맞고, 읽는 사람이 못 지나간
+       것이다. 점선 테두리와 흐린 색이 「이것은 그가 쓴 문장이 아니다」를 말한다.
+
+       기울임은 쓰지 않는다. 이 앱의 글꼴 묶음에 한글 이탤릭 자소가 없어 브라우저가 합성으로 기울이고,
+       획 균형이 무너져 작은 글자가 먼저 안 읽힌다. UX 레인이 :4000 에서 재 보았다 — 「권한」의 진행
+       폭이 normal·italic 둘 다 27.6875px 로 같다(2026-09-18). */
+    .msg.redacted {
+      background: transparent;
+      border: 1px dashed var(--md-sys-color-outline-variant, #cbd5e1);
+      color: var(--md-sys-color-outline, #94a3b8);
+    }
+    .redacted-body {
+      align-items: center;
+      display: flex;
+      gap: 6px;
+    }
+    .redacted-body md-icon {
+      /* md-icon 은 자기 크기를 이 변수로 잡는다 — width/height 만 주면 아무 일도 안 일어난다. */
+      --md-icon-size: 14px;
+      font-size: 14px;
+    }
+
     .msg.pending {
       opacity: 0.5;
     }
@@ -1894,6 +2123,20 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
       cursor: not-allowed;
     }
 
+    /* 보내기 전에 보이는 초대 안내 — 누르기 전에 알아야 하는 사실이다. */
+    .invite-notice {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      margin: 0 2px 4px;
+      color: var(--md-sys-color-on-surface-variant, #475569);
+      font-size: 11.5px;
+    }
+
+    .invite-notice md-icon {
+      --md-icon-size: 15px;
+    }
+
     /* ── Send button — ChatGPT 스타일 원형 ↑ (.input-row 안의 button 만) ─── */
     .input-row > button {
       width: 32px;
@@ -1915,6 +2158,15 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
       align-self: flex-end;
       margin-bottom: 2px;
     }
+    /*
+      방에 말하는 자리는 **두 번째 행동**이다 — 이 화면의 첫 행동은 어시스턴트에게 묻는 것이다.
+      같은 무게로 두면 무엇이 기본인지 화면이 말하지 않게 된다(ADR-0070 A15 의 자리 둘).
+    */
+    .input-row > button.say-to-room {
+      background: var(--md-sys-color-surface-container-highest, #e2e8f0);
+      color: var(--md-sys-color-on-surface-variant, #475569);
+    }
+
     .input-row > button:disabled {
       background: var(--md-sys-color-surface-container-highest, #e2e8f0);
       color: var(--md-sys-color-outline, #94a3b8);
@@ -1949,6 +2201,25 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
         // 첫 마운트 시 sessionId 가 이미 set 돼있어도 loadHistory 는 첫 render 후 updated()
         // 가 처리 — 단일 진입점으로 일관 (이전엔 connectedCallback 과 updated 양쪽이 호출 →
         // 동시 fetch race 발생).
+        /* 모드가 이미 붙어 있으면 무엇을 주는지 먼저 묻는다 — 바뀔 때는 updated 가 다시 묻는다. */
+        if (this.mode?.kind)
+            this.loadModeView();
+        if (this.subject)
+            this.onSubjectChanged();
+    }
+    /**
+     * 화면이 보여 주는 것의 종류가 바뀌었다 — 설 수 있는 대화를 다시 묻고, 지난번 고른 것을 되살린다.
+     *
+     * 되살리는 것은 **고른 대화**이지 세션이 아니다. 세션은 자기가 어느 대화였는지 이미 알고, 다른
+     * 대화로 가면 그때 새로 난다(ADR-0072 A17 ①).
+     */
+    async onSubjectChanged() {
+        await this.loadModeChoices();
+        if (this.modeChoices.length < 2 || !this.subject || !this.mode)
+            return;
+        const kind = pickInitialMode(this.mode.kind, this.modeChoices, this.rememberedMode(this.subject));
+        if (kind && kind !== this.mode.kind)
+            this.mode = { ...this.mode, kind };
     }
     updated(changed) {
         /*
@@ -1974,8 +2245,14 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
          * The host still owns `sessionId`; it hears `assistant-mode-changed` and decides whether
          * this subject gets a stored session of its own.
          */
+        /* 보는 것의 종류가 바뀌면 설 수 있는 대화도 달라진다 — 보드에서 현장으로 넘어간 자리. */
+        if (changed.has('subject'))
+            this.onSubjectChanged();
         if (changed.has('mode') && isDifferentConversation(changed.get('mode'), this.mode)) {
+            /* What this conversation offers is the new mode's; ask before drawing the panel again. */
+            this.modeView = undefined;
             this.rebuildMentionCaches();
+            this.loadModeView();
             this.lines = [];
             this.pickedMentions.clear();
             this.pickedUserMentions.clear();
@@ -2024,6 +2301,10 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
     disconnectedCallback() {
         this._stopPresence();
         this._stopMessageSubscription();
+        if (this.elapsedTimer) {
+            clearInterval(this.elapsedTimer);
+            this.elapsedTimer = undefined;
+        }
         super.disconnectedCallback();
     }
     // ── C4 presence/roster ─────────────────────────────────────────────────────
@@ -2160,6 +2441,7 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
       ${this.toastMessage
             ? html `<div class="toast show">${this.toastMessage}</div>`
             : nothing}
+      ${this.renderModeSubject()}
       ${this.renderSessionTabs()}
       ${this.renderRoster()}
       <div class="messages" @click=${this.onBubbleClick}>
@@ -2177,8 +2459,12 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
                 const prevSameSender = !!prev && prev.role === 'user' && prev.senderEmail === line.senderEmail;
                 const showSenderLabel = isOther && !prevSameSender;
                 const content = (line.content ?? '').trim();
-                const isMarkdown = line.role !== 'system' && content.length > 0;
-                const showActions = line.role !== 'system' && !line.pending && content.length > 0;
+                /*
+                 * 가려진 줄은 어시스턴트의 말이 아니다 — 마크다운으로 그리지 않고, 복사·재실행 같은 손잡이도
+                 * 달지 않는다(ADR-0073 판정 1). 그 손잡이들은 있지도 않은 답을 다룬다.
+                 */
+                const isMarkdown = line.role !== 'system' && content.length > 0 && !line.redacted;
+                const showActions = line.role !== 'system' && !line.pending && content.length > 0 && !line.redacted;
                 return html `
             ${showLabel
                     ? html `<div class="msg-label">${i18next.t('ai-assistant.label.ai')}</div>`
@@ -2189,19 +2475,21 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
               <div
                 class="msg ${line.role} ${isOther ? 'other' : ''} ${line.pending ? 'pending' : ''} ${line.systemOpen
                     ? 'open'
-                    : ''}">
+                    : ''} ${line.redacted ? 'redacted' : ''}">
                 ${line.pending
                     ? html `<span class="typing-dots"><span></span><span></span><span></span></span>`
-                    : isMarkdown
-                        ? html `<div class="md-body">${unsafeHTML(renderMarkdown(content))}</div>`
-                        : line.role === 'system'
-                            ? html `<span
+                    : line.redacted
+                        ? html `<div class="redacted-body"><md-icon>lock</md-icon><span>${content}</span></div>`
+                        : isMarkdown
+                            ? html `<div class="md-body">${unsafeHTML(renderMarkdown(content))}</div>`
+                            : line.role === 'system'
+                                ? html `<span
                           class="sys-text"
                           title=${i18next.t('ai-assistant.text.toggle-system-note', { defaultValue: 'click to expand' })}
                           @click=${() => this.toggleSystemNote(idx)}
                           >${content}</span
                         >`
-                            : content}
+                                : content}
                 ${line.attachments && line.attachments.length > 0
                     ? html `
                       <div class="msg-attachments">
@@ -2348,6 +2636,7 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
               </div>
             `
             : nothing}
+        ${this.renderInviteNotice()}
         <div class="input-row">
           <div class="textarea-wrap">
             <textarea
@@ -2361,7 +2650,9 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
         }}
               ?disabled=${this.busy}
               rows="1"
-              placeholder=${this.placeholder ?? i18next.t('ai-assistant.text.input-placeholder')}></textarea>
+              placeholder=${this.conversation.placeholder ??
+            this.placeholder ??
+            i18next.t('ai-assistant.text.input-placeholder')}></textarea>
             ${this.mentionOpen
             ? html `
                   <ox-mention-popup
@@ -2381,6 +2672,27 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
                 `
             : nothing}
           </div>
+          ${ /*
+            두 자리다 — 어시스턴트에게 묻는 자리와 **방에 말하는 자리**. 누른 자리가 그 말의 대상을
+            정하고, 서버는 어느 문이 불렸는지로 그 사실을 저장한다(ADR-0070 A15 결정 ①).
+
+            **방에 사람이 있을 때만 보인다.** 혼자 쓰는 대화에서 「방에 말하기」는 아무에게도 하지 않는
+            말이고, 누를 일이 없는 단추는 무엇이 기본인지 흐린다. 조건은 참여자 목록과 같다(둘 이상) —
+            둘째 사람은 멘션으로 들어오고, 그 순간 이 자리도 함께 선다.
+          */''}
+          ${this.sessionId && this.participants.length >= 2
+            ? html `
+                <button
+                  class="say-to-room"
+                  ?disabled=${this.busy || !this.input.trim()}
+                  @click=${() => this.sayToRoom()}
+                  title=${i18next.t('ai-assistant.text.say-to-room-tooltip', {
+                defaultValue: 'say this to the people here — the assistant does not answer'
+            })}>
+                  <md-icon>forum</md-icon>
+                </button>
+              `
+            : nothing}
           <button
             ?disabled=${this.busy || (!this.input.trim() && this.attachments.length === 0)}
             @click=${this.send}
@@ -2393,6 +2705,82 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
       </div>
     `;
     }
+    /**
+     * 방에 말한다 — 어시스턴트는 답하지 않는다.
+     *
+     * 저장되는 대화가 있을 때만 할 수 있다. 세션이 없는 즉석 질문에는 「방」이 없다 — 그 자리에서
+     * 한 말은 누구에게도 남지 않는다.
+     */
+    async sayToRoom() {
+        const body = this.input.trim();
+        if (!body || this.busy)
+            return;
+        if (!this.sessionId) {
+            /* 말할 방이 없다는 사실을 말한다 — 조용히 버리면 사람은 말했다고 믿는다. */
+            this.errorMessage = i18next.t('ai-assistant.text.no-room-yet', {
+                defaultValue: 'this conversation is not saved yet, so there is nobody else in it to talk to'
+            });
+            return;
+        }
+        const localId = `local-${++this._localSeq}-r`;
+        this.lines = [...this.lines, { role: 'user', content: body, _localId: localId, senderEmail: this._myEmail }];
+        this.input = '';
+        this.busy = true;
+        try {
+            const result = await client.mutate({
+                mutation: SAY_TO_ROOM_MUTATION,
+                variables: { sessionId: this.sessionId, content: body }
+            });
+            /* 방송 에코와 겹치지 않게 서버 id 로 맞춘다 — 보낸 말이 두 줄로 보이지 않게. */
+            this._reconcileSentLine(localId, result.data?.sayToRoom ?? undefined, {});
+        }
+        catch (error) {
+            this.lines = this.lines.filter(line => line._localId !== localId);
+            this.input = body;
+            this.errorMessage = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            this.busy = false;
+        }
+    }
+    /**
+     * 보내기 전에 말한다 — 「이 사람은 이 대화에 들어옵니다」(ADR-0071 결정 1 ④).
+     *
+     * 멘션은 사람을 불러들인다. 누른 뒤에 알면 이미 들어와 있고, 협의의 공개 범위는 되돌리기 어려운
+     * 종류의 일이다. 그래서 **아직 보내지 않은 상태에서** 누가 들어오게 되는지 보인다.
+     *
+     * 초대할 수 없는 자리(보기 권한 · 아직 참여자가 아님)라면 그 사실을 말한다 — 눌렀는데 아무 일도
+     * 일어나지 않는 것이 가장 나쁘다.
+     */
+    renderInviteNotice() {
+        if (!this.sessionId)
+            return nothing;
+        const here = new Set(this.participants.map(p => p.user?.id).filter(Boolean));
+        const incoming = [...this.pickedUserMentions.entries()]
+            .filter(([token, userId]) => this.input.includes(`@${token}`) && !here.has(userId))
+            .map(([token]) => token);
+        if (incoming.length === 0)
+            return nothing;
+        const myRole = this.participants.find(p => p.user?.id && p.user.id === this._myUserId)?.role;
+        const mayInvite = myRole === 'owner' || myRole === 'member';
+        const names = incoming.map(token => `@${token}`).join(', ');
+        return html `
+      <div class="invite-notice">
+        <md-icon>person_add</md-icon>
+        <span>
+          ${mayInvite
+            ? i18next.t('ai-assistant.text.will-be-invited', {
+                names,
+                defaultValue: '{names} will join this conversation when you send'
+            })
+            : i18next.t('ai-assistant.text.cannot-invite', {
+                names,
+                defaultValue: '{names} will not join — only the people already in this conversation can bring someone in'
+            })}
+        </span>
+      </div>
+    `;
+    }
     onKeyDown(e) {
         // Mention popup 활성 시 — 화살표/Enter/Tab/Esc 가로채서 popup 네비게이션
         if (this.mentionOpen) {
@@ -2512,14 +2900,32 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
         // 매칭된 후보 outline 만 갱신 — 카메라/선택 변경은 commit (Enter/click) 시점에만.
         this.highlightMatchedCandidates();
     }
+    /**
+     * 호스트가 목록을 주지 않을 때 이 도메인의 사용자를 직접 묻는다.
+     *
+     * 실패는 빈 목록이다 — 멘션을 못 고르는 것이지 대화가 막힐 일은 아니다.
+     */
+    async fetchDomainUsers(query) {
+        try {
+            const result = await client.query({
+                query: DOMAIN_USERS_FOR_MENTION_QUERY,
+                variables: { query },
+                fetchPolicy: 'network-only'
+            });
+            return result.data?.domainUsersForMention ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
     /** `@` query 에 대한 userProvider 비동기 호출 — 응답 도착 시 popup 결과 갱신.
      *  race 방지: token 으로 최신 호출 식별 (늦게 도착한 응답 무시). */
     async refreshUserCandidatesAsync(query, hashPos) {
-        if (!this.userProvider)
-            return;
         const token = ++this.userFetchToken;
         try {
-            const users = await Promise.resolve(this.userProvider(query));
+            const users = this.userProvider
+                ? await Promise.resolve(this.userProvider(query))
+                : await this.fetchDomainUsers(query);
             if (token !== this.userFetchToken)
                 return; // 더 최신 호출이 있음
             // popup 이 닫혔거나 trigger / hashPos 가 바뀌면 무시
@@ -2695,6 +3101,59 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
     ]; }
     /** 보드의 세션 탭 — 다중 세션 활성화 시 패널 상단. host 가 sessions 비워두면 표시 X.
      *  레이블은 session.name 우선, 없으면 fallback "세션 N". */
+    /**
+     * 이 대화의 **주어** — 같은 화면 위에 두 대화가 설 때만 나온다(ADR-0072 A17 ①).
+     *
+     * 하나뿐이면 아무것도 그리지 않는다. 고를 것이 없는 고르개는 자리만 차지하고, 사람에게 「무언가
+     * 고를 것이 있다」는 잘못된 신호를 준다.
+     *
+     * ── 왜 탭 줄이 아닌가 (UX 레인, 2026-09-18) ───────────────────────────────
+     * 처음에는 칩 줄에 `role="tablist"` 를 달았다. 바로 아래가 세션 탭이고 그쪽도 tablist 라서, 화면
+     * 낭독기로 들으면 「탭 목록, 대화」 다음에 「탭 목록, Conversation history」 가 이어졌다 — 고르는
+     * 축이 둘인데 둘 다 「탭」이라고 말한다. 게다가 ARIA 탭은 좌우 화살표 이동과 `tabpanel` 이 함께
+     * 있어야 성립하고, 둘 다 없으면 낭독기는 「2 중 1번째 탭」이라 말하고 화살표는 아무 일도 안 한다.
+     *
+     * 무게도 다르다. 세션은 「어느 지난 대화냐」이고 모드는 「이 대화가 무엇에 대한 것이냐」이다. 같은
+     * 무게로 그리면 어느 쪽이 화제를 바꾸고 어느 쪽이 실타래를 바꾸는지 구별되지 않는다. 그래서 지금
+     * 대화가 제목 굵기로 서고, 바꿀 자리는 그 옆에 붙는다.
+     *
+     * ── 왜 도크 제목 줄로 안 올리나 (UX 레인 판정, 2026-09-18) ────────────────
+     * 도크 제목은 「지금 어디에 있나」(이 도형 · 이 현장 · 이 스테이션 화면)이고 이 줄은 「이 대화가
+     * 무엇에 대한 것이냐」이다. 대화의 주어는 대화 안에 있다. 그리고 세 도크가 각자 그리면 세 벌이 되고
+     * 그 세 벌은 갈린다 — `modeChoices` 를 아는 것도 여기다. 올리면 목록과 고른 것이 세 자리로 나갔다
+     * 돌아온다.
+     */
+    renderModeSubject() {
+        if (this.modeChoices.length < 2)
+            return nothing;
+        const current = this.modeChoices.find(choice => choice.kind === this.mode?.kind);
+        const others = this.modeChoices.filter(choice => choice.kind !== this.mode?.kind);
+        return html `
+      <div class="mode-subject">
+        <span class="mode-now">${current?.label ?? this.mode?.kind ?? ''}</span>
+        ${others.length === 1
+            ? html `
+              <button
+                class="mode-switch"
+                title=${i18next.t('ai-assistant.text.switch-conversation', { name: others[0].label })}
+                aria-label=${i18next.t('ai-assistant.text.switch-conversation', { name: others[0].label })}
+                ?disabled=${this.busy}
+                @click=${() => this.onModePick(others[0].kind)}>
+                ${others[0].label}
+              </button>
+            `
+            : html `
+              <select
+                class="mode-select"
+                aria-label=${i18next.t('ai-assistant.label.conversation')}
+                ?disabled=${this.busy}
+                @change=${(event) => this.onModePick(event.target.value)}>
+                ${this.modeChoices.map(choice => html `<option value=${choice.kind} ?selected=${choice.kind === this.mode?.kind}>${choice.label}</option>`)}
+              </select>
+            `}
+      </div>
+    `;
+    }
     renderSessionTabs() {
         if (!this.sessions || this.sessions.length === 0)
             return nothing;
@@ -2780,8 +3239,8 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
           <span class="badge">${i18next.t('ai-assistant.label.korean-supported')}</span>
           <span class="badge">${i18next.t('ai-assistant.label.multi-command')}</span>
           <span class="badge">${i18next.t('ai-assistant.label.review-able')}</span>
-          ${this.conversation.footerNoticeKey
-            ? html `<br />${i18next.t(this.conversation.footerNoticeKey)}`
+          ${this.conversation.footerNotice
+            ? html `<br />${this.conversation.footerNotice}`
             : ''}
         </div>
       </div>
@@ -2942,7 +3401,8 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
                 class="run"
                 ?disabled=${sent}
                 @click=${() => this.executeProposal(p, key)}>
-                ${sent ? i18next.t('ai-assistant.text.proposal-sent', { defaultValue: 'execution requested' })
+                ${sent
+                ? this.proposalStateText(key)
                 : i18next.t('ai-assistant.button.run-proposal', { defaultValue: 'run' })}
               </button>
               ${ /*
@@ -2951,15 +3411,15 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
                 This badge used to read "there are chips" as "the model is in the 3D viewer" and
                 say so, in a component that plant and twin also use.
               */''}
-              ${this.stagedProposals.has(key) && this.conversation.stagedNoticeKey ? html `
+              ${this.stagedProposals.has(key) && this.conversation.stagedNotice ? html `
                 <span class="staged-badge">
                   <md-icon>check_circle</md-icon>
-                  <span>${i18next.t(this.conversation.stagedNoticeKey)}</span>
+                  <span>${this.conversation.stagedNotice}</span>
                 </span>
               ` : nothing}
             </div>
             ${rawChoices.length ? html `
-              <div class="proposal-choices" role="group" aria-label="대화 선택지">
+              <div class="proposal-choices" role="group" aria-label=${i18next.t('ai-assistant.text.proposal-choices', { defaultValue: 'follow-up choices' })}>
                 ${rawChoices.map((c) => html `
                   <button
                     class="choice-chip ${c.primary ? 'primary' : ''}"
@@ -2976,6 +3436,43 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
       </div>
     `;
     }
+    /**
+     * 눌린 카드가 말하는 것 — **호스트가 한 일**이고, 아직 모르면 모른다고 말한다.
+     *
+     * 예전에는 누른 순간 「실행됨」이었다. 09-18 트윈에서 아무 일도 일어나지 않은 채 「✓ 반영했습니다」가
+     * 떴다(ADR-0070 A12-a).
+     */
+    proposalStateText(key) {
+        const outcome = this.proposalOutcomes.get(key);
+        if (!outcome) {
+            /* 답이 오기 전 — 아는 사실은 「보냈고 아직 답이 없다」뿐이다. 경과 시간을 함께 보인다. */
+            const since = this.proposalSentAt.get(key);
+            const seconds = since ? Math.max(0, Math.round((Date.now() - since) / 1000)) : 0;
+            return i18next.t('ai-assistant.text.proposal-waiting', {
+                seconds,
+                defaultValue: 'sending — {seconds}s, no answer yet'
+            });
+        }
+        const counted = typeof outcome.applied === 'number' && typeof outcome.total === 'number' && outcome.total > 0
+            ? i18next.t('ai-assistant.text.proposal-applied-count', {
+                applied: outcome.applied,
+                total: outcome.total,
+                defaultValue: ' {applied} of {total}'
+            })
+            : '';
+        /* 사유는 호스트가 준 코드 그대로다 — 문장으로 바꾸지 않는다(ADR-0042). */
+        const reason = outcome.errorCode ? ` (${outcome.errorCode})` : '';
+        const verdict = i18next.t(`ai-assistant.verdict.${outcome.verdict}`, {
+            defaultValue: outcome.verdict === 'accepted'
+                ? 'done'
+                : outcome.verdict === 'refused'
+                    ? 'refused'
+                    : outcome.verdict === 'declined'
+                        ? 'cancelled'
+                        : 'could not run'
+        });
+        return `${verdict}${counted}${reason}`;
+    }
     onChoiceClick(choice, proposal, key) {
         if (choice.action === 'save') {
             this.dispatchEvent(new CustomEvent('assistant-choice', {
@@ -3020,25 +3517,67 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
                 .map(k => `${JSON.stringify(k)}:${stable(v[k])}`)
                 .join(',')}}`;
         };
+        /*
+         * 서버가 실어 보낸 키가 정본이다 — 무엇이 같은 조치인가는 제안을 만든 쪽이 안다(ADR-0061 결정
+         * 7 뒤 정리). 예전에는 여기서 `command|instanceId|args` 로 다시 셌는데, 명령이 없는 제안(선언 ·
+         * 새 트윈 초안)은 그 셋이 모두 비어 **서로 다른 제안이 한 카드로 접혔고**, 하나를 누르면 나머지가
+         * 함께 「요청됨」이 됐다.
+         */
+        if (typeof p?.key === 'string' && p.key)
+            return p.key;
         try {
-            return `${p?.command ?? ''}|${p?.instanceId ?? ''}|${stable(p?.args)}`;
+            return `${p?.tool ?? ''}|${p?.command ?? ''}|${p?.instanceId ?? ''}|${stable(p?.args)}|${stable(p?.ops)}`;
         }
         catch {
-            return `${p?.command ?? ''}|${p?.instanceId ?? ''}`;
+            return `${p?.tool ?? ''}|${p?.command ?? ''}|${p?.instanceId ?? ''}`;
         }
     }
-    /**
-     * 실행은 호스트가 한다 — 이 컴포넌트는 도메인(트윈 명령 채널)을 모른다.
-     * 확인 대화·명령 전송·결과 기록은 호스트의 몫이고, 여기서는 중복 클릭만 막는다.
-     */
     executeProposal(p, key) {
         this.sentProposals = new Set(this.sentProposals).add(key);
+        this.proposalSentAt.set(key, Date.now());
+        this._startElapsedTicker();
         this.dispatchEvent(new CustomEvent('assistant-proposal-execute', {
-            detail: { proposal: p, sessionId: this.sessionId },
+            /*
+             * `proposalKey` 를 함께 준다 — 호스트가 `reportProposalOutcome` 으로 답할 때 쓰는 이름이다.
+             * 호스트가 자기 규칙으로 키를 다시 만들면 카드가 못 찾는 답이 생긴다(원본은 하나).
+             */
+            detail: { proposal: p, sessionId: this.sessionId, proposalKey: key },
             bubbles: true,
             composed: true
         }));
     }
+    /**
+     * 호스트가 무엇을 했는지 — 대화에 남은 `system` 행에서 읽는다(ADR-0070 A12-a 결정 ①).
+     *
+     * 카드가 자기 기억으로 상태를 들고 있으면 새로 고치는 순간 사라지고, 다른 창에서 실행한 것은
+     * 애초에 보이지 않는다. 그래서 상태의 자리는 이력이다.
+     */
+    get proposalOutcomes() {
+        const outcomes = new Map();
+        for (const line of this.lines) {
+            if (line.role !== 'system')
+                continue;
+            const parsed = parseProposalOutcomeLine(line.content ?? '');
+            if (parsed)
+                outcomes.set(parsed.key, parsed);
+        }
+        return outcomes;
+    }
+    /** 경과 시간을 보이는 동안에만 돈다 — 답이 오면 멈춘다. */
+    _startElapsedTicker() {
+        if (this.elapsedTimer)
+            return;
+        this.elapsedTimer = setInterval(() => {
+            const outcomes = this.proposalOutcomes;
+            const waiting = [...this.proposalSentAt.keys()].some(key => !outcomes.has(key));
+            if (!waiting) {
+                clearInterval(this.elapsedTimer);
+                this.elapsedTimer = undefined;
+                return;
+            }
+            this.requestUpdate();
+        }, 1000);
+    }
     /**
      * 접지 경고 — 답이 언급했지만 **근거에 없던** 대상을 알린다.
      *
@@ -3165,12 +3704,12 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
     /** 배지 문구 — 코드가 아니라 사람 말로. */
     outcomeLabel(outcome) {
         const map = {
-            ok: ['ai-assistant.text.outcome-ok', '조회'],
-            rejected: ['ai-assistant.text.outcome-rejected', '거절'],
-            queued: ['ai-assistant.text.outcome-queued', '적용 예정'],
-            proposed: ['ai-assistant.text.outcome-proposed', '제안'],
-            folded: ['ai-assistant.text.outcome-folded', '중복 접힘'],
-            error: ['ai-assistant.text.outcome-error', '오류']
+            ok: ['ai-assistant.text.outcome-ok', 'read'],
+            rejected: ['ai-assistant.text.outcome-rejected', 'rejected'],
+            queued: ['ai-assistant.text.outcome-queued', 'to apply'],
+            proposed: ['ai-assistant.text.outcome-proposed', 'proposed'],
+            folded: ['ai-assistant.text.outcome-folded', 'duplicate'],
+            error: ['ai-assistant.text.outcome-error', 'error']
         };
         const [key, fallback] = map[outcome] ?? map.ok;
         return i18next.t(key, { defaultValue: fallback });
@@ -3304,8 +3843,8 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
         this.attachments = [];
         const promptText = text || (attachmentsToSend.length > 0
             ? (attachmentsToSend[0].type.startsWith('image/')
-                ? '첨부된 이미지를 참고하여 제안해 주세요.'
-                : '첨부된 파일을 확인해 주세요.')
+                ? i18next.t('ai-assistant.text.attached-image-ask', { defaultValue: 'here is an image — go by it.' })
+                : i18next.t('ai-assistant.text.attached-file-ask', { defaultValue: 'here is a file — take a look.' }))
             : '');
         if (!this.sessionId && this.prepareSession) {
             this.busy = true;
@@ -3325,7 +3864,7 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
         let requestBase;
         try {
             const provided = this.contextProvider?.() || {};
-            requestContext = structuredClone({ systemPrompt: this.conversation.systemPrompt, hostContext: this.conversation.hostContext, ...provided });
+            requestContext = structuredClone({ hostContext: this.conversation.hostContext, ...provided });
             liveBoard = structuredClone(this.boardProvider ? this.boardProvider() : this.currentBoard);
             requestBase = { version: 1, sessionId: this.sessionId, hostContext: requestContext.hostContext,
                 modelFingerprint: assistantModelFingerprint(liveBoard) };
@@ -3407,11 +3946,9 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
                         ? buildAssistantChatInput({
                             sessionId: this.sessionId,
                             history,
-                            systemPrompt: requestContext.systemPrompt,
+                            mode: { kind: this.conversation.kind, target: this.conversation.target },
                             truncateAfterMessageId: this._truncateAfterId,
-                            hostContext: requestContext.hostContext,
-                            toolCategories: this.conversation.toolCategories,
-                            requireGroundingTools: this.requireGroundingTools
+                            hostContext: requestContext.hostContext
                         })
                         : buildChatMutationInput({
                             sessionId: this.sessionId,
@@ -3420,7 +3957,8 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
                             scopes: this.scopes,
                             truncateAfterMessageId: this._truncateAfterId,
                             hostContext: requestContext.hostContext,
-                            toolCategories: this.conversation.toolCategories,
+                            /* The board door still takes its categories from the element — it declares no mode. */
+                            toolCategories: this.toolCategories,
                             boardTools: this.boardTools,
                             requireGroundingTools: this.requireGroundingTools,
                             knownTypes: this.knownTypes,
@@ -3560,9 +4098,9 @@ __decorate([
     __metadata("design:type", Object)
 ], OxAssistantChat.prototype, "mode", void 0);
 __decorate([
-    property({ type: String, attribute: 'system-prompt' }),
+    property({ type: String }),
     __metadata("design:type", String)
-], OxAssistantChat.prototype, "systemPrompt", void 0);
+], OxAssistantChat.prototype, "subject", void 0);
 __decorate([
     property({ type: Boolean, attribute: 'require-grounding-tools' }),
     __metadata("design:type", Object)
@@ -3585,7 +4123,7 @@ __decorate([
 ], OxAssistantChat.prototype, "componentSchemas", void 0);
 __decorate([
     property({ type: String }),
-    __metadata("design:type", Object)
+    __metadata("design:type", String)
 ], OxAssistantChat.prototype, "placeholder", void 0);
 __decorate([
     state(),
@@ -3695,6 +4233,14 @@ __decorate([
     state(),
     __metadata("design:type", Object)
 ], OxAssistantChat.prototype, "mentionOverflow", void 0);
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], OxAssistantChat.prototype, "modeView", void 0);
+__decorate([
+    state(),
+    __metadata("design:type", Array)
+], OxAssistantChat.prototype, "modeChoices", void 0);
 OxAssistantChat = OxAssistantChat_1 = __decorate([
     customElement('ox-assistant-chat')
 ], OxAssistantChat);