@jungjaehoon/mama-os 0.8.3 → 0.9.0

package/public/viewer/js/utils/api.js

@@ -3,267 +3,267 @@
  * @module utils/api
  * @version 1.0.0
  */
-
-/* eslint-env browser */
-
-/**
- * API client for MAMA viewer
- */
 export class API {
-  /**
-   * Base URL for API requests (empty for same origin)
-   */
-  static baseUrl = '';
-
-  /**
-   * Perform GET request
-   * @param {string} endpoint - API endpoint
-   * @param {Object} params - Query parameters
-   * @returns {Promise<Object>} Response data
-   */
-  static async get(endpoint, params = null) {
-    const url = new URL(endpoint, window.location.origin);
-    if (params) {
-      Object.entries(params).forEach(([key, value]) => {
-        if (value !== null && value !== undefined) {
-          url.searchParams.set(key, value);
+    /**
+     * Base URL for API requests (empty for same origin)
+     */
+    static baseUrl = '';
+    /**
+     * Parse JSON response safely with explicit error context.
+     */
+    static async parseJsonResponse(response, context = '요청') {
+        const contentType = response.headers.get('content-type') || '';
+        const text = await response.text();
+        if (!contentType.includes('application/json')) {
+            const snippet = text.slice(0, 80).replace(/\n/g, ' ');
+            throw new Error(`${context}에서 JSON 응답이 아닙니다. content-type: ${contentType || '없음'}, body: ${snippet}`);
+        }
+        try {
+            if (!text) {
+                throw new Error(`${context} 응답 본문이 비어 있습니다. status=${response.status}, url=${response.url}`);
+            }
+            return JSON.parse(text);
+        }
+        catch (error) {
+            const snippet = text.slice(0, 120).replace(/\n/g, ' ');
+            const cause = error instanceof Error ? error.message : String(error);
+            throw new Error(`${context} 응답 JSON 파싱 실패: ${cause} (샘플: ${snippet})`);
+        }
+    }
+    /**
+     * Perform GET request
+     */
+    static async get(endpoint, params = null) {
+        const url = new URL(endpoint, window.location.origin);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== null && value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            });
+        }
+        const response = await fetch(url);
+        if (!response.ok) {
+            let errorMessage = `HTTP ${response.status}`;
+            try {
+                const errorData = await this.parseJsonResponse(response, `GET ${endpoint}`);
+                errorMessage = errorData.message || errorData.error || errorMessage;
+            }
+            catch (parseError) {
+                errorMessage = parseError instanceof Error ? parseError.message : String(parseError);
+            }
+            throw new Error(errorMessage);
+        }
+        return this.parseJsonResponse(response, `GET ${endpoint}`);
+    }
+    /**
+     * Perform POST request
+     * @param {string} endpoint - API endpoint
+     * @param {Object} body - Request body
+     * @returns {Promise<Object>} Response data
+     */
+    static async post(endpoint, body) {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            let errorMessage = `HTTP ${response.status}`;
+            try {
+                const errorData = await this.parseJsonResponse(response, `POST ${endpoint}`);
+                errorMessage = errorData.message || errorData.error || errorMessage;
+            }
+            catch (parseError) {
+                errorMessage = parseError instanceof Error ? parseError.message : String(parseError);
+            }
+            throw new Error(errorMessage);
+        }
+        return this.parseJsonResponse(response, `POST ${endpoint}`);
+    }
+    /**
+     * Perform PUT request
+     */
+    static async put(endpoint, body) {
+        const response = await fetch(endpoint, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            let errorMessage = `HTTP ${response.status}`;
+            try {
+                const errorData = await this.parseJsonResponse(response, `PUT ${endpoint}`);
+                errorMessage = errorData.message || errorData.error || errorMessage;
+            }
+            catch (parseError) {
+                errorMessage = parseError instanceof Error ? parseError.message : String(parseError);
+            }
+            throw new Error(errorMessage);
+        }
+        return this.parseJsonResponse(response, `PUT ${endpoint}`);
+    }
+    /**
+     * Perform DELETE request
+     */
+    static async del(endpoint) {
+        const response = await fetch(endpoint, { method: 'DELETE' });
+        if (!response.ok) {
+            let errorMessage = `HTTP ${response.status}`;
+            try {
+                const errorData = await this.parseJsonResponse(response, `DELETE ${endpoint}`);
+                errorMessage = errorData.message || errorData.error || errorMessage;
+            }
+            catch (parseError) {
+                errorMessage = parseError instanceof Error ? parseError.message : String(parseError);
+            }
+            throw new Error(errorMessage);
         }
-      });
+        return this.parseJsonResponse(response, `DELETE ${endpoint}`);
+    }
+    // =============================================
+    // Graph API
+    // =============================================
+    /**
+     * Get graph data
+     * @param {Object} params - Query parameters
+     * @returns {Promise<Object>} Graph data
+     */
+    static async getGraph(params = {}) {
+        // cluster: false by default to avoid slow embedding calculations
+        return this.get('/graph', { cluster: 'false', ...params });
+    }
+    /**
+     * Get similar decisions for a node
+     * @param {string} nodeId - Node ID
+     * @returns {Promise<Object>} Similar decisions
+     */
+    static async getSimilarDecisions(nodeId) {
+        return this.get('/graph/similar', { id: nodeId });
+    }
+    /**
+     * Update decision outcome
+     * @param {string} id - Decision ID
+     * @param {string} outcome - Outcome value
+     * @param {string} reason - Optional reason
+     * @returns {Promise<Object>} Update result
+     */
+    static async updateOutcome(id, outcome, reason = null) {
+        return this.post('/graph/update', { id, outcome, reason });
+    }
+    // =============================================
+    // Checkpoint API
+    // =============================================
+    /**
+     * Get all checkpoints
+     * @returns {Promise<Object>} Checkpoints data
+     */
+    static async getCheckpoints() {
+        return this.get('/checkpoints');
+    }
+    // =============================================
+    // MAMA Memory API
+    // =============================================
+    /**
+     * Search MAMA decisions
+     * @param {string} query - Search query
+     * @param {number} limit - Maximum results
+     * @returns {Promise<Object>} Search results
+     */
+    static async searchMemory(query, limit = 10) {
+        return this.get('/api/mama/search', { q: query, limit });
+    }
+    /**
+     * Save a new decision to MAMA
+     * @param {Object} data - Decision data
+     * @param {string} data.topic - Decision topic
+     * @param {string} data.decision - Decision text
+     * @param {string} data.reasoning - Reasoning text
+     * @param {number} data.confidence - Confidence (0-1)
+     * @returns {Promise<Object>} Save result
+     */
+    static async saveDecision(data) {
+        return this.post('/api/mama/save', data);
+    }
+    // =============================================
+    // Session API
+    // =============================================
+    /**
+     * Create a new chat session
+     * @param {string} projectDir - Project directory
+     * @returns {Promise<Object>} Session data
+     */
+    static async createSession(projectDir = '.') {
+        return this.post('/api/sessions', {
+            projectDir,
+        });
+    }
+    /**
+     * Get the last active session
+     * @returns {Promise<Object>} Last active session
+     */
+    static async getLastActiveSession() {
+        return this.get('/api/sessions/last-active');
+    }
+    /**
+     * Get all active sessions
+     * @returns {Promise<Object>} Sessions list
+     */
+    static async getSessions() {
+        return this.get('/api/sessions');
+    }
+    // =============================================
+    // Cron API
+    // =============================================
+    static async getCronJobs() {
+        return this.get('/api/cron');
+    }
+    static async updateCronJob(id, data) {
+        return this.put(`/api/cron/${encodeURIComponent(id)}`, data);
+    }
+    static async runCronJob(id) {
+        return this.post(`/api/cron/${encodeURIComponent(id)}/run`, {});
+    }
+    static async getCronLogs(id, limit = 5) {
+        return this.get(`/api/cron/${encodeURIComponent(id)}/logs`, { limit });
+    }
+    // =============================================
+    // Token API
+    // =============================================
+    static async getTokenSummary() {
+        return this.get('/api/tokens/summary');
+    }
+    static async getTokensByAgent() {
+        return this.get('/api/tokens/by-agent');
+    }
+    static async getTokensDaily(days = 30) {
+        return this.get('/api/tokens/daily', { days });
+    }
+    // =============================================
+    // Skills API
+    // =============================================
+    static async getSkills() {
+        return this.get('/api/skills');
+    }
+    static async getSkillCatalog(source = 'all') {
+        return this.get('/api/skills/catalog', { source });
+    }
+    static async searchSkills(query, source = 'all') {
+        return this.get('/api/skills/search', { q: query, source });
     }
-
-    const response = await fetch(url);
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new Error(error.message || `HTTP ${response.status}`);
+    static async installSkill(source, name) {
+        return this.post('/api/skills/install', { source, name });
     }
-
-    return response.json();
-  }
-
-  /**
-   * Perform POST request
-   * @param {string} endpoint - API endpoint
-   * @param {Object} body - Request body
-   * @returns {Promise<Object>} Response data
-   */
-  static async post(endpoint, body) {
-    const response = await fetch(endpoint, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(body),
-    });
-
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new Error(error.message || `HTTP ${response.status}`);
+    static async uninstallSkill(name, source = 'mama') {
+        return this.del(`/api/skills/${encodeURIComponent(name)}?source=${encodeURIComponent(source)}`);
     }
-
-    return response.json();
-  }
-
-  /**
-   * Perform PUT request
-   */
-  static async put(endpoint, body) {
-    const response = await fetch(endpoint, {
-      method: 'PUT',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(body),
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new Error(error.message || `HTTP ${response.status}`);
+    static async toggleSkill(name, enabled, source = 'mama') {
+        return this.put(`/api/skills/${encodeURIComponent(name)}`, { enabled, source });
     }
-    return response.json();
-  }
-
-  /**
-   * Perform DELETE request
-   */
-  static async del(endpoint) {
-    const response = await fetch(endpoint, { method: 'DELETE' });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new Error(error.message || `HTTP ${response.status}`);
+    static async getSkillContent(name, source = 'mama') {
+        return this.get(`/api/skills/${encodeURIComponent(name)}/readme`, { source });
     }
-    return response.json();
-  }
-
-  // =============================================
-  // Graph API
-  // =============================================
-
-  /**
-   * Get graph data
-   * @param {Object} params - Query parameters
-   * @returns {Promise<Object>} Graph data
-   */
-  static async getGraph(params = {}) {
-    // cluster: false by default to avoid slow embedding calculations
-    return this.get('/graph', { cluster: 'false', ...params });
-  }
-
-  /**
-   * Get similar decisions for a node
-   * @param {string} nodeId - Node ID
-   * @returns {Promise<Object>} Similar decisions
-   */
-  static async getSimilarDecisions(nodeId) {
-    return this.get('/graph/similar', { id: nodeId });
-  }
-
-  /**
-   * Update decision outcome
-   * @param {string} id - Decision ID
-   * @param {string} outcome - Outcome value
-   * @param {string} reason - Optional reason
-   * @returns {Promise<Object>} Update result
-   */
-  static async updateOutcome(id, outcome, reason = null) {
-    return this.post('/graph/update', { id, outcome, reason });
-  }
-
-  // =============================================
-  // Checkpoint API
-  // =============================================
-
-  /**
-   * Get all checkpoints
-   * @returns {Promise<Object>} Checkpoints data
-   */
-  static async getCheckpoints() {
-    return this.get('/checkpoints');
-  }
-
-  // =============================================
-  // MAMA Memory API
-  // =============================================
-
-  /**
-   * Search MAMA decisions
-   * @param {string} query - Search query
-   * @param {number} limit - Maximum results
-   * @returns {Promise<Object>} Search results
-   */
-  static async searchMemory(query, limit = 10) {
-    return this.get('/api/mama/search', { q: query, limit });
-  }
-
-  /**
-   * Save a new decision to MAMA
-   * @param {Object} data - Decision data
-   * @param {string} data.topic - Decision topic
-   * @param {string} data.decision - Decision text
-   * @param {string} data.reasoning - Reasoning text
-   * @param {number} data.confidence - Confidence (0-1)
-   * @returns {Promise<Object>} Save result
-   */
-  static async saveDecision(data) {
-    return this.post('/api/mama/save', data);
-  }
-
-  // =============================================
-  // Session API
-  // =============================================
-
-  /**
-   * Create a new chat session
-   * @param {string} projectDir - Project directory
-   * @returns {Promise<Object>} Session data
-   */
-  static async createSession(projectDir = '.') {
-    return this.post('/api/sessions', { projectDir });
-  }
-
-  /**
-   * Get the last active session
-   * @returns {Promise<Object|null>} Last active session or null
-   */
-  static async getLastActiveSession() {
-    try {
-      return await this.get('/api/sessions/last-active');
-    } catch {
-      return null;
+    static async installSkillFromUrl(url) {
+        return this.post('/api/skills/install-url', { url });
     }
-  }
-
-  /**
-   * Get all active sessions
-   * @returns {Promise<Object>} Sessions list
-   */
-  static async getSessions() {
-    return this.get('/api/sessions');
-  }
-
-  // =============================================
-  // Cron API
-  // =============================================
-
-  static async getCronJobs() {
-    return this.get('/api/cron');
-  }
-
-  static async updateCronJob(id, data) {
-    return this.put(`/api/cron/${id}`, data);
-  }
-
-  static async runCronJob(id) {
-    return this.post(`/api/cron/${id}/run`, {});
-  }
-
-  static async getCronLogs(id, limit = 5) {
-    return this.get(`/api/cron/${id}/logs`, { limit });
-  }
-
-  // =============================================
-  // Token API
-  // =============================================
-
-  static async getTokenSummary() {
-    return this.get('/api/tokens/summary');
-  }
-
-  static async getTokensByAgent() {
-    return this.get('/api/tokens/by-agent');
-  }
-
-  static async getTokensDaily(days = 30) {
-    return this.get('/api/tokens/daily', { days });
-  }
-
-  // =============================================
-  // Skills API
-  // =============================================
-
-  static async getSkills() {
-    return this.get('/api/skills');
-  }
-
-  static async getSkillCatalog(source = 'all') {
-    return this.get('/api/skills/catalog', { source });
-  }
-
-  static async searchSkills(query, source = 'all') {
-    return this.get('/api/skills/search', { q: query, source });
-  }
-
-  static async installSkill(source, name) {
-    return this.post('/api/skills/install', { source, name });
-  }
-
-  static async uninstallSkill(name, source = 'mama') {
-    return this.del(`/api/skills/${encodeURIComponent(name)}?source=${source}`);
-  }
-
-  static async toggleSkill(name, enabled, source = 'mama') {
-    return this.put(`/api/skills/${encodeURIComponent(name)}`, { enabled, source });
-  }
-
-  static async getSkillContent(name, source = 'mama') {
-    return this.get(`/api/skills/${encodeURIComponent(name)}/readme`, { source });
-  }
-
-  static async installSkillFromUrl(url) {
-    return this.post('/api/skills/install-url', { url });
-  }
 }

package/public/viewer/js/utils/debug-logger.js

@@ -1,34 +1,28 @@
 /* eslint-env browser */
-
 /**
  * Lightweight DebugLogger for viewer modules.
  * Mirrors mama-core DebugLogger behavior (no console.log usage).
  */
 export class DebugLogger {
-  constructor(context = 'Viewer') {
-    this.context = context;
-  }
-
-  _format(level, args) {
-    const ts = new Date().toISOString();
-    return [`[${ts}] [${this.context}] [${level}]`, ...args];
-  }
-
-  debug(...args) {
-    console.debug(...this._format('DEBUG', args));
-  }
-
-  info(...args) {
-    console.info(...this._format('INFO', args));
-  }
-
-  warn(...args) {
-    console.warn(...this._format('WARN', args));
-  }
-
-  error(...args) {
-    console.error(...this._format('ERROR', args));
-  }
+    context;
+    constructor(context = 'Viewer') {
+        this.context = String(context);
+    }
+    _format(level, args) {
+        const ts = new Date().toISOString();
+        return [`[${ts}] [${this.context}] [${level}]`, ...args];
+    }
+    debug(...args) {
+        console.debug(...this._format('DEBUG', args));
+    }
+    info(...args) {
+        console.info(...this._format('INFO', args));
+    }
+    warn(...args) {
+        console.warn(...this._format('WARN', args));
+    }
+    error(...args) {
+        console.error(...this._format('ERROR', args));
+    }
 }
-
 export default DebugLogger;