openwire 1.2.0 → 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.
package/CHANGELOG.md ADDED
@@ -0,0 +1,37 @@
1
+ # Changelog
2
+
3
+ ## 1.2.1 — Documentation and branding
4
+
5
+ - Reorganize the README around quick start, client setup, architecture, configuration, and compatibility.
6
+ - Add the Openwire logo, a dark-theme wordmark, status badges, and an architecture diagram.
7
+ - Organize supplied SVGs under `assets/brand` and package brand assets, diagrams, changelog, and roadmap for npm.
8
+ - Verify required visual assets in the package smoke check.
9
+
10
+ ## 1.2.0 — Openwire
11
+
12
+ ### Migration
13
+
14
+ - Rename the npm package, primary CLI, default MCP identity, and repository to `openwire`.
15
+ - Keep the `api-mcp-bridge` command as an alias and retain existing environment variables and CLI arguments.
16
+ - Derive the reported MCP version from package metadata.
17
+
18
+ ### Fixes
19
+
20
+ - Forward configured headers when downloading protected specifications.
21
+ - Return MCP tool errors for upstream HTTP 4xx/5xx responses.
22
+ - Enforce serialized response character budgets, including JSON punctuation and escaping.
23
+ - Preserve nullable object schemas and avoid mutating input schemas during normalization.
24
+ - Reserve the built-in `health` name when generating operation tools.
25
+ - Resolve local request-body references and select operation/path server overrides.
26
+ - Prefer JSON request media types; reject unsupported encodings when a body is supplied.
27
+ - Refresh affected dependencies within existing major versions to resolve reported advisories.
28
+
29
+ ### Maintenance
30
+
31
+ - Remove the empty npm ignore file and duplicate CLI header configuration handling.
32
+ - Add MCP integration tests and installed-package verification to CI.
33
+ - Document actual authentication, response-limit, and OpenAPI compatibility boundaries.
34
+
35
+ ## 1.1.0
36
+
37
+ - Resolve CLI entry paths through npm binary symlinks.
package/README.md CHANGED
@@ -1,154 +1,86 @@
1
- # openwire
2
-
3
- > A Model Context Protocol (MCP) server that loads OpenAPI 3.0/3.1 specifications (YAML or JSON) at runtime and dynamically exposes every endpoint as a fully validated MCP tool for LLMs.
4
-
5
- Instead of hand-writing tool wrappers for each REST endpoint, give the bridge a local OpenAPI file path or a remote URL. It automatically turns each operation into a typed, validated MCP tool.
6
-
7
- ## Table of Contents
8
-
9
- - [Features](#features)
10
- - [How It Works](#how-it-works)
11
- - [Requirements](#requirements)
12
- - [Migrating from api-mcp-bridge](#migrating-from-api-mcp-bridge)
13
- - [Installation](#installation)
14
- - [CLI Usage](#cli-usage)
15
- - [MCP Client Configuration](#mcp-client-configuration)
16
- - [Configuration & Environment Variables](#configuration--environment-variables)
17
- - [Authentication](#authentication)
18
- - [Compatibility and limitations](#compatibility-and-limitations)
19
- - [Tool Mapping](#tool-mapping)
20
- - [Security & Limits](#security--limits)
21
- - [License](#license)
22
-
23
- ## Features
24
-
25
- - **Dynamic spec ingestion** — loads OpenAPI 3.0.x and 3.1.x specs (JSON or YAML) from a local file path or a remote `http(s)://` URL at startup.
26
- - **Zero glue code** — every operation in the spec becomes an MCP tool automatically; there is nothing to code per endpoint.
27
- - **Type-safe input schemas** — path, query, header, and cookie parameters become top-level tool properties; the request body is exposed as a `body` property. Required fields are enforced.
28
- - **Draft-07 compatible schema normalization** — OpenAPI 3.0 constructs such as `nullable: true` and boolean `exclusiveMinimum`/`exclusiveMaximum` are converted to JSON Schema the MCP/LLM layer understands.
29
- - **`$ref` resolution** — local component references (`#/components/schemas/...`) are dereferenced recursively, with cycle and depth guards.
30
- - **Input validation** — LLM-supplied arguments are validated against the generated JSON Schema with AJV (formats included) _before_ any network call; validation failures are returned as readable tool errors.
31
- - **Automatic HTTP execution** — path parameters are URL-encoded and substituted, query/header/cookie parameters are serialized, and request bodies are sent as JSON with the correct `Content-Type`.
32
- - **Header-based authentication** — inject static credentials via `API_AUTH_HEADERS`/`API_HEADERS` (or `-H`) when fetching the spec and calling API endpoints. Configured headers are not added to tool schemas.
33
- - **Base URL override** — point the bridge at a different environment (staging, a local mock, an authenticated proxy) without editing the spec.
34
- - **Optional response limits** — configure depth, array length, string length, and serialized character budgets. Limits are unlimited by default; tool responses flag truncation.
35
- - **Built-in `health` tool** — a no-op bootstrap tool to verify the server is responding.
36
- - **Failure handling** — invalid specifications prevent startup. Invalid tool arguments, network failures, and HTTP 4xx/5xx responses produce MCP tool errors.
37
- - **Insecure HTTP allowed** — optional flag to permit plain `http://` targets.
38
-
39
- ## How It Works
1
+ <p align="center">
2
+ <picture>
3
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mtellami/openwire/master/assets/brand/logo-dark.svg">
4
+ <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/mtellami/openwire/master/assets/brand/logo.svg">
5
+ <img src="https://raw.githubusercontent.com/mtellami/openwire/master/assets/brand/logo.svg" alt="Openwire" width="460" height="140">
6
+ </picture>
7
+ </p>
40
8
 
41
- ```
42
- OpenAPI spec (file or URL)
43
- │
44
- ▼
45
- ┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐
46
- │ Spec Loader │───▶│ Parser │───▶│ Schema Builder │
47
- │ (YAML/JSON, $ref │ │ (3.0/3.1, ops → │ │ (OpenAPI schema → │
48
- │ dereference) │ │ tool metadata) │ │ MCP JSON Schema) │
49
- └───────────────────┘ └───────────────────┘ └───────────────────┘
50
- │
51
- ▼
52
- ┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐
53
- │ MCP Server │ │ Validator (AJV) │ │ HTTP Executor │
54
- │ (stdio, one tool │───▶│ (reject bad args) │───▶│ (call the API) │
55
- │ per operation) │ └───────────────────┘ └─────────┬─────────┘
56
- └───────────────────┘ ▼
57
- ┌───────────────────┐
58
- │ Sanitizer │
59
- │ (bounded response│
60
- │ for LLM context) │
61
- └───────────────────┘
62
- ```
9
+ <h1 align="center">Your API. Ready for AI.</h1>
63
10
 
64
- 1. **Load** — the spec is read from a file or fetched over HTTP(S) and parsed as JSON or YAML.
65
- 2. **Parse** — each path/verb pair becomes a `ParsedOperation`; `$ref`s are resolved, parameters merged, and tool names derived from `operationId`.
66
- 3. **Build schemas** — operation schemas are normalized and converted into the JSON Schema input contract for each MCP tool.
67
- 4. **Serve** — an MCP stdio server registers a `health` tool plus one tool per operation.
68
- 5. **Validate** — on each tool call, arguments are checked against the input schema with AJV before anything hits the network.
69
- 6. **Execute** — a real HTTP request is built (URL, headers, query, cookies, JSON body) and dispatched with a timeout.
70
- 7. **Sanitize** — the response body is compacted/truncated under configurable budgets and returned to the model, along with the HTTP status.
11
+ <p align="center">
12
+ Turn an OpenAPI specification into validated MCP tools.<br>
13
+ One command. No endpoint wrappers.
14
+ </p>
71
15
 
72
- ## Requirements
16
+ <p align="center">
17
+ <a href="https://www.npmjs.com/package/openwire"><img src="https://img.shields.io/npm/v/openwire?style=flat&amp;color=1D9E75" alt="npm version"></a>
18
+ <a href="https://github.com/mtellami/openwire/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/mtellami/openwire/ci.yml?branch=master&amp;style=flat&amp;label=CI" alt="CI status"></a>
19
+ <a href="https://www.npmjs.com/package/openwire"><img src="https://img.shields.io/node/v/openwire?style=flat&amp;color=1D9E75" alt="Node.js requirement"></a>
20
+ <a href="https://github.com/mtellami/openwire/blob/master/LICENSE"><img src="https://img.shields.io/github/license/mtellami/openwire?style=flat&amp;color=1D9E75" alt="MIT license"></a>
21
+ </p>
73
22
 
74
- - Node.js `>= 20.19` (ESM, built-in `fetch`)
75
- - An OpenAPI 3.0.x or 3.1.x specification, as JSON or YAML
23
+ <p align="center">
24
+ <a href="#quick-start">Quick start</a> ·
25
+ <a href="#connect-your-mcp-client">Client setup</a> ·
26
+ <a href="#how-it-works">Architecture</a> ·
27
+ <a href="#configuration">Configuration</a> ·
28
+ <a href="#compatibility">Compatibility</a> ·
29
+ <a href="https://github.com/mtellami/openwire/blob/master/ROADMAP.md">Roadmap</a>
30
+ </p>
76
31
 
77
- ## Migrating from api-mcp-bridge
32
+ ---
78
33
 
79
- ```bash
80
- npm uninstall -g api-mcp-bridge
81
- npm install -g openwire
82
- ```
34
+ Openwire is a [Model Context Protocol](https://modelcontextprotocol.io) server for REST APIs. Give it a local OpenAPI file or a remote specification URL, and it exposes API operations as tools that an MCP client can discover and call over **stdio**.
83
35
 
84
- Change MCP client commands from `api-mcp-bridge` to `openwire`; for npx use `npx --yes --package openwire openwire --spec ./openapi.yaml`. Environment variables and CLI arguments remain compatible. The old command is also included as an alias in Openwire 1.2.0. The default MCP server identity is now `openwire`; `SERVER_NAME` remains available for overrides.
36
+ Use it to connect an existing API to an AI assistant, point the same tools at staging or a local mock, or explore an API without maintaining a separate integration for every endpoint.
85
37
 
86
- Source repository: [mtellami/openwire](https://github.com/mtellami/openwire). See [release notes](CHANGELOG.md) and the [optimization roadmap](ROADMAP.md).
38
+ ## Why Openwire
87
39
 
88
- ## Installation
40
+ | Capability | What you get |
41
+ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
42
+ | **Tools from your spec** | Operation names, descriptions, parameters, and JSON request bodies become tool definitions at startup. |
43
+ | **Validation before execution** | Arguments are checked against generated schemas with AJV, including supported string formats, before an API request is made. |
44
+ | **Configured authentication** | Inject static authorization or proxy headers into spec downloads and API requests. |
45
+ | **Control over responses** | Opt into depth, array, string, and serialized character limits to manage model context usage. |
46
+ | **Predictable failures** | Validation failures, network errors, and HTTP 4xx/5xx responses are returned as MCP tool errors. |
47
+ | **A small runtime** | Node.js, built-in `fetch`, and a stdio connection. No separate HTTP service to deploy. |
89
48
 
90
- The npm package ships a compiled CLI. This project is an OpenAPI-to-MCP server, unrelated to the Apache ActiveMQ OpenWire protocol.
49
+ ## Quick start
91
50
 
92
- ### Global install
51
+ **Requirements:** Node.js **20.19 or newer** and an OpenAPI **3.0.x or 3.1.x** specification. See [compatibility](#compatibility) for supported features.
93
52
 
94
- ```bash
95
- npm install -g openwire
96
- ```
97
-
98
- ### Run-on-demand with npx
53
+ Run directly with npx:
99
54
 
100
55
  ```bash
101
- npx openwire --spec ./openapi.yaml
56
+ npx --yes openwire --spec ./openapi.yaml
102
57
  ```
103
58
 
104
- ### From source
59
+ Or install the CLI:
105
60
 
106
61
  ```bash
107
- npm install
108
- npm run build
109
- npm run start -- --spec ./openapi.yaml
110
- ```
111
-
112
- ## CLI Usage
113
-
114
- ```
115
- openwire [options] [source]
62
+ npm install -g openwire
63
+ openwire --spec ./openapi.yaml
116
64
  ```
117
65
 
118
- | Argument | Description |
119
- | ---------------------- | ------------------------------------------------------------------------------------------- |
120
- | `-s, --spec <src>` | Path to the spec file or an `http(s)://` URL. |
121
- | `-H, --headers <json>` | JSON object of headers injected into every request (e.g. `{"Authorization":"Bearer ..."}`). |
122
- | `<src>` (positional) | Same as `--spec`. |
123
- | `--help` | Show usage. |
124
-
125
- The spec source can also be provided via the `OPENAPI_SOURCE` environment variable. The CLI flag (or positional argument) takes precedence.
66
+ Remote JSON and YAML specifications work too:
126
67
 
127
68
  ```bash
128
- # Local file spec
129
- openwire --spec ./openapi.yaml
130
-
131
- # Remote spec URL
132
- openwire --spec https://api.example.com/openapi.json
133
-
134
- # Env-driven
135
- OPENAPI_SOURCE=./openapi.yaml openwire
69
+ npx --yes openwire --spec https://api.example.com/openapi.json
136
70
  ```
137
71
 
138
- ## MCP Client Configuration
139
-
140
- `openwire` is a **stdio** MCP server, so it plugs into MCP-compatible clients (Claude Desktop, Cursor, VS Code Copilot, homegrown agents, etc.) as a stdio subprocess.
72
+ > Openwire is a stdio subprocess for an MCP client. A terminal waiting for input is expected; connect it to your client to discover and call tools.
141
73
 
142
- ### Claude Desktop
74
+ ## Connect your MCP client
143
75
 
144
- Open `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`; Windows: `%APPDATA%\Claude\`):
76
+ Add Openwire to a client that supports local stdio MCP servers. The following uses the common `mcpServers` configuration format; the file location and settings interface depend on your client.
145
77
 
146
78
  ```json
147
79
  {
148
80
  "mcpServers": {
149
81
  "openwire": {
150
- "command": "openwire",
151
- "args": ["--spec", "/absolute/path/to/openapi.yaml"],
82
+ "command": "npx",
83
+ "args": ["--yes", "openwire", "--spec", "/absolute/path/to/openapi.yaml"],
152
84
  "env": {
153
85
  "API_BASE_URL": "https://api.example.com"
154
86
  }
@@ -157,126 +89,190 @@ Open `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/
157
89
  }
158
90
  ```
159
91
 
160
- ### Generic / JSON MCP client
161
-
162
- ```json
163
- {
164
- "mcpServers": {
165
- "openwire": {
166
- "command": "openwire",
167
- "args": ["--spec", "https://api.example.com/openapi.json"]
168
- }
169
- }
170
- }
92
+ For a global installation, set `"command": "openwire"` and use `"args": ["--spec", "/absolute/path/to/openapi.yaml"]`. For a source checkout, use `"command": "node"` with the absolute path to `dist/index.js` followed by `--spec` and your spec path.
93
+
94
+ Use an absolute local spec path: the client's working directory may differ from your terminal. Restart the connection after changing the specification or configuration; the tool list is built once at startup.
95
+
96
+ ## How it works
97
+
98
+ <p align="center">
99
+ <img src="https://raw.githubusercontent.com/mtellami/openwire/master/assets/diagrams/architecture.svg" alt="At startup, Openwire loads an OpenAPI specification and builds MCP tools. At runtime, a client calls a tool, Openwire validates arguments, calls the REST API, and returns a compacted response." width="960" height="360">
100
+ </p>
101
+
102
+ At startup, Openwire loads the spec, resolves supported local references, normalizes schemas, and registers a tool for each operation plus a built-in `health` tool. At runtime, it validates arguments, builds and executes the HTTP request, then compacts the response under any configured limits.
103
+
104
+ ### From endpoint to tool
105
+
106
+ Given this operation:
107
+
108
+ ```yaml
109
+ openapi: 3.0.3
110
+ info:
111
+ title: Pet API
112
+ version: 1.0.0
113
+ servers:
114
+ - url: https://api.example.com
115
+ paths:
116
+ /pets/{petId}:
117
+ get:
118
+ operationId: getPetById
119
+ summary: Find a pet by ID
120
+ parameters:
121
+ - name: petId
122
+ in: path
123
+ required: true
124
+ schema:
125
+ type: string
126
+ responses:
127
+ "200":
128
+ description: A pet record
171
129
  ```
172
130
 
173
- ### If the binary is not globally installed
174
-
175
- Use plain `node`:
131
+ Openwire exposes a `getPetById` tool. Calling it with:
176
132
 
177
133
  ```json
178
- {
179
- "mcpServers": {
180
- "openwire": {
181
- "command": "node",
182
- "args": ["/path/to/openwire/dist/index.js", "--spec", "./openapi.yaml"]
183
- }
184
- }
185
- }
134
+ { "petId": "pet-123" }
186
135
  ```
187
136
 
188
- > Note: the tool list is fixed at startup — restart the MCP client whenever the upstream spec changes.
137
+ makes a `GET https://api.example.com/pets/pet-123` request. A successful response is returned as text with its HTTP status, for example:
189
138
 
190
- ## Configuration & Environment Variables
139
+ ```text
140
+ HTTP 200 OK
141
+ {"id":"pet-123","name":"Rex"}
142
+ ```
191
143
 
192
- The server is configured once at startup through environment variables (and the CLI `source` argument).
144
+ | Mapping | Behavior |
145
+ | -------------- | ---------------------------------------------------------------------------------------------------------------- |
146
+ | Tool name | Normalize `operationId` to camelCase; fall back to the method and path. Collisions receive numeric suffixes. |
147
+ | Tool arguments | Path, query, header, and cookie parameters become top-level properties. Unknown arguments are rejected. |
148
+ | Request body | Expose JSON payloads under `body`; require it when the spec does. |
149
+ | Base URL | Use operation, path, then document servers, unless `API_BASE_URL` is set. |
150
+ | Health check | The reserved `health` tool accepts an optional `echo` string. An API operation named `health` becomes `health2`. |
193
151
 
194
- | Variable | Default | Description |
195
- | ---------------------------- | --------------- | -------------------------------------------------------------------------------------------------- |
196
- | `OPENAPI_SOURCE` | _(required)_ | Spec path or `http(s)://` URL to load at startup. |
197
- | `OPENAPI_MAX_TOOLS` | `100` | Maximum number of MCP tools generated from the spec. |
198
- | `API_BASE_URL` | from spec | Overrides the selected operation, path, or document server URL for every request. |
199
- | `API_TIMEOUT_MS` | `30000` | Per-request timeout for calls to the target API. |
200
- | `API_MAX_RESPONSE_CHARS` | unlimited | Total character budget for sanitized responses returned to the model. |
201
- | `SANITIZE_MAX_DEPTH` | unlimited | Max nesting depth kept when compacting JSON responses. |
202
- | `SANITIZE_MAX_ARRAY_LENGTH` | unlimited | Max number of array elements kept per array. |
203
- | `SANITIZE_MAX_STRING_LENGTH` | unlimited | Max length of an individual string value. |
204
- | `LOG_LEVEL` | `info` | `debug`, `info`, `warn`, or `error`. |
205
- | `SERVER_NAME` | `openwire` | MCP server name reported to the client. |
206
- | `SERVER_VERSION` | package version | MCP server version reported to the client. |
207
- | `ALLOW_INSECURE_HTTP` | `false` | When `true`, permits `http://` spec sources and target APIs; otherwise those requests are refused. |
208
- | `API_AUTH_HEADERS` | _(none)_ | JSON object of headers injected into every request (e.g. `{"Authorization":"Bearer ..."}`). |
209
- | `API_HEADERS` | _(none)_ | Same as `API_AUTH_HEADERS`; takes precedence when both are set. |
152
+ ## Configuration
210
153
 
211
- Example:
154
+ ```text
155
+ openwire [options] [source]
156
+ ```
157
+
158
+ | Argument | Description |
159
+ | ---------------------- | --------------------------------------------------------------- |
160
+ | `-s, --spec <source>` | Local spec path or HTTP(S) URL. Overrides `OPENAPI_SOURCE`. |
161
+ | `<source>` | Positional alternative to `--spec`. |
162
+ | `-H, --headers <json>` | JSON object of headers. Overrides header environment variables. |
163
+ | `-h, --help` | Print CLI usage and available environment settings. |
164
+
165
+ ### Environment variables
166
+
167
+ | Variable | Default | Purpose |
168
+ | ---------------------------- | ----------------------------- | ----------------------------------------------------------------------------------------------- |
169
+ | `OPENAPI_SOURCE` | Required without a CLI source | Local spec path or HTTP(S) URL. |
170
+ | `API_BASE_URL` | Selected server from the spec | Override the base URL for every API call. |
171
+ | `API_TIMEOUT_MS` | `30000` | Timeout in milliseconds for spec downloads and API requests. |
172
+ | `OPENAPI_MAX_TOOLS` | `100` | Maximum number of spec operations. Specs above this limit are rejected; `health` is additional. |
173
+ | `API_HEADERS` | Unset | JSON header map sent on spec downloads and API requests. |
174
+ | `API_AUTH_HEADERS` | Unset | Header map fallback; `API_HEADERS` takes precedence. |
175
+ | `API_MAX_RESPONSE_CHARS` | Unlimited | Serialized response-body character budget. |
176
+ | `SANITIZE_MAX_DEPTH` | Unlimited | Maximum JSON nesting depth retained; root depth is zero. |
177
+ | `SANITIZE_MAX_ARRAY_LENGTH` | Unlimited | Maximum number of elements retained per array. |
178
+ | `SANITIZE_MAX_STRING_LENGTH` | Unlimited | String content retained before an optional truncation marker. |
179
+ | `ALLOW_INSECURE_HTTP` | `false` | Permit plain HTTP for spec downloads and API requests. |
180
+ | `LOG_LEVEL` | `info` | `debug`, `info`, `warn`, or `error`. Logs go to stderr. |
181
+ | `SERVER_NAME` | `openwire` | MCP server identity reported to the client. |
182
+ | `SERVER_VERSION` | Package version | MCP server version reported to the client. |
183
+
184
+ ### Authenticate requests
185
+
186
+ Configure precomputed Bearer tokens, Basic authorization values, API-key headers, or custom proxy headers:
212
187
 
213
188
  ```bash
214
- export OPENAPI_SOURCE=https://petstore3.swagger.io/api/v3/openapi.json
215
- export API_BASE_URL=https://localhost:8080
216
- export API_TIMEOUT_MS=15000
217
- export API_MAX_RESPONSE_CHARS=50000
218
- export LOG_LEVEL=debug
219
- openwire
189
+ export API_HEADERS='{"Authorization":"Bearer YOUR_TOKEN","X-API-Key":"YOUR_KEY"}'
190
+ openwire --spec https://api.example.com/openapi.json
220
191
  ```
221
192
 
222
- > When `API_BASE_URL` is set, every tool call is routed to that base URL regardless of what the spec declares, which is handy for mocking, staging, or authenticated gateways.
193
+ For client-managed subprocesses, put `API_HEADERS` in the client's `env` configuration. Keep real credentials out of committed configuration files.
223
194
 
224
- ## Authentication
195
+ Header precedence is **`--headers` → `API_HEADERS` → `API_AUTH_HEADERS`**: the highest-priority value replaces the entire header map. Configured headers override same-name header parameters supplied in a tool call.
225
196
 
226
- Openwire injects configured credentials as HTTP headers on spec downloads and API requests. Configured headers override tool-supplied header parameters of the same name. Configure them with `API_AUTH_HEADERS` (env), `API_HEADERS` (env, takes precedence), or the `-H/--headers` CLI flag (takes precedence over both).
197
+ The same headers are sent to the spec URL and the selected API server, so use trusted endpoints. Security schemes are metadata: Openwire does not perform OAuth/OpenID flows, refresh tokens, or automatically inject query/cookie API keys. Use a suitable proxy or restart with updated static credentials when tokens rotate.
227
198
 
228
- The value is a JSON object of header name/value pairs:
199
+ ### Manage response size
200
+
201
+ Limits are opt-in. For example:
229
202
 
230
203
  ```bash
231
- export OPENAPI_SOURCE=https://api.example.com/openapi.json
232
- export API_AUTH_HEADERS='{"Authorization":"Bearer eyJhbGciOi...","X-API-Key":"abc123"}'
233
- openwire
204
+ export API_MAX_RESPONSE_CHARS=20000
205
+ export SANITIZE_MAX_DEPTH=8
206
+ export SANITIZE_MAX_ARRAY_LENGTH=50
207
+ export SANITIZE_MAX_STRING_LENGTH=2000
208
+ openwire --spec ./openapi.yaml
234
209
  ```
235
210
 
236
- Or via the CLI flag:
211
+ The character budget includes JSON escaping, punctuation, and embedded markers. HTTP status lines and the separate `[response truncated]` notice sit outside that budget. JSON remains valid when a value fits; otherwise the response body is empty.
212
+
213
+ Responses are buffered before sanitization. These options limit output to the client, rather than download size or peak memory usage.
214
+
215
+ ### Use a local API
237
216
 
238
217
  ```bash
239
- openwire --spec ./openapi.yaml -H '{"Authorization":"Bearer eyJhbGciOi..."}'
218
+ export API_BASE_URL=http://localhost:8080
219
+ export ALLOW_INSECURE_HTTP=true
220
+ openwire --spec ./openapi.yaml
240
221
  ```
241
222
 
242
- Supply precomputed Bearer tokens, Basic authorization values, API-key headers, or proxy headers. Security schemes in the spec are metadata: Openwire does not perform OAuth/OpenID flows or automatically inject query/cookie API keys. Query/cookie parameters declared by the spec remain ordinary tool arguments.
223
+ ## Compatibility
243
224
 
244
- Static tokens only — if your API needs a fresh token per call (client-credentials exchange, short-lived JWTs), point `API_BASE_URL` at a proxy that acquires tokens, or rotate the header value before restarting the bridge.
225
+ | Area | Current support |
226
+ | ----------------- | ----------------------------------------------------------------------------------------------------- |
227
+ | Transport | Local stdio MCP server. |
228
+ | Specifications | OpenAPI 3.0.x and 3.1.x, JSON or YAML, local file or HTTP(S) source. |
229
+ | Schema validation | AJV draft-07 with OpenAPI 3.0 normalization; full JSON Schema 2020-12 semantics are not implemented. |
230
+ | References | Supported local references; external references and recursive schema cycles are rejected. |
231
+ | Request bodies | `application/json` and `application/*+json`; other encodings return an error when a body is supplied. |
232
+ | Parameters | Scalar/JSON serialization; OpenAPI `style` and `explode` are not fully implemented. |
233
+ | Servers | Operation/path/document precedence and a global override; server variables are not expanded. |
234
+ | Authentication | Static HTTP headers; no token acquisition or refresh. |
245
235
 
246
- > When the _spec file itself_ is served from a protected URL, the same headers are attached when fetching `OPENAPI_SOURCE` over HTTP(S).
236
+ Parameter names share one argument namespace. Duplicate names across locations, or a parameter named `body`, can collide with the request-body argument.
247
237
 
248
- ## Compatibility and limitations
238
+ Plain HTTP is refused by default. Configured credentials are not added to tool schemas, and logs omit request headers; upstream response bodies can still echo sensitive information. Invalid specifications prevent initialization; invalid arguments, network failures, and HTTP 4xx/5xx responses produce tool errors.
249
239
 
250
- - Local references are supported; external references and recursive schema cycles are rejected.
251
- - OpenAPI 3.0 schemas are normalized for draft-07 validation. OpenAPI 3.1 documents are accepted, but full JSON Schema 2020-12 semantics are not implemented.
252
- - JSON request bodies (`application/json` and `application/*+json`) are supported and preferred. Other body encodings return a clear execution error when a body is supplied.
253
- - Parameter serialization uses simple scalar/JSON values; OpenAPI `style`/`explode` rules are not fully implemented.
254
- - Parameter names share one tool namespace; duplicate names across locations or a parameter named `body` can collide with the body argument.
255
- - Server selection uses operation, path, then document precedence. Server-variable expansion is not implemented.
240
+ ## Development
256
241
 
257
- ## Tool Mapping
242
+ ```bash
243
+ git clone https://github.com/mtellami/openwire.git
244
+ cd openwire
245
+ npm ci
246
+ npm run build
247
+ npm start -- --spec ./openapi.yaml
248
+ ```
258
249
 
259
- - **Tool name** — derived from the operation's `operationId` (normalized to camelCase); falls back to `<method>_<path>` when no `operationId` exists. The built-in `health` name is reserved. Collisions get a numeric suffix (`getUser`, `getUser2`, …).
260
- - **Tool description** — `HTTP <METHOD> <path>`, plus the operation `summary` and `description`.
261
- - **Input schema** — one property per path/query/header/cookie parameter (required ones listed under `required`), and a single `body` property for operations with a request body (required when the spec marks it so). `additionalProperties` is disabled.
262
- - **Built-in tools** — a `health` tool with an optional `echo` string argument lets clients probe connectivity.
250
+ | Command | Purpose |
251
+ | -------------------------------------- | ----------------------------------------------------------------- |
252
+ | `npm run dev -- --spec ./openapi.yaml` | Run the CLI with source watching. |
253
+ | `npm run typecheck` | Check TypeScript types. |
254
+ | `npm run lint` | Lint source files. |
255
+ | `npm run format:check` | Check repository formatting. |
256
+ | `npm test` | Run unit and MCP integration tests. |
257
+ | `npm run test:package` | Build, pack, install, and verify both CLI names and MCP behavior. |
263
258
 
264
- Example effect for a hypothetical `GET /pets/{petId}` with an `order` query param:
259
+ CI runs checks on Node.js **20, 22, and 24**. Brand assets live in [`assets/brand`](https://github.com/mtellami/openwire/tree/master/assets/brand), and README diagrams live in [`assets/diagrams`](https://github.com/mtellami/openwire/tree/master/assets/diagrams). The README uses absolute image URLs so the same branding renders on GitHub and npm.
265
260
 
266
- ```
267
- MCP tool: getPetById
268
- Input: { petId: string (required), order?: string }
261
+ For bug reports, include your Node.js version, a minimal specification with secrets removed, the command or client configuration, and the observed error. Use [GitHub Issues](https://github.com/mtellami/openwire/issues) for reports and feature requests, or open a pull request with a focused change and relevant validation.
262
+
263
+ ## Migrating from api-mcp-bridge
264
+
265
+ ```bash
266
+ npm uninstall -g api-mcp-bridge
267
+ npm install -g openwire
269
268
  ```
270
269
 
271
- ## Security & Limits
270
+ Update the MCP command to `openwire`, or use `npx --yes openwire`. Existing environment variable names and CLI arguments remain compatible. The old command is retained as an alias in Openwire 1.2.x; the default server identity is now `openwire`.
272
271
 
273
- - Spec loading supports both local files and remote URLs; remote fetches honor `API_TIMEOUT_MS`, and `http://` sources are refused unless `ALLOW_INSECURE_HTTP=true`.
274
- - Requests to the target API are made with the built-in `fetch` and a timeout; slow or failing upstreams surface as structured tool errors. Plain `http://` targets are refused unless `ALLOW_INSECURE_HTTP=true`.
275
- - Configured credentials are injected server-side and are not added to tool schemas. Logs omit request headers, but upstream responses may echo secrets; configure and trust your upstream accordingly.
276
- - Response limits are opt-in. `API_MAX_RESPONSE_CHARS` bounds the serialized response body, including escaping and embedded markers; HTTP status lines and the separate `[response truncated]` notice are outside that budget. JSON stays valid when a value fits; otherwise the body is empty. Downloads are still buffered before sanitization.
277
- - Argument validation happens before any external call, rejecting malformed input early.
278
- - To talk to `http://` endpoints (e.g., local mocks), set `ALLOW_INSECURE_HTTP=true`.
272
+ ## Project
279
273
 
280
- ## License
274
+ - [Changelog](https://github.com/mtellami/openwire/blob/master/CHANGELOG.md) — release history and migration notes.
275
+ - [Roadmap](https://github.com/mtellami/openwire/blob/master/ROADMAP.md) — operation filtering, bounded downloads, OpenAPI compatibility, and authentication improvements.
276
+ - [MIT license](https://github.com/mtellami/openwire/blob/master/LICENSE) — maintained by [Moad Tellami](https://github.com/mtellami).
281
277
 
282
- [MIT](LICENSE)
278
+ Openwire is an OpenAPI-to-MCP server, unrelated to the Apache ActiveMQ OpenWire protocol.
package/ROADMAP.md ADDED
@@ -0,0 +1,15 @@
1
+ # Openwire optimization roadmap
2
+
3
+ Priorities follow the current implementation review. These features are deferred beyond 1.2.0.
4
+
5
+ | Priority | Improvement | Benefit | Acceptance evidence |
6
+ | -------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
7
+ | 1 | Filter operations by tag, path, method, or operation ID before applying the tool limit | Let large APIs expose a useful subset without overwhelming client context | Deterministic filtered tool lists; excluded operations never register; measure tool-schema size reduction |
8
+ | 2 | Stream and cap spec downloads and API responses before buffering | Bound memory use even when upstream payloads are huge | Byte-accurate limits for UTF-8, streamed responses, and missing Content-Length; benchmark peak memory |
9
+ | 3 | Support parameter style/explode, server variables, recursive schemas, and dialect-aware OpenAPI 3.1 validation | Increase compatibility with real API specifications | Conformance fixtures for each supported feature and explicit errors for unsupported constructs |
10
+ | 4 | Separate spec and API credentials; support explicit query/cookie API-key injection | Avoid sharing credentials between services and support additional authentication layouts | Credential isolation across hosts, redirect tests, and no secret tool-schema exposure |
11
+ | 5 | Benchmark startup and optimize repeated reference resolution/schema compilation | Reduce startup time for larger specifications | Compare cold/warm startup, compile counts, memory, and identical generated schemas before adding caches |
12
+
13
+ Additional correctness work: avoid argument-name collisions between parameter locations and request bodies; validate configuration numbers strictly; expand redirect policy checks and sensitive-URL redaction. Do not add automatic retries for mutating API requests without an explicit idempotency policy.
14
+
15
+ Keep stdio as the default transport. Consider new transports or OAuth token acquisition as separate features with their own compatibility and lifecycle designs.
@@ -0,0 +1,10 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512" xmlns:c2pa="http://c2pa.org/manifest">
2
+ <title>openwire icon</title>
3
+ <rect width="512" height="512" rx="112" fill="#111916"/>
4
+ <g transform="translate(334 256) scale(4)" fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="3">
5
+ <path d="M-45 -18 Q-55 -18 -55 -8 V-4 Q-55 0 -61 0 Q-55 0 -55 4 V8 Q-55 18 -45 18" stroke="#F1EFE8"/>
6
+ <path d="M-42 0 H-22" stroke="#1D9E75"/>
7
+ <polygon points="22,0 11,19.1 -11,19.1 -22,0 -11,-19.1 11,-19.1" stroke="#1D9E75"/>
8
+ <circle cx="0" cy="0" r="4" fill="#1D9E75" stroke="none"/>
9
+ </g>
10
+ <metadata><c2pa:manifest>AAAWgmp1bWIAAAAeanVtZGMycGEAEQAQgAAAqgA4m3EDYzJwYQAAABZcanVtYgAAAEdqdW1kYzJtYQARABCAAACqADibcQN1cm46YzJwYTphYmFlMmZmOC0wYmU4LTQ4MjctYTg4Mi1mMGY3NDk1YWM5NDUAAAADl2p1bWIAAAApanVtZGMyYXMAEQAQgAAAqgA4m3EDYzJwYS5hc3NlcnRpb25zAAAAALxqdW1iAAAARGp1bWRjYm9yABEAEIAAAKoAOJtxE2MycGEuaW5ncmVkaWVudC52MwAAAAAYYzJzaE3BSctaZZImCG0SJfeh9BkAAABwY2JvcqNpZGM6Zm9ybWF0bWltYWdlL3N2Zyt4bWxqaW5zdGFuY2VJRHgseG1wOmlpZDpjNzk1N2ZiYi0wNTVmLTQ1NDAtYjI0Ny1iMzFhM2U0Y2MyMDJscmVsYXRpb25zaGlwaHBhcmVudE9mAAAB4mp1bWIAAABBanVtZGNib3IAEQAQgAAAqgA4m3ETYzJwYS5hY3Rpb25zLnYyAAAAABhjMnNoLV74T/rjkD+Zbg1CRRJ2hwAAAZljYm9yomdhY3Rpb25zgqJmYWN0aW9ua2MycGEub3BlbmVkanBhcmFtZXRlcnOha2luZ3JlZGllbnRzgaJjdXJseC1zZWxmI2p1bWJmPWMycGEuYXNzZXJ0aW9ucy9jMnBhLmluZ3JlZGllbnQudjNkaGFzaFggsZvkU9mXBCNYqW6BS7d1YQ34QdgKuWOFL55V4yUR9H+kZmFjdGlvbngdY29tLmFudGhyb3BpYy5jbGF1ZGUucHJvdmlkZWRqcGFyYW1ldGVyc6F4H2NvbS5hbnRocm9waWMub3JpZ2luLWNvbmZpZGVuY2VndW5rbm93bmtkZXNjcmlwdGlvbnhmQ2xhdWRlIHByb3ZpZGVkIHRoaXMgZmlsZSBhdCB0aGUgcmVxdWVzdCBvZiBhIHVzZXIgYW5kIG1heSBoYXZlIGNyZWF0ZWQgb3IgbW9kaWZpZWQgdGhlIGZpbGUgY29udGVudHMubXNvZnR3YXJlQWdlbnShZG5hbWVmQ2xhdWRlcmFsbEFjdGlvbnNJbmNsdWRlZPUAAADIanVtYgAAAEBqdW1kY2JvcgARABCAAACqADibcRNjMnBhLmhhc2guZGF0YQAAAAAYYzJzaB0LZf1b0kwBXSbc4YqEWBgAAACAY2JvcqVjYWxnZnNoYTI1NmNwYWRMAAAAAAAAAAAAAAAAZGhhc2hYIL213/lUmPfYLLw1wSeoKoNu1oKjdgp2Yz00Zj7g9/6tZG5hbWVuanVtYmYgbWFuaWZlc3RqZXhjbHVzaW9uc4GiZXN0YXJ0GQKgZmxlbmd0aBkeBAAAAj5qdW1iAAAAJ2p1bWRjMmNsABEAEIAAAKoAOJtxA2MycGEuY2xhaW0udjIAAAACD2Nib3KlY2FsZ2ZzaGEyNTZpc2lnbmF0dXJleE1zZWxmI2p1bWJmPS9jMnBhL3VybjpjMnBhOmFiYWUyZmY4LTBiZTgtNDgyNy1hODgyLWYwZjc0OTVhYzk0NS9jMnBhLnNpZ25hdHVyZWppbnN0YW5jZUlEeCx4bXA6aWlkOjU2OTI5NWU1LTM0NGQtNDgwMS04NjRjLWExMDdmNWNjZWUxN3JjcmVhdGVkX2Fzc2VydGlvbnODomN1cmx4LXNlbGYjanVtYmY9YzJwYS5hc3NlcnRpb25zL2MycGEuaW5ncmVkaWVudC52M2RoYXNoWCCxm+RT2ZcEI1ipboFLt3VhDfhB2Aq5Y4UvnlXjJRH0f6JjdXJseCpzZWxmI2p1bWJmPWMycGEuYXNzZXJ0aW9ucy9jMnBhLmFjdGlvbnMudjJkaGFzaFggxyl49LE2PPKNnlVsKYm5Hf/lBKtGwOaun3OZ1faW+1iiY3VybHgpc2VsZiNqdW1iZj1jMnBhLmFzc2VydGlvbnMvYzJwYS5oYXNoLmRhdGFkaGFzaFggYhaIzTD+Yt5/mKuSNLTBu24cCMXhMYT/2IgYHd8i2TN0Y2xhaW1fZ2VuZXJhdG9yX2luZm+jZG5hbWVvQW50aHJvcGljIEZpbGVzZ3ZlcnNpb25lMS4wLjBrc3BlY1ZlcnNpb25lMi40LjAAABA4anVtYgAAAChqdW1kYzJjcwARABCAAACqADibcQNjMnBhLnNpZ25hdHVyZQAAABAIY2JvctKEWQISogEmGCFZAgowggIGMIIBjaADAgECAhRA5aAK7sI50L64g/oGQgU9Z1UTADAKBggqhkjOPQQDAzBJMRcwFQYDVQQKEw5BbnRocm9waWMsIFBCQzEuMCwGA1UEAxMlQW50aHJvcGljIENvbnRlbnQgQ3JlZGVudGlhbHMgUm9vdCBDQTAeFw0yNjA4MDcxODQzNTZaFw0yODA4MDYxOTQzNTZaMEQxFzAVBgNVBAoTDkFudGhyb3BpYywgUEJDMSkwJwYDVQQDEyBBbnRocm9waWMgQ2xhdWRlIENvbnRlbnQgU2lnbmluZzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJh6CmvLUBgFFNU0vUKlOVtE6djd17L5SuwX0LemFisBM3dkd/3cyjxFA3Qo5S46fX0/ihY0VZ7mfb9KF703t5OjWDBWMA4GA1UdDwEB/wQEAwIHgDAVBgNVHSUEDjAMBgorBgEEAYPoXgIBMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUzlHiBIFOZFsj+OPEz5o+nMHXXMIwCgYIKoZIzj0EAwMDZwAwZAIwMXMdFJ4BetLLVY7ORuE9noqbbAZOZn/aArXyTwFAZfKrPzxF2vPoJNf1+UCdg1XGAjBwX1zd9WGqYkqmL5SFqw1QySjr1zJfpJM9+1rdDwSPLMOPOjKuiXjoU/pUUeG9RwmhY3BhZFkNngAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAPZYQNssFvxnIH8IPMQK7dDKiTfh16wlZpIXOUh/tRELIcipYBEOLXRgRF5IxUMAa1HteytIs6NCEWgwIiTIc5o7QJ4=</c2pa:manifest></metadata></svg>
@@ -0,0 +1,10 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="460" height="140" viewBox="0 0 460 140">
2
+ <title>openwire</title>
3
+ <g transform="translate(130 70) scale(1.9)" fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="3">
4
+ <path d="M-45 -18 Q-55 -18 -55 -8 V-4 Q-55 0 -61 0 Q-55 0 -55 4 V8 Q-55 18 -45 18" stroke="#F1EFE8"/>
5
+ <path d="M-42 0 H-22" stroke="#1D9E75"/>
6
+ <polygon points="22,0 11,19.1 -11,19.1 -22,0 -11,-19.1 11,-19.1" stroke="#1D9E75"/>
7
+ <circle cx="0" cy="0" r="4" fill="#1D9E75" stroke="none"/>
8
+ </g>
9
+ <text x="190" y="88" font-family="Inter, Helvetica, Arial, sans-serif" font-size="56" font-weight="500" fill="#F1EFE8">open<tspan fill="#1D9E75">wire</tspan></text>
10
+ </svg>
@@ -0,0 +1,10 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="460" height="140" viewBox="0 0 460 140" xmlns:c2pa="http://c2pa.org/manifest">
2
+ <title>openwire</title>
3
+ <g transform="translate(130 70) scale(1.9)" fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="3">
4
+ <path d="M-45 -18 Q-55 -18 -55 -8 V-4 Q-55 0 -61 0 Q-55 0 -55 4 V8 Q-55 18 -45 18" stroke="#2C2C2A"/>
5
+ <path d="M-42 0 H-22" stroke="#1D9E75"/>
6
+ <polygon points="22,0 11,19.1 -11,19.1 -22,0 -11,-19.1 11,-19.1" stroke="#1D9E75"/>
7
+ <circle cx="0" cy="0" r="4" fill="#1D9E75" stroke="none"/>
8
+ </g>
9
+ <text x="190" y="88" font-family="Inter, Helvetica, Arial, sans-serif" font-size="56" font-weight="500" fill="#2C2C2A">open<tspan fill="#1D9E75">wire</tspan></text>
10
+ <metadata><c2pa:manifest>AAAWgmp1bWIAAAAeanVtZGMycGEAEQAQgAAAqgA4m3EDYzJwYQAAABZcanVtYgAAAEdqdW1kYzJtYQARABCAAACqADibcQN1cm46YzJwYToyOTMxN2NkZi01Mjc5LTQwYTktODM5My0wMGFmYmU0MjUzYzQAAAADl2p1bWIAAAApanVtZGMyYXMAEQAQgAAAqgA4m3EDYzJwYS5hc3NlcnRpb25zAAAAALxqdW1iAAAARGp1bWRjYm9yABEAEIAAAKoAOJtxE2MycGEuaW5ncmVkaWVudC52MwAAAAAYYzJzaN3ZYQXQClPTBocAMokXfhgAAABwY2JvcqNpZGM6Zm9ybWF0bWltYWdlL3N2Zyt4bWxqaW5zdGFuY2VJRHgseG1wOmlpZDo0NTlmODM4MS1mZWU1LTQ2NjQtOWRkYy1lMWQwYWI3ZTEyM2RscmVsYXRpb25zaGlwaHBhcmVudE9mAAAB4mp1bWIAAABBanVtZGNib3IAEQAQgAAAqgA4m3ETYzJwYS5hY3Rpb25zLnYyAAAAABhjMnNos79OVmWlsOygRQmHb1NPvwAAAZljYm9yomdhY3Rpb25zgqJmYWN0aW9ua2MycGEub3BlbmVkanBhcmFtZXRlcnOha2luZ3JlZGllbnRzgaJjdXJseC1zZWxmI2p1bWJmPWMycGEuYXNzZXJ0aW9ucy9jMnBhLmluZ3JlZGllbnQudjNkaGFzaFgg1MwYOJtjZb9cUWqHMDhElPULYBDuZC1uAcxT+6vkv/mkZmFjdGlvbngdY29tLmFudGhyb3BpYy5jbGF1ZGUucHJvdmlkZWRqcGFyYW1ldGVyc6F4H2NvbS5hbnRocm9waWMub3JpZ2luLWNvbmZpZGVuY2VndW5rbm93bmtkZXNjcmlwdGlvbnhmQ2xhdWRlIHByb3ZpZGVkIHRoaXMgZmlsZSBhdCB0aGUgcmVxdWVzdCBvZiBhIHVzZXIgYW5kIG1heSBoYXZlIGNyZWF0ZWQgb3IgbW9kaWZpZWQgdGhlIGZpbGUgY29udGVudHMubXNvZnR3YXJlQWdlbnShZG5hbWVmQ2xhdWRlcmFsbEFjdGlvbnNJbmNsdWRlZPUAAADIanVtYgAAAEBqdW1kY2JvcgARABCAAACqADibcRNjMnBhLmhhc2guZGF0YQAAAAAYYzJzaGBwIGmqV9mzu6VCXr//SzQAAACAY2JvcqVjYWxnZnNoYTI1NmNwYWRMAAAAAAAAAAAAAAAAZGhhc2hYIFPeq538hiXmKIpvSG4G2AQZFfZwH2eS94aNIpxABnoIZG5hbWVuanVtYmYgbWFuaWZlc3RqZXhjbHVzaW9uc4GiZXN0YXJ0GQMIZmxlbmd0aBkeBAAAAj5qdW1iAAAAJ2p1bWRjMmNsABEAEIAAAKoAOJtxA2MycGEuY2xhaW0udjIAAAACD2Nib3KlY2FsZ2ZzaGEyNTZpc2lnbmF0dXJleE1zZWxmI2p1bWJmPS9jMnBhL3VybjpjMnBhOjI5MzE3Y2RmLTUyNzktNDBhOS04MzkzLTAwYWZiZTQyNTNjNC9jMnBhLnNpZ25hdHVyZWppbnN0YW5jZUlEeCx4bXA6aWlkOjg3YTg1NTk5LWY2ODktNDI2Mi04MmNhLTQ2OTgyZTA3OTlkM3JjcmVhdGVkX2Fzc2VydGlvbnODomN1cmx4LXNlbGYjanVtYmY9YzJwYS5hc3NlcnRpb25zL2MycGEuaW5ncmVkaWVudC52M2RoYXNoWCDUzBg4m2Nlv1xRaocwOESU9QtgEO5kLW4BzFP7q+S/+aJjdXJseCpzZWxmI2p1bWJmPWMycGEuYXNzZXJ0aW9ucy9jMnBhLmFjdGlvbnMudjJkaGFzaFggtY+k4GdlcAoxXBcYDgU0IyDiXvo2AesW0rWWd1SgfrWiY3VybHgpc2VsZiNqdW1iZj1jMnBhLmFzc2VydGlvbnMvYzJwYS5oYXNoLmRhdGFkaGFzaFggMW9Mcyzz4EidoHSIAnZZmYNsUGCKUqYX7s2u3JadpW50Y2xhaW1fZ2VuZXJhdG9yX2luZm+jZG5hbWVvQW50aHJvcGljIEZpbGVzZ3ZlcnNpb25lMS4wLjBrc3BlY1ZlcnNpb25lMi40LjAAABA4anVtYgAAAChqdW1kYzJjcwARABCAAACqADibcQNjMnBhLnNpZ25hdHVyZQAAABAIY2JvctKEWQISogEmGCFZAgowggIGMIIBjaADAgECAhRA5aAK7sI50L64g/oGQgU9Z1UTADAKBggqhkjOPQQDAzBJMRcwFQYDVQQKEw5BbnRocm9waWMsIFBCQzEuMCwGA1UEAxMlQW50aHJvcGljIENvbnRlbnQgQ3JlZGVudGlhbHMgUm9vdCBDQTAeFw0yNjA4MDcxODQzNTZaFw0yODA4MDYxOTQzNTZaMEQxFzAVBgNVBAoTDkFudGhyb3BpYywgUEJDMSkwJwYDVQQDEyBBbnRocm9waWMgQ2xhdWRlIENvbnRlbnQgU2lnbmluZzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJh6CmvLUBgFFNU0vUKlOVtE6djd17L5SuwX0LemFisBM3dkd/3cyjxFA3Qo5S46fX0/ihY0VZ7mfb9KF703t5OjWDBWMA4GA1UdDwEB/wQEAwIHgDAVBgNVHSUEDjAMBgorBgEEAYPoXgIBMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUzlHiBIFOZFsj+OPEz5o+nMHXXMIwCgYIKoZIzj0EAwMDZwAwZAIwMXMdFJ4BetLLVY7ORuE9noqbbAZOZn/aArXyTwFAZfKrPzxF2vPoJNf1+UCdg1XGAjBwX1zd9WGqYkqmL5SFqw1QySjr1zJfpJM9+1rdDwSPLMOPOjKuiXjoU/pUUeG9RwmhY3BhZFkNngAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAPZYQDMqnM3ulviHK0qUGy/Nhv2dIv3nl3t02pwVEszMNTj2q47Eq06A4bjkq0XqmiBXJDykeVRcBMa66NCR79kfm84=</c2pa:manifest></metadata></svg>
@@ -0,0 +1,39 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="960" height="360" viewBox="0 0 960 360" role="img" aria-labelledby="title desc">
2
+ <title id="title">Openwire architecture</title>
3
+ <desc id="desc">At startup, an OpenAPI specification is parsed into validated MCP tools. During a tool call, Openwire validates arguments, calls the REST API, and returns the compacted response to the MCP client.</desc>
4
+ <defs>
5
+ <marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto-start-reverse"><path d="M0 0L8 4L0 8" fill="none" stroke="#60766c" stroke-width="1.5"/></marker>
6
+ </defs>
7
+ <rect x="1" y="1" width="958" height="358" rx="20" fill="#f8faf9" stroke="#dce7e1"/>
8
+ <g font-family="Inter, Helvetica, Arial, sans-serif">
9
+ <text x="36" y="35" font-size="11" font-weight="700" letter-spacing="2" fill="#52655c">STARTUP</text>
10
+ <rect x="36" y="53" width="230" height="64" rx="12" fill="#fff" stroke="#d0ded6"/>
11
+ <text x="56" y="79" font-size="16" font-weight="600" fill="#182d22">OpenAPI specification</text>
12
+ <text x="56" y="101" font-size="12" fill="#52655c">File or URL · JSON / YAML</text>
13
+ <path d="M268 85H321" stroke="#60766c" stroke-width="1.5" marker-end="url(#arrow)"/>
14
+ <rect x="333" y="53" width="267" height="64" rx="12" fill="#eaf6f0" stroke="#82bfa5"/>
15
+ <text x="353" y="79" font-size="16" font-weight="600" fill="#182d22">Parse and build schemas</text>
16
+ <text x="353" y="101" font-size="12" fill="#52655c">Resolve local references · map operations</text>
17
+ <path d="M602 85H656" stroke="#60766c" stroke-width="1.5" marker-end="url(#arrow)"/>
18
+ <rect x="668" y="53" width="256" height="64" rx="12" fill="#fff" stroke="#d0ded6"/>
19
+ <text x="688" y="79" font-size="16" font-weight="600" fill="#182d22">Register MCP tools</text>
20
+ <text x="688" y="101" font-size="12" fill="#52655c">One per operation + health</text>
21
+ <path d="M36 143H924" stroke="#dce7e1"/>
22
+ <text x="36" y="175" font-size="11" font-weight="700" letter-spacing="2" fill="#52655c">TOOL CALL</text>
23
+ <rect x="36" y="195" width="190" height="74" rx="12" fill="#fff" stroke="#d0ded6"/>
24
+ <text x="56" y="225" font-size="16" font-weight="600" fill="#182d22">MCP client</text>
25
+ <text x="56" y="248" font-size="12" fill="#52655c">Call a tool over stdio</text>
26
+ <path d="M228 231H283" stroke="#60766c" stroke-width="1.5" marker-end="url(#arrow)"/>
27
+ <rect x="295" y="195" width="320" height="74" rx="12" fill="#111916"/>
28
+ <text x="315" y="225" font-size="16" font-weight="600" fill="#f1efe8">Openwire</text>
29
+ <text x="315" y="248" font-size="12" fill="#b6d4c5">Validate arguments → build HTTP request</text>
30
+ <path d="M617 231H720" stroke="#60766c" stroke-width="1.5" marker-end="url(#arrow)"/>
31
+ <text x="646" y="216" font-size="11" fill="#52655c">HTTP(S)</text>
32
+ <rect x="732" y="195" width="192" height="74" rx="12" fill="#fff" stroke="#d0ded6"/>
33
+ <text x="752" y="225" font-size="16" font-weight="600" fill="#182d22">Your REST API</text>
34
+ <text x="752" y="248" font-size="12" fill="#52655c">Execute the operation</text>
35
+ <path d="M828 271V318H133V281" stroke="#1d9e75" stroke-width="1.5" fill="none" marker-end="url(#arrow)"/>
36
+ <rect x="273" y="302" width="420" height="28" rx="14" fill="#eaf6f0"/>
37
+ <text x="483" y="321" text-anchor="middle" font-size="12" font-weight="500" fill="#176c50">HTTP status + compacted body · optional response limits</text>
38
+ </g>
39
+ </svg>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openwire",
3
- "version": "1.2.0",
3
+ "version": "1.2.1",
4
4
  "description": "OpenAPI-to-MCP server: turn API specifications into validated tools for AI clients.",
5
5
  "author": "Moad Tellami",
6
6
  "license": "MIT",
@@ -42,7 +42,10 @@
42
42
  "api-mcp-bridge": "dist/index.js"
43
43
  },
44
44
  "files": [
45
- "dist"
45
+ "dist",
46
+ "assets",
47
+ "CHANGELOG.md",
48
+ "ROADMAP.md"
46
49
  ],
47
50
  "scripts": {
48
51
  "dev": "tsx watch src/index.ts",