@extenshi/mcp 0.13.1 → 0.14.0

package/dist/uninstall-form-tools.js

@@ -0,0 +1,184 @@
+/**
+ * Uninstall survey tools (plan 2026-10-18 §3).
+ *
+ * Until these, the survey was editable only in Dojo: an extension renamed after
+ * launch kept its old name in the survey headline, the thank-you screens and
+ * their translations, and an agent could not fix it. These read, preview and
+ * update one survey through the same validation the Dojo editor uses; its
+ * translations stay with get/set_page_translations (surface `uninstall`).
+ * find_brand_mentions finds the old name across every hosted text first.
+ */
+import { z } from 'zod';
+const READ_ONLY = { readOnlyHint: true, idempotentHint: true, destructiveHint: false, openWorldHint: true };
+const UNINSTALL_REASONS = [
+    'too_buggy',
+    'found_alternative',
+    'not_needed',
+    'privacy_concerns',
+    'too_expensive',
+    'confusing',
+    'missing_features',
+    'slows_browser',
+];
+const httpUrl = z.string().url().max(500);
+/** Mirrors the BFF's partial patch; the server validates the merged form again. */
+export const uninstallFormPatchSchema = z
+    .object({
+    name: z.string().min(1).max(80).describe('Dev-facing variant name (not shown on the page).'),
+    enabled: z.boolean(),
+    accentColor: z.string().regex(/^#[0-9a-fA-F]{3,8}$/),
+    theme: z.enum(['light', 'dark']),
+    headline: z
+        .string()
+        .max(120)
+        .nullable()
+        .describe('Page heading. null = the built-in "Sorry to see you uninstall <title>" in the page language.'),
+    thankYouMessage: z.string().max(300).nullable().describe('Shown after an answer. null = built-in text.'),
+    reasons: z.array(z.enum(UNINSTALL_REASONS)).min(1).max(UNINSTALL_REASONS.length),
+    customReasons: z.array(z.string().min(1).max(60)).max(2).describe('Your own reason chips (max 2).'),
+    askComment: z.boolean(),
+    askContact: z
+        .boolean()
+        .describe('Ask for an email address. Turning it on needs confirmPrivacyChange: true.'),
+    winbackUrl: httpUrl.nullable().describe('Form-level win-back button link (http/https).'),
+    winbackLabel: z.string().max(80).nullable(),
+    reasonOutcomes: z
+        .array(z.object({
+        reason: z.string().min(1).max(80).describe('A reason key, `custom:<label>`, or `other`.'),
+        thankYouMessage: z.string().max(300).optional(),
+        winbackUrl: httpUrl.optional(),
+        winbackLabel: z.string().max(80).optional(),
+    }))
+        .describe('Per-reason after-submit screen. Replaces the whole list.'),
+    reasonFollowups: z
+        .array(z.object({
+        reason: z.string().min(1).max(80),
+        prompt: z.string().min(1).max(200),
+        kind: z.enum(['text', 'choice']),
+        choices: z.array(z.string().min(1).max(60)).max(8).optional(),
+        multiple: z.boolean().optional(),
+    }))
+        .describe('Per-reason follow-up question. Replaces the whole list.'),
+})
+    .partial()
+    .strict();
+export function registerUninstallFormTools(add, bff, fail) {
+    const ids = {
+        projectId: z.string().uuid(),
+        formId: z.string().uuid().describe('From list_uninstall_forms.'),
+    };
+    add({
+        name: 'list_uninstall_forms',
+        description: "The project's hosted uninstall surveys: {id, name, publicCode, url, enabled, primary, responseCount, " +
+            'createdAt, updatedAt}. `primary` is the one generated setUninstallURL code points at; a survey keeps ' +
+            'its URL for life. Requires project.read. FREE.',
+        parameters: z.object({ projectId: z.string().uuid() }),
+        annotations: { title: 'List uninstall surveys', ...READ_ONLY },
+        execute: async (args, context) => {
+            try {
+                return JSON.stringify(await bff(context).listUninstallForms(args));
+            }
+            catch (err) {
+                return fail(err);
+            }
+        },
+    });
+    add({
+        name: 'get_uninstall_form',
+        description: 'One uninstall survey in full: every setting, the per-reason outcomes and follow-up questions, its ' +
+            'URL, `updatedAt` (pass it back as expectedUpdatedAt to update_uninstall_form), the page heading and ' +
+            'where it comes from (`headline`, or `default` built from `title`, which is the store listing name ' +
+            'or the project name), and translation status per project language {translated, missing, outdated}. ' +
+            'Requires project.read. FREE.',
+        parameters: z.object(ids),
+        annotations: { title: 'Read an uninstall survey', ...READ_ONLY },
+        execute: async (args, context) => {
+            try {
+                return JSON.stringify(await bff(context).getUninstallForm(args));
+            }
+            catch (err) {
+                return fail(err);
+            }
+        },
+    });
+    add({
+        name: 'update_uninstall_form',
+        description: 'Change an uninstall survey. `patch` is partial: absent fields keep their value, null clears an ' +
+            'optional text, list fields replace the whole list. The merged survey passes the same validation as ' +
+            'the Dojo editor (lengths, http(s) links, outcomes and questions only for reasons the survey offers). ' +
+            'dryRun: true returns {changes [{field, before, after}], staleTranslations [{locale, paths}], ' +
+            'warnings} and writes nothing. A write needs expectedUpdatedAt (from get_uninstall_form) and an ' +
+            'idempotencyKey (UUID): a survey saved since you read it is refused (CONFLICT FORM_CHANGED); a retry ' +
+            'with the same key returns the first result (replayed: true). Translations whose original changed ' +
+            'are kept and listed as stale: re-translate them with set_page_translations. Turning askContact on ' +
+            'needs confirmPrivacyChange: true, since the privacy policy then has to cover email collection. The public ' +
+            'URL and the collected responses stay as they are. The change is listed for the owner in Dojo with ' +
+            'proposedBy. Requires hosted.write.',
+        parameters: z.object({
+            ...ids,
+            patch: uninstallFormPatchSchema,
+            expectedUpdatedAt: z.string().datetime().optional().describe('`updatedAt` from get_uninstall_form.'),
+            dryRun: z.boolean().optional(),
+            idempotencyKey: z.string().uuid().optional().describe('Required for a write; reuse it only to retry.'),
+            confirmPrivacyChange: z.boolean().optional(),
+            proposedBy: z.string().max(120).optional().describe('Your agent/tool name, shown to the owner.'),
+        }),
+        annotations: {
+            title: 'Update an uninstall survey',
+            readOnlyHint: false,
+            idempotentHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+        execute: async (args, context) => {
+            try {
+                return JSON.stringify(await bff(context).updateUninstallForm(args));
+            }
+            catch (err) {
+                return fail(err);
+            }
+        },
+    });
+    add({
+        name: 'preview_uninstall_form',
+        description: 'What the live survey shows in one language, built by the functions the page uses: heading, ' +
+            'subheading, the reason chips with their labels and follow-up questions, whether a comment or email ' +
+            'is asked, and the after-submit screen per reason (message and win-back button). `locale` is ' +
+            'resolved as for a visitor (an unoffered language falls back to the default; the answer says which ' +
+            'was used). Also returns previewUrl, which renders the page in a browser without counting an ' +
+            'uninstall. Records no visit and no response. Requires project.read. FREE.',
+        parameters: z.object({ ...ids, locale: z.string().max(35).optional() }),
+        annotations: { title: 'Preview an uninstall survey', ...READ_ONLY },
+        execute: async (args, context) => {
+            try {
+                return JSON.stringify(await bff(context).previewUninstallForm(args));
+            }
+            catch (err) {
+                return fail(err);
+            }
+        },
+    });
+    add({
+        name: 'find_brand_mentions',
+        description: "Find where a name (e.g. the extension's old name) still appears in the project's hosted text: " +
+            'uninstall surveys, welcome pages, install instructions, the live homepage, the live privacy policy ' +
+            'and its form, and with pay.read also the license terms and Pay offers — each with its translations. ' +
+            'Case-insensitive. Each match: {surface, id, publicCode, name, path, locale, term, excerpt, fix}, ' +
+            'where `fix` names the tool that changes that field. `skipped` lists surfaces this credential cannot ' +
+            'read. Read-only. Requires project.read. FREE.',
+        parameters: z.object({
+            projectId: z.string().uuid(),
+            terms: z.array(z.string().min(2).max(120)).min(1).max(5),
+        }),
+        annotations: { title: 'Find a name in hosted pages', ...READ_ONLY },
+        execute: async (args, context) => {
+            try {
+                return JSON.stringify(await bff(context).findBrandMentions(args));
+            }
+            catch (err) {
+                return fail(err);
+            }
+        },
+    });
+}
+//# sourceMappingURL=uninstall-form-tools.js.map

package/dist/uninstall-form-tools.js.map

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

package/dist/update-check.d.ts

@@ -23,6 +23,15 @@ export declare function updateCheckOptedOut(env?: NodeJS.ProcessEnv): boolean;
 export declare function isNewerVersion(current: string, latest: string): boolean;
 /** Build the stderr hint (exported for testability). */
 export declare function updateMessage(current: string, latest: string): string;
+/** What the last check learned, for connection_diagnostics: stderr never reaches the agent. */
+export interface KnownUpdate {
+    version: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+    howToUpdate: string | null;
+}
+/** The result of this process's update check, or null when none finished (opted out, offline, remote). */
+export declare function knownUpdate(): KnownUpdate | null;
 /**
  * Fire-and-forget update check. Never throws; writes at most one line to stderr.
  * `fetchImpl`/`out` are injectable for tests.

package/dist/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAOjF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAevE;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOrE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAO,KAAa,EAC/B,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAqC,GACzD,OAAO,CAAC,IAAI,CAAC,CAqBf"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAOjF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAevE;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOrE;AAED,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAGD,0GAA0G;AAC1G,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAO,KAAa,EAC/B,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAqC,GACzD,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/update-check.js

@@ -51,6 +51,11 @@ export function updateMessage(current, latest) {
         'For a pinned global install: `npm i -g @extenshi/mcp@latest`, then restart. ' +
         '(Silence this with EXTENSHI_NO_UPDATE_CHECK=1.)\n');
 }
+let known = null;
+/** The result of this process's update check, or null when none finished (opted out, offline, remote). */
+export function knownUpdate() {
+    return known;
+}
 /**
  * Fire-and-forget update check. Never throws; writes at most one line to stderr.
  * `fetchImpl`/`out` are injectable for tests.
@@ -75,7 +80,19 @@ export async function checkForUpdate(current, fetchImpl = fetch, out = (m) => pr
             return;
         const json = (await res.json());
         const latest = typeof json.version === 'string' ? json.version : undefined;
-        if (latest && isNewerVersion(current, latest))
+        if (!latest)
+            return;
+        const updateAvailable = isNewerVersion(current, latest);
+        known = {
+            version: current,
+            latestVersion: latest,
+            updateAvailable,
+            // A client with a cached npx copy keeps an older tool list until it fetches @latest.
+            howToUpdate: updateAvailable
+                ? 'Restart the client with `npx -y @extenshi/mcp@latest` (or `npm i -g @extenshi/mcp@latest`).'
+                : null,
+        };
+        if (updateAvailable)
             out(updateMessage(current, latest));
     }
     catch {

package/dist/update-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,YAAY,GAAG,iDAAiD,CAAA;AACtE,MAAM,UAAU,GAAG,IAAI,CAAA;AAEvB,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACvE,OAAO,CACN,GAAG,CAAC,wBAAwB,KAAK,GAAG;QACpC,GAAG,CAAC,YAAY,KAAK,GAAG;QACxB,GAAG,CAAC,kBAAkB,KAAK,GAAG;QAC9B,GAAG,CAAC,EAAE,KAAK,MAAM,CACjB,CAAA;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAC3B,CAAC;SACC,KAAK,CAAC,GAAG,CAAC;SACV,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IACrC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;IACxB,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QACtB,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;IACxB,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,MAAc;IAC5D,OAAO,CACN,gDAAgD,OAAO,MAAM,MAAM,IAAI;QACvE,sEAAsE;QACtE,8EAA8E;QAC9E,mDAAmD,CACnD,CAAA;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAAe,EACf,YAA0B,KAAK,EAC/B,MAA6B,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAE3D,IAAI,mBAAmB,EAAE;QAAE,OAAM;IACjC,IAAI,CAAC;QACJ,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,CAAC,CAAA;QAC9D,IAAI,GAAa,CAAA;QACjB,IAAI,CAAC;YACJ,GAAG,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE;gBACnC,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;aACvC,CAAC,CAAA;QACH,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAA;QACpB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAM;QACnB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0B,CAAA;QACxD,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;QAC1E,IAAI,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC;YAAE,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;IACnF,CAAC;IAAC,MAAM,CAAC;QACR,6DAA6D;IAC9D,CAAC;AACF,CAAC"}
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@extenshi/mcp",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Extenshi MCP server — bring the extension catalog (search, security, market research) and pre-publish scanning into your AI tools",
   "type": "module",
   "license": "MIT",