moltblock 0.2.0

package/dist/entity.js

@@ -0,0 +1,80 @@
+/**
+ * Entity: minimal runnable loop — task in -> graph (Generator/Critic/Judge) -> Verifier -> artifact out.
+ */
+import { runCritic, runGenerator, runJudge } from "./agents.js";
+import { defaultCodeEntityBindings } from "./config.js";
+import { LLMGateway } from "./gateway.js";
+import { GraphRunner } from "./graph-runner.js";
+import { AgentGraph } from "./graph-schema.js";
+import { WorkingMemory } from "./memory.js";
+import { hashMemory, recordOutcome } from "./persistence.js";
+import { runVerifier } from "./verifier.js";
+/**
+ * Code Entity: Generator -> Critic -> Judge -> Verifier.
+ * Uses working memory and per-role LLM gateways.
+ */
+export class CodeEntity {
+    gateways;
+    constructor(bindings) {
+        const resolvedBindings = bindings ?? defaultCodeEntityBindings();
+        this.gateways = {
+            generator: new LLMGateway(resolvedBindings["generator"]),
+            critic: new LLMGateway(resolvedBindings["critic"]),
+            judge: new LLMGateway(resolvedBindings["judge"]),
+        };
+    }
+    /**
+     * 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.
+     */
+    async run(task, options = {}) {
+        const { testCode, store, entityVersion = "0.2.0", writeCheckpointAfter = false, } = options;
+        const t0 = performance.now();
+        const memory = new WorkingMemory();
+        memory.setTask(task);
+        // Inject long-term context from verified memory
+        if (store) {
+            const recent = store.getRecentVerified(5);
+            const parts = [];
+            for (const e of recent) {
+                if (e.content_preview) {
+                    parts.push(e.content_preview.slice(0, 500));
+                }
+                else if (e.summary) {
+                    parts.push(e.summary);
+                }
+            }
+            memory.longTermContext = parts.length > 0 ? parts.join("\n---\n") : "";
+        }
+        // Run the agent pipeline
+        await runGenerator(this.gateways["generator"], memory, store ?? null);
+        await runCritic(this.gateways["critic"], memory, store ?? null);
+        await runJudge(this.gateways["judge"], memory, store ?? null);
+        await runVerifier(memory, testCode);
+        // Record outcome and persist if verification passed
+        const latencySec = (performance.now() - t0) / 1000;
+        if (store) {
+            recordOutcome(store, memory.verificationPassed, latencySec, task.slice(0, 100));
+        }
+        if (store && memory.verificationPassed && memory.authoritativeArtifact) {
+            const artifactRef = `artifact_${Date.now()}`;
+            store.addVerified(artifactRef, `Verified artifact (${memory.authoritativeArtifact.length} chars)`, memory.authoritativeArtifact.slice(0, 2000));
+            if (writeCheckpointAfter) {
+                const graphHash = "fixed-code-entity";
+                const refs = [artifactRef];
+                const memHash = hashMemory(refs);
+                store.writeCheckpoint(entityVersion, graphHash, memHash, refs);
+            }
+        }
+        return memory;
+    }
+}
+/**
+ * Load an Entity from a declarative graph (JSON/YAML). Returns a GraphRunner.
+ */
+export function loadEntityWithGraph(graphPath, bindings) {
+    const graph = AgentGraph.load(graphPath);
+    return new GraphRunner(graph, bindings);
+}
+//# sourceMappingURL=entity.js.map

package/dist/entity.js.map

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

package/dist/gateway.d.ts

@@ -0,0 +1,19 @@
+/**
+ * LLM gateway: single interface for local (LM Studio/llama.cpp) and Z.ai / OpenAI-compatible APIs.
+ */
+import type { ModelBinding, ChatMessage } from "./types.js";
+/**
+ * One client per role; uses OpenAI-compatible API with base_url and optional api_key.
+ */
+export declare class LLMGateway {
+    private client;
+    private model;
+    private modelResolved;
+    private binding;
+    constructor(binding: ModelBinding);
+    /**
+     * Send chat completion request; return assistant content.
+     */
+    complete(messages: ChatMessage[], maxTokens?: number): Promise<string>;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4B5D;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,YAAY;IASjC;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAkB3E"}

package/dist/gateway.js

@@ -0,0 +1,63 @@
+/**
+ * LLM gateway: single interface for local (LM Studio/llama.cpp) and Z.ai / OpenAI-compatible APIs.
+ */
+import OpenAI from "openai";
+/**
+ * If model is 'local' or empty and base_url is localhost, use first available model from API.
+ */
+async function resolveLocalModel(client, baseUrl, configured) {
+    if (configured && configured !== "local") {
+        return configured;
+    }
+    if (!baseUrl.includes("localhost") && !baseUrl.includes("127.0.0.1")) {
+        return configured || "default";
+    }
+    try {
+        const models = await client.models.list();
+        const firstModel = models.data[0];
+        if (firstModel?.id) {
+            return firstModel.id;
+        }
+    }
+    catch {
+        // Ignore errors, use default
+    }
+    return configured || "default";
+}
+/**
+ * One client per role; uses OpenAI-compatible API with base_url and optional api_key.
+ */
+export class LLMGateway {
+    client;
+    model;
+    modelResolved = false;
+    binding;
+    constructor(binding) {
+        this.binding = binding;
+        this.client = new OpenAI({
+            baseURL: binding.baseUrl,
+            apiKey: binding.apiKey ?? "not-needed",
+        });
+        this.model = binding.model;
+    }
+    /**
+     * Send chat completion request; return assistant content.
+     */
+    async complete(messages, maxTokens = 2048) {
+        if (!this.modelResolved) {
+            this.model = await resolveLocalModel(this.client, this.binding.baseUrl, this.model);
+            this.modelResolved = true;
+        }
+        const resp = await this.client.chat.completions.create({
+            model: this.model,
+            messages: messages.map((m) => ({ role: m.role, content: m.content })),
+            max_tokens: maxTokens,
+        });
+        const choice = resp.choices[0];
+        if (!choice?.message) {
+            return "";
+        }
+        return choice.message.content ?? "";
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAC9B,MAAc,EACd,OAAe,EACf,UAAkB;IAElB,IAAI,UAAU,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACrE,OAAO,UAAU,IAAI,SAAS,CAAC;IACjC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,UAAU,EAAE,EAAE,EAAE,CAAC;YACnB,OAAO,UAAU,CAAC,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IACD,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,UAAU;IACb,MAAM,CAAS;IACf,KAAK,CAAS;IACd,aAAa,GAAG,KAAK,CAAC;IACtB,OAAO,CAAe;IAE9B,YAAY,OAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,YAAY;SACvC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAuB,EAAE,SAAS,GAAG,IAAI;QACtD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACpF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACrD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACrE,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,CAAC;CACF"}

package/dist/governance.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Governance: molt rate limits, human veto, audit. Enforced outside the cognitive loop.
+ */
+import type { GovernanceConfig } from "./types.js";
+import { Store } from "./persistence.js";
+/**
+ * Create a governance config with defaults.
+ */
+export declare function createGovernanceConfig(overrides?: Partial<GovernanceConfig>): GovernanceConfig;
+/**
+ * Return [allowed, reason]. Checks rate limit and veto.
+ */
+export declare function canMolt(store: Store, config: GovernanceConfig): {
+    allowed: boolean;
+    reason: string;
+};
+/**
+ * Trigger a molt: validate governance, write checkpoint, bump version, audit.
+ * New graph/bindings/prompts are applied by the caller (e.g. load new graph).
+ * Returns { success, message }.
+ */
+export declare function triggerMolt(store: Store, entityVersion: string, config: GovernanceConfig, options?: {
+    graphHash?: string;
+    memoryHash?: string;
+    artifactRefs?: string[];
+}): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Human veto: pause the entity (no further work until resumed).
+ */
+export declare function pause(store: Store): void;
+/**
+ * Resume after pause.
+ */
+export declare function resume(store: Store): void;
+/**
+ * Return true if entity is paused.
+ */
+export declare function isPaused(store: Store): boolean;
+/**
+ * Record emergency shutdown in audit log.
+ */
+export declare function emergencyShutdown(store: Store): void;
+//# sourceMappingURL=governance.d.ts.map

package/dist/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../src/governance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,KAAK,EAIN,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACxC,gBAAgB,CAMlB;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAyBtC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACL;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqBvC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAGxC;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAGzC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEpD"}

package/dist/governance.js

@@ -0,0 +1,87 @@
+/**
+ * Governance: molt rate limits, human veto, audit. Enforced outside the cognitive loop.
+ */
+import { auditLog, getGovernanceValue, setGovernanceValue, } from "./persistence.js";
+/**
+ * Create a governance config with defaults.
+ */
+export function createGovernanceConfig(overrides = {}) {
+    return {
+        moltRateLimitSec: overrides.moltRateLimitSec ?? 60.0,
+        allowedMoltTriggers: overrides.allowedMoltTriggers ?? ["system", "human"],
+        humanVetoPaused: overrides.humanVetoPaused ?? false,
+    };
+}
+/**
+ * Return [allowed, reason]. Checks rate limit and veto.
+ */
+export function canMolt(store, config) {
+    if (config.humanVetoPaused) {
+        const paused = getGovernanceValue(store, "paused");
+        if (paused === "1") {
+            return { allowed: false, reason: "Entity is paused (human veto)" };
+        }
+    }
+    const last = getGovernanceValue(store, "last_molt_at");
+    if (last) {
+        try {
+            const t = parseFloat(last);
+            const now = Date.now() / 1000;
+            if (now - t < config.moltRateLimitSec) {
+                return {
+                    allowed: false,
+                    reason: `Molt rate limit: wait ${config.moltRateLimitSec}s between molts`,
+                };
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    return { allowed: true, reason: "" };
+}
+/**
+ * Trigger a molt: validate governance, write checkpoint, bump version, audit.
+ * New graph/bindings/prompts are applied by the caller (e.g. load new graph).
+ * Returns { success, message }.
+ */
+export function triggerMolt(store, entityVersion, config, options = {}) {
+    const { graphHash = "", memoryHash = "", artifactRefs = [] } = options;
+    const { allowed, reason } = canMolt(store, config);
+    if (!allowed) {
+        return { success: false, message: reason };
+    }
+    store.writeCheckpoint(entityVersion, graphHash || "molt", memoryHash || "", artifactRefs);
+    const now = Date.now() / 1000;
+    setGovernanceValue(store, "last_molt_at", now.toString());
+    setGovernanceValue(store, "entity_version", entityVersion);
+    auditLog(store, "molt", `version=${entityVersion} graph_hash=${graphHash}`);
+    return { success: true, message: "Molt completed" };
+}
+/**
+ * Human veto: pause the entity (no further work until resumed).
+ */
+export function pause(store) {
+    setGovernanceValue(store, "paused", "1");
+    auditLog(store, "pause", "human veto");
+}
+/**
+ * Resume after pause.
+ */
+export function resume(store) {
+    setGovernanceValue(store, "paused", "0");
+    auditLog(store, "resume", "");
+}
+/**
+ * Return true if entity is paused.
+ */
+export function isPaused(store) {
+    return getGovernanceValue(store, "paused") === "1";
+}
+/**
+ * Record emergency shutdown in audit log.
+ */
+export function emergencyShutdown(store) {
+    auditLog(store, "emergency_shutdown", "");
+}
+//# sourceMappingURL=governance.js.map

package/dist/governance.js.map

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

package/dist/graph-runner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Execute an agent graph: load DAG, run nodes in topological order, then verifier.
+ */
+import { type ModelBinding } from "./config.js";
+import { AgentGraph } from "./graph-schema.js";
+import { WorkingMemory } from "./memory.js";
+import { Store } from "./persistence.js";
+/**
+ * Runs a declarative agent graph: nodes (role + binding), edges (data flow).
+ * After all nodes run, verifier runs on the final node's output and gating is applied.
+ */
+export declare class GraphRunner {
+    private graph;
+    private gateways;
+    constructor(graph: AgentGraph, bindings?: Record<string, ModelBinding>);
+    /**
+     * Execute graph: task in -> run nodes in topo order -> run verifier on final node -> gating.
+     * If store is provided and verification passed: admit to verified memory; optionally write checkpoint.
+     * Returns working memory with slots filled and authoritative_artifact set iff verification passed.
+     */
+    run(task: string, options?: {
+        testCode?: string;
+        store?: Store;
+        entityVersion?: string;
+        writeCheckpointAfter?: boolean;
+    }): Promise<WorkingMemory>;
+}
+//# sourceMappingURL=graph-runner.d.ts.map

package/dist/graph-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runner.d.ts","sourceRoot":"","sources":["../src/graph-runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAwC,MAAM,kBAAkB,CAAC;AAG/E;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAsC;gBAE1C,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAmBtE;;;;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;CA0F1B"}

package/dist/graph-runner.js

@@ -0,0 +1,103 @@
+/**
+ * Execute an agent graph: load DAG, run nodes in topological order, then verifier.
+ */
+import { runRole } from "./agents.js";
+import { defaultCodeEntityBindings } from "./config.js";
+import { LLMGateway } from "./gateway.js";
+import { WorkingMemory } from "./memory.js";
+import { hashGraph, hashMemory, recordOutcome } from "./persistence.js";
+import { runVerifier } from "./verifier.js";
+/**
+ * Runs a declarative agent graph: nodes (role + binding), edges (data flow).
+ * After all nodes run, verifier runs on the final node's output and gating is applied.
+ */
+export class GraphRunner {
+    graph;
+    gateways = new Map();
+    constructor(graph, bindings) {
+        this.graph = graph;
+        const resolvedBindings = bindings ?? defaultCodeEntityBindings();
+        for (const node of graph.nodes) {
+            if (node.role === "verifier") {
+                continue;
+            }
+            const key = node.binding;
+            if (!this.gateways.has(key)) {
+                const binding = resolvedBindings[key];
+                if (!binding) {
+                    throw new Error(`Binding key '${key}' not in bindings`);
+                }
+                this.gateways.set(key, new LLMGateway(binding));
+            }
+        }
+    }
+    /**
+     * Execute graph: task in -> run nodes in topo order -> run verifier on final node -> gating.
+     * If store is provided and verification passed: admit to verified memory; optionally write checkpoint.
+     * Returns working memory with slots filled and authoritative_artifact set iff verification passed.
+     */
+    async run(task, options = {}) {
+        const { testCode, store, entityVersion = "0.2.0", writeCheckpointAfter = false, } = options;
+        const t0 = performance.now();
+        const memory = new WorkingMemory();
+        memory.setTask(task);
+        // Inject long-term context from verified memory
+        if (store) {
+            const recent = store.getRecentVerified(5);
+            const parts = [];
+            for (const e of recent) {
+                if (e.content_preview) {
+                    parts.push(e.content_preview.slice(0, 500));
+                }
+                else if (e.summary) {
+                    parts.push(e.summary);
+                }
+            }
+            memory.longTermContext = parts.length > 0 ? parts.join("\n---\n") : "";
+        }
+        // Run nodes in topological order
+        const order = this.graph.topologicalOrder();
+        for (const nodeId of order) {
+            const node = this.graph.nodes.find((n) => n.id === nodeId);
+            if (!node || node.role === "verifier") {
+                continue;
+            }
+            const preds = this.graph.predecessors(nodeId);
+            const inputs = {};
+            for (const p of preds) {
+                inputs[p] = memory.getSlot(p);
+            }
+            const gateway = this.gateways.get(node.binding);
+            if (!gateway) {
+                throw new Error(`No gateway for binding '${node.binding}'`);
+            }
+            const out = await runRole(node.role, gateway, task, inputs, memory.longTermContext, store ?? null);
+            memory.setSlot(nodeId, out);
+        }
+        // Set final candidate from final node
+        const finalId = this.graph.getFinalNodeId();
+        if (finalId) {
+            memory.finalCandidate = memory.getSlot(finalId);
+        }
+        // Run verification
+        await runVerifier(memory, testCode);
+        // Record outcome and persist if verification passed
+        const latencySec = (performance.now() - t0) / 1000;
+        if (store) {
+            recordOutcome(store, memory.verificationPassed, latencySec, task.slice(0, 100));
+        }
+        if (store && memory.verificationPassed && memory.authoritativeArtifact) {
+            const artifactRef = `artifact_${Date.now()}`;
+            store.addVerified(artifactRef, `Verified artifact (${memory.authoritativeArtifact.length} chars)`, memory.authoritativeArtifact.slice(0, 2000));
+            if (writeCheckpointAfter) {
+                const graphConfig = this.graph.toJSON();
+                const graphHashVal = hashGraph(graphConfig);
+                const refs = [artifactRef];
+                const memHash = hashMemory(refs);
+                store.writeCheckpoint(entityVersion, graphHashVal, memHash, refs);
+            }
+        }
+        return memory;
+    }
+}
+//# sourceMappingURL=graph-runner.js.map

package/dist/graph-runner.js.map

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

package/dist/graph-schema.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Agent graph schema: DAG of nodes (role + model_binding) and edges (data flow).
+ */
+import { z } from "zod";
+export declare const GraphNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodString;
+    binding: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    role: string;
+    binding: string;
+}, {
+    id: string;
+    role: string;
+    binding: string;
+}>;
+export type GraphNode = z.infer<typeof GraphNodeSchema>;
+export declare const GraphEdgeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    to: string;
+}, {
+    from: string;
+    to: string;
+}>;
+export type GraphEdge = z.infer<typeof GraphEdgeSchema>;
+export declare const AgentGraphSchema: z.ZodObject<{
+    nodes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodString;
+        binding: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        role: string;
+        binding: string;
+    }, {
+        id: string;
+        role: string;
+        binding: string;
+    }>, "many">>;
+    edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>, "many">>;
+    final_node: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        id: string;
+        role: string;
+        binding: string;
+    }[];
+    edges: {
+        from: string;
+        to: string;
+    }[];
+    final_node?: string | null | undefined;
+}, {
+    nodes?: {
+        id: string;
+        role: string;
+        binding: string;
+    }[] | undefined;
+    edges?: {
+        from: string;
+        to: string;
+    }[] | undefined;
+    final_node?: string | null | undefined;
+}>;
+export type AgentGraphData = z.infer<typeof AgentGraphSchema>;
+/**
+ * Declarative agent graph: nodes and edges. Verifier runs on final node(s) output.
+ */
+export declare class AgentGraph {
+    readonly nodes: GraphNode[];
+    readonly edges: GraphEdge[];
+    readonly finalNode: string | null;
+    constructor(data: AgentGraphData);
+    /**
+     * Return list of node ids that have an edge into nodeId.
+     */
+    predecessors(nodeId: string): string[];
+    /**
+     * Return list of node ids that nodeId has an edge to.
+     */
+    successors(nodeId: string): string[];
+    /**
+     * Return node ids in topological order (inputs before outputs).
+     */
+    topologicalOrder(): string[];
+    /**
+     * Node whose output goes to verifier. Explicit final_node or single node with no outgoing edges.
+     */
+    getFinalNodeId(): string | null;
+    /**
+     * Serialize to JSON string.
+     */
+    toJSON(): string;
+    /**
+     * Load graph from JSON or YAML file.
+     */
+    static load(filePath: string): AgentGraph;
+    /**
+     * Create graph from data object.
+     */
+    static fromData(data: AgentGraphData): AgentGraph;
+}
+//# sourceMappingURL=graph-schema.d.ts.map

package/dist/graph-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-schema.d.ts","sourceRoot":"","sources":["../src/graph-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU3B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE9D;;GAEG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEtB,IAAI,EAAE,cAAc;IAMhC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAIpC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAgC5B;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAU/B;;OAEG;IACH,MAAM,IAAI,MAAM;IAQhB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU;IA0BzC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU;CAGlD"}