@50heads/mcp 2026.925.2 → 2026.1009.1

package/dist/types/constants.d.ts

@@ -4,14 +4,15 @@
  */
 export declare const SERVER_NAME = "50heads";
 /** Calendar version (YYYY.MDD.N). Stamped at release by scripts/release.ts; never edit by hand. */
-export declare const SERVER_VERSION = "2026.925.2";
+export declare const SERVER_VERSION = "2026.1009.1";
 /** Sent by the CLI on every request, so the API can tell releases apart. */
-export declare const USER_AGENT = "50heads-mcp/2026.925.2";
+export declare const USER_AGENT = "50heads-mcp/2026.1009.1";
 export declare const MCP_RESOURCE_URL = "https://mcp.50heads.com/mcp";
 /** The scope each tool needs (spec: Authorization → Scopes). null: no sign-in needed. */
 export declare const TOOL_SCOPES: {
     readonly estimate: "questions:write";
     readonly ask: "questions:write";
+    readonly ask_set: "questions:write";
     readonly get_results: "questions:read";
     readonly wait_for_results: "questions:read";
     readonly list_questions: "questions:read";
@@ -25,6 +26,7 @@ export declare const TOOL_SCOPES: {
     readonly export: "questions:read";
     readonly build_ask_link: null;
     readonly list_targeting: null;
+    readonly list_audiences: null;
     readonly search_help: null;
     readonly send_feedback: null;
 };

package/dist/types/generated/skill.d.ts

@@ -1,5 +1,5 @@
 /** The skill's version (front matter metadata.version); advertised as skillVersion. */
-export declare const SKILL_VERSION = "2026.925.2";
+export declare const SKILL_VERSION = "2026.1009.1";
 /** SKILL.md without its front matter: the 50heads://guide resource. */
 export declare const SKILL_BODY = "# Asking 50heads\n\n50heads puts one short question to verified people on their phones and returns how they split. Answers cost credits, priced in your currency; fifty take about ten minutes.\n\n## When to ask\n\nAsk when the answer is a human reaction: which name, headline, image or menu people prefer, whether copy is clear, what they notice first. Never ask for facts, predictions, advice or research. Before asking again, call `list_questions` and reuse a recent answer.\n\n## Eight rules for a good question\n\n1. One question a head can answer in five seconds.\n2. Ask about a preference or first impression, never a fact.\n3. Show the thing: images (`ab_image`, `upload_image`) for anything visual.\n4. Keep options short, parallel and few: two to four is best. Add Neither when a forced pick would mislead.\n5. Word it neutrally. No leading words, no hint of the answer you want.\n6. Put background in `context`, one line, only when a head needs it.\n7. Pick the type that fits: `single_choice` to pick, `pairwise` for two, `ranking` for order, `scale_1_5` for strength, `free_text` (Tier 2) for why.\n8. Match heads and tier to the stakes: 50 at Tier 1 for a quick read, 100 or more or Tier 2 for a decision; target the countries and language of the real audience.\n\n## How to ask\n\n1. Call `estimate` and, when a person is present, show them the price and time together: \"50 answers, about 10 minutes, $12.70.\"\n2. Call `ask` with a fresh UUID as `idempotency_key`. Reuse that key if you retry.\n3. Wait on the task, or call `wait_for_results` on older hosts. `get_results` shows it while live.\n\n## Reading results\n\nLead with the winner, the margin in points and the confidence. With 50 heads a margin under 10 points is noise: say so and suggest more heads, not a verdict. Report underfilled as underfilled. Quote the split, not adjectives.\n\n## Worked example\n\n\"Which menu would you order from?\" with two menu photos, `ab_image`, 50 heads, Tier 1. Menu B 68%, Menu A 32%: \"Menu B wins by 36 points. Confidence high.\" Follow up with 20 Tier 2 heads saying why.\n\n## Avoid\n\n- Double questions (\"Is it clear and friendly?\").\n- Yes-or-no questions that lead.\n- Asking for personal data or anything that identifies someone.\n- Re-asking the same question to fish for a different answer.\n\nMore: `references/question-types.md`, `pricing.md`, `tools.md`.\n";
 /** Every file in the skill bundle, by path relative to skills/50heads. */

package/dist/types/language.d.ts

@@ -5,6 +5,19 @@ import { QUESTION_LANGUAGES } from "@50heads/shared";
  * asks the caller (elicitation) rather than guess.
  */
 type Lang = (typeof QUESTION_LANGUAGES)[number];
-/** A language code, or null when the text is not clearly one language. */
+/** A language its script alone gives away: kana is Japanese, Hangul Korean, Han without kana Chinese. */
+export type ScriptLanguage = "ja" | "ko" | "zh";
+/**
+ * The language of a text written in a script heads can only mean one way. Japanese is any kana
+ * (Han alone is ambiguous with Chinese, kana is not); Korean is Hangul; Chinese is Han with no
+ * kana. Null for every other script, including Latin, where stopwords decide.
+ */
+export declare function detectScriptLanguage(text: string): ScriptLanguage | null;
+/**
+ * A language code, or null when the text is not clearly one language. Script decides first:
+ * kana, Hangul and Han name ja, ko and zh outright, but only once that code is a question
+ * language (QUESTION_LANGUAGES); until then such text is null and the caller asks, as it does
+ * today. Latin text goes to the stopword count.
+ */
 export declare function detectLanguage(text: string): Lang | null;
 export {};

package/dist/types/manifest.d.ts

@@ -4,7 +4,7 @@
  */
 export declare const REGISTRY_NAME = "com.50heads/mcp";
 export declare const NPM_PACKAGE = "@50heads/mcp";
-export declare const DESCRIPTION = "Ask fifty verified real people a five-second question and get the split back.";
+export declare const DESCRIPTION = "Ask fifty verified people a five-second question and get the split back.";
 export type ManifestOptions = {
     /** The hosted endpoint, https://mcp.50heads.com/mcp. */
     endpoint?: string;
@@ -93,7 +93,6 @@ export declare function registryServerJson(): {
     repository: {
         url: string;
         source: string;
-        subfolder: string;
     };
     icons: {
         src: string;

package/dist/types/pricing.d.ts

@@ -23,6 +23,11 @@ export declare function formatPrice(p: {
     amount: number;
     currency: string;
 }, locale?: string): string;
+/**
+ * Opening line of the package README. Generated into README.md so the published credit
+ * total stays the Tier 1 price from packages/shared (50 × per-answer credits).
+ */
+export declare function readmeLead(): string;
 /** "about 10 minutes", "about 2 hours". */
 export declare function aboutMinutes(minutes: number): string;
 /** Cost and time in one sentence, per BRAND.md: "50 answers, about 10 minutes, $12.70." */