@vibexnpm/talkx 2.5.0 → 3.0.0

package/README.md

@@ -198,14 +198,13 @@ if (summary.outcome !== 'EMITTED') console.warn(summary.detail); // SKIPPED/FAIL
 
 // 3) 번역 — 특정 메시지를 목표 언어로 번역
 const translated = await client.translateWithAssistant(roomId, {
-  personaId,
   sourceMessageId: message.messageId,
-  targetLang: 'en'                    // 선택 (미지정 시 서버 정책)
+  targetLang: 'en'                    // 필수
 });
-// 결과 메시지는 일반 chatMessage 이벤트로도 수신됨 (outcome === 'EMITTED' 시 messageId 존재)
+renderTranslatedText(translated.translatedText); // 요청자 전용 응답, 방 broadcast 없음
 ```
 
-요약/번역은 동기 호출이라 LLM 처리(수 초) 후 반환되며, 생성된 어시스턴트 메시지는 일반 `chatMessage` 이벤트로도 도착합니다.
+요약/번역은 동기 호출이라 LLM 처리(수 초) 후 반환됩니다. 요약은 생성된 어시스턴트 메시지가 일반 `chatMessage` 이벤트로도 도착하고, 번역은 요청자 전용 응답으로만 반환됩니다.
 
 ---
 

package/dist/index.d.ts

@@ -236,7 +236,7 @@ export interface AssistantPersonaResponse {
 
 /**
  * 어시스턴트 도구 실행 결과 — 서버 {@code AssistantToolResult}.
- * {@link ChatClient.summarizeWithAssistant} / {@link ChatClient.translateWithAssistant} 반환.
+ * {@link ChatClient.summarizeWithAssistant} 반환.
  */
 export interface AssistantToolResult {
     /**
@@ -254,6 +254,16 @@ export interface AssistantToolResult {
     detail: string | null;
 }
 
+/** {@link ChatClient.translateWithAssistant} 반환 — 요청자 전용 온디맨드 번역 응답. */
+export interface OnDemandTranslationResponse {
+    /** 번역된 텍스트. */
+    translatedText: string;
+    /** 번역 대상 원본 메시지의 {@code messageId}. */
+    sourceMessageId: string;
+    /** 요청한 목표 언어. */
+    targetLang: string;
+}
+
 /** {@link ChatClient.summarizeWithAssistant} 옵션 — 서버 {@code SummarizeToolRequest}. */
 export interface SummarizeToolRequest {
     /** 요약을 수행할 어시스턴트 ID ({@link AssistantPersonaResponse.id}). 필수. */
@@ -266,12 +276,10 @@ export interface SummarizeToolRequest {
 
 /** {@link ChatClient.translateWithAssistant} 옵션 — 서버 {@code TranslateToolRequest}. */
 export interface TranslateToolRequest {
-    /** 번역을 수행할 어시스턴트 ID ({@link AssistantPersonaResponse.id}). 필수. */
-    personaId: string;
     /** 번역 대상 메시지의 {@code messageId}. 필수. */
     sourceMessageId: string;
-    /** 목표 언어 (예: {@code 'en'}). 미지정 시 서버 정책. */
-    targetLang?: string;
+    /** 목표 언어 (예: {@code 'en'}). 필수. */
+    targetLang: string;
 }
 
 /**
@@ -1300,8 +1308,8 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
     rateAssistantMessage(roomId: string, messageId: string, rating: number, comment?: string): Promise<void>;
     /** 어시스턴트로 대화 요약 (버튼 진입점, 동기). */
     summarizeWithAssistant(roomId: string, options: SummarizeToolRequest): Promise<AssistantToolResult>;
-    /** 어시스턴트로 특정 메시지 번역 (버튼 진입점, 동기). */
-    translateWithAssistant(roomId: string, options: TranslateToolRequest): Promise<AssistantToolResult>;
+    /** 특정 메시지 온디맨드 번역 (버튼 진입점, 동기, 요청자 전용 응답). */
+    translateWithAssistant(roomId: string, options: TranslateToolRequest): Promise<OnDemandTranslationResponse>;
     /** 방 PM 프롬프트 레이어 조회 — PM_BACKSTAGE 방 전용, 참여자 전체. 미등록 시 404. */
     getRoomPmPrompt(roomId: string): Promise<PmPromptLayerResponse>;
     /** 방 PM 프롬프트 레이어 등록/수정 (upsert, 새 버전 자동 기록) — 방 주인(OWNER) 전용. content 1~2,000자. */
@@ -1641,8 +1649,8 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     rateAssistantMessage(roomId: string, messageId: string, rating: number, comment?: string): Promise<void>;
     /** 어시스턴트로 대화 요약 (버튼 진입점, 동기). */
     summarizeWithAssistant(roomId: string, options: SummarizeToolRequest): Promise<AssistantToolResult>;
-    /** 어시스턴트로 특정 메시지 번역 (버튼 진입점, 동기). */
-    translateWithAssistant(roomId: string, options: TranslateToolRequest): Promise<AssistantToolResult>;
+    /** 특정 메시지 온디맨드 번역 (버튼 진입점, 동기, 요청자 전용 응답). */
+    translateWithAssistant(roomId: string, options: TranslateToolRequest): Promise<OnDemandTranslationResponse>;
     /** 방 PM 프롬프트 레이어 조회 — PM_BACKSTAGE 방 전용, 참여자 전체. 미등록 시 404. */
     getRoomPmPrompt(roomId: string): Promise<PmPromptLayerResponse>;
     /** 방 PM 프롬프트 레이어 등록/수정 (upsert, 새 버전 자동 기록) — 방 주인(OWNER) 전용. content 1~2,000자. */