@thalovant/mcp-server 0.4.1 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.5.1 — 2026-09-13
+
+- Expose advisory reply claim status and first-seen pipeline/skill identifiers, with shared conformance for fallback, mixed stages, legacy hubs and malformed stamps. Existing reply construction remains compatible.
+
+## 0.5.0 — 2026-09-13
+
+- Use Node SDK 0.7.0 inventory models and Python-compatible question detection.
+- Add an inventory `presentation` view with derived skill titles, explicit phrase-language order, and unknown catalog metadata preserved.
+- Gate PRs and publication on the shared SDK acceptance contract and check for drift every six hours.
+
 ## 0.4.1 — 2026-09-12
 
 - Use Node SDK 0.6.1 with thalovant-languages 0.2.1 listing data, matching Python 0.6.8 across 270 languages.

package/README.md

@@ -393,6 +393,14 @@ adds at most 1500ms. A silent listing can use engine manifests; disable this wit
 per-principal policy. `thalovant_get_operation` reads an operation ID returned by
 provisioning without replaying the write.
 
+The additive `presentation` object contains the shared SDK inventory shape:
+`cache_version`, `hub_id`, `hub_name`, `source`, `generated_at`, `skills`, `notes`,
+and `languages_present`. Skill titles are derived from IDs. Runtime discovery
+cannot prove catalog locales or hub display metadata, so those fields remain
+unknown (empty lists/strings), with explanatory notes. Intent language order is
+explicit and survives JSON key sorting. Each tool call retains its own identity
+lease; the server does not persist inventory or share a session across callers.
+
 ## Request hints, embedded audio, and configuration merging
 
 `thalovant_ask` accepts `sttLang`, an ordered `pipeline`, and `location`
@@ -464,7 +472,7 @@ Runtime calls sharing the same hub client identity run sequentially within one
 MCP process. Use a distinct client identity for each independently running MCP
 server so the hub can keep their sessions separate.
 
-Version 0.4.1 requires `@thalovant/sdk` `^0.6.1` (0.6.1 through versions below 0.7.0). This release enforces
+Version 0.5.1 requires `@thalovant/sdk` `^0.7.1` (0.7.1 through versions below 0.8.0). This release enforces
 secure effective MQTT URLs and carries a single connection deadline through
 MQTT setup and HTTP failure cleanup. Runtime tools support
 HiveMind v3 Noise over WSS, HTTPS and MQTT over TLS. `thalovant_healthcheck`
@@ -569,7 +577,7 @@ The CLI handles SIGTERM and SIGINT in stdio and HTTP modes, including when it
 runs as the container's PID 1. It closes sessions and HTTP connections before a
 successful exit, with a ten-second failure deadline for stalled cleanup.
 
-Version 0.4.1 uses Node SDK 0.6.1 and the same 270-language listing data as
-Python 0.6.8. With `sentence: true`, Spanish questions receive their question
+Version 0.5.1 uses Node SDK 0.7.1 with Python 0.7.4-compatible inventory
+and question detection, including Unicode question marks and omitted-language patterns. With `sentence: true`, Spanish questions receive their question
 mark and complete French phrases keep their final period. Undescribed
 languages remain bare.

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { inventoryPresentation } from "./inventory-output.js";
 import { runtimeReplyContent } from "./reply-output.js";
 import { throwIfRuntimeCancelled, withRuntimeLease } from "./runtime-lease.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -1361,6 +1362,7 @@ export function createServer() {
         const inventory = await client.intents(languages, { describe, fallback, timeoutMs: clampTimeout(timeoutMs) });
         return jsonContent(redactSecrets({
             ...inventory.asObject(),
+            presentation: inventoryPresentation(inventory),
             examples: inventory.intents.map(intent => ({ id: intent.id,
                 languages: Object.fromEntries(inventory.languages.map(lang => [lang, intent.examples(lang, exampleLimit, { speakable, sentence, slots })])),
             })),

package/dist/inventory-output.d.ts

@@ -0,0 +1,12 @@
+import type { HubIntentInventory } from "@thalovant/sdk";
+/** Add a display view without claiming catalogue metadata from runtime phrases. */
+export declare function inventoryPresentation(runtime: HubIntentInventory, generatedAt?: string): {
+    languages_present: string[];
+    cache_version: number;
+    hub_id: string;
+    hub_name: string;
+    source: string;
+    generated_at: string;
+    notes: string[];
+    skills: import("@thalovant/sdk").InventorySkillData[];
+};

package/dist/inventory-output.js

@@ -0,0 +1,12 @@
+import { Inventory, Intent, Skill, friendlyTitle, languagesPresent } from "@thalovant/sdk";
+/** Add a display view without claiming catalogue metadata from runtime phrases. */
+export function inventoryPresentation(runtime, generatedAt = new Date().toISOString()) {
+    const notes = [
+        "Skill titles are derived from IDs; catalogue locales and hub metadata are unknown.",
+        `Runtime discovery source: ${runtime.source}.`,
+        ...runtime.denied.map(query => `Query refused or unanswered: ${query}.`),
+        ...(!runtime.fallbacksKnown ? ["Fallback skill support is unknown."] : []),
+    ];
+    const inventory = new Inventory("", "", "hub", generatedAt, runtime.skills.map(skill => new Skill(skill.skillId, friendlyTitle(skill.skillId), [], skill.intents.map(intent => new Intent(intent.id, intent.name, intent.skillId, intent.engine, intent.phrases, intent.languages)))), notes);
+    return { ...inventory.asObject(), languages_present: languagesPresent(inventory) };
+}

package/dist/reply-output.d.ts

@@ -29,6 +29,9 @@ export declare function runtimeReplyContent(reply: ThalovantReply, includeAudio?
                 [x: string]: unknown;
             };
         } | undefined;
+        pipelineIds: string[];
+        skillIds: string[];
+        claimed: boolean;
     };
     clips: ({
         type: "audio";

package/dist/reply-output.js

@@ -1,3 +1,4 @@
+import { replyClaimMetadata } from "@thalovant/sdk";
 import { createHash } from "node:crypto";
 function eventSummary(event) {
     const { binary_data: _encoded, ...data } = event.data;
@@ -31,6 +32,7 @@ export function runtimeReplyContent(reply, includeAudio = false) {
         return output;
     });
     return { summary: {
+            ...replyClaimMetadata(reply),
             text: reply.text, displayText: reply.displayText, utterances: reply.utterances,
             handled: reply.handled, ok: reply.ok, sessionId: reply.sessionId, requestId: reply.requestId,
             lang: reply.lang, hasAudio: reply.hasAudio ?? false, droppedMedia: reply.droppedMedia ?? 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thalovant/mcp-server",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Stdio and Streamable HTTP MCP server for Thalovant control-plane and hub runtime APIs.",
   "license": "MIT",
   "type": "module",
@@ -64,7 +64,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@thalovant/sdk": "^0.6.1",
+    "@thalovant/sdk": "^0.7.1",
     "jose": "^6.2.8",
     "zod": "^3.25.76"
   },

package/server.json

@@ -7,19 +7,19 @@
     "url": "https://github.com/thalovant/thalovant-mcp",
     "source": "github"
   },
-  "version": "0.4.1",
+  "version": "0.5.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@thalovant/mcp-server",
-      "version": "0.4.1",
+      "version": "0.5.1",
       "transport": {
         "type": "stdio"
       }
     },
     {
       "registryType": "oci",
-      "identifier": "ghcr.io/thalovant/thalovant-mcp:0.4.1",
+      "identifier": "ghcr.io/thalovant/thalovant-mcp:0.5.1",
       "transport": {
         "type": "streamable-http",
         "url": "http://127.0.0.1:3000/mcp"