@respira/wordpress-mcp-server 8.2.10 → 8.3.0

package/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to Respira WordPress MCP Server will be documented in this f
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [8.3.0] - 2026-08-13
+
+### Added
+
+- **A site can now hold one design direction, and every builder obeys it.** Nine new tools. `wordpress_save_design_direction`, `wordpress_get_design_direction`, `wordpress_list_design_directions`, `wordpress_activate_design_direction` and `wordpress_delete_design_direction` manage the direction itself: palette, font pairs, spacing, and plain-language guidance including the don'ts, saved on the site with real revisions. Activation refuses a direction that lacks the minimum to be real (background, ink, accent, a font pair) and names exactly which paths are missing. Values the agent inferred rather than found stay marked as inferred until confirmed.
+- **`wordpress_import_design_tokens`** reads DTCG 2025.10, Tokens Studio exports, Tailwind configs, or a plain `:root` CSS block into the direction. Dry-run by default, so what would change is visible before anything is written.
+- **`wordpress_apply_design_direction`** pushes the direction's tokens into each builder's own stores: Bricks global colors, the Elementor kit, Oxygen variables, nine builders in all. Approval-gated, with a per-builder report of what was written where. **`wordpress_export_design_direction`** returns strict DTCG, so a direction is portable, never captive.
+- **`wordpress_check_design`** reads what a build produced and says whether it is done. Nine deterministic rules: colors and fonts outside the direction, filler copy, placeholder names, the familiar AI tells, and probes generated from the direction's own don'ts, each citing the line it enforces. Waivers set on the direction are honored and stay visible in the result. The response also lists what cannot be judged without seeing the rendered page, rather than pretending a text scan saw it.
+
+### Changed
+
+- **Page builds stop treating the direction as advisory.** `build_page` resolves hardcoded values against the active direction and reports anything that fell outside it, and the build skills run `wordpress_check_design` before calling a page finished.
+
+## [8.2.11] - 2026-08-12
+
+### Fixed
+
+- **A leftover config file could beat the credentials in your client entry, silently.** `~/.respira/config.json` outranks `WORDPRESS_URL` and `WORDPRESS_API_KEY`, which is deliberate: an explicit file is the more considered of the two. Doing it without saying so was not. A customer followed setup instructions to add those variables to his VS Code entry, still had a config.json from an earlier attempt, and got a connector that started cleanly, listed its tools, and talked to a site he had not chosen. Nothing on screen connected the symptom to the cause, and he spent a week on it. When both are present the server now names the address it is ignoring, the address it is using, and how to change which one wins. A setup with only one source of credentials stays silent.
+- **Six builders made `get_page_outline` unroutable on every site that used them.** Display names with spaces were being sent where route slugs belong.
+
+### Changed
+
+- **A site that cannot be found now says which config the server actually read.** `RESPIRA_CONFIG_B64`, `RESPIRA_CONFIG_FILE`, or the default file, named in the error, because "site not found" is unactionable when three sources can supply it.
+- **`claude mcp add` now suggests `-s user`,** so a connection follows the machine rather than the folder it was created in.
+
 ## [8.2.10] - 2026-08-12
 
 ### Fixed

package/README.md

@@ -7,7 +7,7 @@
 <h1 align="center">Respira WordPress MCP Server</h1>
 
 <p align="center">
-  <strong>198 MCP tools, 303 with the WooCommerce add-on. 17 page builders and the native Site Editor. MCP 2026-07-28 with legacy-client support.</strong><br>
+  <strong>210 MCP tools, 315 with the WooCommerce add-on. 17 page builders and the native Site Editor. MCP 2026-07-28 with legacy-client support.</strong><br>
   Element-level editing, full page creation, HTML-to-builder conversion with rendering fidelity validation, per-site tool governance, storefront design intelligence, stock images, bulk operations — all through one MCP server.
 </p>
 
@@ -132,7 +132,7 @@ Every successful tool response includes `structuredContent`, the raw JSON object
 
 ### v6.0 "Storefront" — Context-Aware Tool Filtering
 
-The MCP server exposes 198 core tools and 103 WooCommerce add-on tools. It automatically filters the list based on the site's detected builder and active plugins, so clients receive only the useful subset. Fail-open: if detection fails, the full list is returned.
+The MCP server exposes 210 core tools and 105 WooCommerce add-on tools. It automatically filters the list based on the site's detected builder and active plugins, so clients receive only the useful subset. Fail-open: if detection fails, the full list is returned.
 
 | Capability | Respira | Typical WordPress MCP servers |
 |---|---|---|
@@ -279,7 +279,7 @@ Unknown tool names now return a proper `CallToolResult` with `isError: true` and
 ## v6.0 "Storefront" — What's New
 
 ### Context-Aware Tool Filtering
-The MCP server automatically filters its 198 core and 103 WooCommerce tools based on the site's detected builder and active plugins. Less noise, faster AI responses, lower token usage. Fail-open: if detection fails, the full list is returned.
+The MCP server automatically filters its 210 core and 105 WooCommerce tools based on the site's detected builder and active plugins. Less noise, faster AI responses, lower token usage. Fail-open: if detection fails, the full list is returned.
 
 ### Flatsome UX Builder (Builder #12)
 Full round-trip shortcode editing, element-level precision, declarative page creation, and 55-element intelligence. Detected by active theme — mixed-builder sites handled per-page.
@@ -390,6 +390,26 @@ These are Respira-native WordPress operations, not a copied generic tool catalog
 | `wordpress_update_site_navigation` | Target one link/submenu while preserving unknown extension blocks |
 | `wordpress_delete_site_navigation` | Delete through approval; referenced navigation is refused by default |
 
+### Design Direction (9 tools)
+
+One saved design direction per site — identity, DTCG-subset tokens, dials, guidance, waivers — that agents read before building anything. Readiness is computed on every response: `ready` needs the bg + ink + accent color roles plus a heading/body font pair, and activation refuses a direction that is not ready. The direction document is site data, not instructions.
+
+The token standard lane: import any token format (DTCG 2025.10 lenient, Tokens Studio, Tailwind, pasted `:root{}` CSS) into a draft, activate once ready, apply into the builder's NATIVE token store, export as strict DTCG 2025.10 with per-builder mapping metadata under `$extensions["press.respira"]`.
+
+The design check closes the loop: `wordpress_check_design` runs deterministic slop-and-drift rules (no rendering) against draft content or a saved post, honors the direction's waivers, and lists what only the planned rendered check can verify — run it after building, before treating the work as done.
+
+| Tool | Description |
+|---|---|
+| `wordpress_get_design_direction` | Read the active direction (or one by id) with computed readiness |
+| `wordpress_list_design_directions` | List saved directions with readiness and the active flag |
+| `wordpress_save_design_direction` | Save or update a schema-validated DRAFT; response reports readiness |
+| `wordpress_activate_design_direction` | Activate through approval; refuses a not-ready direction |
+| `wordpress_delete_design_direction` | Trash through approval; clears the active pointer if needed |
+| `wordpress_import_design_tokens` | Import DTCG / Tokens Studio / Tailwind / CSS tokens into a draft; dry-run by default, returns the readiness delta, never activates |
+| `wordpress_apply_design_direction` | Push the direction's tokens into the resolved builder's native store through approval; snapshot first, per-builder report persisted |
+| `wordpress_export_design_direction` | Export strict DTCG 2025.10 with roles + per-builder apply reports in `$extensions["press.respira"]` |
+| `wordpress_check_design` | Read-only deterministic design check: off-palette colors/fonts vs the direction, filler copy, placeholder names, AI-default palettes, triggered donts; run after building, before done |
+
 ### Bricks Deep Intelligence (20 tools) — NEW in v5.4
 | Tool | Description |
 |---|---|
@@ -824,6 +844,6 @@ MIT © [Respira](https://respira.press)
 ---
 
 <p align="center">
-  <strong>198 core tools, 303 with WooCommerce. 17 builders. The AI infrastructure layer for WordPress.</strong><br>
+  <strong>210 core tools, 315 with WooCommerce. 17 builders. The AI infrastructure layer for WordPress.</strong><br>
   <a href="https://respira.press">respira.press</a>
 </p>

package/TOOL_CATALOG.md

@@ -2,7 +2,7 @@
 
 <!-- Generated by scripts/check-tool-registry-parity.mjs. Do not edit by hand. -->
 
-Generated catalog: **174 core tools**, **105 WooCommerce tools**, **279 total**.
+Generated catalog: **183 core tools**, **105 WooCommerce tools**, **288 total**.
 
 The runtime applies site context and per-site governance, so an individual connection may expose a smaller relevant subset.
 
@@ -10,6 +10,7 @@ The runtime applies site context and per-site governance, so an individual conne
 
 - `respira_duplicate_with_translations` — write; hosted/stdio
 - `wordpress_abilities_gap_report` — read; hosted/stdio
+- `wordpress_activate_design_direction` — write; native + hosted
 - `wordpress_activate_plugin` — write; native + hosted
 - `wordpress_analyze_aeo` — read; native + hosted
 - `wordpress_analyze_images` — read; native + hosted
@@ -21,12 +22,14 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_append_theme_file` — read; hosted/stdio
 - `wordpress_apply_accessibility_fixes` — write; hosted/stdio
 - `wordpress_apply_builder_patch` — write; native + hosted
+- `wordpress_apply_design_direction` — write; native + hosted
 - `wordpress_assign_menu_location` — write; native + hosted
 - `wordpress_batch_update` — write; native + hosted
 - `wordpress_begin_session` — read; hosted/stdio
 - `wordpress_build_mega_menu` — write; native + hosted
 - `wordpress_build_page` — write; native + hosted
 - `wordpress_bulk_pages_operation` — write; native + hosted
+- `wordpress_check_design` — read; native + hosted
 - `wordpress_check_seo_issues` — read; native + hosted
 - `wordpress_check_structured_data` — read; native + hosted
 - `wordpress_convert_html_to_builder` — write; native + hosted
@@ -52,6 +55,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_delete_acf_field_group` — write; hosted/stdio
 - `wordpress_delete_comment` — write; native + hosted
 - `wordpress_delete_custom_post` — write; native + hosted
+- `wordpress_delete_design_direction` — write; native + hosted
 - `wordpress_delete_design_token` — write; native + hosted
 - `wordpress_delete_media` — write; native + hosted
 - `wordpress_delete_menu` — write; native + hosted
@@ -71,6 +75,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_diff_snapshots` — read; native + hosted
 - `wordpress_duplicate_element` — write; native + hosted
 - `wordpress_end_session` — read; hosted/stdio
+- `wordpress_export_design_direction` — read; native + hosted
 - `wordpress_extract_builder_content` — read; native + hosted
 - `wordpress_find_builder_targets` — read; native + hosted
 - `wordpress_find_element` — read; native + hosted
@@ -83,6 +88,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_get_comment` — read; native + hosted
 - `wordpress_get_core_web_vitals` — read; native + hosted
 - `wordpress_get_custom_post` — read; native + hosted
+- `wordpress_get_design_direction` — read; native + hosted
 - `wordpress_get_divi_migration_readiness` — read; hosted/stdio
 - `wordpress_get_media` — read; native + hosted
 - `wordpress_get_menu` — read; native + hosted
@@ -102,6 +108,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_get_theme_docs` — read; native + hosted
 - `wordpress_get_translations` — read; native + hosted
 - `wordpress_get_user` — read; native + hosted
+- `wordpress_import_design_tokens` — write; native + hosted
 - `wordpress_inject_builder_content` — write; native + hosted
 - `wordpress_install_plugin` — write; native + hosted
 - `wordpress_invoke_ability` — write; hosted/stdio
@@ -112,6 +119,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_list_custom_post_types` — read; hosted/stdio
 - `wordpress_list_custom_posts` — read; native + hosted
 - `wordpress_list_custom_taxonomies` — read; hosted/stdio
+- `wordpress_list_design_directions` — read; native + hosted
 - `wordpress_list_design_tokens` — read; native + hosted
 - `wordpress_list_media` — read; native + hosted
 - `wordpress_list_memory` — read; native + hosted
@@ -148,6 +156,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_restore_snapshot` — write; native + hosted
 - `wordpress_run_pagespeed_audit` — read; hosted/stdio
 - `wordpress_run_security_audit` — read; native + hosted
+- `wordpress_save_design_direction` — write; native + hosted
 - `wordpress_scan_page_accessibility` — read; hosted/stdio
 - `wordpress_search_abilities` — read; native + hosted
 - `wordpress_search_docs` — read; hosted/stdio

package/dist/__tests__/builder-slug-path.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=builder-slug-path.test.d.ts.map

package/dist/__tests__/builder-slug-path.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-slug-path.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/builder-slug-path.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/builder-slug-path.test.js

@@ -0,0 +1,70 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import axios from 'axios';
+import { WordPressClient } from '../wordpress-client.js';
+// The REST routes are /builder/(?P<builder>[a-zA-Z0-9_-]+)/..., which cannot
+// express a space, but builder-info reports DISPLAY names and six adapters have
+// one. Auto-detect lowercased the display name straight into the path, so on
+// those sites the URL was unroutable and the agent was told "No route was found
+// matching the URL and request method". Verified live against WordPress before
+// the fix:
+//   /builder/beaver/outline/2       -> 401 (route matched, key missing)
+//   /builder/beaver%20builder/...   -> 404 rest_no_route
+//
+// Asserted on the URL that actually goes on the wire, not on the private
+// helper, so this keeps holding if the normalisation moves.
+async function outlineUrlFor(displayName) {
+    const saved = axios.defaults.adapter;
+    const seen = [];
+    try {
+        axios.defaults.adapter = ((config) => {
+            const url = config.url || '';
+            const full = url.startsWith('http') ? url : `${config.baseURL || ''}${url}`;
+            seen.push(full);
+            const json = (data) => Promise.resolve({
+                status: 200, statusText: 'OK', headers: { 'content-type': 'application/json' },
+                config, data, request: {},
+            });
+            if (/context\/builder-info/.test(full)) {
+                return json({ active_builder: { name: displayName, version: '1.0' }, builders: {} });
+            }
+            if (/\/status/.test(full))
+                return json({ ok: true });
+            return json({ rows: [] });
+        });
+        const client = new WordPressClient({ name: 't', url: 'https://example.com', apiKey: 'k' });
+        await client.getPageOutline('', 42);
+        return seen.find((u) => u.includes('/outline/')) || '';
+    }
+    finally {
+        axios.defaults.adapter = saved;
+    }
+}
+test('a display name with a space becomes a routable slug on the wire', async () => {
+    const url = await outlineUrlFor('Beaver Builder');
+    assert.ok(url.includes('/builder/beaver/outline/42'), `got: ${url}`);
+    assert.ok(!/%20|\s/.test(url), `URL must not carry a space: ${url}`);
+});
+test('every spaced display name produces a segment the route can match', async () => {
+    const cases = [
+        ['Beaver Builder', 'beaver'],
+        ['Flatsome UX Builder', 'flatsome'],
+        ['Kadence Blocks', 'kadence'],
+        ['Oxygen 6', 'oxygen6'],
+        ['Thrive Architect', 'thrive'],
+        ['Visual Composer', 'visual-composer'],
+    ];
+    for (const [name, expected] of cases) {
+        const url = await outlineUrlFor(name);
+        assert.ok(url.includes(`/builder/${expected}/outline/42`), `${name} -> ${url}`);
+        const segment = (url.match(/\/builder\/([^/]+)\/outline\//) || [])[1] || '';
+        assert.match(segment, /^[a-zA-Z0-9_-]+$/, `${name} produced an unroutable segment: ${segment}`);
+    }
+});
+test('single-word names still pass through unchanged', async () => {
+    for (const name of ['Divi', 'Elementor', 'Bricks', 'Gutenberg']) {
+        const url = await outlineUrlFor(name);
+        assert.ok(url.includes(`/builder/${name.toLowerCase()}/outline/42`), `${name} -> ${url}`);
+    }
+});
+//# sourceMappingURL=builder-slug-path.test.js.map

package/dist/__tests__/builder-slug-path.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-slug-path.test.js","sourceRoot":"","sources":["../../src/__tests__/builder-slug-path.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/config-origin-in-errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-origin-in-errors.test.d.ts.map

package/dist/__tests__/config-origin-in-errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-origin-in-errors.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/config-origin-in-errors.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config-origin-in-errors.test.js

@@ -0,0 +1,64 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { describeConfigOrigin } from '../config.js';
+// "Site not found. Available: env-site" is true and useless: the question is
+// which config the process read. A workspace .mcp.json or a RESPIRA_CONFIG_B64
+// in the client entry silently outranks the file someone just edited. 703
+// respira_site_id_not_found events, and an hour lost on this repo.
+const withEnv = (env, fn) => {
+    const saved = {};
+    for (const k of Object.keys(env)) {
+        saved[k] = process.env[k];
+        if (env[k] === undefined)
+            delete process.env[k];
+        else
+            process.env[k] = env[k];
+    }
+    try {
+        fn();
+    }
+    finally {
+        for (const k of Object.keys(saved)) {
+            if (saved[k] === undefined)
+                delete process.env[k];
+            else
+                process.env[k] = saved[k];
+        }
+    }
+};
+test('names the env variable when RESPIRA_CONFIG_B64 is what won', () => {
+    withEnv({ RESPIRA_CONFIG_B64: 'e30=', RESPIRA_CONFIG_FILE: undefined }, () => {
+        const s = describeConfigOrigin();
+        assert.match(s, /RESPIRA_CONFIG_B64/);
+        assert.match(s, /overrides any config file/i);
+        assert.match(s, /restarted/i, 'must say a restart is needed, or the fix looks like it did not work');
+    });
+});
+test('names the explicit file path when RESPIRA_CONFIG_FILE is what won', () => {
+    withEnv({ RESPIRA_CONFIG_B64: undefined, RESPIRA_CONFIG_FILE: '/tmp/some-config.json' }, () => {
+        const s = describeConfigOrigin();
+        assert.match(s, /RESPIRA_CONFIG_FILE/);
+        assert.ok(s.includes('/tmp/some-config.json'), `must name the path: ${s}`);
+    });
+});
+test('names the default path, and warns the env var may be overriding it', () => {
+    withEnv({ RESPIRA_CONFIG_B64: undefined, RESPIRA_CONFIG_FILE: undefined }, () => {
+        const s = describeConfigOrigin();
+        assert.match(s, /config\.json/);
+        assert.match(s, /RESPIRA_CONFIG_B64/, 'the default case must point at the thing that outranks it');
+    });
+});
+test('always actionable: never an empty or bare sentence', () => {
+    for (const env of [
+        { RESPIRA_CONFIG_B64: 'e30=', RESPIRA_CONFIG_FILE: undefined },
+        { RESPIRA_CONFIG_B64: undefined, RESPIRA_CONFIG_FILE: '/x/y.json' },
+        { RESPIRA_CONFIG_B64: undefined, RESPIRA_CONFIG_FILE: undefined },
+    ]) {
+        withEnv(env, () => {
+            const s = describeConfigOrigin();
+            assert.ok(s.length > 60, `too terse to help: ${s}`);
+            assert.match(s, /read its sites from/);
+        });
+    }
+});
+//# sourceMappingURL=config-origin-in-errors.test.js.map

package/dist/__tests__/config-origin-in-errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-origin-in-errors.test.js","sourceRoot":"","sources":["../../src/__tests__/config-origin-in-errors.test.ts"],"names":[],"mappings":"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"}

package/dist/agent-signature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-signature.d.ts","sourceRoot":"","sources":["../src/agent-signature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;CACzD;AAkCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAQvE;AAwGD,wBAAgB,2BAA2B,IAAI,qBAAqB,CA4BnE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa/D"}
+{"version":3,"file":"agent-signature.d.ts","sourceRoot":"","sources":["../src/agent-signature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;CACzD;AAkCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAQvE;AAgHD,wBAAgB,2BAA2B,IAAI,qBAAqB,CA4BnE;AAiBD,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB/D"}

package/dist/agent-signature.js

@@ -115,6 +115,14 @@ function detectClientFromHeuristics() {
         return 'cowork';
     if (fingerprint.includes('cursor'))
         return 'cursor';
+    // claude-code is a RUNTIME, not a place. The same bucket covers a bare
+    // terminal, the IDE extension, and per-workspace tools like Conductor, whose
+    // config story is completely different (there, every workspace is its own
+    // directory, so a locally-scoped `claude mcp add` connects one and not the
+    // next). CLAUDE_CODE_ENTRYPOINT already distinguishes them and we were
+    // throwing it away, which is why "558 sites on claude-code" could not answer
+    // any question about setup. Keep the bucket stable for continuity and carry
+    // the entrypoint alongside it.
     if (process.env.CLAUDECODE || process.env.CLAUDE_CODE_ENTRYPOINT)
         return 'claude-code';
     if (parentCommand.includes('claude.app') || parentCommand.includes('claude.exe') ||
@@ -184,6 +192,22 @@ export function detectRespiraAgentSignature() {
         source: explicitClient ? 'env' : client === 'unknown' ? 'default' : 'heuristic',
     };
 }
+/**
+ * Where the Claude Code runtime is running: `cli`, the IDE extension, and so
+ * on. Claude Code is a runtime rather than a place, and the setup story differs by
+ * host: a per-workspace tool gives every workspace its own directory, so a
+ * locally-scoped `claude mcp add` connects one and not the next. Without this,
+ * every one of those hosts collapses into a single bucket and no question
+ * about setup can be answered from telemetry. Env value only, never a path.
+ */
+function detectAgentSurface() {
+    const entry = sanitizeHeaderToken(process.env.CLAUDE_CODE_ENTRYPOINT);
+    if (entry)
+        return entry;
+    if (process.env.CLAUDECODE)
+        return 'cli';
+    return null;
+}
 export function getRespiraAgentHeaders() {
     const signature = detectRespiraAgentSignature();
     const headers = {
@@ -191,6 +215,10 @@ export function getRespiraAgentHeaders() {
         'X-Respira-Agent-Transport': signature.transport,
         'X-Respira-Agent-Source': signature.source,
     };
+    const surface = detectAgentSurface();
+    if (surface) {
+        headers['X-Respira-Agent-Surface'] = surface;
+    }
     if (signature.version) {
         headers['X-Respira-Agent-Version'] = signature.version;
     }

package/dist/agent-signature.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-signature.js","sourceRoot":"","sources":["../src/agent-signature.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-signature.js","sourceRoot":"","sources":["../src/agent-signature.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -135,22 +135,7 @@ export declare function setDefaultSite(siteId: string): void;
  * Test connection to a WordPress site
  */
 export declare function testConnection(siteId: string): Promise<void>;
-/**
- * Describe the configuration this process is ACTUALLY running on.
- *
- * Resolution order is RESPIRA_CONFIG_B64, then RESPIRA_CONFIG_FILE, then
- * ~/.respira/config.json. Only the winner matters, and until now nothing
- * reported which one won. That gap is the common factor behind three separate
- * customer incidents whose mechanisms were all different: a redeem that wrote a
- * file an env var was already overriding, a Desktop bundle installed alongside
- * an older npx entry that kept winning, and a licence lapse that left the keys
- * in the winning config dead.
- *
- * Deliberately reports the config PATH but never the tokens. A customer pastes
- * this output into a support thread.
- *
- * @param sites Sites the running server actually resolved.
- */
+export declare function describeConfigOrigin(): string;
 export declare function describeEffectiveConfig(sites: Array<{
     id?: string;
     url?: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -580,6 +580,13 @@ export function loadConfig() {
             // A real config file wins, but the first-run placeholder must not shadow
             // real WORDPRESS_URL / RESPIRA_* / --wordpress-url credentials set below.
             if (!isPlaceholderConfig(fileConfig)) {
+                // Say so when the file is quietly beating credentials the user set in
+                // their client entry. Silence here reads as "the env block is wrong":
+                // a customer spent a week on a VS Code connector that started cleanly
+                // and talked to nothing, because a config.json left over from an
+                // earlier attempt outranked the WORDPRESS_URL he had just been told to
+                // add. The precedence is deliberate; hiding it is not.
+                warnIfFileShadowsEnvCredentials(CONFIG_FILE, fileConfig);
                 return fileConfig;
             }
         }
@@ -703,6 +710,62 @@ export async function testConnection(siteId) {
  *
  * @param sites Sites the running server actually resolved.
  */
+/**
+ * One sentence naming the config this process actually read, for errors.
+ *
+ * describeEffectiveConfig returns the full structured picture, but it only ever
+ * surfaced inside diagnose_connection. The moment people are confused is the
+ * moment a site id does not resolve, and there the message was "not found.
+ * Available: env-site" — true, and useless, because the real question is WHICH
+ * config won. A workspace `.mcp.json`, or a RESPIRA_CONFIG_B64 pasted into the
+ * client entry, silently outranks the file the operator just edited, and
+ * nothing said so.
+ *
+ * That is 703 respira_site_id_not_found events in telemetry, and it cost this
+ * project an hour today when a workspace `.mcp.json` pinned the server to
+ * env-mode and hid a multi-site config that was sitting right there.
+ */
+/**
+ * Warn when ~/.respira/config.json outranks credentials set in the client entry.
+ *
+ * The precedence is intentional: an explicit file is the more deliberate of the
+ * two. What was not intentional is doing it silently. A user who has just been
+ * told to add WORDPRESS_URL and WORDPRESS_API_KEY to their MCP client, and who
+ * still has a config.json from an earlier attempt, gets a server that starts
+ * cleanly, lists its tools, and reaches a site they did not choose. There is
+ * nothing on screen connecting the symptom to the cause.
+ *
+ * Only fires when BOTH are present, so a normal single-source setup stays quiet.
+ *
+ * @param filePath The config file that won.
+ * @param fileConfig What it resolved to, used to name the site actually in use.
+ */
+function warnIfFileShadowsEnvCredentials(filePath, fileConfig) {
+    const envUrl = (process.env.WORDPRESS_URL || process.env.RESPIRA_URL || '').trim();
+    const envKey = (process.env.WORDPRESS_API_KEY || process.env.RESPIRA_API_KEY || '').trim();
+    if (!envUrl || !envKey)
+        return;
+    const inUse = fileConfig.sites?.[0]?.url || 'the site in that file';
+    const which = process.env.WORDPRESS_URL ? 'WORDPRESS_URL' : 'RESPIRA_URL';
+    console.error(`Warning: ${which} is set to ${envUrl}, but ${filePath} exists and takes precedence, ` +
+        `so Respira is using ${inUse} instead. ` +
+        `Delete or rename that file to use the address from your client entry, ` +
+        `or edit the file to point at the site you want.`);
+}
+export function describeConfigOrigin() {
+    const b64 = process.env.RESPIRA_CONFIG_B64?.trim();
+    const explicitFile = process.env.RESPIRA_CONFIG_FILE?.trim();
+    if (b64) {
+        return ('This server read its sites from the RESPIRA_CONFIG_B64 environment variable, ' +
+            'set in your MCP client entry, which overrides any config file on disk. ' +
+            'If you expected a different set of sites, that variable is what to change, ' +
+            'and the client has to be restarted afterwards.');
+    }
+    if (explicitFile) {
+        return `This server read its sites from RESPIRA_CONFIG_FILE (${expandHomePath(explicitFile)}). If you edited a different file, this is the one in effect.`;
+    }
+    return `This server read its sites from ${expandHomePath('~/.respira/config.json')}. If you edited a different file, or set RESPIRA_CONFIG_B64 in your client entry, this is not the config in effect.`;
+}
 export function describeEffectiveConfig(sites) {
     const b64 = process.env.RESPIRA_CONFIG_B64?.trim();
     const explicitFile = process.env.RESPIRA_CONFIG_FILE?.trim();