@jee1/memento-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Memento Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @jee1/memento-client
+
+TypeScript/JavaScript 앱에서 Memento HTTP API(`/tools/*`)를 **프로그래밍 방식으로** 호출할 때 쓰는 클라이언트입니다. MCP 프로토콜 대신 REST 래퍼가 필요한 백엔드·스크립트·테스트에 맞습니다.
+
+## 스크립트
+
+| 명령 | 설명 |
+|------|------|
+| `npm run build -w @jee1/memento-client` | 빌드 |
+| `npm run test -w @jee1/memento-client` | 단위 테스트 |
+| `npm run type-check -w @jee1/memento-client` | 타입 검사 |
+
+## 문서
+
+패키지 API와 사용 예는 저장소 [docs/README.md](../../docs/README.md) 및 앱 예시 `apps/experimental-example`을 참고하세요.
+
+저장소 전체 구조는 [AGENTS.md](../../AGENTS.md)를 참고하세요.

package/dist/client/agent-client.d.ts

@@ -0,0 +1,15 @@
+import type { AgentEventEnvelopeLike, AgentObservationQuery, AgentOperationsStatusQuery, AgentProvenanceQuery, AgentProvenanceLinkInput } from '../types.js';
+import type { MementoClientCore } from './client-context.js';
+export declare function getAgentCapabilities<T = Record<string, unknown>>(client: MementoClientCore): Promise<T>;
+export declare function getAgentOperationsStatus<T = Record<string, unknown>>(client: MementoClientCore, query?: AgentOperationsStatusQuery): Promise<T>;
+export declare function startAgentSession<T = Record<string, unknown>>(client: MementoClientCore, event: AgentEventEnvelopeLike): Promise<T>;
+export declare function ingestAgentObservations<T = Record<string, unknown>>(client: MementoClientCore, events: AgentEventEnvelopeLike[]): Promise<T>;
+export declare function preCompactAgentSession<T = Record<string, unknown>>(client: MementoClientCore, sessionId: string, event: AgentEventEnvelopeLike): Promise<T>;
+export declare function stopAgentSession<T = Record<string, unknown>>(client: MementoClientCore, sessionId: string, event: AgentEventEnvelopeLike): Promise<T>;
+export declare function getAgentSession<T = Record<string, unknown>>(client: MementoClientCore, sessionId: string): Promise<T>;
+export declare function listAgentObservations<T = Record<string, unknown>>(client: MementoClientCore, sessionId: string, query?: AgentObservationQuery): Promise<T>;
+export declare function getAgentProvenance<T = Record<string, unknown>>(client: MementoClientCore, query: AgentProvenanceQuery): Promise<T>;
+export declare function linkAgentProvenance<T = Record<string, unknown>>(client: MementoClientCore, input: AgentProvenanceLinkInput): Promise<T>;
+export declare function exportAgentSession<T = Record<string, unknown>>(client: MementoClientCore, sessionId: string): Promise<T>;
+export declare function deleteAgentSession(client: MementoClientCore, sessionId: string): Promise<void>;
+//# sourceMappingURL=agent-client.d.ts.map

package/dist/client/agent-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.d.ts","sourceRoot":"","sources":["../../src/client/agent-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,wBAAsB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED,wBAAsB,wBAAwB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,MAAM,EAAE,iBAAiB,EACzB,KAAK,GAAE,0BAA+B,GACrC,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED,wBAAsB,uBAAuB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,sBAAsB,EAAE,GAC/B,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED,wBAAsB,sBAAsB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAsB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAsB,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,qBAA0B,GAChC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED,wBAAsB,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/client/agent-client.js

@@ -0,0 +1,64 @@
+export async function getAgentCapabilities(client) {
+    client.ensureConnected();
+    const response = await client.httpClient.get('/api/v1/agent/capabilities');
+    return response.data;
+}
+export async function getAgentOperationsStatus(client, query = {}) {
+    client.ensureConnected();
+    const response = await client.httpClient.get('/api/v1/agent/operations/status', {
+        params: query,
+    });
+    return response.data;
+}
+export async function startAgentSession(client, event) {
+    client.ensureConnected();
+    const response = await client.httpClient.post('/api/v1/agent/sessions', event);
+    return response.data;
+}
+export async function ingestAgentObservations(client, events) {
+    client.ensureConnected();
+    const response = await client.httpClient.post('/api/v1/agent/observations:ingest', { events });
+    return response.data;
+}
+export async function preCompactAgentSession(client, sessionId, event) {
+    client.ensureConnected();
+    const response = await client.httpClient.post(`/api/v1/agent/sessions/${encodeURIComponent(sessionId)}:pre-compact`, event);
+    return response.data;
+}
+export async function stopAgentSession(client, sessionId, event) {
+    client.ensureConnected();
+    const response = await client.httpClient.post(`/api/v1/agent/sessions/${encodeURIComponent(sessionId)}:stop`, event);
+    return response.data;
+}
+export async function getAgentSession(client, sessionId) {
+    client.ensureConnected();
+    const response = await client.httpClient.get(`/api/v1/agent/sessions/${encodeURIComponent(sessionId)}`);
+    return response.data;
+}
+export async function listAgentObservations(client, sessionId, query = {}) {
+    client.ensureConnected();
+    const response = await client.httpClient.get(`/api/v1/agent/sessions/${encodeURIComponent(sessionId)}/observations`, { params: query });
+    return response.data;
+}
+export async function getAgentProvenance(client, query) {
+    client.ensureConnected();
+    const response = await client.httpClient.get('/api/v1/agent/provenance', {
+        params: query,
+    });
+    return response.data;
+}
+export async function linkAgentProvenance(client, input) {
+    client.ensureConnected();
+    const response = await client.httpClient.post('/api/v1/agent/provenance', input);
+    return response.data;
+}
+export async function exportAgentSession(client, sessionId) {
+    client.ensureConnected();
+    const response = await client.httpClient.get(`/api/v1/agent/sessions/${encodeURIComponent(sessionId)}/export`);
+    return response.data;
+}
+export async function deleteAgentSession(client, sessionId) {
+    client.ensureConnected();
+    await client.httpClient.delete(`/api/v1/agent/sessions/${encodeURIComponent(sessionId)}`);
+}
+//# sourceMappingURL=agent-client.js.map

package/dist/client/agent-client.js.map

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

package/dist/client/client-context.d.ts

@@ -0,0 +1,14 @@
+import type { AxiosInstance } from 'axios';
+import type { EventEmitter } from 'events';
+import type { MementoClientOptions, HealthCheck } from '../types.js';
+/**
+ * MementoClient 내부 모듈이 공유하는 컨텍스트 인터페이스
+ */
+export type MementoClientCore = EventEmitter & {
+    httpClient: AxiosInstance;
+    isConnected: boolean;
+    options: Required<MementoClientOptions>;
+    healthCheck(): Promise<HealthCheck>;
+    ensureConnected(): void;
+};
+//# sourceMappingURL=client-context.d.ts.map

package/dist/client/client-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-context.d.ts","sourceRoot":"","sources":["../../src/client/client-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG;IAC7C,UAAU,EAAE,aAAa,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACxC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,eAAe,IAAI,IAAI,CAAC;CACzB,CAAC"}

package/dist/client/client-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client-context.js.map

package/dist/client/client-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-context.js","sourceRoot":"","sources":["../../src/client/client-context.ts"],"names":[],"mappings":""}

package/dist/client/factory.d.ts

@@ -0,0 +1,7 @@
+import { MementoClient } from '../memento-client.js';
+import type { MementoClientOptions } from '../types.js';
+/**
+ * MementoClient 인스턴스를 생성하는 팩토리 함수
+ */
+export declare function createMementoClient(options?: MementoClientOptions): MementoClient;
+//# sourceMappingURL=factory.d.ts.map

package/dist/client/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/client/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAEjF"}

package/dist/client/factory.js

@@ -0,0 +1,8 @@
+import { MementoClient } from '../memento-client.js';
+/**
+ * MementoClient 인스턴스를 생성하는 팩토리 함수
+ */
+export function createMementoClient(options) {
+    return new MementoClient(options);
+}
+//# sourceMappingURL=factory.js.map

package/dist/client/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/client/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA8B;IAChE,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/client/format-utils.d.ts

@@ -0,0 +1,10 @@
+import type { MemoryItem } from '../types.js';
+/**
+ * 메모리 배열을 CSV로 변환
+ */
+export declare function memoriesToCSV(memories: MemoryItem[]): string;
+/**
+ * 메모리 배열을 Markdown으로 변환
+ */
+export declare function memoriesToMarkdown(memories: MemoryItem[]): string;
+//# sourceMappingURL=format-utils.d.ts.map

package/dist/client/format-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../../src/client/format-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAa9C;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CA8B5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CA0CjE"}

package/dist/client/format-utils.js

@@ -0,0 +1,79 @@
+/**
+ * CSV 셀 값을 안전하게 이스케이프
+ */
+function toSafeCSVCell(value) {
+    if (value == null)
+        return '';
+    const neutralizedValue = /^[=+\-@]/.test(value) ? `'${value}` : value;
+    return `"${neutralizedValue.replace(/"/g, '""')}"`;
+}
+/**
+ * 메모리 배열을 CSV로 변환
+ */
+export function memoriesToCSV(memories) {
+    if (memories.length === 0)
+        return '';
+    const headers = [
+        'id',
+        'content',
+        'type',
+        'importance',
+        'created_at',
+        'last_accessed',
+        'pinned',
+        'tags',
+        'privacy_scope',
+        'source',
+    ];
+    const rows = memories.map(memory => [
+        memory.id,
+        toSafeCSVCell(memory.content),
+        memory.type,
+        memory.importance,
+        memory.created_at,
+        memory.last_accessed || '',
+        memory.pinned,
+        memory.tags?.length ? toSafeCSVCell(memory.tags.join(';')) : '',
+        memory.privacy_scope,
+        memory.source ? toSafeCSVCell(memory.source) : '',
+    ]);
+    return [headers.join(','), ...rows.map(row => row.join(','))].join('\n');
+}
+/**
+ * 메모리 배열을 Markdown으로 변환
+ */
+export function memoriesToMarkdown(memories) {
+    if (memories.length === 0)
+        return '# 기억이 없습니다\n';
+    let markdown = `# 기억 목록 (${memories.length}개)\n\n`;
+    for (const memory of memories) {
+        const typeEmoji = {
+            working: '⚡',
+            episodic: '📅',
+            semantic: '🧠',
+            procedural: '🔧',
+            core: '⭐',
+            vault: '🔒',
+        }[memory.type] || '📝';
+        const importanceBar = '★'.repeat(Math.round(memory.importance * 5)) +
+            '☆'.repeat(5 - Math.round(memory.importance * 5));
+        markdown += `## ${typeEmoji} ${memory.id}\n\n`;
+        markdown += `**내용**: ${memory.content}\n\n`;
+        markdown += `**타입**: ${memory.type}\n`;
+        markdown += `**중요도**: ${importanceBar} (${memory.importance})\n`;
+        markdown += `**생성일**: ${memory.created_at}\n`;
+        if (memory.last_accessed) {
+            markdown += `**마지막 접근**: ${memory.last_accessed}\n`;
+        }
+        if (memory.tags && memory.tags.length > 0) {
+            markdown += `**태그**: ${memory.tags.map(tag => `#${tag}`).join(' ')}\n`;
+        }
+        markdown += `**공개 범위**: ${memory.privacy_scope}\n`;
+        if (memory.pinned) {
+            markdown += `**고정됨**: ✅\n`;
+        }
+        markdown += '\n---\n\n';
+    }
+    return markdown;
+}
+//# sourceMappingURL=format-utils.js.map

package/dist/client/format-utils.js.map

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

package/dist/client/http-transport.d.ts

@@ -0,0 +1,29 @@
+import type { MementoClientOptions, HealthCheck } from '../types.js';
+import { MementoError } from '../types.js';
+import type { AxiosInstance, AxiosError } from 'axios';
+import type { MementoClientCore } from './client-context.js';
+/**
+ * HTTP 클라이언트 생성
+ */
+export declare function createHttpClient(options: Required<MementoClientOptions>, onError: (error: MementoError) => void): AxiosInstance;
+/**
+ * HTTP 에러를 MementoError로 변환
+ */
+export declare function handleHttpError(error: AxiosError): MementoError;
+/**
+ * 연결 상태 확인
+ */
+export declare function ensureConnected(client: MementoClientCore): void;
+/**
+ * 서버에 연결
+ */
+export declare function connectClient(client: MementoClientCore): Promise<void>;
+/**
+ * 연결 해제
+ */
+export declare function disconnectClient(client: MementoClientCore): Promise<void>;
+/**
+ * 서버 상태 확인
+ */
+export declare function healthCheck(client: MementoClientCore): Promise<HealthCheck>;
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/client/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../src/client/http-transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,YAAY,EAKb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAA6C,UAAU,EAAE,MAAM,OAAO,CAAC;AAClG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EACvC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACrC,aAAa,CAgDf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CA2B/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAI/D;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAGjF"}

package/dist/client/http-transport.js

@@ -0,0 +1,123 @@
+import axios from 'axios';
+import { logger } from '../logger.js';
+import { MementoError, ConnectionError, AuthenticationError, ValidationError, NotFoundError, } from '../types.js';
+/**
+ * HTTP 클라이언트 생성
+ */
+export function createHttpClient(options, onError) {
+    const client = axios.create({
+        baseURL: options.serverUrl,
+        timeout: options.timeout,
+        headers: {
+            'Content-Type': 'application/json',
+            'User-Agent': '@jee1/memento-client/0.1.0',
+        },
+    });
+    client.interceptors.request.use((config) => {
+        if (options.apiKey && config.headers) {
+            config.headers.Authorization = `Bearer ${options.apiKey}`;
+        }
+        if (options.logLevel === 'debug') {
+            logger.debug('[MementoClient] Request:', {
+                method: config.method?.toUpperCase(),
+                url: config.url,
+            });
+        }
+        return config;
+    }, (error) => {
+        onError(new ConnectionError('Request failed', error));
+        return Promise.reject(error);
+    });
+    client.interceptors.response.use((response) => {
+        if (options.logLevel === 'debug') {
+            logger.debug('[MementoClient] Response:', {
+                status: response.status,
+            });
+        }
+        return response;
+    }, (error) => {
+        const mementoError = handleHttpError(error);
+        onError(mementoError);
+        return Promise.reject(mementoError);
+    });
+    return client;
+}
+/**
+ * HTTP 에러를 MementoError로 변환
+ */
+export function handleHttpError(error) {
+    if (error.response) {
+        const { status, data } = error.response;
+        const errorData = data;
+        const message = (errorData?.error && typeof errorData.error === 'object' && 'message' in errorData.error && typeof errorData.error.message === 'string')
+            ? errorData.error.message
+            : (errorData?.message && typeof errorData.message === 'string')
+                ? errorData.message
+                : error.message;
+        switch (status) {
+            case 400:
+                return new ValidationError(message, errorData);
+            case 401:
+                return new AuthenticationError(message, errorData);
+            case 404:
+                return new NotFoundError(message, errorData);
+            case 500:
+                return new MementoError(message, 'INTERNAL_ERROR', status, errorData);
+            default:
+                return new MementoError(message, 'HTTP_ERROR', status, errorData);
+        }
+    }
+    else if (error.request) {
+        return new ConnectionError('Network error - no response received', error);
+    }
+    else {
+        return new ConnectionError('Request setup error', error);
+    }
+}
+/**
+ * 연결 상태 확인
+ */
+export function ensureConnected(client) {
+    if (!client.isConnected) {
+        throw new ConnectionError('Client is not connected. Call connect() first.');
+    }
+}
+/**
+ * 서버에 연결
+ */
+export async function connectClient(client) {
+    try {
+        const health = await client.healthCheck();
+        client.isConnected = true;
+        client.emit('connected');
+        if (client.options.logLevel !== 'silent') {
+            logger.info('✅ Memento 서버에 연결되었습니다:', {
+                version: health.version,
+                status: health.status,
+            });
+        }
+    }
+    catch (error) {
+        client.isConnected = false;
+        client.emit('error', error);
+        throw new ConnectionError('Failed to connect to Memento server', error);
+    }
+}
+/**
+ * 연결 해제
+ */
+export async function disconnectClient(client) {
+    client.isConnected = false;
+    client.emit('disconnected');
+    if (client.options.logLevel !== 'silent') {
+        logger.info('🔌 Memento 서버 연결이 해제되었습니다');
+    }
+}
+/**
+ * 서버 상태 확인
+ */
+export async function healthCheck(client) {
+    const response = await client.httpClient.get('/health');
+    return response.data;
+}
+//# sourceMappingURL=http-transport.js.map

package/dist/client/http-transport.js.map

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

package/dist/client/memory-client.d.ts

@@ -0,0 +1,27 @@
+import type { MemoryItem, CreateMemoryParams, UpdateMemoryParams, RememberResult, PinResult, ForgetResult } from '../types.js';
+import type { MementoClientCore } from './client-context.js';
+/**
+ * 기억 저장
+ */
+export declare function remember(client: MementoClientCore, params: CreateMemoryParams): Promise<RememberResult>;
+/**
+ * 기억 조회
+ */
+export declare function getMemory(client: MementoClientCore, id: string): Promise<MemoryItem>;
+/**
+ * 기억 업데이트
+ */
+export declare function updateMemory(client: MementoClientCore, id: string, params: UpdateMemoryParams): Promise<MemoryItem>;
+/**
+ * 기억 삭제
+ */
+export declare function forget(client: MementoClientCore, memoryId: string, hard?: boolean): Promise<ForgetResult>;
+/**
+ * 기억 고정
+ */
+export declare function pin(client: MementoClientCore, memoryId: string): Promise<PinResult>;
+/**
+ * 기억 고정 해제
+ */
+export declare function unpin(client: MementoClientCore, memoryId: string): Promise<PinResult>;
+//# sourceMappingURL=memory-client.d.ts.map

package/dist/client/memory-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-client.d.ts","sourceRoot":"","sources":["../../src/client/memory-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAuB1F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,EACzB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,UAAU,CAAC,CA+DrB;AAED;;GAEG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,OAAe,GACpB,OAAO,CAAC,YAAY,CAAC,CAWvB;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAUzF;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAU3F"}

package/dist/client/memory-client.js

@@ -0,0 +1,128 @@
+import { recall } from './search-client.js';
+/**
+ * 기억 저장
+ */
+export async function remember(client, params) {
+    client.ensureConnected();
+    const response = await client.httpClient.post('/tools/remember', params);
+    const result = response.data.result;
+    client.emit('memory:created', result);
+    return result;
+}
+/**
+ * 기억 조회
+ */
+export async function getMemory(client, id) {
+    client.ensureConnected();
+    const searchResult = await recall(client, 'memory', { id: [id] }, 1);
+    let items;
+    if (searchResult.items && Array.isArray(searchResult.items)) {
+        items = searchResult.items;
+    }
+    else if (searchResult.items && typeof searchResult.items === 'object' && 'items' in searchResult.items) {
+        const nestedItems = searchResult.items;
+        items = Array.isArray(nestedItems.items) ? nestedItems.items : [];
+    }
+    else {
+        throw new Error(`Memory with ID ${id} not found`);
+    }
+    if (items.length === 0) {
+        throw new Error(`Memory with ID ${id} not found`);
+    }
+    const memory = items[0];
+    if (!memory || memory.id !== id) {
+        throw new Error(`Memory with ID ${id} not found`);
+    }
+    return memory;
+}
+/**
+ * 기억 업데이트
+ */
+export async function updateMemory(client, id, params) {
+    client.ensureConnected();
+    const existingMemory = await getMemory(client, id);
+    const memoryType = params.type || existingMemory.type;
+    await forget(client, id);
+    const createParams = {
+        type: memoryType,
+        tags: params.tags !== undefined ? params.tags : existingMemory.tags,
+        importance: params.importance !== undefined ? params.importance : existingMemory.importance,
+        source: params.source !== undefined ? params.source : existingMemory.source,
+        privacy_scope: params.privacy_scope !== undefined ? params.privacy_scope : existingMemory.privacy_scope,
+        project_id: params.project_id !== undefined ? params.project_id : existingMemory.project_id,
+        metadata: params.metadata !== undefined ? params.metadata : existingMemory.metadata,
+    };
+    const existingMemoryExtended = existingMemory;
+    if (memoryType === 'core') {
+        createParams.key = params.key !== undefined ? params.key : existingMemoryExtended.key;
+        createParams.value = params.value !== undefined ? params.value : existingMemoryExtended.value;
+        createParams.always_load = params.always_load !== undefined ? params.always_load : existingMemoryExtended.always_load;
+    }
+    else if (memoryType === 'vault') {
+        createParams.key = params.key !== undefined ? params.key : existingMemoryExtended.key;
+        createParams.value = params.value !== undefined ? params.value : existingMemoryExtended.value;
+        createParams.immutable = params.immutable !== undefined ? params.immutable : existingMemoryExtended.immutable;
+    }
+    else {
+        createParams.content = params.content !== undefined ? params.content : existingMemory.content;
+        if (memoryType === 'procedural') {
+            createParams.task_goal = params.task_goal !== undefined ? params.task_goal : existingMemoryExtended.task_goal;
+            createParams.steps = params.steps !== undefined ? params.steps : existingMemoryExtended.steps;
+            createParams.reflection_notes = params.reflection_notes !== undefined ? params.reflection_notes : existingMemoryExtended.reflection_notes;
+        }
+    }
+    const rememberResult = await remember(client, createParams);
+    const memoryItem = {
+        id: rememberResult.memory_id,
+        content: createParams.content || '',
+        type: createParams.type || 'episodic',
+        importance: createParams.importance || 0.5,
+        created_at: rememberResult.created_at,
+        pinned: false,
+        privacy_scope: createParams.privacy_scope || 'private',
+        tags: createParams.tags,
+        source: createParams.source,
+        project_id: createParams.project_id,
+        metadata: createParams.metadata,
+    };
+    client.emit('memory:updated', memoryItem);
+    return memoryItem;
+}
+/**
+ * 기억 삭제
+ */
+export async function forget(client, memoryId, hard = false) {
+    client.ensureConnected();
+    const response = await client.httpClient.post('/tools/forget', {
+        id: memoryId,
+        hard,
+    });
+    const result = response.data.result;
+    client.emit('memory:deleted', memoryId);
+    return result;
+}
+/**
+ * 기억 고정
+ */
+export async function pin(client, memoryId) {
+    client.ensureConnected();
+    const response = await client.httpClient.post('/tools/pin', {
+        id: memoryId,
+    });
+    const result = response.data.result;
+    client.emit('memory:pinned', memoryId);
+    return result;
+}
+/**
+ * 기억 고정 해제
+ */
+export async function unpin(client, memoryId) {
+    client.ensureConnected();
+    const response = await client.httpClient.post('/tools/unpin', {
+        id: memoryId,
+    });
+    const result = response.data.result;
+    client.emit('memory:unpinned', memoryId);
+    return result;
+}
+//# sourceMappingURL=memory-client.js.map

package/dist/client/memory-client.js.map

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