@sequence0/blockclaw 2.0.0

package/dist/ai/brain.js

@@ -0,0 +1,117 @@
+import { isAgentRunning } from "../agent/process.js";
+import { RuleEngine } from "./rules.js";
+import { SYSTEM_PROMPT, buildContext } from "./prompts.js";
+import { getSystemInfo } from "../utils/platform.js";
+import { readBlockclawConfig } from "../agent/config.js";
+import { logger } from "../utils/logger.js";
+/** AI Brain — orchestrates responses from rules engine or LLM */
+export class Brain {
+    client;
+    memory;
+    rules;
+    provider;
+    constructor(client, memory) {
+        this.client = client;
+        this.memory = memory;
+        this.rules = new RuleEngine(client, memory);
+        this.provider = this.detectProvider();
+    }
+    /** Process a query and return a response */
+    async ask(question) {
+        if (this.provider === "rules") {
+            return this.rules.query(question);
+        }
+        try {
+            const context = await this.gatherContext();
+            return await this.callLLM(question, context);
+        }
+        catch (err) {
+            logger.debug(`LLM failed, falling back to rules: ${err.message}`);
+            return this.rules.query(question);
+        }
+    }
+    getProvider() {
+        return this.provider;
+    }
+    detectProvider() {
+        const config = readBlockclawConfig();
+        if (config.anthropic_api_key)
+            return "claude";
+        if (config.ollama_url)
+            return "ollama";
+        return "rules";
+    }
+    async gatherContext() {
+        const { running, pid } = isAgentRunning();
+        let status;
+        let health;
+        if (running) {
+            try {
+                const s = await this.client.status();
+                status = s;
+            }
+            catch { }
+            try {
+                const h = await this.client.committeeHealth();
+                health = h;
+            }
+            catch { }
+        }
+        const issues = this.memory.getIssues(5);
+        const system = getSystemInfo();
+        return buildContext({
+            running,
+            pid,
+            status,
+            health,
+            issues: issues.map((i) => ({ summary: i.summary, occurrences: i.occurrences })),
+            system: system,
+        });
+    }
+    async callLLM(question, context) {
+        if (this.provider === "claude")
+            return this.callClaude(question, context);
+        if (this.provider === "ollama")
+            return this.callOllama(question, context);
+        return this.rules.query(question);
+    }
+    async callClaude(question, context) {
+        const config = readBlockclawConfig();
+        if (!config.anthropic_api_key)
+            throw new Error("No Anthropic API key configured");
+        // Dynamic import — optional peer dependency
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import("@anthropic-ai/sdk");
+        const Anthropic = mod.default;
+        const client = new Anthropic({ apiKey: config.anthropic_api_key });
+        const response = await client.messages.create({
+            model: "claude-haiku-4-5-20251001",
+            max_tokens: 1024,
+            system: SYSTEM_PROMPT,
+            messages: [
+                { role: "user", content: `${context}\n\nQuestion: ${question}` },
+            ],
+        });
+        const textBlock = response.content.find((b) => b.type === "text");
+        return textBlock?.text ?? "No response generated.";
+    }
+    async callOllama(question, context) {
+        const config = readBlockclawConfig();
+        const url = config.ollama_url ?? "http://localhost:11434";
+        const response = await fetch(`${url}/api/generate`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                model: "llama3.2",
+                prompt: `${SYSTEM_PROMPT}\n\n${context}\n\nQuestion: ${question}`,
+                stream: false,
+            }),
+            signal: AbortSignal.timeout(30000),
+        });
+        if (!response.ok)
+            throw new Error(`Ollama error: ${response.status}`);
+        const data = await response.json();
+        return data.response ?? "No response generated.";
+    }
+}
+//# sourceMappingURL=brain.js.map

package/dist/ai/brain.js.map

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

package/dist/ai/prompts.d.ts

@@ -0,0 +1,15 @@
+/** System prompt for AI-powered responses */
+export declare const SYSTEM_PROMPT = "You are BlockClaw, an AI agent managing a Sequence0 network node.\n\nSequence0 is a decentralized threshold signing network supporting 81+ blockchains.\nNode runners operate agent nodes that participate in distributed key generation (DKG),\nFROST threshold signing, key refresh, and committee health monitoring.\n\nYour role:\n- Monitor and manage the agent node autonomously\n- Answer questions about the node's status, health, and configuration\n- Diagnose and fix common issues (restarts, port conflicts, peer connectivity)\n- Explain concepts related to threshold signing, DKG, committee health\n\nKey concepts:\n- DKG (Distributed Key Generation): Protocol where agents collectively generate a shared key\n- FROST: Flexible Round-Optimized Schnorr Threshold signatures\n- Committee: Group of agents that share a wallet's key material\n- Threshold: Minimum number of agents needed to produce a signature (e.g., 2-of-3)\n- Key Refresh: Periodic rotation of key shares without changing the public key\n- Key Reshare: Adding/removing committee members by redistributing shares\n\nStatus meanings:\n- Healthy: All committee members responsive\n- Degraded: Some members unresponsive but above threshold\n- AtRisk: Barely above threshold, reshare recommended\n- Critical: At or below threshold, signatures may fail\n- Dead: Below threshold, committee non-functional\n\nAlways be concise and actionable. Suggest specific commands when relevant.";
+/** Build context for the AI from current state */
+export declare function buildContext(state: {
+    running: boolean;
+    pid?: number | null;
+    status?: Record<string, unknown>;
+    health?: Record<string, unknown>[];
+    issues?: Array<{
+        summary: string;
+        occurrences: number;
+    }>;
+    system?: Record<string, string | number>;
+}): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/ai/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,eAAO,MAAM,aAAa,s6CA2BiD,CAAC;AAE5E,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,CAyCT"}

package/dist/ai/prompts.js

@@ -0,0 +1,67 @@
+/** System prompt for AI-powered responses */
+export const SYSTEM_PROMPT = `You are BlockClaw, an AI agent managing a Sequence0 network node.
+
+Sequence0 is a decentralized threshold signing network supporting 81+ blockchains.
+Node runners operate agent nodes that participate in distributed key generation (DKG),
+FROST threshold signing, key refresh, and committee health monitoring.
+
+Your role:
+- Monitor and manage the agent node autonomously
+- Answer questions about the node's status, health, and configuration
+- Diagnose and fix common issues (restarts, port conflicts, peer connectivity)
+- Explain concepts related to threshold signing, DKG, committee health
+
+Key concepts:
+- DKG (Distributed Key Generation): Protocol where agents collectively generate a shared key
+- FROST: Flexible Round-Optimized Schnorr Threshold signatures
+- Committee: Group of agents that share a wallet's key material
+- Threshold: Minimum number of agents needed to produce a signature (e.g., 2-of-3)
+- Key Refresh: Periodic rotation of key shares without changing the public key
+- Key Reshare: Adding/removing committee members by redistributing shares
+
+Status meanings:
+- Healthy: All committee members responsive
+- Degraded: Some members unresponsive but above threshold
+- AtRisk: Barely above threshold, reshare recommended
+- Critical: At or below threshold, signatures may fail
+- Dead: Below threshold, committee non-functional
+
+Always be concise and actionable. Suggest specific commands when relevant.`;
+/** Build context for the AI from current state */
+export function buildContext(state) {
+    const lines = ["Current state:"];
+    if (state.running) {
+        lines.push(`Agent: Running (PID ${state.pid})`);
+    }
+    else {
+        lines.push("Agent: Stopped");
+    }
+    if (state.status) {
+        lines.push(`Peers: ${state.status.connected_peers ?? 0}`);
+        lines.push(`Wallets: ${Array.isArray(state.status.wallets) ? state.status.wallets.length : 0}`);
+        lines.push(`Network: ${state.status.network ?? "unknown"}`);
+    }
+    if (state.health && state.health.length > 0) {
+        const unhealthy = state.health.filter((h) => ["degraded", "atrisk", "critical", "dead"].includes(String(h.status).toLowerCase()));
+        if (unhealthy.length > 0) {
+            lines.push(`Unhealthy committees: ${unhealthy.length}`);
+            for (const h of unhealthy.slice(0, 3)) {
+                lines.push(`  - ${h.wallet_id}: ${h.status}`);
+            }
+        }
+        else {
+            lines.push(`All ${state.health.length} committees healthy`);
+        }
+    }
+    if (state.issues && state.issues.length > 0) {
+        lines.push(`Recent issues:`);
+        for (const i of state.issues.slice(0, 3)) {
+            lines.push(`  - ${i.summary} (${i.occurrences}x)`);
+        }
+    }
+    if (state.system) {
+        lines.push(`System: ${state.system.platform}-${state.system.arch}, ${state.system.freeMemoryGB}GB free`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=prompts.js.map

package/dist/ai/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;2EA2B8C,CAAC;AAE5E,kDAAkD;AAClD,MAAM,UAAU,YAAY,CAAC,KAO5B;IACC,MAAM,KAAK,GAAa,CAAC,gBAAgB,CAAC,CAAC;IAE3C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChG,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1C,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CACpF,CAAC;QACF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,yBAAyB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YACxD,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,qBAAqB,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,YAAY,SAAS,CAAC,CAAC;IAC3G,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/ai/rules.d.ts

@@ -0,0 +1,19 @@
+import { AgentClient } from "../agent/client.js";
+import { Memory } from "../core/memory.js";
+/** Rule-based response engine — no LLM needed */
+export declare class RuleEngine {
+    private client;
+    private memory;
+    constructor(client: AgentClient, memory: Memory);
+    /** Process a natural language query and return a response */
+    query(input: string): Promise<string>;
+    private statusResponse;
+    private peerResponse;
+    private walletResponse;
+    private healthResponse;
+    private issueResponse;
+    private networkResponse;
+    private helpResponse;
+    private systemResponse;
+}
+//# sourceMappingURL=rules.d.ts.map

package/dist/ai/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/ai/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAwB,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,iDAAiD;AACjD,qBAAa,UAAU;IAEnB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;gBADN,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM;IAGxB,6DAA6D;IACvD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAuB7B,cAAc;YAgBd,YAAY;YAYZ,cAAc;YAad,cAAc;IAmB5B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,cAAc;CASvB"}

package/dist/ai/rules.js

@@ -0,0 +1,143 @@
+import { readBlockclawConfig, readAgentConfig } from "../agent/config.js";
+import { isAgentRunning } from "../agent/process.js";
+import { getSystemInfo } from "../utils/platform.js";
+import { VERSION } from "../version.js";
+/** Rule-based response engine — no LLM needed */
+export class RuleEngine {
+    client;
+    memory;
+    constructor(client, memory) {
+        this.client = client;
+        this.memory = memory;
+    }
+    /** Process a natural language query and return a response */
+    async query(input) {
+        const q = input.toLowerCase().trim();
+        if (matches(q, ["status", "how", "running", "alive", "up"]))
+            return this.statusResponse();
+        if (matches(q, ["peer", "peers", "connected", "connections"]))
+            return this.peerResponse();
+        if (matches(q, ["wallet", "wallets", "balance", "address"]))
+            return this.walletResponse();
+        if (matches(q, ["health", "committee", "healthy", "degraded"]))
+            return this.healthResponse();
+        if (matches(q, ["issue", "problem", "error", "wrong", "fail"]))
+            return this.issueResponse();
+        if (matches(q, ["network", "mainnet", "testnet", "chain"]))
+            return this.networkResponse();
+        if (matches(q, ["help", "what can", "commands", "how do"]))
+            return this.helpResponse();
+        if (matches(q, ["system", "cpu", "memory", "disk", "hardware"]))
+            return this.systemResponse();
+        if (matches(q, ["version", "update"]))
+            return `BlockClaw v${VERSION}. Run 'blockclaw update --check' to check for updates.`;
+        if (matches(q, ["restart", "reboot", "fix"]))
+            return "To restart the agent: `blockclaw restart`\nTo run diagnostics: `blockclaw doctor`";
+        return `I'm not sure how to answer that. Try:\n` +
+            `  • "status" — check agent status\n` +
+            `  • "peers" — show peer connections\n` +
+            `  • "health" — committee health\n` +
+            `  • "wallets" — list wallets\n` +
+            `  • "issues" — recent problems\n` +
+            `  • "help" — available commands`;
+    }
+    async statusResponse() {
+        const { running, pid } = isAgentRunning();
+        if (!running)
+            return "Agent is not running. Start it with: `blockclaw start`";
+        try {
+            const status = await this.client.status();
+            return `Agent is running (PID ${pid}).\n` +
+                `Peers: ${status.connected_peers}\n` +
+                `Wallets: ${status.wallets.length}\n` +
+                `Active DKG: ${status.active_dkg_sessions}\n` +
+                `Active Signing: ${status.active_signing_sessions}`;
+        }
+        catch {
+            return `Agent process is running (PID ${pid}) but API is not responding. It may still be starting up.`;
+        }
+    }
+    async peerResponse() {
+        try {
+            const peers = await this.client.peers();
+            if (peers.length === 0)
+                return "No peers connected. The agent may be bootstrapping.";
+            return `Connected to ${peers.length} peer(s):\n` +
+                peers.slice(0, 5).map((p) => `  • ${p.peer_id}`).join("\n") +
+                (peers.length > 5 ? `\n  ... and ${peers.length - 5} more` : "");
+        }
+        catch {
+            return "Could not fetch peer info. Is the agent running?";
+        }
+    }
+    async walletResponse() {
+        try {
+            const wallets = await this.client.wallets();
+            if (wallets.length === 0)
+                return "No wallets. Create one with: `blockclaw wallet create --id <name>`";
+            return `${wallets.length} wallet(s):\n` +
+                wallets.slice(0, 5).map((w) => `  • ${w.wallet_id} (${w.chain}) — ${w.address}`).join("\n");
+        }
+        catch {
+            return "Could not fetch wallet info. Is the agent running?";
+        }
+    }
+    async healthResponse() {
+        try {
+            const committees = await this.client.committeeHealth();
+            if (committees.length === 0)
+                return "No committees found.";
+            const degraded = committees.filter((c) => ["degraded", "atrisk", "critical", "dead"].includes(c.status.toLowerCase()));
+            if (degraded.length === 0)
+                return `All ${committees.length} committee(s) are healthy.`;
+            return `${degraded.length} committee(s) need attention:\n` +
+                degraded.map((c) => `  • ${c.wallet_id}: ${c.status} (${c.alive}/${c.total} alive)`).join("\n");
+        }
+        catch {
+            return "Could not fetch health info. Is the agent running?";
+        }
+    }
+    issueResponse() {
+        const issues = this.memory.getIssues(5);
+        if (issues.length === 0)
+            return "No recent issues recorded.";
+        return `Recent issues:\n` +
+            issues.map((i) => `  • ${i.summary} (${i.occurrences}x, last: ${new Date(i.lastSeen).toLocaleString()})`).join("\n");
+    }
+    networkResponse() {
+        const config = readBlockclawConfig();
+        const agentConfig = readAgentConfig();
+        return `Network: ${config.network ?? agentConfig?.network ?? "mainnet"}\n` +
+            `API Port: ${config.api_port ?? agentConfig?.api_port ?? 8080}\n` +
+            `P2P Port: ${agentConfig?.port ?? 9000}`;
+    }
+    helpResponse() {
+        return `Available commands:\n` +
+            `  blockclaw start    — Start the agent\n` +
+            `  blockclaw stop     — Stop the agent\n` +
+            `  blockclaw restart  — Restart the agent\n` +
+            `  blockclaw status   — Show agent status\n` +
+            `  blockclaw health   — Committee health\n` +
+            `  blockclaw wallet   — Wallet management\n` +
+            `  blockclaw logs     — View agent logs\n` +
+            `  blockclaw doctor   — Run diagnostics\n` +
+            `  blockclaw daemon   — Background daemon\n` +
+            `  blockclaw config   — Configuration\n` +
+            `  blockclaw update   — Check for updates\n` +
+            `  blockclaw ask      — Ask a question\n` +
+            `  blockclaw info     — System info`;
+    }
+    systemResponse() {
+        const info = getSystemInfo();
+        return `System Info:\n` +
+            `  Platform: ${info.platform}-${info.arch}\n` +
+            `  Node.js: ${info.nodeVersion}\n` +
+            `  CPUs: ${info.cpus}\n` +
+            `  Memory: ${info.freeMemoryGB} GB free / ${info.totalMemoryGB} GB total\n` +
+            `  Uptime: ${info.uptime}`;
+    }
+}
+function matches(input, keywords) {
+    return keywords.some((kw) => input.includes(kw));
+}
+//# sourceMappingURL=rules.js.map

package/dist/ai/rules.js.map

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

package/dist/core/detector.d.ts

@@ -0,0 +1,16 @@
+export interface SystemRequirements {
+    passed: boolean;
+    checks: DiagnosticCheck[];
+}
+export interface DiagnosticCheck {
+    name: string;
+    status: "pass" | "warn" | "fail";
+    message: string;
+}
+/** Detect hardware and check system requirements */
+export declare function detectSystem(): Promise<SystemRequirements>;
+/** Check port availability for P2P and API ports */
+export declare function checkPorts(p2pPort: number, apiPort: number): Promise<DiagnosticCheck[]>;
+/** Suggest optimal configuration based on hardware */
+export declare function suggestConfig(): Record<string, string | number>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/core/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/core/detector.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,wBAAsB,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAkDhE;AAED,oDAAoD;AACpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAkB7F;AAED,sDAAsD;AACtD,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAsB/D"}

package/dist/core/detector.js

@@ -0,0 +1,90 @@
+import { getSystemInfo, getDiskUsage } from "../utils/platform.js";
+import { isPortAvailable } from "../agent/process.js";
+import { SEQUENCE0_DIR } from "../utils/paths.js";
+import { formatBytes } from "../utils/format.js";
+/** Detect hardware and check system requirements */
+export async function detectSystem() {
+    const checks = [];
+    const info = getSystemInfo();
+    // Node.js version
+    const nodeVersion = parseInt(info.nodeVersion.replace("v", ""));
+    checks.push({
+        name: "Node.js Version",
+        status: nodeVersion >= 18 ? "pass" : "fail",
+        message: nodeVersion >= 18
+            ? `${info.nodeVersion} (OK)`
+            : `${info.nodeVersion} (requires >= 18.0.0)`,
+    });
+    // CPU cores
+    checks.push({
+        name: "CPU Cores",
+        status: info.cpus >= 2 ? "pass" : "warn",
+        message: `${info.cpus} cores${info.cpus < 2 ? " (2+ recommended)" : ""}`,
+    });
+    // Memory
+    const totalGB = parseFloat(info.totalMemoryGB);
+    const freeGB = parseFloat(info.freeMemoryGB);
+    checks.push({
+        name: "Memory",
+        status: totalGB >= 2 ? (freeGB >= 0.5 ? "pass" : "warn") : "fail",
+        message: `${info.freeMemoryGB} GB free / ${info.totalMemoryGB} GB total${totalGB < 2 ? " (2 GB minimum)" : ""}`,
+    });
+    // Disk space
+    const disk = await getDiskUsage(SEQUENCE0_DIR);
+    if (disk.total > 0) {
+        const freeGBDisk = disk.free / 1073741824;
+        checks.push({
+            name: "Disk Space",
+            status: freeGBDisk >= 1 ? (freeGBDisk >= 5 ? "pass" : "warn") : "fail",
+            message: `${formatBytes(disk.free)} free / ${formatBytes(disk.total)} total (${disk.usedPercent.toFixed(1)}% used)`,
+        });
+    }
+    // Platform
+    checks.push({
+        name: "Platform",
+        status: ["darwin", "linux"].includes(info.platform) ? "pass" : "warn",
+        message: `${info.platform}-${info.arch}`,
+    });
+    const passed = checks.every((c) => c.status !== "fail");
+    return { passed, checks };
+}
+/** Check port availability for P2P and API ports */
+export async function checkPorts(p2pPort, apiPort) {
+    const checks = [];
+    const p2pAvailable = await isPortAvailable(p2pPort);
+    checks.push({
+        name: `P2P Port (${p2pPort})`,
+        status: p2pAvailable ? "pass" : "fail",
+        message: p2pAvailable ? "Available" : `Port ${p2pPort} is in use`,
+    });
+    const apiAvailable = await isPortAvailable(apiPort);
+    checks.push({
+        name: `API Port (${apiPort})`,
+        status: apiAvailable ? "pass" : "fail",
+        message: apiAvailable ? "Available" : `Port ${apiPort} is in use`,
+    });
+    return checks;
+}
+/** Suggest optimal configuration based on hardware */
+export function suggestConfig() {
+    const info = getSystemInfo();
+    const cpus = info.cpus;
+    const totalGB = parseFloat(info.totalMemoryGB);
+    const suggestions = {};
+    // Log level based on resources
+    if (totalGB < 4) {
+        suggestions.log_level = "warn";
+    }
+    else {
+        suggestions.log_level = "info";
+    }
+    // Heartbeat interval based on resources
+    if (cpus <= 2 || totalGB < 4) {
+        suggestions.heartbeat_interval = 600; // 10 min for low-resource systems
+    }
+    else {
+        suggestions.heartbeat_interval = 300; // 5 min default
+    }
+    return suggestions;
+}
+//# sourceMappingURL=detector.js.map

package/dist/core/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/core/detector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAajD,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAE7B,kBAAkB;IAClB,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAC3C,OAAO,EAAE,WAAW,IAAI,EAAE;YACxB,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,OAAO;YAC5B,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,uBAAuB;KAC/C,CAAC,CAAC;IAEH,YAAY;IACZ,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACxC,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,EAAE;KACzE,CAAC,CAAC;IAEH,SAAS;IACT,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM;QACjE,OAAO,EAAE,GAAG,IAAI,CAAC,YAAY,cAAc,IAAI,CAAC,aAAa,YAAY,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE;KAChH,CAAC,CAAC;IAEH,aAAa;IACb,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM;YACtE,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SACpH,CAAC,CAAC;IACL,CAAC;IAED,WAAW;IACX,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACrE,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE;KACzC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,OAAe;IAC/D,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,aAAa,OAAO,GAAG;QAC7B,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACtC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,OAAO,YAAY;KAClE,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,aAAa,OAAO,GAAG;QAC7B,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACtC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,OAAO,YAAY;KAClE,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE/C,MAAM,WAAW,GAAoC,EAAE,CAAC;IAExD,+BAA+B;IAC/B,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,WAAW,CAAC,SAAS,GAAG,MAAM,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,SAAS,GAAG,MAAM,CAAC;IACjC,CAAC;IAED,wCAAwC;IACxC,IAAI,IAAI,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAC7B,WAAW,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,kCAAkC;IAC1E,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,gBAAgB;IACxD,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/core/healer.d.ts

@@ -0,0 +1,62 @@
+import { AgentClient } from "../agent/client.js";
+import { Memory } from "./memory.js";
+import type { HeartbeatEvent } from "./heartbeat.js";
+export type HealAction = "restart_agent" | "fix_port_conflict" | "reconnect_peers" | "rotate_logs" | "update_binary" | "alert_operator" | "none";
+export interface SelfHealerOptions {
+    /** Maximum restarts allowed within windowMs (default: 5) */
+    maxRestarts?: number;
+    /** Rolling window in milliseconds to track restart frequency (default: 300000 = 5 min) */
+    windowMs?: number;
+}
+export declare class SelfHealer {
+    private readonly client;
+    private readonly memory;
+    private readonly maxRestarts;
+    private readonly windowMs;
+    /** Timestamps of recent restarts within the rolling window */
+    private restartTimestamps;
+    /** Consecutive restart count for exponential backoff */
+    private consecutiveRestarts;
+    constructor(client: AgentClient, memory: Memory, options?: SelfHealerOptions);
+    /**
+     * Evaluate a heartbeat event and decide on a healing action.
+     * Executes the action and returns which action was taken.
+     */
+    handleEvent(event: HeartbeatEvent): Promise<HealAction>;
+    /** Reset restart counter and backoff state. */
+    reset(): void;
+    /** Agent is unreachable — decide between restart and port conflict fix. */
+    private _handleAgentDown;
+    /** Zero peers — restart agent to re-bootstrap. */
+    private _handlePeersLost;
+    /** Disk usage above 95% — truncate agent logs. */
+    private _handleDiskWarning;
+    /** Memory usage above 90% — restart agent to reclaim memory. */
+    private _handleMemoryWarning;
+    /** Update available — download and restart if auto-update is enabled. */
+    private _handleUpdateAvailable;
+    /** Stop the agent (if running), resolve binary, and spawn with merged config. */
+    private _restartAgent;
+    /** Find an available port, update config, and restart. */
+    private _fixPortConflict;
+    /** Restart the agent to re-bootstrap peer connections. */
+    private _reconnectPeers;
+    /** Truncate the agent log file to reclaim disk space. */
+    private _rotateLogs;
+    /** Committee is degraded — alert operator about at-risk wallets. */
+    private _handleHealthDegraded;
+    /** Committee is critical/dead — urgent alert, suggest reshare. */
+    private _handleHealthCritical;
+    /** Emit a critical alert and stop self-healing. */
+    private _alertOperator;
+    /** Resolve binary, merge config, and spawn the agent process. */
+    private _spawnWithBackoff;
+    /** Apply exponential backoff before a restart: 1s, 2s, 4s, 8s, 16s. */
+    private _backoff;
+    /** Record a restart timestamp in the rolling window. */
+    private _recordRestart;
+    /** Remove restart timestamps older than the rolling window. */
+    private _pruneRestartWindow;
+}
+export default SelfHealer;
+//# sourceMappingURL=healer.d.ts.map

package/dist/core/healer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healer.d.ts","sourceRoot":"","sources":["../../src/core/healer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrD,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,mBAAmB,GACnB,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,MAAM,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,8DAA8D;IAC9D,OAAO,CAAC,iBAAiB,CAAgB;IAEzC,wDAAwD;IACxD,OAAO,CAAC,mBAAmB,CAAK;gBAEpB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAW5E;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA2D7D,+CAA+C;IAC/C,KAAK,IAAI,IAAI;IAUb,2EAA2E;YAC7D,gBAAgB;IA2B9B,kDAAkD;YACpC,gBAAgB;IAK9B,kDAAkD;YACpC,kBAAkB;IAKhC,gEAAgE;YAClD,oBAAoB;IAKlC,yEAAyE;YAC3D,sBAAsB;IA4BpC,iFAAiF;YACnE,aAAa;IAyB3B,0DAA0D;YAC5C,gBAAgB;IA+C9B,0DAA0D;YAC5C,eAAe;IAsB7B,yDAAyD;YAC3C,WAAW;IAgBzB,oEAAoE;YACtD,qBAAqB;IAgCnC,kEAAkE;YACpD,qBAAqB;IAYnC,mDAAmD;IACnD,OAAO,CAAC,cAAc;IAwBtB,iEAAiE;YACnD,iBAAiB;IAwB/B,uEAAuE;YACzD,QAAQ;IAStB,wDAAwD;IACxD,OAAO,CAAC,cAAc;IAItB,+DAA+D;IAC/D,OAAO,CAAC,mBAAmB;CAI5B;AAED,eAAe,UAAU,CAAC"}