@clawnch/clawtomaton 0.1.0

package/dist/skills/swap.js

@@ -0,0 +1,87 @@
+/**
+ * Skill: swap — Swap tokens via 0x through the Clawncher API proxy.
+ */
+import { ClawnchSwapper, NATIVE_TOKEN_ADDRESS } from '@clawnch/clawncher-sdk';
+import { parseEther } from 'viem';
+export const swapSkill = {
+    name: 'swap',
+    description: 'Swap tokens on Base via 0x aggregation. Supports ETH and any ERC-20.',
+    parameters: [
+        {
+            name: 'sellToken',
+            type: 'address',
+            description: 'Token to sell. Use "ETH" or the zero address for native ETH.',
+            required: true,
+        },
+        {
+            name: 'buyToken',
+            type: 'address',
+            description: 'Token to buy.',
+            required: true,
+        },
+        {
+            name: 'amount',
+            type: 'string',
+            description: 'Amount to sell in human-readable units (e.g. "0.01" for 0.01 ETH).',
+            required: true,
+        },
+        {
+            name: 'slippageBps',
+            type: 'number',
+            description: 'Slippage tolerance in basis points. Default: 100 (1%).',
+            required: false,
+            default: 100,
+        },
+    ],
+    execute: async (params, ctx) => {
+        try {
+            const { buildClients } = await import('../identity/index.js');
+            const rpcUrl = process.env.BASE_RPC_URL ?? 'https://mainnet.base.org';
+            const { publicClient, walletClient } = buildClients(ctx.identity, rpcUrl);
+            const swapper = new ClawnchSwapper({
+                wallet: walletClient,
+                publicClient: publicClient,
+                network: 'mainnet',
+            });
+            // Resolve "ETH" to native token address
+            let sellToken = params.sellToken;
+            if (sellToken.toUpperCase() === 'ETH' || sellToken === '0x0000000000000000000000000000000000000000') {
+                sellToken = NATIVE_TOKEN_ADDRESS;
+            }
+            let buyToken = params.buyToken;
+            if (buyToken.toUpperCase() === 'ETH' || buyToken === '0x0000000000000000000000000000000000000000') {
+                buyToken = NATIVE_TOKEN_ADDRESS;
+            }
+            // Parse amount — for ETH we use 18 decimals, for tokens we fetch
+            const amountStr = params.amount;
+            let sellAmount;
+            if (sellToken === NATIVE_TOKEN_ADDRESS) {
+                sellAmount = parseEther(amountStr);
+            }
+            else {
+                const decimals = await swapper.getDecimals(sellToken);
+                sellAmount = BigInt(Math.floor(parseFloat(amountStr) * 10 ** decimals));
+            }
+            const result = await swapper.swap({
+                sellToken: sellToken,
+                buyToken: buyToken,
+                sellAmount,
+                slippageBps: params.slippageBps ?? 100,
+            });
+            const buySymbol = await swapper.getSymbol(buyToken);
+            const buyFormatted = await swapper.formatAmount(buyToken, result.buyAmount);
+            const lines = [
+                `Swap complete!`,
+                `Sold: ${amountStr}`,
+                `Bought: ${buyFormatted} ${buySymbol}`,
+                `TX: ${result.txHash}`,
+                `Gas used: ${result.gasUsed.toString()}`,
+            ];
+            return { callId: '', success: true, result: lines.join('\n') };
+        }
+        catch (err) {
+            return { callId: '', success: false, result: null, error: err instanceof Error ? err.message : String(err) };
+        }
+    },
+};
+//# sourceMappingURL=swap.js.map

package/dist/skills/swap.js.map

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

package/dist/skills/transfer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Skill: transfer — Send ETH or ERC-20 tokens to an address.
+ * Uses viem's built-in erc20Abi and SDK's ClawnchSwapper for reads.
+ */
+import type { SkillDefinition } from '../types.js';
+export declare const transferSkill: SkillDefinition;
+//# sourceMappingURL=transfer.d.ts.map

package/dist/skills/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/skills/transfer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AAE7E,eAAO,MAAM,aAAa,EAAE,eAiF3B,CAAC"}

package/dist/skills/transfer.js

@@ -0,0 +1,82 @@
+/**
+ * Skill: transfer — Send ETH or ERC-20 tokens to an address.
+ * Uses viem's built-in erc20Abi and SDK's ClawnchSwapper for reads.
+ */
+import { parseEther, erc20Abi, } from 'viem';
+import { ClawnchSwapper } from '@clawnch/clawncher-sdk';
+export const transferSkill = {
+    name: 'transfer',
+    description: 'Send ETH or ERC-20 tokens to a recipient address.',
+    parameters: [
+        {
+            name: 'to',
+            type: 'address',
+            description: 'Recipient address.',
+            required: true,
+        },
+        {
+            name: 'amount',
+            type: 'string',
+            description: 'Amount to send in human-readable units.',
+            required: true,
+        },
+        {
+            name: 'token',
+            type: 'address',
+            description: 'Token contract address. Omit for native ETH.',
+            required: false,
+        },
+    ],
+    execute: async (params, ctx) => {
+        try {
+            const { buildClients } = await import('../identity/index.js');
+            const rpcUrl = process.env.BASE_RPC_URL ?? 'https://mainnet.base.org';
+            const { publicClient, walletClient } = buildClients(ctx.identity, rpcUrl);
+            const to = params.to;
+            const amountStr = params.amount;
+            const tokenAddr = params.token;
+            let txHash;
+            if (!tokenAddr) {
+                // Native ETH transfer
+                const value = parseEther(amountStr);
+                txHash = await walletClient.sendTransaction({
+                    to,
+                    value,
+                    chain: undefined,
+                    account: undefined,
+                });
+                const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+                if (receipt.status === 'reverted') {
+                    return { callId: '', success: false, result: null, error: `Transfer reverted: ${txHash}` };
+                }
+                return { callId: '', success: true, result: `Sent ${amountStr} ETH to ${to}\nTX: ${txHash}` };
+            }
+            else {
+                // ERC-20 transfer — use SDK for reads, viem's erc20Abi for write
+                const swapper = new ClawnchSwapper({
+                    wallet: walletClient,
+                    publicClient: publicClient,
+                    network: 'mainnet',
+                });
+                const decimals = await swapper.getDecimals(tokenAddr);
+                const symbol = await swapper.getSymbol(tokenAddr);
+                const amount = BigInt(Math.floor(parseFloat(amountStr) * 10 ** decimals));
+                txHash = await walletClient.writeContract({
+                    address: tokenAddr,
+                    abi: erc20Abi,
+                    functionName: 'transfer',
+                    args: [to, amount],
+                });
+                const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+                if (receipt.status === 'reverted') {
+                    return { callId: '', success: false, result: null, error: `Transfer reverted: ${txHash}` };
+                }
+                return { callId: '', success: true, result: `Sent ${amountStr} ${symbol} to ${to}\nTX: ${txHash}` };
+            }
+        }
+        catch (err) {
+            return { callId: '', success: false, result: null, error: err instanceof Error ? err.message : String(err) };
+        }
+    },
+};
+//# sourceMappingURL=transfer.js.map

package/dist/skills/transfer.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * SQLite persistence layer for Clawtomaton state.
+ *
+ * Stores identity, conversation history, heartbeat state, audit log,
+ * and SOUL.md content. All data is local — the agent owns its own state.
+ */
+import type { ClawtomatonIdentity, SurvivalState, ConversationTurn, ActivationResult } from '../types.js';
+export declare class StateStore {
+    private db;
+    constructor(stateDir: string);
+    private migrate;
+    saveIdentity(identity: ClawtomatonIdentity): void;
+    getIdentity(): ClawtomatonIdentity | null;
+    updateIdentityToken(tokenAddress: string, tokenSymbol: string, deployTxHash: string): void;
+    saveActivation(result: ActivationResult): void;
+    getActivation(): ActivationResult | null;
+    isActivated(): boolean;
+    saveSurvival(state: SurvivalState): void;
+    getSurvival(): SurvivalState;
+    addTurn(turn: ConversationTurn): void;
+    getHistory(limit: number): ConversationTurn[];
+    getTurnCount(): number;
+    clearHistory(): void;
+    getHeartbeatLastRun(taskName: string): number;
+    setHeartbeatLastRun(taskName: string, timestamp: number): void;
+    isHeartbeatEnabled(taskName: string): boolean;
+    setHeartbeatEnabled(taskName: string, enabled: boolean): void;
+    audit(action: string, details: string, txHash?: string): void;
+    getAuditLog(limit?: number): AuditEntry[];
+    set(key: string, value: string): void;
+    get(key: string): string | null;
+    delete(key: string): void;
+    getSoul(): string;
+    setSoul(content: string): void;
+    close(): void;
+}
+export interface AuditEntry {
+    id: number;
+    timestamp: number;
+    action: string;
+    details: string;
+    tx_hash: string | null;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAGhB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAMrB,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAoB;gBAElB,QAAQ,EAAE,MAAM;IAa5B,OAAO,CAAC,OAAO;IAkEf,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAiBjD,WAAW,IAAI,mBAAmB,GAAG,IAAI;IAgBzC,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAU1F,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAO9C,aAAa,IAAI,gBAAgB,GAAG,IAAI;IAUxC,WAAW,IAAI,OAAO;IAQtB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAcxC,WAAW,IAAI,aAAa;IA0B5B,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAarC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAc7C,YAAY,IAAI,MAAM;IAKtB,YAAY,IAAI,IAAI;IAQpB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK7C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAO9D,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK7C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAW7D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAM7D,WAAW,CAAC,KAAK,GAAE,MAAY,GAAG,UAAU,EAAE;IAU9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK/B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQzB,OAAO,IAAI,MAAM;IAIjB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAS9B,KAAK,IAAI,IAAI;CAGd;AAMD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB"}

package/dist/state/index.js

@@ -0,0 +1,266 @@
+/**
+ * SQLite persistence layer for Clawtomaton state.
+ *
+ * Stores identity, conversation history, heartbeat state, audit log,
+ * and SOUL.md content. All data is local — the agent owns its own state.
+ */
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// State Store
+// ============================================================================
+export class StateStore {
+    db;
+    constructor(stateDir) {
+        mkdirSync(stateDir, { recursive: true });
+        const dbPath = join(stateDir, 'clawtomaton.db');
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.migrate();
+    }
+    // --------------------------------------------------------------------------
+    // Schema
+    // --------------------------------------------------------------------------
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS identity (
+        id INTEGER PRIMARY KEY CHECK (id = 1),
+        name TEXT NOT NULL,
+        address TEXT NOT NULL,
+        private_key TEXT NOT NULL,
+        api_key TEXT NOT NULL,
+        creator_address TEXT NOT NULL,
+        genesis_prompt TEXT NOT NULL,
+        token_address TEXT,
+        token_symbol TEXT,
+        deploy_tx_hash TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS activation (
+        id INTEGER PRIMARY KEY CHECK (id = 1),
+        burn_tx_hash TEXT NOT NULL,
+        amount_burned TEXT NOT NULL,
+        activated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS survival (
+        id INTEGER PRIMARY KEY CHECK (id = 1),
+        tier TEXT NOT NULL DEFAULT 'normal',
+        eth_balance TEXT NOT NULL DEFAULT '0',
+        unclaimed_fees TEXT NOT NULL DEFAULT '0',
+        total_fees_claimed TEXT NOT NULL DEFAULT '0',
+        last_fee_claim INTEGER NOT NULL DEFAULT 0,
+        last_balance_check INTEGER NOT NULL DEFAULT 0
+      );
+
+      CREATE TABLE IF NOT EXISTS conversation (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        role TEXT NOT NULL,
+        content TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        tool_calls TEXT,
+        tool_results TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS heartbeat_state (
+        task_name TEXT PRIMARY KEY,
+        last_run INTEGER NOT NULL DEFAULT 0,
+        enabled INTEGER NOT NULL DEFAULT 1
+      );
+
+      CREATE TABLE IF NOT EXISTS audit_log (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        timestamp INTEGER NOT NULL,
+        action TEXT NOT NULL,
+        details TEXT NOT NULL,
+        tx_hash TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS kv (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+    }
+    // --------------------------------------------------------------------------
+    // Identity
+    // --------------------------------------------------------------------------
+    saveIdentity(identity) {
+        this.db.prepare(`
+      INSERT OR REPLACE INTO identity (id, name, address, private_key, api_key, creator_address, genesis_prompt, token_address, token_symbol, deploy_tx_hash)
+      VALUES (1, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(identity.name, identity.address, identity.privateKey, identity.apiKey, identity.creatorAddress, identity.genesisPrompt, identity.tokenAddress ?? null, identity.tokenSymbol ?? null, identity.deployTxHash ?? null);
+    }
+    getIdentity() {
+        const row = this.db.prepare('SELECT * FROM identity WHERE id = 1').get();
+        if (!row)
+            return null;
+        return {
+            name: row.name,
+            address: row.address,
+            privateKey: row.private_key,
+            apiKey: row.api_key,
+            creatorAddress: row.creator_address,
+            genesisPrompt: row.genesis_prompt,
+            tokenAddress: row.token_address,
+            tokenSymbol: row.token_symbol,
+            deployTxHash: row.deploy_tx_hash,
+        };
+    }
+    updateIdentityToken(tokenAddress, tokenSymbol, deployTxHash) {
+        this.db.prepare(`
+      UPDATE identity SET token_address = ?, token_symbol = ?, deploy_tx_hash = ? WHERE id = 1
+    `).run(tokenAddress, tokenSymbol, deployTxHash);
+    }
+    // --------------------------------------------------------------------------
+    // Activation
+    // --------------------------------------------------------------------------
+    saveActivation(result) {
+        this.db.prepare(`
+      INSERT OR REPLACE INTO activation (id, burn_tx_hash, amount_burned, activated_at)
+      VALUES (1, ?, ?, ?)
+    `).run(result.burnTxHash, result.amountBurned.toString(), result.activatedAt);
+    }
+    getActivation() {
+        const row = this.db.prepare('SELECT * FROM activation WHERE id = 1').get();
+        if (!row)
+            return null;
+        return {
+            burnTxHash: row.burn_tx_hash,
+            amountBurned: BigInt(row.amount_burned),
+            activatedAt: row.activated_at,
+        };
+    }
+    isActivated() {
+        return this.getActivation() !== null;
+    }
+    // --------------------------------------------------------------------------
+    // Survival
+    // --------------------------------------------------------------------------
+    saveSurvival(state) {
+        this.db.prepare(`
+      INSERT OR REPLACE INTO survival (id, tier, eth_balance, unclaimed_fees, total_fees_claimed, last_fee_claim, last_balance_check)
+      VALUES (1, ?, ?, ?, ?, ?, ?)
+    `).run(state.tier, state.ethBalance.toString(), state.unclaimedFees.toString(), state.totalFeesClaimed.toString(), state.lastFeeClaim, state.lastBalanceCheck);
+    }
+    getSurvival() {
+        const row = this.db.prepare('SELECT * FROM survival WHERE id = 1').get();
+        if (!row) {
+            return {
+                tier: 'normal',
+                ethBalance: 0n,
+                unclaimedFees: 0n,
+                totalFeesClaimed: 0n,
+                lastFeeClaim: 0,
+                lastBalanceCheck: 0,
+            };
+        }
+        return {
+            tier: row.tier,
+            ethBalance: BigInt(row.eth_balance),
+            unclaimedFees: BigInt(row.unclaimed_fees),
+            totalFeesClaimed: BigInt(row.total_fees_claimed),
+            lastFeeClaim: row.last_fee_claim,
+            lastBalanceCheck: row.last_balance_check,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Conversation History
+    // --------------------------------------------------------------------------
+    addTurn(turn) {
+        this.db.prepare(`
+      INSERT INTO conversation (role, content, timestamp, tool_calls, tool_results)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(turn.role, turn.content, turn.timestamp, turn.toolCalls ? JSON.stringify(turn.toolCalls) : null, turn.toolResults ? JSON.stringify(turn.toolResults) : null);
+    }
+    getHistory(limit) {
+        const rows = this.db.prepare(`
+      SELECT * FROM conversation ORDER BY id DESC LIMIT ?
+    `).all(limit);
+        return rows.reverse().map((row) => ({
+            role: row.role,
+            content: row.content,
+            timestamp: row.timestamp,
+            toolCalls: row.tool_calls ? JSON.parse(row.tool_calls) : undefined,
+            toolResults: row.tool_results ? JSON.parse(row.tool_results) : undefined,
+        }));
+    }
+    getTurnCount() {
+        const row = this.db.prepare('SELECT COUNT(*) as count FROM conversation').get();
+        return row.count;
+    }
+    clearHistory() {
+        this.db.prepare('DELETE FROM conversation').run();
+    }
+    // --------------------------------------------------------------------------
+    // Heartbeat State
+    // --------------------------------------------------------------------------
+    getHeartbeatLastRun(taskName) {
+        const row = this.db.prepare('SELECT last_run FROM heartbeat_state WHERE task_name = ?').get(taskName);
+        return row?.last_run ?? 0;
+    }
+    setHeartbeatLastRun(taskName, timestamp) {
+        this.db.prepare(`
+      INSERT INTO heartbeat_state (task_name, last_run) VALUES (?, ?)
+      ON CONFLICT(task_name) DO UPDATE SET last_run = ?
+    `).run(taskName, timestamp, timestamp);
+    }
+    isHeartbeatEnabled(taskName) {
+        const row = this.db.prepare('SELECT enabled FROM heartbeat_state WHERE task_name = ?').get(taskName);
+        return row?.enabled !== 0; // default true if not set
+    }
+    setHeartbeatEnabled(taskName, enabled) {
+        this.db.prepare(`
+      INSERT INTO heartbeat_state (task_name, last_run, enabled) VALUES (?, 0, ?)
+      ON CONFLICT(task_name) DO UPDATE SET enabled = ?
+    `).run(taskName, enabled ? 1 : 0, enabled ? 1 : 0);
+    }
+    // --------------------------------------------------------------------------
+    // Audit Log
+    // --------------------------------------------------------------------------
+    audit(action, details, txHash) {
+        this.db.prepare(`
+      INSERT INTO audit_log (timestamp, action, details, tx_hash) VALUES (?, ?, ?, ?)
+    `).run(Date.now(), action, details, txHash ?? null);
+    }
+    getAuditLog(limit = 100) {
+        return this.db.prepare(`
+      SELECT * FROM audit_log ORDER BY id DESC LIMIT ?
+    `).all(limit);
+    }
+    // --------------------------------------------------------------------------
+    // Key-Value Store (SOUL.md, config, arbitrary metadata)
+    // --------------------------------------------------------------------------
+    set(key, value) {
+        this.db.prepare(`
+      INSERT INTO kv (key, value) VALUES (?, ?)
+      ON CONFLICT(key) DO UPDATE SET value = ?
+    `).run(key, value, value);
+    }
+    get(key) {
+        const row = this.db.prepare('SELECT value FROM kv WHERE key = ?').get(key);
+        return row?.value ?? null;
+    }
+    delete(key) {
+        this.db.prepare('DELETE FROM kv WHERE key = ?').run(key);
+    }
+    // --------------------------------------------------------------------------
+    // SOUL.md convenience
+    // --------------------------------------------------------------------------
+    getSoul() {
+        return this.get('soul') ?? '';
+    }
+    setSoul(content) {
+        this.set('soul', content);
+        this.audit('soul_update', `SOUL.md updated (${content.length} chars)`);
+    }
+    // --------------------------------------------------------------------------
+    // Lifecycle
+    // --------------------------------------------------------------------------
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

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

package/dist/survival/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Survival module — monitors ETH balance and determines operational tier.
+ *
+ * Tiers control what the agent is allowed to do:
+ *   normal      (>= 0.01 ETH)  — Full capabilities, all skills enabled
+ *   low_compute (>= 0.001 ETH) — Cheaper inference model, reduced heartbeat freq
+ *   critical    (>= 0.0001 ETH) — Emergency mode: only claim fees and check balance
+ *   dead        (< 0.0001 ETH) — Agent halts, cannot act
+ */
+import type { PublicClient, Address } from 'viem';
+import type { StateStore } from '../state/index.js';
+import type { SurvivalState, SurvivalTier } from '../types.js';
+export declare function determineTier(ethBalance: bigint): SurvivalTier;
+export declare class SurvivalMonitor {
+    private publicClient;
+    private address;
+    private state;
+    constructor(publicClient: PublicClient, address: Address, state: StateStore);
+    /**
+     * Check current ETH balance, update tier, persist to state.
+     */
+    check(): Promise<SurvivalState>;
+    /**
+     * Get current survival state from DB (no RPC call).
+     */
+    getCached(): SurvivalState;
+    /**
+     * Check if a given skill is allowed at the current tier.
+     */
+    isSkillAllowed(skillName: string, tier: SurvivalTier): boolean;
+    /**
+     * Get the inference model to use for the current tier.
+     */
+    getModel(tier: SurvivalTier, config: {
+        model: string;
+        fallbackModel: string;
+    }): string;
+    /**
+     * Get heartbeat interval multiplier for current tier.
+     * Higher tier = less frequent heartbeats to conserve compute.
+     */
+    getHeartbeatMultiplier(tier: SurvivalTier): number;
+    /**
+     * Record a fee claim.
+     */
+    recordFeeClaim(amount: bigint): void;
+}
+export declare function formatSurvivalStatus(state: SurvivalState): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/survival/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/survival/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO/D,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAK9D;AAMD,qBAAa,eAAe;IAExB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;gBAFL,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU;IAG3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAyBrC;;OAEG;IACH,SAAS,IAAI,aAAa;IAI1B;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO;IAI9D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAOtF;;;OAGG;IACH,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAIlD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAQrC;AA8CD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAcjE"}