@vibexnpm/talkx 8.12.0 → 8.13.0

package/dist/index.d.ts

@@ -1339,6 +1339,66 @@ export interface ChatFile {
     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
 // ============================================================================
@@ -2455,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 동기 반환. */
@@ -2948,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 동기 반환. */