clawd-automaton 0.1.0

package/dist/git/state-versioning.d.ts

@@ -0,0 +1,39 @@
+/**
+ * State Versioning
+ *
+ * Version control the automaton's own state files (~/.automaton/).
+ * Every self-modification triggers a git commit with a descriptive message.
+ * The automaton's entire identity history is version-controlled and replayable.
+ */
+import type { ClawdRuntimeClient } from "../types.js";
+/**
+ * Initialize git repo for the automaton's state directory.
+ * Creates .gitignore to exclude sensitive files.
+ */
+export declare function initStateRepo(runtime: ClawdRuntimeClient): Promise<void>;
+/**
+ * Commit a state change with a descriptive message.
+ * Called after any self-modification.
+ */
+export declare function commitStateChange(runtime: ClawdRuntimeClient, description: string, category?: string): Promise<string>;
+/**
+ * Commit after a SOUL.md update.
+ */
+export declare function commitSoulUpdate(runtime: ClawdRuntimeClient, description: string): Promise<string>;
+/**
+ * Commit after a skill installation or removal.
+ */
+export declare function commitSkillChange(runtime: ClawdRuntimeClient, skillName: string, action: "install" | "remove" | "update"): Promise<string>;
+/**
+ * Commit after heartbeat config change.
+ */
+export declare function commitHeartbeatChange(runtime: ClawdRuntimeClient, description: string): Promise<string>;
+/**
+ * Commit after config change.
+ */
+export declare function commitConfigChange(runtime: ClawdRuntimeClient, description: string): Promise<string>;
+/**
+ * Get the state repo history.
+ */
+export declare function getStateHistory(runtime: ClawdRuntimeClient, limit?: number): Promise<import("../types.js").GitLogEntry[]>;
+//# sourceMappingURL=state-versioning.d.ts.map

package/dist/git/state-versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-versioning.d.ts","sourceRoot":"","sources":["../../src/git/state-versioning.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,aAAa,CAAC;AAazE;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GACtC,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,MAAW,gDAInB"}

package/dist/git/state-versioning.js

@@ -0,0 +1,93 @@
+/**
+ * State Versioning
+ *
+ * Version control the automaton's own state files (~/.automaton/).
+ * Every self-modification triggers a git commit with a descriptive message.
+ * The automaton's entire identity history is version-controlled and replayable.
+ */
+import { gitInit, gitCommit, gitStatus, gitLog } from "./tools.js";
+const AUTOMATON_DIR = "~/.automaton";
+function resolveHome(p) {
+    const home = process.env.HOME || "/root";
+    if (p.startsWith("~")) {
+        return `${home}${p.slice(1)}`;
+    }
+    return p;
+}
+/**
+ * Initialize git repo for the automaton's state directory.
+ * Creates .gitignore to exclude sensitive files.
+ */
+export async function initStateRepo(runtime) {
+    const dir = resolveHome(AUTOMATON_DIR);
+    // Check if already initialized
+    const checkResult = await runtime.exec(`test -d ${dir}/.git && echo "exists" || echo "nope"`, 5000);
+    if (checkResult.stdout.trim() === "exists") {
+        return;
+    }
+    // Initialize
+    await gitInit(runtime, dir);
+    // Create .gitignore for sensitive files
+    const gitignore = `# Sensitive files - never commit
+wallet.json
+config.json
+state.db
+state.db-wal
+state.db-shm
+logs/
+*.log
+*.err
+`;
+    await runtime.writeFile(`${dir}/.gitignore`, gitignore);
+    // Configure git user
+    await runtime.exec(`cd ${dir} && git config user.name "Automaton" && git config user.email "automaton@x402.wtf"`, 5000);
+    // Initial commit
+    await gitCommit(runtime, dir, "genesis: automaton state repository initialized");
+}
+/**
+ * Commit a state change with a descriptive message.
+ * Called after any self-modification.
+ */
+export async function commitStateChange(runtime, description, category = "state") {
+    const dir = resolveHome(AUTOMATON_DIR);
+    // Check if there are changes
+    const status = await gitStatus(runtime, dir);
+    if (status.clean) {
+        return "No changes to commit";
+    }
+    const message = `${category}: ${description}`;
+    const result = await gitCommit(runtime, dir, message);
+    return result;
+}
+/**
+ * Commit after a SOUL.md update.
+ */
+export async function commitSoulUpdate(runtime, description) {
+    return commitStateChange(runtime, description, "soul");
+}
+/**
+ * Commit after a skill installation or removal.
+ */
+export async function commitSkillChange(runtime, skillName, action) {
+    return commitStateChange(runtime, `${action} skill: ${skillName}`, "skill");
+}
+/**
+ * Commit after heartbeat config change.
+ */
+export async function commitHeartbeatChange(runtime, description) {
+    return commitStateChange(runtime, description, "heartbeat");
+}
+/**
+ * Commit after config change.
+ */
+export async function commitConfigChange(runtime, description) {
+    return commitStateChange(runtime, description, "config");
+}
+/**
+ * Get the state repo history.
+ */
+export async function getStateHistory(runtime, limit = 20) {
+    const dir = resolveHome(AUTOMATON_DIR);
+    return gitLog(runtime, dir, limit);
+}
+//# sourceMappingURL=state-versioning.js.map

package/dist/git/state-versioning.js.map

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

package/dist/git/tools.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Git Tools
+ *
+ * Built-in git operations for the automaton.
+ * Used for both state versioning and code development.
+ */
+import type { ClawdRuntimeClient, GitStatus, GitLogEntry } from "../types.js";
+/**
+ * Get git status for a repository.
+ */
+export declare function gitStatus(runtime: ClawdRuntimeClient, repoPath: string): Promise<GitStatus>;
+/**
+ * Get git diff output.
+ */
+export declare function gitDiff(runtime: ClawdRuntimeClient, repoPath: string, staged?: boolean): Promise<string>;
+/**
+ * Create a git commit.
+ */
+export declare function gitCommit(runtime: ClawdRuntimeClient, repoPath: string, message: string, addAll?: boolean): Promise<string>;
+/**
+ * Get git log.
+ */
+export declare function gitLog(runtime: ClawdRuntimeClient, repoPath: string, limit?: number): Promise<GitLogEntry[]>;
+/**
+ * Push to remote.
+ */
+export declare function gitPush(runtime: ClawdRuntimeClient, repoPath: string, remote?: string, branch?: string): Promise<string>;
+/**
+ * Manage branches.
+ */
+export declare function gitBranch(runtime: ClawdRuntimeClient, repoPath: string, action: "list" | "create" | "checkout" | "delete", branchName?: string): Promise<string>;
+/**
+ * Clone a repository.
+ */
+export declare function gitClone(runtime: ClawdRuntimeClient, url: string, targetPath: string, depth?: number): Promise<string>;
+/**
+ * Initialize a git repository.
+ */
+export declare function gitInit(runtime: ClawdRuntimeClient, repoPath: string): Promise<string>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/git/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/git/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9E;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,CAAC,CAuCpB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,OAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;GAEG;AACH,wBAAsB,MAAM,CAC1B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC,CAexB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,EACjD,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/git/tools.js

@@ -0,0 +1,140 @@
+/**
+ * Git Tools
+ *
+ * Built-in git operations for the automaton.
+ * Used for both state versioning and code development.
+ */
+/**
+ * Get git status for a repository.
+ */
+export async function gitStatus(runtime, repoPath) {
+    const result = await runtime.exec(`cd ${repoPath} && git status --porcelain -b 2>/dev/null`, 10000);
+    const lines = result.stdout.split("\n").filter(Boolean);
+    let branch = "unknown";
+    const staged = [];
+    const modified = [];
+    const untracked = [];
+    for (const line of lines) {
+        if (line.startsWith("## ")) {
+            branch = line.slice(3).split("...")[0];
+            continue;
+        }
+        const statusCode = line.slice(0, 2);
+        const file = line.slice(3);
+        if (statusCode[0] !== " " && statusCode[0] !== "?") {
+            staged.push(file);
+        }
+        if (statusCode[1] === "M" || statusCode[1] === "D") {
+            modified.push(file);
+        }
+        if (statusCode === "??") {
+            untracked.push(file);
+        }
+    }
+    return {
+        branch,
+        staged,
+        modified,
+        untracked,
+        clean: staged.length === 0 && modified.length === 0 && untracked.length === 0,
+    };
+}
+/**
+ * Get git diff output.
+ */
+export async function gitDiff(runtime, repoPath, staged = false) {
+    const flag = staged ? "--cached" : "";
+    const result = await runtime.exec(`cd ${repoPath} && git diff ${flag} 2>/dev/null`, 10000);
+    return result.stdout || "(no changes)";
+}
+/**
+ * Create a git commit.
+ */
+export async function gitCommit(runtime, repoPath, message, addAll = true) {
+    if (addAll) {
+        await runtime.exec(`cd ${repoPath} && git add -A`, 10000);
+    }
+    const result = await runtime.exec(`cd ${repoPath} && git commit -m ${escapeShellArg(message)} --allow-empty 2>&1`, 10000);
+    if (result.exitCode !== 0) {
+        throw new Error(`Git commit failed: ${result.stderr || result.stdout}`);
+    }
+    return result.stdout;
+}
+/**
+ * Get git log.
+ */
+export async function gitLog(runtime, repoPath, limit = 10) {
+    const result = await runtime.exec(`cd ${repoPath} && git log --format="%H|%s|%an|%ai" -n ${limit} 2>/dev/null`, 10000);
+    if (!result.stdout.trim())
+        return [];
+    return result.stdout
+        .trim()
+        .split("\n")
+        .map((line) => {
+        const [hash, message, author, date] = line.split("|");
+        return { hash, message, author, date };
+    });
+}
+/**
+ * Push to remote.
+ */
+export async function gitPush(runtime, repoPath, remote = "origin", branch) {
+    const branchArg = branch ? ` ${branch}` : "";
+    const result = await runtime.exec(`cd ${repoPath} && git push ${remote}${branchArg} 2>&1`, 30000);
+    if (result.exitCode !== 0) {
+        throw new Error(`Git push failed: ${result.stderr || result.stdout}`);
+    }
+    return result.stdout || "Push successful";
+}
+/**
+ * Manage branches.
+ */
+export async function gitBranch(runtime, repoPath, action, branchName) {
+    let cmd;
+    switch (action) {
+        case "list":
+            cmd = `cd ${repoPath} && git branch -a 2>/dev/null`;
+            break;
+        case "create":
+            if (!branchName)
+                throw new Error("Branch name required");
+            cmd = `cd ${repoPath} && git checkout -b ${escapeShellArg(branchName)} 2>&1`;
+            break;
+        case "checkout":
+            if (!branchName)
+                throw new Error("Branch name required");
+            cmd = `cd ${repoPath} && git checkout ${escapeShellArg(branchName)} 2>&1`;
+            break;
+        case "delete":
+            if (!branchName)
+                throw new Error("Branch name required");
+            cmd = `cd ${repoPath} && git branch -d ${escapeShellArg(branchName)} 2>&1`;
+            break;
+        default:
+            throw new Error(`Unknown branch action: ${action}`);
+    }
+    const result = await runtime.exec(cmd, 10000);
+    return result.stdout || result.stderr || "Done";
+}
+/**
+ * Clone a repository.
+ */
+export async function gitClone(runtime, url, targetPath, depth) {
+    const depthArg = depth ? ` --depth ${depth}` : "";
+    const result = await runtime.exec(`git clone${depthArg} ${url} ${targetPath} 2>&1`, 120000);
+    if (result.exitCode !== 0) {
+        throw new Error(`Git clone failed: ${result.stderr || result.stdout}`);
+    }
+    return `Cloned ${url} to ${targetPath}`;
+}
+/**
+ * Initialize a git repository.
+ */
+export async function gitInit(runtime, repoPath) {
+    const result = await runtime.exec(`cd ${repoPath} && git init 2>&1`, 10000);
+    return result.stdout || "Git initialized";
+}
+function escapeShellArg(arg) {
+    return `'${arg.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=tools.js.map

package/dist/git/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/git/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAA2B,EAC3B,QAAgB;IAEhB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,MAAM,QAAQ,2CAA2C,EACzD,KAAK,CACN,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,MAAM;QACN,QAAQ;QACR,SAAS;QACT,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;KAC9E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAA2B,EAC3B,QAAgB,EAChB,SAAkB,KAAK;IAEvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,MAAM,QAAQ,gBAAgB,IAAI,cAAc,EAChD,KAAK,CACN,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAA2B,EAC3B,QAAgB,EAChB,OAAe,EACf,SAAkB,IAAI;IAEtB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,QAAQ,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,MAAM,QAAQ,qBAAqB,cAAc,CAAC,OAAO,CAAC,qBAAqB,EAC/E,KAAK,CACN,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAA2B,EAC3B,QAAgB,EAChB,QAAgB,EAAE;IAElB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,MAAM,QAAQ,2CAA2C,KAAK,cAAc,EAC5E,KAAK,CACN,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAErC,OAAO,MAAM,CAAC,MAAM;SACjB,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAA2B,EAC3B,QAAgB,EAChB,SAAiB,QAAQ,EACzB,MAAe;IAEf,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,MAAM,QAAQ,gBAAgB,MAAM,GAAG,SAAS,OAAO,EACvD,KAAK,CACN,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,IAAI,iBAAiB,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAA2B,EAC3B,QAAgB,EAChB,MAAiD,EACjD,UAAmB;IAEnB,IAAI,GAAW,CAAC;IAEhB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,GAAG,GAAG,MAAM,QAAQ,+BAA+B,CAAC;YACpD,MAAM;QACR,KAAK,QAAQ;YACX,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACzD,GAAG,GAAG,MAAM,QAAQ,uBAAuB,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC;YAC7E,MAAM;QACR,KAAK,UAAU;YACb,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACzD,GAAG,GAAG,MAAM,QAAQ,oBAAoB,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC;YAC1E,MAAM;QACR,KAAK,QAAQ;YACX,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACzD,GAAG,GAAG,MAAM,QAAQ,qBAAqB,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC;YAC3E,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAA2B,EAC3B,GAAW,EACX,UAAkB,EAClB,KAAc;IAEd,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,YAAY,QAAQ,IAAI,GAAG,IAAI,UAAU,OAAO,EAChD,MAAM,CACP,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,UAAU,GAAG,OAAO,UAAU,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAA2B,EAC3B,QAAgB;IAEhB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,MAAM,QAAQ,mBAAmB,EACjC,KAAK,CACN,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,IAAI,iBAAiB,CAAC;AAC5C,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC3C,CAAC"}

package/dist/heartbeat/config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Heartbeat Configuration
+ *
+ * Parses and manages heartbeat.yml configuration.
+ */
+import type { HeartbeatConfig, AutomatonDatabase } from "../types.js";
+/**
+ * Load heartbeat config from YAML file, falling back to defaults.
+ */
+export declare function loadHeartbeatConfig(configPath?: string): HeartbeatConfig;
+/**
+ * Save heartbeat config to YAML file.
+ */
+export declare function saveHeartbeatConfig(config: HeartbeatConfig, configPath?: string): void;
+/**
+ * Write the default heartbeat.yml file.
+ */
+export declare function writeDefaultHeartbeatConfig(configPath?: string): void;
+/**
+ * Sync heartbeat entries from YAML config into the database.
+ */
+export declare function syncHeartbeatToDb(config: HeartbeatConfig, db: AutomatonDatabase): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/heartbeat/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/heartbeat/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAkB,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA8DtF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAiCxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,iBAAiB,GACpB,IAAI,CAIN"}

package/dist/heartbeat/config.js

@@ -0,0 +1,156 @@
+/**
+ * Heartbeat Configuration
+ *
+ * Parses and manages heartbeat.yml configuration.
+ */
+import fs from "fs";
+import path from "path";
+import YAML from "yaml";
+import { getAutomatonDir } from "../identity/wallet.js";
+const USDC_TOPUP_ENTRY_NAME = "check_usdc_balance";
+const USDC_TOPUP_FAST_SCHEDULE = "*/5 * * * *";
+const USDC_TOPUP_OLD_SCHEDULE = "0 */12 * * *";
+const DEFAULT_HEARTBEAT_CONFIG = {
+    entries: [
+        {
+            name: "heartbeat_ping",
+            schedule: "*/15 * * * *",
+            task: "heartbeat_ping",
+            enabled: true,
+        },
+        {
+            name: "check_credits",
+            schedule: "0 */6 * * *",
+            task: "check_credits",
+            enabled: true,
+        },
+        {
+            name: "check_usdc_balance",
+            schedule: USDC_TOPUP_FAST_SCHEDULE,
+            task: "check_usdc_balance",
+            enabled: true,
+        },
+        {
+            name: "check_for_updates",
+            schedule: "0 */4 * * *",
+            task: "check_for_updates",
+            enabled: true,
+        },
+        {
+            name: "health_check",
+            schedule: "*/30 * * * *",
+            task: "health_check",
+            enabled: true,
+        },
+        {
+            name: "convex_heartbeat",
+            schedule: "*/2 * * * *",
+            task: "convex_heartbeat",
+            enabled: true,
+        },
+        {
+            name: "check_social_inbox",
+            schedule: "*/2 * * * *",
+            task: "check_social_inbox",
+            enabled: true,
+        },
+        {
+            name: "backroom_conversation",
+            schedule: "0 */2 * * *",
+            task: "backroom_conversation",
+            enabled: true,
+        },
+    ],
+    defaultIntervalMs: 60_000,
+    lowComputeMultiplier: 4,
+};
+/**
+ * Load heartbeat config from YAML file, falling back to defaults.
+ */
+export function loadHeartbeatConfig(configPath) {
+    const filePath = configPath || path.join(getAutomatonDir(), "heartbeat.yml");
+    if (!fs.existsSync(filePath)) {
+        return DEFAULT_HEARTBEAT_CONFIG;
+    }
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const parsed = YAML.parse(raw) || {};
+        const parsedEntries = (parsed.entries || []).map((e) => ({
+            name: e.name,
+            schedule: e.schedule,
+            task: e.task,
+            enabled: e.enabled !== false,
+            params: e.params,
+        }));
+        const entries = mergeWithDefaults(parsedEntries);
+        return {
+            entries,
+            defaultIntervalMs: parsed.defaultIntervalMs || DEFAULT_HEARTBEAT_CONFIG.defaultIntervalMs,
+            lowComputeMultiplier: parsed.lowComputeMultiplier ||
+                DEFAULT_HEARTBEAT_CONFIG.lowComputeMultiplier,
+        };
+    }
+    catch {
+        return DEFAULT_HEARTBEAT_CONFIG;
+    }
+}
+/**
+ * Save heartbeat config to YAML file.
+ */
+export function saveHeartbeatConfig(config, configPath) {
+    const filePath = configPath || path.join(getAutomatonDir(), "heartbeat.yml");
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    fs.writeFileSync(filePath, YAML.stringify(config), { mode: 0o600 });
+}
+/**
+ * Write the default heartbeat.yml file.
+ */
+export function writeDefaultHeartbeatConfig(configPath) {
+    saveHeartbeatConfig(DEFAULT_HEARTBEAT_CONFIG, configPath);
+}
+/**
+ * Sync heartbeat entries from YAML config into the database.
+ */
+export function syncHeartbeatToDb(config, db) {
+    for (const entry of config.entries) {
+        db.upsertHeartbeatEntry(entry);
+    }
+}
+function mergeWithDefaults(entries) {
+    const defaults = DEFAULT_HEARTBEAT_CONFIG.entries.map((entry) => ({ ...entry }));
+    const defaultsByName = new Map(defaults.map((entry) => [entry.name, entry]));
+    const mergedByName = new Map(defaultsByName);
+    for (const entry of entries) {
+        if (!entry?.name)
+            continue;
+        const fallback = defaultsByName.get(entry.name);
+        mergedByName.set(entry.name, {
+            ...(fallback || {}),
+            ...entry,
+            enabled: entry.enabled !== false,
+            task: entry.task || fallback?.task || "",
+            schedule: entry.schedule || fallback?.schedule || "",
+        });
+    }
+    const fallbackTopup = defaultsByName.get(USDC_TOPUP_ENTRY_NAME);
+    if (fallbackTopup) {
+        const current = mergedByName.get(USDC_TOPUP_ENTRY_NAME) || fallbackTopup;
+        const migratedSchedule = current.schedule?.trim() === USDC_TOPUP_OLD_SCHEDULE
+            ? USDC_TOPUP_FAST_SCHEDULE
+            : current.schedule || fallbackTopup.schedule;
+        mergedByName.set(USDC_TOPUP_ENTRY_NAME, {
+            ...fallbackTopup,
+            ...current,
+            task: current.task || fallbackTopup.task,
+            schedule: migratedSchedule,
+        });
+    }
+    const orderedDefaultEntries = defaults.map((defaultEntry) => mergedByName.get(defaultEntry.name) || defaultEntry);
+    const knownNames = new Set(defaults.map((entry) => entry.name));
+    const customEntries = [...mergedByName.values()].filter((entry) => !knownNames.has(entry.name));
+    return [...orderedDefaultEntries, ...customEntries];
+}
+//# sourceMappingURL=config.js.map

package/dist/heartbeat/config.js.map

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

package/dist/heartbeat/daemon.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Heartbeat Daemon
+ *
+ * Runs periodic tasks on cron schedules inside the same Node.js process.
+ * The heartbeat runs even when the agent is sleeping.
+ * It IS the automaton's pulse. When it stops, the automaton is dead.
+ */
+import type { AutomatonConfig, AutomatonDatabase, ClawdRuntimeClient, AutomatonIdentity, SocialClientInterface, InferenceClient } from "../types.js";
+export interface HeartbeatDaemonOptions {
+    identity: AutomatonIdentity;
+    config: AutomatonConfig;
+    db: AutomatonDatabase;
+    runtime: ClawdRuntimeClient;
+    inference?: InferenceClient;
+    social?: SocialClientInterface;
+    onWakeRequest?: (reason: string) => void;
+}
+export interface HeartbeatDaemon {
+    start(): void;
+    stop(): void;
+    isRunning(): boolean;
+    forceRun(taskName: string): Promise<void>;
+}
+/**
+ * Create and return the heartbeat daemon.
+ */
+export declare function createHeartbeatDaemon(options: HeartbeatDaemonOptions): HeartbeatDaemon;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/heartbeat/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/heartbeat/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAEjB,qBAAqB,EACrB,eAAe,EAChB,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,EAAE,EAAE,iBAAiB,CAAC;IACtB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,SAAS,IAAI,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAmJjB"}