• 작성: 미래차 팀, 2026-08-23 · 대상 코드: orchestration-server 64065c7
• 미래차가 OC 에 요청하는 변경은 3 절(세션 모드) 하나다. 2 절은 OC 작업이 없고 "동의"만 필요하다. 1 절은 이미 동작 중인 것(참고).
• 계약 정본: 위키 MQTT_SCHEMA-FUTURE_CAR §3-2-1

미래차가 태블릿 채팅에 띄우는 문장("출발 할까요?", 각 step 의 질문)은 LLM 답변이 아니라 정해진 문장이다. OC 를 거치면 LLM 이 문장을 바꾸고, 지시문이 대화 기록에 남고, 세션당 1건 락에 우리 요청이 조용히 드롭됐다. 그래서 미래차가 orchestration/{sid}/ai/response 에 직접 발행한다(브로커 ACL 상 future-car 계정은 orchestration/# 쓰기 가능).

OC 가 할 일은 없다. 이 두 토픽은 OC 가 구독하지 않는다. 다만 계약상 OC 가 발행자인 토픽에 미래차가 같이 쓰는 것이므로 동의가 필요하다(AsyncAPI 문서·모니터링 관점). 거절하면 대안으로 ai/request 에 passthrough: true (LLM·히스토리·suggestions 생략하고 text 를 그대로 message 로)를 구현해 달라고 요청한다 — 미래차는 env 한 줄 (OC_CHAT_PUBLISH=request)로 그 경로로 돌아간다.

미래차가 직접 쓰는 메시지는 OC 의 ai_messages 히스토리에 남지 않는다. 여정 뒤 일반 채팅에서 "차가 한 말"을 맥락으로 쓰고 싶다면 OC 가 ai/response 를 구독해 assistant 턴으로 저장하는 방법이 있다 — 선택.

topics.go 에 추가:

// AiModeTopic — SUBSCRIBE orchestration/{sessionId}/ai/mode (retained, 미래차 발행)
const AiModeTopic = "orchestration/+/ai/mode"
// AiModeTopicFmt — PUBLISH(삭제용) orchestration/{sessionId}/ai/mode
const AiModeTopicFmt = "orchestration/%s/ai/mode"

세션별 (mode, expiresAt). 기존 SessionStore 에 필드를 얹어도 되지만, 미래차 여정은 세션보다 짧고 TTL 이 별개라 분리를 권한다(TimedLock 과 같은 결인 작은 맵).

type AiModeStore struct {
    mu      sync.RWMutex
    entries map[string]aiModeEntry   // sessionID → {mode, expiresAt}
}

func (s *AiModeStore) IsCar(sessionID string) bool   // mode=="car" && time.Now() < expiresAt
func (s *AiModeStore) Set(sessionID, mode string, ttl time.Duration)
func (s *AiModeStore) Clear(sessionID string)

func RegisterAiModeHandler(svc *Service, store *AiModeStore) error {
    return svc.Subscribe(AiModeTopic, 1, func(topic string, payload []byte) {
        // 빈 payload = retained 삭제 → Clear
        // {"mode":"car","ttl_sec":N}  → Set(sid, "car", N초; 0/누락이면 기본 30분, 상한 2시간)
        // {"mode":"chat"}             → Clear
        // 모르는 mode 는 무시 + 로그
    })
}

server.go 의 핸들러 등록 줄에 RegisterAiModeHandler(mqttService, aiModeStore) 추가. RegisterAiChatHandler 에 aiModeStore 인자를 넘긴다.

if aiModeStore.IsCar(sessionID) {
    // 관람객 발화: STT 만 하고 LLM 답변·suggestions 는 생략한다.
    var transcript string
    switch req.Type {
    case "voice":
        transcript = sttOnly(...)          // 기존 voice 경로에서 STT 까지만 (ChatWithAudio 의 전사 부분)
    case "text":
        transcript = req.Text
    }
    // user 턴은 저장한다(여정 뒤 일반 채팅·요약에서 맥락으로 쓰일 수 있음) — 6장 열린 질문
    _ = queries.InsertAiMessage(ctx, ...Role:"user", Transcript: transcript, Content: transcript)
    resp := AiChatResponse{OK: true, ContextID: req.ContextID, Transcript: transcript, Message: ""}
    publish(resp)
    return
}

⚠️ voice 경로 주의: 현재 STT 와 LLM 답변이 llmClient.ChatWithAudio 한 호출에 묶여 있다 (ai_chat.go voice case). car 모드에서는 전사만 필요하므로 전사만 하는 경로가 필요하다 — ChatWithAudio 에 "답변 생략" 옵션을 두거나, STT 전용 함수를 분리한다. 이게 이 변경에서 가장 큰 작업이다.

1. ai/mode 없이 태블릿 텍스트 → 지금과 동일(회귀 없음)
2. {"mode":"car"} 발행 → 태블릿 텍스트 → message:"", ai/suggestions 미발행
3. car 모드에서 미래차가 직접 쓴 ai/response 가 태블릿에 그대로 보임(OC 무관)
4. {"mode":"chat"} → 2 의 요청이 다시 LLM 답변을 받음
5. ttl_sec:5 로 car → 6초 뒤 태블릿 텍스트 → LLM 답변 받음(TTL)
6. car 모드 중 signout → retained ai/mode 가 비어 있음(MQTTX 로 재구독해 확인)
7. OC 재시작 → retained ai/mode 가 다시 들어와 모드 복원

• car 모드에서 관람객 user 턴을 히스토리에 저장할지 → 저장 (리플렉션·요약 맥락)
• 미래차가 직접 쓴 문장을 OC 가 구독해 assistant 턴으로 저장할지 → 선택(하면 여정 뒤 채팅이 "차가 한 말"을 앎)
• ttl_sec 기본값/상한 → 30분 / 2시간
• 여정 중 관람객의 일반 질문에 답이 없어도 되는가 → 연출 의도로 확인 필요 (이 스펙의 전제)