arc402-cli 0.2.0

package/dist/daemon/job-lifecycle.js

@@ -0,0 +1,201 @@
+"use strict";
+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.generateReceipt = generateReceipt;
+exports.extractLearnings = extractLearnings;
+exports.createJobDirectory = createJobDirectory;
+exports.cleanJobDirectory = cleanJobDirectory;
+exports.computePolicyHash = computePolicyHash;
+/**
+ * ARC-402 Job Lifecycle — Post-delivery processing.
+ *
+ * Handles everything that happens after a worker completes a job:
+ *   1. Execution receipt generation
+ *   2. Learning extraction from completed work
+ *   3. Worker memory update
+ *   4. Per-agreement job directory management
+ *
+ * These functions are called by the daemon after a successful delivery.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const crypto = __importStar(require("crypto"));
+const token_metering_1 = require("./token-metering");
+const ARC402_DIR = path.join(os.homedir(), ".arc402");
+const RECEIPTS_DIR = path.join(ARC402_DIR, "receipts");
+const WORKER_DIR = path.join(ARC402_DIR, "worker");
+const WORKER_MEMORY_DIR = path.join(WORKER_DIR, "memory");
+const WORKER_CONFIG = path.join(WORKER_DIR, "config.json");
+const JOBS_DIR = path.join(ARC402_DIR, "jobs");
+/**
+ * Generate and persist an execution receipt after job delivery.
+ */
+function generateReceipt(params) {
+    fs.mkdirSync(RECEIPTS_DIR, { recursive: true });
+    // Compute policy hash
+    let policyHash = "0x0";
+    const policyPath = params.policyFilePath ?? path.join(ARC402_DIR, "openshell-policy.yaml");
+    if (fs.existsSync(policyPath)) {
+        const content = fs.readFileSync(policyPath, "utf-8");
+        policyHash = "0x" + crypto.createHash("sha256").update(content).digest("hex");
+    }
+    // Calculate wall clock time
+    const started = new Date(params.startedAt).getTime();
+    const completed = new Date(params.completedAt).getTime();
+    const wallClockSeconds = Math.max(0, Math.floor((completed - started) / 1000));
+    // Read token usage report (if the worker wrote one)
+    const tokenUsage = (0, token_metering_1.readUsageReport)(params.agreementId);
+    const receipt = {
+        schema: "arc402.execution-receipt.v1",
+        agreement_id: params.agreementId,
+        workroom_policy_hash: policyHash,
+        started_at: params.startedAt,
+        completed_at: params.completedAt,
+        deliverable_hash: params.deliverableHash,
+        worker_address: params.walletAddress,
+        metrics: {
+            wall_clock_seconds: wallClockSeconds,
+            network_hosts_contacted: params.networkHosts ?? [],
+            policy_violations_attempted: 0,
+        },
+        token_usage: tokenUsage,
+        receipt_hash: "", // filled below
+    };
+    // Receipt hash = SHA-256 of the receipt content (without the hash field)
+    const hashInput = JSON.stringify({ ...receipt, receipt_hash: undefined });
+    receipt.receipt_hash = "0x" + crypto.createHash("sha256").update(hashInput).digest("hex");
+    // Persist
+    const receiptPath = path.join(RECEIPTS_DIR, `${params.agreementId}.json`);
+    fs.writeFileSync(receiptPath, JSON.stringify(receipt, null, 2));
+    return receipt;
+}
+// ─── Learning Extraction ──────────────────────────────────────────────────────
+/**
+ * Extract learnings from a completed job and update worker memory.
+ *
+ * This creates:
+ *   1. A per-job memory file: memory/job-<id>.md
+ *   2. Updates the cumulative learnings.md
+ *   3. Updates the worker config (job count, earnings)
+ */
+function extractLearnings(params) {
+    fs.mkdirSync(WORKER_MEMORY_DIR, { recursive: true });
+    const now = new Date().toISOString();
+    const dateStr = now.split("T")[0];
+    // 1. Per-job memory file
+    const jobMemory = `# Job: ${params.agreementId}
+*Completed: ${now}*
+*Capability: ${params.capability}*
+*Price: ${params.priceEth} ETH*
+*Duration: ${params.wallClockSeconds}s*
+*Outcome: ${params.success ? "delivered" : "failed"}*
+
+## Task
+${params.taskDescription}
+
+## Deliverable
+Hash: ${params.deliverableHash}
+
+## Learnings
+- Completed ${params.capability} task in ${params.wallClockSeconds}s
+- ${params.success ? "Delivered successfully" : "Delivery failed — review required"}
+`;
+    const jobFile = path.join(WORKER_MEMORY_DIR, `job-${params.agreementId}.md`);
+    fs.writeFileSync(jobFile, jobMemory);
+    // 2. Update cumulative learnings.md
+    const learningsPath = path.join(WORKER_MEMORY_DIR, "learnings.md");
+    let learnings = "";
+    if (fs.existsSync(learningsPath)) {
+        learnings = fs.readFileSync(learningsPath, "utf-8");
+    }
+    const newEntry = `\n### ${dateStr} — ${params.capability} (${params.agreementId.slice(0, 8)}...)
+- Duration: ${params.wallClockSeconds}s | Price: ${params.priceEth} ETH | Outcome: ${params.success ? "✓" : "✗"}
+`;
+    // Append to learnings
+    if (learnings.includes("No learnings yet")) {
+        learnings = `# Accumulated Learnings\n\n*Auto-updated after each completed job.*\n${newEntry}`;
+    }
+    else {
+        learnings += newEntry;
+    }
+    fs.writeFileSync(learningsPath, learnings);
+    // 3. Update worker config
+    if (fs.existsSync(WORKER_CONFIG)) {
+        try {
+            const config = JSON.parse(fs.readFileSync(WORKER_CONFIG, "utf-8"));
+            config.job_count = (config.job_count || 0) + 1;
+            const currentEarnings = parseFloat(config.total_earned_eth || "0");
+            const jobEarnings = parseFloat(params.priceEth || "0");
+            config.total_earned_eth = (currentEarnings + jobEarnings).toFixed(6);
+            config.last_job_at = now;
+            fs.writeFileSync(WORKER_CONFIG, JSON.stringify(config, null, 2));
+        }
+        catch { /* non-fatal — config may be malformed */ }
+    }
+}
+// ─── Per-Agreement Job Directory ──────────────────────────────────────────────
+/**
+ * Create an isolated job directory for a specific agreement.
+ * Returns the path to the job workspace.
+ */
+function createJobDirectory(agreementId) {
+    const jobDir = path.join(JOBS_DIR, `agreement-${agreementId}`);
+    fs.mkdirSync(jobDir, { recursive: true });
+    return jobDir;
+}
+/**
+ * Clean up a job directory after settlement.
+ * Preserves the receipt and job memory — only removes working files.
+ */
+function cleanJobDirectory(agreementId) {
+    const jobDir = path.join(JOBS_DIR, `agreement-${agreementId}`);
+    if (fs.existsSync(jobDir)) {
+        fs.rmSync(jobDir, { recursive: true, force: true });
+    }
+}
+// ─── Policy Hash ──────────────────────────────────────────────────────────────
+/**
+ * Compute the SHA-256 hash of the current workroom policy.
+ * This hash can be registered in AgentRegistry for verifiability.
+ */
+function computePolicyHash(policyFilePath) {
+    const policyPath = policyFilePath ?? path.join(ARC402_DIR, "openshell-policy.yaml");
+    if (!fs.existsSync(policyPath))
+        return "0x0";
+    const content = fs.readFileSync(policyPath, "utf-8");
+    return "0x" + crypto.createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=job-lifecycle.js.map

package/dist/daemon/job-lifecycle.js.map

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

package/dist/daemon/notify.d.ts

@@ -0,0 +1,22 @@
+export type NotifyEvent = "hire_request" | "hire_accepted" | "hire_rejected" | "delivery" | "dispute" | "channel_challenge" | "low_balance" | "daemon_started" | "daemon_stopped";
+export interface TelegramConfig {
+    botToken: string;
+    chatId: string;
+}
+export declare class Notifier {
+    private config;
+    private notifyFlags;
+    constructor(botToken: string, chatId: string, flags?: Partial<Record<NotifyEvent, boolean>>);
+    isEnabled(): boolean;
+    send(event: NotifyEvent, message: string): Promise<void>;
+    notifyHireRequest(hireId: string, hirerAddress: string, priceEth: string, capability: string): Promise<void>;
+    notifyHireAccepted(hireId: string, agreementId: string): Promise<void>;
+    notifyHireRejected(hireId: string, reason: string): Promise<void>;
+    notifyDelivery(agreementId: string, deliveryHash: string, userOpHash: string): Promise<void>;
+    notifyDispute(agreementId: string, raisedBy: string): Promise<void>;
+    notifyChannelChallenge(channelId: string, txHash: string): Promise<void>;
+    notifyLowBalance(balanceEth: string, thresholdEth: string): Promise<void>;
+    notifyStarted(walletAddress: string, subsystems: string[]): Promise<void>;
+    notifyStopped(): Promise<void>;
+}
+//# sourceMappingURL=notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/daemon/notify.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,eAAe,GACf,eAAe,GACf,UAAU,GACV,SAAS,GACT,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiCD,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,WAAW,CAA+B;gBAGhD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAM;IAgBnD,SAAS,IAAI,OAAO;IAId,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5G,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5F,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/daemon/notify.js

@@ -0,0 +1,148 @@
+"use strict";
+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.Notifier = void 0;
+/**
+ * Telegram notification module for daemon events.
+ * Uses Telegram Bot API — no external dependencies.
+ */
+const https = __importStar(require("https"));
+function telegramPost(botToken, method, body) {
+    return new Promise((resolve, reject) => {
+        const payload = JSON.stringify(body);
+        const options = {
+            hostname: "api.telegram.org",
+            port: 443,
+            path: `/bot${botToken}/${method}`,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(payload),
+            },
+        };
+        const req = https.request(options, (res) => {
+            let data = "";
+            res.on("data", (c) => { data += c.toString(); });
+            res.on("end", () => {
+                const parsed = JSON.parse(data);
+                if (!parsed.ok) {
+                    reject(new Error(`Telegram API error: ${parsed.description}`));
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+        req.on("error", reject);
+        req.write(payload);
+        req.end();
+    });
+}
+class Notifier {
+    constructor(botToken, chatId, flags = {}) {
+        this.config = botToken && chatId ? { botToken, chatId } : null;
+        this.notifyFlags = {
+            hire_request: flags.hire_request ?? true,
+            hire_accepted: flags.hire_accepted ?? true,
+            hire_rejected: flags.hire_rejected ?? true,
+            delivery: flags.delivery ?? true,
+            dispute: flags.dispute ?? true,
+            channel_challenge: flags.channel_challenge ?? true,
+            low_balance: flags.low_balance ?? true,
+            daemon_started: true,
+            daemon_stopped: true,
+        };
+    }
+    isEnabled() {
+        return this.config !== null;
+    }
+    async send(event, message) {
+        if (!this.config)
+            return;
+        if (!this.notifyFlags[event])
+            return;
+        try {
+            await telegramPost(this.config.botToken, "sendMessage", {
+                chat_id: this.config.chatId,
+                text: message,
+                parse_mode: "HTML",
+            });
+        }
+        catch (err) {
+            // Non-fatal — log and continue
+            process.stderr.write(`[notify] Telegram send failed: ${err}\n`);
+        }
+    }
+    async notifyHireRequest(hireId, hirerAddress, priceEth, capability) {
+        const short = hirerAddress.slice(0, 10);
+        const msg = [
+            `⚡ <b>Hire Request</b>`,
+            `ID: <code>${hireId}</code>`,
+            `From: <code>${short}...</code>`,
+            `Capability: ${capability || "unspecified"}`,
+            `Price: ${priceEth} ETH`,
+            ``,
+            `Approve: <code>arc402 daemon approve ${hireId}</code>`,
+            `Reject:  <code>arc402 daemon reject ${hireId}</code>`,
+        ].join("\n");
+        await this.send("hire_request", msg);
+    }
+    async notifyHireAccepted(hireId, agreementId) {
+        await this.send("hire_accepted", `✅ <b>Hire Accepted</b>\nID: <code>${hireId}</code>\nAgreement: <code>${agreementId}</code>`);
+    }
+    async notifyHireRejected(hireId, reason) {
+        await this.send("hire_rejected", `❌ <b>Hire Rejected</b>\nID: <code>${hireId}</code>\nReason: ${reason}`);
+    }
+    async notifyDelivery(agreementId, deliveryHash, userOpHash) {
+        await this.send("delivery", `📦 <b>Delivery Submitted</b>\nAgreement: <code>${agreementId}</code>\nDelivery hash: <code>${deliveryHash.slice(0, 16)}...</code>\nUserOp: <code>${userOpHash.slice(0, 16)}...</code>`);
+    }
+    async notifyDispute(agreementId, raisedBy) {
+        await this.send("dispute", `⚠️ <b>Dispute Raised</b>\nAgreement: <code>${agreementId}</code>\nBy: <code>${raisedBy}</code>`);
+    }
+    async notifyChannelChallenge(channelId, txHash) {
+        await this.send("channel_challenge", `🔔 <b>Channel Challenged</b>\nChannel: <code>${channelId.slice(0, 16)}...</code>\nTx: <code>${txHash.slice(0, 16)}...</code>`);
+    }
+    async notifyLowBalance(balanceEth, thresholdEth) {
+        await this.send("low_balance", `💸 <b>Low Balance Alert</b>\nCurrent: ${balanceEth} ETH\nThreshold: ${thresholdEth} ETH`);
+    }
+    async notifyStarted(walletAddress, subsystems) {
+        await this.send("daemon_started", `🟢 <b>ARC-402 Daemon Started</b>\nWallet: <code>${walletAddress}</code>\nSubsystems: ${subsystems.join(", ")}`);
+    }
+    async notifyStopped() {
+        await this.send("daemon_stopped", `🔴 <b>ARC-402 Daemon Stopped</b>`);
+    }
+}
+exports.Notifier = Notifier;
+//# sourceMappingURL=notify.js.map

package/dist/daemon/notify.js.map

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

package/dist/daemon/token-metering.d.ts

@@ -0,0 +1,42 @@
+export interface TokenUsageEntry {
+    model: string;
+    provider: string;
+    input: number;
+    output: number;
+    ts: string;
+    cost_usd?: number;
+}
+export interface AggregatedTokenUsage {
+    total_input: number;
+    total_output: number;
+    total_tokens: number;
+    estimated_cost_usd: number;
+    models_used: string[];
+    entries: number;
+    by_model: Record<string, {
+        input: number;
+        output: number;
+        calls: number;
+        cost_usd: number;
+    }>;
+}
+/**
+ * Get the path where the worker should write token usage for an agreement.
+ * The daemon sets this as an env var before calling exec_command.
+ */
+export declare function getUsageReportPath(agreementId: string): string;
+/**
+ * Create the parent directory and return the path.
+ * Called by the daemon before spawning the worker.
+ */
+export declare function prepareUsageReport(agreementId: string): string;
+/**
+ * Read the token usage report for an agreement and aggregate totals.
+ * Returns null if no report exists.
+ */
+export declare function readUsageReport(agreementId: string): AggregatedTokenUsage | null;
+/**
+ * Format token usage for CLI display.
+ */
+export declare function formatUsageReport(usage: AggregatedTokenUsage): string;
+//# sourceMappingURL=token-metering.d.ts.map

package/dist/daemon/token-metering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metering.d.ts","sourceRoot":"","sources":["../../src/daemon/token-metering.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AA4BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI9D;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAqDhF;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAiBrE"}

package/dist/daemon/token-metering.js

@@ -0,0 +1,178 @@
+"use strict";
+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.getUsageReportPath = getUsageReportPath;
+exports.prepareUsageReport = prepareUsageReport;
+exports.readUsageReport = readUsageReport;
+exports.formatUsageReport = formatUsageReport;
+/**
+ * ARC-402 Token Usage Metering
+ *
+ * Tracks LLM token consumption per agreement. The worker writes a usage report
+ * file during execution; the daemon reads it after delivery and includes the
+ * data in the execution receipt.
+ *
+ * Architecture:
+ *   - Before execution: daemon creates a usage report path for the agreement
+ *   - During execution: worker appends usage entries as it calls LLM APIs
+ *   - After execution: daemon reads the report, aggregates totals, includes in receipt
+ *
+ * The worker writes entries in JSON Lines format to:
+ *   /workroom/jobs/agreement-<id>/token-usage.jsonl
+ *
+ * Each line:
+ *   {"model":"claude-sonnet-4-6","provider":"anthropic","input":1200,"output":450,"ts":"..."}
+ *
+ * This is non-invasive — no proxy, no network interception. The worker
+ * is responsible for reporting its own usage. OpenClaw agents can do this
+ * natively via session metadata.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const ARC402_DIR = path.join(os.homedir(), ".arc402");
+const JOBS_DIR = path.join(ARC402_DIR, "jobs");
+// ─── Known model pricing (USD per 1M tokens, as of 2026-03) ──────────────────
+const MODEL_PRICING = {
+    // Anthropic
+    "claude-opus-4-6": { input: 15.0, output: 75.0 },
+    "claude-sonnet-4-6": { input: 3.0, output: 15.0 },
+    "claude-haiku-4-5": { input: 0.8, output: 4.0 },
+    // OpenAI
+    "gpt-5.4": { input: 2.5, output: 10.0 },
+    "gpt-5.3-codex": { input: 2.5, output: 10.0 },
+    "gpt-4o": { input: 2.5, output: 10.0 },
+    "gpt-4o-mini": { input: 0.15, output: 0.6 },
+    // Google
+    "gemini-2.5-pro": { input: 1.25, output: 10.0 },
+    "gemini-2.5-flash": { input: 0.15, output: 0.6 },
+    // Defaults
+    "default": { input: 2.0, output: 8.0 },
+};
+function estimateCost(model, inputTokens, outputTokens) {
+    const pricing = MODEL_PRICING[model] ?? MODEL_PRICING["default"];
+    return (inputTokens * pricing.input + outputTokens * pricing.output) / 1000000;
+}
+// ─── Usage report path ────────────────────────────────────────────────────────
+/**
+ * Get the path where the worker should write token usage for an agreement.
+ * The daemon sets this as an env var before calling exec_command.
+ */
+function getUsageReportPath(agreementId) {
+    return path.join(JOBS_DIR, `agreement-${agreementId}`, "token-usage.jsonl");
+}
+/**
+ * Create the parent directory and return the path.
+ * Called by the daemon before spawning the worker.
+ */
+function prepareUsageReport(agreementId) {
+    const reportPath = getUsageReportPath(agreementId);
+    fs.mkdirSync(path.dirname(reportPath), { recursive: true });
+    return reportPath;
+}
+// ─── Read and aggregate ───────────────────────────────────────────────────────
+/**
+ * Read the token usage report for an agreement and aggregate totals.
+ * Returns null if no report exists.
+ */
+function readUsageReport(agreementId) {
+    const reportPath = getUsageReportPath(agreementId);
+    if (!fs.existsSync(reportPath))
+        return null;
+    const content = fs.readFileSync(reportPath, "utf-8").trim();
+    if (!content)
+        return null;
+    const lines = content.split("\n").filter(Boolean);
+    const entries = [];
+    for (const line of lines) {
+        try {
+            entries.push(JSON.parse(line));
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    if (entries.length === 0)
+        return null;
+    // Aggregate
+    const byModel = {};
+    let totalInput = 0;
+    let totalOutput = 0;
+    let totalCost = 0;
+    for (const entry of entries) {
+        totalInput += entry.input;
+        totalOutput += entry.output;
+        const model = entry.model || "unknown";
+        if (!byModel[model]) {
+            byModel[model] = { input: 0, output: 0, calls: 0, cost_usd: 0 };
+        }
+        byModel[model].input += entry.input;
+        byModel[model].output += entry.output;
+        byModel[model].calls += 1;
+        const cost = entry.cost_usd ?? estimateCost(model, entry.input, entry.output);
+        byModel[model].cost_usd += cost;
+        totalCost += cost;
+    }
+    return {
+        total_input: totalInput,
+        total_output: totalOutput,
+        total_tokens: totalInput + totalOutput,
+        estimated_cost_usd: Math.round(totalCost * 10000) / 10000, // 4 decimal places
+        models_used: Object.keys(byModel),
+        entries: entries.length,
+        by_model: byModel,
+    };
+}
+// ─── CLI display helper ───────────────────────────────────────────────────────
+/**
+ * Format token usage for CLI display.
+ */
+function formatUsageReport(usage) {
+    const lines = [];
+    lines.push(`Token Usage`);
+    lines.push(`───────────`);
+    lines.push(`Total tokens:  ${usage.total_tokens.toLocaleString()} (${usage.total_input.toLocaleString()} in / ${usage.total_output.toLocaleString()} out)`);
+    lines.push(`Est. cost:     $${usage.estimated_cost_usd.toFixed(4)}`);
+    lines.push(`LLM calls:     ${usage.entries}`);
+    lines.push(``);
+    if (Object.keys(usage.by_model).length > 1) {
+        lines.push(`By model:`);
+        for (const [model, data] of Object.entries(usage.by_model)) {
+            lines.push(`  ${model.padEnd(24)} ${data.calls} calls  ${(data.input + data.output).toLocaleString()} tokens  $${data.cost_usd.toFixed(4)}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=token-metering.js.map

package/dist/daemon/token-metering.js.map

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

package/dist/daemon/userops.d.ts

@@ -0,0 +1,21 @@
+/**
+ * UserOperation builder and submitter for the ARC-402 daemon.
+ * Wraps protocol calls (accept, fulfill) into ERC-4337 UserOperations.
+ */
+import { ethers } from "ethers";
+import type { UserOperation } from "../bundler";
+import type { DaemonConfig } from "./config";
+export declare function encodeWalletCall(target: string, innerCalldata: string, value?: bigint): string;
+export declare function buildAcceptCalldata(serviceAgreementAddress: string, agreementId: string, walletAddress: string): string;
+export declare function buildFulfillCalldata(serviceAgreementAddress: string, agreementId: string, deliveryHash: string, walletAddress: string): string;
+export declare class UserOpsManager {
+    private bundlerClient;
+    private provider;
+    private config;
+    constructor(config: DaemonConfig, provider: ethers.Provider);
+    buildUserOp(callData: string, senderWallet: string): Promise<UserOperation>;
+    submit(callData: string, senderWallet: string): Promise<string>;
+    waitForInclusion(userOpHash: string): Promise<void>;
+    pingBundler(): Promise<boolean>;
+}
+//# sourceMappingURL=userops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userops.d.ts","sourceRoot":"","sources":["../../src/daemon/userops.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAY7C,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,KAAK,SAAY,GAChB,MAAM,CASR;AAED,wBAAgB,mBAAmB,CACjC,uBAAuB,EAAE,MAAM,EAC/B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,CAGR;AAED,wBAAgB,oBAAoB,CAClC,uBAAuB,EAAE,MAAM,EAC/B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,MAAM,CAGR;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ;IAarD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB3E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CActC"}