moltblock 0.2.0

package/dist/graph-schema.js

@@ -0,0 +1,137 @@
+/**
+ * Agent graph schema: DAG of nodes (role + model_binding) and edges (data flow).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+export const GraphNodeSchema = z.object({
+    id: z.string().describe("Unique node id (e.g. generator, critic, judge)"),
+    role: z.string().describe("Role name: generator, critic, judge, router, etc."),
+    binding: z.string().describe("Key into bindings dict (e.g. generator, critic)"),
+});
+export const GraphEdgeSchema = z.object({
+    from: z.string().describe("Source node id"),
+    to: z.string().describe("Target node id"),
+});
+export const AgentGraphSchema = z.object({
+    nodes: z.array(GraphNodeSchema).default([]),
+    edges: z.array(GraphEdgeSchema).default([]),
+    final_node: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("Node whose output is the final candidate for verification (default: node with no outgoing edges)"),
+});
+/**
+ * Declarative agent graph: nodes and edges. Verifier runs on final node(s) output.
+ */
+export class AgentGraph {
+    nodes;
+    edges;
+    finalNode;
+    constructor(data) {
+        this.nodes = data.nodes;
+        this.edges = data.edges;
+        this.finalNode = data.final_node ?? null;
+    }
+    /**
+     * Return list of node ids that have an edge into nodeId.
+     */
+    predecessors(nodeId) {
+        return this.edges.filter((e) => e.to === nodeId).map((e) => e.from);
+    }
+    /**
+     * Return list of node ids that nodeId has an edge to.
+     */
+    successors(nodeId) {
+        return this.edges.filter((e) => e.from === nodeId).map((e) => e.to);
+    }
+    /**
+     * Return node ids in topological order (inputs before outputs).
+     */
+    topologicalOrder() {
+        const nodeIds = new Set(this.nodes.map((n) => n.id));
+        const inDegree = {};
+        for (const nid of nodeIds) {
+            inDegree[nid] = 0;
+        }
+        for (const e of this.edges) {
+            if (nodeIds.has(e.to)) {
+                inDegree[e.to] = (inDegree[e.to] ?? 0) + 1;
+            }
+        }
+        const order = [];
+        while (order.length < nodeIds.size) {
+            const ready = [...nodeIds].filter((nid) => !order.includes(nid) && inDegree[nid] === 0);
+            if (ready.length === 0) {
+                break; // cycle or done
+            }
+            order.push(...ready);
+            for (const nid of ready) {
+                for (const s of this.successors(nid)) {
+                    if (inDegree[s] !== undefined) {
+                        inDegree[s]--;
+                    }
+                }
+            }
+        }
+        return order;
+    }
+    /**
+     * Node whose output goes to verifier. Explicit final_node or single node with no outgoing edges.
+     */
+    getFinalNodeId() {
+        if (this.finalNode) {
+            return this.finalNode;
+        }
+        const candidates = this.nodes
+            .filter((n) => this.successors(n.id).length === 0)
+            .map((n) => n.id);
+        return candidates.length === 1 ? (candidates[0] ?? null) : null;
+    }
+    /**
+     * Serialize to JSON string.
+     */
+    toJSON() {
+        return JSON.stringify({
+            nodes: this.nodes,
+            edges: this.edges,
+            final_node: this.finalNode,
+        });
+    }
+    /**
+     * Load graph from JSON or YAML file.
+     */
+    static load(filePath) {
+        const resolved = path.resolve(filePath);
+        if (!fs.existsSync(resolved)) {
+            throw new Error(`Graph file not found: ${resolved}`);
+        }
+        const raw = fs.readFileSync(resolved, "utf-8");
+        const ext = path.extname(filePath).toLowerCase();
+        let data;
+        if (ext === ".yaml" || ext === ".yml") {
+            // Dynamic import for yaml
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const yaml = require("js-yaml");
+                data = yaml.load(raw);
+            }
+            catch {
+                throw new Error("js-yaml required for YAML graphs: npm install js-yaml");
+            }
+        }
+        else {
+            data = JSON.parse(raw);
+        }
+        const parsed = AgentGraphSchema.parse(data);
+        return new AgentGraph(parsed);
+    }
+    /**
+     * Create graph from data object.
+     */
+    static fromData(data) {
+        return new AgentGraph(AgentGraphSchema.parse(data));
+    }
+}
+//# sourceMappingURL=graph-schema.js.map

package/dist/graph-schema.js.map

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

package/dist/handoff.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Multi-entity handoff: Entity A produces signed artifact -> Entity B consumes as input.
+ */
+import { Store } from "./persistence.js";
+import type { ReceivedArtifact } from "./types.js";
+/**
+ * Sign artifact and deliver to recipient's inbox. Returns artifact_ref.
+ * recipientStore is the recipient entity's Store (entity_id = recipient).
+ */
+export declare function sendArtifact(senderEntityId: string, recipientStore: Store, artifactContent: string, artifactRef?: string): string;
+/**
+ * Get inbox artifacts for this entity. If verify=true, only return entries
+ * where the signature is valid for the sender. Each entry includes
+ * from_entity_id, artifact_ref, payload_text, verified.
+ */
+export declare function receiveArtifacts(store: Store, options?: {
+    limit?: number;
+    verify?: boolean;
+}): ReceivedArtifact[];
+//# sourceMappingURL=handoff.d.ts.map

package/dist/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAsB,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,KAAK,EACrB,eAAe,EAAE,MAAM,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAeR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjD,gBAAgB,EAAE,CAgBpB"}

package/dist/handoff.js

@@ -0,0 +1,38 @@
+/**
+ * Multi-entity handoff: Entity A produces signed artifact -> Entity B consumes as input.
+ */
+import { getInbox, putInbox } from "./persistence.js";
+import { artifactHash, signArtifact, verifyArtifact } from "./signing.js";
+/**
+ * Sign artifact and deliver to recipient's inbox. Returns artifact_ref.
+ * recipientStore is the recipient entity's Store (entity_id = recipient).
+ */
+export function sendArtifact(senderEntityId, recipientStore, artifactContent, artifactRef) {
+    const ref = artifactRef ?? `artifact_${senderEntityId}_${Date.now()}`;
+    const payloadHash = artifactHash(artifactContent);
+    const signature = signArtifact(senderEntityId, artifactContent);
+    putInbox(recipientStore, senderEntityId, ref, payloadHash, signature, artifactContent.slice(0, 100_000));
+    return ref;
+}
+/**
+ * Get inbox artifacts for this entity. If verify=true, only return entries
+ * where the signature is valid for the sender. Each entry includes
+ * from_entity_id, artifact_ref, payload_text, verified.
+ */
+export function receiveArtifacts(store, options = {}) {
+    const { limit = 20, verify = true } = options;
+    const entries = getInbox(store, limit);
+    return entries.map((e) => {
+        let ok = true;
+        if (verify && e.payload_text && e.signature) {
+            ok = verifyArtifact(e.from_entity_id, e.payload_text, e.signature);
+        }
+        return {
+            from_entity_id: e.from_entity_id,
+            artifact_ref: e.artifact_ref,
+            payload_text: e.payload_text ?? "",
+            verified: ok,
+        };
+    });
+}
+//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAS,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG1E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,cAAsB,EACtB,cAAqB,EACrB,eAAuB,EACvB,WAAoB;IAEpB,MAAM,GAAG,GAAG,WAAW,IAAI,YAAY,cAAc,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACtE,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,YAAY,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAEhE,QAAQ,CACN,cAAc,EACd,cAAc,EACd,GAAG,EACH,WAAW,EACX,SAAS,EACT,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAClC,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAY,EACZ,UAAgD,EAAE;IAElD,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEvC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvB,IAAI,EAAE,GAAG,IAAI,CAAC;QACd,IAAI,MAAM,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;YAC5C,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QACrE,CAAC;QACD,OAAO;YACL,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;YAClC,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/improvement.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Recursive improvement loop: measure outcomes, critique strategies, update prompts, re-evaluate.
+ */
+import { Store } from "./persistence.js";
+import type { StrategySuggestion } from "./types.js";
+/**
+ * Review recent outcomes and return suggested strategy updates (rule-based for MVP).
+ * Returns list of { role, suggestion } for human or governance to apply.
+ */
+export declare function critiqueStrategies(store: Store, recentCount?: number): StrategySuggestion[];
+/**
+ * Apply a new prompt for role (strategy update). Under governance, this would require approval.
+ */
+export declare function applySuggestion(store: Store, role: string, newPrompt: string): void;
+/**
+ * Run eval_tasks through runTask (which returns verification_passed).
+ * If store is provided, record each outcome. Returns { passed, total }.
+ */
+export declare function runEval(runTask: (task: string) => Promise<boolean>, evalTasks: string[], store?: Store): Promise<{
+    passed: number;
+    total: number;
+}>;
+/**
+ * One improvement cycle: run eval, critique, optionally apply suggestions.
+ * Returns { passed, total, suggestions }.
+ */
+export declare function runImprovementCycle(store: Store, runTask: (task: string) => Promise<boolean>, evalTasks: string[], applySuggestions?: boolean): Promise<{
+    passed: number;
+    total: number;
+    suggestions: StrategySuggestion[];
+}>;
+//# sourceMappingURL=improvement.d.ts.map

package/dist/improvement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improvement.d.ts","sourceRoot":"","sources":["../src/improvement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,EAIN,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,EACZ,WAAW,SAAK,GACf,kBAAkB,EAAE,CA0BtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EAC3C,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,CAAC,EAAE,KAAK,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB5C;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EAC3C,SAAS,EAAE,MAAM,EAAE,EACnB,gBAAgB,UAAQ,GACvB,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC,CAAC,CAUD"}

package/dist/improvement.js

@@ -0,0 +1,67 @@
+/**
+ * Recursive improvement loop: measure outcomes, critique strategies, update prompts, re-evaluate.
+ */
+import { getRecentOutcomes, recordOutcome, setStrategy, } from "./persistence.js";
+/**
+ * Review recent outcomes and return suggested strategy updates (rule-based for MVP).
+ * Returns list of { role, suggestion } for human or governance to apply.
+ */
+export function critiqueStrategies(store, recentCount = 10) {
+    const outcomes = getRecentOutcomes(store, recentCount);
+    if (outcomes.length < 3) {
+        return [];
+    }
+    const passed = outcomes.filter((o) => o.verification_passed).length;
+    const failRate = 1.0 - passed / outcomes.length;
+    const suggestions = [];
+    if (failRate >= 0.5) {
+        suggestions.push({
+            role: "generator",
+            suggestion: "Add explicit instruction: output only valid TypeScript with no markdown fences or commentary.",
+        });
+        suggestions.push({
+            role: "judge",
+            suggestion: "Ensure Judge incorporates all critic feedback and outputs runnable code only.",
+        });
+    }
+    return suggestions;
+}
+/**
+ * Apply a new prompt for role (strategy update). Under governance, this would require approval.
+ */
+export function applySuggestion(store, role, newPrompt) {
+    setStrategy(store, role, newPrompt);
+}
+/**
+ * Run eval_tasks through runTask (which returns verification_passed).
+ * If store is provided, record each outcome. Returns { passed, total }.
+ */
+export async function runEval(runTask, evalTasks, store) {
+    let passed = 0;
+    for (const task of evalTasks) {
+        const t0 = performance.now();
+        const ok = await runTask(task);
+        const latency = (performance.now() - t0) / 1000;
+        if (store) {
+            recordOutcome(store, ok, latency, task.slice(0, 100));
+        }
+        if (ok) {
+            passed++;
+        }
+    }
+    return { passed, total: evalTasks.length };
+}
+/**
+ * One improvement cycle: run eval, critique, optionally apply suggestions.
+ * Returns { passed, total, suggestions }.
+ */
+export async function runImprovementCycle(store, runTask, evalTasks, applySuggestions = false) {
+    const { passed, total } = await runEval(runTask, evalTasks, store);
+    const suggestions = critiqueStrategies(store, total);
+    if (applySuggestions && suggestions.length > 0) {
+        // Only apply if we have a concrete new prompt; suggestion text could be used by a meta-agent to generate one
+        // For now, this is a no-op placeholder
+    }
+    return { passed, total, suggestions };
+}
+//# sourceMappingURL=improvement.js.map

package/dist/improvement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improvement.js","sourceRoot":"","sources":["../src/improvement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,iBAAiB,EACjB,aAAa,EACb,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAY,EACZ,WAAW,GAAG,EAAE;IAEhB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAEvD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC;IACpE,MAAM,QAAQ,GAAG,GAAG,GAAG,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAEhD,MAAM,WAAW,GAAyB,EAAE,CAAC;IAE7C,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;QACpB,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,WAAW;YACjB,UAAU,EACR,+FAA+F;SAClG,CAAC,CAAC;QACH,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,OAAO;YACb,UAAU,EACR,+EAA+E;SAClF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,IAAY,EACZ,SAAiB;IAEjB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAA2C,EAC3C,SAAmB,EACnB,KAAa;IAEb,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;QAEhD,IAAI,KAAK,EAAE,CAAC;YACV,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAY,EACZ,OAA2C,EAC3C,SAAmB,EACnB,gBAAgB,GAAG,KAAK;IAMxB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAErD,IAAI,gBAAgB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,6GAA6G;QAC7G,uCAAuC;IACzC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Moltblock — framework for evolving composite intelligences (Entities).
+ */
+export declare const VERSION = "0.2.0";
+export type { ModelBinding, BindingEntry, AgentConfig, MoltblockConfig, ChatMessage, VerifiedMemoryEntry, CheckpointEntry, OutcomeEntry, InboxEntry, StrategySuggestion, ReceivedArtifact, GovernanceConfig, } from "./types.js";
+export { WorkingMemory } from "./memory.js";
+export { signArtifact, verifyArtifact, artifactHash } from "./signing.js";
+export { loadMoltblockConfig, defaultCodeEntityBindings, BindingEntrySchema, AgentConfigSchema, MoltblockConfigSchema, ModelBindingSchema, } from "./config.js";
+export { Store, hashGraph, hashMemory, auditLog, getGovernanceValue, setGovernanceValue, putInbox, getInbox, recordOutcome, getRecentOutcomes, getStrategy, setStrategy, } from "./persistence.js";
+export { LLMGateway } from "./gateway.js";
+export { runGenerator, runCritic, runJudge, runRole, } from "./agents.js";
+export { AgentGraph, GraphNodeSchema, GraphEdgeSchema, AgentGraphSchema, type GraphNode, type GraphEdge, type AgentGraphData, } from "./graph-schema.js";
+export { GraphRunner } from "./graph-runner.js";
+export { extractCodeBlock, runVitestOnCode, runVerifier } from "./verifier.js";
+export { createGovernanceConfig, canMolt, triggerMolt, pause, resume, isPaused, emergencyShutdown, } from "./governance.js";
+export { sendArtifact, receiveArtifacts } from "./handoff.js";
+export { critiqueStrategies, applySuggestion, runEval, runImprovementCycle, } from "./improvement.js";
+export { CodeEntity, loadEntityWithGraph } from "./entity.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG1E,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,OAAO,GACR,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,UAAU,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG/E,OAAO,EACL,sBAAsB,EACtB,OAAO,EACP,WAAW,EACX,KAAK,EACL,MAAM,EACN,QAAQ,EACR,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,OAAO,EACP,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * Moltblock — framework for evolving composite intelligences (Entities).
+ */
+export const VERSION = "0.2.0";
+// Memory
+export { WorkingMemory } from "./memory.js";
+// Signing
+export { signArtifact, verifyArtifact, artifactHash } from "./signing.js";
+// Config
+export { loadMoltblockConfig, defaultCodeEntityBindings, BindingEntrySchema, AgentConfigSchema, MoltblockConfigSchema, ModelBindingSchema, } from "./config.js";
+// Persistence
+export { Store, hashGraph, hashMemory, auditLog, getGovernanceValue, setGovernanceValue, putInbox, getInbox, recordOutcome, getRecentOutcomes, getStrategy, setStrategy, } from "./persistence.js";
+// Gateway
+export { LLMGateway } from "./gateway.js";
+// Agents
+export { runGenerator, runCritic, runJudge, runRole, } from "./agents.js";
+// Graph
+export { AgentGraph, GraphNodeSchema, GraphEdgeSchema, AgentGraphSchema, } from "./graph-schema.js";
+// Graph Runner
+export { GraphRunner } from "./graph-runner.js";
+// Verifier
+export { extractCodeBlock, runVitestOnCode, runVerifier } from "./verifier.js";
+// Governance
+export { createGovernanceConfig, canMolt, triggerMolt, pause, resume, isPaused, emergencyShutdown, } from "./governance.js";
+// Handoff
+export { sendArtifact, receiveArtifacts } from "./handoff.js";
+// Improvement
+export { critiqueStrategies, applySuggestion, runEval, runImprovementCycle, } from "./improvement.js";
+// Entity
+export { CodeEntity, loadEntityWithGraph } from "./entity.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAkB/B,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1E,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,cAAc;AACd,OAAO,EACL,KAAK,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,SAAS;AACT,OAAO,EACL,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,OAAO,GACR,MAAM,aAAa,CAAC;AAErB,QAAQ;AACR,OAAO,EACL,UAAU,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,GAIjB,MAAM,mBAAmB,CAAC;AAE3B,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE/E,aAAa;AACb,OAAO,EACL,sBAAsB,EACtB,OAAO,EACP,WAAW,EACX,KAAK,EACL,MAAM,EACN,QAAQ,EACR,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE9D,cAAc;AACd,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,OAAO,EACP,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Working memory: shared state for one task (drafts, critique, final artifact, verification result).
+ */
+/**
+ * In-memory scratchpad for a single run of the agent graph.
+ */
+export declare class WorkingMemory {
+    task: string;
+    draft: string;
+    critique: string;
+    finalCandidate: string;
+    verificationPassed: boolean;
+    verificationEvidence: string;
+    authoritativeArtifact: string;
+    meta: Record<string, unknown>;
+    /** Graph runner: node_id -> output (filled by graph execution) */
+    slots: Record<string, string>;
+    /** Injected from long-term memory for agent context (read-only) */
+    longTermContext: string;
+    setTask(task: string): void;
+    setDraft(draft: string): void;
+    setCritique(critique: string): void;
+    setFinalCandidate(candidate: string): void;
+    setVerification(passed: boolean, evidence?: string): void;
+    setSlot(nodeId: string, content: string): void;
+    getSlot(nodeId: string): string;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,aAAa;IACxB,IAAI,SAAM;IACV,KAAK,SAAM;IACX,QAAQ,SAAM;IACd,cAAc,SAAM;IACpB,kBAAkB,UAAS;IAC3B,oBAAoB,SAAM;IAC1B,qBAAqB,SAAM;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IACnC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IACnC,mEAAmE;IACnE,eAAe,SAAM;IAErB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1C,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,IAAI;IAQrD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGhC"}

package/dist/memory.js

@@ -0,0 +1,46 @@
+/**
+ * Working memory: shared state for one task (drafts, critique, final artifact, verification result).
+ */
+/**
+ * In-memory scratchpad for a single run of the agent graph.
+ */
+export class WorkingMemory {
+    task = "";
+    draft = "";
+    critique = "";
+    finalCandidate = "";
+    verificationPassed = false;
+    verificationEvidence = "";
+    authoritativeArtifact = "";
+    meta = {};
+    /** Graph runner: node_id -> output (filled by graph execution) */
+    slots = {};
+    /** Injected from long-term memory for agent context (read-only) */
+    longTermContext = "";
+    setTask(task) {
+        this.task = task;
+    }
+    setDraft(draft) {
+        this.draft = draft;
+    }
+    setCritique(critique) {
+        this.critique = critique;
+    }
+    setFinalCandidate(candidate) {
+        this.finalCandidate = candidate;
+    }
+    setVerification(passed, evidence = "") {
+        this.verificationPassed = passed;
+        this.verificationEvidence = evidence;
+        if (passed) {
+            this.authoritativeArtifact = this.finalCandidate;
+        }
+    }
+    setSlot(nodeId, content) {
+        this.slots[nodeId] = content;
+    }
+    getSlot(nodeId) {
+        return this.slots[nodeId] ?? "";
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,OAAO,aAAa;IACxB,IAAI,GAAG,EAAE,CAAC;IACV,KAAK,GAAG,EAAE,CAAC;IACX,QAAQ,GAAG,EAAE,CAAC;IACd,cAAc,GAAG,EAAE,CAAC;IACpB,kBAAkB,GAAG,KAAK,CAAC;IAC3B,oBAAoB,GAAG,EAAE,CAAC;IAC1B,qBAAqB,GAAG,EAAE,CAAC;IAC3B,IAAI,GAA4B,EAAE,CAAC;IACnC,kEAAkE;IAClE,KAAK,GAA2B,EAAE,CAAC;IACnC,mEAAmE;IACnE,eAAe,GAAG,EAAE,CAAC;IAErB,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,iBAAiB,CAAC,SAAiB;QACjC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;IAED,eAAe,CAAC,MAAe,EAAE,QAAQ,GAAG,EAAE;QAC5C,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACjC,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,cAAc,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,OAAe;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;CACF"}

package/dist/persistence.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Long-term verified memory and checkpoints (SQLite persistence).
+ */
+import Database from "better-sqlite3";
+import type { CheckpointEntry, InboxEntry, OutcomeEntry, VerifiedMemoryEntry } from "./types.js";
+/**
+ * Persistence for verified memory (admission only after verification) and
+ * immutable checkpoints (entity version, graph hash, memory hash, artifact refs).
+ */
+export declare class Store {
+    readonly entityId: string;
+    readonly path: string;
+    private db;
+    constructor(options?: {
+        path?: string;
+        entityId?: string;
+    });
+    private initSchema;
+    /**
+     * Admit a verified artifact into long-term memory (call only after verification pass).
+     */
+    addVerified(artifactRef: string, summary?: string, contentPreview?: string): void;
+    /**
+     * Return the k most recent verified entries for this entity (for agent context).
+     */
+    getRecentVerified(k?: number): VerifiedMemoryEntry[];
+    /**
+     * Append an immutable checkpoint.
+     */
+    writeCheckpoint(entityVersion: string, graphHash: string, memoryHash: string, artifactRefs: string[]): void;
+    /**
+     * List recent checkpoints for this entity.
+     */
+    listCheckpoints(limit?: number): CheckpointEntry[];
+    /** Get internal db for helper functions */
+    getDb(): Database.Database;
+    close(): void;
+}
+/**
+ * Stable hash for graph config (for checkpoint).
+ */
+export declare function hashGraph(graphConfig: string | Buffer): string;
+/**
+ * Stable hash for memory state (e.g. last N artifact refs).
+ */
+export declare function hashMemory(verifiedRefs: string[]): string;
+/**
+ * Append an audit log entry (molt, veto, shutdown, etc.).
+ */
+export declare function auditLog(store: Store, eventType: string, detail?: string): void;
+/**
+ * Get a governance state value (e.g. last_molt_at, paused).
+ */
+export declare function getGovernanceValue(store: Store, key: string): string | null;
+/**
+ * Set a governance state value.
+ */
+export declare function setGovernanceValue(store: Store, key: string, value: string): void;
+/**
+ * Add a signed artifact to this entity's inbox (store is the recipient).
+ */
+export declare function putInbox(store: Store, fromEntityId: string, artifactRef: string, payloadHash: string, signature: string, payloadText?: string): void;
+/**
+ * Return recent inbox entries for this entity (recipient).
+ */
+export declare function getInbox(store: Store, limit?: number): InboxEntry[];
+/**
+ * Record one task outcome for measurement.
+ */
+export declare function recordOutcome(store: Store, verificationPassed: boolean, latencySec?: number, taskRef?: string): void;
+/**
+ * Return the k most recent outcomes for this entity.
+ */
+export declare function getRecentOutcomes(store: Store, k?: number): OutcomeEntry[];
+/**
+ * Return current strategy (prompt) for role, or null if not set.
+ */
+export declare function getStrategy(store: Store, role: string): string | null;
+/**
+ * Set strategy (prompt) for role; inserts new version.
+ */
+export declare function setStrategy(store: Store, role: string, content: string): void;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,YAAY,EACZ,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,CAAoB;gBAElB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAgB9D,OAAO,CAAC,UAAU;IAsFlB;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAcjF;;OAEG;IACH,iBAAiB,CAAC,CAAC,SAAI,GAAG,mBAAmB,EAAE;IAmB/C;;OAEG;IACH,eAAe,CACb,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EAAE,GACrB,IAAI;IAeP;;OAEG;IACH,eAAe,CAAC,KAAK,SAAK,GAAG,eAAe,EAAE;IAqB9C,2CAA2C;IAC3C,KAAK,IAAI,QAAQ,CAAC,QAAQ;IAI1B,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI9D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAGzD;AAID;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAM/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOjF;AAID;;GAEG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAeN;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,SAAK,GAAG,UAAU,EAAE,CAsB/D;AAID;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,kBAAkB,EAAE,OAAO,EAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAaN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,SAAK,GAAG,YAAY,EAAE,CAkBtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAa7E"}