@vibexnpm/talkx 2.5.0 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vibexnpm/talkx",
-    "version": "2.5.0",
+    "version": "3.0.0",
     "type": "module",
     "description": "TalkFlow SDK - Chat & WebRTC unified client",
     "main": "dist/talkflow-sdk.umd.js",

package/src/chat/ChatClient.js

@@ -438,40 +438,37 @@ class ChatClient extends EventEmitter {
     }
 
     /**
-     * 어시스턴트로 특정 메시지 번역 (버튼 진입점, 동기).
+     * 특정 메시지 온디맨드 번역 (버튼 진입점, 동기).
      *
-     * <p>지정한 페르소나가 {@code sourceMessageId} 메시지를 {@code targetLang} 으로 번역해
-     * 방에 어시스턴트 메시지로 broadcast 한다. 생성된 메시지는 일반 {@code chatMessage}
-     * 이벤트로도 수신된다.</p>
+     * <p>{@code sourceMessageId} 메시지(텍스트/이미지/문서)를 {@code targetLang} 으로 번역해 요청자에게만
+     * 반환한다. 이미지는 이미지 속 텍스트를, 문서(PDF/DOCX/XLSX/PPTX 등)는 파일 안의 텍스트를 서버가 추출해
+     * 번역한다. 방에 메시지를 저장하거나 {@code chatMessage} 이벤트를 broadcast 하지 않는다. 읽을 텍스트가
+     * 없거나 문서가 너무 크면 에러를 반환한다.</p>
      *
      * @param {string} roomId - 채팅방 ID
      * @param {Object} options
-     * @param {string} options.personaId - 번역을 수행할 어시스턴트 ID ({@link #getAssistants} 의 {@code id}). 필수.
-     * @param {string} options.sourceMessageId - 번역 대상 메시지의 {@code messageId}. 필수.
-     * @param {string} [options.targetLang] - 목표 언어 (예: {@code 'en'}, {@code '日本語'}). 미지정 시 서버 정책.
-     * @returns {Promise<{outcome: string, messageId: (string|null), detail: (string|null)}>}
-     *   {@code outcome}: {@code 'EMITTED'} (생성됨, {@code messageId} 존재) |
-     *   {@code 'SKIPPED'} / {@code 'FAILED'} ({@code detail} 에 사유).
+     * @param {string} options.sourceMessageId - 번역 대상 메시지의 {@code messageId} (텍스트/이미지/문서). 필수.
+     * @param {string} options.targetLang - 목표 언어 (예: {@code 'en'}, {@code '日本語'}). 필수.
+     * @returns {Promise<{translatedText: string, sourceMessageId: string, targetLang: string}>}
      *
      * @example
      * const result = await chat.translateWithAssistant(roomId, {
-     *   personaId,
      *   sourceMessageId: msg.messageId,
      *   targetLang: 'en'
      * });
      */
     async translateWithAssistant(roomId, options = {}) {
-        const { personaId, targetLang, sourceMessageId } = options;
-        if (!personaId) {
-            throw new Error('translateWithAssistant requires options.personaId');
-        }
+        const { targetLang, sourceMessageId } = options;
         if (!sourceMessageId) {
             throw new Error('translateWithAssistant requires options.sourceMessageId');
         }
+        if (!targetLang) {
+            throw new Error('translateWithAssistant requires options.targetLang');
+        }
 
         const response = await this.apiClient.post(
             `/api/v1/rooms/${roomId}/assistant/tools/translate`,
-            { personaId, targetLang, sourceMessageId }
+            { targetLang, sourceMessageId }
         );
         return this._unwrapSuccessResponse(response);
     }

package/types/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자. */