@coralai/nps-cli 0.1.0

package/dist/session/session-store.d.ts

@@ -0,0 +1,29 @@
+import type { Logger } from 'pino';
+export interface SessionRecord {
+    v: 1;
+    sessionId: string;
+    compatHash: string;
+    profile: string;
+    lastEventId?: string;
+    lastSeenAt: string;
+}
+export declare class SessionStore {
+    private readonly stateDir;
+    private logger;
+    /** LRU cache of recent eventIds per channel (last 100 per channel). */
+    private recentEvents;
+    private static readonly LRU;
+    constructor(stateDir: string, logger?: Logger);
+    private fileFor;
+    /** Read stored record for a channel, or undefined if absent / corrupt. */
+    get(channelId: string): SessionRecord | undefined;
+    /** Atomic write: .tmp + fsync + rename. Mode 0600. */
+    put(channelId: string, rec: Omit<SessionRecord, 'v' | 'lastSeenAt'> & {
+        lastSeenAt?: string;
+    }): void;
+    /** Drop the session for a channel (used by /reset or compat mismatch). */
+    delete(channelId: string): void;
+    /** Returns true if the eventId was already processed for this channel. */
+    hasSeenEvent(channelId: string, eventId: string): boolean;
+}
+//# sourceMappingURL=session-store.d.ts.map

package/dist/session/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/session/session-store.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IAOrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,MAAM,CAAS;IACvB,uEAAuE;IACvE,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAO;gBAGf,QAAQ,EAAE,MAAM,EACjC,MAAM,CAAC,EAAE,MAAM;IAMjB,OAAO,CAAC,OAAO;IAMf,0EAA0E;IAC1E,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAiBjD,sDAAsD;IACtD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,GAAG,GAAG,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAuCpG,0EAA0E;IAC1E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAS/B,0EAA0E;IAC1E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAQ1D"}

package/dist/session/session-store.js

@@ -0,0 +1,123 @@
+/**
+ * M6 — SessionStore.
+ *
+ * One JSON file per channel under `~/.nps/state/`.
+ *   ~/.nps/state/<channelId-sanitized>.json
+ *
+ * Atomic write: write to .tmp + fsync + rename. Mode 0600.
+ *
+ * Schema:
+ *   { v: 1, sessionId, compatHash, profile, lastEventId, lastSeenAt }
+ *
+ * eventId dedupe: simple in-memory LRU + check against stored lastEventId.
+ */
+import { existsSync, mkdirSync, openSync, fsyncSync, closeSync, renameSync, readFileSync, writeSync, chmodSync, unlinkSync, } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { getLogger } from '../logger.js';
+export class SessionStore {
+    stateDir;
+    logger;
+    /** LRU cache of recent eventIds per channel (last 100 per channel). */
+    recentEvents = new Map();
+    static LRU = 100;
+    constructor(stateDir, logger) {
+        this.stateDir = stateDir;
+        this.logger = logger ?? getLogger('session-store');
+        mkdirSync(this.stateDir, { recursive: true });
+    }
+    fileFor(channelId) {
+        // Sanitize channelId for filesystem path (Matrix room IDs contain `!`, `:`).
+        const safe = channelId.replace(/[^a-zA-Z0-9._-]/g, '_');
+        return join(this.stateDir, `${safe}.json`);
+    }
+    /** Read stored record for a channel, or undefined if absent / corrupt. */
+    get(channelId) {
+        const path = this.fileFor(channelId);
+        if (!existsSync(path))
+            return undefined;
+        try {
+            const raw = readFileSync(path, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object' && parsed.v === 1 && typeof parsed.sessionId === 'string') {
+                return parsed;
+            }
+            this.logger.warn({ channelId, path }, 'unexpected session record shape — treating as missing');
+            return undefined;
+        }
+        catch (e) {
+            this.logger.warn({ channelId, path, err: e instanceof Error ? e.message : e }, 'corrupt session JSON — treating as missing (fresh start)');
+            return undefined;
+        }
+    }
+    /** Atomic write: .tmp + fsync + rename. Mode 0600. */
+    put(channelId, rec) {
+        const path = this.fileFor(channelId);
+        const tmp = `${path}.tmp`;
+        const full = {
+            v: 1,
+            sessionId: rec.sessionId,
+            compatHash: rec.compatHash,
+            profile: rec.profile,
+            ...(rec.lastEventId !== undefined ? { lastEventId: rec.lastEventId } : {}),
+            lastSeenAt: rec.lastSeenAt ?? new Date().toISOString(),
+        };
+        const json = JSON.stringify(full, null, 2);
+        try {
+            mkdirSync(dirname(tmp), { recursive: true });
+            const fd = openSync(tmp, 'w', 0o600);
+            try {
+                writeSync(fd, json + '\n');
+                fsyncSync(fd);
+            }
+            finally {
+                closeSync(fd);
+            }
+            renameSync(tmp, path);
+            try {
+                chmodSync(path, 0o600);
+            }
+            catch { /* best-effort */ }
+            // Track lastEventId in LRU for dedupe
+            if (full.lastEventId) {
+                const list = this.recentEvents.get(channelId) ?? [];
+                list.push(full.lastEventId);
+                if (list.length > SessionStore.LRU)
+                    list.shift();
+                this.recentEvents.set(channelId, list);
+            }
+        }
+        catch (e) {
+            // best-effort cleanup of .tmp
+            try {
+                unlinkSync(tmp);
+            }
+            catch { /* ignore */ }
+            this.logger.error({ err: e instanceof Error ? e.message : e, channelId, path }, 'session put failed');
+            throw e;
+        }
+    }
+    /** Drop the session for a channel (used by /reset or compat mismatch). */
+    delete(channelId) {
+        const path = this.fileFor(channelId);
+        if (existsSync(path)) {
+            try {
+                unlinkSync(path);
+            }
+            catch (e) {
+                this.logger.warn({ err: e instanceof Error ? e.message : e, channelId }, 'delete failed');
+            }
+        }
+        this.recentEvents.delete(channelId);
+    }
+    /** Returns true if the eventId was already processed for this channel. */
+    hasSeenEvent(channelId, eventId) {
+        // Check in-memory LRU first
+        const list = this.recentEvents.get(channelId);
+        if (list?.includes(eventId))
+            return true;
+        // Also check stored record's lastEventId
+        const rec = this.get(channelId);
+        return rec?.lastEventId === eventId;
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session/session-store.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const NPS_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const NPS_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@coralai/nps-cli",
+  "version": "0.1.0",
+  "description": "Local Linux daemon hosting per-DM Claude Code agents accessible via Matrix",
+  "type": "module",
+  "main": "dist/main.js",
+  "bin": {
+    "nps": "dist/main.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://git.wymsn.com/coral/jarvis-skills.git",
+    "directory": "nps-cli"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "linux"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/main.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "claude",
+    "agent",
+    "matrix",
+    "im",
+    "daemon"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@coralai/claude-code-agent": "^0.2.0",
+    "chokidar": "^5.0.0",
+    "pino": "^10.3.1",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "matrix-js-sdk": "^41.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.2"
+  }
+}