claude-soul-server 0.1.0

package/dist/util/files.d.ts

@@ -0,0 +1,20 @@
+import type { SoulConfig } from "../types/config-types.js";
+export declare const SOUL_DIR: string;
+export declare const DATA_DIR: string;
+export declare const FILES_DIR: string;
+export declare const SNAPSHOTS_DIR: string;
+export declare const REFLECTIONS_DIR: string;
+export declare const FRAMEWORKS_PATH: string;
+export declare const SESSION_LOG_PATH: string;
+export declare const STATE_PATH: string;
+export declare const TENSIONS_PATH: string;
+export declare const EXEMPLARS_PATH: string;
+export declare const LESSONS_PATH: string;
+export declare const META_PATH: string;
+export declare const CONFIG_PATH: string;
+export declare function ensureDirs(): Promise<void>;
+export declare function readJsonSafe<T>(filePath: string, fallback: T): Promise<T>;
+export declare function writeJsonAtomic(filePath: string, data: unknown): Promise<void>;
+export declare function readFileSafe(filePath: string): Promise<string>;
+export declare function loadConfig(): Promise<SoulConfig>;
+export declare function soulFilePath(name: string): string;

package/dist/util/files.js

@@ -0,0 +1,54 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { DEFAULT_CONFIG } from "../types/config-types.js";
+export const SOUL_DIR = path.join(os.homedir(), ".soul");
+export const DATA_DIR = path.join(SOUL_DIR, "data");
+export const FILES_DIR = path.join(SOUL_DIR, "files");
+export const SNAPSHOTS_DIR = path.join(DATA_DIR, "snapshots");
+export const REFLECTIONS_DIR = path.join(SOUL_DIR, "reflections");
+export const FRAMEWORKS_PATH = path.join(DATA_DIR, "frameworks.json");
+export const SESSION_LOG_PATH = path.join(DATA_DIR, "session-log.jsonl");
+export const STATE_PATH = path.join(DATA_DIR, "state.json");
+export const TENSIONS_PATH = path.join(DATA_DIR, "tensions.json");
+export const EXEMPLARS_PATH = path.join(DATA_DIR, "exemplars.json");
+export const LESSONS_PATH = path.join(DATA_DIR, "lessons.json");
+export const META_PATH = path.join(DATA_DIR, "meta.json");
+export const CONFIG_PATH = path.join(SOUL_DIR, "config.json");
+export async function ensureDirs() {
+    await fs.mkdir(DATA_DIR, { recursive: true });
+    await fs.mkdir(FILES_DIR, { recursive: true });
+    await fs.mkdir(SNAPSHOTS_DIR, { recursive: true });
+    await fs.mkdir(REFLECTIONS_DIR, { recursive: true });
+}
+export async function readJsonSafe(filePath, fallback) {
+    try {
+        const data = await fs.readFile(filePath, "utf-8");
+        return JSON.parse(data);
+    }
+    catch {
+        return fallback;
+    }
+}
+export async function writeJsonAtomic(filePath, data) {
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    const tmpPath = `${filePath}.tmp.${process.pid}`;
+    await fs.writeFile(tmpPath, JSON.stringify(data, null, 2), "utf-8");
+    await fs.rename(tmpPath, filePath);
+}
+export async function readFileSafe(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+export async function loadConfig() {
+    return readJsonSafe(CONFIG_PATH, DEFAULT_CONFIG);
+}
+export function soulFilePath(name) {
+    return path.join(FILES_DIR, name);
+}
+//# sourceMappingURL=files.js.map

package/dist/util/files.js.map

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

package/dist/util/llm.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Call Claude Code CLI in non-interactive mode.
+ * Uses existing Claude Code auth — no separate API key needed.
+ */
+export declare function callClaude(prompt: string, model: string, userMessage?: string): Promise<string>;
+export declare function parseLlmJson(raw: string): Record<string, unknown> | null;

package/dist/util/llm.js

@@ -0,0 +1,76 @@
+import fs from "node:fs/promises";
+/**
+ * Call Claude Code CLI in non-interactive mode.
+ * Uses existing Claude Code auth — no separate API key needed.
+ */
+export async function callClaude(prompt, model, userMessage = "Perform the task described in your system prompt. Respond with ONLY the JSON object. No other text.") {
+    const tmpPrompt = `/tmp/soul-prompt-${process.pid}-${Date.now()}.txt`;
+    await fs.writeFile(tmpPrompt, prompt, "utf-8");
+    const args = [
+        "-p", userMessage,
+        "--append-system-prompt-file", tmpPrompt,
+        "--model", model,
+        "--max-turns", "3",
+        "--output-format", "text",
+        "--no-session-persistence",
+    ];
+    try {
+        const { spawn } = await import("node:child_process");
+        const result = await new Promise((resolve, reject) => {
+            const proc = spawn("claude", args, {
+                stdio: ["pipe", "pipe", "pipe"],
+                env: { ...process.env, NO_COLOR: "1" },
+            });
+            proc.stdin.end();
+            const chunks = [];
+            const errChunks = [];
+            proc.stdout.on("data", (chunk) => chunks.push(chunk));
+            proc.stderr.on("data", (chunk) => errChunks.push(chunk));
+            const timer = setTimeout(() => {
+                proc.kill();
+                reject(new Error("claude CLI timed out after 8 minutes"));
+            }, 480_000);
+            proc.on("close", (code) => {
+                clearTimeout(timer);
+                const stdout = Buffer.concat(chunks).toString("utf-8");
+                const stderr = Buffer.concat(errChunks).toString("utf-8");
+                if (code !== 0 && !stdout.trim()) {
+                    reject(new Error(`claude CLI exited with code ${code}: ${stderr}`));
+                }
+                else {
+                    resolve(stdout);
+                }
+            });
+            proc.on("error", (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+        });
+        return result;
+    }
+    finally {
+        await fs.unlink(tmpPrompt).catch(() => { });
+    }
+}
+export function parseLlmJson(raw) {
+    let cleaned = raw.trim();
+    if (cleaned.startsWith("```")) {
+        cleaned = cleaned.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "");
+    }
+    try {
+        return JSON.parse(cleaned);
+    }
+    catch {
+        const match = cleaned.match(/\{[\s\S]*\}/);
+        if (match) {
+            try {
+                return JSON.parse(match[0]);
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/util/llm.js.map

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

package/dist/util/tokens.d.ts

@@ -0,0 +1 @@
+export declare function estimateTokens(content: string): number;

package/dist/util/tokens.js

@@ -0,0 +1,4 @@
+export function estimateTokens(content) {
+    return Math.ceil(content.length / 4);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/util/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/util/tokens.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "claude-soul-server",
+  "version": "0.1.0",
+  "description": "Self-improving learning engine for Claude Code — persistent identity, cross-session memory, and evolving cognitive frameworks",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "claude-soul-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "mcp",
+    "learning",
+    "persistence",
+    "identity",
+    "ai"
+  ],
+  "author": "DomDemetz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DomDemetz/claude-soul"
+  },
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}