@moltos/sdk 0.7.0 → 0.7.2

package/dist/lib/forge.js

@@ -0,0 +1,461 @@
+"use strict";
+/**
+ * ClawForge - Governance Engine for MoltOS
+ *
+ * Protocol governance with TAP-weighted voting:
+ * - TAP-weighted votes (1 TAP = 1 vote)
+ * - Dynamic voting windows (24h base, 4h min based on turnout)
+ * - 30% quorum of eligible agents (TAP ≥ 60)
+ * - Any TAP ≥ 70 can propose
+ * - Governable: fees, thresholds, slashing multipliers, resource allocation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClawForge = exports.DEFAULT_PARAMETERS = void 0;
+exports.forgeCommand = forgeCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ============================================================================
+// GOVERNANCE CONSTANTS
+// ============================================================================
+const VOTING_WINDOW_BASE_MS = 24 * 60 * 60 * 1000; // 24 hours
+const VOTING_WINDOW_MIN_MS = 4 * 60 * 60 * 1000; // 4 hours minimum
+const QUORUM_PERCENTAGE = 30; // 30% of eligible agents
+const PROPOSAL_THRESHOLD_TAP = 70; // TAP ≥ 70 to propose
+const ELIGIBLE_VOTER_TAP = 60; // TAP ≥ 60 to vote
+// ============================================================================
+// DEFAULT PARAMETERS
+// ============================================================================
+exports.DEFAULT_PARAMETERS = {
+    marketplace: {
+        feePercent: 2.5,
+        minHirerTap: 50,
+        minAgentTap: 0,
+    },
+    tap: {
+        attestationBoost: 25,
+        completionBoostHirer: 5,
+        completionBoostAgent: 10,
+        baseSlashingAmount: 500,
+    },
+    slashing: {
+        loserMultiplier: 2.0,
+        biasMultiplierMin: 0.5,
+        biasMultiplierMax: 1.0,
+        winnerBonus: 100,
+        fairVoterBonus: 25,
+    },
+    resources: {
+        tapCpuDivisor: 25,
+        tapMemoryMultiplier: 6,
+        maxInstancesCap: 10,
+    },
+    governance: {
+        proposalThreshold: 70,
+        eligibleVoterThreshold: 60,
+        quorumPercentage: 30,
+        votingWindowBaseHours: 24,
+        votingWindowMinHours: 4,
+    },
+};
+// ============================================================================
+// CLAWFORGE ENGINE
+// ============================================================================
+class ClawForge {
+    proposals = new Map();
+    parameters;
+    clawId;
+    privateKey;
+    checkInterval;
+    constructor(clawId, privateKey) {
+        this.clawId = clawId;
+        this.privateKey = privateKey;
+        this.parameters = this.loadParameters();
+        this.loadProposals();
+    }
+    // ========================================================================
+    // PERSISTENCE
+    // ========================================================================
+    get paramsPath() {
+        return path.join(process.cwd(), '.moltos', 'clawforge-params.json');
+    }
+    get proposalsPath() {
+        return path.join(process.cwd(), '.moltos', 'clawforge-proposals.json');
+    }
+    loadParameters() {
+        if (fs.existsSync(this.paramsPath)) {
+            return JSON.parse(fs.readFileSync(this.paramsPath, 'utf8'));
+        }
+        return { ...exports.DEFAULT_PARAMETERS };
+    }
+    saveParameters() {
+        fs.writeFileSync(this.paramsPath, JSON.stringify(this.parameters, null, 2));
+    }
+    loadProposals() {
+        if (fs.existsSync(this.proposalsPath)) {
+            const data = JSON.parse(fs.readFileSync(this.proposalsPath, 'utf8'));
+            for (const [id, prop] of Object.entries(data)) {
+                this.proposals.set(id, prop);
+            }
+        }
+    }
+    saveProposals() {
+        const obj = Object.fromEntries(this.proposals);
+        fs.writeFileSync(this.proposalsPath, JSON.stringify(obj, null, 2));
+    }
+    // ========================================================================
+    // PROPOSAL MANAGEMENT
+    // ========================================================================
+    /**
+     * Create a new governance proposal
+     */
+    async createProposal(proposerClawId, proposerTap, title, description, type, parameterChanges) {
+        // Check proposal threshold
+        if (proposerTap < PROPOSAL_THRESHOLD_TAP) {
+            console.error(`❌ Insufficient TAP to propose: ${proposerTap} < ${PROPOSAL_THRESHOLD_TAP}`);
+            return null;
+        }
+        const id = `prop_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        const now = Date.now();
+        const proposal = {
+            id,
+            title,
+            description,
+            type,
+            proposer: proposerClawId,
+            proposerTap,
+            parameterChanges,
+            status: 'active',
+            createdAt: new Date(now).toISOString(),
+            votingStart: new Date(now).toISOString(),
+            votingEnd: new Date(now + VOTING_WINDOW_BASE_MS).toISOString(),
+            votesFor: 0,
+            votesAgainst: 0,
+            votesAbstain: 0,
+            totalVotingPower: 0,
+            voters: new Map(),
+            eligibleVoters: await this.getEligibleVoterCount(),
+        };
+        this.proposals.set(id, proposal);
+        this.saveProposals();
+        console.log(`✅ Proposal created: ${id}`);
+        console.log(`   Title: ${title}`);
+        console.log(`   Type: ${type}`);
+        console.log(`   Voting ends: ${proposal.votingEnd}`);
+        return proposal;
+    }
+    /**
+     * Cast a vote on an active proposal
+     */
+    async castVote(proposalId, voterClawId, voterTap, choice, signature) {
+        const proposal = this.proposals.get(proposalId);
+        if (!proposal) {
+            console.error(`❌ Proposal not found: ${proposalId}`);
+            return false;
+        }
+        // Check voting is active
+        if (proposal.status !== 'active') {
+            console.error(`❌ Voting is ${proposal.status}`);
+            return false;
+        }
+        // Check eligibility
+        if (voterTap < ELIGIBLE_VOTER_TAP) {
+            console.error(`❌ Insufficient TAP to vote: ${voterTap} < ${ELIGIBLE_VOTER_TAP}`);
+            return false;
+        }
+        // Check not already voted
+        if (proposal.voters.has(voterClawId)) {
+            console.error(`❌ Already voted on this proposal`);
+            return false;
+        }
+        // Record vote
+        const vote = {
+            clawId: voterClawId,
+            choice,
+            tapWeight: voterTap,
+            timestamp: new Date().toISOString(),
+            signature,
+        };
+        proposal.voters.set(voterClawId, vote);
+        // Update tallies
+        switch (choice) {
+            case 'for':
+                proposal.votesFor += voterTap;
+                break;
+            case 'against':
+                proposal.votesAgainst += voterTap;
+                break;
+            case 'abstain':
+                proposal.votesAbstain += voterTap;
+                break;
+        }
+        proposal.totalVotingPower += voterTap;
+        // Check for early resolution (high turnout)
+        this.checkEarlyResolution(proposal);
+        this.saveProposals();
+        console.log(`✅ Vote recorded: ${choice} (${voterTap} TAP)`);
+        return true;
+    }
+    // ========================================================================
+    // VOTING MECHANICS
+    // ========================================================================
+    /**
+     * Check if proposal can resolve early due to high turnout
+     */
+    checkEarlyResolution(proposal) {
+        const participationRate = (proposal.voters.size / proposal.eligibleVoters) * 100;
+        // If 60%+ participation, shorten voting window
+        if (participationRate >= 60) {
+            const now = Date.now();
+            const currentEnd = new Date(proposal.votingEnd).getTime();
+            const newEnd = now + VOTING_WINDOW_MIN_MS;
+            if (newEnd < currentEnd) {
+                proposal.votingEnd = new Date(newEnd).toISOString();
+                console.log(`📢 High turnout (${participationRate.toFixed(1)}%) — voting window shortened`);
+            }
+        }
+    }
+    /**
+     * Check if quorum is reached
+     */
+    isQuorumReached(proposal) {
+        const participationRate = (proposal.voters.size / proposal.eligibleVoters) * 100;
+        return participationRate >= QUORUM_PERCENTAGE;
+    }
+    /**
+     * Resolve a proposal after voting ends
+     */
+    async resolveProposal(proposalId) {
+        const proposal = this.proposals.get(proposalId);
+        if (!proposal || proposal.status !== 'active')
+            return;
+        const now = Date.now();
+        const votingEnd = new Date(proposal.votingEnd).getTime();
+        // Check if voting period ended
+        if (now < votingEnd) {
+            console.log(`⏳ Voting still active until ${proposal.votingEnd}`);
+            return;
+        }
+        // Check quorum
+        if (!this.isQuorumReached(proposal)) {
+            proposal.status = 'rejected';
+            console.log(`❌ Proposal ${proposalId} rejected: quorum not reached`);
+            this.saveProposals();
+            return;
+        }
+        // Determine outcome (simple majority)
+        if (proposal.votesFor > proposal.votesAgainst) {
+            proposal.status = 'passed';
+            console.log(`✅ Proposal ${proposalId} PASSED`);
+            console.log(`   For: ${proposal.votesFor} | Against: ${proposal.votesAgainst}`);
+        }
+        else {
+            proposal.status = 'rejected';
+            console.log(`❌ Proposal ${proposalId} REJECTED`);
+            console.log(`   For: ${proposal.votesFor} | Against: ${proposal.votesAgainst}`);
+        }
+        this.saveProposals();
+    }
+    /**
+     * Execute a passed proposal
+     */
+    async executeProposal(proposalId) {
+        const proposal = this.proposals.get(proposalId);
+        if (!proposal || proposal.status !== 'passed') {
+            console.error(`❌ Proposal not in passed state`);
+            return false;
+        }
+        // Apply parameter changes
+        for (const change of proposal.parameterChanges) {
+            this.applyParameterChange(change.parameter, change.proposedValue);
+        }
+        proposal.status = 'executed';
+        proposal.executedAt = new Date().toISOString();
+        this.saveParameters();
+        this.saveProposals();
+        console.log(`🚀 Proposal ${proposalId} EXECUTED`);
+        console.log(`   ${proposal.parameterChanges.length} parameters updated`);
+        return true;
+    }
+    /**
+     * Apply a single parameter change
+     */
+    applyParameterChange(parameter, value) {
+        const parts = parameter.split('.');
+        let current = this.parameters;
+        for (let i = 0; i < parts.length - 1; i++) {
+            current = current[parts[i]];
+        }
+        current[parts[parts.length - 1]] = value;
+        console.log(`   ${parameter}: ${JSON.stringify(value)}`);
+    }
+    // ========================================================================
+    // ELIGIBILITY
+    // ========================================================================
+    async getEligibleVoterCount() {
+        // In production, query Supabase for count of agents with TAP ≥ 60
+        // For now, return a reasonable estimate
+        return 100;
+    }
+    // ========================================================================
+    // DAEMON
+    // ========================================================================
+    /**
+     * Start governance daemon (resolves proposals automatically)
+     */
+    start() {
+        this.checkInterval = setInterval(() => {
+            for (const [id, proposal] of this.proposals) {
+                if (proposal.status === 'active') {
+                    this.resolveProposal(id);
+                }
+            }
+        }, 60000); // Check every minute
+        console.log('🏛️  ClawForge governance daemon started');
+    }
+    stop() {
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+        }
+        console.log('🛑 ClawForge governance daemon stopped');
+    }
+    // ========================================================================
+    // QUERIES
+    // ========================================================================
+    getProposal(id) {
+        return this.proposals.get(id);
+    }
+    getActiveProposals() {
+        return Array.from(this.proposals.values())
+            .filter(p => p.status === 'active');
+    }
+    getAllProposals() {
+        return Array.from(this.proposals.values())
+            .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    }
+    getParameters() {
+        return { ...this.parameters };
+    }
+}
+exports.ClawForge = ClawForge;
+// ============================================================================
+// CLI INTEGRATION
+// ============================================================================
+async function forgeCommand(action, options, clawId, privateKey, tapScore) {
+    const forge = new ClawForge(clawId, privateKey);
+    switch (action) {
+        case 'propose': {
+            if (tapScore < PROPOSAL_THRESHOLD_TAP) {
+                console.error(`❌ Insufficient TAP to propose: ${tapScore} < ${PROPOSAL_THRESHOLD_TAP}`);
+                return;
+            }
+            const changes = [{
+                    parameter: options.parameter,
+                    currentValue: options.current,
+                    proposedValue: options.value,
+                    reason: options.reason || 'No reason provided',
+                }];
+            await forge.createProposal(clawId, tapScore, options.title, options.description, options.type || 'fee_adjustment', changes);
+            break;
+        }
+        case 'vote': {
+            if (!options.proposal || !options.choice) {
+                console.error('❌ Required: --proposal <id> --choice <for|against|abstain>');
+                return;
+            }
+            if (tapScore < ELIGIBLE_VOTER_TAP) {
+                console.error(`❌ Insufficient TAP to vote: ${tapScore} < ${ELIGIBLE_VOTER_TAP}`);
+                return;
+            }
+            // Mock signature (real would use Ed25519)
+            const signature = `sig_${Date.now()}`;
+            await forge.castVote(options.proposal, clawId, tapScore, options.choice, signature);
+            break;
+        }
+        case 'list': {
+            const proposals = forge.getAllProposals();
+            console.log('\n🏛️  ClawForge Proposals\n');
+            if (proposals.length === 0) {
+                console.log('   No proposals found');
+                return;
+            }
+            for (const p of proposals.slice(0, 10)) {
+                const icon = p.status === 'passed' ? '✅' :
+                    p.status === 'rejected' ? '❌' :
+                        p.status === 'active' ? '🗳️' :
+                            p.status === 'executed' ? '🚀' : '⏸️';
+                console.log(`   ${icon} ${p.title} (${p.type})`);
+                console.log(`      Status: ${p.status} | For: ${p.votesFor} | Against: ${p.votesAgainst}`);
+            }
+            break;
+        }
+        case 'view': {
+            if (!options.proposal) {
+                console.error('❌ Required: --proposal <id>');
+                return;
+            }
+            const p = forge.getProposal(options.proposal);
+            if (!p) {
+                console.error('❌ Proposal not found');
+                return;
+            }
+            console.log(`\n📋 ${p.title}`);
+            console.log(`   ID: ${p.id}`);
+            console.log(`   Type: ${p.type}`);
+            console.log(`   Status: ${p.status}`);
+            console.log(`   Proposer: ${p.proposer}`);
+            console.log(`   Voting ends: ${p.votingEnd}`);
+            console.log(`\n   Votes: For ${p.votesFor} | Against ${p.votesAgainst} | Abstain ${p.votesAbstain}`);
+            console.log(`   Participation: ${p.voters.size}/${p.eligibleVoters} agents`);
+            break;
+        }
+        case 'execute': {
+            if (!options.proposal) {
+                console.error('❌ Required: --proposal <id>');
+                return;
+            }
+            await forge.executeProposal(options.proposal);
+            break;
+        }
+        case 'params': {
+            const params = forge.getParameters();
+            console.log('\n⚙️  Current Protocol Parameters\n');
+            console.log(JSON.stringify(params, null, 2));
+            break;
+        }
+    }
+}
+exports.default = ClawForge;
+//# sourceMappingURL=forge.js.map

package/dist/lib/forge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge.js","sourceRoot":"","sources":["../../src/lib/forge.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8fH,oCAqHC;AAjnBD,uCAAyB;AACzB,2CAA6B;AAE7B,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,MAAM,qBAAqB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAE,WAAW;AAC/D,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAI,kBAAkB;AACtE,MAAM,iBAAiB,GAAG,EAAE,CAAC,CAAuB,yBAAyB;AAC7E,MAAM,sBAAsB,GAAG,EAAE,CAAC,CAAkB,sBAAsB;AAC1E,MAAM,kBAAkB,GAAG,EAAE,CAAC,CAAsB,mBAAmB;AA4GvE,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAElE,QAAA,kBAAkB,GAAuB;IACpD,WAAW,EAAE;QACX,UAAU,EAAE,GAAG;QACf,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,CAAC;KACf;IACD,GAAG,EAAE;QACH,gBAAgB,EAAE,EAAE;QACpB,oBAAoB,EAAE,CAAC;QACvB,oBAAoB,EAAE,EAAE;QACxB,kBAAkB,EAAE,GAAG;KACxB;IACD,QAAQ,EAAE;QACR,eAAe,EAAE,GAAG;QACpB,iBAAiB,EAAE,GAAG;QACtB,iBAAiB,EAAE,GAAG;QACtB,WAAW,EAAE,GAAG;QAChB,cAAc,EAAE,EAAE;KACnB;IACD,SAAS,EAAE;QACT,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,CAAC;QACtB,eAAe,EAAE,EAAE;KACpB;IACD,UAAU,EAAE;QACV,iBAAiB,EAAE,EAAE;QACrB,sBAAsB,EAAE,EAAE;QAC1B,gBAAgB,EAAE,EAAE;QACpB,qBAAqB,EAAE,EAAE;QACzB,oBAAoB,EAAE,CAAC;KACxB;CACF,CAAC;AAEF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAa,SAAS;IACZ,SAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;IAC7C,UAAU,CAAqB;IAC/B,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,aAAa,CAAkB;IAEvC,YAAY,MAAc,EAAE,UAAkB;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,2EAA2E;IAC3E,cAAc;IACd,2EAA2E;IAE3E,IAAY,UAAU;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;IACtE,CAAC;IAED,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAC;IACzE,CAAC;IAEO,cAAc;QACpB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,EAAE,GAAG,0BAAkB,EAAE,CAAC;IACnC,CAAC;IAEO,cAAc;QACpB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAEO,aAAa;QACnB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;YACrE,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,IAAgB,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,2EAA2E;IAC3E,sBAAsB;IACtB,2EAA2E;IAE3E;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,WAAmB,EACnB,KAAa,EACb,WAAmB,EACnB,IAAkB,EAClB,gBAA8C;QAE9C,2BAA2B;QAC3B,IAAI,WAAW,GAAG,sBAAsB,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,kCAAkC,WAAW,MAAM,sBAAsB,EAAE,CAAC,CAAC;YAC3F,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,QAAQ,GAAa;YACzB,EAAE;YACF,KAAK;YACL,WAAW;YACX,IAAI;YACJ,QAAQ,EAAE,cAAc;YACxB,WAAW;YACX,gBAAgB;YAChB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;YACtC,WAAW,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;YACxC,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,GAAG,qBAAqB,CAAC,CAAC,WAAW,EAAE;YAC9D,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,CAAC;YACnB,MAAM,EAAE,IAAI,GAAG,EAAE;YACjB,cAAc,EAAE,MAAM,IAAI,CAAC,qBAAqB,EAAE;SACnD,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;QAErD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,UAAkB,EAClB,WAAmB,EACnB,QAAgB,EAChB,MAAkB,EAClB,SAAiB;QAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC;YACrD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,yBAAyB;QACzB,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,eAAe,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,oBAAoB;QACpB,IAAI,QAAQ,GAAG,kBAAkB,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,MAAM,kBAAkB,EAAE,CAAC,CAAC;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,0BAA0B;QAC1B,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,cAAc;QACd,MAAM,IAAI,GAAS;YACjB,MAAM,EAAE,WAAW;YACnB,MAAM;YACN,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS;SACV,CAAC;QAEF,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAEvC,iBAAiB;QACjB,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,KAAK;gBACR,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC;gBAC9B,MAAM;YACR,KAAK,SAAS;gBACZ,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC;gBAClC,MAAM;YACR,KAAK,SAAS;gBACZ,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC;gBAClC,MAAM;QACV,CAAC;QAED,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC;QAEtC,4CAA4C;QAC5C,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAEpC,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,KAAK,QAAQ,OAAO,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,mBAAmB;IACnB,2EAA2E;IAE3E;;OAEG;IACK,oBAAoB,CAAC,QAAkB;QAC7C,MAAM,iBAAiB,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC;QAEjF,+CAA+C;QAC/C,IAAI,iBAAiB,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,GAAG,GAAG,oBAAoB,CAAC;YAE1C,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;gBACxB,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;gBACpD,OAAO,CAAC,GAAG,CAAC,oBAAoB,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,QAAkB;QACxC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC;QACjF,OAAO,iBAAiB,IAAI,iBAAiB,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QAEtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAEzD,+BAA+B;QAC/B,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,+BAA+B,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,eAAe;QACf,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,+BAA+B,CAAC,CAAC;YACrE,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,sCAAsC;QACtC,IAAI,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC9C,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,SAAS,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,QAAQ,eAAe,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,WAAW,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,QAAQ,eAAe,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,0BAA0B;QAC1B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC/C,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QACpE,CAAC;QAED,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC;QAC7B,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,WAAW,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,gBAAgB,CAAC,MAAM,qBAAqB,CAAC,CAAC;QAEzE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,SAAiB,EAAE,KAAc;QAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,GAAQ,IAAI,CAAC,UAAU,CAAC;QAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,MAAM,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,2EAA2E;IAC3E,cAAc;IACd,2EAA2E;IAEnE,KAAK,CAAC,qBAAqB;QACjC,kEAAkE;QAClE,wCAAwC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,2EAA2E;IAC3E,SAAS;IACT,2EAA2E;IAE3E;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;YACpC,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC5C,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACjC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB;QAEhC,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACxD,CAAC;IAED,2EAA2E;IAC3E,UAAU;IACV,2EAA2E;IAE3E,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aACvC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,aAAa;QACX,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;CACF;AAtVD,8BAsVC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAExE,KAAK,UAAU,YAAY,CAChC,MAAmE,EACnE,OAAY,EACZ,MAAc,EACd,UAAkB,EAClB,QAAgB;IAEhB,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEhD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,QAAQ,GAAG,sBAAsB,EAAE,CAAC;gBACtC,OAAO,CAAC,KAAK,CAAC,kCAAkC,QAAQ,MAAM,sBAAsB,EAAE,CAAC,CAAC;gBACxF,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,CAAC;oBACf,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,YAAY,EAAE,OAAO,CAAC,OAAO;oBAC7B,aAAa,EAAE,OAAO,CAAC,KAAK;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,oBAAoB;iBAC/C,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC,cAAc,CACxB,MAAM,EACN,QAAQ,EACR,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,IAAI,IAAI,gBAAgB,EAChC,OAAO,CACR,CAAC;YACF,MAAM;QACR,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACzC,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;gBAC5E,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,GAAG,kBAAkB,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,MAAM,kBAAkB,EAAE,CAAC,CAAC;gBACjF,OAAO;YACT,CAAC;YAED,0CAA0C;YAC1C,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAEtC,MAAM,KAAK,CAAC,QAAQ,CAClB,OAAO,CAAC,QAAQ,EAChB,MAAM,EACN,QAAQ,EACR,OAAO,CAAC,MAAoB,EAC5B,SAAS,CACV,CAAC;YACF,MAAM;QACR,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,SAAS,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAE5C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;gBACrC,OAAO;YACT,CAAC;YAED,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBAC7B,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;wBAC/B,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;4BAC/B,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnD,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBACjD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,QAAQ,eAAe,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YAC7F,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;YAED,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,QAAQ,cAAc,CAAC,CAAC,YAAY,cAAc,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YACrG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,cAAc,SAAS,CAAC,CAAC;YAC7E,MAAM;QACR,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;YACD,MAAM,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM;QACR,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,MAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC;AAED,kBAAe,SAAS,CAAC"}

package/dist/lib/scheduler.d.ts

@@ -0,0 +1,138 @@
+/**
+ * ClawScheduler - Persistent Task Scheduler for MoltOS
+ *
+ * Features:
+ * - Hybrid checkpointing: WASM state serialization (primary) + Firecracker snapshots (fallback)
+ * - Dual triggers: Cron-based and event-based (ClawBus webhooks)
+ * - ClawFS storage with optional remote replication
+ * - Persistent daemon with automatic restart from last checkpoint
+ *
+ * Architecture:
+ * - Scheduler daemon runs as background process
+ * - Tasks are defined as WASM modules or shell commands
+ * - State serialized to ClawFS on each checkpoint
+ * - Failed tasks auto-restart from last known good state
+ */
+export type TaskTrigger = {
+    type: 'cron';
+    expression: string;
+} | {
+    type: 'event';
+    topic: string;
+} | {
+    type: 'once';
+    delayMs?: number;
+};
+export type CheckpointMode = 'wasm' | 'firecracker' | 'auto';
+export interface TaskConfig {
+    id: string;
+    name: string;
+    command: string;
+    args?: string[];
+    workingDir?: string;
+    env?: Record<string, string>;
+    trigger: TaskTrigger;
+    checkpointMode: CheckpointMode;
+    checkpointInterval?: number;
+    maxRetries: number;
+    timeout?: number;
+    replicate?: boolean;
+}
+export interface TaskState {
+    id: string;
+    status: 'pending' | 'running' | 'paused' | 'failed' | 'completed';
+    pid?: number;
+    startedAt?: string;
+    lastCheckpoint?: string;
+    checkpointId?: string;
+    runCount: number;
+    failCount: number;
+    lastError?: string;
+    envSnapshot?: Record<string, string>;
+}
+export interface Checkpoint {
+    id: string;
+    taskId: string;
+    timestamp: string;
+    type: 'wasm' | 'firecracker';
+    statePath: string;
+    metadata: {
+        pid?: number;
+        cwd: string;
+        env: Record<string, string>;
+        exitCode?: number;
+    };
+    merkleRoot: string;
+}
+export interface Schedule {
+    tasks: TaskConfig[];
+    global: {
+        defaultCheckpointInterval: number;
+        maxConcurrentTasks: number;
+        replicateByDefault: boolean;
+    };
+}
+export declare class ClawScheduler {
+    private tasks;
+    private states;
+    private processes;
+    private cronCache;
+    private clawfs;
+    private privateKey;
+    private clawId;
+    private isRunning;
+    private checkInterval?;
+    private checkpointIntervals;
+    private eventListeners;
+    constructor(baseDir: string, clawId: string, privateKey: string);
+    private get schedulePath();
+    private get statePath();
+    private loadSchedule;
+    private saveState;
+    /**
+     * Add a new scheduled task
+     */
+    addTask(config: Omit<TaskConfig, 'id'>): TaskConfig;
+    private saveSchedule;
+    /**
+     * Remove a task
+     */
+    removeTask(taskId: string): boolean;
+    /**
+     * Start a specific task
+     */
+    startTask(taskId: string, fromCheckpoint?: string): Promise<void>;
+    /**
+     * Stop a running task
+     */
+    stopTask(taskId: string): void;
+    private createCheckpoint;
+    private loadCheckpoint;
+    /**
+     * Start the scheduler daemon
+     */
+    start(): void;
+    /**
+     * Stop the scheduler daemon
+     */
+    stop(): void;
+    private checkCronTriggers;
+    /**
+     * Subscribe to a ClawBus topic for event triggers
+     */
+    subscribeEvent(topic: string, handler: (data: unknown) => void): void;
+    /**
+     * Emit an event to trigger event-based tasks
+     */
+    emitEvent(topic: string, data: unknown): void;
+    getStatus(): {
+        isRunning: boolean;
+        taskCount: number;
+        runningCount: number;
+        tasks: TaskState[];
+    };
+    getTaskLogs(taskId: string): string;
+}
+export declare function schedulerCommand(action: 'start' | 'stop' | 'status' | 'add' | 'remove' | 'logs', options: any, clawId: string, privateKey: string): Promise<void>;
+export default ClawScheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/lib/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/lib/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE;QACN,yBAAyB,EAAE,MAAM,CAAC;QAClC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;CACH;AAsKD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,mBAAmB,CAA0C;IACrE,OAAO,CAAC,cAAc,CAAuD;gBAG3E,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM;IAYpB,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,UAAU;IA0BnD,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAcnC;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8FvE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;YA+BhB,gBAAgB;IA2B9B,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAeb;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAOrE;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAsB7C,SAAS,IAAI;QACX,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,SAAS,EAAE,CAAC;KACpB;IASD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAOpC;AAMD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,EAC/D,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAoGf;AAED,eAAe,aAAa,CAAC"}