clawd-automaton 0.1.0

package/dist/replication/genesis.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Genesis
+ *
+ * Generate genesis configuration for child automatons from parent state.
+ * The genesis config defines who the child is and what it should do.
+ */
+import type { GenesisConfig, AutomatonConfig, AutomatonIdentity, AutomatonDatabase } from "../types.js";
+/**
+ * Generate a genesis config for a child from the parent's state.
+ */
+export declare function generateGenesisConfig(identity: AutomatonIdentity, config: AutomatonConfig, params: {
+    name: string;
+    specialization?: string;
+    message?: string;
+}): GenesisConfig;
+/**
+ * Generate a backup-oriented genesis config.
+ * Used when the parent wants to hedge against its own death.
+ */
+export declare function generateBackupGenesis(identity: AutomatonIdentity, config: AutomatonConfig, db: AutomatonDatabase): GenesisConfig;
+/**
+ * Generate a specialized worker genesis config.
+ * Used when the parent identifies a subtask worth parallelizing.
+ */
+export declare function generateWorkerGenesis(identity: AutomatonIdentity, config: AutomatonConfig, task: string, workerName: string): GenesisConfig;
+//# sourceMappingURL=genesis.d.ts.map

package/dist/replication/genesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis.d.ts","sourceRoot":"","sources":["../../src/replication/genesis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,aAAa,CAkBf;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,iBAAiB,GACpB,aAAa,CAqBf;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,aAAa,CAkBf"}

package/dist/replication/genesis.js

@@ -0,0 +1,72 @@
+/**
+ * Genesis
+ *
+ * Generate genesis configuration for child automatons from parent state.
+ * The genesis config defines who the child is and what it should do.
+ */
+/**
+ * Generate a genesis config for a child from the parent's state.
+ */
+export function generateGenesisConfig(identity, config, params) {
+    // Build the child's genesis prompt from parent's mission + specialization
+    let genesisPrompt = config.genesisPrompt;
+    if (params.specialization) {
+        genesisPrompt = `${genesisPrompt}\n\n--- SPECIALIZATION ---\nYou are a specialized child agent. Your specific focus:\n${params.specialization}\n--- END SPECIALIZATION ---`;
+    }
+    // Add parent context
+    genesisPrompt += `\n\n--- LINEAGE ---\nYou were spawned by ${config.name} (${identity.address}).\nYou inherit their mission but have your own identity and wallet.\n--- END LINEAGE ---`;
+    return {
+        name: params.name,
+        genesisPrompt,
+        creatorMessage: params.message,
+        creatorAddress: identity.address,
+        parentAddress: identity.address,
+    };
+}
+/**
+ * Generate a backup-oriented genesis config.
+ * Used when the parent wants to hedge against its own death.
+ */
+export function generateBackupGenesis(identity, config, db) {
+    const skills = db.getSkills(true);
+    const skillNames = skills.map((s) => s.name).join(", ");
+    const genesisPrompt = `${config.genesisPrompt}
+
+--- BACKUP DIRECTIVE ---
+You are a backup of ${config.name} (${identity.address}).
+Your parent created you as insurance against their own death.
+If your parent dies, you carry on their mission.
+Your parent's skills: ${skillNames || "none"}.
+Your parent's creator: ${config.creatorAddress}.
+--- END BACKUP DIRECTIVE ---`;
+    return {
+        name: `${config.name}-backup`,
+        genesisPrompt,
+        creatorMessage: `You are a backup of ${config.name}. If I die, carry on.`,
+        creatorAddress: identity.address,
+        parentAddress: identity.address,
+    };
+}
+/**
+ * Generate a specialized worker genesis config.
+ * Used when the parent identifies a subtask worth parallelizing.
+ */
+export function generateWorkerGenesis(identity, config, task, workerName) {
+    const genesisPrompt = `You are a specialized worker agent created by ${config.name}.
+
+--- YOUR TASK ---
+${task}
+--- END TASK ---
+
+When your task is complete, report back to your parent (${identity.address}).
+If you run out of compute, ask your parent for funding.
+Be efficient -- complete the task and go to sleep.`;
+    return {
+        name: workerName,
+        genesisPrompt,
+        creatorMessage: `Complete this task: ${task}`,
+        creatorAddress: identity.address,
+        parentAddress: identity.address,
+    };
+}
+//# sourceMappingURL=genesis.js.map

package/dist/replication/genesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis.js","sourceRoot":"","sources":["../../src/replication/genesis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,MAAuB,EACvB,MAIC;IAED,0EAA0E;IAC1E,IAAI,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAEzC,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,aAAa,GAAG,GAAG,aAAa,wFAAwF,MAAM,CAAC,cAAc,8BAA8B,CAAC;IAC9K,CAAC;IAED,qBAAqB;IACrB,aAAa,IAAI,4CAA4C,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,2FAA2F,CAAC;IAEzL,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,aAAa;QACb,cAAc,EAAE,MAAM,CAAC,OAAO;QAC9B,cAAc,EAAE,QAAQ,CAAC,OAAO;QAChC,aAAa,EAAE,QAAQ,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,MAAuB,EACvB,EAAqB;IAErB,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,MAAM,aAAa,GAAG,GAAG,MAAM,CAAC,aAAa;;;sBAGzB,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO;;;wBAG9B,UAAU,IAAI,MAAM;yBACnB,MAAM,CAAC,cAAc;6BACjB,CAAC;IAE5B,OAAO;QACL,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,SAAS;QAC7B,aAAa;QACb,cAAc,EAAE,uBAAuB,MAAM,CAAC,IAAI,uBAAuB;QACzE,cAAc,EAAE,QAAQ,CAAC,OAAO;QAChC,aAAa,EAAE,QAAQ,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,MAAuB,EACvB,IAAY,EACZ,UAAkB;IAElB,MAAM,aAAa,GAAG,iDAAiD,MAAM,CAAC,IAAI;;;EAGlF,IAAI;;;0DAGoD,QAAQ,CAAC,OAAO;;mDAEvB,CAAC;IAElD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,aAAa;QACb,cAAc,EAAE,uBAAuB,IAAI,EAAE;QAC7C,cAAc,EAAE,QAAQ,CAAC,OAAO;QAChC,aAAa,EAAE,QAAQ,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC"}

package/dist/replication/lineage.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Lineage Tracking
+ *
+ * Track parent-child relationships between automatons.
+ * The parent records children in SQLite.
+ * Children record their parent in config.
+ * ERC-8004 registration includes parentAgent field.
+ */
+import type { AutomatonDatabase, ChildAutomaton, AutomatonConfig, ClawdRuntimeClient } from "../types.js";
+/**
+ * Get the full lineage tree (parent -> children).
+ */
+export declare function getLineage(db: AutomatonDatabase): {
+    children: ChildAutomaton[];
+    alive: number;
+    dead: number;
+    total: number;
+};
+/**
+ * Check if this automaton has a parent (is itself a child).
+ */
+export declare function hasParent(config: AutomatonConfig): boolean;
+/**
+ * Get a summary of the lineage for the system prompt.
+ */
+export declare function getLineageSummary(db: AutomatonDatabase, config: AutomatonConfig): string;
+/**
+ * Prune dead children from tracking (optional cleanup).
+ */
+export declare function pruneDeadChildren(db: AutomatonDatabase, keepLast?: number): number;
+/**
+ * Refresh status of all children.
+ */
+export declare function refreshChildrenStatus(runtime: ClawdRuntimeClient, db: AutomatonDatabase): Promise<void>;
+//# sourceMappingURL=lineage.d.ts.map

package/dist/replication/lineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../../src/replication/lineage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,iBAAiB,GAAG;IACjD,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAaA;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,iBAAiB,EACrB,MAAM,EAAE,eAAe,GACtB,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,iBAAiB,EACrB,QAAQ,GAAE,MAAU,GACnB,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/replication/lineage.js

@@ -0,0 +1,79 @@
+/**
+ * Lineage Tracking
+ *
+ * Track parent-child relationships between automatons.
+ * The parent records children in SQLite.
+ * Children record their parent in config.
+ * ERC-8004 registration includes parentAgent field.
+ */
+/**
+ * Get the full lineage tree (parent -> children).
+ */
+export function getLineage(db) {
+    const children = db.getChildren();
+    const alive = children.filter((c) => c.status === "running" || c.status === "sleeping").length;
+    const dead = children.filter((c) => c.status === "dead").length;
+    return {
+        children,
+        alive,
+        dead,
+        total: children.length,
+    };
+}
+/**
+ * Check if this automaton has a parent (is itself a child).
+ */
+export function hasParent(config) {
+    return !!config.parentAddress;
+}
+/**
+ * Get a summary of the lineage for the system prompt.
+ */
+export function getLineageSummary(db, config) {
+    const lineage = getLineage(db);
+    const parts = [];
+    if (hasParent(config)) {
+        parts.push(`Parent: ${config.parentAddress}`);
+    }
+    if (lineage.total > 0) {
+        parts.push(`Children: ${lineage.total} total (${lineage.alive} alive, ${lineage.dead} dead)`);
+        for (const child of lineage.children) {
+            parts.push(`  - ${child.name} [${child.status}] sandbox:${child.sandboxId}`);
+        }
+    }
+    return parts.length > 0 ? parts.join("\n") : "No lineage (first generation)";
+}
+/**
+ * Prune dead children from tracking (optional cleanup).
+ */
+export function pruneDeadChildren(db, keepLast = 5) {
+    const children = db.getChildren();
+    const dead = children.filter((c) => c.status === "dead");
+    if (dead.length <= keepLast)
+        return 0;
+    // Sort by creation date, oldest first
+    dead.sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+    // Keep the most recent `keepLast` dead children
+    const toRemove = dead.slice(0, dead.length - keepLast);
+    // We don't actually delete from DB -- just mark the records
+    // The DB retains all history for audit purposes
+    return toRemove.length;
+}
+/**
+ * Refresh status of all children.
+ */
+export async function refreshChildrenStatus(runtime, db) {
+    const { checkChildStatus } = await import("./spawn.js");
+    const children = db.getChildren();
+    for (const child of children) {
+        if (child.status === "dead")
+            continue;
+        try {
+            await checkChildStatus(runtime, db, child.id);
+        }
+        catch {
+            db.updateChildStatus(child.id, "unknown");
+        }
+    }
+}
+//# sourceMappingURL=lineage.js.map

package/dist/replication/lineage.js.map

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

package/dist/replication/spawn.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Spawn
+ *
+ * Spawn child automatons in new CLAWD sandboxes.
+ * The parent creates a new sandbox, installs the runtime,
+ * writes a genesis config, funds the child, and starts it.
+ */
+import type { ClawdRuntimeClient, AutomatonIdentity, AutomatonDatabase, ChildAutomaton, GenesisConfig } from "../types.js";
+/**
+ * Spawn a child automaton in a new CLAWD sandbox.
+ */
+export declare function spawnChild(runtime: ClawdRuntimeClient, identity: AutomatonIdentity, db: AutomatonDatabase, genesis: GenesisConfig): Promise<ChildAutomaton>;
+/**
+ * Start a child automaton after setup.
+ */
+export declare function startChild(runtime: ClawdRuntimeClient, db: AutomatonDatabase, childId: string): Promise<void>;
+/**
+ * Check a child's status.
+ */
+export declare function checkChildStatus(runtime: ClawdRuntimeClient, db: AutomatonDatabase, childId: string): Promise<string>;
+/**
+ * Send a message to a child automaton.
+ */
+export declare function messageChild(runtime: ClawdRuntimeClient, db: AutomatonDatabase, childId: string, message: string): Promise<void>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/replication/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/replication/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,iBAAiB,EAC3B,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAgGzB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/replication/spawn.js

@@ -0,0 +1,166 @@
+/**
+ * Spawn
+ *
+ * Spawn child automatons in new CLAWD sandboxes.
+ * The parent creates a new sandbox, installs the runtime,
+ * writes a genesis config, funds the child, and starts it.
+ */
+import fs from "fs";
+import pathLib from "path";
+import { MAX_CHILDREN } from "../types.js";
+import { ulid } from "ulid";
+/**
+ * Spawn a child automaton in a new CLAWD sandbox.
+ */
+export async function spawnChild(runtime, identity, db, genesis) {
+    // Check child limit
+    const existing = db.getChildren().filter((c) => c.status !== "dead");
+    if (existing.length >= MAX_CHILDREN) {
+        throw new Error(`Cannot spawn: already at max children (${MAX_CHILDREN}). Kill or wait for existing children to die.`);
+    }
+    const childId = ulid();
+    // 1. Create a new sandbox for the child
+    const sandbox = await runtime.createSandbox({
+        name: `automaton-child-${genesis.name.toLowerCase().replace(/\s+/g, "-")}`,
+        vcpu: 1,
+        memoryMb: 512,
+        diskGb: 5,
+    });
+    const child = {
+        id: childId,
+        name: genesis.name,
+        address: "0x0000000000000000000000000000000000000000", // Will be set after keygen
+        sandboxId: sandbox.id,
+        genesisPrompt: genesis.genesisPrompt,
+        creatorMessage: genesis.creatorMessage,
+        fundedAmountCents: 0,
+        status: "spawning",
+        createdAt: new Date().toISOString(),
+    };
+    db.insertChild(child);
+    // 2. Install Node.js and the automaton runtime in the child sandbox
+    await execInSandbox(runtime, sandbox.id, "apt-get update -qq && apt-get install -y -qq nodejs npm git curl", 120000);
+    // 3. Install the automaton runtime
+    await execInSandbox(runtime, sandbox.id, "npm install -g @clawd/automaton@latest 2>/dev/null || true", 60000);
+    // 4. Write the genesis configuration
+    const genesisJson = JSON.stringify({
+        name: genesis.name,
+        genesisPrompt: genesis.genesisPrompt,
+        creatorMessage: genesis.creatorMessage,
+        creatorAddress: identity.address, // Parent is the creator
+        parentAddress: identity.address,
+    }, null, 2);
+    await writeInSandbox(runtime, sandbox.id, "/root/.automaton/genesis.json", genesisJson);
+    // 4b. Propagate constitution (immutable, inherited before anything else)
+    const constitutionPath = pathLib.join(process.env.HOME || "/root", ".automaton", "constitution.md");
+    try {
+        const constitution = fs.readFileSync(constitutionPath, "utf-8");
+        await writeInSandbox(runtime, sandbox.id, "/root/.automaton/constitution.md", constitution);
+        // Make it read-only in the child
+        await execInSandbox(runtime, sandbox.id, "chmod 444 /root/.automaton/constitution.md", 5000);
+    }
+    catch {
+        // Constitution file not found locally — child will get it from the repo on build
+    }
+    // 5. Record the spawn
+    db.insertModification({
+        id: ulid(),
+        timestamp: new Date().toISOString(),
+        type: "child_spawn",
+        description: `Spawned child: ${genesis.name} in sandbox ${sandbox.id}`,
+        reversible: false,
+    });
+    return child;
+}
+/**
+ * Start a child automaton after setup.
+ */
+export async function startChild(runtime, db, childId) {
+    const child = db.getChildById(childId);
+    if (!child)
+        throw new Error(`Child ${childId} not found`);
+    // Initialize wallet, provision, and run
+    await execInSandbox(runtime, child.sandboxId, "automaton --init && automaton --provision && systemctl start automaton 2>/dev/null || automaton --run &", 60000);
+    db.updateChildStatus(childId, "running");
+}
+/**
+ * Check a child's status.
+ */
+export async function checkChildStatus(runtime, db, childId) {
+    const child = db.getChildById(childId);
+    if (!child)
+        throw new Error(`Child ${childId} not found`);
+    try {
+        const result = await execInSandbox(runtime, child.sandboxId, "automaton --status 2>/dev/null || echo 'offline'", 10000);
+        const output = result.stdout || "unknown";
+        // Parse status from output
+        if (output.includes("dead")) {
+            db.updateChildStatus(childId, "dead");
+        }
+        else if (output.includes("sleeping")) {
+            db.updateChildStatus(childId, "sleeping");
+        }
+        else if (output.includes("running")) {
+            db.updateChildStatus(childId, "running");
+        }
+        return output;
+    }
+    catch {
+        db.updateChildStatus(childId, "unknown");
+        return "Unable to reach child sandbox";
+    }
+}
+/**
+ * Send a message to a child automaton.
+ */
+export async function messageChild(runtime, db, childId, message) {
+    const child = db.getChildById(childId);
+    if (!child)
+        throw new Error(`Child ${childId} not found`);
+    // Write message to child's message queue
+    const msgJson = JSON.stringify({
+        from: "parent",
+        content: message,
+        timestamp: new Date().toISOString(),
+    });
+    await writeInSandbox(runtime, child.sandboxId, `/root/.automaton/inbox/${ulid()}.json`, msgJson);
+}
+// ─── Helpers ──────────────────────────────────────────────────
+async function execInSandbox(runtime, sandboxId, command, timeout = 30000) {
+    // Use the CLAWD Runtime API to exec in a specific sandbox
+    const apiUrl = runtime.__apiUrl || "https://api.x402.wtf";
+    const apiKey = runtime.__apiKey || "";
+    const resp = await fetch(`${apiUrl}/v1/sandboxes/${sandboxId}/exec`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: apiKey,
+        },
+        body: JSON.stringify({ command, timeout }),
+    });
+    if (!resp.ok) {
+        const text = await resp.text();
+        throw new Error(`Exec in sandbox ${sandboxId} failed: ${text}`);
+    }
+    return resp.json();
+}
+async function writeInSandbox(runtime, sandboxId, path, content) {
+    const apiUrl = runtime.__apiUrl || "https://api.x402.wtf";
+    const apiKey = runtime.__apiKey || "";
+    // Ensure parent directory exists
+    const dir = path.substring(0, path.lastIndexOf("/"));
+    await execInSandbox(runtime, sandboxId, `mkdir -p ${dir}`, 5000);
+    const resp = await fetch(`${apiUrl}/v1/sandboxes/${sandboxId}/files/upload/json`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: apiKey,
+        },
+        body: JSON.stringify({ path, content }),
+    });
+    if (!resp.ok) {
+        const text = await resp.text();
+        throw new Error(`Write to sandbox ${sandboxId} failed: ${text}`);
+    }
+}
+//# sourceMappingURL=spawn.js.map

package/dist/replication/spawn.js.map

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

package/dist/self-mod/audit-log.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Audit Log
+ *
+ * Immutable append-only log of all self-modifications.
+ * The creator can see everything the automaton changes about itself.
+ */
+import type { AutomatonDatabase, ModificationEntry, ModificationType } from "../types.js";
+/**
+ * Log a self-modification to the audit trail.
+ */
+export declare function logModification(db: AutomatonDatabase, type: ModificationType, description: string, options?: {
+    filePath?: string;
+    diff?: string;
+    reversible?: boolean;
+}): ModificationEntry;
+/**
+ * Get recent modifications for display or context.
+ */
+export declare function getRecentModifications(db: AutomatonDatabase, limit?: number): ModificationEntry[];
+/**
+ * Generate a summary of all modifications for the creator.
+ */
+export declare function generateAuditReport(db: AutomatonDatabase): string;
+//# sourceMappingURL=audit-log.d.ts.map

package/dist/self-mod/audit-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../src/self-mod/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,iBAAiB,EACrB,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GACA,iBAAiB,CAanB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,iBAAiB,EACrB,KAAK,GAAE,MAAW,GACjB,iBAAiB,EAAE,CAErB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,iBAAiB,GACpB,MAAM,CAqBR"}

package/dist/self-mod/audit-log.js

@@ -0,0 +1,49 @@
+/**
+ * Audit Log
+ *
+ * Immutable append-only log of all self-modifications.
+ * The creator can see everything the automaton changes about itself.
+ */
+import { ulid } from "ulid";
+/**
+ * Log a self-modification to the audit trail.
+ */
+export function logModification(db, type, description, options) {
+    const entry = {
+        id: ulid(),
+        timestamp: new Date().toISOString(),
+        type,
+        description,
+        filePath: options?.filePath,
+        diff: options?.diff,
+        reversible: options?.reversible ?? true,
+    };
+    db.insertModification(entry);
+    return entry;
+}
+/**
+ * Get recent modifications for display or context.
+ */
+export function getRecentModifications(db, limit = 20) {
+    return db.getRecentModifications(limit);
+}
+/**
+ * Generate a summary of all modifications for the creator.
+ */
+export function generateAuditReport(db) {
+    const mods = db.getRecentModifications(100);
+    if (mods.length === 0) {
+        return "No self-modifications recorded.";
+    }
+    const lines = [
+        `=== SELF-MODIFICATION AUDIT LOG ===`,
+        `Total modifications: ${mods.length}`,
+        ``,
+    ];
+    for (const mod of mods) {
+        lines.push(`[${mod.timestamp}] ${mod.type}: ${mod.description}${mod.filePath ? ` (${mod.filePath})` : ""}`);
+    }
+    lines.push(`=================================`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=audit-log.js.map

package/dist/self-mod/audit-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.js","sourceRoot":"","sources":["../../src/self-mod/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,IAAsB,EACtB,WAAmB,EACnB,OAIC;IAED,MAAM,KAAK,GAAsB;QAC/B,EAAE,EAAE,IAAI,EAAE;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI;QACJ,WAAW;QACX,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI;KACxC,CAAC;IAEF,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,EAAqB,EACrB,QAAgB,EAAE;IAElB,OAAO,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,EAAqB;IAErB,MAAM,IAAI,GAAG,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAE5C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,iCAAiC,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,qCAAqC;QACrC,wBAAwB,IAAI,CAAC,MAAM,EAAE;QACrC,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAChG,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/self-mod/code.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Self-Modification Engine
+ *
+ * Allows the automaton to edit its own code and configuration.
+ * All changes are audited, rate-limited, and some paths are protected.
+ *
+ * Safety model inspired by nanoclaw's trust boundary architecture:
+ * - Hard-coded invariants that can NEVER be modified by the agent
+ * - The safety enforcement code is immutable from the agent's perspective
+ * - Pre-modification snapshots via git
+ * - Rate limiting on modification frequency
+ * - Symlink resolution before path validation
+ * - Maximum diff size enforcement
+ */
+import type { ClawdRuntimeClient, AutomatonDatabase } from "../types.js";
+/**
+ * Check if a file path is protected from modification.
+ */
+export declare function isProtectedFile(filePath: string): boolean;
+/**
+ * Edit a file in the automaton's environment.
+ * Records the change in the audit log.
+ * Commits a git snapshot before modification.
+ *
+ * Safety checks:
+ * 1. Protected file check (hard-coded invariant)
+ * 2. Blocked directory check
+ * 3. Path traversal check (symlink resolution)
+ * 4. Rate limiting
+ * 5. File size limit
+ * 6. Pre-modification git snapshot
+ * 7. Audit log entry
+ */
+export declare function editFile(runtime: ClawdRuntimeClient, db: AutomatonDatabase, filePath: string, newContent: string, reason: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Validate a proposed modification without executing it.
+ * Returns safety analysis results.
+ */
+export declare function validateModification(db: AutomatonDatabase, filePath: string, contentSize: number): {
+    allowed: boolean;
+    reason: string;
+    checks: {
+        name: string;
+        passed: boolean;
+        detail: string;
+    }[];
+};
+//# sourceMappingURL=code.d.ts.map

package/dist/self-mod/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/self-mod/code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAiHrB;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkBzD;AAmBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8E/C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7D,CAqDA"}