moltblock 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Henrique Veiga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/config/code_entity_graph.json

@@ -0,0 +1,12 @@
+{
+  "nodes": [
+    {"id": "generator", "role": "generator", "binding": "generator"},
+    {"id": "critic", "role": "critic", "binding": "critic"},
+    {"id": "judge", "role": "judge", "binding": "judge"}
+  ],
+  "edges": [
+    {"from": "generator", "to": "critic"},
+    {"from": "critic", "to": "judge"}
+  ],
+  "final_node": "judge"
+}

package/dist/agents.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Agents: Generator, Critic, Judge. Each uses LLMGateway and reads/writes WorkingMemory.
+ */
+import { LLMGateway } from "./gateway.js";
+import { WorkingMemory } from "./memory.js";
+import { Store } from "./persistence.js";
+/**
+ * Generator: task -> draft artifact (code).
+ */
+export declare function runGenerator(gateway: LLMGateway, memory: WorkingMemory, store?: Store | null): Promise<void>;
+/**
+ * Critic: draft + task -> critique.
+ */
+export declare function runCritic(gateway: LLMGateway, memory: WorkingMemory, store?: Store | null): Promise<void>;
+/**
+ * Judge: task + draft + critique -> final candidate artifact.
+ */
+export declare function runJudge(gateway: LLMGateway, memory: WorkingMemory, store?: Store | null): Promise<void>;
+/**
+ * Run a single role with task and inputs (node_id -> content from predecessors).
+ * Returns the role's output string. Used by the graph runner.
+ */
+export declare function runRole(role: string, gateway: LLMGateway, task: string, inputs: Record<string, string>, longTermContext?: string, store?: Store | null): Promise<string>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAe,MAAM,kBAAkB,CAAC;AA0BtD;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,aAAa,EACrB,KAAK,GAAE,KAAK,GAAG,IAAW,GACzB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,aAAa,EACrB,KAAK,GAAE,KAAK,GAAG,IAAW,GACzB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,aAAa,EACrB,KAAK,GAAE,KAAK,GAAG,IAAW,GACzB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,eAAe,SAAK,EACpB,KAAK,GAAE,KAAK,GAAG,IAAW,GACzB,OAAO,CAAC,MAAM,CAAC,CA0DjB"}

package/dist/agents.js

@@ -0,0 +1,124 @@
+/**
+ * Agents: Generator, Critic, Judge. Each uses LLMGateway and reads/writes WorkingMemory.
+ */
+import { getStrategy } from "./persistence.js";
+// Default prompts; can be overridden by strategy store (recursive improvement)
+// Note: Prompts updated to produce TypeScript instead of Python
+const CODE_GENERATOR_SYSTEM = `You are the Generator for a Code Entity. You produce a single TypeScript implementation that satisfies the user's task. Output only valid TypeScript code, no markdown fences or extra commentary. The code will be reviewed by a Critic and then verified by running tests.`;
+const CODE_CRITIC_SYSTEM = `You are the Critic. Review the draft code for bugs, edge cases, and style. Be concise. List specific issues and suggestions. Do not rewrite the code; only critique.`;
+const CODE_JUDGE_SYSTEM = `You are the Judge. Given the task, the draft code, and the critique, produce the final single TypeScript implementation. Output only valid TypeScript code, no markdown fences or extra commentary. Incorporate the critic's feedback. The result will be run through vitest.`;
+function systemPrompt(role, store) {
+    if (store) {
+        const s = getStrategy(store, role);
+        if (s) {
+            return s;
+        }
+    }
+    const defaults = {
+        generator: CODE_GENERATOR_SYSTEM,
+        critic: CODE_CRITIC_SYSTEM,
+        judge: CODE_JUDGE_SYSTEM,
+    };
+    return defaults[role] ?? CODE_GENERATOR_SYSTEM;
+}
+/**
+ * Generator: task -> draft artifact (code).
+ */
+export async function runGenerator(gateway, memory, store = null) {
+    let userContent = memory.task;
+    if (memory.longTermContext) {
+        userContent = userContent + "\n\nRelevant verified knowledge:\n" + memory.longTermContext;
+    }
+    const system = systemPrompt("generator", store);
+    const messages = [
+        { role: "system", content: system },
+        { role: "user", content: userContent },
+    ];
+    const draft = await gateway.complete(messages);
+    memory.setDraft(draft.trim());
+}
+/**
+ * Critic: draft + task -> critique.
+ */
+export async function runCritic(gateway, memory, store = null) {
+    const system = systemPrompt("critic", store);
+    const messages = [
+        { role: "system", content: system },
+        { role: "user", content: `Task:\n${memory.task}\n\nDraft code:\n${memory.draft}` },
+    ];
+    const critique = await gateway.complete(messages);
+    memory.setCritique(critique.trim());
+}
+/**
+ * Judge: task + draft + critique -> final candidate artifact.
+ */
+export async function runJudge(gateway, memory, store = null) {
+    const system = systemPrompt("judge", store);
+    const messages = [
+        { role: "system", content: system },
+        {
+            role: "user",
+            content: `Task:\n${memory.task}\n\nDraft:\n${memory.draft}\n\nCritique:\n${memory.critique}`,
+        },
+    ];
+    const final = await gateway.complete(messages);
+    memory.setFinalCandidate(final.trim());
+}
+/**
+ * Run a single role with task and inputs (node_id -> content from predecessors).
+ * Returns the role's output string. Used by the graph runner.
+ */
+export async function runRole(role, gateway, task, inputs, longTermContext = "", store = null) {
+    let userContent = task;
+    if (longTermContext) {
+        userContent = task + "\n\nRelevant verified knowledge:\n" + longTermContext;
+    }
+    if (role === "generator") {
+        const system = systemPrompt("generator", store);
+        const messages = [
+            { role: "system", content: system },
+            { role: "user", content: userContent },
+        ];
+        return (await gateway.complete(messages)).trim();
+    }
+    if (role === "critic") {
+        const draft = inputs["generator"] ?? "";
+        let content = `Task:\n${task}\n\nDraft code:\n${draft}`;
+        if (longTermContext) {
+            content = content + "\n\nRelevant verified knowledge:\n" + longTermContext;
+        }
+        const system = systemPrompt("critic", store);
+        const messages = [
+            { role: "system", content: system },
+            { role: "user", content: content },
+        ];
+        return (await gateway.complete(messages)).trim();
+    }
+    if (role === "judge") {
+        const draft = inputs["generator"] ?? "";
+        const critique = inputs["critic"] ?? "";
+        let content = `Task:\n${task}\n\nDraft:\n${draft}\n\nCritique:\n${critique}`;
+        if (longTermContext) {
+            content = content + "\n\nRelevant verified knowledge:\n" + longTermContext;
+        }
+        const system = systemPrompt("judge", store);
+        const messages = [
+            { role: "system", content: system },
+            { role: "user", content: content },
+        ];
+        return (await gateway.complete(messages)).trim();
+    }
+    if (role === "router") {
+        // Passthrough: route to first pipeline (single pipeline = no-op)
+        const messages = [
+            {
+                role: "system",
+                content: "You are a Router. Classify the task in one word: code, research, or other. Reply with only that word.",
+            },
+            { role: "user", content: task },
+        ];
+        return (await gateway.complete(messages)).trim();
+    }
+    throw new Error(`Unknown role for graph: ${role}`);
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI: run one Code Entity task.
+ */
+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":";AACA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * CLI: run one Code Entity task.
+ */
+import fs from "node:fs";
+import { program } from "commander";
+import { CodeEntity } from "./entity.js";
+import { defaultCodeEntityBindings } from "./config.js";
+async function main() {
+    program
+        .name("moltblock")
+        .description("Moltblock Code Entity — one task through the loop.")
+        .argument("<task>", "Task description (e.g. 'Implement a function add(a,b) that returns a+b.')")
+        .option("-t, --test <path>", "Path to file containing test code (e.g. vitest test module). If omitted, only syntax check.")
+        .option("--json", "Output result as JSON (draft, critique, final, verification_passed, authoritative_artifact).")
+        .action(async (task, options) => {
+        let testCode;
+        if (options.test && fs.existsSync(options.test)) {
+            testCode = fs.readFileSync(options.test, "utf-8");
+        }
+        const entity = new CodeEntity(defaultCodeEntityBindings());
+        const memory = await entity.run(task, { testCode });
+        if (options.json) {
+            const out = {
+                verification_passed: memory.verificationPassed,
+                verification_evidence: memory.verificationEvidence,
+                authoritative_artifact: memory.verificationPassed
+                    ? memory.authoritativeArtifact
+                    : null,
+                draft: memory.draft,
+                critique: memory.critique,
+                final_candidate: memory.finalCandidate,
+            };
+            console.log(JSON.stringify(out, null, 2));
+        }
+        else {
+            console.log("=== Draft ===");
+            console.log(memory.draft);
+            console.log("\n=== Critique ===");
+            console.log(memory.critique);
+            console.log("\n=== Final candidate ===");
+            console.log(memory.finalCandidate);
+            console.log("\n=== Verification ===");
+            console.log(memory.verificationPassed ? "Passed:" : "Failed:", memory.verificationPassed);
+            console.log(memory.verificationEvidence);
+            if (memory.verificationPassed && memory.authoritativeArtifact) {
+                console.log("\n=== Authoritative artifact ===");
+                console.log(memory.authoritativeArtifact);
+            }
+        }
+    });
+    await program.parseAsync(process.argv);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,135 @@
+/**
+ * LLM gateway config: per-role model binding.
+ * Load from JSON (moltblock.json), with env overrides.
+ */
+import { z } from "zod";
+export declare const BindingEntrySchema: z.ZodObject<{
+    backend: z.ZodString;
+    base_url: z.ZodString;
+    model: z.ZodDefault<z.ZodString>;
+    api_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    model: string;
+    backend: string;
+    base_url: string;
+    api_key?: string | null | undefined;
+}, {
+    backend: string;
+    base_url: string;
+    model?: string | undefined;
+    api_key?: string | null | undefined;
+}>;
+export type BindingEntry = z.infer<typeof BindingEntrySchema>;
+export declare const AgentConfigSchema: z.ZodObject<{
+    bindings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        backend: z.ZodString;
+        base_url: z.ZodString;
+        model: z.ZodDefault<z.ZodString>;
+        api_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        backend: string;
+        base_url: string;
+        api_key?: string | null | undefined;
+    }, {
+        backend: string;
+        base_url: string;
+        model?: string | undefined;
+        api_key?: string | null | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    bindings?: Record<string, {
+        model: string;
+        backend: string;
+        base_url: string;
+        api_key?: string | null | undefined;
+    }> | undefined;
+}, {
+    bindings?: Record<string, {
+        backend: string;
+        base_url: string;
+        model?: string | undefined;
+        api_key?: string | null | undefined;
+    }> | undefined;
+}>;
+export type AgentConfig = z.infer<typeof AgentConfigSchema>;
+export declare const MoltblockConfigSchema: z.ZodObject<{
+    agent: z.ZodOptional<z.ZodObject<{
+        bindings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            backend: z.ZodString;
+            base_url: z.ZodString;
+            model: z.ZodDefault<z.ZodString>;
+            api_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            model: string;
+            backend: string;
+            base_url: string;
+            api_key?: string | null | undefined;
+        }, {
+            backend: string;
+            base_url: string;
+            model?: string | undefined;
+            api_key?: string | null | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        bindings?: Record<string, {
+            model: string;
+            backend: string;
+            base_url: string;
+            api_key?: string | null | undefined;
+        }> | undefined;
+    }, {
+        bindings?: Record<string, {
+            backend: string;
+            base_url: string;
+            model?: string | undefined;
+            api_key?: string | null | undefined;
+        }> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    agent?: {
+        bindings?: Record<string, {
+            model: string;
+            backend: string;
+            base_url: string;
+            api_key?: string | null | undefined;
+        }> | undefined;
+    } | undefined;
+}, {
+    agent?: {
+        bindings?: Record<string, {
+            backend: string;
+            base_url: string;
+            model?: string | undefined;
+            api_key?: string | null | undefined;
+        }> | undefined;
+    } | undefined;
+}>;
+export type MoltblockConfig = z.infer<typeof MoltblockConfigSchema>;
+export declare const ModelBindingSchema: z.ZodObject<{
+    backend: z.ZodString;
+    baseUrl: z.ZodString;
+    apiKey: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    model: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    model: string;
+    backend: string;
+    baseUrl: string;
+    apiKey: string | null;
+}, {
+    backend: string;
+    baseUrl: string;
+    model?: string | undefined;
+    apiKey?: string | null | undefined;
+}>;
+export type ModelBinding = z.infer<typeof ModelBindingSchema>;
+/**
+ * Load and parse moltblock.json if present. Returns null if no file or parse error.
+ */
+export declare function loadMoltblockConfig(): MoltblockConfig | null;
+/**
+ * Model bindings for Code Entity. Load from moltblock.json if present, then env overrides.
+ * If no JSON, uses env/.env only (backward compatible). API keys from env win over JSON.
+ */
+export declare function defaultCodeEntityBindings(): Record<string, ModelBinding>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAwB9D;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,IAAI,CAY5D;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CA0ExE"}

package/dist/config.js

@@ -0,0 +1,139 @@
+/**
+ * LLM gateway config: per-role model binding.
+ * Load from JSON (moltblock.json), with env overrides.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { z } from "zod";
+// Load .env so MOLTBLOCK_ZAI_API_KEY etc. can be set there
+try {
+    const dotenv = await import("dotenv");
+    dotenv.config();
+}
+catch {
+    // dotenv not required
+}
+// --- Zod schemas (OpenClaw-style config) ---
+export const BindingEntrySchema = z.object({
+    backend: z.string().describe("e.g. 'local' or 'zai' or 'openai'"),
+    base_url: z.string().describe("API base URL"),
+    model: z.string().default("default").describe("Model id for chat completion"),
+    api_key: z.string().nullable().optional().describe("Bearer token; null for local. Prefer env."),
+});
+export const AgentConfigSchema = z.object({
+    bindings: z.record(BindingEntrySchema).optional().describe("Per-role model bindings"),
+});
+export const MoltblockConfigSchema = z.object({
+    agent: AgentConfigSchema.optional().describe("Agent defaults and bindings"),
+});
+export const ModelBindingSchema = z.object({
+    backend: z.string().describe("e.g. 'local' or 'zai' or 'openai'"),
+    baseUrl: z.string().describe("API base URL"),
+    apiKey: z.string().nullable().default(null).describe("Bearer token; null for local"),
+    model: z.string().default("default").describe("Model name for chat completion"),
+});
+/**
+ * Resolve config file: MOLTBLOCK_CONFIG env, then ./moltblock.json, ./.moltblock/moltblock.json, ~/.moltblock/moltblock.json.
+ */
+function configPath() {
+    const envPath = (process.env["MOLTBLOCK_CONFIG"] ?? "").trim();
+    if (envPath && fs.existsSync(envPath)) {
+        return envPath;
+    }
+    const cwd = process.cwd();
+    const candidates = [
+        path.join(cwd, "moltblock.json"),
+        path.join(cwd, ".moltblock", "moltblock.json"),
+        path.join(os.homedir(), ".moltblock", "moltblock.json"),
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Load and parse moltblock.json if present. Returns null if no file or parse error.
+ */
+export function loadMoltblockConfig() {
+    const configFile = configPath();
+    if (!configFile) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(configFile, "utf-8");
+        const data = JSON.parse(raw);
+        return MoltblockConfigSchema.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+function env(key, defaultValue = "") {
+    return (process.env[key] ?? defaultValue).trim();
+}
+/**
+ * Model bindings for Code Entity. Load from moltblock.json if present, then env overrides.
+ * If no JSON, uses env/.env only (backward compatible). API keys from env win over JSON.
+ */
+export function defaultCodeEntityBindings() {
+    const cfg = loadMoltblockConfig();
+    const zaiKey = env("MOLTBLOCK_ZAI_API_KEY");
+    const localUrl = env("MOLTBLOCK_GENERATOR_BASE_URL") || "http://localhost:1234/v1";
+    const localModel = env("MOLTBLOCK_GENERATOR_MODEL") || "local";
+    const envUrl = (key, fallback) => env(key) || fallback;
+    const envModel = (key, fallback) => env(key) || fallback;
+    const bindingsFromJson = cfg?.agent?.bindings ?? {};
+    function bindingFor(role, defaultBackend, defaultBase, defaultModel, defaultApiKey) {
+        const entry = bindingsFromJson[role];
+        if (entry) {
+            const baseUrl = envUrl(`MOLTBLOCK_${role.toUpperCase()}_BASE_URL`, entry.base_url);
+            const model = envModel(`MOLTBLOCK_${role.toUpperCase()}_MODEL`, entry.model ?? "default");
+            const apiKey = env(`MOLTBLOCK_${role.toUpperCase()}_API_KEY`) ||
+                entry.api_key ||
+                (entry.backend === "zai" ? zaiKey : null) ||
+                null;
+            return { backend: entry.backend, baseUrl, apiKey, model };
+        }
+        // No JSON: legacy env-only behavior
+        if (role === "generator") {
+            return { backend: "local", baseUrl: localUrl, apiKey: null, model: localModel };
+        }
+        if (role === "critic") {
+            const useZai = Boolean(zaiKey);
+            return {
+                backend: useZai ? "zai" : "local",
+                baseUrl: envUrl("MOLTBLOCK_CRITIC_BASE_URL", useZai ? "https://api.z.ai/api/paas/v4" : localUrl),
+                apiKey: useZai ? zaiKey : null,
+                model: envModel("MOLTBLOCK_CRITIC_MODEL", useZai ? "glm-4.7-flash" : localModel),
+            };
+        }
+        if (role === "judge") {
+            const useZai = Boolean(zaiKey);
+            return {
+                backend: useZai ? "zai" : "local",
+                baseUrl: envUrl("MOLTBLOCK_JUDGE_BASE_URL", useZai ? "https://api.z.ai/api/paas/v4" : localUrl),
+                apiKey: useZai ? zaiKey : null,
+                model: envModel("MOLTBLOCK_JUDGE_MODEL", useZai ? "glm-4.7-flash" : localModel),
+            };
+        }
+        if (role === "verifier") {
+            return {
+                backend: "local",
+                baseUrl: envUrl("MOLTBLOCK_VERIFIER_BASE_URL", localUrl),
+                apiKey: null,
+                model: envModel("MOLTBLOCK_VERIFIER_MODEL", localModel),
+            };
+        }
+        return { backend: defaultBackend, baseUrl: defaultBase, apiKey: defaultApiKey, model: defaultModel };
+    }
+    return {
+        generator: bindingFor("generator", "local", localUrl, localModel, null),
+        critic: bindingFor("critic", zaiKey ? "zai" : "local", localUrl, localModel, zaiKey || null),
+        judge: bindingFor("judge", zaiKey ? "zai" : "local", localUrl, localModel, zaiKey || null),
+        verifier: bindingFor("verifier", "local", localUrl, localModel, null),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/entity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Entity: minimal runnable loop — task in -> graph (Generator/Critic/Judge) -> Verifier -> artifact out.
+ */
+import { type ModelBinding } from "./config.js";
+import { GraphRunner } from "./graph-runner.js";
+import { WorkingMemory } from "./memory.js";
+import { Store } from "./persistence.js";
+/**
+ * Code Entity: Generator -> Critic -> Judge -> Verifier.
+ * Uses working memory and per-role LLM gateways.
+ */
+export declare class CodeEntity {
+    private gateways;
+    constructor(bindings?: Record<string, ModelBinding>);
+    /**
+     * One full loop: task in -> Generator -> Critic -> Judge -> Verifier -> gating.
+     * If store is provided and verification passed: admit to verified memory; optionally write checkpoint.
+     * Returns working memory with authoritative_artifact set only if verification passed.
+     */
+    run(task: string, options?: {
+        testCode?: string;
+        store?: Store;
+        entityVersion?: string;
+        writeCheckpointAfter?: boolean;
+    }): Promise<WorkingMemory>;
+}
+/**
+ * Load an Entity from a declarative graph (JSON/YAML). Returns a GraphRunner.
+ */
+export declare function loadEntityWithGraph(graphPath: string, bindings?: Record<string, ModelBinding>): GraphRunner;
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,EAA6B,MAAM,kBAAkB,CAAC;AAGpE;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IASnD;;;;OAIG;IACG,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAC3B,GACL,OAAO,CAAC,aAAa,CAAC;CAwD1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACtC,WAAW,CAGb"}