openwire 0.0.0-stage → 1.2.1

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.
Files changed (81) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/LICENSE +21 -0
  3. package/README.md +277 -2
  4. package/ROADMAP.md +15 -0
  5. package/assets/brand/icon.svg +10 -0
  6. package/assets/brand/logo-dark.svg +10 -0
  7. package/assets/brand/logo.svg +10 -0
  8. package/assets/diagrams/architecture.svg +39 -0
  9. package/dist/config.d.ts +31 -0
  10. package/dist/config.js +97 -0
  11. package/dist/config.js.map +1 -0
  12. package/dist/errors.d.ts +17 -0
  13. package/dist/errors.js +22 -0
  14. package/dist/errors.js.map +1 -0
  15. package/dist/http/executor.d.ts +2 -0
  16. package/dist/http/executor.js +53 -0
  17. package/dist/http/executor.js.map +1 -0
  18. package/dist/http/index.d.ts +2 -0
  19. package/dist/http/index.js +3 -0
  20. package/dist/http/index.js.map +1 -0
  21. package/dist/http/request.d.ts +2 -0
  22. package/dist/http/request.js +75 -0
  23. package/dist/http/request.js.map +1 -0
  24. package/dist/index.d.ts +9 -0
  25. package/dist/index.js +111 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/loader/index.d.ts +2 -0
  28. package/dist/loader/index.js +2 -0
  29. package/dist/loader/index.js.map +1 -0
  30. package/dist/loader/specLoader.d.ts +17 -0
  31. package/dist/loader/specLoader.js +78 -0
  32. package/dist/loader/specLoader.js.map +1 -0
  33. package/dist/logger.d.ts +16 -0
  34. package/dist/logger.js +65 -0
  35. package/dist/logger.js.map +1 -0
  36. package/dist/metadata.d.ts +4 -0
  37. package/dist/metadata.js +4 -0
  38. package/dist/metadata.js.map +1 -0
  39. package/dist/parser/index.d.ts +1 -0
  40. package/dist/parser/index.js +2 -0
  41. package/dist/parser/index.js.map +1 -0
  42. package/dist/parser/parser.d.ts +12 -0
  43. package/dist/parser/parser.js +423 -0
  44. package/dist/parser/parser.js.map +1 -0
  45. package/dist/pipeline.d.ts +4 -0
  46. package/dist/pipeline.js +29 -0
  47. package/dist/pipeline.js.map +1 -0
  48. package/dist/sanitizer/index.d.ts +2 -0
  49. package/dist/sanitizer/index.js +2 -0
  50. package/dist/sanitizer/index.js.map +1 -0
  51. package/dist/sanitizer/sanitizer.d.ts +12 -0
  52. package/dist/sanitizer/sanitizer.js +88 -0
  53. package/dist/sanitizer/sanitizer.js.map +1 -0
  54. package/dist/schema/builder.d.ts +10 -0
  55. package/dist/schema/builder.js +36 -0
  56. package/dist/schema/builder.js.map +1 -0
  57. package/dist/schema/index.d.ts +2 -0
  58. package/dist/schema/index.js +3 -0
  59. package/dist/schema/index.js.map +1 -0
  60. package/dist/schema/normalize.d.ts +14 -0
  61. package/dist/schema/normalize.js +79 -0
  62. package/dist/schema/normalize.js.map +1 -0
  63. package/dist/server/handler.d.ts +11 -0
  64. package/dist/server/handler.js +56 -0
  65. package/dist/server/handler.js.map +1 -0
  66. package/dist/server/index.d.ts +4 -0
  67. package/dist/server/index.js +3 -0
  68. package/dist/server/index.js.map +1 -0
  69. package/dist/server/server.d.ts +7 -0
  70. package/dist/server/server.js +50 -0
  71. package/dist/server/server.js.map +1 -0
  72. package/dist/types.d.ts +87 -0
  73. package/dist/types.js +2 -0
  74. package/dist/types.js.map +1 -0
  75. package/dist/validator/index.d.ts +2 -0
  76. package/dist/validator/index.js +2 -0
  77. package/dist/validator/index.js.map +1 -0
  78. package/dist/validator/validator.d.ts +9 -0
  79. package/dist/validator/validator.js +46 -0
  80. package/dist/validator/validator.js.map +1 -0
  81. package/package.json +77 -4
package/dist/errors.js ADDED
@@ -0,0 +1,22 @@
1
+ export class BridgeError extends Error {
2
+ constructor(message, options) {
3
+ super(message, options);
4
+ this.name = new.target.name;
5
+ }
6
+ }
7
+ export class ConfigError extends BridgeError {
8
+ }
9
+ export class SpecLoadError extends BridgeError {
10
+ }
11
+ export class SpecParseError extends BridgeError {
12
+ }
13
+ export class ValidationError extends BridgeError {
14
+ details;
15
+ constructor(message, details) {
16
+ super(message);
17
+ this.details = details;
18
+ }
19
+ }
20
+ export class HttpExecutionError extends BridgeError {
21
+ }
22
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,WAAW;CAAG;AAE/C,MAAM,OAAO,aAAc,SAAQ,WAAW;CAAG;AAEjD,MAAM,OAAO,cAAe,SAAQ,WAAW;CAAG;AAElD,MAAM,OAAO,eAAgB,SAAQ,WAAW;IACrC,OAAO,CAAa;IAE7B,YAAY,OAAe,EAAE,OAAmB;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;CAAG"}
@@ -0,0 +1,2 @@
1
+ import type { HttpResult, ParsedOperation, RuntimeContext } from "../types.js";
2
+ export declare function executeOperation(runtime: RuntimeContext, operation: ParsedOperation, args: Record<string, unknown>): Promise<HttpResult>;
@@ -0,0 +1,53 @@
1
+ import { HttpExecutionError } from "../errors.js";
2
+ import { prepareRequest } from "./request.js";
3
+ export async function executeOperation(runtime, operation, args) {
4
+ const config = runtime.config;
5
+ const baseUrl = config.baseUrlOverride ?? operation.baseUrl;
6
+ if (!baseUrl) {
7
+ throw new HttpExecutionError(`No server URL available for operation "${operation.toolName}"`);
8
+ }
9
+ const request = prepareRequest(operation, args, baseUrl, config.timeoutMs);
10
+ if (config.headers) {
11
+ for (const [name, value] of Object.entries(config.headers)) {
12
+ request.headers[name.toLowerCase()] = value;
13
+ }
14
+ }
15
+ if (!config.allowInsecureHttp && new URL(request.url).protocol === "http:") {
16
+ throw new HttpExecutionError(`Refusing insecure HTTP request to "${request.url}"; set ALLOW_INSECURE_HTTP=true to allow plain http targets`);
17
+ }
18
+ const controller = new AbortController();
19
+ const timer = setTimeout(() => controller.abort(), request.timeoutMs);
20
+ try {
21
+ const init = {
22
+ method: request.method.toUpperCase(),
23
+ headers: request.headers,
24
+ signal: controller.signal,
25
+ };
26
+ if (request.body !== undefined) {
27
+ init.body = JSON.stringify(request.body);
28
+ }
29
+ const response = await runtime.fetchImpl(request.url, init);
30
+ const bodyText = await response.text();
31
+ return {
32
+ url: request.url,
33
+ method: request.method,
34
+ status: response.status,
35
+ statusText: response.statusText,
36
+ headers: Object.fromEntries(response.headers.entries()),
37
+ bodyText,
38
+ };
39
+ }
40
+ catch (err) {
41
+ if (err instanceof Error && err.name === "AbortError") {
42
+ throw new HttpExecutionError(`Request to ${request.url} timed out after ${request.timeoutMs}ms`);
43
+ }
44
+ const message = err instanceof Error ? err.message : String(err);
45
+ throw new HttpExecutionError(`HTTP request to ${request.url} failed: ${message}`, {
46
+ cause: err,
47
+ });
48
+ }
49
+ finally {
50
+ clearTimeout(timer);
51
+ }
52
+ }
53
+ //# sourceMappingURL=executor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/http/executor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export { prepareRequest } from "./request.js";
2
+ export { executeOperation } from "./executor.js";
@@ -0,0 +1,3 @@
1
+ export { prepareRequest } from "./request.js";
2
+ export { executeOperation } from "./executor.js";
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { HttpRequestContext, ParsedOperation } from "../types.js";
2
+ export declare function prepareRequest(operation: ParsedOperation, args: Record<string, unknown>, baseUrl: string, timeoutMs: number): HttpRequestContext;
@@ -0,0 +1,75 @@
1
+ import { ValidationError } from "../errors.js";
2
+ export function prepareRequest(operation, args, baseUrl, timeoutMs) {
3
+ const path = substitutePathParams(operation.path, operation, args);
4
+ const headers = { accept: "application/json" };
5
+ const query = [];
6
+ const cookies = [];
7
+ for (const parameter of operation.parameters) {
8
+ const value = args[parameter.name];
9
+ if (value === undefined || value === null) {
10
+ continue;
11
+ }
12
+ switch (parameter.in) {
13
+ case "query":
14
+ query.push([parameter.name, serializeValue(value)]);
15
+ break;
16
+ case "header":
17
+ headers[parameter.name.toLowerCase()] = serializeValue(value);
18
+ break;
19
+ case "cookie":
20
+ cookies.push(`${parameter.name}=${encodeURIComponent(serializeValue(value))}`);
21
+ break;
22
+ case "path":
23
+ break;
24
+ }
25
+ }
26
+ let body;
27
+ if (operation.requestBody) {
28
+ const value = args.body;
29
+ if (value !== undefined) {
30
+ if (!/^application\/(?:json|[^;]+\+json)(?:;|$)/i.test(operation.requestBody.contentType)) {
31
+ throw new ValidationError(`Unsupported request body content type "${operation.requestBody.contentType}": only JSON bodies are supported`);
32
+ }
33
+ body = value;
34
+ headers["content-type"] = operation.requestBody.contentType;
35
+ }
36
+ }
37
+ if (cookies.length > 0) {
38
+ headers.cookie = cookies.join("; ");
39
+ }
40
+ const url = buildUrl(baseUrl, path, query);
41
+ return { url, method: operation.method, headers, body, timeoutMs };
42
+ }
43
+ function buildUrl(baseUrl, path, query) {
44
+ const joined = baseUrl.replace(/\/+$/, "") + (path.startsWith("/") ? path : `/${path}`);
45
+ const url = new URL(joined);
46
+ for (const [key, value] of query) {
47
+ url.searchParams.append(key, value);
48
+ }
49
+ return url.toString();
50
+ }
51
+ function substitutePathParams(path, operation, args) {
52
+ return path.replace(/\{([^}]+)\}/g, (match, rawName) => {
53
+ const parameter = operation.parameters.find((parameter) => parameter.in === "path" && parameter.name === rawName);
54
+ const value = parameter ? args[parameter.name] : undefined;
55
+ if (value === undefined || value === null) {
56
+ return match;
57
+ }
58
+ return encodeURIComponent(serializeValue(value));
59
+ });
60
+ }
61
+ function serializeValue(value) {
62
+ if (typeof value === "string") {
63
+ return value;
64
+ }
65
+ if (typeof value === "number" || typeof value === "boolean") {
66
+ return String(value);
67
+ }
68
+ try {
69
+ return JSON.stringify(value);
70
+ }
71
+ catch {
72
+ return String(value);
73
+ }
74
+ }
75
+ //# sourceMappingURL=request.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/http/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,UAAU,cAAc,CAC5B,SAA0B,EAC1B,IAA6B,EAC7B,OAAe,EACf,SAAiB;IAEjB,MAAM,IAAI,GAAG,oBAAoB,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACnE,MAAM,OAAO,GAA2B,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACvE,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,QAAQ,SAAS,CAAC,EAAE,EAAE,CAAC;YACrB,KAAK,OAAO;gBACV,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACpD,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC9D,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,kBAAkB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/E,MAAM;YACR,KAAK,MAAM;gBACT,MAAM;QACV,CAAC;IACH,CAAC;IAED,IAAI,IAAa,CAAC;IAClB,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,4CAA4C,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1F,MAAM,IAAI,eAAe,CACvB,0CAA0C,SAAS,CAAC,WAAW,CAAC,WAAW,mCAAmC,CAC/G,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,KAAK,CAAC;YACb,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,IAAY,EAAE,KAAyB;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACxF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAY,EACZ,SAA0B,EAC1B,IAA6B;IAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAC7D,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CACzC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,CACrE,CAAC;QACF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,kBAAkB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
@@ -0,0 +1,9 @@
1
+ #!/usr/bin/env node
2
+ interface CliArgs {
3
+ source?: string;
4
+ headers?: string;
5
+ help: boolean;
6
+ }
7
+ export declare function parseCliArgs(argv: string[]): CliArgs;
8
+ export declare function main(): Promise<void>;
9
+ export {};
package/dist/index.js ADDED
@@ -0,0 +1,111 @@
1
+ #!/usr/bin/env node
2
+ import { realpathSync } from "node:fs";
3
+ import { pathToFileURL } from "node:url";
4
+ import { serveStdio } from "@modelcontextprotocol/server/stdio";
5
+ import { DEFAULT_CONFIG, loadConfig } from "./config.js";
6
+ import { Logger } from "./logger.js";
7
+ import { buildContext } from "./pipeline.js";
8
+ import { createMcpServer } from "./server/index.js";
9
+ export function parseCliArgs(argv) {
10
+ let source;
11
+ let headers;
12
+ let help = false;
13
+ for (let i = 0; i < argv.length; i += 1) {
14
+ const arg = argv[i];
15
+ if (arg === undefined) {
16
+ continue;
17
+ }
18
+ if (arg === "--spec" || arg === "-s") {
19
+ const next = argv[i + 1];
20
+ if (next !== undefined) {
21
+ source = next;
22
+ }
23
+ i += 1;
24
+ }
25
+ else if (arg === "--headers" || arg === "--header" || arg === "-H") {
26
+ const next = argv[i + 1];
27
+ if (next !== undefined) {
28
+ headers = next;
29
+ }
30
+ i += 1;
31
+ }
32
+ else if (arg === "--help" || arg === "-h") {
33
+ help = true;
34
+ }
35
+ else if (arg.startsWith("--")) {
36
+ // ignore unknown flags
37
+ }
38
+ else if (source === undefined) {
39
+ source = arg;
40
+ }
41
+ }
42
+ const res = { help };
43
+ if (source !== undefined) {
44
+ res.source = source;
45
+ }
46
+ if (headers !== undefined) {
47
+ res.headers = headers;
48
+ }
49
+ return res;
50
+ }
51
+ const USAGE = `openwire — Dynamic OpenAPI-to-MCP Bridge Engine
52
+
53
+ Usage:
54
+ openwire [options] [source]
55
+
56
+ Options:
57
+ -s, --spec <source> Path to an OpenAPI spec file, or an http(s):// URL.
58
+ Overrides the OPENAPI_SOURCE environment variable.
59
+ -H, --headers <json> JSON object of extra headers injected into every request (e.g. {"Authorization": "Bearer ..."}).
60
+ -h, --help Show this help message and exit.
61
+
62
+ Environment:
63
+ OPENAPI_SOURCE Spec file path or URL (required unless --spec is given).
64
+ API_BASE_URL Override the base URL used for every request.
65
+ API_TIMEOUT_MS Per-request timeout in ms (default: ${DEFAULT_CONFIG.timeoutMs}).
66
+ OPENAPI_MAX_TOOLS Maximum operations exposed (default: ${DEFAULT_CONFIG.maxTools}).
67
+ API_MAX_RESPONSE_CHARS Response character budget (default: unlimited).
68
+ SANITIZE_MAX_DEPTH Max JSON depth kept (default: unlimited).
69
+ SANITIZE_MAX_ARRAY_LENGTH Max array elements kept (default: unlimited).
70
+ SANITIZE_MAX_STRING_LENGTH Max string length kept (default: unlimited).
71
+ LOG_LEVEL debug | info | warn | error (default: info).
72
+ SERVER_NAME MCP server name (default: ${DEFAULT_CONFIG.serverName}).
73
+ SERVER_VERSION MCP server version (default: ${DEFAULT_CONFIG.serverVersion}).
74
+ ALLOW_INSECURE_HTTP "true" to allow plain http:// targets (default: false).
75
+ API_HEADERS JSON object of extra headers injected into every request.
76
+ `;
77
+ export async function main() {
78
+ const cli = parseCliArgs(process.argv.slice(2));
79
+ if (cli.help) {
80
+ process.stdout.write(USAGE);
81
+ process.exit(0);
82
+ }
83
+ let config;
84
+ try {
85
+ config = loadConfig(process.env, cli.source, cli.headers);
86
+ }
87
+ catch (err) {
88
+ process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
89
+ process.stderr.write(USAGE);
90
+ process.exit(1);
91
+ }
92
+ const logger = new Logger({ level: config.logLevel });
93
+ logger.info(`Openwire starting (server="${config.serverName}" v${config.serverVersion})`);
94
+ const handle = serveStdio(async () => {
95
+ const context = await buildContext(config, logger);
96
+ return createMcpServer(context);
97
+ });
98
+ const shutdown = (signal) => {
99
+ logger.info(`Received ${signal}, shutting down`);
100
+ void handle.close().then(() => {
101
+ process.exit(0);
102
+ });
103
+ };
104
+ process.on("SIGINT", () => shutdown("SIGINT"));
105
+ process.on("SIGTERM", () => shutdown("SIGTERM"));
106
+ }
107
+ const entry = process.argv[1];
108
+ if (entry && import.meta.url === pathToFileURL(realpathSync(entry)).href) {
109
+ void main();
110
+ }
111
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export { loadSpec, isHttpSource, inferFormat } from "./specLoader.js";
2
+ export type { LoadedSpec, LoadSpecOptions } from "./specLoader.js";
@@ -0,0 +1,2 @@
1
+ export { loadSpec, isHttpSource, inferFormat } from "./specLoader.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,17 @@
1
+ export interface LoadedSpec {
2
+ source: string;
3
+ text: string;
4
+ format: "json" | "yaml";
5
+ }
6
+ export interface LoadSpecOptions {
7
+ maxBytes?: number;
8
+ timeoutMs?: number;
9
+ fetchImpl?: typeof fetch;
10
+ /** When false (default), refusing to fetch specs from plain `http://` URLs. */
11
+ allowInsecureHttp?: boolean;
12
+ /** Extra headers sent when fetching a remote spec (e.g. configured credentials). */
13
+ headers?: Record<string, string>;
14
+ }
15
+ export declare function isHttpSource(source: string): boolean;
16
+ export declare function inferFormat(source: string, text: string): "json" | "yaml";
17
+ export declare function loadSpec(source: string, options?: LoadSpecOptions): Promise<LoadedSpec>;
@@ -0,0 +1,78 @@
1
+ import { readFile, stat } from "node:fs/promises";
2
+ import { SpecLoadError } from "../errors.js";
3
+ export function isHttpSource(source) {
4
+ return /^https?:\/\//i.test(source);
5
+ }
6
+ export function inferFormat(source, text) {
7
+ if (/\.json$/i.test(source)) {
8
+ return "json";
9
+ }
10
+ if (/\.(ya?ml)$/i.test(source)) {
11
+ return "yaml";
12
+ }
13
+ return text.trimStart().startsWith("{") ? "json" : "yaml";
14
+ }
15
+ export async function loadSpec(source, options = {}) {
16
+ if (isHttpSource(source)) {
17
+ return loadFromHttp(source, options);
18
+ }
19
+ return loadFromFile(source, options);
20
+ }
21
+ async function loadFromFile(source, options) {
22
+ try {
23
+ const s = await stat(source);
24
+ if (options.maxBytes && s.size > options.maxBytes) {
25
+ throw new SpecLoadError(`Spec file "${source}" is ${s.size} bytes, exceeding the ${options.maxBytes} byte limit`);
26
+ }
27
+ const text = await readFile(source, "utf8");
28
+ return { source, text, format: inferFormat(source, text) };
29
+ }
30
+ catch (err) {
31
+ if (err instanceof SpecLoadError) {
32
+ throw err;
33
+ }
34
+ const message = err instanceof Error ? err.message : String(err);
35
+ throw new SpecLoadError(`Failed to read spec from file "${source}": ${message}`, {
36
+ cause: err,
37
+ });
38
+ }
39
+ }
40
+ async function loadFromHttp(source, options) {
41
+ if (options.allowInsecureHttp !== true && /^http:\/\//i.test(source)) {
42
+ throw new SpecLoadError(`Refusing to fetch spec over insecure HTTP from "${source}"; set ALLOW_INSECURE_HTTP=true to allow it`);
43
+ }
44
+ const fetchImpl = options.fetchImpl ?? fetch;
45
+ const timeoutMs = options.timeoutMs ?? 30_000;
46
+ const controller = new AbortController();
47
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
48
+ try {
49
+ const response = await fetchImpl(source, {
50
+ signal: controller.signal,
51
+ headers: options.headers,
52
+ });
53
+ if (!response.ok) {
54
+ throw new SpecLoadError(`Failed to fetch spec from "${source}": HTTP ${response.status} ${response.statusText}`);
55
+ }
56
+ const text = await response.text();
57
+ if (options.maxBytes && text.length > options.maxBytes) {
58
+ throw new SpecLoadError(`Spec from "${source}" is ${text.length} characters, exceeding the ${options.maxBytes} byte limit`);
59
+ }
60
+ return { source, text, format: inferFormat(source, text) };
61
+ }
62
+ catch (err) {
63
+ if (err instanceof SpecLoadError) {
64
+ throw err;
65
+ }
66
+ const aborted = err instanceof Error && err.name === "AbortError";
67
+ const message = aborted
68
+ ? `timed out after ${timeoutMs}ms`
69
+ : err instanceof Error
70
+ ? err.message
71
+ : String(err);
72
+ throw new SpecLoadError(`Failed to load spec from "${source}": ${message}`, { cause: err });
73
+ }
74
+ finally {
75
+ clearTimeout(timer);
76
+ }
77
+ }
78
+ //# sourceMappingURL=specLoader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"specLoader.js","sourceRoot":"","sources":["../../src/loader/specLoader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ export type LogLevel = "debug" | "info" | "warn" | "error";
2
+ export declare function parseLogLevel(value: string | undefined): LogLevel;
3
+ export declare class Logger {
4
+ readonly level: LogLevel;
5
+ readonly prefix: string;
6
+ constructor(options?: {
7
+ level?: LogLevel;
8
+ prefix?: string;
9
+ });
10
+ child(prefix: string): Logger;
11
+ debug(message: string, ...args: unknown[]): void;
12
+ info(message: string, ...args: unknown[]): void;
13
+ warn(message: string, ...args: unknown[]): void;
14
+ error(message: string, ...args: unknown[]): void;
15
+ private write;
16
+ }
package/dist/logger.js ADDED
@@ -0,0 +1,65 @@
1
+ const LEVEL_ORDER = {
2
+ debug: 10,
3
+ info: 20,
4
+ warn: 30,
5
+ error: 40,
6
+ };
7
+ export function parseLogLevel(value) {
8
+ const candidate = value?.toLowerCase();
9
+ if (candidate && candidate in LEVEL_ORDER) {
10
+ return candidate;
11
+ }
12
+ return "info";
13
+ }
14
+ export class Logger {
15
+ level;
16
+ prefix;
17
+ constructor(options = {}) {
18
+ this.level = options.level ?? "info";
19
+ this.prefix = options.prefix ?? "";
20
+ }
21
+ child(prefix) {
22
+ const combined = this.prefix ? `${this.prefix} ${prefix}` : prefix;
23
+ return new Logger({ level: this.level, prefix: combined });
24
+ }
25
+ debug(message, ...args) {
26
+ this.write("debug", message, args);
27
+ }
28
+ info(message, ...args) {
29
+ this.write("info", message, args);
30
+ }
31
+ warn(message, ...args) {
32
+ this.write("warn", message, args);
33
+ }
34
+ error(message, ...args) {
35
+ this.write("error", message, args);
36
+ }
37
+ write(level, message, args) {
38
+ if (LEVEL_ORDER[level] < LEVEL_ORDER[this.level]) {
39
+ return;
40
+ }
41
+ const stamp = new Date().toISOString();
42
+ const prefix = this.prefix ? ` [${this.prefix}]` : "";
43
+ const line = `${stamp} ${level.toUpperCase()}${prefix} ${message}${args.length ? " " + fmt(args) : ""}`;
44
+ process.stderr.write(line + "\n");
45
+ }
46
+ }
47
+ function fmt(args) {
48
+ return args
49
+ .map((arg) => {
50
+ if (typeof arg === "string") {
51
+ return arg;
52
+ }
53
+ if (arg instanceof Error) {
54
+ return arg.stack ?? arg.message;
55
+ }
56
+ try {
57
+ return JSON.stringify(arg);
58
+ }
59
+ catch {
60
+ return String(arg);
61
+ }
62
+ })
63
+ .join(" ");
64
+ }
65
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export declare const packageMetadata: {
2
+ name: string;
3
+ version: string;
4
+ };
@@ -0,0 +1,4 @@
1
+ import { createRequire } from "node:module";
2
+ // Both src/ and dist/ live directly below the package root.
3
+ export const packageMetadata = createRequire(import.meta.url)("../package.json");
4
+ //# sourceMappingURL=metadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAG9E,CAAC"}
@@ -0,0 +1 @@
1
+ export { parseOpenApiSpec, toToolName, uniqueToolName, dereferenceSchema } from "./parser.js";
@@ -0,0 +1,2 @@
1
+ export { parseOpenApiSpec, toToolName, uniqueToolName, dereferenceSchema } from "./parser.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,12 @@
1
+ import type { OpenAPIV3, OpenAPIV3_1 } from "openapi-types";
2
+ import type { JsonSchema, ParsedSpec } from "../types.js";
3
+ type OpenApiDocument = (OpenAPIV3.Document | OpenAPIV3_1.Document) & Record<string, unknown>;
4
+ export interface ParseOptions {
5
+ /** Origin (e.g. `https://api.example.com`) used to resolve relative server URLs. */
6
+ specOrigin?: string;
7
+ }
8
+ export declare function parseOpenApiSpec(text: string, format?: "json" | "yaml", options?: ParseOptions): ParsedSpec;
9
+ export declare function toToolName(raw: string): string;
10
+ export declare function uniqueToolName(base: string, used: Set<string>): string;
11
+ export declare function dereferenceSchema(schema: JsonSchema, root: OpenApiDocument): JsonSchema;
12
+ export {};