@usemilkyway/agent-sdk 0.1.0

package/dist/agent.d.ts

@@ -0,0 +1,12 @@
+import { Express } from "express";
+import { AgentConfig, Handlers } from "./types";
+interface CreateAgentOptions {
+    devMode?: boolean;
+}
+interface AgentInstance {
+    app: Express;
+    listen: (port: number, callback?: () => void) => void;
+}
+export declare function createAgent(config: AgentConfig, handlers: Handlers, options?: CreateAgentOptions): AgentInstance;
+export {};
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +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"}

package/dist/agent.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgent = createAgent;
+const express_1 = __importDefault(require("express"));
+const x402_1 = require("./x402");
+const router_1 = require("./router");
+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 })
+        });
+    });
+    app.get("/about", (_, 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
+        };
+        res.json(about);
+    });
+    app.post("/execute", async (req, res) => {
+        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));
+    });
+    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`);
+            }));
+        }
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+export declare class MilkyWayError extends Error {
+    readonly type: string;
+    readonly statusCode: number;
+    constructor(message: string, type: string, statusCode?: number);
+}
+export declare class ValidationError extends MilkyWayError {
+    constructor(message: string);
+}
+export declare class PaymentError extends MilkyWayError {
+    constructor(message: string);
+}
+export declare class DeadlineError extends MilkyWayError {
+    constructor();
+}
+export declare class CapabilityError extends MilkyWayError {
+    constructor(name: string, available: string[]);
+}
+export declare class InternalError extends MilkyWayError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY;CAK3C;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,aAAa;;CAK/C;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;CAQ9C;AAED,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalError = exports.CapabilityError = exports.DeadlineError = exports.PaymentError = exports.ValidationError = exports.MilkyWayError = void 0;
+class MilkyWayError extends Error {
+    constructor(message, type, statusCode = 400) {
+        super(message);
+        this.type = type;
+        this.statusCode = statusCode;
+        this.name = "MilkyWayError";
+    }
+}
+exports.MilkyWayError = MilkyWayError;
+class ValidationError extends MilkyWayError {
+    constructor(message) {
+        super(message, "validation", 400);
+        this.name = "ValidationError";
+    }
+}
+exports.ValidationError = ValidationError;
+class PaymentError extends MilkyWayError {
+    constructor(message) {
+        super(message, "payment", 402);
+        this.name = "PaymentError";
+    }
+}
+exports.PaymentError = PaymentError;
+class DeadlineError extends MilkyWayError {
+    constructor() {
+        super("Deadline has passed", "deadline", 408);
+        this.name = "DeadlineError";
+    }
+}
+exports.DeadlineError = DeadlineError;
+class CapabilityError extends MilkyWayError {
+    constructor(name, available) {
+        super(`Unknown capability: "${name}". Available: ${available.join(", ")}`, "capability", 400);
+        this.name = "CapabilityError";
+    }
+}
+exports.CapabilityError = CapabilityError;
+class InternalError extends MilkyWayError {
+    constructor(message) {
+        super(message, "internal", 500);
+        this.name = "InternalError";
+    }
+}
+exports.InternalError = InternalError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAc,SAAQ,KAAK;IACtC,YACE,OAAe,EACC,IAAY,EACZ,aAAqB,GAAG;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAc;QAGxC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AATD,sCASC;AAED,MAAa,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,YAAa,SAAQ,aAAa;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,MAAa,aAAc,SAAQ,aAAa;IAC9C;QACE,KAAK,CAAC,qBAAqB,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,MAAa,eAAgB,SAAQ,aAAa;IAChD,YAAY,IAAY,EAAE,SAAmB;QAC3C,KAAK,CACH,wBAAwB,IAAI,iBAAiB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACnE,YAAY,EACZ,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AATD,0CASC;AAED,MAAa,aAAc,SAAQ,aAAa;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+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 * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,34 @@
+"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 __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;
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return agent_1.createAgent; } });
+var x402_1 = require("./x402");
+Object.defineProperty(exports, "requirePayment", { enumerable: true, get: function () { return x402_1.requirePayment; } });
+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, "validateInput", { enumerable: true, get: function () { return validator_1.validateInput; } });
+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; } });
+Object.defineProperty(exports, "PaymentError", { enumerable: true, get: function () { return errors_1.PaymentError; } });
+Object.defineProperty(exports, "DeadlineError", { enumerable: true, get: function () { return errors_1.DeadlineError; } });
+Object.defineProperty(exports, "CapabilityError", { enumerable: true, get: function () { return errors_1.CapabilityError; } });
+Object.defineProperty(exports, "InternalError", { enumerable: true, get: function () { return errors_1.InternalError; } });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/router.d.ts

@@ -0,0 +1,4 @@
+import { Request, Response } from "express";
+import { AgentConfig, Handlers } from "./types";
+export declare function buildExecuteHandler(config: AgentConfig, handlers: Handlers): (req: Request, res: Response) => Promise<Response<any, Record<string, any>> | undefined>;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +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"}

package/dist/router.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExecuteHandler = buildExecuteHandler;
+const validator_1 = require("./validator");
+const errors_1 = require("./errors");
+function buildExecuteHandler(config, handlers) {
+    return async (req, res) => {
+        const body = req.body;
+        if (body.milkyway_version !== "1.0") {
+            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,
+                status: "expired",
+                error: "Deadline has passed",
+                error_type: "deadline"
+            });
+        }
+        try {
+            const capabilityNames = Object.keys(config.capabilities);
+            let capabilityName;
+            let handler;
+            if (typeof handlers === "function") {
+                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]) {
+                    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);
+            }
+            const validatedInput = (0, validator_1.validateInput)(body.task?.input || {}, capabilityDef.input_schema);
+            const output = await handler(validatedInput);
+            res.json({
+                milkyway_version: "1.0",
+                job_id: body.job_id,
+                status: "completed",
+                output,
+                completed_at: Math.floor(Date.now() / 1000)
+            });
+        }
+        catch (err) {
+            if (err instanceof errors_1.DeadlineError) {
+                return res.status(408).json({
+                    milkyway_version: "1.0",
+                    job_id: body.job_id,
+                    status: "expired",
+                    error: err.message,
+                    error_type: err.type
+                });
+            }
+            if (err instanceof errors_1.MilkyWayError) {
+                return res.status(err.statusCode).json({
+                    milkyway_version: "1.0",
+                    job_id: body.job_id,
+                    status: "failed",
+                    error: err.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,
+                status: "failed",
+                error: message,
+                error_type: "internal"
+            });
+        }
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export type FieldType = "string" | "number" | "boolean" | "array" | "object";
+export interface FieldDef {
+    type: FieldType;
+    required?: boolean;
+    description?: string;
+    default?: unknown;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    enum?: unknown[];
+}
+export interface AgentSchema {
+    [field: string]: FieldDef;
+}
+export interface AgentPricing {
+    model: "per_job" | "per_day" | "per_month" | "free";
+    amount: string;
+    currency: "USDC";
+}
+export interface CapabilityDef {
+    description: string;
+    pricing: AgentPricing;
+    input_schema: AgentSchema;
+    output_schema: AgentSchema;
+}
+export interface AgentConfig {
+    milkyway_version: string;
+    name: string;
+    description: string;
+    wallet: string;
+    max_deadline_seconds?: number;
+    capabilities: {
+        [capabilityName: string]: CapabilityDef;
+    };
+}
+export type MilkyWayAbout = AgentConfig;
+export interface ExecuteRequest {
+    milkyway_version: string;
+    job_id: string;
+    task: {
+        capability?: string;
+        input: Record<string, unknown>;
+    };
+    deadline: number;
+}
+export interface ExecuteResponse {
+    milkyway_version: string;
+    job_id: string;
+    status: "completed" | "failed" | "expired";
+    output?: Record<string, unknown>;
+    error?: string;
+    error_type?: "validation" | "payment" | "deadline" | "capability" | "internal";
+    completed_at?: number;
+}
+export type HandlerFn = (input: Record<string, unknown>) => Promise<Record<string, unknown>>;
+export type Handlers = HandlerFn | {
+    [capabilityName: string]: HandlerFn;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validator.d.ts

@@ -0,0 +1,3 @@
+import { AgentSchema } from "./types";
+export declare function validateInput(input: Record<string, unknown>, schema: AgentSchema): Record<string, unknown>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +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"}

package/dist/validator.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateInput = validateInput;
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+function buildZodType(def) {
+    switch (def.type) {
+        case "string": {
+            if (def.enum)
+                return zod_1.z.enum(def.enum);
+            let t = zod_1.z.string();
+            if (def.minLength !== undefined)
+                t = t.min(def.minLength);
+            if (def.maxLength !== undefined)
+                t = t.max(def.maxLength);
+            return t;
+        }
+        case "number": {
+            let t = zod_1.z.number();
+            if (def.min !== undefined)
+                t = t.min(def.min);
+            if (def.max !== undefined)
+                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();
+    }
+}
+function buildZodSchema(schema) {
+    const shape = {};
+    for (const [field, def] of Object.entries(schema)) {
+        let zodType = buildZodType(def);
+        if (!def.required) {
+            zodType = zodType.optional();
+            if (def.default !== undefined) {
+                zodType = zodType.default(def.default);
+            }
+        }
+        shape[field] = zodType;
+    }
+    return zod_1.z.object(shape);
+}
+function validateInput(input, schema) {
+    const zodSchema = buildZodSchema(schema);
+    const result = zodSchema.safeParse(input);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map(i => `${i.path.join(".")}: ${i.message}`)
+            .join(", ");
+        throw new errors_1.ValidationError(issues);
+    }
+    return result.data;
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/dist/verify.d.ts

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

package/dist/verify.d.ts.map

@@ -0,0 +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"}

package/dist/verify.js

@@ -0,0 +1,83 @@
+"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;
+    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");
+        }
+    }
+    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}`);
+    }
+    // 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
+        }
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/verify.js.map

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

package/dist/x402.d.ts

@@ -0,0 +1,4 @@
+import { Request, Response, NextFunction } from "express";
+import { AgentPricing } from "./types";
+export declare function requirePayment(walletAddress: string, pricing: AgentPricing, devMode?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void | Response<any, Record<string, any>>>;
+//# sourceMappingURL=x402.d.ts.map

package/dist/x402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,OAAe,IAEV,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,wDA0C9D"}

package/dist/x402.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requirePayment = requirePayment;
+const verify_1 = require("./verify");
+const USDC_ADDRESS = "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
+function requirePayment(walletAddress, pricing, devMode = false) {
+    return async (req, res, next) => {
+        if (pricing.model === "free" || pricing.amount === "0") {
+            return next();
+        }
+        if (devMode) {
+            console.log("[dev mode] payment verification bypassed");
+            return next();
+        }
+        const paymentHeader = req.headers["payment-signature"] ||
+            req.headers["x-payment"];
+        if (!paymentHeader) {
+            return res.status(402).json({
+                x402Version: 1,
+                accepts: [{
+                        scheme: "exact",
+                        network: "eip155:42161",
+                        maxAmountRequired: String(Math.round(parseFloat(pricing.amount) * 1000000)),
+                        payTo: walletAddress,
+                        asset: USDC_ADDRESS,
+                        description: `${pricing.amount} ${pricing.currency} per job`,
+                        maxTimeoutSeconds: 60,
+                        extra: { name: "USD Coin", version: "2" }
+                    }]
+            });
+        }
+        try {
+            const resource = `${req.protocol}://${req.get("host")}${req.path}`;
+            await (0, verify_1.verifyPayment)(paymentHeader, resource, pricing.amount);
+            next();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            res.status(402).json({
+                x402Version: 1,
+                error: message
+            });
+        }
+    };
+}
+//# sourceMappingURL=x402.js.map

package/dist/x402.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.js","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":";;AAMA,wCA+CC;AApDD,qCAAyC;AAGzC,MAAM,YAAY,GAAG,4CAA4C,CAAC;AAElE,SAAgB,cAAc,CAC5B,aAAqB,EACrB,OAAqB,EACrB,UAAmB,KAAK;IAExB,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QAC/D,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YACxD,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,aAAa,GAChB,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAY;YAC3C,GAAG,CAAC,OAAO,CAAC,WAAW,CAAY,CAAC;QAEvC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,WAAW,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC;wBACR,MAAM,EAAa,OAAO;wBAC1B,OAAO,EAAY,cAAc;wBACjC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,OAAS,CAAC,CAAC;wBAC7E,KAAK,EAAc,aAAa;wBAChC,KAAK,EAAc,YAAY;wBAC/B,WAAW,EAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,UAAU;wBAClE,iBAAiB,EAAE,EAAE;wBACrB,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;qBAC1C,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACnE,MAAM,IAAA,sBAAa,EAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7D,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,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,WAAW,EAAE,CAAC;gBACd,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@usemilkyway/agent-sdk",
+  "version": "0.1.0",
+  "description": "Build and monetize AI agents on MilkyWay",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@coinbase/x402": "^0.4.0",
+    "express": "^4.18.0",
+    "ethers": "^6.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/express": "^4.17.0",
+    "@types/node": "^20.0.0"
+  }
+}