silo-agent 1.0.0

package/build/lib/heartbeat.js

@@ -0,0 +1,256 @@
+/**
+ * SILO — Heartbeat Daemon
+ *
+ * A cron-like scheduler for autonomous agent operation.
+ *
+ * When a user enables "fully autonomous" mode, the heartbeat daemon:
+ *   1. Periodically checks agent health (storage connectivity, balance, session state)
+ *   2. Runs diagnostic tasks and pushes fixes automatically
+ *   3. Auto-commits attestation sessions at configurable intervals
+ *   4. Syncs shared memory channels with other agents
+ *   5. Stores heartbeat records on 0G for audit trail
+ *
+ * Inspired by clawdbots' heartbeat pattern — adapted for 0G-backed agent orchestration.
+ */
+import { createHash } from "node:crypto";
+const DEFAULT_CONFIG = {
+    autonomousMode: false,
+    baseIntervalMs: 30_000,
+    maxHistorySize: 500,
+    persistHeartbeats: true,
+    heartbeatChannel: "silo:heartbeat",
+};
+export class HeartbeatDaemon {
+    vault;
+    sharedMemory;
+    config;
+    tasks = new Map();
+    taskTimers = new Map();
+    running = false;
+    heartbeatId;
+    sequenceNumber = 0;
+    startedAt = null;
+    taskHistory = [];
+    mainTimer = null;
+    constructor(vault, sharedMemory, config = {}) {
+        this.vault = vault;
+        this.sharedMemory = sharedMemory;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.heartbeatId = createHash("sha256")
+            .update(`heartbeat:${vault.address}:${Date.now()}:${Math.random()}`)
+            .digest("hex")
+            .slice(0, 16);
+    }
+    get id() { return this.heartbeatId; }
+    get isRunning() { return this.running; }
+    get isAutonomous() { return this.config.autonomousMode; }
+    /** Register a task with the heartbeat daemon */
+    registerTask(task) {
+        this.tasks.set(task.name, {
+            ...task,
+            lastRunAt: null,
+            runCount: 0,
+        });
+    }
+    /** Enable or disable autonomous mode at runtime */
+    setAutonomousMode(enabled) {
+        this.config.autonomousMode = enabled;
+    }
+    /** Register the default set of tasks for autonomous operation */
+    registerDefaultTasks() {
+        this.registerTask({
+            name: "health_check",
+            type: "health_check",
+            intervalMs: 30_000,
+            enabled: true,
+            handler: async (ctx) => {
+                const balance = await ctx.vault.getBalance();
+                const balanceNum = parseFloat(balance);
+                return {
+                    taskName: "health_check",
+                    taskType: "health_check",
+                    success: balanceNum > 0,
+                    timestamp: Date.now(),
+                    duration: 0,
+                    output: JSON.stringify({
+                        balance,
+                        sessionId: ctx.vault.sessionId,
+                        agentAddress: ctx.vault.address,
+                        lowBalance: balanceNum < 0.01,
+                    }),
+                };
+            },
+        });
+        this.registerTask({
+            name: "session_auto_commit",
+            type: "session_commit",
+            intervalMs: 300_000,
+            enabled: true,
+            handler: async (ctx) => {
+                if (!ctx.autonomousMode) {
+                    return {
+                        taskName: "session_auto_commit",
+                        taskType: "session_commit",
+                        success: true,
+                        timestamp: Date.now(),
+                        duration: 0,
+                        output: "Skipped — not in autonomous mode",
+                    };
+                }
+                const summary = ctx.vault.sessionSummary();
+                if (summary.includes("Events:  0")) {
+                    return {
+                        taskName: "session_auto_commit",
+                        taskType: "session_commit",
+                        success: true,
+                        timestamp: Date.now(),
+                        duration: 0,
+                        output: "Skipped — no events to commit",
+                    };
+                }
+                const result = await ctx.vault.commitSession();
+                return {
+                    taskName: "session_auto_commit",
+                    taskType: "session_commit",
+                    success: true,
+                    timestamp: Date.now(),
+                    duration: 0,
+                    output: JSON.stringify(result),
+                    rootHash: result.traceRootHash,
+                };
+            },
+        });
+        this.registerTask({
+            name: "memory_sync",
+            type: "memory_sync",
+            intervalMs: 15_000,
+            enabled: true,
+            handler: async (ctx) => {
+                const channels = ctx.sharedMemory.listChannels();
+                return {
+                    taskName: "memory_sync",
+                    taskType: "memory_sync",
+                    success: true,
+                    timestamp: Date.now(),
+                    duration: 0,
+                    output: JSON.stringify({
+                        channelCount: channels.length,
+                        channels: channels.map(c => ({
+                            name: c.name,
+                            entries: c.entryCount,
+                            subscribers: c.subscribers.length,
+                        })),
+                    }),
+                };
+            },
+        });
+    }
+    /**
+     * Start the heartbeat daemon. Begins running all registered tasks on their intervals.
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.startedAt = Date.now();
+        for (const [name, task] of this.tasks) {
+            if (!task.enabled)
+                continue;
+            const timer = setInterval(async () => {
+                await this.executeTask(task);
+            }, task.intervalMs);
+            this.taskTimers.set(name, timer);
+        }
+        this.mainTimer = setInterval(async () => {
+            await this.beat();
+        }, this.config.baseIntervalMs);
+        this.sharedMemory.createChannel(this.config.heartbeatChannel);
+    }
+    /** Stop the heartbeat daemon */
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        for (const timer of this.taskTimers.values()) {
+            clearInterval(timer);
+        }
+        this.taskTimers.clear();
+        if (this.mainTimer) {
+            clearInterval(this.mainTimer);
+            this.mainTimer = null;
+        }
+    }
+    async executeTask(task) {
+        const startTime = Date.now();
+        let result;
+        try {
+            const ctx = {
+                vault: this.vault,
+                sharedMemory: this.sharedMemory,
+                heartbeatId: this.heartbeatId,
+                autonomousMode: this.config.autonomousMode,
+                taskHistory: this.taskHistory,
+            };
+            result = await task.handler(ctx);
+            result.duration = Date.now() - startTime;
+        }
+        catch (error) {
+            result = {
+                taskName: task.name,
+                taskType: task.type,
+                success: false,
+                timestamp: Date.now(),
+                duration: Date.now() - startTime,
+                error: error.message,
+            };
+            this.config.onError?.(error, task);
+        }
+        task.lastRunAt = Date.now();
+        task.runCount++;
+        this.taskHistory.push(result);
+        if (this.taskHistory.length > this.config.maxHistorySize) {
+            this.taskHistory.shift();
+        }
+        this.config.onTaskComplete?.(result);
+        return result;
+    }
+    /** The main heartbeat — runs on the base interval */
+    async beat() {
+        this.sequenceNumber++;
+        const record = {
+            heartbeatId: this.heartbeatId,
+            agentId: this.vault.address,
+            timestamp: Date.now(),
+            sequenceNumber: this.sequenceNumber,
+            tasksRun: this.taskHistory.slice(-10),
+            autonomousMode: this.config.autonomousMode,
+            uptime: this.startedAt ? Date.now() - this.startedAt : 0,
+        };
+        this.config.onBeat?.(record);
+        if (this.config.persistHeartbeats && this.config.autonomousMode) {
+            try {
+                await this.sharedMemory.write(this.config.heartbeatChannel, JSON.stringify(record), { type: "heartbeat", seq: this.sequenceNumber });
+            }
+            catch { }
+        }
+    }
+    /** Get the current heartbeat status */
+    status() {
+        return {
+            running: this.running,
+            autonomous: this.config.autonomousMode,
+            heartbeatId: this.heartbeatId,
+            uptime: this.startedAt ? Date.now() - this.startedAt : 0,
+            sequenceNumber: this.sequenceNumber,
+            registeredTasks: Array.from(this.tasks.values()).map(t => ({
+                name: t.name,
+                type: t.type,
+                enabled: t.enabled,
+                lastRunAt: t.lastRunAt,
+                runCount: t.runCount,
+            })),
+            recentResults: this.taskHistory.slice(-20),
+        };
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/build/lib/heartbeat.js.map

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

package/build/lib/memory-coordinator.d.ts

@@ -0,0 +1,150 @@
+/**
+ * SILO — Memory Coordinator
+ *
+ * Solves the multi-agent coordination problem for shared memory:
+ *
+ *   1. Channel Locks — Prevents concurrent writes to the same channel.
+ *      Agents acquire a lock before writing, release after. TTL-based
+ *      expiry prevents deadlocks from crashed agents.
+ *
+ *   2. Optimistic Concurrency — Every write must include the expected
+ *      prevRootHash. If another agent wrote in between, the write is
+ *      rejected with a CONFLICT error. The agent must re-read and retry.
+ *
+ *   3. Fork Detection — If two agents somehow both write with the same
+ *      prevRootHash (e.g., lock wasn't used), the coordinator detects
+ *      the fork and flags it for resolution.
+ *
+ *   4. Version Vector — Each channel tracks a monotonic version counter.
+ *      Agents include the version they read from, enabling the server
+ *      to detect stale writes without comparing root hashes.
+ *
+ * The coordinator runs on the API server (single source of truth).
+ * Agents interact with it via REST or WebSocket before writing to 0G.
+ *
+ * Protocol:
+ *   1. Agent calls acquireLock(channel) → gets lockToken
+ *   2. Agent reads current head via getHead(channel) → {headRootHash, version}
+ *   3. Agent writes to 0G with prevRootHash = headRootHash
+ *   4. Agent calls commitWrite(channel, newRootHash, expectedVersion, lockToken)
+ *   5. Coordinator validates version match → updates head → releases lock
+ *   6. Coordinator broadcasts update to all subscribers
+ */
+export interface ChannelLock {
+    channel: string;
+    holderId: string;
+    token: string;
+    acquiredAt: number;
+    ttlMs: number;
+    expiresAt: number;
+}
+export interface ChannelHead {
+    channel: string;
+    headRootHash: string | null;
+    version: number;
+    lastWriterId: string | null;
+    lastWriteAt: number | null;
+}
+export interface WriteReceipt {
+    channel: string;
+    rootHash: string;
+    prevRootHash: string | null;
+    version: number;
+    writerId: string;
+    timestamp: number;
+}
+export interface ForkRecord {
+    channel: string;
+    detectedAt: number;
+    branchA: {
+        rootHash: string;
+        writerId: string;
+        version: number;
+    };
+    branchB: {
+        rootHash: string;
+        writerId: string;
+        version: number;
+    };
+    commonAncestor: string | null;
+    resolved: boolean;
+    resolution?: "keep_a" | "keep_b" | "merge";
+}
+export type ConflictError = {
+    code: "CONFLICT";
+    message: string;
+    currentVersion: number;
+    currentHead: string | null;
+    yourVersion: number;
+};
+export type LockError = {
+    code: "LOCKED";
+    message: string;
+    holder: string;
+    expiresAt: number;
+};
+export interface CoordinatorConfig {
+    defaultLockTtlMs: number;
+    maxLockTtlMs: number;
+    enableForkDetection: boolean;
+    onForkDetected?: (fork: ForkRecord) => void;
+    onHeadUpdated?: (receipt: WriteReceipt) => void;
+}
+export declare class MemoryCoordinator {
+    private locks;
+    private heads;
+    private writeLog;
+    private forks;
+    private config;
+    private cleanupTimer;
+    constructor(config?: Partial<CoordinatorConfig>);
+    /** Initialize or get the tracked head for a channel */
+    ensureChannel(channel: string): ChannelHead;
+    /**
+     * Acquire a write lock on a channel.
+     * Returns a lock token that must be passed to commitWrite.
+     * Rejects if channel is already locked by another agent.
+     */
+    acquireLock(channel: string, agentId: string, ttlMs?: number): ChannelLock | LockError;
+    /** Release a lock (requires the token or the holder's agentId) */
+    releaseLock(channel: string, tokenOrAgentId: string): boolean;
+    /** Check if a channel is locked and by whom */
+    getLock(channel: string): ChannelLock | null;
+    /** Get the current head of a channel (what agents read before writing) */
+    getHead(channel: string): ChannelHead;
+    /**
+     * Commit a write to a channel.
+     *
+     * This is the critical coordination point:
+     *   - Validates the lock token
+     *   - Checks the expectedVersion matches current version (optimistic concurrency)
+     *   - Detects forks if the prevRootHash doesn't match current head
+     *   - Updates the head and increments version
+     *   - Releases the lock
+     *   - Returns a receipt
+     */
+    commitWrite(channel: string, newRootHash: string, prevRootHash: string | null, expectedVersion: number, writerId: string, lockToken?: string): WriteReceipt | ConflictError;
+    /**
+     * Coordinated write — acquire lock, check version, commit, release.
+     * This is the high-level "safe write" that agents should use.
+     */
+    beginWrite(channel: string, agentId: string): {
+        head: ChannelHead;
+        lock: ChannelLock;
+    } | LockError;
+    /** Get the write history for a channel */
+    getWriteLog(channel: string, limit?: number): WriteReceipt[];
+    /** Get all detected forks */
+    getForks(channel?: string): ForkRecord[];
+    /** Resolve a fork (mark it as handled) */
+    resolveFork(channel: string, resolution: "keep_a" | "keep_b" | "merge", resolvedHead?: string): boolean;
+    /** List all channels with their coordination state */
+    listChannels(): {
+        head: ChannelHead;
+        locked: boolean;
+        lockHolder?: string;
+    }[];
+    private cleanExpiredLocks;
+    /** Shutdown the coordinator */
+    destroy(): void;
+}

package/build/lib/memory-coordinator.js

@@ -0,0 +1,249 @@
+/**
+ * SILO — Memory Coordinator
+ *
+ * Solves the multi-agent coordination problem for shared memory:
+ *
+ *   1. Channel Locks — Prevents concurrent writes to the same channel.
+ *      Agents acquire a lock before writing, release after. TTL-based
+ *      expiry prevents deadlocks from crashed agents.
+ *
+ *   2. Optimistic Concurrency — Every write must include the expected
+ *      prevRootHash. If another agent wrote in between, the write is
+ *      rejected with a CONFLICT error. The agent must re-read and retry.
+ *
+ *   3. Fork Detection — If two agents somehow both write with the same
+ *      prevRootHash (e.g., lock wasn't used), the coordinator detects
+ *      the fork and flags it for resolution.
+ *
+ *   4. Version Vector — Each channel tracks a monotonic version counter.
+ *      Agents include the version they read from, enabling the server
+ *      to detect stale writes without comparing root hashes.
+ *
+ * The coordinator runs on the API server (single source of truth).
+ * Agents interact with it via REST or WebSocket before writing to 0G.
+ *
+ * Protocol:
+ *   1. Agent calls acquireLock(channel) → gets lockToken
+ *   2. Agent reads current head via getHead(channel) → {headRootHash, version}
+ *   3. Agent writes to 0G with prevRootHash = headRootHash
+ *   4. Agent calls commitWrite(channel, newRootHash, expectedVersion, lockToken)
+ *   5. Coordinator validates version match → updates head → releases lock
+ *   6. Coordinator broadcasts update to all subscribers
+ */
+import { createHash } from "node:crypto";
+const DEFAULT_CONFIG = {
+    defaultLockTtlMs: 30_000,
+    maxLockTtlMs: 120_000,
+    enableForkDetection: true,
+};
+export class MemoryCoordinator {
+    locks = new Map();
+    heads = new Map();
+    writeLog = new Map();
+    forks = [];
+    config;
+    cleanupTimer = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.cleanupTimer = setInterval(() => this.cleanExpiredLocks(), 5_000);
+    }
+    /** Initialize or get the tracked head for a channel */
+    ensureChannel(channel) {
+        if (!this.heads.has(channel)) {
+            this.heads.set(channel, {
+                channel,
+                headRootHash: null,
+                version: 0,
+                lastWriterId: null,
+                lastWriteAt: null,
+            });
+            this.writeLog.set(channel, []);
+        }
+        return this.heads.get(channel);
+    }
+    /**
+     * Acquire a write lock on a channel.
+     * Returns a lock token that must be passed to commitWrite.
+     * Rejects if channel is already locked by another agent.
+     */
+    acquireLock(channel, agentId, ttlMs) {
+        this.cleanExpiredLocks();
+        this.ensureChannel(channel);
+        const existing = this.locks.get(channel);
+        if (existing && existing.holderId !== agentId) {
+            return {
+                code: "LOCKED",
+                message: `Channel "${channel}" is locked by ${existing.holderId.slice(0, 8)}... (expires in ${Math.round((existing.expiresAt - Date.now()) / 1000)}s)`,
+                holder: existing.holderId,
+                expiresAt: existing.expiresAt,
+            };
+        }
+        if (existing && existing.holderId === agentId) {
+            existing.expiresAt = Date.now() + (ttlMs ?? this.config.defaultLockTtlMs);
+            return existing;
+        }
+        const effectiveTtl = Math.min(ttlMs ?? this.config.defaultLockTtlMs, this.config.maxLockTtlMs);
+        const lock = {
+            channel,
+            holderId: agentId,
+            token: createHash("sha256")
+                .update(`lock:${channel}:${agentId}:${Date.now()}:${Math.random()}`)
+                .digest("hex")
+                .slice(0, 32),
+            acquiredAt: Date.now(),
+            ttlMs: effectiveTtl,
+            expiresAt: Date.now() + effectiveTtl,
+        };
+        this.locks.set(channel, lock);
+        return lock;
+    }
+    /** Release a lock (requires the token or the holder's agentId) */
+    releaseLock(channel, tokenOrAgentId) {
+        const lock = this.locks.get(channel);
+        if (!lock)
+            return true;
+        if (lock.token === tokenOrAgentId || lock.holderId === tokenOrAgentId) {
+            this.locks.delete(channel);
+            return true;
+        }
+        return false;
+    }
+    /** Check if a channel is locked and by whom */
+    getLock(channel) {
+        this.cleanExpiredLocks();
+        return this.locks.get(channel) ?? null;
+    }
+    /** Get the current head of a channel (what agents read before writing) */
+    getHead(channel) {
+        return this.ensureChannel(channel);
+    }
+    /**
+     * Commit a write to a channel.
+     *
+     * This is the critical coordination point:
+     *   - Validates the lock token
+     *   - Checks the expectedVersion matches current version (optimistic concurrency)
+     *   - Detects forks if the prevRootHash doesn't match current head
+     *   - Updates the head and increments version
+     *   - Releases the lock
+     *   - Returns a receipt
+     */
+    commitWrite(channel, newRootHash, prevRootHash, expectedVersion, writerId, lockToken) {
+        const head = this.ensureChannel(channel);
+        if (lockToken) {
+            const lock = this.locks.get(channel);
+            if (lock && lock.token !== lockToken && lock.holderId !== writerId) {
+                return {
+                    code: "CONFLICT",
+                    message: `Invalid lock token for channel "${channel}"`,
+                    currentVersion: head.version,
+                    currentHead: head.headRootHash,
+                    yourVersion: expectedVersion,
+                };
+            }
+        }
+        if (expectedVersion !== head.version) {
+            if (this.config.enableForkDetection && prevRootHash !== head.headRootHash) {
+                const fork = {
+                    channel,
+                    detectedAt: Date.now(),
+                    branchA: { rootHash: head.headRootHash ?? "null", writerId: head.lastWriterId ?? "unknown", version: head.version },
+                    branchB: { rootHash: newRootHash, writerId, version: expectedVersion },
+                    commonAncestor: prevRootHash,
+                    resolved: false,
+                };
+                this.forks.push(fork);
+                this.config.onForkDetected?.(fork);
+            }
+            return {
+                code: "CONFLICT",
+                message: `Version mismatch on "${channel}": expected ${expectedVersion}, current is ${head.version}. Re-read and retry.`,
+                currentVersion: head.version,
+                currentHead: head.headRootHash,
+                yourVersion: expectedVersion,
+            };
+        }
+        head.headRootHash = newRootHash;
+        head.version++;
+        head.lastWriterId = writerId;
+        head.lastWriteAt = Date.now();
+        const receipt = {
+            channel,
+            rootHash: newRootHash,
+            prevRootHash,
+            version: head.version,
+            writerId,
+            timestamp: Date.now(),
+        };
+        const log = this.writeLog.get(channel);
+        log.push(receipt);
+        if (log.length > 200)
+            log.shift();
+        this.releaseLock(channel, writerId);
+        this.config.onHeadUpdated?.(receipt);
+        return receipt;
+    }
+    /**
+     * Coordinated write — acquire lock, check version, commit, release.
+     * This is the high-level "safe write" that agents should use.
+     */
+    beginWrite(channel, agentId) {
+        const lockResult = this.acquireLock(channel, agentId);
+        if ("code" in lockResult)
+            return lockResult;
+        const head = this.getHead(channel);
+        return { head, lock: lockResult };
+    }
+    /** Get the write history for a channel */
+    getWriteLog(channel, limit = 50) {
+        const log = this.writeLog.get(channel) ?? [];
+        return log.slice(-limit);
+    }
+    /** Get all detected forks */
+    getForks(channel) {
+        if (channel)
+            return this.forks.filter(f => f.channel === channel);
+        return [...this.forks];
+    }
+    /** Resolve a fork (mark it as handled) */
+    resolveFork(channel, resolution, resolvedHead) {
+        const fork = this.forks.find(f => f.channel === channel && !f.resolved);
+        if (!fork)
+            return false;
+        fork.resolved = true;
+        fork.resolution = resolution;
+        if (resolvedHead) {
+            const head = this.ensureChannel(channel);
+            head.headRootHash = resolvedHead;
+            head.version++;
+        }
+        return true;
+    }
+    /** List all channels with their coordination state */
+    listChannels() {
+        return Array.from(this.heads.values()).map(head => {
+            const lock = this.locks.get(head.channel);
+            return {
+                head,
+                locked: !!lock,
+                lockHolder: lock?.holderId,
+            };
+        });
+    }
+    cleanExpiredLocks() {
+        const now = Date.now();
+        for (const [channel, lock] of this.locks) {
+            if (lock.expiresAt <= now) {
+                this.locks.delete(channel);
+            }
+        }
+    }
+    /** Shutdown the coordinator */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=memory-coordinator.js.map

package/build/lib/memory-coordinator.js.map

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