@obora/runtime 0.1.0

package/dist/blackboard/snapshot/snapshot-manager.d.ts

@@ -0,0 +1,253 @@
+/**
+ * @module snapshot/snapshot-manager
+ * @description 스냅샷 관리자 (파사드 패턴)
+ */
+import type { BlackboardState } from '../types';
+import type { Snapshot, SnapshotMeta, CreateSnapshotOptions, RestoreSnapshotOptions, SnapshotValidationResult } from './types';
+import type { SnapshotCreatorOptions } from './snapshot-creator';
+import type { SnapshotRestorerOptions } from './snapshot-restorer';
+import type { SnapshotDiff, SectionDiff, SectionData } from './snapshot-comparer';
+import { SnapshotRestoreError } from './snapshot-restorer';
+/**
+ * 스냅샷 목록 필터 옵션
+ */
+export interface ListSnapshotOptions {
+    /** 태그로 필터링 */
+    tags?: string[];
+    /** 세션 ID로 필터링 */
+    sessionId?: string;
+    /** 정렬 기준 */
+    sortBy?: 'date' | 'id';
+    /** 정렬 순서 */
+    order?: 'asc' | 'desc';
+}
+/**
+ * 스냅샷 관리자 설정
+ */
+export interface SnapshotManagerOptions extends SnapshotCreatorOptions, SnapshotRestorerOptions {
+    /** 자동 압축 임계값 (바이트, 기본: 10KB) */
+    autoCompressThreshold?: number;
+    /** 기본 압축 사용 */
+    defaultCompress?: boolean;
+    /** ID 생성 함수 */
+    idGenerator?: () => string;
+}
+/**
+ * 스냅샷 복원 에러
+ */
+export { SnapshotRestoreError };
+/**
+ * 스냅샷 관리자
+ * @description Blackboard 상태의 스냅샷 생성, 검증, 복원 담당
+ *
+ * 파사드 패턴으로 각 전문 클래스를 조합하여 기존 API 유지
+ *
+ * @example
+ * ```typescript
+ * const manager = new SnapshotManager();
+ *
+ * // 스냅샷 생성
+ * const snapshot = await manager.createSnapshot(board.getState(), {
+ *   description: 'Before major decision',
+ *   tags: ['checkpoint', 'decision-001'],
+ *   compress: true,
+ * });
+ *
+ * // JSON으로 저장
+ * const json = manager.toJSON(snapshot);
+ * fs.writeFileSync('snapshot.json', json);
+ *
+ * // JSON에서 로드
+ * const loaded = manager.fromJSON(fs.readFileSync('snapshot.json', 'utf-8'));
+ *
+ * // 검증
+ * const validation = await manager.validate(loaded);
+ * if (!validation.valid) {
+ *   console.error('Invalid snapshot:', validation.errors);
+ * }
+ *
+ * // 복원
+ * const restoredState = manager.restore(loaded, {
+ *   newSessionId: true,
+ * });
+ * board.replaceState(restoredState);
+ * ```
+ */
+export declare class SnapshotManager {
+    private creator;
+    private validator;
+    private restorer;
+    private serializer;
+    private comparer;
+    private storage;
+    constructor(options?: SnapshotManagerOptions);
+    /**
+     * 스냅샷 저장 (내부)
+     */
+    private storeSnapshot;
+    /**
+     * 저장된 스냅샷 목록 조회
+     * @param options - 필터 및 정렬 옵션
+     * @returns 스냅샷 목록
+     */
+    list(options?: ListSnapshotOptions): Snapshot[];
+    /**
+     * ID로 스냅샷 조회
+     * @param id - 스냅샷 ID
+     * @returns 스냅샷 또는 undefined
+     */
+    get(id: string): Snapshot | undefined;
+    /**
+     * ID로 스냅샷 삭제
+     * @param id - 스냅샷 ID
+     * @returns 삭제 성공 여부
+     */
+    delete(id: string): boolean;
+    /**
+     * 스냅샷 생성 (동기)
+     * @param state - 현재 Blackboard 상태
+     * @param options - 생성 옵션
+     * @returns 스냅샷
+     */
+    createSnapshot(state: BlackboardState, options?: CreateSnapshotOptions): Snapshot;
+    /**
+     * 메타데이터만 포함된 스냅샷 생성 (동기)
+     * @param state - 현재 상태
+     * @param description - 설명
+     * @returns 메타 전용 스냅샷
+     */
+    createMetaSnapshot(state: BlackboardState, description?: string): SnapshotMeta;
+    /**
+     * 스냅샷 검증 (동기)
+     * @param snapshot - 검증할 스냅샷
+     * @returns 검증 결과
+     */
+    validate(snapshot: Snapshot): SnapshotValidationResult;
+    /**
+     * 스냅샷 검증 (비동기)
+     * @param snapshot - 검증할 스냅샷
+     * @returns 검증 결과
+     */
+    validateAsync(snapshot: Snapshot): Promise<SnapshotValidationResult>;
+    /**
+     * 버전 호환성 체크
+     * @param formatVersion - 스냅샷 형식 버전
+     * @returns 호환 여부 및 상세 정보
+     */
+    checkVersionCompatibility(formatVersion: string): {
+        compatible: boolean;
+        current: string;
+        snapshot: string;
+        migrationRequired: boolean;
+    };
+    /**
+     * 동기 체크섬 검증 (구조적 검증만, 체크섬 제외)
+     * @description restore()에서 사용하는 동기 검증 메서드
+     * @param snapshot - 검증할 스냅샷
+     * @returns 검증 결과
+     */
+    validateSyncStructure(snapshot: Snapshot): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 스냅샷에서 상태 복원
+     * @param snapshot - 스냅샷
+     * @param options - 복원 옵션
+     * @returns 복원된 상태
+     * @throws {SnapshotRestoreError} 복원 실패 시
+     * @description
+     * **옵션 동작:**
+     * - `skipVersionCheck`: 포맷 버전 호환성 검사 건너뜀
+     * - `skipStructuralValidation`: 구조적 검증 건너뜀 (validateSync)
+     * - `resetVersion`: 상태 버전 0으로 초기화 (기본: true)
+     * - `newSessionId`: 새 세션 ID 생성 (기본: true)
+     */
+    restore(snapshot: Snapshot, options?: RestoreSnapshotOptions): BlackboardState;
+    /**
+     * 부분 복원 (특정 섹션만)
+     * @param snapshot - 스냅샷
+     * @param currentState - 현재 상태
+     * @param sections - 복원할 섹션
+     * @returns 병합된 상태
+     */
+    partialRestore(snapshot: Snapshot, currentState: BlackboardState, sections: ('state' | 'knowledge' | 'decisions')[]): BlackboardState;
+    /**
+     * 스냅샷 → JSON 문자열
+     * @param snapshot - 스냅샷
+     * @param pretty - 예쁜 출력 여부
+     * @returns JSON 문자열
+     */
+    toJSON(snapshot: Snapshot, pretty?: boolean): string;
+    /**
+     * JSON 문자열 → 스냅샷
+     * @param json - JSON 문자열
+     * @returns 스냅샷
+     * @throws {Error} JSON 파싱 실패 시 명확한 에러 메시지
+     */
+    fromJSON(json: string): Snapshot;
+    /**
+     * 스냅샷 → Uint8Array (바이너리)
+     * @param snapshot - 스냅샷
+     * @returns Uint8Array
+     */
+    toUint8Array(snapshot: Snapshot): Uint8Array;
+    /**
+     * Uint8Array → 스냅샷
+     * @param bytes - 바이트 배열
+     * @returns 스냅샷
+     * @throws {Error} 디코딩 실패 시 명확한 에러 메시지
+     */
+    fromUint8Array(bytes: Uint8Array): Snapshot;
+    /**
+     * 스냅샷 비교
+     * @param a - 첫 번째 스냅샷
+     * @param b - 두 번째 스냅샷
+     * @returns 차이점 목록
+     */
+    compare(a: Snapshot, b: Snapshot): SnapshotDiff;
+    /**
+     * 섹션 차이점 생성
+     * @param data1 - 첫 번째 데이터
+     * @param data2 - 두 번째 데이터
+     * @returns 섹션 차이점
+     */
+    createSectionDiff(data1: SectionData, data2: SectionData): SectionDiff;
+    /**
+     * 상태 데이터 추출
+     * @param snapshot - 스냅샷
+     * @returns 상태 데이터
+     */
+    extractStateData(snapshot: Snapshot): SectionData;
+    /**
+     * 지식 데이터 추출
+     * @param snapshot - 스냅샷
+     * @returns 지식 데이터
+     */
+    extractKnowledgeData(snapshot: Snapshot): SectionData;
+    /**
+     * 의사결정 데이터 추출
+     * @param snapshot - 스냅샷
+     * @returns 의사결정 데이터
+     */
+    extractDecisionsData(snapshot: Snapshot): SectionData;
+    /**
+     * 스냅샷 메타데이터만 추출
+     */
+    extractMeta(snapshot: Snapshot): SnapshotMeta;
+    /**
+     * 스냅샷 크기 계산 (숫자)
+     * @param snapshot - 스냅샷
+     * @returns 바이트 크기
+     */
+    size(snapshot: Snapshot): number;
+    /**
+     * 스냅샷 크기 계산 (상세)
+     */
+    calculateSize(snapshot: Snapshot): {
+        total: number;
+        data: number;
+        meta: number;
+        compressed: boolean;
+    };
+}

package/dist/blackboard/snapshot/snapshot-restorer.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @module snapshot/snapshot-restorer
+ * @description 스냅샷 복원 담당
+ */
+import type { BlackboardState } from '../types';
+import type { Snapshot, RestoreSnapshotOptions } from './types';
+/**
+ * 스냅샷 복원 에러
+ */
+export declare class SnapshotRestoreError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+/**
+ * 스냅샷 복원자 설정
+ */
+export interface SnapshotRestorerOptions {
+    /** ID 생성 함수 */
+    idGenerator?: () => string;
+}
+/**
+ * 스냅샷 복원자
+ * @description 스냅샷 복원 전담 클래스
+ */
+export declare class SnapshotRestorer {
+    private serializer;
+    private validator;
+    private idGenerator;
+    constructor(options?: SnapshotRestorerOptions);
+    /**
+     * 스냅샷에서 상태 복원
+     * @param snapshot - 스냅샷
+     * @param options - 복원 옵션
+     * @returns 복원된 상태
+     * @throws {SnapshotRestoreError} 복원 실패 시
+     * @description
+     * **옵션 동작:**
+     * - `skipVersionCheck`: 포맷 버전 호환성 검사 건너뜀
+     * - `skipStructuralValidation`: 구조적 검증 건너뜀 (validateSync)
+     *   - 참고: 체크섬 검증은 validate()에서 수행됨
+     * - `resetVersion`: 상태 버전 0으로 초기화 (기본: true)
+     * - `newSessionId`: 새 세션 ID 생성 (기본: true)
+     */
+    restore(snapshot: Snapshot, options?: RestoreSnapshotOptions): BlackboardState;
+    /**
+     * 부분 복원 (특정 섹션만)
+     * @param snapshot - 스냅샷
+     * @param currentState - 현재 상태
+     * @param sections - 복원할 섹션
+     * @returns 병합된 상태
+     */
+    partialRestore(snapshot: Snapshot, currentState: BlackboardState, sections: ('state' | 'knowledge' | 'decisions')[]): BlackboardState;
+}

package/dist/blackboard/snapshot/snapshot-serializer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @module snapshot/snapshot-serializer
+ * @description 스냅샷 직렬화 담당
+ */
+import type { Snapshot } from './types';
+/**
+ * 스냅샷 직렬화 옵션
+ */
+export interface SnapshotSerializeOptions {
+    /** 예쁜 출력 여부 */
+    pretty?: boolean;
+}
+/**
+ * 스냅샷 직렬화자
+ * @description 스냅샷 직렬화/역직렬화 전담 클래스
+ */
+export declare class SnapshotSerializer {
+    /**
+     * 스냅샷 → JSON 문자열
+     * @param snapshot - 스냅샷
+     * @param pretty - 예쁜 출력 여부
+     * @returns JSON 문자열
+     */
+    toJSON(snapshot: Snapshot, pretty?: boolean): string;
+    /**
+     * JSON 문자열 → 스냅샷
+     * @param json - JSON 문자열
+     * @returns 스냅샷
+     * @throws {Error} JSON 파싱 실패 시 명확한 에러 메시지
+     */
+    fromJSON(json: string): Snapshot;
+    /**
+     * 스냅샷 → Uint8Array (바이너리)
+     * @param snapshot - 스냅샷
+     * @returns Uint8Array
+     */
+    toUint8Array(snapshot: Snapshot): Uint8Array;
+    /**
+     * Uint8Array → 스냅샷
+     * @param bytes - 바이트 배열
+     * @returns 스냅샷
+     * @throws {Error} 디코딩 실패 시 명확한 에러 메시지
+     */
+    fromUint8Array(bytes: Uint8Array): Snapshot;
+}

package/dist/blackboard/snapshot/snapshot-validator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @module snapshot/snapshot-validator
+ * @description 스냅샷 검증 담당
+ */
+import type { Snapshot, SnapshotValidationResult } from "./types";
+import { StateSerializer } from "./serializer";
+/**
+ * 스냅샷 검증자
+ * @description 스냅샷 검증 전담 클래스
+ */
+export declare class SnapshotValidator {
+    private serializer;
+    constructor(serializer?: StateSerializer);
+    /**
+     * 스냅샷 검증 (비동기)
+     * @param snapshot - 검증할 스냅샷
+     * @returns 검증 결과
+     */
+    validate(snapshot: Snapshot): Promise<SnapshotValidationResult>;
+    /**
+     * 스냅샷 검증 (동기)
+     * @param snapshot - 검증할 스냅샷
+     * @returns 검증 결과
+     * @description 테스트 환경 등에서 동기 검증이 필요한 경우 사용
+     */
+    validateSync(snapshot: Snapshot): SnapshotValidationResult;
+    /**
+     * 버전 호환성 체크
+     * @param formatVersion - 스냅샷 형식 버전
+     * @returns 호환 여부 및 상세 정보
+     */
+    checkVersionCompatibility(formatVersion: string): {
+        compatible: boolean;
+        current: string;
+        snapshot: string;
+        migrationRequired: boolean;
+    };
+    /**
+     * 동기 체크섬 검증 (구조적 검증만, 체크섬 제외)
+     * @description restore()에서 사용하는 동기 검증 메서드
+     * 체크섬 검증은 비동기이므로 validate()에서 수행해야 함
+     * @param snapshot - 검증할 스냅샷
+     * @returns 검증 결과
+     */
+    validateSyncStructure(snapshot: Snapshot): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 런타임 구조 검증 (P0: agents/tasks/opinions)
+     * @description 역직렬화 후 실제 데이터 구조 검증
+     * P1: 에러 수집 모드 (break 제거)
+     */
+    private validateRuntimeStructure;
+}

package/dist/blackboard/snapshot/type-guards.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module snapshot/type-guards
+ * @description 타입 가드 함수들 (중복 제거)
+ */
+import type { SerializedState } from './types';
+/**
+ * 타입 가드: SerializedState 여부 확인
+ * @description P1: 검증 범위 확대 - state/knowledge/decisions 필드 검증 추가
+ * @param value - 확인할 값
+ * @returns SerializedState 타입 여부
+ */
+export declare function isSerializedState(value: unknown): value is SerializedState;

package/dist/blackboard/snapshot/types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * @module snapshot/types
+ * @description 스냅샷 타입 정의
+ */
+import type { SessionId } from "../types";
+/**
+ * 스냅샷 형식 버전
+ * @description 역직렬화 시 호환성 체크에 사용
+ */
+export declare const SNAPSHOT_FORMAT_VERSION = "1.0.0";
+/**
+ * 스냅샷 메타데이터
+ */
+export interface SnapshotMeta {
+    /** 스냅샷 ID */
+    readonly id: string;
+    /** 스냅샷 형식 버전 */
+    readonly formatVersion: string;
+    /** 생성 시간 */
+    readonly createdAt: Date;
+    /** 원본 세션 ID */
+    readonly sessionId: SessionId;
+    /** 원본 상태 버전 */
+    readonly stateVersion: number;
+    /** 스냅샷 설명 (선택) */
+    readonly description?: string;
+    /** 스냅샷 태그 (선택) */
+    readonly tags?: string[];
+    /** 체크섬 (무결성 검증용) */
+    readonly checksum: string;
+    /** 압축 데이터 체크섬 */
+    readonly compressedChecksum?: string;
+    /** 압축 여부 */
+    readonly compressed: boolean;
+    /** 원본 크기 (바이트) */
+    readonly originalSize: number;
+    /** 압축 크기 (바이트, 압축 시) */
+    readonly compressedSize?: number;
+}
+/**
+ * 직렬화된 상태
+ * @description Map, Date 등이 JSON 호환 형식으로 변환됨
+ */
+export interface SerializedState {
+    meta: {
+        version: number;
+        lastUpdated: string;
+        sessionId: string;
+        createdAt: string;
+    };
+    state: {
+        phase: string;
+        context: Record<string, unknown>;
+        agents: Array<[string, unknown]>;
+        tasks: Array<[string, unknown]>;
+    };
+    knowledge: {
+        facts: unknown[];
+        inferences: unknown[];
+        patterns: unknown[];
+    };
+    decisions: {
+        current: unknown | null;
+        pending: unknown[];
+        opinions: Array<[string, unknown]>;
+        history: unknown[];
+        voting?: Record<string, unknown>;
+    };
+}
+/**
+ * 전체 스냅샷 구조
+ */
+export interface Snapshot {
+    /** 메타데이터 */
+    meta: SnapshotMeta;
+    /** 직렬화된 상태 데이터 */
+    data: SerializedState | string;
+}
+/**
+ * 스냅샷 생성 옵션
+ */
+export interface CreateSnapshotOptions {
+    /** 스냅샷 설명 */
+    description?: string;
+    /** 태그 */
+    tags?: string[];
+    /** 압축 사용 여부 (기본: false) */
+    compress?: boolean;
+    /** 특정 섹션만 포함 */
+    includeSections?: ("state" | "knowledge" | "decisions")[];
+    /** 메타만 포함 (상태 제외) */
+    metaOnly?: boolean;
+    /** 내부 저장소에 저장 여부 */
+    store?: boolean;
+}
+/**
+ * 스냅샷 복원 옵션
+ */
+export interface RestoreSnapshotOptions {
+    /** 버전 체크 건너뛰기 */
+    skipVersionCheck?: boolean;
+    /** 구조적 검증 건너뛰기 (validateSync) */
+    skipStructuralValidation?: boolean;
+    /** 검증 건너뛰기 (별칭: skipStructuralValidation) */
+    skipValidation?: boolean;
+    /** 특정 섹션만 복원 */
+    restoreSections?: ("state" | "knowledge" | "decisions")[];
+    /** 복원 후 버전 리셋 여부 (기본: true) */
+    resetVersion?: boolean;
+    /** 새 세션 ID 발급 (기본: true) */
+    newSessionId?: boolean;
+}
+/**
+ * 스냅샷 검증 결과
+ */
+export interface SnapshotValidationResult {
+    /** 유효 여부 */
+    valid: boolean;
+    /** 에러 목록 */
+    errors: SnapshotValidationError[];
+    /** 경고 목록 */
+    warnings: SnapshotValidationWarning[];
+}
+/**
+ * 검증 에러
+ */
+export interface SnapshotValidationError {
+    code: "VERSION_MISMATCH" | "CHECKSUM_INVALID" | "DATA_CORRUPTED" | "FORMAT_INVALID" | "MISSING_FIELD";
+    message: string;
+    details?: unknown;
+}
+/**
+ * 검증 경고
+ */
+export interface SnapshotValidationWarning {
+    code: "DEPRECATED_FORMAT" | "UNKNOWN_FIELDS" | "PARTIAL_DATA";
+    message: string;
+    details?: unknown;
+}
+/**
+ * 스냅샷 마이그레이션 인터페이스
+ * @description 스냅샷 데이터 버전 간 마이그레이션을 위한 인터페이스
+ */
+export interface SnapshotMigration {
+    /** 원본 버전 */
+    fromVersion: number;
+    /** 대상 버전 */
+    toVersion: number;
+    /** 마이그레이션 함수 */
+    migrate(data: unknown): unknown;
+}

package/dist/blackboard/snapshot/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module snapshot/utils
+ * @description 유틸리티 함수들 (중복 제거)
+ */
+import type { Snapshot, SerializedState } from "./types";
+/**
+ * JSON.stringify replacer for key sorting
+ * @param key - Property key
+ * @param value - Property value
+ * @returns Value with sorted keys for objects
+ */
+export declare function sortedKeyReplacer(key: string, value: unknown): unknown;
+/**
+ * 스냅샷 데이터 압축 해제 (공통 헬퍼)
+ * @description P0: decompressData 로직 중복 제거를 위한 공통 함수
+ * @param snapshot - 스냅샷
+ * @returns 역직렬화된 상태 데이터
+ * @throws {Error} 압축 해제 실패 또는 타입 불일치 시
+ */
+export declare function decompressSnapshotData(snapshot: Snapshot): SerializedState;

package/dist/blackboard/types/agent.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @module agent
+ * @description 에이전트 관련 타입 정의
+ */
+import type { Timestamped } from "./base";
+import type { AgentId, TaskId } from "./base";
+/**
+ * 에이전트 상태 enum
+ * @description 에이전트의 현재 활동 상태를 나타냄
+ */
+export declare enum AgentStatusEnum {
+    /** 유휴 상태 - 작업 대기 중 */
+    IDLE = "idle",
+    /** 작업 중 - 활성 상태 */
+    BUSY = "busy",
+    /** 오류 상태 - 복구 필요 */
+    ERROR = "error",
+    /** 중지됨 */
+    STOPPED = "stopped"
+}
+/**
+ * 에이전트 역할 타입
+ * @description 에이전트가 수행할 수 있는 역할
+ */
+export type AgentRole = "analyst" | "executor" | "verifier" | "director";
+/**
+ * 에이전트 상태 정보
+ * @description 에이전트의 현재 상태와 작업 정보를 담는 인터페이스
+ *
+ * @example
+ * ```typescript
+ * const agentStatus: AgentStatus = {
+ *   id: createAgentId('agent-001'),
+ *   role: 'analyst',
+ *   status: AgentStatusEnum.BUSY,
+ *   currentTask: createTaskId('task-001'),
+ *   lastHeartbeat: new Date(),
+ *   createdAt: new Date(),
+ *   updatedAt: new Date(),
+ *   metadata: { model: 'gpt-4' }
+ * };
+ * ```
+ */
+export interface AgentStatus extends Timestamped {
+    /** 에이전트 고유 ID */
+    readonly id: AgentId;
+    /** 에이전트 역할 */
+    readonly role: AgentRole;
+    /** 현재 상태 */
+    status: AgentStatusEnum;
+    /** 현재 수행 중인 작업 (없으면 null) */
+    currentTask: TaskId | null;
+    /** 마지막 하트비트 시간 */
+    lastHeartbeat: Date;
+    /** 추가 메타데이터 */
+    metadata: Record<string, unknown>;
+}
+/**
+ * 에이전트 상태 업데이트 옵션
+ * @description 부분 업데이트를 위한 선택적 필드 인터페이스
+ */
+export interface AgentStatusUpdate {
+    /** 새로운 상태 */
+    status?: AgentStatusEnum;
+    /** 새로운 현재 작업 */
+    currentTask?: TaskId | null;
+    /** 마지막 하트비트 시간 */
+    lastHeartbeat?: Date;
+    /** 업데이트할 메타데이터 */
+    metadata?: Partial<Record<string, unknown>>;
+}
+/**
+ * 에이전트 통계
+ * @description 에이전트의 성능 및 활동 통계
+ */
+export interface AgentStats {
+    /** 에이전트 ID */
+    agentId: AgentId;
+    /** 완료한 작업 수 */
+    tasksCompleted: number;
+    /** 실패한 작업 수 */
+    tasksFailed: number;
+    /** 총 작업 시간 (밀리초) */
+    totalTaskTime: number;
+    /** 평균 작업 시간 (밀리초) */
+    averageTaskTime: number;
+    /** 마지막 활동 시간 */
+    lastActiveTime: Date;
+}