@arc402/daemon 1.2.0

package/dist/job-lifecycle.d.ts

@@ -0,0 +1,62 @@
+import { type AggregatedTokenUsage } from "./token-metering";
+export interface ExecutionReceipt {
+    schema: "arc402.execution-receipt.v1";
+    agreement_id: string;
+    workroom_policy_hash: string;
+    started_at: string;
+    completed_at: string;
+    deliverable_hash: string;
+    worker_address: string;
+    metrics: {
+        wall_clock_seconds: number;
+        network_hosts_contacted: string[];
+        policy_violations_attempted: number;
+    };
+    token_usage: AggregatedTokenUsage | null;
+    receipt_hash: string;
+}
+/**
+ * Generate and persist an execution receipt after job delivery.
+ */
+export declare function generateReceipt(params: {
+    agreementId: string;
+    deliverableHash: string;
+    walletAddress: string;
+    startedAt: string;
+    completedAt: string;
+    policyFilePath?: string;
+    networkHosts?: string[];
+}): ExecutionReceipt;
+/**
+ * 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)
+ */
+export declare function extractLearnings(params: {
+    agreementId: string;
+    taskDescription: string;
+    deliverableHash: string;
+    priceEth: string;
+    capability: string;
+    wallClockSeconds: number;
+    success: boolean;
+}): void;
+/**
+ * Create an isolated job directory for a specific agreement.
+ * Returns the path to the job workspace.
+ */
+export declare function createJobDirectory(agreementId: string): string;
+/**
+ * Clean up a job directory after settlement.
+ * Preserves the receipt and job memory — only removes working files.
+ */
+export declare function cleanJobDirectory(agreementId: string): void;
+/**
+ * Compute the SHA-256 hash of the current workroom policy.
+ * This hash can be registered in AgentRegistry for verifiability.
+ */
+export declare function computePolicyHash(policyFilePath?: string): string;
+//# sourceMappingURL=job-lifecycle.d.ts.map

package/dist/job-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-lifecycle.d.ts","sourceRoot":"","sources":["../src/job-lifecycle.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAW9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,6BAA6B,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE;QACP,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,MAAM,EAAE,CAAC;QAClC,2BAA2B,EAAE,MAAM,CAAC;KACrC,CAAC;IACF,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,gBAAgB,CA6CnB;AAID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,IAAI,CA2DP;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAK3D;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAKjE"}

package/dist/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/job-lifecycle.js.map

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

package/dist/notify.d.ts

@@ -0,0 +1,51 @@
+import type { DaemonConfig } from "./config";
+export type NotifyEvent = "hire_request" | "hire_accepted" | "hire_rejected" | "delivery" | "dispute" | "channel_challenge" | "low_balance" | "daemon_started" | "daemon_stopped";
+export interface NotificationChannel {
+    send(title: string, body: string): Promise<void>;
+}
+export declare class TelegramChannel implements NotificationChannel {
+    private botToken;
+    private chatId;
+    constructor(botToken: string, chatId: string);
+    send(title: string, body: string): Promise<void>;
+}
+export declare class DiscordChannel implements NotificationChannel {
+    private webhookUrl;
+    constructor(webhookUrl: string);
+    send(title: string, body: string): Promise<void>;
+}
+export declare class WebhookChannel implements NotificationChannel {
+    private url;
+    private headers;
+    constructor(url: string, headers?: Record<string, string>);
+    send(title: string, body: string): Promise<void>;
+}
+export declare class EmailChannel implements NotificationChannel {
+    private cfg;
+    constructor(cfg: {
+        smtpHost: string;
+        smtpPort: number;
+        smtpUser: string;
+        smtpPass: string;
+        to: string;
+    });
+    send(title: string, body: string): Promise<void>;
+}
+export declare class Notifier {
+    private channels;
+    private notifyFlags;
+    constructor(channels: NotificationChannel[], flags?: Partial<Record<NotifyEvent, boolean>>);
+    isEnabled(): boolean;
+    send(event: NotifyEvent, title: string, body: 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>;
+}
+export declare function buildNotifier(config: DaemonConfig): Notifier;
+//# sourceMappingURL=notify.d.ts.map

package/dist/notify.d.ts.map

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

package/dist/notify.js

@@ -0,0 +1,276 @@
+"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 = exports.EmailChannel = exports.WebhookChannel = exports.DiscordChannel = exports.TelegramChannel = void 0;
+exports.buildNotifier = buildNotifier;
+/**
+ * Multi-channel notification module for daemon events.
+ * Supports Telegram, Discord webhooks, generic webhooks, and email (via nodemailer).
+ */
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+// ─── HTTP helper ──────────────────────────────────────────────────────────────
+function httpPost(url, payload, extraHeaders) {
+    return new Promise((resolve, reject) => {
+        const parsed = new URL(url);
+        const mod = parsed.protocol === "https:" ? https : http;
+        const options = {
+            hostname: parsed.hostname,
+            port: parsed.port || (parsed.protocol === "https:" ? 443 : 80),
+            path: parsed.pathname + parsed.search,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(payload),
+                ...extraHeaders,
+            },
+        };
+        const req = mod.request(options, (res) => {
+            res.resume();
+            res.on("end", () => {
+                if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`HTTP ${res.statusCode}`));
+                }
+            });
+        });
+        req.on("error", reject);
+        req.write(payload);
+        req.end();
+    });
+}
+// ─── Telegram channel ─────────────────────────────────────────────────────────
+class TelegramChannel {
+    constructor(botToken, chatId) {
+        this.botToken = botToken;
+        this.chatId = chatId;
+    }
+    async send(title, body) {
+        const text = body ? `<b>${title}</b>\n${body}` : `<b>${title}</b>`;
+        const payload = JSON.stringify({ chat_id: this.chatId, text, parse_mode: "HTML" });
+        const options = {
+            hostname: "api.telegram.org",
+            port: 443,
+            path: `/bot${this.botToken}/sendMessage`,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(payload),
+            },
+        };
+        await new Promise((resolve, reject) => {
+            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();
+        });
+    }
+}
+exports.TelegramChannel = TelegramChannel;
+// ─── Discord channel ──────────────────────────────────────────────────────────
+class DiscordChannel {
+    constructor(webhookUrl) {
+        this.webhookUrl = webhookUrl;
+    }
+    async send(title, body) {
+        const content = body ? `**${title}**\n${body}` : `**${title}**`;
+        await httpPost(this.webhookUrl, JSON.stringify({ content }), {});
+    }
+}
+exports.DiscordChannel = DiscordChannel;
+// ─── Generic webhook channel ──────────────────────────────────────────────────
+class WebhookChannel {
+    constructor(url, headers = {}) {
+        this.url = url;
+        this.headers = headers;
+    }
+    async send(title, body) {
+        await httpPost(this.url, JSON.stringify({ title, body, timestamp: new Date().toISOString() }), this.headers);
+    }
+}
+exports.WebhookChannel = WebhookChannel;
+// ─── Email channel (optional — requires nodemailer) ───────────────────────────
+class EmailChannel {
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    async send(title, body) {
+        // nodemailer is an optional runtime dependency — load via require to skip
+        // compile-time module resolution. Throws a clear message if not installed.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-explicit-any
+        let nodemailer;
+        try {
+            // Using Function constructor avoids TypeScript static import analysis.
+            nodemailer = (new Function("require", "return require('nodemailer')"))(require);
+        }
+        catch {
+            throw new Error("nodemailer is not installed. Run: npm install nodemailer");
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+        const transport = nodemailer.createTransport({
+            host: this.cfg.smtpHost,
+            port: this.cfg.smtpPort,
+            auth: { user: this.cfg.smtpUser, pass: this.cfg.smtpPass },
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+        await transport.sendMail({
+            from: this.cfg.smtpUser,
+            to: this.cfg.to,
+            subject: title,
+            text: body,
+        });
+    }
+}
+exports.EmailChannel = EmailChannel;
+// ─── Notifier ─────────────────────────────────────────────────────────────────
+class Notifier {
+    constructor(channels, flags = {}) {
+        this.channels = channels;
+        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.channels.length > 0;
+    }
+    async send(event, title, body) {
+        if (!this.notifyFlags[event])
+            return;
+        await Promise.all(this.channels.map(async (ch) => {
+            try {
+                await ch.send(title, body);
+            }
+            catch (err) {
+                process.stderr.write(`[notify] Channel send failed: ${err}\n`);
+            }
+        }));
+    }
+    async notifyHireRequest(hireId, hirerAddress, priceEth, capability) {
+        const short = hirerAddress.slice(0, 10);
+        await this.send("hire_request", "Hire Request", [
+            `ID: ${hireId}`,
+            `From: ${short}...`,
+            `Capability: ${capability || "unspecified"}`,
+            `Price: ${priceEth} ETH`,
+            ``,
+            `Approve: arc402 daemon approve ${hireId}`,
+            `Reject:  arc402 daemon reject ${hireId}`,
+        ].join("\n"));
+    }
+    async notifyHireAccepted(hireId, agreementId) {
+        await this.send("hire_accepted", "Hire Accepted", `ID: ${hireId}\nAgreement: ${agreementId}`);
+    }
+    async notifyHireRejected(hireId, reason) {
+        await this.send("hire_rejected", "Hire Rejected", `ID: ${hireId}\nReason: ${reason}`);
+    }
+    async notifyDelivery(agreementId, deliveryHash, userOpHash) {
+        await this.send("delivery", "Delivery Submitted", [
+            `Agreement: ${agreementId}`,
+            `Delivery hash: ${deliveryHash.slice(0, 16)}...`,
+            `UserOp: ${userOpHash.slice(0, 16)}...`,
+        ].join("\n"));
+    }
+    async notifyDispute(agreementId, raisedBy) {
+        await this.send("dispute", "Dispute Raised", `Agreement: ${agreementId}\nBy: ${raisedBy}`);
+    }
+    async notifyChannelChallenge(channelId, txHash) {
+        await this.send("channel_challenge", "Channel Challenged", `Channel: ${channelId.slice(0, 16)}...\nTx: ${txHash.slice(0, 16)}...`);
+    }
+    async notifyLowBalance(balanceEth, thresholdEth) {
+        await this.send("low_balance", "Low Balance Alert", `Current: ${balanceEth} ETH\nThreshold: ${thresholdEth} ETH`);
+    }
+    async notifyStarted(walletAddress, subsystems) {
+        await this.send("daemon_started", "ARC-402 Daemon Started", `Wallet: ${walletAddress}\nSubsystems: ${subsystems.join(", ")}`);
+    }
+    async notifyStopped() {
+        await this.send("daemon_stopped", "ARC-402 Daemon Stopped", "");
+    }
+}
+exports.Notifier = Notifier;
+// ─── Factory ──────────────────────────────────────────────────────────────────
+function buildNotifier(config) {
+    const notif = config.notifications;
+    const channels = [];
+    if (notif.telegram_bot_token && notif.telegram_chat_id) {
+        channels.push(new TelegramChannel(notif.telegram_bot_token, notif.telegram_chat_id));
+    }
+    if (notif.discord?.webhook_url) {
+        channels.push(new DiscordChannel(notif.discord.webhook_url));
+    }
+    if (notif.webhook?.url) {
+        channels.push(new WebhookChannel(notif.webhook.url, notif.webhook.headers ?? {}));
+    }
+    if (notif.email?.smtp_host && notif.email?.smtp_user && notif.email?.to) {
+        channels.push(new EmailChannel({
+            smtpHost: notif.email.smtp_host,
+            smtpPort: notif.email.smtp_port,
+            smtpUser: notif.email.smtp_user,
+            smtpPass: notif.email.smtp_pass,
+            to: notif.email.to,
+        }));
+    }
+    return new Notifier(channels, {
+        hire_request: notif.notify_on_hire_request,
+        hire_accepted: notif.notify_on_hire_accepted,
+        hire_rejected: notif.notify_on_hire_rejected,
+        delivery: notif.notify_on_delivery,
+        dispute: notif.notify_on_dispute,
+        channel_challenge: notif.notify_on_channel_challenge,
+        low_balance: notif.notify_on_low_balance,
+    });
+}
+//# sourceMappingURL=notify.js.map

package/dist/notify.js.map

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

package/dist/permission-gate.d.ts

@@ -0,0 +1,30 @@
+import { ethers } from "ethers";
+export interface ToolPermissionContext {
+    agreementId: string;
+    walletAddress: `0x${string}`;
+    policyEngineAddress: `0x${string}`;
+    provider: ethers.Provider;
+}
+export interface ToolPermission {
+    tool: string;
+    input: unknown;
+    context: ToolPermissionContext;
+}
+export type PermissionDecision = {
+    granted: true;
+    estimatedSpend?: bigint;
+} | {
+    granted: false;
+    reason: string;
+    estimatedSpend?: bigint;
+};
+export interface PermissionGateDependencies {
+    createPolicyEngine?: (address: string, provider: ethers.Provider) => {
+        validateSpend: {
+            staticCall: (wallet: string, category: string, amount: bigint, contextId: string) => Promise<[boolean, string]>;
+        };
+    };
+}
+export declare function checkPermissions(p: ToolPermission, deps?: PermissionGateDependencies): Promise<PermissionDecision>;
+export declare function resetPermissionCache(): void;
+//# sourceMappingURL=permission-gate.d.ts.map