@extenshi/mcp 0.2.0 → 0.4.0

package/dist/welcome-agent-brief.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Welcome-page goal presets + the AI-agent brief.
+ *
+ * SELF-CONTAINED ON PURPOSE — no imports, so it can be copied verbatim into the
+ * published `@extenshi/mcp` package, which cannot depend on unpublished
+ * workspace packages (same constraint and same solution as svg-scrub.ts).
+ *
+ * SINGLE SOURCE, TWO COPIES, byte-identical:
+ *   shared-types/welcome-agent-brief.ts          (canonical — edit here)
+ *   tools/extenshi-mcp/src/welcome-agent-brief.ts (synced copy for @extenshi/mcp)
+ * after editing, run:
+ *   cp shared-types/welcome-agent-brief.ts tools/extenshi-mcp/src/welcome-agent-brief.ts
+ * A test in tools/extenshi-mcp/src/welcome-workflow.test.ts fails CI on drift.
+ *
+ * Why the sync is load-bearing rather than tidy: the brief tells an agent what
+ * to build AND states the limits the save path enforces. If the MCP copy drifts,
+ * an agent produces blocks against one spec and catalog-bff rejects them against
+ * another — and the author sees a validation error for work they were told to do.
+ */
+export declare const WELCOME_MAX_BLOCKS = 14;
+export declare const WELCOME_MAX_ANNOTATIONS = 8;
+export declare const WELCOME_TEXT_MAX_LEN = 600;
+export declare const WELCOME_TITLE_MAX_LEN = 120;
+export declare const WELCOME_ALT_MAX_LEN = 200;
+/** Inline SVG cap — an instructional diagram, not an embedded illustration set. */
+export declare const WELCOME_SVG_MAX_LEN = 24000;
+export declare const WELCOME_UPLOAD_MAX_BYTES: number;
+export declare const WELCOME_DEFAULT_ACCENT = "#5e5ce6";
+/**
+ * A welcome page exists to drive exactly one action. Naming that action is the
+ * single highest-leverage input to both the default copy and the agent brief:
+ * in ~90% of extensions the valuable action is "find and pin the extension",
+ * but a new-tab replacement instead needs the user to accept the override, and
+ * a content-script widget needs them to visit the target site and spot it.
+ */
+export type WelcomeGoal = 'PIN_EXTENSION' | 'NEW_TAB_OPT_IN' | 'VISIT_SITE' | 'CUSTOM';
+export interface WelcomeGoalPreset {
+    goal: WelcomeGoal;
+    label: string;
+    /** One-line description of the action, shown in the constructor. */
+    summary: string;
+    defaultHeadline: string;
+    defaultMessage: string;
+    /** Starting checklist — the author edits these, they are not fixed. */
+    defaultSteps: string[];
+    /**
+     * What an illustration for this goal must actually show. Fed verbatim into
+     * the agent brief, so it has to describe pixels, not intent.
+     */
+    illustrationTargets: string[];
+}
+export declare const WELCOME_GOAL_PRESETS: Record<WelcomeGoal, WelcomeGoalPreset>;
+export declare const WELCOME_GOALS: WelcomeGoal[];
+export declare function isWelcomeGoal(v: unknown): v is WelcomeGoal;
+export interface WelcomeAgentBriefInput {
+    extensionName: string;
+    goal: WelcomeGoal;
+    /** Free-text description of what the extension actually does. */
+    whatItDoes?: string | null;
+    /** Site the extension acts on — required to make VISIT_SITE illustrations concrete. */
+    targetSite?: string | null;
+    /** Store screenshot URLs we already host, offered to the agent as raw material. */
+    storeScreenshots?: string[];
+    /** Steps the author has already written, if any. */
+    existingSteps?: string[];
+    accentColor?: string;
+    /** Where the finished blocks get pasted back. */
+    constructorUrl?: string;
+}
+/**
+ * Render the brief that tells a coding/design agent what to produce for this
+ * welcome page.
+ *
+ * This is the tool's real job. An author who opens the constructor knows what
+ * their extension does but not what a good welcome page contains; an agent can
+ * draw and annotate but does not know the goal, the store assets we already
+ * hold, or the block JSON it must emit. The brief is the contract between them,
+ * so it states all three — and it is a pure function of the config (no network,
+ * no key, no credits) so both dojo and the MCP server can render it.
+ */
+export declare function buildWelcomeAgentBrief(input: WelcomeAgentBriefInput): string;
+//# sourceMappingURL=welcome-agent-brief.d.ts.map

package/dist/welcome-agent-brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-agent-brief.d.ts","sourceRoot":"","sources":["../src/welcome-agent-brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,eAAO,MAAM,kBAAkB,KAAK,CAAA;AACpC,eAAO,MAAM,uBAAuB,IAAI,CAAA;AACxC,eAAO,MAAM,oBAAoB,MAAM,CAAA;AACvC,eAAO,MAAM,qBAAqB,MAAM,CAAA;AACxC,eAAO,MAAM,mBAAmB,MAAM,CAAA;AACtC,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,QAAS,CAAA;AACzC,eAAO,MAAM,wBAAwB,QAAkB,CAAA;AACvD,eAAO,MAAM,sBAAsB,YAAY,CAAA;AAI/C;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,gBAAgB,GAAG,YAAY,GAAG,QAAQ,CAAA;AAEtF,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,uEAAuE;IACvE,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAC7B;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAoEvE,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAAgE,CAAA;AAEvG,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE1D;AAID,MAAM,WAAW,sBAAsB;IACtC,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,WAAW,CAAA;IACjB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAkN5E"}

package/dist/welcome-agent-brief.js

@@ -0,0 +1,221 @@
+/**
+ * Welcome-page goal presets + the AI-agent brief.
+ *
+ * SELF-CONTAINED ON PURPOSE — no imports, so it can be copied verbatim into the
+ * published `@extenshi/mcp` package, which cannot depend on unpublished
+ * workspace packages (same constraint and same solution as svg-scrub.ts).
+ *
+ * SINGLE SOURCE, TWO COPIES, byte-identical:
+ *   shared-types/welcome-agent-brief.ts          (canonical — edit here)
+ *   tools/extenshi-mcp/src/welcome-agent-brief.ts (synced copy for @extenshi/mcp)
+ * after editing, run:
+ *   cp shared-types/welcome-agent-brief.ts tools/extenshi-mcp/src/welcome-agent-brief.ts
+ * A test in tools/extenshi-mcp/src/welcome-workflow.test.ts fails CI on drift.
+ *
+ * Why the sync is load-bearing rather than tidy: the brief tells an agent what
+ * to build AND states the limits the save path enforces. If the MCP copy drifts,
+ * an agent produces blocks against one spec and catalog-bff rejects them against
+ * another — and the author sees a validation error for work they were told to do.
+ */
+// ── Caps (mirrored by the zod schemas in catalog-bff/src/lib/welcome-blocks.ts) ──
+export const WELCOME_MAX_BLOCKS = 14;
+export const WELCOME_MAX_ANNOTATIONS = 8;
+export const WELCOME_TEXT_MAX_LEN = 600;
+export const WELCOME_TITLE_MAX_LEN = 120;
+export const WELCOME_ALT_MAX_LEN = 200;
+/** Inline SVG cap — an instructional diagram, not an embedded illustration set. */
+export const WELCOME_SVG_MAX_LEN = 24_000;
+export const WELCOME_UPLOAD_MAX_BYTES = 2 * 1024 * 1024;
+export const WELCOME_DEFAULT_ACCENT = '#5e5ce6';
+export const WELCOME_GOAL_PRESETS = {
+    PIN_EXTENSION: {
+        goal: 'PIN_EXTENSION',
+        label: 'Pin the extension',
+        summary: 'Get the user to find the extension in the toolbar puzzle menu and pin it.',
+        defaultHeadline: "You're all set — pin it so it's always one click away",
+        defaultMessage: 'Chrome hides new extensions behind the puzzle icon. Pinning takes five seconds and means you never have to hunt for it again.',
+        defaultSteps: [
+            'Click the puzzle icon in the top-right of the browser toolbar',
+            'Find this extension in the list that opens',
+            'Click the pin icon next to it so it stays in the toolbar',
+            'The icon now sits in your toolbar — click it any time to start',
+        ],
+        illustrationTargets: [
+            'The browser toolbar with the puzzle (Extensions) icon highlighted in the top-right.',
+            "The open extensions dropdown with this extension's row highlighted.",
+            'The same dropdown with the pin toggle beside that row highlighted.',
+            'The toolbar after pinning, with the extension icon now visible next to the address bar.',
+        ],
+    },
+    NEW_TAB_OPT_IN: {
+        goal: 'NEW_TAB_OPT_IN',
+        label: 'Keep the new-tab change',
+        summary: 'Get the user to accept the new-tab override prompt instead of reverting it.',
+        defaultHeadline: 'One last step — keep your new tab',
+        defaultMessage: 'Your browser will ask whether to keep the new-tab page. Choose "Keep it" and the extension is ready to use.',
+        defaultSteps: [
+            'Open a new tab',
+            'Your browser shows a "change back?" prompt in the top-right',
+            'Click "Keep it" to confirm the new-tab page',
+            'Open a new tab again to see it live',
+        ],
+        illustrationTargets: [
+            'A fresh browser window with the new-tab change confirmation dialog visible.',
+            'The same dialog with the "Keep it" button highlighted.',
+            'The new tab page rendering the extension after confirmation.',
+        ],
+    },
+    VISIT_SITE: {
+        goal: 'VISIT_SITE',
+        label: 'Use it on a site',
+        summary: 'Send the user to the site where the extension injects its widget, and show them the widget.',
+        defaultHeadline: "You're installed — here's where to find it",
+        defaultMessage: 'This extension works directly on the pages you already use. Open a supported page and the controls appear automatically.',
+        defaultSteps: [
+            'Open a supported page in a new tab',
+            'Wait a second for the page to finish loading',
+            'Look for the extension panel added to the page',
+            'Click it to run the extension on that page',
+        ],
+        illustrationTargets: [
+            'The target website as it normally looks, before the extension acts.',
+            'The same page with the injected extension widget highlighted in place.',
+            'The widget expanded, showing the extension actually doing its job.',
+        ],
+    },
+    CUSTOM: {
+        goal: 'CUSTOM',
+        label: 'Something else',
+        summary: 'Describe your own primary action; nothing is pre-filled.',
+        defaultHeadline: '',
+        defaultMessage: '',
+        defaultSteps: [],
+        illustrationTargets: [],
+    },
+};
+export const WELCOME_GOALS = ['PIN_EXTENSION', 'NEW_TAB_OPT_IN', 'VISIT_SITE', 'CUSTOM'];
+export function isWelcomeGoal(v) {
+    return typeof v === 'string' && WELCOME_GOALS.includes(v);
+}
+/**
+ * Render the brief that tells a coding/design agent what to produce for this
+ * welcome page.
+ *
+ * This is the tool's real job. An author who opens the constructor knows what
+ * their extension does but not what a good welcome page contains; an agent can
+ * draw and annotate but does not know the goal, the store assets we already
+ * hold, or the block JSON it must emit. The brief is the contract between them,
+ * so it states all three — and it is a pure function of the config (no network,
+ * no key, no credits) so both dojo and the MCP server can render it.
+ */
+export function buildWelcomeAgentBrief(input) {
+    const preset = WELCOME_GOAL_PRESETS[input.goal] ?? WELCOME_GOAL_PRESETS.PIN_EXTENSION;
+    const name = input.extensionName.trim() || 'the extension';
+    const accent = input.accentColor || WELCOME_DEFAULT_ACCENT;
+    const shots = input.storeScreenshots ?? [];
+    const steps = (input.existingSteps ?? []).filter((s) => s.trim());
+    const out = [];
+    out.push(`# Welcome-page illustrations for "${name}"`);
+    out.push('');
+    out.push('You are producing the visual, step-by-step content for the page a user lands on the', 'moment they install this browser extension. Everything you make here gets pasted back', 'into the Extenshi welcome-page constructor as blocks — so produce the assets AND the', 'block JSON at the end.', '');
+    out.push('## The one action this page must drive');
+    out.push('');
+    out.push(`**${preset.label}** — ${preset.summary}`);
+    out.push('');
+    out.push('A welcome page that explains everything drives nothing. Every block you write must', 'serve that single action; cut anything that does not.', '');
+    if (input.whatItDoes?.trim()) {
+        out.push('## What the extension does');
+        out.push('');
+        out.push(input.whatItDoes.trim());
+        out.push('');
+    }
+    if (input.goal === 'VISIT_SITE') {
+        out.push('## Target site');
+        out.push('');
+        out.push(input.targetSite?.trim()
+            ? `The extension acts on: ${input.targetSite.trim()}. Illustrations must show that real site, not a generic page.`
+            : 'No target site was supplied. Ask the developer which site the extension injects into before drawing anything — a generic page teaches the user nothing.');
+        out.push('');
+    }
+    out.push('## Illustrations to produce');
+    out.push('');
+    if (preset.illustrationTargets.length) {
+        out.push('One image per step, in this order:');
+        out.push('');
+        preset.illustrationTargets.forEach((t, i) => {
+            out.push(`${i + 1}. ${t}`);
+        });
+    }
+    else {
+        out.push('No preset applies to this goal. Decide the shortest sequence of images that takes a', 'brand-new user from "just installed" to having completed the action above, and produce', 'one image per step.');
+    }
+    out.push('');
+    out.push('### How to get each image');
+    out.push('');
+    out.push('1. **Screenshot the real thing wherever you can.** Load the extension in a clean browser', '   profile, drive it to the exact moment the step describes, and capture the browser', '   window. A real screenshot of the actual UI beats a drawing, because the user is', '   matching what they see on their own screen against your image.', '2. **Crop to the region that matters.** A full 1920px desktop capture renders unreadably', '   small in a page column. Crop to the toolbar, the dropdown, or the widget — enough', '   surrounding context to locate it, nothing more.', '3. **Draw an SVG instead when a screenshot is impossible or ugly** — an OS dialog you', '   cannot reliably reproduce, a state that needs three preconditions, or anything with', '   personal data in it. A clean vector mock of the browser chrome is better than a', '   cluttered real capture.', '');
+    if (shots.length) {
+        out.push('### Screenshots we already host');
+        out.push('');
+        out.push(`This extension has ${shots.length} store screenshot${shots.length === 1 ? '' : 's'} already`, 'mirrored on our storage. They are approved store assets and can be dropped straight into', 'a block with `"source": "store"` and the URL as-is — no upload step:', '');
+        for (const u of shots.slice(0, 10)) {
+            out.push(`- ${u}`);
+        }
+        out.push('');
+        out.push('Use these for "what the extension looks like / what it does" blocks. They are marketing', 'captures, so they usually will NOT show the install steps — draw or capture those yourself.', '');
+    }
+    out.push('## Annotating: show exactly where to click');
+    out.push('');
+    out.push('An un-annotated screenshot makes the user hunt. Every image that has a click target must', 'carry a marker on it. Do NOT burn arrows into the image pixels — the constructor draws', 'markers as an overlay, so they stay crisp, stay translatable, and can be moved later.', '', 'Give each marker as a percentage of the image box:', '', '- `kind: "number"` — a numbered badge on the thing to click. Use when the step is one of', '  an ordered sequence, which is the common case.', '- `kind: "arrow"` — a pointer with an `angle` in degrees clockwise from pointing right', '  (0 = →, 90 = ↓, 180 = ←, 270 = ↑). Use when the target is small or near an edge and a', '  badge would cover it.', "- `x` / `y` are 0–100 percentages of the image's own width/height, measured to the CENTRE", '  of the target. Percentages, not pixels: the page is responsive and the author may swap', '  in a re-captured screenshot at a different resolution.', `- At most ${WELCOME_MAX_ANNOTATIONS} markers per image. If you need more, the image is doing`, '  too much — split it into two steps.', '');
+    out.push('## Constraints that will be enforced on save');
+    out.push('');
+    out.push(`- At most ${WELCOME_MAX_BLOCKS} blocks total.`, `- Step titles ≤ ${WELCOME_TITLE_MAX_LEN} chars; body text ≤ ${WELCOME_TEXT_MAX_LEN} chars.`, `- Every image needs \`alt\` text (≤ ${WELCOME_ALT_MAX_LEN} chars) describing what is shown —`, '  it is what a screen-reader user gets instead of your illustration.', `- SVG: a single \`<svg>\` element, ≤ ${WELCOME_SVG_MAX_LEN} chars, flat shapes only. Scripts,`, '  event handlers, `<foreignObject>`, external references and embedded rasters are stripped', '  by the server sanitizer — if you rely on them the image will render broken, so do not', '  use them.', `- Uploads: PNG / JPEG / WebP only, ≤ ${Math.round(WELCOME_UPLOAD_MAX_BYTES / 1024 / 1024)} MB each.`, `- Accent colour for this page is \`${accent}\` — match it in drawn illustrations so the page`, '  reads as one design.', '');
+    if (steps.length) {
+        out.push('## Steps the author already wrote');
+        out.push('');
+        out.push('Keep their wording and intent; you are adding the visuals, not rewriting the page:');
+        out.push('');
+        steps.forEach((s, i) => {
+            out.push(`${i + 1}. ${s}`);
+        });
+        out.push('');
+    }
+    out.push('## What to hand back');
+    out.push('');
+    out.push('A JSON array of blocks in this exact shape:');
+    out.push('');
+    out.push('```json');
+    out.push(JSON.stringify([
+        {
+            kind: 'step',
+            id: 'step-1',
+            title: preset.defaultSteps[0] ?? 'First thing the user does',
+            body: 'Optional one-sentence elaboration.',
+            media: {
+                source: 'svg',
+                svg: '<svg viewBox="0 0 640 200">…</svg>',
+                alt: 'Browser toolbar with the extensions puzzle icon at the top right',
+                annotations: [{ x: 92.5, y: 18, kind: 'number', n: 1, label: 'Click here' }],
+            },
+        },
+        {
+            kind: 'image',
+            id: 'shot-1',
+            media: {
+                source: 'store',
+                url: shots[0] ?? 'https://…/screenshot.png',
+                alt: 'The extension panel open on a supported page',
+                annotations: [],
+            },
+            caption: 'What it looks like in use.',
+        },
+        { kind: 'text', id: 'outro', title: 'Need help?', body: 'Short closing paragraph.' },
+    ], null, 2));
+    out.push('```');
+    out.push('');
+    out.push('- `source: "svg"` → put the markup in `svg`, leave `url` unset.', '- `source: "store"` → put one of the hosted URLs above in `url`, leave `svg` unset.', '- `source: "upload"` → the author uploads the file in the constructor and the URL is filled', '  in there; emit the block with an empty `url` and say which local file belongs in it.', '- `id` just has to be unique within the page.', '');
+    out.push('## Then');
+    out.push('');
+    out.push('1. Save any images you drew or captured as files next to the project so the author can upload them.', `2. Open the constructor${input.constructorUrl ? ` — ${input.constructorUrl}` : ''}, paste the block JSON,`, '   upload any local images, and check the live preview.', '3. Look at the preview at a narrow width too — annotations that read fine on desktop can', '   collide on a phone.');
+    return out.join('\n');
+}
+//# sourceMappingURL=welcome-agent-brief.js.map

package/dist/welcome-agent-brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-agent-brief.js","sourceRoot":"","sources":["../src/welcome-agent-brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,oFAAoF;AAEpF,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AACpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAA;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AACtC,mFAAmF;AACnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAA;AA6B/C,MAAM,CAAC,MAAM,oBAAoB,GAA2C;IAC3E,aAAa,EAAE;QACd,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,2EAA2E;QACpF,eAAe,EAAE,uDAAuD;QACxE,cAAc,EACb,+HAA+H;QAChI,YAAY,EAAE;YACb,+DAA+D;YAC/D,4CAA4C;YAC5C,0DAA0D;YAC1D,gEAAgE;SAChE;QACD,mBAAmB,EAAE;YACpB,qFAAqF;YACrF,qEAAqE;YACrE,oEAAoE;YACpE,yFAAyF;SACzF;KACD;IACD,cAAc,EAAE;QACf,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE,6EAA6E;QACtF,eAAe,EAAE,mCAAmC;QACpD,cAAc,EACb,6GAA6G;QAC9G,YAAY,EAAE;YACb,gBAAgB;YAChB,6DAA6D;YAC7D,6CAA6C;YAC7C,qCAAqC;SACrC;QACD,mBAAmB,EAAE;YACpB,6EAA6E;YAC7E,wDAAwD;YACxD,8DAA8D;SAC9D;KACD;IACD,UAAU,EAAE;QACX,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE,6FAA6F;QACtG,eAAe,EAAE,4CAA4C;QAC7D,cAAc,EACb,0HAA0H;QAC3H,YAAY,EAAE;YACb,oCAAoC;YACpC,8CAA8C;YAC9C,gDAAgD;YAChD,4CAA4C;SAC5C;QACD,mBAAmB,EAAE;YACpB,qEAAqE;YACrE,wEAAwE;YACxE,oEAAoE;SACpE;KACD;IACD,MAAM,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,0DAA0D;QACnE,eAAe,EAAE,EAAE;QACnB,cAAc,EAAE,EAAE;QAClB,YAAY,EAAE,EAAE;QAChB,mBAAmB,EAAE,EAAE;KACvB;CACD,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAkB,CAAC,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAA;AAEvG,MAAM,UAAU,aAAa,CAAC,CAAU;IACvC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,aAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AACxE,CAAC;AAoBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAA6B;IACnE,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,aAAa,CAAA;IACrF,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,eAAe,CAAA;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,IAAI,sBAAsB,CAAA;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAA;IAC1C,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAEjE,MAAM,GAAG,GAAa,EAAE,CAAA;IAExB,GAAG,CAAC,IAAI,CAAC,qCAAqC,IAAI,GAAG,CAAC,CAAA;IACtD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CACP,qFAAqF,EACrF,uFAAuF,EACvF,sFAAsF,EACtF,wBAAwB,EACxB,EAAE,CACF,CAAA;IAED,GAAG,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAA;IAClD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IACnD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CACP,oFAAoF,EACpF,uDAAuD,EACvD,EAAE,CACF,CAAA;IAED,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;QACtC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAA;QACjC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACb,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,GAAG,CAAC,IAAI,CACP,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE;YACvB,CAAC,CAAC,0BAA0B,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,+DAA+D;YAClH,CAAC,CAAC,yJAAyJ,CAC5J,CAAA;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACb,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;IACvC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,IAAI,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;QAC9C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC3C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;IACH,CAAC;SAAM,CAAC;QACP,GAAG,CAAC,IAAI,CACP,qFAAqF,EACrF,wFAAwF,EACxF,qBAAqB,CACrB,CAAA;IACF,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEZ,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;IACrC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CACP,0FAA0F,EAC1F,sFAAsF,EACtF,oFAAoF,EACpF,mEAAmE,EACnE,0FAA0F,EAC1F,sFAAsF,EACtF,oDAAoD,EACpD,uFAAuF,EACvF,wFAAwF,EACxF,oFAAoF,EACpF,4BAA4B,EAC5B,EAAE,CACF,CAAA;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;QAC3C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,GAAG,CAAC,IAAI,CACP,sBAAsB,KAAK,CAAC,MAAM,oBAAoB,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,EAC7F,0FAA0F,EAC1F,sEAAsE,EACtE,EAAE,CACF,CAAA;QACD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACnB,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,GAAG,CAAC,IAAI,CACP,yFAAyF,EACzF,6FAA6F,EAC7F,EAAE,CACF,CAAA;IACF,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAA;IACtD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CACP,0FAA0F,EAC1F,wFAAwF,EACxF,uFAAuF,EACvF,EAAE,EACF,oDAAoD,EACpD,EAAE,EACF,0FAA0F,EAC1F,kDAAkD,EAClD,wFAAwF,EACxF,yFAAyF,EACzF,yBAAyB,EACzB,2FAA2F,EAC3F,0FAA0F,EAC1F,0DAA0D,EAC1D,aAAa,uBAAuB,0DAA0D,EAC9F,uCAAuC,EACvC,EAAE,CACF,CAAA;IAED,GAAG,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;IACxD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CACP,aAAa,kBAAkB,gBAAgB,EAC/C,mBAAmB,qBAAqB,uBAAuB,oBAAoB,SAAS,EAC5F,uCAAuC,mBAAmB,oCAAoC,EAC9F,sEAAsE,EACtE,wCAAwC,mBAAmB,oCAAoC,EAC/F,4FAA4F,EAC5F,yFAAyF,EACzF,aAAa,EACb,wCAAwC,IAAI,CAAC,KAAK,CAAC,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAAC,WAAW,EACrG,sCAAsC,MAAM,kDAAkD,EAC9F,wBAAwB,EACxB,EAAE,CACF,CAAA;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;QAC7C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,GAAG,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAA;QAC9F,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QACF,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACb,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;IAChC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAA;IACvD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACnB,GAAG,CAAC,IAAI,CACP,IAAI,CAAC,SAAS,CACb;QACC;YACC,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,2BAA2B;YAC5D,IAAI,EAAE,oCAAoC;YAC1C,KAAK,EAAE;gBACN,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,oCAAoC;gBACzC,GAAG,EAAE,kEAAkE;gBACvE,WAAW,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;aAC5E;SACD;QACD;YACC,IAAI,EAAE,OAAO;YACb,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE;gBACN,MAAM,EAAE,OAAO;gBACf,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,0BAA0B;gBAC3C,GAAG,EAAE,8CAA8C;gBACnD,WAAW,EAAE,EAAE;aACf;YACD,OAAO,EAAE,4BAA4B;SACrC;QACD,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,0BAA0B,EAAE;KACpF,EACD,IAAI,EACJ,CAAC,CACD,CACD,CAAA;IACD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACf,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CACP,iEAAiE,EACjE,qFAAqF,EACrF,6FAA6F,EAC7F,wFAAwF,EACxF,+CAA+C,EAC/C,EAAE,CACF,CAAA;IAED,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACnB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACZ,GAAG,CAAC,IAAI,CACP,qGAAqG,EACrG,0BAA0B,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,yBAAyB,EAC3G,yDAAyD,EACzD,0FAA0F,EAC1F,wBAAwB,CACxB,CAAA;IAED,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC"}

package/dist/welcome-workflow.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Static content for the free `generate_welcome_page_workflow` MCP tool.
+ *
+ * Like `generate_icon_workflow`, this path deliberately spends ZERO Extenshi
+ * credits and touches no Extenshi infrastructure: the brief is a pure function
+ * of its arguments, so the tool works offline and can never fail on a docs or
+ * BFF outage. An agent connected through the MCP connector gets the exact
+ * requirements — what to illustrate, how to annotate, what JSON to emit —
+ * instead of guessing them.
+ *
+ * The brief itself lives in ./welcome-agent-brief.ts, a byte-identical copy of
+ * shared-types/welcome-agent-brief.ts. That sync is what guarantees the spec an
+ * agent is handed here is the same spec catalog-bff enforces on save.
+ *
+ * Store screenshots are NOT fetched here: that would need a catalog read (an
+ * API key and a credit) and would turn a free tool into a paid one. An agent
+ * that wants them calls `get_extension` and passes the URLs back in via
+ * `store_screenshots`.
+ */
+export declare const CONSTRUCTOR_URL = "https://dojo.extenshi.io/tools/onboarding-page";
+export interface WelcomeWorkflowArgs {
+    extensionName?: string;
+    goal?: string;
+    whatItDoes?: string;
+    targetSite?: string;
+    storeScreenshots?: string[];
+    existingSteps?: string[];
+    accentColor?: string;
+}
+export declare function renderWelcomeWorkflow(args: WelcomeWorkflowArgs): string;
+//# sourceMappingURL=welcome-workflow.d.ts.map

package/dist/welcome-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-workflow.d.ts","sourceRoot":"","sources":["../src/welcome-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,eAAO,MAAM,eAAe,mDAAmD,CAAA;AAE/E,MAAM,WAAW,mBAAmB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAkCvE"}

package/dist/welcome-workflow.js

@@ -0,0 +1,55 @@
+/**
+ * Static content for the free `generate_welcome_page_workflow` MCP tool.
+ *
+ * Like `generate_icon_workflow`, this path deliberately spends ZERO Extenshi
+ * credits and touches no Extenshi infrastructure: the brief is a pure function
+ * of its arguments, so the tool works offline and can never fail on a docs or
+ * BFF outage. An agent connected through the MCP connector gets the exact
+ * requirements — what to illustrate, how to annotate, what JSON to emit —
+ * instead of guessing them.
+ *
+ * The brief itself lives in ./welcome-agent-brief.ts, a byte-identical copy of
+ * shared-types/welcome-agent-brief.ts. That sync is what guarantees the spec an
+ * agent is handed here is the same spec catalog-bff enforces on save.
+ *
+ * Store screenshots are NOT fetched here: that would need a catalog read (an
+ * API key and a credit) and would turn a free tool into a paid one. An agent
+ * that wants them calls `get_extension` and passes the URLs back in via
+ * `store_screenshots`.
+ */
+import { buildWelcomeAgentBrief, isWelcomeGoal } from './welcome-agent-brief.js';
+export const CONSTRUCTOR_URL = 'https://dojo.extenshi.io/tools/onboarding-page';
+export function renderWelcomeWorkflow(args) {
+    // An unrecognised goal falls back to the ~90% case rather than erroring: a
+    // slightly-wrong preset still produces a usable brief, and a hard failure
+    // here would strand the agent with nothing.
+    const goal = isWelcomeGoal(args.goal) ? args.goal : 'PIN_EXTENSION';
+    const brief = buildWelcomeAgentBrief({
+        extensionName: args.extensionName ?? '',
+        goal,
+        whatItDoes: args.whatItDoes,
+        targetSite: args.targetSite,
+        storeScreenshots: args.storeScreenshots,
+        existingSteps: args.existingSteps,
+        accentColor: args.accentColor,
+        constructorUrl: CONSTRUCTOR_URL,
+    });
+    return [
+        brief,
+        '',
+        '---',
+        '',
+        '## How this page gets published',
+        '',
+        'The author does not have to host anything. Saving in the constructor publishes the page at',
+        '`welcome.extenshi.io/{extensionId}/{slug}` and produces a `chrome.runtime.onInstalled`',
+        'snippet that opens it once on first install (never on update) and counts confirmed installs',
+        'by version and browser.',
+        '',
+        'If the author would rather host the page themselves, they can set their own URL in the',
+        'constructor instead — the generated snippet then opens their page and fires a separate',
+        'permission-free beacon, so the install counter keeps working either way. In that case the',
+        'block JSON above is still worth producing: it is the content spec for their own page.',
+    ].join('\n');
+}
+//# sourceMappingURL=welcome-workflow.js.map

package/dist/welcome-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-workflow.js","sourceRoot":"","sources":["../src/welcome-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAoB,MAAM,0BAA0B,CAAA;AAElG,MAAM,CAAC,MAAM,eAAe,GAAG,gDAAgD,CAAA;AAY/E,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC9D,2EAA2E;IAC3E,0EAA0E;IAC1E,4CAA4C;IAC5C,MAAM,IAAI,GAAgB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAA;IAEhF,MAAM,KAAK,GAAG,sBAAsB,CAAC;QACpC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;QACvC,IAAI;QACJ,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,cAAc,EAAE,eAAe;KAC/B,CAAC,CAAA;IAEF,OAAO;QACN,KAAK;QACL,EAAE;QACF,KAAK;QACL,EAAE;QACF,iCAAiC;QACjC,EAAE;QACF,4FAA4F;QAC5F,wFAAwF;QACxF,6FAA6F;QAC7F,yBAAyB;QACzB,EAAE;QACF,wFAAwF;QACxF,wFAAwF;QACxF,2FAA2F;QAC3F,uFAAuF;KACvF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@extenshi/mcp",
-  "version": "0.2.0",
+  "version": "0.4.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",