@jee1/memento-client 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,288 @@
+/**
+ * @jee1/memento-client 타입 정의
+ * Memento MCP Server와 통신하기 위한 클라이언트 라이브러리 타입들
+ */
+export type MemoryType = 'working' | 'episodic' | 'semantic' | 'procedural' | 'core' | 'vault';
+export type PrivacyScope = 'private' | 'team' | 'public';
+export interface MementoClientOptions {
+    /** MCP 서버 URL (기본값: http://localhost:8080) */
+    serverUrl?: string;
+    /** API 키 (M2+에서 사용) */
+    apiKey?: string;
+    /** 연결 타임아웃 (밀리초, 기본값: 10000) */
+    timeout?: number;
+    /** 재시도 횟수 (기본값: 3) */
+    retryCount?: number;
+    /** 로그 레벨 */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'silent';
+}
+export interface MemoryItem {
+    id: string;
+    content: string;
+    type: MemoryType;
+    importance: number;
+    created_at: string;
+    last_accessed?: string;
+    pinned: boolean;
+    source?: string;
+    tags?: string[];
+    privacy_scope: PrivacyScope;
+    project_id?: string;
+    user_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateMemoryParams {
+    content?: string;
+    type?: MemoryType;
+    key?: string;
+    value?: string;
+    always_load?: boolean;
+    immutable?: boolean;
+    task_goal?: string;
+    steps?: string;
+    reflection_notes?: string;
+    tags?: string[];
+    importance?: number;
+    source?: string;
+    privacy_scope?: PrivacyScope;
+    project_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateMemoryParams {
+    content?: string;
+    type?: MemoryType;
+    key?: string;
+    value?: string;
+    always_load?: boolean;
+    immutable?: boolean;
+    task_goal?: string;
+    steps?: string;
+    reflection_notes?: string;
+    tags?: string[];
+    importance?: number;
+    source?: string;
+    privacy_scope?: PrivacyScope;
+    project_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SearchFilters {
+    id?: string[];
+    type?: MemoryType[];
+    tags?: string[];
+    project_id?: string;
+    time_from?: string;
+    time_to?: string;
+    pinned?: boolean;
+}
+/**
+ * `/tools/recall`에 전달하는 추가 옵션.
+ * `score_breakdown`을 받으려면 서버 계약상 `include_metadata`와 `include_score_breakdown`을 모두 켜야 한다.
+ */
+export interface RecallCallOptions {
+    include_metadata?: boolean;
+    include_score_breakdown?: boolean;
+    /** 하이브리드 검색 가중치 (0–1). 서버 `recall` 도구 `vector_weight`와 동일 */
+    vector_weight?: number;
+    /** 하이브리드 검색 가중치 (0–1). 서버 `recall` 도구 `text_weight`와 동일 */
+    text_weight?: number;
+}
+export interface SearchResult {
+    items: MemorySearchResult[];
+    total_count: number;
+    query_time: number;
+    search_type?: string;
+    vector_search_available?: boolean;
+}
+export interface MemorySearchResult {
+    id: string;
+    content: string;
+    type: MemoryType;
+    importance: number;
+    created_at: string;
+    last_accessed?: string;
+    pinned: boolean;
+    tags?: string[];
+    privacy_scope: PrivacyScope;
+    score: number;
+    recall_reason: string;
+    /** `recall` 시 include_metadata·include_score_breakdown이 모두 true일 때만(서버 계약) */
+    score_breakdown?: unknown;
+}
+export interface HybridSearchParams {
+    query: string;
+    filters?: SearchFilters;
+    limit?: number;
+    vectorWeight?: number;
+    textWeight?: number;
+    /** recall과 동일 — score_breakdown을 쓰려면 include_metadata·include_score_breakdown 필요 */
+    include_metadata?: boolean;
+    include_score_breakdown?: boolean;
+}
+export interface HybridSearchResult {
+    items: HybridSearchItem[];
+    total_count: number;
+    query_time: number;
+    search_type: 'hybrid';
+}
+export interface HybridSearchItem {
+    id: string;
+    content: string;
+    type: MemoryType;
+    importance: number;
+    created_at: string;
+    last_accessed?: string;
+    pinned: boolean;
+    tags?: string[];
+    privacy_scope: PrivacyScope;
+    textScore: number;
+    vectorScore: number;
+    finalScore: number;
+    score: number;
+    recall_reason: string;
+    score_breakdown?: unknown;
+}
+export interface RememberResult {
+    memory_id: string;
+    created_at: string;
+    type: string;
+    importance: number;
+}
+export interface PinResult {
+    success: boolean;
+    memory_id: string;
+    pinned: boolean;
+}
+export interface ForgetResult {
+    success: boolean;
+    memory_id: string;
+    deleted_at: string;
+}
+export interface LinkResult {
+    success: boolean;
+    link_id: string;
+    source_id: string;
+    target_id: string;
+    relation_type: string;
+    created_at: string;
+}
+export interface ExportResult {
+    success: boolean;
+    format: string;
+    data: string;
+    count: number;
+    exported_at: string;
+}
+export interface FeedbackResult {
+    success: boolean;
+    memory_id?: string;
+    feedback_id?: string;
+    helpful?: boolean;
+    created_at?: string;
+    /** 실패 시 (contracts/mcp-tools.md) */
+    error?: string;
+}
+/**
+ * `MementoClient.feedback()` 6번째 인자(FR-002) — `session_id`·`agent_id` 출처 추적.
+ * `score_breakdown`만 없고 attribution만 줄 때: `feedback(id, h, comment, score, undefined, options)`.
+ */
+export interface FeedbackCallOptions {
+    session_id?: string;
+    agent_id?: string;
+}
+/** `recordRecallFeedback()` — comment·score·attribution을 한 번에 전달 */
+export interface RecordRecallFeedbackOptions extends FeedbackCallOptions {
+    comment?: string;
+    score?: number;
+}
+export interface ContextInjectionParams {
+    query: string;
+    token_budget?: number;
+    context_type?: 'conversation' | 'task' | 'general';
+}
+export interface ContextInjectionResult {
+    role: 'system';
+    content: string;
+    metadata: {
+        memories_used: number;
+        token_count: number;
+        search_time: number;
+    };
+}
+export type AgentEventEnvelopeLike = Record<string, unknown>;
+export interface AgentObservationQuery {
+    cursor?: string;
+    limit?: number;
+    event_type?: string;
+    status?: string;
+    from?: string;
+    to?: string;
+}
+export interface AgentOperationsStatusQuery {
+    since?: string;
+    limit?: number;
+}
+export interface AgentProvenanceQuery {
+    memory_id?: string;
+    observation_id?: string;
+    direction?: 'sources' | 'derived' | 'both';
+    max_depth?: number;
+}
+export interface AgentProvenanceLinkInput {
+    memory_id: string;
+    session_id?: string;
+    observation_id?: string;
+    derivation_type: string;
+}
+export declare class MementoError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, details?: Record<string, unknown> | undefined);
+}
+export declare class ConnectionError extends MementoError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class AuthenticationError extends MementoError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class ValidationError extends MementoError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class NotFoundError extends MementoError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export interface MementoClientEvents {
+    'connected': () => void;
+    'disconnected': () => void;
+    'error': (error: MementoError) => void;
+    'memory:created': (memory: MemoryItem) => void;
+    'memory:updated': (memory: MemoryItem) => void;
+    'memory:deleted': (memoryId: string) => void;
+    'memory:pinned': (memoryId: string) => void;
+    'memory:unpinned': (memoryId: string) => void;
+}
+export interface PaginationParams {
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+}
+export interface PaginatedResult<T> {
+    items: T[];
+    total_count: number;
+    has_more: boolean;
+    next_cursor?: string;
+}
+export interface HealthCheck {
+    status: 'healthy' | 'unhealthy';
+    version: string;
+    uptime: number;
+    database: {
+        status: 'connected' | 'disconnected';
+        latency?: number;
+    };
+    search: {
+        status: 'available' | 'unavailable';
+        embedding_available: boolean;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,44 @@
+/**
+ * @jee1/memento-client 타입 정의
+ * Memento MCP Server와 통신하기 위한 클라이언트 라이브러리 타입들
+ */
+// ============================================================================
+// 에러 타입들
+// ============================================================================
+export class MementoError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(message, code, statusCode, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'MementoError';
+    }
+}
+export class ConnectionError extends MementoError {
+    constructor(message, details) {
+        super(message, 'CONNECTION_ERROR', undefined, details);
+        this.name = 'ConnectionError';
+    }
+}
+export class AuthenticationError extends MementoError {
+    constructor(message, details) {
+        super(message, 'AUTHENTICATION_ERROR', 401, details);
+        this.name = 'AuthenticationError';
+    }
+}
+export class ValidationError extends MementoError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', 400, details);
+        this.name = 'ValidationError';
+    }
+}
+export class NotFoundError extends MementoError {
+    constructor(message, details) {
+        super(message, 'NOT_FOUND', 404, details);
+        this.name = 'NotFoundError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAySH,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG5B;IACA;IACA;IAJT,YACE,OAAe,EACR,IAAY,EACZ,UAAmB,EACnB,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @jee1/memento-client 유틸리티 함수들
+ * 클라이언트 라이브러리 사용을 편리하게 하는 헬퍼 함수들
+ */
+export { isValidMemoryType, isValidPrivacyScope, isValidImportance, validateCreateMemoryParams, validateSearchParams, } from './client/validation-utils.js';
+export { extractTagsFromContent, summarizeContent, calculateImportance, getDefaultSettingsForType, serializeMemory, deserializeMemory, } from './client/memory-utils.js';
+export { normalizeQuery, normalizeScore, groupSearchResults, } from './client/search-utils.js';
+export { getRelativeTime, createDateRangeFilter, } from './client/time-utils.js';
+export { memoriesToCSV, memoriesToMarkdown, } from './client/format-utils.js';
+export { createMementoClient } from './client/factory.js';
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/utils.js

@@ -0,0 +1,11 @@
+/**
+ * @jee1/memento-client 유틸리티 함수들
+ * 클라이언트 라이브러리 사용을 편리하게 하는 헬퍼 함수들
+ */
+export { isValidMemoryType, isValidPrivacyScope, isValidImportance, validateCreateMemoryParams, validateSearchParams, } from './client/validation-utils.js';
+export { extractTagsFromContent, summarizeContent, calculateImportance, getDefaultSettingsForType, serializeMemory, deserializeMemory, } from './client/memory-utils.js';
+export { normalizeQuery, normalizeScore, groupSearchResults, } from './client/search-utils.js';
+export { getRelativeTime, createDateRangeFilter, } from './client/time-utils.js';
+export { memoriesToCSV, memoriesToMarkdown, } from './client/format-utils.js';
+export { createMementoClient } from './client/factory.js';
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@jee1/memento-client",
+  "version": "0.1.0",
+  "description": "Memento MCP Server client library for AI Agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "clean": "rimraf dist",
+    "type-check": "tsc --declaration --emitDeclarationOnly",
+    "test": "vitest run",
+    "test:ci": "vitest run --reporter=basic"
+  },
+  "keywords": [
+    "memento",
+    "mcp",
+    "memory",
+    "ai",
+    "agent",
+    "context",
+    "typescript"
+  ],
+  "author": "Memento Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jee1/memento.git",
+    "directory": "packages/memento-client"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.18.1",
+    "ws": "^8.21.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}