@vibexnpm/talkx 8.11.0 → 8.13.0

package/dist/index.d.ts

@@ -1290,10 +1290,18 @@ export interface ApiEnvelope<T> {
     message?: string;
 }
 
+/**
+ * 파일 종류 — {@link ChatFile.category} 와 {@link ChatFileListParams.type} 이 같은 값을 쓴다.
+ * {@code FILE} 은 «기타» — 이미지·동영상·음성·문서가 아닌 파일(zip 등).
+ */
+export type ChatFileCategory = 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'FILE';
+
 /** {@link ChatClient.getFiles} 파라미터 — 파일함 한 페이지. */
 export interface ChatFileListParams {
     /** 방 하나로 거르기. 생략하면 내가 지금 참여 중인 방 전부. 참여하지 않은 방이면 403. */
     roomId?: string;
+    /** 종류로 거르기 — 생략하면 전부. 방·종류를 바꾸면 커서({@code lastId}·{@code lastSortValue}) 없이 처음부터 부른다. */
+    type?: ChatFileCategory;
     /** 페이지 크기(파일 수). 기본 50, max 100. */
     size?: number;
     /** 직전 응답의 {@code lastId} 그대로 — 불투명 값이라 만들어 쓰지 않는다. */
@@ -1326,11 +1334,71 @@ export interface ChatFile {
     /** 올린 시각(epoch millis). */
     uploadedAt: number;
     /** 종류 — 파일 MIME 기준, 채팅 첨부 분류와 같다. */
-    category: 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'FILE';
+    category: ChatFileCategory;
     /** 파일명({@code fileName})·다운로드 링크({@code fileUrl})·MIME({@code fileType})·크기·썸네일 — 채팅 메시지 첨부와 같은 모양. */
     file: FileMetaData;
 }
 
+/** PM 보고서 종류 — 지금은 자료조사({@code RESEARCH}) 하나. {@link PmReport.kind} 와 {@link PmReportListParams.kind} 가 같은 값. */
+export type PmReportKind = 'RESEARCH';
+
+/** {@link ChatClient.getPmReports} 파라미터 — 보고서 한 페이지. */
+export interface PmReportListParams {
+    /** 보고서 종류 — 생략하면 {@code RESEARCH}. 종류·방을 바꾸면 커서 없이 처음부터 부른다. */
+    kind?: PmReportKind;
+    /** 방 하나로 거르기. 생략하면 내가 지금 참여 중인 방 전부. 참여하지 않은 방이면 403. */
+    roomId?: string;
+    /** 페이지 크기. 기본 50, max 100. */
+    size?: number;
+    /** 직전 응답의 {@code lastId} 그대로. */
+    lastId?: string;
+    /** 직전 응답의 {@code lastSortValue} 그대로(epoch millis). */
+    lastSortValue?: number | string;
+}
+
+/**
+ * PM 보고서 목록 한 줄 — 방에 PM 이 올린 작업 결과 하나.
+ *
+ * <p>보이는 범위는 파일함과 같다 — 참여 중인 방만, 재입장 이전·보관 기간 밖·나만 삭제한 결과는 오지 않는다.</p>
+ */
+export interface PmReport {
+    /** 보고서 id — 상세({@link ChatClient.getPmReport})에 넘기는 값. 목록 key 로 쓴다. */
+    id: string;
+    /** 결과 메시지 — {@link ChatMessage.messageId} 와 같은 값. 채팅에서 그 메시지로 이동할 때 쓴다. */
+    messageId: string;
+    kind: PmReportKind;
+    /** 제목 — PM 이 작업을 맡긴 요지(120자). 비어 있으면 null. */
+    title: string | null;
+    /** 결과 앞 200자 — 마크다운 원문 그대로. */
+    preview: string;
+    /** 채팅에서 «작업 중 참고한 대화 일부가 수정/삭제되어…» 고지가 붙은 결과인가 — 상세 본문 위에 같은 문구가 붙는다. */
+    contextChanged: boolean;
+    roomId: string;
+    /** 방 이름 — 1:1 은 상대 이름. 찾지 못하면 null. */
+    roomName: string | null;
+    roomType: ChatRoomTypeValue | null;
+    /** 작업을 시킨 사람. */
+    requesterId: string | null;
+    /** 그 사람 닉네임 — 찾지 못하면(탈퇴 등) null. */
+    requesterName: string | null;
+    requesterProfileUrl: string | null;
+    /** 결과를 올린 PM 페르소나 이름 — 찾지 못하면 null. */
+    pmName: string | null;
+    /** 결과가 방에 올라온 시각(epoch millis). */
+    publishedAt: number;
+}
+
+/** PM 보고서 상세 — 목록 한 줄({@link PmReport})과 같은 칸 + 본문. */
+export interface PmReportDetail extends PmReport {
+    /**
+     * 본문(마크다운) — 결과 전문(출처 절 포함). 채팅에서 결과에 붙었던 안내도 같은 문구로 붙는다: 대화 변경 고지(본문 위,
+     * {@code contextChanged} 일 때)·이미지 분석 범위 안내(본문 끝).
+     */
+    content: string;
+    /** 본문 글자 수(코드포인트). */
+    contentLength: number;
+}
+
 // ============================================================================
 // Event payloads
 // ============================================================================
@@ -2447,6 +2515,17 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
      * 다음 페이지는 응답의 {@code lastId}·{@code lastSortValue} 를 그대로 넘긴다.
      */
     getFiles(params?: ChatFileListParams): Promise<ApiEnvelope<CursorPageResponse<ChatFile>>>;
+
+    /**
+     * PM 보고서 목록 — 내가 지금 참여 중인 방들에 PM 이 올린 작업 결과(지금은 자료조사), 최신순 커서 페이징. 반환은
+     * envelope 째({@code result.data.content}). 보이는 범위는 파일함과 같다. 다음 페이지는 응답의 {@code lastId}·
+     * {@code lastSortValue} 를 그대로 넘긴다. 끝은 {@code hasNext} 로만 판단한다 — 드물게 짧거나 빈 페이지가
+     * {@code hasNext: true} 와 함께 온다.
+     */
+    getPmReports(params?: PmReportListParams): Promise<ApiEnvelope<CursorPageResponse<PmReport>>>;
+
+    /** PM 보고서 상세 — 목록 한 줄 + 본문({@code content}). 없거나 볼 수 없으면 404. 반환은 envelope 째. */
+    getPmReport(reportId: string): Promise<ApiEnvelope<PmReportDetail>>;
     fetchLinkPreview(url: string): Promise<FetchLinkPreviewResponse | null>;
     sendMessage(roomId: string, data: SendMessageData): Promise<SendMessageResult>;
     /** Optimistic UI 버전 — 응답 전 base/예측 messageIds 동기 반환. */
@@ -2940,6 +3019,17 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
      * 다음 페이지는 응답의 {@code lastId}·{@code lastSortValue} 를 그대로 넘긴다.
      */
     getFiles(params?: ChatFileListParams): Promise<ApiEnvelope<CursorPageResponse<ChatFile>>>;
+
+    /**
+     * PM 보고서 목록 — 내가 지금 참여 중인 방들에 PM 이 올린 작업 결과(지금은 자료조사), 최신순 커서 페이징. 반환은
+     * envelope 째({@code result.data.content}). 보이는 범위는 파일함과 같다. 다음 페이지는 응답의 {@code lastId}·
+     * {@code lastSortValue} 를 그대로 넘긴다. 끝은 {@code hasNext} 로만 판단한다 — 드물게 짧거나 빈 페이지가
+     * {@code hasNext: true} 와 함께 온다.
+     */
+    getPmReports(params?: PmReportListParams): Promise<ApiEnvelope<CursorPageResponse<PmReport>>>;
+
+    /** PM 보고서 상세 — 목록 한 줄 + 본문({@code content}). 없거나 볼 수 없으면 404. 반환은 envelope 째. */
+    getPmReport(reportId: string): Promise<ApiEnvelope<PmReportDetail>>;
     fetchLinkPreview(url: string): Promise<FetchLinkPreviewResponse | null>;
     sendMessage(roomId: string, data: SendMessageData): Promise<SendMessageResult>;
     /** Optimistic UI 버전 — 응답 전 base/예측 messageIds 동기 반환. */