agent-working-memory 0.3.0

package/dist/api/routes.js

@@ -0,0 +1,388 @@
+/**
+ * API Routes — the black box interface agents interact with.
+ *
+ * Core (agent-facing):
+ *   POST /memory/write       — write a memory (salience filter decides disposition)
+ *   POST /memory/activate    — retrieve by context activation
+ *   POST /memory/feedback    — report whether a memory was useful
+ *   POST /memory/retract     — invalidate a wrong memory
+ *
+ * Checkpointing:
+ *   POST /memory/checkpoint        — save explicit execution state
+ *   GET  /memory/restore/:agentId  — restore state + targeted recall + async mini-consolidation
+ *
+ * Task management:
+ *   POST /task/create         — create a prioritized task
+ *   POST /task/update         — update status, priority, or blocking
+ *   GET  /task/list/:agentId  — list tasks (filtered by status)
+ *   GET  /task/next/:agentId  — get highest-priority actionable task
+ *
+ * Diagnostic (debugging/eval):
+ *   POST /memory/search      — deterministic search (not cognitive)
+ *   GET  /memory/:id         — get a specific engram
+ *   GET  /agent/:id/stats    — memory stats for an agent
+ *   GET  /agent/:id/metrics  — eval metrics
+ *   POST /agent/register     — register a new agent
+ *
+ * System:
+ *   POST /system/evict       — trigger eviction check
+ *   POST /system/decay       — trigger edge decay
+ *   POST /system/consolidate — run sleep cycle (strengthen, decay, sweep)
+ *   GET  /health             — health check
+ */
+import { evaluateSalience } from '../core/salience.js';
+import { DEFAULT_AGENT_CONFIG } from '../types/agent.js';
+import { embed } from '../core/embeddings.js';
+export function registerRoutes(app, deps) {
+    const { store, activationEngine, connectionEngine, evictionEngine, retractionEngine, evalEngine, consolidationEngine, consolidationScheduler } = deps;
+    // ============================================================
+    // CORE — Agent-facing endpoints
+    // ============================================================
+    app.post('/memory/write', async (req, reply) => {
+        const body = req.body;
+        const salience = evaluateSalience({
+            content: body.content,
+            eventType: body.eventType,
+            surprise: body.surprise,
+            decisionMade: body.decisionMade,
+            causalDepth: body.causalDepth,
+            resolutionEffort: body.resolutionEffort,
+        });
+        if (salience.disposition === 'discard') {
+            return reply.code(200).send({
+                stored: false,
+                disposition: 'discard',
+                salience: salience.score,
+                reasonCodes: salience.reasonCodes,
+            });
+        }
+        const engram = store.createEngram({
+            agentId: body.agentId,
+            concept: body.concept,
+            content: body.content,
+            tags: body.tags,
+            salience: salience.score,
+            confidence: body.confidence,
+            salienceFeatures: salience.features,
+            reasonCodes: salience.reasonCodes,
+            ttl: salience.disposition === 'staging' ? DEFAULT_AGENT_CONFIG.stagingTtlMs : undefined,
+        });
+        if (salience.disposition === 'staging') {
+            store.updateStage(engram.id, 'staging');
+        }
+        // Create temporal adjacency edge to previous memory (conversation thread graph)
+        // This enables multi-hop graph walk through conversation sequences
+        try {
+            const prev = store.getLatestEngram(body.agentId, engram.id);
+            if (prev) {
+                store.upsertAssociation(prev.id, engram.id, 0.3, 'temporal', 0.8);
+            }
+        }
+        catch { /* Temporal edge creation is non-fatal */ }
+        if (salience.disposition === 'active') {
+            connectionEngine.enqueue(engram.id);
+            // Auto-assign to episode (1-hour window per agent)
+            try {
+                let episode = store.getActiveEpisode(body.agentId, 3600_000);
+                if (!episode) {
+                    episode = store.createEpisode({ agentId: body.agentId, label: body.concept });
+                }
+                store.addEngramToEpisode(engram.id, episode.id);
+            }
+            catch { /* Episode assignment is non-fatal */ }
+        }
+        // Generate embedding asynchronously (don't block response)
+        embed(`${body.concept} ${body.content}`).then(vec => {
+            store.updateEmbedding(engram.id, vec);
+        }).catch(() => { }); // Embedding failure is non-fatal
+        // Auto-checkpoint: track write for consolidation scheduling
+        try {
+            store.updateAutoCheckpointWrite(body.agentId, engram.id);
+        }
+        catch { /* non-fatal */ }
+        return reply.code(201).send({
+            stored: true,
+            disposition: salience.disposition,
+            salience: salience.score,
+            reasonCodes: salience.reasonCodes,
+            engram,
+        });
+    });
+    app.post('/memory/activate', async (req, reply) => {
+        const body = req.body;
+        const results = await activationEngine.activate({
+            agentId: body.agentId,
+            context: body.context,
+            limit: body.limit,
+            minScore: body.minScore,
+            includeStaging: body.includeStaging,
+            useReranker: body.useReranker,
+            useExpansion: body.useExpansion,
+            abstentionThreshold: body.abstentionThreshold,
+        });
+        // Auto-checkpoint: track recall for consolidation scheduling
+        try {
+            const ids = results.map(r => r.engram.id);
+            store.updateAutoCheckpointRecall(body.agentId, body.context, ids);
+        }
+        catch { /* non-fatal */ }
+        return reply.send({ results });
+    });
+    app.post('/memory/feedback', async (req, reply) => {
+        const body = req.body;
+        store.logRetrievalFeedback(body.activationEventId ?? null, body.engramId, body.useful, body.context ?? '');
+        // Update engram confidence based on feedback
+        const engram = store.getEngram(body.engramId);
+        if (engram) {
+            const config = DEFAULT_AGENT_CONFIG;
+            const delta = body.useful
+                ? config.feedbackPositiveBoost
+                : -config.feedbackNegativePenalty;
+            store.updateConfidence(engram.id, engram.confidence + delta);
+        }
+        // Touch activity for consolidation scheduling
+        if (engram) {
+            try {
+                store.touchActivity(engram.agentId);
+            }
+            catch { /* non-fatal */ }
+        }
+        return reply.send({ recorded: true });
+    });
+    app.post('/memory/retract', async (req, reply) => {
+        const body = req.body;
+        const result = retractionEngine.retract({
+            agentId: body.agentId,
+            targetEngramId: body.targetEngramId,
+            reason: body.reason,
+            counterContent: body.counterContent,
+        });
+        // Touch activity for consolidation scheduling
+        try {
+            store.touchActivity(body.agentId);
+        }
+        catch { /* non-fatal */ }
+        return reply.send(result);
+    });
+    // ============================================================
+    // DIAGNOSTIC — Debugging and inspection
+    // ============================================================
+    app.post('/memory/search', async (req, reply) => {
+        const body = req.body;
+        const results = store.search({
+            agentId: body.agentId,
+            text: body.text,
+            concept: body.concept,
+            tags: body.tags,
+            stage: body.stage,
+            retracted: body.retracted,
+            limit: body.limit,
+            offset: body.offset,
+        });
+        return reply.send({ results, count: results.length });
+    });
+    app.get('/memory/:id', async (req, reply) => {
+        const { id } = req.params;
+        const engram = store.getEngram(id);
+        if (!engram)
+            return reply.code(404).send({ error: 'Not found' });
+        const associations = store.getAssociationsFor(id);
+        return reply.send({ engram, associations });
+    });
+    app.get('/agent/:id/stats', async (req, reply) => {
+        const { id } = req.params;
+        const active = store.getEngramsByAgent(id, 'active');
+        const staging = store.getEngramsByAgent(id, 'staging');
+        const retracted = store.getEngramsByAgent(id, undefined, true).filter(e => e.retracted);
+        const associations = store.getAllAssociations(id);
+        return reply.send({
+            agentId: id,
+            engrams: {
+                active: active.length,
+                staging: staging.length,
+                retracted: retracted.length,
+                total: active.length + staging.length + retracted.length,
+            },
+            associations: associations.length,
+            avgConfidence: active.length > 0
+                ? +(active.reduce((s, e) => s + e.confidence, 0) / active.length).toFixed(3)
+                : 0,
+        });
+    });
+    app.get('/agent/:id/metrics', async (req, reply) => {
+        const { id } = req.params;
+        const windowHours = parseInt(req.query.window ?? '24', 10);
+        const metrics = evalEngine.computeMetrics(id, windowHours);
+        return reply.send({ metrics });
+    });
+    app.post('/agent/register', async (req, reply) => {
+        const body = req.body;
+        const id = crypto.randomUUID();
+        return reply.code(201).send({
+            id,
+            name: body.name,
+            config: DEFAULT_AGENT_CONFIG,
+        });
+    });
+    // ============================================================
+    // SYSTEM — Maintenance operations
+    // ============================================================
+    app.post('/system/evict', async (req, reply) => {
+        const body = req.body;
+        const result = evictionEngine.enforceCapacity(body.agentId, DEFAULT_AGENT_CONFIG);
+        return reply.send(result);
+    });
+    app.post('/system/decay', async (req, reply) => {
+        const body = req.body;
+        const decayed = evictionEngine.decayEdges(body.agentId, body.halfLifeDays);
+        return reply.send({ edgesDecayed: decayed });
+    });
+    app.post('/system/consolidate', async (req, reply) => {
+        const body = req.body;
+        const result = consolidationEngine.consolidate(body.agentId);
+        return reply.send(result);
+    });
+    // ============================================================
+    // CHECKPOINTING — Conscious state preservation
+    // ============================================================
+    app.post('/memory/checkpoint', async (req, reply) => {
+        const body = req.body;
+        const state = {
+            currentTask: body.currentTask,
+            decisions: body.decisions ?? [],
+            activeFiles: body.activeFiles ?? [],
+            nextSteps: body.nextSteps ?? [],
+            relatedMemoryIds: body.relatedMemoryIds ?? [],
+            notes: body.notes ?? '',
+            episodeId: body.episodeId ?? null,
+        };
+        store.saveCheckpoint(body.agentId, state);
+        return reply.send({ saved: true, agentId: body.agentId });
+    });
+    app.get('/memory/restore/:agentId', async (req, reply) => {
+        const { agentId } = req.params;
+        const checkpoint = store.getCheckpoint(agentId);
+        const now = Date.now();
+        const idleMs = checkpoint
+            ? now - checkpoint.auto.lastActivityAt.getTime()
+            : 0;
+        // Get last written engram for context
+        let lastWrite = null;
+        if (checkpoint?.auto.lastWriteId) {
+            const engram = store.getEngram(checkpoint.auto.lastWriteId);
+            if (engram) {
+                lastWrite = { id: engram.id, concept: engram.concept, content: engram.content };
+            }
+        }
+        // Recall memories using last context (if available)
+        let recalledMemories = [];
+        const recallContext = checkpoint?.auto.lastRecallContext
+            ?? checkpoint?.executionState?.currentTask
+            ?? null;
+        if (recallContext) {
+            try {
+                const results = await activationEngine.activate({
+                    agentId,
+                    context: recallContext,
+                    limit: 5,
+                    minScore: 0.05,
+                    useReranker: true,
+                    useExpansion: true,
+                });
+                recalledMemories = results.map(r => ({
+                    id: r.engram.id,
+                    concept: r.engram.concept,
+                    content: r.engram.content,
+                    score: r.score,
+                }));
+            }
+            catch { /* recall failure is non-fatal */ }
+        }
+        // Trigger mini-consolidation if idle >5min (async, fire-and-forget)
+        const MINI_CONSOLIDATION_IDLE_MS = 5 * 60_000;
+        let miniConsolidationTriggered = false;
+        if (idleMs > MINI_CONSOLIDATION_IDLE_MS) {
+            miniConsolidationTriggered = true;
+            consolidationScheduler.runMiniConsolidation(agentId).catch(() => { });
+        }
+        return reply.send({
+            executionState: checkpoint?.executionState ?? null,
+            checkpointAt: checkpoint?.checkpointAt ?? null,
+            recalledMemories,
+            lastWrite,
+            idleMs,
+            miniConsolidationTriggered,
+        });
+    });
+    // ============================================================
+    // TASK MANAGEMENT
+    // ============================================================
+    app.post('/task/create', async (req, reply) => {
+        const body = req.body;
+        const engram = store.createEngram({
+            agentId: body.agentId,
+            concept: body.concept,
+            content: body.content,
+            tags: [...(body.tags ?? []), 'task'],
+            salience: 0.9,
+            confidence: 0.8,
+            salienceFeatures: {
+                surprise: 0.5, decisionMade: true, causalDepth: 0.5,
+                resolutionEffort: 0.5, eventType: 'decision',
+            },
+            reasonCodes: ['task-created'],
+            taskStatus: body.blockedBy ? 'blocked' : 'open',
+            taskPriority: body.priority ?? 'medium',
+            blockedBy: body.blockedBy,
+        });
+        connectionEngine.enqueue(engram.id);
+        embed(`${body.concept} ${body.content}`).then(vec => {
+            store.updateEmbedding(engram.id, vec);
+        }).catch(() => { });
+        return reply.send(engram);
+    });
+    app.post('/task/update', async (req, reply) => {
+        const body = req.body;
+        const engram = store.getEngram(body.taskId);
+        if (!engram || !engram.taskStatus) {
+            return reply.code(404).send({ error: 'Task not found' });
+        }
+        if (body.blockedBy !== undefined) {
+            store.updateBlockedBy(body.taskId, body.blockedBy);
+        }
+        if (body.status) {
+            store.updateTaskStatus(body.taskId, body.status);
+        }
+        if (body.priority) {
+            store.updateTaskPriority(body.taskId, body.priority);
+        }
+        return reply.send(store.getEngram(body.taskId));
+    });
+    app.get('/task/list/:agentId', async (req, reply) => {
+        const { agentId } = req.params;
+        const { status, includeDone } = req.query;
+        let tasks = store.getTasks(agentId, status);
+        if (includeDone !== 'true' && !status) {
+            tasks = tasks.filter(t => t.taskStatus !== 'done');
+        }
+        return reply.send({ tasks, count: tasks.length });
+    });
+    app.get('/task/next/:agentId', async (req, reply) => {
+        const { agentId } = req.params;
+        const next = store.getNextTask(agentId);
+        return reply.send(next ? { task: next } : { task: null, message: 'No actionable tasks' });
+    });
+    // Time warp — shift all timestamps backward by N days (for testing)
+    app.post('/system/time-warp', async (req, reply) => {
+        const body = req.body;
+        const ms = body.days * 24 * 60 * 60 * 1000;
+        const shifted = store.timeWarp(body.agentId, ms);
+        return reply.send({ shifted, days: body.days });
+    });
+    app.get('/health', async () => ({
+        status: 'ok',
+        timestamp: new Date().toISOString(),
+        version: '0.3.0',
+    }));
+}
+//# sourceMappingURL=routes.js.map

package/dist/api/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAWH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAa9C,MAAM,UAAU,cAAc,CAAC,GAAoB,EAAE,IAAgB;IACnE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAAC;IAEtJ,+DAA+D;IAC/D,gCAAgC;IAChC,+DAA+D;IAE/D,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAWhB,CAAC;QAEF,MAAM,QAAQ,GAAG,gBAAgB,CAAC;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,KAAK;gBACb,WAAW,EAAE,SAAS;gBACtB,QAAQ,EAAE,QAAQ,CAAC,KAAK;gBACxB,WAAW,EAAE,QAAQ,CAAC,WAAW;aAClC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,QAAQ,CAAC,KAAK;YACxB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,gBAAgB,EAAE,QAAQ,CAAC,QAAQ;YACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,GAAG,EAAE,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;SACxF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACvC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;QAED,gFAAgF;QAChF,mEAAmE;QACnE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5D,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,yCAAyC,CAAC,CAAC;QAErD,IAAI,QAAQ,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACtC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEpC,mDAAmD;YACnD,IAAI,CAAC;gBACH,IAAI,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAChF,CAAC;gBACD,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC,CAAC,qCAAqC,CAAC,CAAC;QACnD,CAAC;QAED,2DAA2D;QAC3D,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAClD,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,iCAAiC;QAErD,4DAA4D;QAC5D,IAAI,CAAC;YAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;QAE3F,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,KAAK;YACxB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG,GAAG,CAAC,IAShB,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;SAC9C,CAAC,CAAC;QAEH,6DAA6D;QAC7D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1C,KAAK,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;QAE3B,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG,GAAG,CAAC,IAKhB,CAAC;QAEF,KAAK,CAAC,oBAAoB,CACxB,IAAI,CAAC,iBAAiB,IAAI,IAAI,EAC9B,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,IAAI,EAAE,CACnB,CAAC;QAEF,6CAA6C;QAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,oBAAoB,CAAC;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM;gBACvB,CAAC,CAAC,MAAM,CAAC,qBAAqB;gBAC9B,CAAC,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC;YACpC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC;QAC/D,CAAC;QAED,8CAA8C;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,IAKhB,CAAC;QAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC;YACtC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC,CAAC;QAEH,8CAA8C;QAC9C,IAAI,CAAC;YAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;QAEpE,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,wCAAwC;IACxC,+DAA+D;IAE/D,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,IAShB,CAAC;QAEF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAY;YACxB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC1C,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC,MAAwB,CAAC;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QAEjE,MAAM,YAAY,GAAG,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC,MAAwB,CAAC;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,KAAK,CAAC,iBAAiB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,KAAK,CAAC,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACxF,MAAM,YAAY,GAAG,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAElD,OAAO,KAAK,CAAC,IAAI,CAAC;YAChB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE;gBACP,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM;aACzD;YACD,YAAY,EAAE,YAAY,CAAC,MAAM;YACjC,aAAa,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;gBAC9B,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC5E,CAAC,CAAC,CAAC;SACN,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACjD,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC,MAAwB,CAAC;QAC5C,MAAM,WAAW,GAAG,QAAQ,CAAE,GAAG,CAAC,KAAa,CAAC,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAwB,CAAC;QAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YAC1B,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,oBAAoB;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,kCAAkC;IAClC,+DAA+D;IAE/D,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAA2B,CAAC;QAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAClF,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAkD,CAAC;QACpE,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,IAA2B,CAAC;QAC7C,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,+CAA+C;IAC/C,+DAA+D;IAE/D,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,GAAG,CAAC,IAShB,CAAC;QAEF,MAAM,KAAK,GAAmB;YAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;YAC/B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;YAC/B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;YAC7C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;SAClC,CAAC;QAEF,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACvD,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAA6B,CAAC;QACtD,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEhD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,UAAU;YACvB,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAChD,CAAC,CAAC,CAAC,CAAC;QAEN,sCAAsC;QACtC,IAAI,SAAS,GAA4D,IAAI,CAAC;QAC9E,IAAI,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5D,IAAI,MAAM,EAAE,CAAC;gBACX,SAAS,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAClF,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,IAAI,gBAAgB,GAA2E,EAAE,CAAC;QAClG,MAAM,aAAa,GAAG,UAAU,EAAE,IAAI,CAAC,iBAAiB;eACnD,UAAU,EAAE,cAAc,EAAE,WAAW;eACvC,IAAI,CAAC;QAEV,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC;oBAC9C,OAAO;oBACP,OAAO,EAAE,aAAa;oBACtB,KAAK,EAAE,CAAC;oBACR,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,IAAI;oBACjB,YAAY,EAAE,IAAI;iBACnB,CAAC,CAAC;gBACH,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACnC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;oBACf,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;oBACzB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;oBACzB,KAAK,EAAE,CAAC,CAAC,KAAK;iBACf,CAAC,CAAC,CAAC;YACN,CAAC;YAAC,MAAM,CAAC,CAAC,iCAAiC,CAAC,CAAC;QAC/C,CAAC;QAED,oEAAoE;QACpE,MAAM,0BAA0B,GAAG,CAAC,GAAG,MAAM,CAAC;QAC9C,IAAI,0BAA0B,GAAG,KAAK,CAAC;QACvC,IAAI,MAAM,GAAG,0BAA0B,EAAE,CAAC;YACxC,0BAA0B,GAAG,IAAI,CAAC;YAClC,sBAAsB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC;YAChB,cAAc,EAAE,UAAU,EAAE,cAAc,IAAI,IAAI;YAClD,YAAY,EAAE,UAAU,EAAE,YAAY,IAAI,IAAI;YAC9C,gBAAgB;YAChB,SAAS;YACT,MAAM;YACN,0BAA0B;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,kBAAkB;IAClB,+DAA+D;IAE/D,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,IAOhB,CAAC;QAEF,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC;YACpC,QAAQ,EAAE,GAAG;YACb,UAAU,EAAE,GAAG;YACf,gBAAgB,EAAE;gBAChB,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG;gBACnD,gBAAgB,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU;aAC7C;YACD,WAAW,EAAE,CAAC,cAAc,CAAC;YAC7B,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YAC/C,YAAY,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;YACvC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAClD,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,IAKhB,CAAC;QAEF,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAA6B,CAAC;QACtD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,KAAsD,CAAC;QAE3F,IAAI,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,WAAW,KAAK,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAA6B,CAAC;QACtD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,oEAAoE;IACpE,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACjD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAyC,CAAC;QAC3D,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * CLI entrypoint for AgentWorkingMemory.
+ *
+ * Commands:
+ *   awm setup    — configure MCP for the current project
+ *   awm mcp      — start the MCP server (called by Claude Code)
+ *   awm serve    — start the HTTP API server
+ *   awm health   — check if a running server is healthy
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/dist/cli.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+/**
+ * CLI entrypoint for AgentWorkingMemory.
+ *
+ * Commands:
+ *   awm setup    — configure MCP for the current project
+ *   awm mcp      — start the MCP server (called by Claude Code)
+ *   awm serve    — start the HTTP API server
+ *   awm health   — check if a running server is healthy
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { resolve, basename, join, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Load .env if present
+try {
+    const envPath = resolve(process.cwd(), '.env');
+    const envContent = readFileSync(envPath, 'utf-8');
+    for (const line of envContent.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const val = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, '');
+        if (!process.env[key])
+            process.env[key] = val;
+    }
+}
+catch { /* No .env file */ }
+const args = process.argv.slice(2);
+const command = args[0];
+function printUsage() {
+    console.log(`
+AgentWorkingMemory — Cognitive memory for AI agents
+
+Usage:
+  awm setup [--agent-id <id>] [--db-path <path>] [--no-claude-md]
+                                                    Configure MCP for current project
+  awm mcp                                           Start MCP server (used by Claude Code)
+  awm serve [--port <port>]                         Start HTTP API server
+  awm health [--port <port>]                        Check server health
+
+Setup:
+  Run 'awm setup' in your project directory. This creates .mcp.json
+  and appends workflow instructions to CLAUDE.md so Claude Code
+  automatically connects to your memory layer.
+
+  Use --no-claude-md to skip CLAUDE.md modification.
+  Restart Claude Code after setup to pick up the new MCP server.
+`.trim());
+}
+// ─── SETUP ──────────────────────────────────────
+function setup() {
+    const cwd = process.cwd();
+    const projectName = basename(cwd).toLowerCase().replace(/[^a-z0-9-]/g, '-');
+    // Parse flags
+    let agentId = projectName;
+    let dbPath = null;
+    let skipClaudeMd = false;
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === '--agent-id' && args[i + 1]) {
+            agentId = args[++i];
+        }
+        else if (args[i] === '--db-path' && args[i + 1]) {
+            dbPath = args[++i];
+        }
+        else if (args[i] === '--no-claude-md') {
+            skipClaudeMd = true;
+        }
+    }
+    // Find the package root (where src/mcp.ts lives)
+    const packageRoot = resolve(__dirname, '..');
+    const mcpScript = join(packageRoot, 'src', 'mcp.ts');
+    const mcpDist = join(packageRoot, 'dist', 'mcp.js');
+    // Determine DB path — default to <awm-root>/data/memory.db (shared across projects)
+    if (!dbPath) {
+        dbPath = join(packageRoot, 'data', 'memory.db');
+    }
+    const dbDir = dirname(dbPath);
+    // Ensure data directory exists
+    if (!existsSync(dbDir)) {
+        mkdirSync(dbDir, { recursive: true });
+        console.log(`Created data directory: ${dbDir}`);
+    }
+    // Determine command based on platform and whether dist exists
+    const isWindows = process.platform === 'win32';
+    const hasDist = existsSync(mcpDist);
+    let mcpConfig;
+    if (hasDist) {
+        // Use compiled JS (faster startup, no tsx needed)
+        mcpConfig = {
+            command: 'node',
+            args: [mcpDist.replace(/\\/g, '/')],
+            env: {
+                AWM_DB_PATH: dbPath.replace(/\\/g, '/'),
+                AWM_AGENT_ID: agentId,
+            },
+        };
+    }
+    else if (isWindows) {
+        mcpConfig = {
+            command: 'cmd',
+            args: ['/c', 'npx', 'tsx', mcpScript.replace(/\\/g, '/')],
+            env: {
+                AWM_DB_PATH: dbPath.replace(/\\/g, '/'),
+                AWM_AGENT_ID: agentId,
+            },
+        };
+    }
+    else {
+        mcpConfig = {
+            command: 'npx',
+            args: ['tsx', mcpScript],
+            env: {
+                AWM_DB_PATH: dbPath,
+                AWM_AGENT_ID: agentId,
+            },
+        };
+    }
+    // Read or create .mcp.json
+    const mcpJsonPath = join(cwd, '.mcp.json');
+    let existing = { mcpServers: {} };
+    if (existsSync(mcpJsonPath)) {
+        try {
+            existing = JSON.parse(readFileSync(mcpJsonPath, 'utf-8'));
+            if (!existing.mcpServers)
+                existing.mcpServers = {};
+        }
+        catch {
+            existing = { mcpServers: {} };
+        }
+    }
+    existing.mcpServers['agent-working-memory'] = mcpConfig;
+    writeFileSync(mcpJsonPath, JSON.stringify(existing, null, 2) + '\n');
+    // Auto-append CLAUDE.md snippet unless --no-claude-md
+    let claudeMdAction = '';
+    const claudeMdSnippet = `
+
+## Memory (AWM)
+You have persistent memory via the agent-working-memory MCP server.
+- At conversation start: call memory_restore to recover previous context
+- When you learn something important: call memory_write
+- When you need past context: call memory_recall
+- Before long operations: call memory_checkpoint to save your state
+- After using a recalled memory: call memory_feedback (useful/not-useful)
+- To retract incorrect info: call memory_retract
+- To manage tasks: call memory_task_add, memory_task_update, memory_task_list, memory_task_next
+`;
+    const claudeMdPath = join(cwd, 'CLAUDE.md');
+    if (skipClaudeMd) {
+        claudeMdAction = '  CLAUDE.md: skipped (--no-claude-md)';
+    }
+    else if (existsSync(claudeMdPath)) {
+        const content = readFileSync(claudeMdPath, 'utf-8');
+        if (content.includes('## Memory (AWM)')) {
+            claudeMdAction = '  CLAUDE.md: already has AWM section (skipped)';
+        }
+        else {
+            writeFileSync(claudeMdPath, content.trimEnd() + '\n' + claudeMdSnippet);
+            claudeMdAction = '  CLAUDE.md: appended AWM workflow section';
+        }
+    }
+    else {
+        writeFileSync(claudeMdPath, `# ${basename(cwd)}\n${claudeMdSnippet}`);
+        claudeMdAction = '  CLAUDE.md: created with AWM workflow section';
+    }
+    console.log(`
+AWM configured for: ${cwd}
+
+  Agent ID:   ${agentId}
+  DB path:    ${dbPath}
+  MCP config: ${mcpJsonPath}
+${claudeMdAction}
+
+Next steps:
+  1. Restart Claude Code to pick up the MCP server
+  2. The memory tools will appear automatically
+`.trim());
+}
+// ─── MCP ──────────────────────────────────────
+async function mcp() {
+    // Dynamic import to avoid loading heavy deps for setup/health commands
+    await import('./mcp.js');
+}
+// ─── SERVE ──────────────────────────────────────
+async function serve() {
+    // Parse --port flag
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === '--port' && args[i + 1]) {
+            process.env.AWM_PORT = args[++i];
+        }
+    }
+    await import('./index.js');
+}
+// ─── HEALTH ──────────────────────────────────────
+function health() {
+    let port = '8400';
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === '--port' && args[i + 1]) {
+            port = args[++i];
+        }
+    }
+    try {
+        const result = execSync(`curl -sf http://localhost:${port}/health`, {
+            encoding: 'utf8',
+            timeout: 5000,
+        });
+        const data = JSON.parse(result);
+        console.log(`OK — v${data.version} (${data.timestamp})`);
+    }
+    catch {
+        console.error(`Cannot reach AWM server on port ${port}`);
+        process.exit(1);
+    }
+}
+// ─── Dispatch ──────────────────────────────────────
+switch (command) {
+    case 'setup':
+        setup();
+        break;
+    case 'mcp':
+        mcp();
+        break;
+    case 'serve':
+        serve();
+        break;
+    case 'health':
+        health();
+        break;
+    case '--help':
+    case '-h':
+    case undefined:
+        printUsage();
+        break;
+    default:
+        console.error(`Unknown command: ${command}`);
+        printUsage();
+        process.exit(1);
+}
+//# sourceMappingURL=cli.js.map