relmio 0.2.14 → 0.3.0

package/CHANGELOG.md

@@ -7,6 +7,41 @@ checks the registry separately after publication.
 
 ## Unreleased
 
+## [0.3.0] - 2026-08-05
+
+### Added
+
+- Add a copy-ready n8n HTTP Request recipe to the local wizard, including the
+  private Chat Completions URL, Generic Credential Type → Bearer Auth fields,
+  the harmless `local-only` bearer placeholder, JSON headers, the structured
+  response-format body, and a full recipe copy action.
+- Add the same structured `gpt-5.6-sol` example and importable cURL recipe to
+  the GitHub README, npm README, and n8n configuration guide.
+- Add a repository-local changelog skill that standardizes Relmio's patch,
+  pre-1.0 feature, and stable major release numbering and metadata checks.
+
+### Changed
+
+- Treat `0.3.0` as Relmio's major feature release within the pre-1.0 series;
+  it consolidates the key improvements shipped from v0.2.10 through v0.2.14:
+  resilient Windows OAuth/bootstrap flows, native Command Prompt installation,
+  compact accessible wizard recipes, verified Homebrew/package-manager
+  preparation, and release-time package checks.
+- Keep the HTTP Request body aligned with n8n's `messages` format by targeting
+  `/v1/chat/completions`; the separate OpenAI Chat Model guidance continues to
+  support the Responses API where that node exposes the switch.
+
+## [0.2.15] - 2026-08-05
+
+### Fixed
+
+- Exit cleanly when WinGet or another non-interactive validator probes the
+  portable command without arguments, while keeping the browser wizard for
+  interactive Command Prompt and PowerShell sessions.
+- Add a redirected-stdio portable smoke test so future WinGet candidates cannot
+  regress into a never-ending default launch.
+- Exclude local npm cache directories from portable release archives.
+
 ## [0.2.14] - 2026-08-04
 
 ### Added

package/README.md

@@ -72,7 +72,7 @@ installing the private n8n sidecar.
 </figure>
 
 Use the site's [Install wizard](https://relmio.vercel.app/install) page for a
-clickable macOS/Linux, PowerShell, Command Prompt, and NPX command switcher
+clickable macOS/Linux, Homebrew, PowerShell, Command Prompt, and NPX command switcher
 tailored to the current self-hosted n8n and Hostinger VPS setup path.
 
 ### Browser interface and theme modes
@@ -96,6 +96,12 @@ the VPS.
 curl -fsSL https://relmio.vercel.app/install.sh | sh
 ```
 
+### Homebrew (macOS or Linux)
+
+```bash
+brew tap Demonbane18/relmio && brew install relmio
+```
+
 ### Windows PowerShell
 
 ```powershell
@@ -120,9 +126,9 @@ the temporary runtime when the wizard closes. The Command Prompt path runs as
 the current user and does not request administrator access or change Windows
 security policy.
 
-Homebrew tap publication and WinGet catalog approval are pending. Their install
-commands will be added only after each public package passes a real
-package-manager installation test. Use a direct installer above today.
+Homebrew is available from the public `Demonbane18/relmio` tap. The WinGet
+command stays hidden until Microsoft accepts its catalog pull request and the
+catalog updates. Until then, use Homebrew or a direct installer above.
 
 Users who already have Node.js 22 or newer can run the npm package directly:
 
@@ -213,6 +219,43 @@ Add Custom Header: Off
 The `local-only` value is a placeholder required by n8n. It is not an OpenAI
 Platform API key.
 
+For an n8n **HTTP Request** node, use **Generic Credential Type** → **Bearer
+Auth**, name the credential `openai-oauth`, and enter `local-only` as the
+bearer token. Enable **Send Headers** with `Content-Type: application/json`,
+then enable **Send Body** → **JSON** → **Using JSON** and paste:
+
+```json
+{
+  "model": "gpt-5.6-sol",
+  "messages": [
+    {
+      "role": "user",
+      "content": "What is a robot?"
+    }
+  ],
+  "response_format": {
+    "type": "json_schema",
+    "json_schema": {
+      "name": "answer",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "content": { "type": "string" }
+        },
+        "required": ["content"],
+        "additionalProperties": false
+      },
+      "strict": true
+    }
+  }
+}
+```
+
+Use `POST http://n8n-openai-oauth:10531/v1/chat/completions` as the URL. The
+local wizard's **Copy HTTP request recipe** action supplies the same fields.
+Replace the model only if the wizard reports a different ID. The full guide
+has the importable cURL version.
+
 ## Important boundaries
 
 - Relmio does not create an OpenAI Platform API key.

package/docs/n8n-configuration.md

@@ -97,8 +97,9 @@ the chain.
 
 ## 3. HTTP Request node
 
-The HTTP Request recipe calls the bridge directly and does not need the n8n
-OpenAI credential.
+The HTTP Request recipe calls the bridge directly with n8n's generic Bearer
+Auth credential. It uses the Chat Completions route because the body below uses
+the `messages` format shown in the n8n node.
 
 ### Copy-paste fields
 
@@ -111,69 +112,120 @@ POST
 URL:
 
 ```text
-http://n8n-openai-oauth:10531/v1/responses
+http://n8n-openai-oauth:10531/v1/chat/completions
 ```
 
 Authentication:
 
 ```text
-None
+Generic Credential Type
 ```
 
-Header 1 name:
+Generic Auth Type:
 
 ```text
-Authorization
+Bearer Auth
 ```
 
-Header 1 value:
+Credential name:
 
 ```text
-Bearer local-only
+openai-oauth
 ```
 
-Header 2 name:
+Bearer token:
+
+```text
+local-only
+```
+
+Enable **Send Headers** and add this header:
+
+Header name:
 
 ```text
 Content-Type
 ```
 
-Header 2 value:
+Header value:
 
 ```text
 application/json
 ```
 
-JSON body:
+Enable **Send Body**, select **JSON** for **Body Content Type**, and choose
+**Using JSON** for **Specify Body**. Paste this body:
 
 ```json
 {
-  "model": "PASTE_ONE_MODEL_ID_FROM_THE_WIZARD",
-  "input": "Reply with exactly: bridge works"
+  "model": "gpt-5.6-sol",
+  "messages": [
+    {
+      "role": "user",
+      "content": "What is a robot?"
+    }
+  ],
+  "response_format": {
+    "type": "json_schema",
+    "json_schema": {
+      "name": "answer",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "content": { "type": "string" }
+        },
+        "required": ["content"],
+        "additionalProperties": false
+      },
+      "strict": true
+    }
+  }
 }
 ```
 
-Enable **Send Headers** and **Send Body**, select a JSON body, and paste the
-object above.
+If the wizard reports a different model ID, replace only `gpt-5.6-sol` with
+that detected ID. The `local-only` bearer value is a harmless n8n placeholder;
+it is not an OpenAI Platform API key.
 
 ### Importable cURL version
 
-The n8n HTTP Request node can import a cURL command. Replace only the model
-placeholder:
+The n8n HTTP Request node can import this cURL command. Replace only the model
+if the wizard reports a different ID:
 
 ```bash
 curl --request POST \
-  --url http://n8n-openai-oauth:10531/v1/responses \
+  --url http://n8n-openai-oauth:10531/v1/chat/completions \
   --header 'Authorization: Bearer local-only' \
   --header 'Content-Type: application/json' \
   --data '{
-    "model": "PASTE_ONE_MODEL_ID_FROM_THE_WIZARD",
-    "input": "Reply with exactly: bridge works"
+    "model": "gpt-5.6-sol",
+    "messages": [
+      {
+        "role": "user",
+        "content": "What is a robot?"
+      }
+    ],
+    "response_format": {
+      "type": "json_schema",
+      "json_schema": {
+        "name": "answer",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "content": { "type": "string" }
+          },
+          "required": ["content"],
+          "additionalProperties": false
+        },
+        "strict": true
+      }
+    }
   }'
 ```
 
-The placeholder header is included because it matches OpenAI-compatible
-client behavior. It is not a real API credential.
+The cURL `Authorization` header is equivalent to the n8n Bearer Auth
+credential. It is included so the command can be imported or run as a direct
+connectivity check.
 
 ### Expression-driven HTTP body
 
@@ -182,8 +234,26 @@ After the fixed test succeeds, switch the entire JSON body field to
 
 ```javascript
 ={{ {
-  model: "PASTE_ONE_MODEL_ID_FROM_THE_WIZARD",
-  input: $json.prompt
+  model: "gpt-5.6-sol",
+  messages: [
+    {
+      role: "user",
+      content: $json.prompt
+    }
+  ],
+  response_format: {
+    type: "json_schema",
+    json_schema: {
+      name: "answer",
+      schema: {
+        type: "object",
+        properties: { content: { type: "string" } },
+        required: ["content"],
+        additionalProperties: false
+      },
+      strict: true
+    }
+  }
 } }}
 ```
 

package/docs/troubleshooting.md

@@ -40,6 +40,12 @@ macOS, Linux, WSL, or Git Bash:
 curl -fsSL https://relmio.vercel.app/install.sh | sh
 ```
 
+Homebrew (macOS or Linux):
+
+```bash
+brew tap Demonbane18/relmio && brew install relmio
+```
+
 Windows PowerShell:
 
 ```powershell
@@ -59,8 +65,9 @@ temporary runtime and verifies its SHA-256 checksum before execution. The
 Command Prompt route is PowerShell-free, non-admin, and does not change Windows
 security policy.
 
-Homebrew tap publication and WinGet catalog approval are pending. Until each
-public package passes its real install test, use one of the direct bootstrap
+Homebrew is available from the public `Demonbane18/relmio` tap. The WinGet
+command stays hidden until Microsoft accepts its catalog pull request and the
+catalog updates. Until then, use Homebrew or one of the direct bootstrap
 commands on this page.
 
 If you choose the existing-Node fallback, confirm Node is version 22 or newer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relmio",
-  "version": "0.2.14",
+  "version": "0.3.0",
   "description": "Turn a supported ChatGPT/Codex OAuth sign-in into a private OpenAI-compatible endpoint, starting with self-hosted n8n.",
   "keywords": [
     "relmio",

package/src/cli.js

@@ -29,10 +29,18 @@ export function cliMode(argumentsList) {
     : "wizard";
 }
 
+export function hasInteractiveTerminal({
+  input = process.stdin,
+  output = process.stdout,
+} = {}) {
+  return Boolean(input?.isTTY && output?.isTTY);
+}
+
 export async function runCli({
   argumentsList = process.argv.slice(2),
   log = console.log,
   readPackage = () => readFile(packageJsonUrl, "utf8"),
+  isInteractive = hasInteractiveTerminal,
 } = {}) {
   if (cliMode(argumentsList) === "version") {
     const packageJson = JSON.parse(await readPackage());
@@ -43,6 +51,13 @@ export async function runCli({
     return;
   }
 
+  if (!isInteractive()) {
+    log(
+      "Relmio needs an interactive terminal to open the local wizard. Run relmio from Command Prompt, PowerShell, or another terminal.",
+    );
+    return;
+  }
+
   const sessionToken = randomBytes(32).toString("base64url");
   const wizard = await startWizardServer({ sessionToken });
   const url = `${wizard.origin}/?session=${sessionToken}`;

package/src/ui/app.js

@@ -123,8 +123,28 @@ async function copyText(value) {
 function renderHttpRequestBody(model) {
   element("result-http-body").textContent = JSON.stringify(
     {
-      model,
-      input: "Reply with exactly: bridge works",
+      model: model === "Not detected" ? "gpt-5.6-sol" : model,
+      messages: [
+        {
+          role: "user",
+          content: "What is a robot?",
+        },
+      ],
+      response_format: {
+        type: "json_schema",
+        json_schema: {
+          name: "answer",
+          schema: {
+            type: "object",
+            properties: {
+              content: { type: "string" },
+            },
+            required: ["content"],
+            additionalProperties: false,
+          },
+          strict: true,
+        },
+      },
     },
     null,
     2,
@@ -144,9 +164,16 @@ function copyHttpRecipe() {
   return [
     "Method: POST",
     `URL: ${element("result-http-url").textContent}`,
-    "Authorization: Bearer local-only",
+    "Authentication: Generic Credential Type",
+    "Generic Auth Type: Bearer Auth",
+    "Credential: openai-oauth",
+    `Bearer token: ${element("result-key").textContent}`,
+    `Authorization: ${element("result-http-auth").textContent}`,
     "Content-Type: application/json",
-    "Authentication: None",
+    "Send Headers: On",
+    "Send Body: On",
+    "Body Content Type: JSON",
+    "Specify Body: Using JSON",
     "JSON body:",
     element("result-http-body").textContent,
   ].join("\n");
@@ -598,7 +625,7 @@ element("install-button").addEventListener("click", async (event) => {
     element("result-model").textContent = firstModel;
     element("result-models").textContent = result.models.join(", ");
     element("result-http-url").textContent =
-      `${result.baseUrl.replace(/\/$/u, "")}/responses`;
+      `${result.baseUrl.replace(/\/$/u, "")}/chat/completions`;
     renderHttpRequestBody(firstModel);
     showStep(5);
     setMessage(

package/src/ui/index.html

@@ -488,7 +488,7 @@
               <div>
                 <dt>URL</dt>
                 <dd class="result-value">
-                  <code id="result-http-url">http://n8n-openai-oauth:10531/v1/responses</code>
+                  <code id="result-http-url">http://n8n-openai-oauth:10531/v1/chat/completions</code>
                   <button
                     class="button secondary copy-value"
                     type="button"
@@ -501,16 +501,43 @@
                 </dd>
               </div>
               <div>
-                <dt>Authorization</dt>
-                <dd><code>Bearer local-only</code></dd>
+                <dt>Authentication</dt>
+                <dd>Generic Credential Type</dd>
+              </div>
+              <div>
+                <dt>Generic Auth Type</dt>
+                <dd>Bearer Auth</dd>
+              </div>
+              <div>
+                <dt>Credential</dt>
+                <dd><code>openai-oauth</code></dd>
+              </div>
+              <div>
+                <dt>Bearer token</dt>
+                <dd><code>local-only</code></dd>
+              </div>
+              <div>
+                <dt>Authorization header</dt>
+                <dd class="result-value">
+                  <code id="result-http-auth">Bearer local-only</code>
+                  <button
+                    class="button secondary copy-value"
+                    type="button"
+                    data-copy-target="result-http-auth"
+                    data-copy-label="Authorization header"
+                    aria-label="Copy Authorization header"
+                  >
+                    Copy
+                  </button>
+                </dd>
               </div>
               <div>
                 <dt>Content-Type</dt>
                 <dd><code>application/json</code></dd>
               </div>
               <div>
-                <dt>Authentication</dt>
-                <dd>None</dd>
+                <dt>Send body</dt>
+                <dd>On · JSON · Using JSON</dd>
               </div>
               <div class="sample-body-row">
                 <dt>JSON body</dt>