App attribution headers don't work

[MasterIO02]

The OpenRouter API docs says to use:

const openRouter = new OpenRouter({
  apiKey: '<OPENROUTER_API_KEY>',
  defaultHeaders: {
    'HTTP-Referer': 'https://myapp.com', // Your app's URL
    'X-Title': 'My AI Assistant', // Your app's display name
  },
});

but defaultHeaders doesn't exist in type SDKOptions.

There are the "xTitle" and "httpReferer" parameters instead, but they aren't working. I don't see them going anywhere in the SDK code.

The AI-generated request code, like in src/funcs/completionsGenerate.ts, doesn't include the HTTP-Referer and X-Title headers.

[srivtx]

Root Cause Found

I investigated this issue and found the root cause.

What's Configured

The overlay at .speakeasy/overlays/add-headers.overlay.yaml correctly defines x-speakeasy-globals with:

• AppIdentifier → HTTP-Referer header
• AppDisplayName → X-Title header

This generates the httpReferer and xTitle options in SDKOptions and environment variable support (OPENROUTER_HTTP_REFERER, OPENROUTER_X_TITLE).

The Problem

For Speakeasy to actually inject these headers into HTTP requests, each operation must explicitly reference these parameters. Currently, operations like /chat/completions and /completions don't include:

parameters:
  - $ref: '#/components/parameters/AppIdentifier'
  - $ref: '#/components/parameters/AppDisplayName'

const headers = new Headers(compactMap({
  "Content-Type": "application/json",
  Accept: "application/json",
}));

# Example for chat completions
- target: $.paths['/chat/completions'].post
  description: Add app identification headers
  update:
    parameters:
      - $ref: '#/components/parameters/AppIdentifier'
      - $ref: '#/components/parameters/AppDisplayName'