moltblock 0.2.0

package/dist/persistence.js

@@ -0,0 +1,295 @@
+/**
+ * Long-term verified memory and checkpoints (SQLite persistence).
+ */
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import Database from "better-sqlite3";
+/**
+ * Persistence for verified memory (admission only after verification) and
+ * immutable checkpoints (entity version, graph hash, memory hash, artifact refs).
+ */
+export class Store {
+    entityId;
+    path;
+    db;
+    constructor(options = {}) {
+        this.entityId = options.entityId ?? "default";
+        const p = options.path ?? path.join(".moltblock", "store.db");
+        this.path = p;
+        if (p !== ":memory:") {
+            const dir = path.dirname(p);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+        }
+        this.db = new Database(p);
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS verified_memory (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_id TEXT NOT NULL,
+        artifact_ref TEXT NOT NULL,
+        summary TEXT,
+        content_preview TEXT,
+        created_at REAL NOT NULL
+      )
+    `);
+        this.db.exec("CREATE INDEX IF NOT EXISTS idx_vm_entity ON verified_memory(entity_id)");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS checkpoints (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_id TEXT NOT NULL,
+        entity_version TEXT NOT NULL,
+        graph_hash TEXT NOT NULL,
+        memory_hash TEXT NOT NULL,
+        artifact_refs TEXT NOT NULL,
+        created_at REAL NOT NULL
+      )
+    `);
+        this.db.exec("CREATE INDEX IF NOT EXISTS idx_cp_entity ON checkpoints(entity_id)");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS outcomes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_id TEXT NOT NULL,
+        task_ref TEXT,
+        verification_passed INTEGER NOT NULL,
+        latency_sec REAL,
+        created_at REAL NOT NULL
+      )
+    `);
+        this.db.exec("CREATE INDEX IF NOT EXISTS idx_out_entity ON outcomes(entity_id)");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS strategies (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_id TEXT NOT NULL,
+        role TEXT NOT NULL,
+        version INTEGER NOT NULL,
+        content TEXT NOT NULL,
+        created_at REAL NOT NULL
+      )
+    `);
+        this.db.exec("CREATE INDEX IF NOT EXISTS idx_strat_entity ON strategies(entity_id)");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS audit_log (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_id TEXT NOT NULL,
+        event_type TEXT NOT NULL,
+        detail TEXT,
+        created_at REAL NOT NULL
+      )
+    `);
+        this.db.exec("CREATE INDEX IF NOT EXISTS idx_audit_entity ON audit_log(entity_id)");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS governance_state (
+        entity_id TEXT NOT NULL,
+        key TEXT NOT NULL,
+        value TEXT NOT NULL,
+        updated_at REAL NOT NULL,
+        PRIMARY KEY (entity_id, key)
+      )
+    `);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS inbox (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_id TEXT NOT NULL,
+        from_entity_id TEXT NOT NULL,
+        artifact_ref TEXT NOT NULL,
+        payload_text TEXT,
+        payload_hash TEXT NOT NULL,
+        signature TEXT NOT NULL,
+        created_at REAL NOT NULL
+      )
+    `);
+        this.db.exec("CREATE INDEX IF NOT EXISTS idx_inbox_entity ON inbox(entity_id)");
+    }
+    /**
+     * Admit a verified artifact into long-term memory (call only after verification pass).
+     */
+    addVerified(artifactRef, summary, contentPreview) {
+        const stmt = this.db.prepare(`
+      INSERT INTO verified_memory (entity_id, artifact_ref, summary, content_preview, created_at)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        stmt.run(this.entityId, artifactRef, summary ?? null, (contentPreview ?? "").slice(0, 2000), Date.now() / 1000);
+    }
+    /**
+     * Return the k most recent verified entries for this entity (for agent context).
+     */
+    getRecentVerified(k = 5) {
+        const stmt = this.db.prepare(`
+      SELECT artifact_ref, summary, content_preview, created_at
+      FROM verified_memory WHERE entity_id = ? ORDER BY id DESC LIMIT ?
+    `);
+        const rows = stmt.all(this.entityId, k);
+        return rows.map((r) => ({
+            artifact_ref: r.artifact_ref,
+            summary: r.summary,
+            content_preview: r.content_preview,
+            created_at: r.created_at,
+        }));
+    }
+    /**
+     * Append an immutable checkpoint.
+     */
+    writeCheckpoint(entityVersion, graphHash, memoryHash, artifactRefs) {
+        const stmt = this.db.prepare(`
+      INSERT INTO checkpoints (entity_id, entity_version, graph_hash, memory_hash, artifact_refs, created_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(this.entityId, entityVersion, graphHash, memoryHash, JSON.stringify(artifactRefs), Date.now() / 1000);
+    }
+    /**
+     * List recent checkpoints for this entity.
+     */
+    listCheckpoints(limit = 20) {
+        const stmt = this.db.prepare(`
+      SELECT entity_version, graph_hash, memory_hash, artifact_refs, created_at
+      FROM checkpoints WHERE entity_id = ? ORDER BY id DESC LIMIT ?
+    `);
+        const rows = stmt.all(this.entityId, limit);
+        return rows.map((r) => ({
+            entity_version: r.entity_version,
+            graph_hash: r.graph_hash,
+            memory_hash: r.memory_hash,
+            artifact_refs: JSON.parse(r.artifact_refs),
+            created_at: r.created_at,
+        }));
+    }
+    /** Get internal db for helper functions */
+    getDb() {
+        return this.db;
+    }
+    close() {
+        this.db.close();
+    }
+}
+/**
+ * Stable hash for graph config (for checkpoint).
+ */
+export function hashGraph(graphConfig) {
+    const data = typeof graphConfig === "string" ? Buffer.from(graphConfig, "utf-8") : graphConfig;
+    return crypto.createHash("sha256").update(data).digest("hex").slice(0, 16);
+}
+/**
+ * Stable hash for memory state (e.g. last N artifact refs).
+ */
+export function hashMemory(verifiedRefs) {
+    const data = JSON.stringify(verifiedRefs.sort());
+    return crypto.createHash("sha256").update(data).digest("hex").slice(0, 16);
+}
+// --- Audit and governance ---
+/**
+ * Append an audit log entry (molt, veto, shutdown, etc.).
+ */
+export function auditLog(store, eventType, detail) {
+    const db = store.getDb();
+    const stmt = db.prepare("INSERT INTO audit_log (entity_id, event_type, detail, created_at) VALUES (?, ?, ?, ?)");
+    stmt.run(store.entityId, eventType, detail ?? "", Date.now() / 1000);
+}
+/**
+ * Get a governance state value (e.g. last_molt_at, paused).
+ */
+export function getGovernanceValue(store, key) {
+    const db = store.getDb();
+    const stmt = db.prepare("SELECT value FROM governance_state WHERE entity_id = ? AND key = ?");
+    const row = stmt.get(store.entityId, key);
+    return row?.value ?? null;
+}
+/**
+ * Set a governance state value.
+ */
+export function setGovernanceValue(store, key, value) {
+    const db = store.getDb();
+    const stmt = db.prepare(`
+    INSERT OR REPLACE INTO governance_state (entity_id, key, value, updated_at)
+    VALUES (?, ?, ?, ?)
+  `);
+    stmt.run(store.entityId, key, value, Date.now() / 1000);
+}
+// --- Inbox (multi-entity handoff) ---
+/**
+ * Add a signed artifact to this entity's inbox (store is the recipient).
+ */
+export function putInbox(store, fromEntityId, artifactRef, payloadHash, signature, payloadText) {
+    const db = store.getDb();
+    const stmt = db.prepare(`
+    INSERT INTO inbox (entity_id, from_entity_id, artifact_ref, payload_text, payload_hash, signature, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `);
+    stmt.run(store.entityId, fromEntityId, artifactRef, payloadText ?? "", payloadHash, signature, Date.now() / 1000);
+}
+/**
+ * Return recent inbox entries for this entity (recipient).
+ */
+export function getInbox(store, limit = 20) {
+    const db = store.getDb();
+    const stmt = db.prepare(`
+    SELECT from_entity_id, artifact_ref, payload_text, payload_hash, signature, created_at
+    FROM inbox WHERE entity_id = ? ORDER BY id DESC LIMIT ?
+  `);
+    const rows = stmt.all(store.entityId, limit);
+    return rows.map((r) => ({
+        from_entity_id: r.from_entity_id,
+        artifact_ref: r.artifact_ref,
+        payload_text: r.payload_text,
+        payload_hash: r.payload_hash,
+        signature: r.signature,
+        created_at: r.created_at,
+    }));
+}
+// --- Outcomes and strategies (recursive improvement) ---
+/**
+ * Record one task outcome for measurement.
+ */
+export function recordOutcome(store, verificationPassed, latencySec, taskRef) {
+    const db = store.getDb();
+    const stmt = db.prepare(`
+    INSERT INTO outcomes (entity_id, task_ref, verification_passed, latency_sec, created_at)
+    VALUES (?, ?, ?, ?, ?)
+  `);
+    stmt.run(store.entityId, taskRef ?? "", verificationPassed ? 1 : 0, latencySec ?? null, Date.now() / 1000);
+}
+/**
+ * Return the k most recent outcomes for this entity.
+ */
+export function getRecentOutcomes(store, k = 20) {
+    const db = store.getDb();
+    const stmt = db.prepare(`
+    SELECT task_ref, verification_passed, latency_sec, created_at
+    FROM outcomes WHERE entity_id = ? ORDER BY id DESC LIMIT ?
+  `);
+    const rows = stmt.all(store.entityId, k);
+    return rows.map((r) => ({
+        task_ref: r.task_ref,
+        verification_passed: r.verification_passed === 1,
+        latency_sec: r.latency_sec,
+        created_at: r.created_at,
+    }));
+}
+/**
+ * Return current strategy (prompt) for role, or null if not set.
+ */
+export function getStrategy(store, role) {
+    const db = store.getDb();
+    const stmt = db.prepare("SELECT content FROM strategies WHERE entity_id = ? AND role = ? ORDER BY version DESC LIMIT 1");
+    const row = stmt.get(store.entityId, role);
+    return row?.content ?? null;
+}
+/**
+ * Set strategy (prompt) for role; inserts new version.
+ */
+export function setStrategy(store, role, content) {
+    const db = store.getDb();
+    const versionStmt = db.prepare("SELECT COALESCE(MAX(version), 0) as maxVersion FROM strategies WHERE entity_id = ? AND role = ?");
+    const versionRow = versionStmt.get(store.entityId, role);
+    const version = (versionRow?.maxVersion ?? 0) + 1;
+    const stmt = db.prepare(`
+    INSERT INTO strategies (entity_id, role, version, content, created_at)
+    VALUES (?, ?, ?, ?, ?)
+  `);
+    stmt.run(store.entityId, role, version, content, Date.now() / 1000);
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

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

package/dist/signing.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Entity signing: sign artifacts for attribution and handoff between entities.
+ */
+/**
+ * Sign an artifact payload; return base64-encoded signature.
+ */
+export declare function signArtifact(entityId: string, payload: string | Buffer): string;
+/**
+ * Verify a signed artifact. Returns true if valid.
+ */
+export declare function verifyArtifact(entityId: string, payload: string | Buffer, signatureB64: string): boolean;
+/**
+ * Stable hash of artifact content (for storage/reference).
+ */
+export declare function artifactHash(payload: string | Buffer): string;
+//# sourceMappingURL=signing.d.ts.map

package/dist/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAK/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAUT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAG7D"}

package/dist/signing.js

@@ -0,0 +1,43 @@
+/**
+ * Entity signing: sign artifacts for attribution and handoff between entities.
+ */
+import crypto from "node:crypto";
+/**
+ * Secret for signing (from env MOLTBLOCK_SIGNING_KEY or entity-specific MOLTBLOCK_SIGNING_KEY_<id>).
+ */
+function getSecret(entityId) {
+    const envKey = process.env[`MOLTBLOCK_SIGNING_KEY_${entityId.toUpperCase()}`] ??
+        process.env["MOLTBLOCK_SIGNING_KEY"] ??
+        "";
+    const key = envKey || `default-secret-${entityId}`;
+    return Buffer.from(key, "utf-8");
+}
+/**
+ * Sign an artifact payload; return base64-encoded signature.
+ */
+export function signArtifact(entityId, payload) {
+    const data = typeof payload === "string" ? Buffer.from(payload, "utf-8") : payload;
+    const hmac = crypto.createHmac("sha256", getSecret(entityId));
+    hmac.update(data);
+    return hmac.digest("base64");
+}
+/**
+ * Verify a signed artifact. Returns true if valid.
+ */
+export function verifyArtifact(entityId, payload, signatureB64) {
+    try {
+        const expected = signArtifact(entityId, payload);
+        return crypto.timingSafeEqual(Buffer.from(expected, "base64"), Buffer.from(signatureB64, "base64"));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Stable hash of artifact content (for storage/reference).
+ */
+export function artifactHash(payload) {
+    const data = typeof payload === "string" ? Buffer.from(payload, "utf-8") : payload;
+    return crypto.createHash("sha256").update(data).digest("hex").slice(0, 32);
+}
+//# sourceMappingURL=signing.js.map

package/dist/signing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.js","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;GAEG;AACH,SAAS,SAAS,CAAC,QAAgB;IACjC,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,yBAAyB,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QACpC,EAAE,CAAC;IACL,MAAM,GAAG,GAAG,MAAM,IAAI,kBAAkB,QAAQ,EAAE,CAAC;IACnD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAwB;IACrE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACnF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAAwB,EACxB,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC,eAAe,CAC3B,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAC/B,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CACpC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAwB;IACnD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACnF,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared TypeScript interfaces for Moltblock.
+ */
+/** One role's LLM backend configuration */
+export interface ModelBinding {
+    backend: string;
+    baseUrl: string;
+    apiKey: string | null;
+    model: string;
+}
+/** JSON config binding entry (from moltblock.json) */
+export interface BindingEntry {
+    backend: string;
+    base_url: string;
+    model?: string;
+    api_key?: string | null;
+}
+/** Agent section in moltblock.json */
+export interface AgentConfig {
+    bindings?: Record<string, BindingEntry>;
+}
+/** Root config schema for moltblock.json */
+export interface MoltblockConfig {
+    agent?: AgentConfig;
+}
+/** Chat message format for LLM */
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+/** Verified memory entry from persistence */
+export interface VerifiedMemoryEntry {
+    artifact_ref: string;
+    summary: string | null;
+    content_preview: string | null;
+    created_at: number;
+}
+/** Checkpoint entry from persistence */
+export interface CheckpointEntry {
+    entity_version: string;
+    graph_hash: string;
+    memory_hash: string;
+    artifact_refs: string[];
+    created_at: number;
+}
+/** Outcome entry from persistence */
+export interface OutcomeEntry {
+    task_ref: string;
+    verification_passed: boolean;
+    latency_sec: number | null;
+    created_at: number;
+}
+/** Inbox entry for multi-entity handoff */
+export interface InboxEntry {
+    from_entity_id: string;
+    artifact_ref: string;
+    payload_text: string;
+    payload_hash: string;
+    signature: string;
+    created_at: number;
+}
+/** Strategy suggestion from improvement loop */
+export interface StrategySuggestion {
+    role: string;
+    suggestion: string;
+}
+/** Result from artifact verification */
+export interface ReceivedArtifact {
+    from_entity_id: string;
+    artifact_ref: string;
+    payload_text: string;
+    verified: boolean;
+}
+/** Governance configuration */
+export interface GovernanceConfig {
+    moltRateLimitSec: number;
+    allowedMoltTriggers: string[];
+    humanVetoPaused: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared TypeScript interfaces for Moltblock.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/verifier.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Verifier: run vitest on code artifact; gate authority and memory admission.
+ */
+import { WorkingMemory } from "./memory.js";
+/**
+ * Remove markdown code fence if present.
+ */
+export declare function extractCodeBlock(text: string): string;
+/**
+ * Write code (and optional test) to temp dir, run vitest, return (passed, stdout+stderr).
+ * If testCode is undefined, we only check that the code is syntactically valid (compiles).
+ */
+export declare function runVitestOnCode(code: string, testCode?: string): Promise<{
+    passed: boolean;
+    output: string;
+}>;
+/**
+ * Run verification on final_candidate. For Code Entity: run vitest.
+ * Sets verification_passed and verification_evidence; if pass, sets authoritative_artifact.
+ */
+export declare function runVerifier(memory: WorkingMemory, testCode?: string): Promise<void>;
+//# sourceMappingURL=verifier.d.ts.map

package/dist/verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../src/verifier.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAerD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsE9C;AAuFD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBzF"}