@convertcom/mcp-server 0.0.1-beta.17 → 0.0.1-beta.18

package/build/whats-new.js

@@ -0,0 +1,150 @@
+// Curated newest-first. Entries cover shipped versions only: add the next
+// entry in the same commit that bumps the release version, never before.
+export const WHATS_NEW_ENTRIES = [
+    {
+        version: '0.0.1-beta.18',
+        highlights: [
+            'Failures now report bounded, privacy-safe cause, source, stage, and dispatch state without exposing customer data or raw upstream diagnostics.',
+            'Hosted OAuth refresh coordination and Durable Object recovery are hardened for concurrency, eviction, cancellation, and client isolation.',
+            'List and report filters reject unknown or misplaced fields instead of silently widening results, with corrected report and visits-page guidance.',
+            'Operator workflows use authoritative goal definitions consistently and preserve partial-coverage warnings across portfolio analysis.',
+            'Documentation search includes refreshed support, Management API, and website knowledge with local and Worker retrieval gates.',
+            'A read-only whats_new tool, prompt, and resource expose version-aware release highlights on demand.',
+        ],
+    },
+    {
+        version: '0.0.1-beta.17',
+        highlights: [
+            'Visits-page goals reject ignored settings.url values before any write and explain the triggering_rule shape.',
+            'Split-URL creation defaults to a no-redirect Original with a redirect treatment at 50/50, verified by readback.',
+            'Reports keep engine-correct done semantics and never present default-like values as computed evidence.',
+            'Failures distinguish started from completed work with bounded, privacy-safe categories.',
+            'Hosted modern-protocol smoke coverage with cancellation and verified cleanup.',
+        ],
+    },
+    {
+        version: '0.0.1-beta.16',
+        highlights: [
+            'Hosted endpoint speaks MCP 2026-07-28 alongside the existing protocol adapter; existing clients preserved.',
+            'Catalog-change subscriptions with grant isolation, deduplication, and explicit refresh fallback.',
+            'Stronger session ownership and startup recovery; writes are never replayed as recovery.',
+            'Hosted documentation search on an isolated compute boundary with cancellation support.',
+        ],
+    },
+    {
+        version: '0.0.1-beta.15',
+        highlights: [
+            'Eligible users can explicitly authorize Entire account, including future projects, at OAuth consent.',
+            'Backend approval requirements surface as actionable request information instead of failed writes.',
+            'Project creation and deletion guardrails with exact second confirmation for destructive calls.',
+            'Notification tools ship disabled by default pending backend rollout; absent from the catalog until enabled.',
+        ],
+    },
+];
+export const MAX_WHATS_NEW_ENTRIES = 10;
+export function parseBetaVersion(value) {
+    if (typeof value !== 'string')
+        return null;
+    const match = /^0\.0\.1-beta\.(\d+)$/.exec(value.trim());
+    if (!match)
+        return null;
+    const ordinal = Number.parseInt(match[1], 10);
+    return Number.isSafeInteger(ordinal) ? ordinal : null;
+}
+export function whatsNewSince(serverVersion, sinceVersion) {
+    const knownVersions = WHATS_NEW_ENTRIES.map((entry) => entry.version);
+    const serverOrdinal = parseBetaVersion(serverVersion);
+    if (serverOrdinal === null) {
+        return {
+            ok: true,
+            server_version: serverVersion,
+            entries: WHATS_NEW_ENTRIES.slice(0, MAX_WHATS_NEW_ENTRIES),
+            truncated: WHATS_NEW_ENTRIES.length > MAX_WHATS_NEW_ENTRIES,
+            note: 'This server reports a deployment identifier instead of a release version, so filtering is unavailable; showing the latest entries.',
+        };
+    }
+    if (sinceVersion === undefined || sinceVersion === null || sinceVersion === '') {
+        const current = WHATS_NEW_ENTRIES.filter((entry) => parseBetaVersion(entry.version) === serverOrdinal);
+        if (current.length === 0) {
+            return {
+                ok: true,
+                server_version: serverVersion,
+                entries: [],
+                truncated: false,
+                note: `No published notes for ${serverVersion} yet; pass since_version to list earlier entries.`,
+            };
+        }
+        return { ok: true, server_version: serverVersion, entries: current, truncated: false };
+    }
+    const sinceOrdinal = parseBetaVersion(sinceVersion);
+    if (sinceOrdinal === null) {
+        return {
+            ok: false,
+            error: `Unknown since_version ${JSON.stringify(String(sinceVersion))}; use one of: ${knownVersions.join(', ')}.`,
+            known_versions: knownVersions,
+        };
+    }
+    if (sinceOrdinal >= serverOrdinal) {
+        return {
+            ok: true,
+            server_version: serverVersion,
+            entries: [],
+            truncated: false,
+            note: `${String(sinceVersion)} is not older than this server (${serverVersion}); nothing new to report.`,
+        };
+    }
+    const entries = WHATS_NEW_ENTRIES.filter((entry) => {
+        const ordinal = parseBetaVersion(entry.version);
+        return ordinal !== null && ordinal > sinceOrdinal && ordinal <= serverOrdinal;
+    });
+    return {
+        ok: true,
+        server_version: serverVersion,
+        entries: entries.slice(0, MAX_WHATS_NEW_ENTRIES),
+        truncated: entries.length > MAX_WHATS_NEW_ENTRIES,
+    };
+}
+export function renderWhatsNewMarkdown(serverVersion, entries, note) {
+    const lines = [`# What's New In Convert MCP ${serverVersion}`, ''];
+    if (entries.length === 0) {
+        lines.push('No published notes for this selection yet.');
+    }
+    for (const entry of entries) {
+        lines.push(`## ${entry.version}`, '');
+        for (const highlight of entry.highlights)
+            lines.push(`- ${highlight}`);
+        lines.push('');
+    }
+    if (note)
+        lines.push(`Note: ${note}`, '');
+    lines.push('Full details live in the per-release notes. This surface is on-demand only; announcements are never pushed.');
+    return lines.join('\n').trim();
+}
+export const WHATS_NEW_RESOURCE_URI = 'convert://releases/whats-new/v1';
+export const WHATS_NEW_RESOURCE_MIME_TYPE = 'text/markdown';
+export function whatsNewResourceProvider(serverVersion) {
+    return {
+        listResources: () => [{
+                uri: WHATS_NEW_RESOURCE_URI,
+                name: 'convert-whats-new-v1',
+                title: "What's New In This Convert MCP Server",
+                description: `Feature announcements for the running server version (${serverVersion}). On-demand only; use the whats_new tool with since_version for earlier releases.`,
+                mimeType: WHATS_NEW_RESOURCE_MIME_TYPE,
+            }],
+        readResource: (uri) => {
+            if (uri !== WHATS_NEW_RESOURCE_URI)
+                return null;
+            const result = whatsNewSince(serverVersion);
+            const entries = result.ok ? result.entries : [];
+            const note = result.ok ? result.note : undefined;
+            return {
+                contents: [{
+                        uri: WHATS_NEW_RESOURCE_URI,
+                        mimeType: WHATS_NEW_RESOURCE_MIME_TYPE,
+                        text: renderWhatsNewMarkdown(serverVersion, entries, note),
+                    }],
+            };
+        },
+    };
+}
+//# sourceMappingURL=whats-new.js.map

package/build/whats-new.js.map

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