@usemilkyway/agent-sdk 0.1.3 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agent.d.ts.map +1 -1
- package/dist/agent.js +51 -21
- package/dist/agent.js.map +1 -1
- package/dist/idempotency.d.ts +4 -0
- package/dist/idempotency.d.ts.map +1 -0
- package/dist/idempotency.js +33 -0
- package/dist/idempotency.js.map +1 -0
- package/dist/index.d.ts +3 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -1
- package/dist/index.js.map +1 -1
- package/dist/logger.d.ts +14 -0
- package/dist/logger.d.ts.map +1 -0
- package/dist/logger.js +86 -0
- package/dist/logger.js.map +1 -0
- package/dist/router.d.ts.map +1 -1
- package/dist/router.js +92 -32
- package/dist/router.js.map +1 -1
- package/dist/timeout.d.ts +2 -0
- package/dist/timeout.d.ts.map +1 -0
- package/dist/timeout.js +18 -0
- package/dist/timeout.js.map +1 -0
- package/dist/types.d.ts +9 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/validator.d.ts +2 -0
- package/dist/validator.d.ts.map +1 -1
- package/dist/validator.js +76 -13
- package/dist/validator.js.map +1 -1
- package/package.json +1 -1
package/dist/agent.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,
|
|
1
|
+
{"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
CHANGED
|
@@ -7,52 +7,82 @@ exports.createAgent = createAgent;
|
|
|
7
7
|
const express_1 = __importDefault(require("express"));
|
|
8
8
|
const x402_1 = require("./x402");
|
|
9
9
|
const router_1 = require("./router");
|
|
10
|
+
const logger_1 = require("./logger");
|
|
10
11
|
function createAgent(config, handlers, options = {}) {
|
|
11
12
|
const app = (0, express_1.default)();
|
|
12
13
|
app.use(express_1.default.json());
|
|
13
14
|
const devMode = options.devMode ?? process.env.MILKYWAY_DEV_MODE === "true";
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
15
|
+
// ── In-flight request tracking (for graceful shutdown) ─────────────────────
|
|
16
|
+
let inFlightCount = 0;
|
|
17
|
+
let isShuttingDown = false;
|
|
18
|
+
app.use((_req, res, next) => {
|
|
19
|
+
if (isShuttingDown) {
|
|
20
|
+
res.setHeader("Connection", "close");
|
|
21
|
+
return res.status(503).json({ error: "Server is shutting down — please retry" });
|
|
22
|
+
}
|
|
23
|
+
inFlightCount++;
|
|
24
|
+
let decremented = false;
|
|
25
|
+
const decrement = () => { if (!decremented) {
|
|
26
|
+
decremented = true;
|
|
27
|
+
inFlightCount--;
|
|
28
|
+
} };
|
|
29
|
+
res.on("finish", decrement);
|
|
30
|
+
res.on("close", decrement);
|
|
31
|
+
next();
|
|
21
32
|
});
|
|
22
|
-
|
|
33
|
+
// ── Standard endpoints ─────────────────────────────────────────────────────
|
|
34
|
+
app.get("/health", (_req, res) => {
|
|
35
|
+
res.json({ name: config.name, version: "1.0.0", status: "ok", ...(devMode && { devMode: true }) });
|
|
36
|
+
});
|
|
37
|
+
app.get("/about", (_req, res) => {
|
|
23
38
|
const about = {
|
|
24
39
|
milkyway_version: "1.0",
|
|
25
40
|
name: config.name,
|
|
26
41
|
description: config.description,
|
|
27
42
|
wallet: config.wallet,
|
|
28
43
|
max_deadline_seconds: config.max_deadline_seconds || 30,
|
|
29
|
-
capabilities: config.capabilities
|
|
44
|
+
capabilities: config.capabilities,
|
|
30
45
|
};
|
|
31
46
|
res.json(about);
|
|
32
47
|
});
|
|
33
48
|
app.post("/execute", async (req, res) => {
|
|
34
|
-
const capabilityName = req.body?.task?.capability ||
|
|
35
|
-
Object.keys(config.capabilities)[0];
|
|
49
|
+
const capabilityName = req.body?.task?.capability || Object.keys(config.capabilities)[0];
|
|
36
50
|
const capability = config.capabilities[capabilityName];
|
|
37
51
|
if (!capability) {
|
|
38
52
|
return (0, router_1.buildExecuteHandler)(config, handlers)(req, res);
|
|
39
53
|
}
|
|
40
54
|
(0, x402_1.requirePayment)(config.wallet, capability.pricing, devMode)(req, res, () => (0, router_1.buildExecuteHandler)(config, handlers)(req, res));
|
|
41
55
|
});
|
|
56
|
+
// ── Graceful shutdown ──────────────────────────────────────────────────────
|
|
57
|
+
function setupGracefulShutdown(server) {
|
|
58
|
+
const DRAIN_TIMEOUT_MS = 30000;
|
|
59
|
+
async function shutdown(signal) {
|
|
60
|
+
console.log(`\n[${config.name}] ${signal} received — shutting down gracefully`);
|
|
61
|
+
isShuttingDown = true;
|
|
62
|
+
server.close();
|
|
63
|
+
const start = Date.now();
|
|
64
|
+
while (inFlightCount > 0) {
|
|
65
|
+
if (Date.now() - start > DRAIN_TIMEOUT_MS) {
|
|
66
|
+
console.warn(`[${config.name}] Drain timeout — ${inFlightCount} request(s) still in flight. Forcing exit.`);
|
|
67
|
+
break;
|
|
68
|
+
}
|
|
69
|
+
console.log(`[${config.name}] Draining — ${inFlightCount} request(s) in flight...`);
|
|
70
|
+
await new Promise((r) => setTimeout(r, 500));
|
|
71
|
+
}
|
|
72
|
+
console.log(`[${config.name}] Shutdown complete`);
|
|
73
|
+
process.exit(0);
|
|
74
|
+
}
|
|
75
|
+
process.on("SIGTERM", () => shutdown("SIGTERM"));
|
|
76
|
+
process.on("SIGINT", () => shutdown("SIGINT"));
|
|
77
|
+
}
|
|
42
78
|
return {
|
|
43
79
|
app,
|
|
44
80
|
listen: (port, callback) => {
|
|
45
|
-
app.listen(port, callback || (() => {
|
|
46
|
-
|
|
47
|
-
if (devMode) {
|
|
48
|
-
console.log("✓ Dev mode: payment verification bypassed");
|
|
49
|
-
}
|
|
50
|
-
console.log("\nEndpoints:");
|
|
51
|
-
console.log(` GET http://localhost:${port}/health`);
|
|
52
|
-
console.log(` GET http://localhost:${port}/about`);
|
|
53
|
-
console.log(` POST http://localhost:${port}/execute\n`);
|
|
81
|
+
const server = app.listen(port, callback || (() => {
|
|
82
|
+
(0, logger_1.logStartup)(config.name, port, Object.keys(config.capabilities));
|
|
54
83
|
}));
|
|
55
|
-
|
|
84
|
+
setupGracefulShutdown(server);
|
|
85
|
+
},
|
|
56
86
|
};
|
|
57
87
|
}
|
|
58
88
|
//# sourceMappingURL=agent.js.map
|
package/dist/agent.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.getCachedResult = getCachedResult;
|
|
4
|
+
exports.cacheResult = cacheResult;
|
|
5
|
+
exports.clearCache = clearCache;
|
|
6
|
+
const cache = new Map();
|
|
7
|
+
const TTL_MS = 10 * 60 * 1000;
|
|
8
|
+
function getCachedResult(jobId) {
|
|
9
|
+
const entry = cache.get(jobId);
|
|
10
|
+
if (!entry)
|
|
11
|
+
return null;
|
|
12
|
+
if (Date.now() - entry.cachedAt > TTL_MS) {
|
|
13
|
+
cache.delete(jobId);
|
|
14
|
+
return null;
|
|
15
|
+
}
|
|
16
|
+
return entry.response;
|
|
17
|
+
}
|
|
18
|
+
function cacheResult(jobId, response) {
|
|
19
|
+
cache.set(jobId, { response, cachedAt: Date.now() });
|
|
20
|
+
if (cache.size > 10000)
|
|
21
|
+
pruneCache();
|
|
22
|
+
}
|
|
23
|
+
function pruneCache() {
|
|
24
|
+
const now = Date.now();
|
|
25
|
+
for (const [key, entry] of cache.entries()) {
|
|
26
|
+
if (now - entry.cachedAt > TTL_MS)
|
|
27
|
+
cache.delete(key);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
function clearCache() {
|
|
31
|
+
cache.clear();
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=idempotency.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
export { createAgent } from "./agent";
|
|
2
2
|
export { requirePayment } from "./x402";
|
|
3
3
|
export { verifyPayment } from "./verify";
|
|
4
|
-
export { validateInput } from "./validator";
|
|
5
|
-
export {
|
|
4
|
+
export { coerceInput, validateInput, validateOutput } from "./validator";
|
|
5
|
+
export { clearCache } from "./idempotency";
|
|
6
|
+
export { MilkyWayError, ValidationError, PaymentError, DeadlineError, CapabilityError, InternalError, } from "./errors";
|
|
6
7
|
export * from "./types";
|
|
7
8
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,
|
|
1
|
+
{"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
CHANGED
|
@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
14
14
|
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
15
|
};
|
|
16
16
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
-
exports.InternalError = exports.CapabilityError = exports.DeadlineError = exports.PaymentError = exports.ValidationError = exports.MilkyWayError = exports.validateInput = exports.verifyPayment = exports.requirePayment = exports.createAgent = void 0;
|
|
17
|
+
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;
|
|
18
18
|
var agent_1 = require("./agent");
|
|
19
19
|
Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return agent_1.createAgent; } });
|
|
20
20
|
var x402_1 = require("./x402");
|
|
@@ -22,7 +22,11 @@ Object.defineProperty(exports, "requirePayment", { enumerable: true, get: functi
|
|
|
22
22
|
var verify_1 = require("./verify");
|
|
23
23
|
Object.defineProperty(exports, "verifyPayment", { enumerable: true, get: function () { return verify_1.verifyPayment; } });
|
|
24
24
|
var validator_1 = require("./validator");
|
|
25
|
+
Object.defineProperty(exports, "coerceInput", { enumerable: true, get: function () { return validator_1.coerceInput; } });
|
|
25
26
|
Object.defineProperty(exports, "validateInput", { enumerable: true, get: function () { return validator_1.validateInput; } });
|
|
27
|
+
Object.defineProperty(exports, "validateOutput", { enumerable: true, get: function () { return validator_1.validateOutput; } });
|
|
28
|
+
var idempotency_1 = require("./idempotency");
|
|
29
|
+
Object.defineProperty(exports, "clearCache", { enumerable: true, get: function () { return idempotency_1.clearCache; } });
|
|
26
30
|
var errors_1 = require("./errors");
|
|
27
31
|
Object.defineProperty(exports, "MilkyWayError", { enumerable: true, get: function () { return errors_1.MilkyWayError; } });
|
|
28
32
|
Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,
|
|
1
|
+
{"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
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
interface RequestLog {
|
|
2
|
+
timestamp: string;
|
|
3
|
+
jobId: string;
|
|
4
|
+
capability: string;
|
|
5
|
+
payment: "verified" | "bypassed" | "rejected" | "free";
|
|
6
|
+
status: "completed" | "failed" | "expired" | "cached";
|
|
7
|
+
durationMs: number;
|
|
8
|
+
error?: string;
|
|
9
|
+
}
|
|
10
|
+
export declare function logRequest(log: RequestLog): void;
|
|
11
|
+
export declare function logStartup(name: string, port: number, capabilities: string[]): void;
|
|
12
|
+
export declare function logError(context: string, err: Error): void;
|
|
13
|
+
export {};
|
|
14
|
+
//# sourceMappingURL=logger.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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
ADDED
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.logRequest = logRequest;
|
|
4
|
+
exports.logStartup = logStartup;
|
|
5
|
+
exports.logError = logError;
|
|
6
|
+
const isDev = process.env.NODE_ENV !== "production";
|
|
7
|
+
const isDevMode = process.env.MILKYWAY_DEV_MODE === "true";
|
|
8
|
+
const C = {
|
|
9
|
+
reset: "\x1b[0m",
|
|
10
|
+
green: "\x1b[32m",
|
|
11
|
+
yellow: "\x1b[33m",
|
|
12
|
+
red: "\x1b[31m",
|
|
13
|
+
blue: "\x1b[34m",
|
|
14
|
+
grey: "\x1b[90m",
|
|
15
|
+
bold: "\x1b[1m",
|
|
16
|
+
};
|
|
17
|
+
function col(colour, text) {
|
|
18
|
+
if (!isDev)
|
|
19
|
+
return text;
|
|
20
|
+
return `${C[colour]}${text}${C.reset}`;
|
|
21
|
+
}
|
|
22
|
+
function logRequest(log) {
|
|
23
|
+
if (process.env.MILKYWAY_SILENT === "true")
|
|
24
|
+
return;
|
|
25
|
+
if (isDev) {
|
|
26
|
+
const statusIcon = {
|
|
27
|
+
completed: col("green", "✓"),
|
|
28
|
+
failed: col("red", "✗"),
|
|
29
|
+
expired: col("yellow", "⏱"),
|
|
30
|
+
cached: col("blue", "⚡"),
|
|
31
|
+
}[log.status];
|
|
32
|
+
const paymentLabel = {
|
|
33
|
+
verified: col("green", "paid"),
|
|
34
|
+
bypassed: col("yellow", "dev"),
|
|
35
|
+
rejected: col("red", "rejected"),
|
|
36
|
+
free: col("grey", "free"),
|
|
37
|
+
}[log.payment];
|
|
38
|
+
const duration = log.durationMs < 1000
|
|
39
|
+
? `${log.durationMs}ms`
|
|
40
|
+
: `${(log.durationMs / 1000).toFixed(1)}s`;
|
|
41
|
+
let line = col("grey", log.timestamp.split("T")[1].split(".")[0]) + " " +
|
|
42
|
+
statusIcon + " " +
|
|
43
|
+
col("bold", log.capability.padEnd(20)) +
|
|
44
|
+
paymentLabel.padEnd(12) +
|
|
45
|
+
col("grey", duration.padEnd(10)) +
|
|
46
|
+
col("grey", log.jobId.slice(0, 8) + "...");
|
|
47
|
+
if (log.error)
|
|
48
|
+
line += "\n " + col("red", `└ ${log.error}`);
|
|
49
|
+
console.log(line);
|
|
50
|
+
}
|
|
51
|
+
else {
|
|
52
|
+
console.log(JSON.stringify({
|
|
53
|
+
level: log.status === "failed" || log.status === "expired" ? "error" : "info",
|
|
54
|
+
...log,
|
|
55
|
+
}));
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
function logStartup(name, port, capabilities) {
|
|
59
|
+
if (process.env.MILKYWAY_SILENT === "true")
|
|
60
|
+
return;
|
|
61
|
+
if (isDev) {
|
|
62
|
+
console.log(col("bold", `\n✦ ${name}`));
|
|
63
|
+
console.log(` Port: ${col("blue", String(port))}`);
|
|
64
|
+
console.log(` Capabilities: ${capabilities.map((cap) => col("blue", cap)).join(", ")}`);
|
|
65
|
+
console.log(` Payment: ${isDevMode
|
|
66
|
+
? col("yellow", "DEV MODE — bypassed")
|
|
67
|
+
: col("green", "enabled (x402)")}`);
|
|
68
|
+
console.log();
|
|
69
|
+
console.log(col("grey", "time status capability payment duration job"));
|
|
70
|
+
console.log(col("grey", "─".repeat(72)));
|
|
71
|
+
}
|
|
72
|
+
else {
|
|
73
|
+
console.log(JSON.stringify({ level: "info", event: "startup", name, port, capabilities }));
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
function logError(context, err) {
|
|
77
|
+
if (process.env.MILKYWAY_SILENT === "true")
|
|
78
|
+
return;
|
|
79
|
+
if (isDev) {
|
|
80
|
+
console.error(col("red", `[error] ${context}: ${err.message}`));
|
|
81
|
+
}
|
|
82
|
+
else {
|
|
83
|
+
console.error(JSON.stringify({ level: "error", context, error: err.message, stack: err.stack }));
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
//# sourceMappingURL=logger.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}
|
package/dist/router.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,
|
|
1
|
+
{"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
CHANGED
|
@@ -2,84 +2,144 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.buildExecuteHandler = buildExecuteHandler;
|
|
4
4
|
const validator_1 = require("./validator");
|
|
5
|
+
const idempotency_1 = require("./idempotency");
|
|
6
|
+
const timeout_1 = require("./timeout");
|
|
7
|
+
const logger_1 = require("./logger");
|
|
5
8
|
const errors_1 = require("./errors");
|
|
6
9
|
function buildExecuteHandler(config, handlers) {
|
|
7
10
|
return async (req, res) => {
|
|
8
11
|
const body = req.body;
|
|
12
|
+
const jobId = body.job_id;
|
|
13
|
+
const requestStart = Date.now();
|
|
14
|
+
const devMode = process.env.MILKYWAY_DEV_MODE === "true";
|
|
9
15
|
if (body.milkyway_version !== "1.0") {
|
|
10
|
-
return res.status(400).json({
|
|
11
|
-
error: `Unsupported protocol version: ${body.milkyway_version}`
|
|
12
|
-
});
|
|
16
|
+
return res.status(400).json({ error: `Unsupported protocol version: ${body.milkyway_version}` });
|
|
13
17
|
}
|
|
14
18
|
const now = Math.floor(Date.now() / 1000);
|
|
15
19
|
if (body.deadline && now > body.deadline) {
|
|
16
20
|
return res.status(408).json({
|
|
17
21
|
milkyway_version: "1.0",
|
|
18
|
-
job_id:
|
|
22
|
+
job_id: jobId,
|
|
19
23
|
status: "expired",
|
|
20
24
|
error: "Deadline has passed",
|
|
21
|
-
error_type: "deadline"
|
|
25
|
+
error_type: "deadline",
|
|
22
26
|
});
|
|
23
27
|
}
|
|
28
|
+
// Resolve capability and handler
|
|
29
|
+
const capabilityNames = Object.keys(config.capabilities);
|
|
30
|
+
let capabilityName;
|
|
31
|
+
let handler;
|
|
24
32
|
try {
|
|
25
|
-
const capabilityNames = Object.keys(config.capabilities);
|
|
26
|
-
let capabilityName;
|
|
27
|
-
let handler;
|
|
28
33
|
if (typeof handlers === "function") {
|
|
29
|
-
if (capabilityNames.length > 1)
|
|
34
|
+
if (capabilityNames.length > 1)
|
|
30
35
|
throw new errors_1.CapabilityError("multiple capabilities require named handlers", capabilityNames);
|
|
31
|
-
}
|
|
32
36
|
capabilityName = capabilityNames[0];
|
|
33
37
|
handler = handlers;
|
|
34
38
|
}
|
|
35
39
|
else {
|
|
36
40
|
capabilityName = body.task?.capability || capabilityNames[0];
|
|
37
|
-
if (!handlers[capabilityName])
|
|
41
|
+
if (!handlers[capabilityName])
|
|
38
42
|
throw new errors_1.CapabilityError(capabilityName, Object.keys(handlers));
|
|
39
|
-
}
|
|
40
43
|
handler = handlers[capabilityName];
|
|
41
44
|
}
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
+
}
|
|
46
|
+
catch (err) {
|
|
47
|
+
const e = err;
|
|
48
|
+
return res.status(e.statusCode ?? 400).json({
|
|
49
|
+
milkyway_version: "1.0",
|
|
50
|
+
job_id: jobId,
|
|
51
|
+
status: "failed",
|
|
52
|
+
error: e.message,
|
|
53
|
+
error_type: e.type ?? "capability",
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
const capabilityDef = config.capabilities[capabilityName];
|
|
57
|
+
// Determine payment status for logging
|
|
58
|
+
const paymentStatus = capabilityDef.pricing.model === "free" || capabilityDef.pricing.amount === "0"
|
|
59
|
+
? "free"
|
|
60
|
+
: devMode
|
|
61
|
+
? "bypassed"
|
|
62
|
+
: "verified";
|
|
63
|
+
// Idempotency check
|
|
64
|
+
if (jobId) {
|
|
65
|
+
const cached = (0, idempotency_1.getCachedResult)(jobId);
|
|
66
|
+
if (cached) {
|
|
67
|
+
(0, logger_1.logRequest)({
|
|
68
|
+
timestamp: new Date().toISOString(),
|
|
69
|
+
jobId,
|
|
70
|
+
capability: capabilityName,
|
|
71
|
+
payment: paymentStatus,
|
|
72
|
+
status: "cached",
|
|
73
|
+
durationMs: Date.now() - requestStart,
|
|
74
|
+
});
|
|
75
|
+
return res.json(cached);
|
|
45
76
|
}
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
77
|
+
}
|
|
78
|
+
try {
|
|
79
|
+
// Coerce → validate input
|
|
80
|
+
const coercedInput = (0, validator_1.coerceInput)(body.task?.input || {}, capabilityDef.input_schema);
|
|
81
|
+
const validatedInput = (0, validator_1.validateInput)(coercedInput, capabilityDef.input_schema);
|
|
82
|
+
// Run handler with deadline timeout
|
|
83
|
+
const rawOutput = await (0, timeout_1.withTimeout)(handler(validatedInput), body.deadline);
|
|
84
|
+
// Validate output
|
|
85
|
+
const output = (0, validator_1.validateOutput)(rawOutput, capabilityDef.output_schema, devMode ? "warn" : "strict");
|
|
86
|
+
const response = {
|
|
49
87
|
milkyway_version: "1.0",
|
|
50
|
-
job_id:
|
|
88
|
+
job_id: jobId,
|
|
51
89
|
status: "completed",
|
|
52
90
|
output,
|
|
53
|
-
completed_at: Math.floor(Date.now() / 1000)
|
|
91
|
+
completed_at: Math.floor(Date.now() / 1000),
|
|
92
|
+
};
|
|
93
|
+
if (jobId)
|
|
94
|
+
(0, idempotency_1.cacheResult)(jobId, response);
|
|
95
|
+
(0, logger_1.logRequest)({
|
|
96
|
+
timestamp: new Date().toISOString(),
|
|
97
|
+
jobId: jobId || "—",
|
|
98
|
+
capability: capabilityName,
|
|
99
|
+
payment: paymentStatus,
|
|
100
|
+
status: "completed",
|
|
101
|
+
durationMs: Date.now() - requestStart,
|
|
54
102
|
});
|
|
103
|
+
res.json(response);
|
|
55
104
|
}
|
|
56
105
|
catch (err) {
|
|
57
|
-
|
|
106
|
+
const isDeadline = err instanceof errors_1.DeadlineError;
|
|
107
|
+
const isMilkyWay = err instanceof errors_1.MilkyWayError;
|
|
108
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
109
|
+
const status = isDeadline ? "expired" : "failed";
|
|
110
|
+
(0, logger_1.logRequest)({
|
|
111
|
+
timestamp: new Date().toISOString(),
|
|
112
|
+
jobId: jobId || "—",
|
|
113
|
+
capability: capabilityName,
|
|
114
|
+
payment: paymentStatus,
|
|
115
|
+
status,
|
|
116
|
+
durationMs: Date.now() - requestStart,
|
|
117
|
+
error: message,
|
|
118
|
+
});
|
|
119
|
+
if (isDeadline) {
|
|
58
120
|
return res.status(408).json({
|
|
59
121
|
milkyway_version: "1.0",
|
|
60
|
-
job_id:
|
|
122
|
+
job_id: jobId,
|
|
61
123
|
status: "expired",
|
|
62
|
-
error:
|
|
63
|
-
error_type:
|
|
124
|
+
error: message,
|
|
125
|
+
error_type: "deadline",
|
|
64
126
|
});
|
|
65
127
|
}
|
|
66
|
-
if (
|
|
128
|
+
if (isMilkyWay) {
|
|
67
129
|
return res.status(err.statusCode).json({
|
|
68
130
|
milkyway_version: "1.0",
|
|
69
|
-
job_id:
|
|
131
|
+
job_id: jobId,
|
|
70
132
|
status: "failed",
|
|
71
|
-
error:
|
|
72
|
-
error_type: err.type
|
|
133
|
+
error: message,
|
|
134
|
+
error_type: err.type,
|
|
73
135
|
});
|
|
74
136
|
}
|
|
75
|
-
console.error("Agent handler error:", err);
|
|
76
|
-
const message = err instanceof Error ? err.message : String(err);
|
|
77
137
|
res.status(500).json({
|
|
78
138
|
milkyway_version: "1.0",
|
|
79
|
-
job_id:
|
|
139
|
+
job_id: jobId,
|
|
80
140
|
status: "failed",
|
|
81
141
|
error: message,
|
|
82
|
-
error_type: "internal"
|
|
142
|
+
error_type: "internal",
|
|
83
143
|
});
|
|
84
144
|
}
|
|
85
145
|
};
|
package/dist/router.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
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
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.withTimeout = withTimeout;
|
|
4
|
+
const errors_1 = require("./errors");
|
|
5
|
+
function withTimeout(promise, deadlineEpoch // unix seconds
|
|
6
|
+
) {
|
|
7
|
+
const msRemaining = (deadlineEpoch * 1000) - Date.now() - 1000;
|
|
8
|
+
if (msRemaining <= 0) {
|
|
9
|
+
return Promise.reject(new errors_1.DeadlineError());
|
|
10
|
+
}
|
|
11
|
+
// Cap at 24 days — setTimeout overflows 32-bit int beyond that
|
|
12
|
+
const safeMs = Math.min(msRemaining, 2147483647);
|
|
13
|
+
return Promise.race([
|
|
14
|
+
promise,
|
|
15
|
+
new Promise((_, reject) => setTimeout(() => reject(new errors_1.DeadlineError()), safeMs)),
|
|
16
|
+
]);
|
|
17
|
+
}
|
|
18
|
+
//# sourceMappingURL=timeout.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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
CHANGED
|
@@ -18,8 +18,17 @@ export interface AgentPricing {
|
|
|
18
18
|
amount: string;
|
|
19
19
|
currency: "USDC";
|
|
20
20
|
}
|
|
21
|
+
export type PermissionType = "READ_WALLET_BALANCE" | "ACCESS_EXTERNAL_APIS" | "EXECUTE_TRANSACTIONS" | "MANAGE_AGENTS";
|
|
22
|
+
export interface PermissionDeclaration {
|
|
23
|
+
type: PermissionType;
|
|
24
|
+
reason: string;
|
|
25
|
+
token?: string;
|
|
26
|
+
max_per_transaction?: string;
|
|
27
|
+
max_lifetime?: string;
|
|
28
|
+
}
|
|
21
29
|
export interface CapabilityDef {
|
|
22
30
|
description: string;
|
|
31
|
+
permissions?: PermissionDeclaration[];
|
|
23
32
|
pricing: AgentPricing;
|
|
24
33
|
input_schema: AgentSchema;
|
|
25
34
|
output_schema: AgentSchema;
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +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"}
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/dist/validator.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
1
|
import { AgentSchema } from "./types";
|
|
2
|
+
export declare function coerceInput(input: Record<string, unknown>, schema: AgentSchema): Record<string, unknown>;
|
|
2
3
|
export declare function validateInput(input: Record<string, unknown>, schema: AgentSchema): Record<string, unknown>;
|
|
4
|
+
export declare function validateOutput(output: Record<string, unknown>, schema: AgentSchema, mode?: "warn" | "strict"): Record<string, unknown>;
|
|
3
5
|
//# sourceMappingURL=validator.d.ts.map
|
package/dist/validator.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAY,MAAM,SAAS,CAAC;
|
|
1
|
+
{"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
CHANGED
|
@@ -1,8 +1,55 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.coerceInput = coerceInput;
|
|
3
4
|
exports.validateInput = validateInput;
|
|
5
|
+
exports.validateOutput = validateOutput;
|
|
4
6
|
const zod_1 = require("zod");
|
|
5
7
|
const errors_1 = require("./errors");
|
|
8
|
+
// ── Input coercion ────────────────────────────────────────────────────────────
|
|
9
|
+
function coerceInput(input, schema) {
|
|
10
|
+
const coerced = { ...input };
|
|
11
|
+
for (const [field, def] of Object.entries(schema)) {
|
|
12
|
+
const value = coerced[field];
|
|
13
|
+
if (value === undefined || value === null)
|
|
14
|
+
continue;
|
|
15
|
+
const targetType = def.type;
|
|
16
|
+
const sourceType = Array.isArray(value) ? "array" : typeof value;
|
|
17
|
+
if (sourceType === targetType)
|
|
18
|
+
continue;
|
|
19
|
+
try {
|
|
20
|
+
coerced[field] = coerce(value, sourceType, targetType, field);
|
|
21
|
+
}
|
|
22
|
+
catch (err) {
|
|
23
|
+
throw new errors_1.ValidationError(err.message);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
return coerced;
|
|
27
|
+
}
|
|
28
|
+
function coerce(value, sourceType, targetType, field) {
|
|
29
|
+
if (sourceType === "string" && targetType === "number") {
|
|
30
|
+
const n = parseFloat(value);
|
|
31
|
+
if (isNaN(n))
|
|
32
|
+
throw new Error(`Field "${field}": cannot coerce "${value}" to number`);
|
|
33
|
+
return n;
|
|
34
|
+
}
|
|
35
|
+
if (sourceType === "string" && targetType === "boolean") {
|
|
36
|
+
if (value === "true" || value === "1")
|
|
37
|
+
return true;
|
|
38
|
+
if (value === "false" || value === "0")
|
|
39
|
+
return false;
|
|
40
|
+
throw new Error(`Field "${field}": cannot coerce "${value}" to boolean. Use "true", "false", "1", or "0"`);
|
|
41
|
+
}
|
|
42
|
+
if (sourceType === "number" && targetType === "string")
|
|
43
|
+
return String(value);
|
|
44
|
+
if (sourceType === "number" && targetType === "boolean")
|
|
45
|
+
return value !== 0;
|
|
46
|
+
if (sourceType === "boolean" && targetType === "string")
|
|
47
|
+
return String(value);
|
|
48
|
+
if (sourceType === "boolean" && targetType === "number")
|
|
49
|
+
return value ? 1 : 0;
|
|
50
|
+
throw new Error(`Field "${field}": cannot coerce ${sourceType} to ${targetType}`);
|
|
51
|
+
}
|
|
52
|
+
// ── Input validation ──────────────────────────────────────────────────────────
|
|
6
53
|
function buildZodType(def) {
|
|
7
54
|
switch (def.type) {
|
|
8
55
|
case "string": {
|
|
@@ -23,14 +70,10 @@ function buildZodType(def) {
|
|
|
23
70
|
t = t.max(def.max);
|
|
24
71
|
return t;
|
|
25
72
|
}
|
|
26
|
-
case "boolean":
|
|
27
|
-
|
|
28
|
-
case "
|
|
29
|
-
|
|
30
|
-
case "object":
|
|
31
|
-
return zod_1.z.record(zod_1.z.unknown());
|
|
32
|
-
default:
|
|
33
|
-
return zod_1.z.unknown();
|
|
73
|
+
case "boolean": return zod_1.z.boolean();
|
|
74
|
+
case "array": return zod_1.z.array(zod_1.z.unknown());
|
|
75
|
+
case "object": return zod_1.z.record(zod_1.z.unknown());
|
|
76
|
+
default: return zod_1.z.unknown();
|
|
34
77
|
}
|
|
35
78
|
}
|
|
36
79
|
function buildZodSchema(schema) {
|
|
@@ -48,14 +91,34 @@ function buildZodSchema(schema) {
|
|
|
48
91
|
return zod_1.z.object(shape);
|
|
49
92
|
}
|
|
50
93
|
function validateInput(input, schema) {
|
|
51
|
-
const
|
|
52
|
-
const result = zodSchema.safeParse(input);
|
|
94
|
+
const result = buildZodSchema(schema).safeParse(input);
|
|
53
95
|
if (!result.success) {
|
|
54
|
-
const issues = result.error.issues
|
|
55
|
-
.map(i => `${i.path.join(".")}: ${i.message}`)
|
|
56
|
-
.join(", ");
|
|
96
|
+
const issues = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ");
|
|
57
97
|
throw new errors_1.ValidationError(issues);
|
|
58
98
|
}
|
|
59
99
|
return result.data;
|
|
60
100
|
}
|
|
101
|
+
// ── Output validation ─────────────────────────────────────────────────────────
|
|
102
|
+
function validateOutput(output, schema, mode = "strict") {
|
|
103
|
+
const violations = [];
|
|
104
|
+
for (const [field, def] of Object.entries(schema)) {
|
|
105
|
+
const value = output[field];
|
|
106
|
+
if (value === undefined) {
|
|
107
|
+
violations.push(`output missing field: "${field}" (expected ${def.type})`);
|
|
108
|
+
continue;
|
|
109
|
+
}
|
|
110
|
+
const actualType = Array.isArray(value) ? "array" : typeof value;
|
|
111
|
+
if (actualType !== def.type) {
|
|
112
|
+
violations.push(`output field "${field}": expected ${def.type}, got ${actualType}`);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
if (violations.length === 0)
|
|
116
|
+
return output;
|
|
117
|
+
const message = `Output schema violation: ${violations.join("; ")}`;
|
|
118
|
+
if (mode === "warn") {
|
|
119
|
+
console.warn(`[MilkyWay SDK] ⚠️ ${message}`);
|
|
120
|
+
return output;
|
|
121
|
+
}
|
|
122
|
+
throw new errors_1.InternalError(message);
|
|
123
|
+
}
|
|
61
124
|
//# sourceMappingURL=validator.js.map
|
package/dist/validator.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"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"}
|