chiasmus 0.1.0

package/dist/solvers/session.d.ts

@@ -0,0 +1,11 @@
+import type { SolverType, SolverInput, SolverResult } from "./types.js";
+export declare class SolverSession {
+    readonly id: string;
+    readonly solverType: SolverType;
+    private solver;
+    private constructor();
+    static create(type: SolverType): Promise<SolverSession>;
+    solve(input: SolverInput): Promise<SolverResult>;
+    dispose(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/solvers/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/solvers/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAU,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhF,qBAAa,aAAa;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;WAMM,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAOvD,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAItD,OAAO,IAAI,IAAI;CAGhB"}

package/dist/solvers/session.js

@@ -0,0 +1,25 @@
+import { randomUUID } from "node:crypto";
+import { createZ3Solver } from "./z3-solver.js";
+import { createPrologSolver } from "./prolog-solver.js";
+export class SolverSession {
+    id;
+    solverType;
+    solver;
+    constructor(id, solverType, solver) {
+        this.id = id;
+        this.solverType = solverType;
+        this.solver = solver;
+    }
+    static async create(type) {
+        const id = randomUUID();
+        const solver = type === "z3" ? await createZ3Solver() : createPrologSolver();
+        return new SolverSession(id, type, solver);
+    }
+    async solve(input) {
+        return this.solver.solve(input);
+    }
+    dispose() {
+        this.solver.dispose();
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/solvers/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/solvers/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,MAAM,OAAO,aAAa;IACf,EAAE,CAAS;IACX,UAAU,CAAa;IACxB,MAAM,CAAS;IAEvB,YAAoB,EAAU,EAAE,UAAsB,EAAE,MAAc;QACpE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAgB;QAClC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,MAAM,GACV,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;QAChE,OAAO,IAAI,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAkB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/solvers/types.d.ts

@@ -0,0 +1,44 @@
+/** Identifies which solver engine to use */
+export type SolverType = "z3" | "prolog";
+/** Result of a solver execution */
+export type SolverResult = {
+    status: "sat";
+    model: Record<string, string>;
+} | {
+    status: "unsat";
+} | {
+    status: "unknown";
+} | {
+    status: "success";
+    answers: PrologAnswer[];
+} | {
+    status: "error";
+    error: string;
+};
+/** A single Prolog query answer: variable bindings */
+export interface PrologAnswer {
+    bindings: Record<string, string>;
+    formatted: string;
+}
+/** Common interface for all solver backends */
+export interface Solver {
+    readonly type: SolverType;
+    /**
+     * Execute a formal specification and return a structured result.
+     * For Z3: input is SMT-LIB format.
+     * For Prolog: input is { program, query }.
+     */
+    solve(input: SolverInput): Promise<SolverResult>;
+    /** Clean up any resources held by this solver instance */
+    dispose(): void;
+}
+/** Input to a solver */
+export type SolverInput = {
+    type: "z3";
+    smtlib: string;
+} | {
+    type: "prolog";
+    program: string;
+    query: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/solvers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/solvers/types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,QAAQ,CAAC;AAEzC,mCAAmC;AACnC,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjD,0DAA0D;IAC1D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAwB;AACxB,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/solvers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/solvers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/solvers/types.ts"],"names":[],"mappings":""}

package/dist/solvers/z3-solver.d.ts

@@ -0,0 +1,3 @@
+import type { Solver } from "./types.js";
+export declare function createZ3Solver(): Promise<Solver>;
+//# sourceMappingURL=z3-solver.d.ts.map

package/dist/solvers/z3-solver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"z3-solver.d.ts","sourceRoot":"","sources":["../../src/solvers/z3-solver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAA6B,MAAM,YAAY,CAAC;AAuBpE,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAoEtD"}

package/dist/solvers/z3-solver.js

@@ -0,0 +1,81 @@
+import { init } from "z3-solver";
+// Cache Z3 WASM initialization — it loads ~30MB, should only happen once.
+let z3Promise = null;
+function getZ3() {
+    if (!z3Promise) {
+        z3Promise = init();
+    }
+    return z3Promise;
+}
+const SOLVER_TIMEOUT_MS = 30_000;
+/** Strip commands that we handle ourselves to avoid conflicts */
+function sanitizeSmtlib(input) {
+    return input
+        .replace(/\(\s*check-sat\s*\)/g, "")
+        .replace(/\(\s*get-model\s*\)/g, "")
+        .replace(/\(\s*exit\s*\)/g, "")
+        .trim();
+}
+export async function createZ3Solver() {
+    const z3 = await getZ3();
+    const ctx = z3.Context("main");
+    let disposed = false;
+    return {
+        type: "z3",
+        async solve(input) {
+            if (input.type !== "z3") {
+                return { status: "error", error: "Expected z3 input type" };
+            }
+            const smtlib = sanitizeSmtlib(input.smtlib);
+            if (!smtlib) {
+                return { status: "sat", model: {} };
+            }
+            const solver = new ctx.Solver();
+            try {
+                solver.fromString(smtlib);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                return { status: "error", error: msg };
+            }
+            let checkResult;
+            try {
+                const check = solver.check();
+                let timer;
+                const timeout = new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(new Error("solver timed out")), SOLVER_TIMEOUT_MS);
+                });
+                checkResult = await Promise.race([check, timeout]);
+                clearTimeout(timer);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                return { status: "error", error: msg };
+            }
+            if (checkResult === "unsat") {
+                return { status: "unsat" };
+            }
+            if (checkResult !== "sat") {
+                return { status: "unknown" };
+            }
+            try {
+                const model = solver.model();
+                const assignments = {};
+                for (const decl of model.decls()) {
+                    assignments[decl.name()] = model.eval(decl.call()).toString();
+                }
+                return { status: "sat", model: assignments };
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                return { status: "error", error: `Model extraction failed: ${msg}` };
+            }
+        },
+        dispose() {
+            if (!disposed) {
+                disposed = true;
+            }
+        },
+    };
+}
+//# sourceMappingURL=z3-solver.js.map

package/dist/solvers/z3-solver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"z3-solver.js","sourceRoot":"","sources":["../../src/solvers/z3-solver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,0EAA0E;AAC1E,IAAI,SAAS,GAAmC,IAAI,CAAC;AAErD,SAAS,KAAK;IACZ,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,iEAAiE;AACjE,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC;SACnC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC;SACnC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;SAC9B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC;IACzB,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO;QACL,IAAI,EAAE,IAAI;QAEV,KAAK,CAAC,KAAK,CAAC,KAAkB;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;YAC9D,CAAC;YAED,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACtC,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACzC,CAAC;YAED,IAAI,WAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,KAAoC,CAAC;gBACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;gBACrF,CAAC,CAAC,CAAC;gBACH,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;gBACnD,YAAY,CAAC,KAAM,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACzC,CAAC;YAED,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC7B,CAAC;YAED,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;gBAC1B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/B,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC7B,MAAM,WAAW,GAA2B,EAAE,CAAC;gBAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;oBACjC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChE,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;YAC/C,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,4BAA4B,GAAG,EAAE,EAAE,CAAC;YACvE,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "chiasmus",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Neurosymbolic verification engine - MCP server for formal reasoning with Z3 and Tau Prolog",
+  "main": "dist/mcp-server.js",
+  "types": "dist/mcp-server.d.ts",
+  "bin": {
+    "chiasmus": "dist/mcp-server.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/mcp-server.d.ts",
+      "default": "./dist/mcp-server.js"
+    },
+    "./solvers": {
+      "types": "./dist/solvers/types.d.ts",
+      "default": "./dist/solvers/types.js"
+    },
+    "./skills": {
+      "types": "./dist/skills/types.d.ts",
+      "default": "./dist/skills/types.js"
+    },
+    "./formalize": {
+      "types": "./dist/formalize/engine.d.ts",
+      "default": "./dist/formalize/engine.js"
+    },
+    "./llm": {
+      "types": "./dist/llm/types.d.ts",
+      "default": "./dist/llm/types.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "mcp": "tsx src/mcp-server.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "z3",
+    "prolog",
+    "formal-verification",
+    "neurosymbolic",
+    "smt",
+    "solver",
+    "model-context-protocol",
+    "claude",
+    "llm"
+  ],
+  "license": "Apache-2.0",
+  "author": "yogthos",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yogthos/chiasmus.git"
+  },
+  "homepage": "https://github.com/yogthos/chiasmus#readme",
+  "bugs": {
+    "url": "https://github.com/yogthos/chiasmus/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^12.8.0",
+    "tau-prolog": "^0.3.4",
+    "z3-solver": "^4.16.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}