@arcadialdev/arcality 2.4.25 → 2.4.27

package/src/arcalityClient.mjs

@@ -1,266 +1,266 @@
-// src/arcalityClient.mjs
-// Client for communicating with Arcality Backend
-// Supports arcality.config (primary) and .env (fallback)
-// Includes MOCK MODE for development without backend
-import fs from 'node:fs';
-import path from 'node:path';
-import { getApiKey, getApiUrl, CONFIG_DIR } from './configLoader.mjs';
-
-// ── Backend config (internal, not user-configurable) ──
-const DAILY_MISSION_LIMIT = 50;
-const USAGE_FILE = path.join(CONFIG_DIR, 'usage.json');
-
-// ═══════════════════════════════════════════════════════
-// MOCK MODE: Local simulation (no backend)
-// Tracks daily usage in ~/.arcality/usage.json
-// ═══════════════════════════════════════════════════════
-
-function getTodayKey() {
-    return new Date().toISOString().slice(0, 10);
-}
-
-function loadLocalUsage() {
-    try {
-        if (fs.existsSync(USAGE_FILE)) {
-            return JSON.parse(fs.readFileSync(USAGE_FILE, 'utf8'));
-        }
-    } catch { }
-    return {};
-}
-
-function saveLocalUsage(usage) {
-    try {
-        if (!fs.existsSync(CONFIG_DIR)) {
-            fs.mkdirSync(CONFIG_DIR, { recursive: true });
-        }
-        fs.writeFileSync(USAGE_FILE, JSON.stringify(usage, null, 2), 'utf8');
-    } catch { }
-}
-
-function getLocalDailyUsage() {
-    const usage = loadLocalUsage();
-    const today = getTodayKey();
-    return usage[today] || 0;
-}
-
-function incrementLocalUsage() {
-    const usage = loadLocalUsage();
-    const today = getTodayKey();
-    usage[today] = (usage[today] || 0) + 1;
-
-    const keys = Object.keys(usage).sort().reverse();
-    const cleaned = {};
-    for (const k of keys.slice(0, 7)) {
-        cleaned[k] = usage[k];
-    }
-    saveLocalUsage(cleaned);
-    return cleaned[today];
-}
-
-// ═══════════════════════════════════════════════════════
-// ARCALITY CONFIG LOADER (for reading arcality.config directly)
-// ═══════════════════════════════════════════════════════
-
-function loadArcalityConfig() {
-    try {
-        const configPath = path.join(process.cwd(), 'arcality.config');
-        if (fs.existsSync(configPath)) {
-            let raw = fs.readFileSync(configPath, 'utf8');
-            if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1);
-            return JSON.parse(raw);
-        }
-    } catch { }
-    return null;
-}
-
-/**
- * Gets the effective API base URL.
- * Uses the internal getApiUrl() — NOT configurable by user.
- */
-function getEffectiveApiBase() {
-    return getApiUrl();
-}
-
-/**
- * Gets the effective API Key.
- * Priority: arcality.config > env > global config
- */
-function getEffectiveApiKey() {
-    const localConfig = loadArcalityConfig();
-    if (localConfig?.apiKey) return localConfig.apiKey;
-
-    const { key } = getApiKey();
-    return key;
-}
-
-// ═══════════════════════════════════════════════════════
-// PUBLIC API
-// ═══════════════════════════════════════════════════════
-
-/**
- * ArcalityClient class — used by KnowledgeService and other modules.
- */
-export class ArcalityClient {
-    constructor(apiKey) {
-        this.apiUrl = getApiUrl();
-        this.apiKey = apiKey;
-    }
-}
-
-/**
- * Validates the API Key.
- * - If backend is available (ARCALITY_API_URL) → validates remotely
- * - If no backend → mock mode with local validation
- */
-export async function validateApiKey() {
-    const key = getEffectiveApiKey();
-
-    if (!key) {
-        return { valid: false, error: 'no_api_key', mode: 'mock' };
-    }
-
-    if (!key.startsWith('arc_k_')) {
-        return { valid: false, error: 'invalid_format', mode: 'mock' };
-    }
-
-    const apiBase = getEffectiveApiBase();
-
-    // ── LIVE mode: Backend available ──
-    if (apiBase) {
-        try {
-            const res = await fetch(`${apiBase}/api/v1/auth/validate`, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'x-api-key': key
-                }
-            });
-
-            if (res.status === 401) return { valid: false, error: 'invalid_api_key', mode: 'live' };
-            if (res.status === 403) return { valid: false, error: 'plan_expired', mode: 'live' };
-            if (!res.ok) return { valid: false, error: 'server_error', mode: 'live' };
-
-            const data = await res.json();
-            return { ...data, valid: true, mode: 'live' };
-        } catch {
-            console.warn('⚠️  Backend not available, using local mode');
-        }
-    }
-
-    // ── MOCK mode: No backend ──
-    const dailyUsed = getLocalDailyUsage();
-    return {
-        valid: true,
-        mode: 'mock',
-        plan: 'internal',
-        daily_used: dailyUsed,
-        daily_limit: DAILY_MISSION_LIMIT,
-        remaining: Math.max(0, DAILY_MISSION_LIMIT - dailyUsed)
-    };
-}
-
-/**
- * Requests to start a mission.
- * @param {string} prompt - The mission prompt (only a hash is sent, never the raw text)
- * @param {string} targetUrl - Target portal URL
- */
-export async function startMission(prompt, targetUrl) {
-    const key = getEffectiveApiKey();
-    if (!key) return { allowed: false, error: 'no_api_key' };
-
-    const apiBase = getEffectiveApiBase();
-
-    // ── LIVE mode ──
-    if (apiBase) {
-        try {
-            const projectId = process.env.ARCALITY_PROJECT_ID || loadArcalityConfig()?.projectId;
-
-            const res = await fetch(`${apiBase}/api/v1/missions/start`, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'x-api-key': key
-                },
-                body: JSON.stringify({
-                    prompt_hash: simpleHash(prompt),
-                    target_url: targetUrl,
-                    project_id: projectId || undefined,
-                })
-            });
-
-            if (res.status === 429) {
-                const data = await res.json();
-                return { allowed: false, error: 'mission_limit_exceeded', ...data };
-            }
-            if (!res.ok) return { allowed: false, error: 'server_error' };
-
-            return { allowed: true, ...(await res.json()) };
-        } catch {
-            // Fallback to mock if backend is down
-        }
-    }
-
-    // ── MOCK mode ──
-    const dailyUsed = getLocalDailyUsage();
-
-    if (dailyUsed >= DAILY_MISSION_LIMIT) {
-        const tomorrow = new Date();
-        tomorrow.setDate(tomorrow.getDate() + 1);
-        tomorrow.setHours(0, 0, 0, 0);
-
-        return {
-            allowed: false,
-            error: 'mission_limit_exceeded',
-            daily_used: dailyUsed,
-            daily_limit: DAILY_MISSION_LIMIT,
-            remaining: 0,
-            resets_at: tomorrow.toISOString()
-        };
-    }
-
-    const newCount = incrementLocalUsage();
-    return {
-        allowed: true,
-        mode: 'mock',
-        mission_id: `mock_${Date.now().toString(36)}`,
-        daily_used: newCount,
-        daily_limit: DAILY_MISSION_LIMIT,
-        remaining: DAILY_MISSION_LIMIT - newCount
-    };
-}
-
-/**
- * Marks a mission as completed.
- * @param {string} missionId
- * @param {'success'|'failed'|'cancelled'} result
- */
-export async function endMission(missionId, result) {
-    const apiBase = getEffectiveApiBase();
-    if (!apiBase || !missionId) return { ok: true };
-
-    const key = getEffectiveApiKey();
-    try {
-        await fetch(`${apiBase}/api/v1/missions/${missionId}/end`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'x-api-key': key
-            },
-            body: JSON.stringify({ result })
-        });
-    } catch { }
-    return { ok: true };
-}
-
-/**
- * Simple hash of the prompt — we never send the raw text to backend
- */
-function simpleHash(str) {
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-        const char = str.charCodeAt(i);
-        hash = ((hash << 5) - hash) + char;
-        hash |= 0;
-    }
-    return 'ph_' + Math.abs(hash).toString(36);
-}
+// src/arcalityClient.mjs
+// Client for communicating with Arcality Backend
+// Supports arcality.config (primary) and .env (fallback)
+// Includes MOCK MODE for development without backend
+import fs from 'node:fs';
+import path from 'node:path';
+import { getApiKey, getApiUrl, CONFIG_DIR } from './configLoader.mjs';
+
+// ── Backend config (internal, not user-configurable) ──
+const DAILY_MISSION_LIMIT = 50;
+const USAGE_FILE = path.join(CONFIG_DIR, 'usage.json');
+
+// ═══════════════════════════════════════════════════════
+// MOCK MODE: Local simulation (no backend)
+// Tracks daily usage in ~/.arcality/usage.json
+// ═══════════════════════════════════════════════════════
+
+function getTodayKey() {
+    return new Date().toISOString().slice(0, 10);
+}
+
+function loadLocalUsage() {
+    try {
+        if (fs.existsSync(USAGE_FILE)) {
+            return JSON.parse(fs.readFileSync(USAGE_FILE, 'utf8'));
+        }
+    } catch { }
+    return {};
+}
+
+function saveLocalUsage(usage) {
+    try {
+        if (!fs.existsSync(CONFIG_DIR)) {
+            fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        fs.writeFileSync(USAGE_FILE, JSON.stringify(usage, null, 2), 'utf8');
+    } catch { }
+}
+
+function getLocalDailyUsage() {
+    const usage = loadLocalUsage();
+    const today = getTodayKey();
+    return usage[today] || 0;
+}
+
+function incrementLocalUsage() {
+    const usage = loadLocalUsage();
+    const today = getTodayKey();
+    usage[today] = (usage[today] || 0) + 1;
+
+    const keys = Object.keys(usage).sort().reverse();
+    const cleaned = {};
+    for (const k of keys.slice(0, 7)) {
+        cleaned[k] = usage[k];
+    }
+    saveLocalUsage(cleaned);
+    return cleaned[today];
+}
+
+// ═══════════════════════════════════════════════════════
+// ARCALITY CONFIG LOADER (for reading arcality.config directly)
+// ═══════════════════════════════════════════════════════
+
+function loadArcalityConfig() {
+    try {
+        const configPath = path.join(process.cwd(), 'arcality.config');
+        if (fs.existsSync(configPath)) {
+            let raw = fs.readFileSync(configPath, 'utf8');
+            if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1);
+            return JSON.parse(raw);
+        }
+    } catch { }
+    return null;
+}
+
+/**
+ * Gets the effective API base URL.
+ * Uses the internal getApiUrl() — NOT configurable by user.
+ */
+function getEffectiveApiBase() {
+    return getApiUrl();
+}
+
+/**
+ * Gets the effective API Key.
+ * Priority: arcality.config > env > global config
+ */
+function getEffectiveApiKey() {
+    const localConfig = loadArcalityConfig();
+    if (localConfig?.apiKey) return localConfig.apiKey;
+
+    const { key } = getApiKey();
+    return key;
+}
+
+// ═══════════════════════════════════════════════════════
+// PUBLIC API
+// ═══════════════════════════════════════════════════════
+
+/**
+ * ArcalityClient class — used by KnowledgeService and other modules.
+ */
+export class ArcalityClient {
+    constructor(apiKey) {
+        this.apiUrl = getApiUrl();
+        this.apiKey = apiKey;
+    }
+}
+
+/**
+ * Validates the API Key.
+ * - If backend is available (ARCALITY_API_URL) → validates remotely
+ * - If no backend → mock mode with local validation
+ */
+export async function validateApiKey() {
+    const key = getEffectiveApiKey();
+
+    if (!key) {
+        return { valid: false, error: 'no_api_key', mode: 'mock' };
+    }
+
+    if (!key.startsWith('arc_k_')) {
+        return { valid: false, error: 'invalid_format', mode: 'mock' };
+    }
+
+    const apiBase = getEffectiveApiBase();
+
+    // ── LIVE mode: Backend available ──
+    if (apiBase) {
+        try {
+            const res = await fetch(`${apiBase}/api/v1/auth/validate`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-api-key': key
+                }
+            });
+
+            if (res.status === 401) return { valid: false, error: 'invalid_api_key', mode: 'live' };
+            if (res.status === 403) return { valid: false, error: 'plan_expired', mode: 'live' };
+            if (!res.ok) return { valid: false, error: 'server_error', mode: 'live' };
+
+            const data = await res.json();
+            return { ...data, valid: true, mode: 'live' };
+        } catch {
+            console.warn('⚠️  Backend not available, using local mode');
+        }
+    }
+
+    // ── MOCK mode: No backend ──
+    const dailyUsed = getLocalDailyUsage();
+    return {
+        valid: true,
+        mode: 'mock',
+        plan: 'internal',
+        daily_used: dailyUsed,
+        daily_limit: DAILY_MISSION_LIMIT,
+        remaining: Math.max(0, DAILY_MISSION_LIMIT - dailyUsed)
+    };
+}
+
+/**
+ * Requests to start a mission.
+ * @param {string} prompt - The mission prompt (only a hash is sent, never the raw text)
+ * @param {string} targetUrl - Target portal URL
+ */
+export async function startMission(prompt, targetUrl) {
+    const key = getEffectiveApiKey();
+    if (!key) return { allowed: false, error: 'no_api_key' };
+
+    const apiBase = getEffectiveApiBase();
+
+    // ── LIVE mode ──
+    if (apiBase) {
+        try {
+            const projectId = process.env.ARCALITY_PROJECT_ID || loadArcalityConfig()?.projectId;
+
+            const res = await fetch(`${apiBase}/api/v1/missions/start`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-api-key': key
+                },
+                body: JSON.stringify({
+                    prompt_hash: simpleHash(prompt),
+                    target_url: targetUrl,
+                    project_id: projectId || undefined,
+                })
+            });
+
+            if (res.status === 429) {
+                const data = await res.json();
+                return { allowed: false, error: 'mission_limit_exceeded', ...data };
+            }
+            if (!res.ok) return { allowed: false, error: 'server_error' };
+
+            return { allowed: true, ...(await res.json()) };
+        } catch {
+            // Fallback to mock if backend is down
+        }
+    }
+
+    // ── MOCK mode ──
+    const dailyUsed = getLocalDailyUsage();
+
+    if (dailyUsed >= DAILY_MISSION_LIMIT) {
+        const tomorrow = new Date();
+        tomorrow.setDate(tomorrow.getDate() + 1);
+        tomorrow.setHours(0, 0, 0, 0);
+
+        return {
+            allowed: false,
+            error: 'mission_limit_exceeded',
+            daily_used: dailyUsed,
+            daily_limit: DAILY_MISSION_LIMIT,
+            remaining: 0,
+            resets_at: tomorrow.toISOString()
+        };
+    }
+
+    const newCount = incrementLocalUsage();
+    return {
+        allowed: true,
+        mode: 'mock',
+        mission_id: `mock_${Date.now().toString(36)}`,
+        daily_used: newCount,
+        daily_limit: DAILY_MISSION_LIMIT,
+        remaining: DAILY_MISSION_LIMIT - newCount
+    };
+}
+
+/**
+ * Marks a mission as completed.
+ * @param {string} missionId
+ * @param {'success'|'failed'|'cancelled'} result
+ */
+export async function endMission(missionId, result) {
+    const apiBase = getEffectiveApiBase();
+    if (!apiBase || !missionId) return { ok: true };
+
+    const key = getEffectiveApiKey();
+    try {
+        await fetch(`${apiBase}/api/v1/missions/${missionId}/end`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': key
+            },
+            body: JSON.stringify({ result })
+        });
+    } catch { }
+    return { ok: true };
+}
+
+/**
+ * Simple hash of the prompt — we never send the raw text to backend
+ */
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash |= 0;
+    }
+    return 'ph_' + Math.abs(hash).toString(36);
+}