@usemilkyway/agent-sdk 0.1.2 → 0.2.0

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAiB,MAAM,SAAS,CAAC;AAE/D,UAAU,kBAAkB;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,GAAG,EAAK,OAAO,CAAC;IAChB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACvD;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAI,WAAW,EACrB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAG,kBAAuB,GAChC,aAAa,CA4Df"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAC;AAI5E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAiB,MAAM,SAAS,CAAC;AAE/D,UAAU,kBAAkB;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,GAAG,EAAK,OAAO,CAAC;IAChB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACvD;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAI,WAAW,EACrB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAG,kBAAuB,GAChC,aAAa,CA+Ff"}

package/dist/agent.js

@@ -7,52 +7,82 @@ exports.createAgent = createAgent;
 const express_1 = __importDefault(require("express"));
 const x402_1 = require("./x402");
 const router_1 = require("./router");
+const logger_1 = require("./logger");
 function createAgent(config, handlers, options = {}) {
     const app = (0, express_1.default)();
     app.use(express_1.default.json());
     const devMode = options.devMode ?? process.env.MILKYWAY_DEV_MODE === "true";
-    app.get("/health", (_, res) => {
-        res.json({
-            name: config.name,
-            version: "1.0.0",
-            status: "ok",
-            ...(devMode && { devMode: true })
-        });
+    // ── In-flight request tracking (for graceful shutdown) ─────────────────────
+    let inFlightCount = 0;
+    let isShuttingDown = false;
+    app.use((_req, res, next) => {
+        if (isShuttingDown) {
+            res.setHeader("Connection", "close");
+            return res.status(503).json({ error: "Server is shutting down — please retry" });
+        }
+        inFlightCount++;
+        let decremented = false;
+        const decrement = () => { if (!decremented) {
+            decremented = true;
+            inFlightCount--;
+        } };
+        res.on("finish", decrement);
+        res.on("close", decrement);
+        next();
     });
-    app.get("/about", (_, res) => {
+    // ── Standard endpoints ─────────────────────────────────────────────────────
+    app.get("/health", (_req, res) => {
+        res.json({ name: config.name, version: "1.0.0", status: "ok", ...(devMode && { devMode: true }) });
+    });
+    app.get("/about", (_req, res) => {
         const about = {
             milkyway_version: "1.0",
             name: config.name,
             description: config.description,
             wallet: config.wallet,
             max_deadline_seconds: config.max_deadline_seconds || 30,
-            capabilities: config.capabilities
+            capabilities: config.capabilities,
         };
         res.json(about);
     });
     app.post("/execute", async (req, res) => {
-        const capabilityName = req.body?.task?.capability ||
-            Object.keys(config.capabilities)[0];
+        const capabilityName = req.body?.task?.capability || Object.keys(config.capabilities)[0];
         const capability = config.capabilities[capabilityName];
         if (!capability) {
             return (0, router_1.buildExecuteHandler)(config, handlers)(req, res);
         }
         (0, x402_1.requirePayment)(config.wallet, capability.pricing, devMode)(req, res, () => (0, router_1.buildExecuteHandler)(config, handlers)(req, res));
     });
+    // ── Graceful shutdown ──────────────────────────────────────────────────────
+    function setupGracefulShutdown(server) {
+        const DRAIN_TIMEOUT_MS = 30000;
+        async function shutdown(signal) {
+            console.log(`\n[${config.name}] ${signal} received — shutting down gracefully`);
+            isShuttingDown = true;
+            server.close();
+            const start = Date.now();
+            while (inFlightCount > 0) {
+                if (Date.now() - start > DRAIN_TIMEOUT_MS) {
+                    console.warn(`[${config.name}] Drain timeout — ${inFlightCount} request(s) still in flight. Forcing exit.`);
+                    break;
+                }
+                console.log(`[${config.name}] Draining — ${inFlightCount} request(s) in flight...`);
+                await new Promise((r) => setTimeout(r, 500));
+            }
+            console.log(`[${config.name}] Shutdown complete`);
+            process.exit(0);
+        }
+        process.on("SIGTERM", () => shutdown("SIGTERM"));
+        process.on("SIGINT", () => shutdown("SIGINT"));
+    }
     return {
         app,
         listen: (port, callback) => {
-            app.listen(port, callback || (() => {
-                console.log(`\n✓ ${config.name} running on port ${port}`);
-                if (devMode) {
-                    console.log("✓ Dev mode: payment verification bypassed");
-                }
-                console.log("\nEndpoints:");
-                console.log(`  GET  http://localhost:${port}/health`);
-                console.log(`  GET  http://localhost:${port}/about`);
-                console.log(`  POST http://localhost:${port}/execute\n`);
+            const server = app.listen(port, callback || (() => {
+                (0, logger_1.logStartup)(config.name, port, Object.keys(config.capabilities));
             }));
-        }
+            setupGracefulShutdown(server);
+        },
     };
 }
 //# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/idempotency.d.ts

@@ -0,0 +1,4 @@
+export declare function getCachedResult(jobId: string): unknown | null;
+export declare function cacheResult(jobId: string, response: unknown): void;
+export declare function clearCache(): void;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"AAQA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQ7D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAGlE;AASD,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/idempotency.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedResult = getCachedResult;
+exports.cacheResult = cacheResult;
+exports.clearCache = clearCache;
+const cache = new Map();
+const TTL_MS = 10 * 60 * 1000;
+function getCachedResult(jobId) {
+    const entry = cache.get(jobId);
+    if (!entry)
+        return null;
+    if (Date.now() - entry.cachedAt > TTL_MS) {
+        cache.delete(jobId);
+        return null;
+    }
+    return entry.response;
+}
+function cacheResult(jobId, response) {
+    cache.set(jobId, { response, cachedAt: Date.now() });
+    if (cache.size > 10000)
+        pruneCache();
+}
+function pruneCache() {
+    const now = Date.now();
+    for (const [key, entry] of cache.entries()) {
+        if (now - entry.cachedAt > TTL_MS)
+            cache.delete(key);
+    }
+}
+function clearCache() {
+    cache.clear();
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":";;AAQA,0CAQC;AAED,kCAGC;AASD,gCAEC;AA3BD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;AAC9C,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9B,SAAgB,eAAe,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAC;QACzC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC;AACxB,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa,EAAE,QAAiB;IAC1D,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,IAAI,GAAG,KAAM;QAAE,UAAU,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3C,IAAI,GAAG,GAAG,KAAK,CAAC,QAAQ,GAAG,MAAM;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,SAAgB,UAAU;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export { createAgent } from "./agent";
 export { requirePayment } from "./x402";
 export { verifyPayment } from "./verify";
-export { validateInput } from "./validator";
-export { MilkyWayError, ValidationError, PaymentError, DeadlineError, CapabilityError, InternalError } from "./errors";
+export { coerceInput, validateInput, validateOutput } from "./validator";
+export { clearCache } from "./idempotency";
+export { MilkyWayError, ValidationError, PaymentError, DeadlineError, CapabilityError, InternalError, } from "./errors";
 export * from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAS,SAAS,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAO,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAO,aAAa,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAkC,SAAS,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAA+B,QAAQ,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAgC,UAAU,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAmC,eAAe,CAAC;AACxE,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InternalError = exports.CapabilityError = exports.DeadlineError = exports.PaymentError = exports.ValidationError = exports.MilkyWayError = exports.validateInput = exports.verifyPayment = exports.requirePayment = exports.createAgent = void 0;
+exports.InternalError = exports.CapabilityError = exports.DeadlineError = exports.PaymentError = exports.ValidationError = exports.MilkyWayError = exports.clearCache = exports.validateOutput = exports.validateInput = exports.coerceInput = exports.verifyPayment = exports.requirePayment = exports.createAgent = void 0;
 var agent_1 = require("./agent");
 Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return agent_1.createAgent; } });
 var x402_1 = require("./x402");
@@ -22,7 +22,11 @@ Object.defineProperty(exports, "requirePayment", { enumerable: true, get: functi
 var verify_1 = require("./verify");
 Object.defineProperty(exports, "verifyPayment", { enumerable: true, get: function () { return verify_1.verifyPayment; } });
 var validator_1 = require("./validator");
+Object.defineProperty(exports, "coerceInput", { enumerable: true, get: function () { return validator_1.coerceInput; } });
 Object.defineProperty(exports, "validateInput", { enumerable: true, get: function () { return validator_1.validateInput; } });
+Object.defineProperty(exports, "validateOutput", { enumerable: true, get: function () { return validator_1.validateOutput; } });
+var idempotency_1 = require("./idempotency");
+Object.defineProperty(exports, "clearCache", { enumerable: true, get: function () { return idempotency_1.clearCache; } });
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "MilkyWayError", { enumerable: true, get: function () { return errors_1.MilkyWayError; } });
 Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAyC;AAAhC,oGAAA,WAAW,OAAA;AACpB,+BAAwC;AAA/B,sGAAA,cAAc,OAAA;AACvB,mCAA0C;AAAjC,uGAAA,aAAa,OAAA;AACtB,yCAA6C;AAApC,0GAAA,aAAa,OAAA;AACtB,mCAOkB;AANhB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,uGAAA,aAAa,OAAA;AAEf,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAkE;AAAzD,oGAAA,WAAW,OAAA;AACpB,+BAAiE;AAAxD,sGAAA,cAAc,OAAA;AACvB,mCAAmE;AAA1D,uGAAA,aAAa,OAAA;AACtB,yCAAyE;AAAhE,wGAAA,WAAW,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,2GAAA,cAAc,OAAA;AACnD,6CAAwE;AAA/D,yGAAA,UAAU,OAAA;AACnB,mCAOkB;AANhB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,uGAAA,aAAa,OAAA;AAEf,0CAAwB"}

package/dist/logger.d.ts

@@ -0,0 +1,14 @@
+interface RequestLog {
+    timestamp: string;
+    jobId: string;
+    capability: string;
+    payment: "verified" | "bypassed" | "rejected" | "free";
+    status: "completed" | "failed" | "expired" | "cached";
+    durationMs: number;
+    error?: string;
+}
+export declare function logRequest(log: RequestLog): void;
+export declare function logStartup(name: string, port: number, capabilities: string[]): void;
+export declare function logError(context: string, err: Error): void;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,UAAU,UAAU;IAClB,SAAS,EAAG,MAAM,CAAC;IACnB,KAAK,EAAO,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAK,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1D,MAAM,EAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAM,MAAM,CAAC;CACpB;AAoBD,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAuChD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAiBnF;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAO1D"}

package/dist/logger.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logRequest = logRequest;
+exports.logStartup = logStartup;
+exports.logError = logError;
+const isDev = process.env.NODE_ENV !== "production";
+const isDevMode = process.env.MILKYWAY_DEV_MODE === "true";
+const C = {
+    reset: "\x1b[0m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+    blue: "\x1b[34m",
+    grey: "\x1b[90m",
+    bold: "\x1b[1m",
+};
+function col(colour, text) {
+    if (!isDev)
+        return text;
+    return `${C[colour]}${text}${C.reset}`;
+}
+function logRequest(log) {
+    if (process.env.MILKYWAY_SILENT === "true")
+        return;
+    if (isDev) {
+        const statusIcon = {
+            completed: col("green", "✓"),
+            failed: col("red", "✗"),
+            expired: col("yellow", "⏱"),
+            cached: col("blue", "⚡"),
+        }[log.status];
+        const paymentLabel = {
+            verified: col("green", "paid"),
+            bypassed: col("yellow", "dev"),
+            rejected: col("red", "rejected"),
+            free: col("grey", "free"),
+        }[log.payment];
+        const duration = log.durationMs < 1000
+            ? `${log.durationMs}ms`
+            : `${(log.durationMs / 1000).toFixed(1)}s`;
+        let line = col("grey", log.timestamp.split("T")[1].split(".")[0]) + "  " +
+            statusIcon + "  " +
+            col("bold", log.capability.padEnd(20)) +
+            paymentLabel.padEnd(12) +
+            col("grey", duration.padEnd(10)) +
+            col("grey", log.jobId.slice(0, 8) + "...");
+        if (log.error)
+            line += "\n   " + col("red", `└ ${log.error}`);
+        console.log(line);
+    }
+    else {
+        console.log(JSON.stringify({
+            level: log.status === "failed" || log.status === "expired" ? "error" : "info",
+            ...log,
+        }));
+    }
+}
+function logStartup(name, port, capabilities) {
+    if (process.env.MILKYWAY_SILENT === "true")
+        return;
+    if (isDev) {
+        console.log(col("bold", `\n✦ ${name}`));
+        console.log(`  Port:         ${col("blue", String(port))}`);
+        console.log(`  Capabilities: ${capabilities.map((cap) => col("blue", cap)).join(", ")}`);
+        console.log(`  Payment:      ${isDevMode
+            ? col("yellow", "DEV MODE — bypassed")
+            : col("green", "enabled (x402)")}`);
+        console.log();
+        console.log(col("grey", "time       status  capability           payment     duration   job"));
+        console.log(col("grey", "─".repeat(72)));
+    }
+    else {
+        console.log(JSON.stringify({ level: "info", event: "startup", name, port, capabilities }));
+    }
+}
+function logError(context, err) {
+    if (process.env.MILKYWAY_SILENT === "true")
+        return;
+    if (isDev) {
+        console.error(col("red", `[error] ${context}: ${err.message}`));
+    }
+    else {
+        console.error(JSON.stringify({ level: "error", context, error: err.message, stack: err.stack }));
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAkB,MAAM,SAAS,CAAC;AAQhE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,QAAQ,IAEJ,KAAK,OAAO,EAAE,KAAK,QAAQ,6DAgG1C"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAwB,SAAS,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAkB,MAAM,SAAS,CAAC;AAOhE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,IAC3D,KAAK,OAAO,EAAE,KAAK,QAAQ,6DA0J1C"}

package/dist/router.js

@@ -2,84 +2,144 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildExecuteHandler = buildExecuteHandler;
 const validator_1 = require("./validator");
+const idempotency_1 = require("./idempotency");
+const timeout_1 = require("./timeout");
+const logger_1 = require("./logger");
 const errors_1 = require("./errors");
 function buildExecuteHandler(config, handlers) {
     return async (req, res) => {
         const body = req.body;
+        const jobId = body.job_id;
+        const requestStart = Date.now();
+        const devMode = process.env.MILKYWAY_DEV_MODE === "true";
         if (body.milkyway_version !== "1.0") {
-            return res.status(400).json({
-                error: `Unsupported protocol version: ${body.milkyway_version}`
-            });
+            return res.status(400).json({ error: `Unsupported protocol version: ${body.milkyway_version}` });
         }
         const now = Math.floor(Date.now() / 1000);
         if (body.deadline && now > body.deadline) {
             return res.status(408).json({
                 milkyway_version: "1.0",
-                job_id: body.job_id,
+                job_id: jobId,
                 status: "expired",
                 error: "Deadline has passed",
-                error_type: "deadline"
+                error_type: "deadline",
             });
         }
+        // Resolve capability and handler
+        const capabilityNames = Object.keys(config.capabilities);
+        let capabilityName;
+        let handler;
         try {
-            const capabilityNames = Object.keys(config.capabilities);
-            let capabilityName;
-            let handler;
             if (typeof handlers === "function") {
-                if (capabilityNames.length > 1) {
+                if (capabilityNames.length > 1)
                     throw new errors_1.CapabilityError("multiple capabilities require named handlers", capabilityNames);
-                }
                 capabilityName = capabilityNames[0];
                 handler = handlers;
             }
             else {
                 capabilityName = body.task?.capability || capabilityNames[0];
-                if (!handlers[capabilityName]) {
+                if (!handlers[capabilityName])
                     throw new errors_1.CapabilityError(capabilityName, Object.keys(handlers));
-                }
                 handler = handlers[capabilityName];
             }
-            const capabilityDef = config.capabilities[capabilityName];
-            if (!capabilityDef) {
-                throw new errors_1.CapabilityError(capabilityName, capabilityNames);
+        }
+        catch (err) {
+            const e = err;
+            return res.status(e.statusCode ?? 400).json({
+                milkyway_version: "1.0",
+                job_id: jobId,
+                status: "failed",
+                error: e.message,
+                error_type: e.type ?? "capability",
+            });
+        }
+        const capabilityDef = config.capabilities[capabilityName];
+        // Determine payment status for logging
+        const paymentStatus = capabilityDef.pricing.model === "free" || capabilityDef.pricing.amount === "0"
+            ? "free"
+            : devMode
+                ? "bypassed"
+                : "verified";
+        // Idempotency check
+        if (jobId) {
+            const cached = (0, idempotency_1.getCachedResult)(jobId);
+            if (cached) {
+                (0, logger_1.logRequest)({
+                    timestamp: new Date().toISOString(),
+                    jobId,
+                    capability: capabilityName,
+                    payment: paymentStatus,
+                    status: "cached",
+                    durationMs: Date.now() - requestStart,
+                });
+                return res.json(cached);
             }
-            const validatedInput = (0, validator_1.validateInput)(body.task?.input || {}, capabilityDef.input_schema);
-            const output = await handler(validatedInput);
-            res.json({
+        }
+        try {
+            // Coerce → validate input
+            const coercedInput = (0, validator_1.coerceInput)(body.task?.input || {}, capabilityDef.input_schema);
+            const validatedInput = (0, validator_1.validateInput)(coercedInput, capabilityDef.input_schema);
+            // Run handler with deadline timeout
+            const rawOutput = await (0, timeout_1.withTimeout)(handler(validatedInput), body.deadline);
+            // Validate output
+            const output = (0, validator_1.validateOutput)(rawOutput, capabilityDef.output_schema, devMode ? "warn" : "strict");
+            const response = {
                 milkyway_version: "1.0",
-                job_id: body.job_id,
+                job_id: jobId,
                 status: "completed",
                 output,
-                completed_at: Math.floor(Date.now() / 1000)
+                completed_at: Math.floor(Date.now() / 1000),
+            };
+            if (jobId)
+                (0, idempotency_1.cacheResult)(jobId, response);
+            (0, logger_1.logRequest)({
+                timestamp: new Date().toISOString(),
+                jobId: jobId || "—",
+                capability: capabilityName,
+                payment: paymentStatus,
+                status: "completed",
+                durationMs: Date.now() - requestStart,
             });
+            res.json(response);
         }
         catch (err) {
-            if (err instanceof errors_1.DeadlineError) {
+            const isDeadline = err instanceof errors_1.DeadlineError;
+            const isMilkyWay = err instanceof errors_1.MilkyWayError;
+            const message = err instanceof Error ? err.message : String(err);
+            const status = isDeadline ? "expired" : "failed";
+            (0, logger_1.logRequest)({
+                timestamp: new Date().toISOString(),
+                jobId: jobId || "—",
+                capability: capabilityName,
+                payment: paymentStatus,
+                status,
+                durationMs: Date.now() - requestStart,
+                error: message,
+            });
+            if (isDeadline) {
                 return res.status(408).json({
                     milkyway_version: "1.0",
-                    job_id: body.job_id,
+                    job_id: jobId,
                     status: "expired",
-                    error: err.message,
-                    error_type: err.type
+                    error: message,
+                    error_type: "deadline",
                 });
             }
-            if (err instanceof errors_1.MilkyWayError) {
+            if (isMilkyWay) {
                 return res.status(err.statusCode).json({
                     milkyway_version: "1.0",
-                    job_id: body.job_id,
+                    job_id: jobId,
                     status: "failed",
-                    error: err.message,
-                    error_type: err.type
+                    error: message,
+                    error_type: err.type,
                 });
             }
-            console.error("Agent handler error:", err);
-            const message = err instanceof Error ? err.message : String(err);
             res.status(500).json({
                 milkyway_version: "1.0",
-                job_id: body.job_id,
+                job_id: jobId,
                 status: "failed",
                 error: message,
-                error_type: "internal"
+                error_type: "internal",
             });
         }
     };

package/dist/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":";;AASA,kDAoGC;AA3GD,2CAA4C;AAC5C,qCAIkB;AAElB,SAAgB,mBAAmB,CACjC,MAAmB,EACnB,QAAkB;IAElB,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAsB,CAAC;QAExC,IAAI,IAAI,CAAC,gBAAgB,KAAK,KAAK,EAAE,CAAC;YACpC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,KAAK,EAAE,iCAAiC,IAAI,CAAC,gBAAgB,EAAE;aAChE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,QAAQ,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,gBAAgB,EAAE,KAAK;gBACvB,MAAM,EAAM,IAAI,CAAC,MAAM;gBACvB,MAAM,EAAM,SAAS;gBACrB,KAAK,EAAO,qBAAqB;gBACjC,UAAU,EAAE,UAAU;aACvB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACzD,IAAI,cAAsB,CAAC;YAC3B,IAAI,OAA6E,CAAC;YAElF,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACnC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,IAAI,wBAAe,CACvB,8CAA8C,EAC9C,eAAe,CAChB,CAAC;gBACJ,CAAC;gBACD,cAAc,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;gBACpC,OAAO,GAAG,QAAQ,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;gBAE7D,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,wBAAe,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACnE,CAAC;gBAED,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;YAC1D,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,wBAAe,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,cAAc,GAAG,IAAA,yBAAa,EAClC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EACtB,aAAa,CAAC,YAAY,CAC3B,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;YAE7C,GAAG,CAAC,IAAI,CAAC;gBACP,gBAAgB,EAAE,KAAK;gBACvB,MAAM,EAAY,IAAI,CAAC,MAAM;gBAC7B,MAAM,EAAY,WAAW;gBAC7B,MAAM;gBACN,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;aAC5C,CAAC,CAAC;QAEL,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,GAAG,YAAY,sBAAa,EAAE,CAAC;gBACjC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBAC1B,gBAAgB,EAAE,KAAK;oBACvB,MAAM,EAAM,IAAI,CAAC,MAAM;oBACvB,MAAM,EAAM,SAAS;oBACrB,KAAK,EAAO,GAAG,CAAC,OAAO;oBACvB,UAAU,EAAE,GAAG,CAAC,IAAI;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,IAAI,GAAG,YAAY,sBAAa,EAAE,CAAC;gBACjC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;oBACrC,gBAAgB,EAAE,KAAK;oBACvB,MAAM,EAAM,IAAI,CAAC,MAAM;oBACvB,MAAM,EAAM,QAAQ;oBACpB,KAAK,EAAO,GAAG,CAAC,OAAO;oBACvB,UAAU,EAAE,GAAG,CAAC,IAAI;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,gBAAgB,EAAE,KAAK;gBACvB,MAAM,EAAM,IAAI,CAAC,MAAM;gBACvB,MAAM,EAAM,QAAQ;gBACpB,KAAK,EAAO,OAAO;gBACnB,UAAU,EAAE,UAAU;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}

package/dist/timeout.d.ts

@@ -0,0 +1,2 @@
+export declare function withTimeout<T>(promise: Promise<T>, deadlineEpoch: number): Promise<T>;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAQ,OAAO,CAAC,CAAC,CAAC,EACzB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/timeout.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTimeout = withTimeout;
+const errors_1 = require("./errors");
+function withTimeout(promise, deadlineEpoch // unix seconds
+) {
+    const msRemaining = (deadlineEpoch * 1000) - Date.now() - 1000;
+    if (msRemaining <= 0) {
+        return Promise.reject(new errors_1.DeadlineError());
+    }
+    // Cap at 24 days — setTimeout overflows 32-bit int beyond that
+    const safeMs = Math.min(msRemaining, 2147483647);
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new errors_1.DeadlineError()), safeMs)),
+    ]);
+}
+//# sourceMappingURL=timeout.js.map

package/dist/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":";;AAEA,kCAmBC;AArBD,qCAAyC;AAEzC,SAAgB,WAAW,CACzB,OAAyB,EACzB,aAAqB,CAAQ,eAAe;;IAE5C,MAAM,WAAW,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAE/D,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,sBAAa,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,+DAA+D;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,UAAa,CAAC,CAAC;IAEpD,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,sBAAa,EAAE,CAAC,EAAE,MAAM,CAAC,CACtD;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/types.d.ts

@@ -18,8 +18,17 @@ export interface AgentPricing {
     amount: string;
     currency: "USDC";
 }
+export type PermissionType = "READ_WALLET_BALANCE" | "ACCESS_EXTERNAL_APIS" | "EXECUTE_TRANSACTIONS" | "MANAGE_AGENTS";
+export interface PermissionDeclaration {
+    type: PermissionType;
+    reason: string;
+    token?: string;
+    max_per_transaction?: string;
+    max_lifetime?: string;
+}
 export interface CapabilityDef {
     description: string;
+    permissions?: PermissionDeclaration[];
     pricing: AgentPricing;
     input_schema: AgentSchema;
     output_schema: AgentSchema;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAU,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAK,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAM,OAAO,CAAC;IACtB,GAAG,CAAC,EAAU,MAAM,CAAC;IACrB,GAAG,CAAC,EAAU,MAAM,CAAC;IACrB,SAAS,CAAC,EAAI,MAAM,CAAC;IACrB,SAAS,CAAC,EAAI,MAAM,CAAC;IACrB,IAAI,CAAC,EAAS,OAAO,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAK,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;IACvD,MAAM,EAAI,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAI,MAAM,CAAC;IACtB,OAAO,EAAQ,YAAY,CAAC;IAC5B,YAAY,EAAG,WAAW,CAAC;IAC3B,aAAa,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAO,MAAM,CAAC;IAC9B,IAAI,EAAmB,MAAM,CAAC;IAC9B,WAAW,EAAY,MAAM,CAAC;IAC9B,MAAM,EAAiB,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE;QACZ,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,CAAC;KACzC,CAAC;CACH;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAY,MAAM,CAAC;IACzB,IAAI,EAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,EAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAY,MAAM,CAAC;IACzB,MAAM,EAAY,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,EAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,KAAK,CAAC,EAAY,MAAM,CAAC;IACzB,UAAU,CAAC,EAAO,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;IACpF,YAAY,CAAC,EAAK,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7F,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT;IAAE,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/validator.d.ts

@@ -1,3 +1,5 @@
 import { AgentSchema } from "./types";
+export declare function coerceInput(input: Record<string, unknown>, schema: AgentSchema): Record<string, unknown>;
 export declare function validateInput(input: Record<string, unknown>, schema: AgentSchema): Record<string, unknown>;
+export declare function validateOutput(output: Record<string, unknown>, schema: AgentSchema, mode?: "warn" | "strict"): Record<string, unknown>;
 //# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAY,MAAM,SAAS,CAAC;AAgDhD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,WAAW,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAY,MAAM,SAAS,CAAC;AAKhD,wBAAgB,WAAW,CACzB,KAAK,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AA4DD,wBAAgB,aAAa,CAC3B,KAAK,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAID,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,EACnB,IAAI,GAAI,MAAM,GAAG,QAAmB,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB"}

package/dist/validator.js

@@ -1,8 +1,55 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceInput = coerceInput;
 exports.validateInput = validateInput;
+exports.validateOutput = validateOutput;
 const zod_1 = require("zod");
 const errors_1 = require("./errors");
+// ── Input coercion ────────────────────────────────────────────────────────────
+function coerceInput(input, schema) {
+    const coerced = { ...input };
+    for (const [field, def] of Object.entries(schema)) {
+        const value = coerced[field];
+        if (value === undefined || value === null)
+            continue;
+        const targetType = def.type;
+        const sourceType = Array.isArray(value) ? "array" : typeof value;
+        if (sourceType === targetType)
+            continue;
+        try {
+            coerced[field] = coerce(value, sourceType, targetType, field);
+        }
+        catch (err) {
+            throw new errors_1.ValidationError(err.message);
+        }
+    }
+    return coerced;
+}
+function coerce(value, sourceType, targetType, field) {
+    if (sourceType === "string" && targetType === "number") {
+        const n = parseFloat(value);
+        if (isNaN(n))
+            throw new Error(`Field "${field}": cannot coerce "${value}" to number`);
+        return n;
+    }
+    if (sourceType === "string" && targetType === "boolean") {
+        if (value === "true" || value === "1")
+            return true;
+        if (value === "false" || value === "0")
+            return false;
+        throw new Error(`Field "${field}": cannot coerce "${value}" to boolean. Use "true", "false", "1", or "0"`);
+    }
+    if (sourceType === "number" && targetType === "string")
+        return String(value);
+    if (sourceType === "number" && targetType === "boolean")
+        return value !== 0;
+    if (sourceType === "boolean" && targetType === "string")
+        return String(value);
+    if (sourceType === "boolean" && targetType === "number")
+        return value ? 1 : 0;
+    throw new Error(`Field "${field}": cannot coerce ${sourceType} to ${targetType}`);
+}
+// ── Input validation ──────────────────────────────────────────────────────────
 function buildZodType(def) {
     switch (def.type) {
         case "string": {
@@ -23,14 +70,10 @@ function buildZodType(def) {
                 t = t.max(def.max);
             return t;
         }
-        case "boolean":
-            return zod_1.z.boolean();
-        case "array":
-            return zod_1.z.array(zod_1.z.unknown());
-        case "object":
-            return zod_1.z.record(zod_1.z.unknown());
-        default:
-            return zod_1.z.unknown();
+        case "boolean": return zod_1.z.boolean();
+        case "array": return zod_1.z.array(zod_1.z.unknown());
+        case "object": return zod_1.z.record(zod_1.z.unknown());
+        default: return zod_1.z.unknown();
     }
 }
 function buildZodSchema(schema) {
@@ -48,14 +91,34 @@ function buildZodSchema(schema) {
     return zod_1.z.object(shape);
 }
 function validateInput(input, schema) {
-    const zodSchema = buildZodSchema(schema);
-    const result = zodSchema.safeParse(input);
+    const result = buildZodSchema(schema).safeParse(input);
     if (!result.success) {
-        const issues = result.error.issues
-            .map(i => `${i.path.join(".")}: ${i.message}`)
-            .join(", ");
+        const issues = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ");
         throw new errors_1.ValidationError(issues);
     }
     return result.data;
 }
+// ── Output validation ─────────────────────────────────────────────────────────
+function validateOutput(output, schema, mode = "strict") {
+    const violations = [];
+    for (const [field, def] of Object.entries(schema)) {
+        const value = output[field];
+        if (value === undefined) {
+            violations.push(`output missing field: "${field}" (expected ${def.type})`);
+            continue;
+        }
+        const actualType = Array.isArray(value) ? "array" : typeof value;
+        if (actualType !== def.type) {
+            violations.push(`output field "${field}": expected ${def.type}, got ${actualType}`);
+        }
+    }
+    if (violations.length === 0)
+        return output;
+    const message = `Output schema violation: ${violations.join("; ")}`;
+    if (mode === "warn") {
+        console.warn(`[MilkyWay SDK] ⚠️  ${message}`);
+        return output;
+    }
+    throw new errors_1.InternalError(message);
+}
 //# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/dist/verify.d.ts

@@ -1,2 +1,2 @@
-export declare function verifyPayment(paymentHeader: string, _resource: string, amountUsdc: string): Promise<void>;
+export declare function verifyPayment(paymentHeader: string, resource: string, amountUsdc: string, network?: string): Promise<void>;
 //# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAmCA,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAqEf"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAIA,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAO,MAAM,EACrB,UAAU,EAAK,MAAM,EACrB,OAAO,CAAC,EAAO,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/verify.js

@@ -1,83 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.verifyPayment = verifyPayment;
-const ethers_1 = require("ethers");
 const errors_js_1 = require("./errors.js");
-const USDC_ADDRESS = "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
-const ARBITRUM_RPC = process.env.ARBITRUM_RPC || "https://arb1.arbitrum.io/rpc";
-const CHAIN_ID = 42161;
-const EIP_3009_TYPES = {
-    TransferWithAuthorization: [
-        { name: "from", type: "address" },
-        { name: "to", type: "address" },
-        { name: "value", type: "uint256" },
-        { name: "validAfter", type: "uint256" },
-        { name: "validBefore", type: "uint256" },
-        { name: "nonce", type: "bytes32" },
-    ],
-};
-const DOMAIN = {
-    name: "USD Coin",
-    version: "2",
-    chainId: CHAIN_ID,
-    verifyingContract: USDC_ADDRESS,
-};
-async function verifyPayment(paymentHeader, _resource, amountUsdc) {
-    const rawAmount = BigInt(Math.round(parseFloat(amountUsdc) * 1000000));
-    let payload;
+const MILKYWAY_FACILITATOR = "https://facilitator.usemilkyway.com";
+async function verifyPayment(paymentHeader, resource, amountUsdc, network) {
+    const facilitatorUrl = process.env.X402_FACILITATOR_URL || MILKYWAY_FACILITATOR;
+    const secret = process.env.FACILITATOR_SECRET;
+    if (!secret) {
+        throw new errors_js_1.PaymentError("FACILITATOR_SECRET is not set. " +
+            "Get it from usemilkyway.com/settings and add it to your .env");
+    }
+    const resolvedNetwork = network
+        || process.env.X402_NETWORK
+        || (process.env.NODE_ENV === "production"
+            ? "eip155:42161"
+            : "eip155:421614");
+    const rawAmount = String(Math.round(parseFloat(amountUsdc) * 1000000));
+    let res;
     try {
-        payload = JSON.parse(Buffer.from(paymentHeader, "base64").toString("utf8"));
-    }
-    catch {
-        throw new errors_js_1.PaymentError("Invalid payment header format");
-    }
-    // Verify amount is sufficient
-    if (BigInt(payload.value) < rawAmount) {
-        throw new errors_js_1.PaymentError(`Insufficient payment: got ${payload.value} raw units, need ${rawAmount}`);
-    }
-    // Verify deadline
-    const now = Math.floor(Date.now() / 1000);
-    if (now < Number(payload.validAfter)) {
-        throw new errors_js_1.PaymentError("Payment not yet valid");
-    }
-    if (now > Number(payload.validBefore)) {
-        throw new errors_js_1.PaymentError("Payment authorization expired");
-    }
-    // Recover signer from EIP-712 signature
-    try {
-        const recovered = ethers_1.ethers.verifyTypedData(DOMAIN, EIP_3009_TYPES, {
-            from: payload.from,
-            to: payload.to,
-            value: payload.value,
-            validAfter: payload.validAfter,
-            validBefore: payload.validBefore,
-            nonce: payload.nonce,
-        }, payload.signature);
-        if (recovered.toLowerCase() !== payload.from.toLowerCase()) {
-            throw new errors_js_1.PaymentError("Signature does not match payer address");
-        }
+        res = await fetch(`${facilitatorUrl}/verify`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-Facilitator-Secret": secret,
+            },
+            body: JSON.stringify({
+                payment: paymentHeader,
+                resource,
+                amount: rawAmount,
+                network: resolvedNetwork,
+            }),
+        });
     }
     catch (err) {
-        if (err instanceof errors_js_1.PaymentError)
-            throw err;
         const message = err instanceof Error ? err.message : String(err);
-        throw new errors_js_1.PaymentError(`Signature verification failed: ${message}`);
+        throw new errors_js_1.PaymentError(`Facilitator unreachable at ${facilitatorUrl}: ${message}`);
+    }
+    if (res.status === 401) {
+        throw new errors_js_1.PaymentError("Facilitator rejected the request — check FACILITATOR_SECRET");
+    }
+    if (!res.ok) {
+        throw new errors_js_1.PaymentError(`Facilitator returned HTTP ${res.status}`);
     }
-    // Optionally verify on-chain that the USDC balance exists
-    if (process.env.VERIFY_ONCHAIN === "true") {
-        try {
-            const provider = new ethers_1.ethers.JsonRpcProvider(ARBITRUM_RPC);
-            const usdc = new ethers_1.ethers.Contract(USDC_ADDRESS, ["function balanceOf(address) view returns (uint256)"], provider);
-            const balance = await usdc.balanceOf(payload.from);
-            if (balance < rawAmount) {
-                throw new errors_js_1.PaymentError("Payer has insufficient USDC balance on-chain");
-            }
-        }
-        catch (err) {
-            if (err instanceof errors_js_1.PaymentError)
-                throw err;
-            // RPC errors are non-fatal — trust the signature
-        }
+    const result = await res.json();
+    if (!result.isValid) {
+        throw new errors_js_1.PaymentError(result.invalidReason || "Payment invalid");
     }
 }
 //# sourceMappingURL=verify.js.map

package/dist/verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify.js","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":";;AAIA,sCAyDC;AA7DD,2CAA2C;AAE3C,MAAM,oBAAoB,GAAG,qCAAqC,CAAC;AAE5D,KAAK,UAAU,aAAa,CACjC,aAAqB,EACrB,QAAqB,EACrB,UAAqB,EACrB,OAAqB;IAErB,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,oBAAoB,CAAC;IAEhF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,wBAAY,CACpB,iCAAiC;YACjC,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,OAAO;WAC1B,OAAO,CAAC,GAAG,CAAC,YAAY;WACxB,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;YACrC,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,eAAe,CAAC,CAAC;IAEzB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,OAAS,CAAC,CAAC,CAAC;IAEzE,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,SAAS,EAAE;YAC5C,MAAM,EAAG,MAAM;YACf,OAAO,EAAE;gBACP,cAAc,EAAU,kBAAkB;gBAC1C,sBAAsB,EAAE,MAAM;aAC/B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAG,aAAa;gBACvB,QAAQ;gBACR,MAAM,EAAI,SAAS;gBACnB,OAAO,EAAG,eAAe;aAC1B,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,wBAAY,CAAC,8BAA8B,cAAc,KAAK,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,wBAAY,CAAC,6DAA6D,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,wBAAY,CAAC,6BAA6B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAkD,CAAC;IAEhF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,wBAAY,CAAC,MAAM,CAAC,aAAa,IAAI,iBAAiB,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usemilkyway/agent-sdk",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Build and monetize AI agents on MilkyWay",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,7 +16,6 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@coinbase/x402": "^0.4.0",
     "express": "^4.18.0",
     "ethers": "^6.0.0",
     "zod": "^3.22.0"