@pofky/asc-mcp 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,109 @@
1
+ "use strict";
2
+ /**
3
+ * MCP Sampling helper.
4
+ *
5
+ * Calls `server.createMessage(...)` on the underlying MCP Server so the
6
+ * user's own client runs the LLM request. Zero cost to us (we do not pay
7
+ * for the user's Anthropic tokens).
8
+ *
9
+ * Capability detection: we check the client's declared capabilities at
10
+ * initialize time. If sampling is not advertised, the caller gets a
11
+ * structured `{ unsupported: true }` response and must degrade gracefully.
12
+ */
13
+ Object.defineProperty(exports, "__esModule", { value: true });
14
+ exports.MODEL_HINTS = void 0;
15
+ exports.clientSupportsSampling = clientSupportsSampling;
16
+ exports.sample = sample;
17
+ const DEFAULT_TIMEOUT_MS = 30_000;
18
+ function clientSupportsSampling(server) {
19
+ try {
20
+ const caps = server.server.getClientCapabilities();
21
+ return Boolean(caps?.sampling);
22
+ }
23
+ catch {
24
+ return false;
25
+ }
26
+ }
27
+ async function sample(server, req) {
28
+ if (!clientSupportsSampling(server)) {
29
+ return { ok: false, unsupported: true };
30
+ }
31
+ const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;
32
+ const messages = [
33
+ {
34
+ role: "user",
35
+ content: { type: "text", text: req.user },
36
+ },
37
+ ];
38
+ try {
39
+ const result = (await withTimeout(server.server.createMessage({
40
+ messages,
41
+ systemPrompt: req.system,
42
+ maxTokens: req.maxTokens,
43
+ temperature: req.temperature,
44
+ modelPreferences: req.modelPreferences,
45
+ }), timeoutMs));
46
+ const text = extractText(result);
47
+ if (!text) {
48
+ return { ok: false, error: "Sampling returned no text content." };
49
+ }
50
+ return {
51
+ ok: true,
52
+ text,
53
+ model: result.model ?? "unknown",
54
+ stopReason: result.stopReason,
55
+ };
56
+ }
57
+ catch (err) {
58
+ const msg = err instanceof Error ? err.message : String(err);
59
+ return { ok: false, error: msg };
60
+ }
61
+ }
62
+ function extractText(result) {
63
+ const content = result.content;
64
+ if (!content)
65
+ return "";
66
+ if (Array.isArray(content)) {
67
+ const textBlocks = content.filter((b) => typeof b === "object" && b !== null && b.type === "text");
68
+ return textBlocks.map((b) => b.text).join("\n").trim();
69
+ }
70
+ if (typeof content === "object" && content !== null) {
71
+ const maybeBlock = content;
72
+ if (maybeBlock.type === "text" && typeof maybeBlock.text === "string") {
73
+ return maybeBlock.text.trim();
74
+ }
75
+ }
76
+ return "";
77
+ }
78
+ function withTimeout(promise, ms) {
79
+ return new Promise((resolve, reject) => {
80
+ const timer = setTimeout(() => {
81
+ reject(new Error(`Sampling timed out after ${ms}ms`));
82
+ }, ms);
83
+ promise.then((v) => {
84
+ clearTimeout(timer);
85
+ resolve(v);
86
+ }, (e) => {
87
+ clearTimeout(timer);
88
+ reject(e);
89
+ });
90
+ });
91
+ }
92
+ exports.MODEL_HINTS = {
93
+ fast: {
94
+ speedPriority: 0.6,
95
+ costPriority: 0.3,
96
+ intelligencePriority: 0.1,
97
+ },
98
+ balanced: {
99
+ speedPriority: 0.4,
100
+ costPriority: 0.3,
101
+ intelligencePriority: 0.3,
102
+ },
103
+ smart: {
104
+ speedPriority: 0.2,
105
+ costPriority: 0.2,
106
+ intelligencePriority: 0.6,
107
+ },
108
+ };
109
+ //# sourceMappingURL=sampling.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sampling.js","sourceRoot":"","sources":["../src/sampling.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAwBH,wDAOC;AAED,wBA0CC;AArDD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,SAAgB,sBAAsB,CAAC,MAAiB;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,MAAM,CAC1B,MAAiB,EACjB,GAAoB;IAEpB,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,kBAAkB,CAAC;IACtD,MAAM,QAAQ,GAAG;QACf;YACE,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;SACnD;KACF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAwB,CAAC,MAAM,WAAW,CACpD,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;YAC1B,QAAQ;YACR,YAAY,EAAE,GAAG,CAAC,MAAM;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;SACvC,CAAC,EACF,SAAS,CACV,CAAwB,CAAC;QAE1B,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;QACpE,CAAC;QACD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;YAChC,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAA2B;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAC/B,CAAC,CAAC,EAAuC,EAAE,CACzC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAAuB,CAAC,IAAI,KAAK,MAAM,CAClF,CAAC;QACF,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,OAA2C,CAAC;QAC/D,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtE,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAI,OAAmB,EAAE,EAAU;IACrD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC,CAAC;QACxD,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,OAAO,CAAC,IAAI,CACV,CAAC,CAAC,EAAE,EAAE;YACJ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,EACD,CAAC,CAAC,EAAE,EAAE;YACJ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,WAAW,GAAG;IACzB,IAAI,EAAE;QACJ,aAAa,EAAE,GAAG;QAClB,YAAY,EAAE,GAAG;QACjB,oBAAoB,EAAE,GAAG;KACC;IAC5B,QAAQ,EAAE;QACR,aAAa,EAAE,GAAG;QAClB,YAAY,EAAE,GAAG;QACjB,oBAAoB,EAAE,GAAG;KACC;IAC5B,KAAK,EAAE;QACL,aAAa,EAAE,GAAG;QAClB,YAAY,EAAE,GAAG;QACjB,oBAAoB,EAAE,GAAG;KACC;CAC7B,CAAC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * `asc-mcp install-skill` and `asc-mcp uninstall-skill` subcommands.
3
+ *
4
+ * Copies (or removes) the bundled `asc-review-triage` Claude Skill to
5
+ * ~/.claude/skills/asc-review-triage/ so Claude Desktop and Claude Code
6
+ * auto-load it.
7
+ */
8
+ export declare function installSkill(): number;
9
+ export declare function uninstallSkill(): number;
10
+ //# sourceMappingURL=skill-installer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-installer.d.ts","sourceRoot":"","sources":["../src/skill-installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuCH,wBAAgB,YAAY,IAAI,MAAM,CA0CrC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAgBvC"}
@@ -0,0 +1,104 @@
1
+ "use strict";
2
+ /**
3
+ * `asc-mcp install-skill` and `asc-mcp uninstall-skill` subcommands.
4
+ *
5
+ * Copies (or removes) the bundled `asc-review-triage` Claude Skill to
6
+ * ~/.claude/skills/asc-review-triage/ so Claude Desktop and Claude Code
7
+ * auto-load it.
8
+ */
9
+ var __importDefault = (this && this.__importDefault) || function (mod) {
10
+ return (mod && mod.__esModule) ? mod : { "default": mod };
11
+ };
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.installSkill = installSkill;
14
+ exports.uninstallSkill = uninstallSkill;
15
+ const node_fs_1 = __importDefault(require("node:fs"));
16
+ const node_path_1 = __importDefault(require("node:path"));
17
+ const node_os_1 = __importDefault(require("node:os"));
18
+ const SKILL_NAME = "asc-review-triage";
19
+ function targetDir() {
20
+ return node_path_1.default.join(node_os_1.default.homedir(), ".claude", "skills", SKILL_NAME);
21
+ }
22
+ function sourceDir() {
23
+ // When compiled, __dirname maps to dist/. The skills/ dir ships at
24
+ // the package root, one level up. CommonJS build uses __dirname.
25
+ return node_path_1.default.resolve(__dirname, "..", "skills", SKILL_NAME);
26
+ }
27
+ function ensureDir(dir) {
28
+ node_fs_1.default.mkdirSync(dir, { recursive: true });
29
+ }
30
+ function copyDirRecursive(src, dest) {
31
+ ensureDir(dest);
32
+ const written = [];
33
+ const entries = node_fs_1.default.readdirSync(src, { withFileTypes: true });
34
+ for (const entry of entries) {
35
+ const s = node_path_1.default.join(src, entry.name);
36
+ const d = node_path_1.default.join(dest, entry.name);
37
+ if (entry.isDirectory()) {
38
+ written.push(...copyDirRecursive(s, d));
39
+ }
40
+ else if (entry.isFile()) {
41
+ node_fs_1.default.copyFileSync(s, d);
42
+ written.push(d);
43
+ }
44
+ }
45
+ return written;
46
+ }
47
+ function installSkill() {
48
+ const src = sourceDir();
49
+ const dest = targetDir();
50
+ if (!node_fs_1.default.existsSync(src)) {
51
+ console.error(`[asc-mcp] skill source not found at ${src}`);
52
+ console.error("[asc-mcp] this is a packaging bug, please open an issue.");
53
+ return 1;
54
+ }
55
+ try {
56
+ console.log(`Installing ${SKILL_NAME} skill for Claude Desktop / Claude Code.`);
57
+ console.log("");
58
+ console.log(`Writing to ${dest}`);
59
+ const homeClaude = node_path_1.default.join(node_os_1.default.homedir(), ".claude");
60
+ const homeClaudeExisted = node_fs_1.default.existsSync(homeClaude);
61
+ const skillsParentExisted = node_fs_1.default.existsSync(node_path_1.default.dirname(dest));
62
+ ensureDir(dest);
63
+ const written = copyDirRecursive(src, dest);
64
+ console.log(` ${homeClaudeExisted ? " " : "+"} ~/.claude/ ${homeClaudeExisted ? "already existed" : "created"}`);
65
+ console.log(` ${skillsParentExisted ? " " : "+"} ~/.claude/skills/ ${skillsParentExisted ? "already existed" : "created"}`);
66
+ for (const f of written) {
67
+ console.log(` + ${node_path_1.default.relative(node_os_1.default.homedir(), f)}`);
68
+ }
69
+ console.log("");
70
+ console.log("Done. The skill is now active.");
71
+ console.log("");
72
+ console.log("Next: in Claude Desktop or Claude Code, try asking");
73
+ console.log(' "any bad reviews on my app lately?"');
74
+ console.log("Claude will auto-load the skill and call the right tools.");
75
+ console.log("");
76
+ console.log("If Claude does not pick it up, restart the client once.");
77
+ console.log("To remove: asc-mcp uninstall-skill");
78
+ return 0;
79
+ }
80
+ catch (err) {
81
+ const msg = err instanceof Error ? err.message : String(err);
82
+ console.error(`[asc-mcp] install failed: ${msg}`);
83
+ return 1;
84
+ }
85
+ }
86
+ function uninstallSkill() {
87
+ const dest = targetDir();
88
+ if (!node_fs_1.default.existsSync(dest)) {
89
+ console.log(`No ${SKILL_NAME} skill found at ${dest}. Nothing to do.`);
90
+ return 0;
91
+ }
92
+ try {
93
+ node_fs_1.default.rmSync(dest, { recursive: true, force: true });
94
+ console.log(`Removed ${dest}`);
95
+ console.log("Restart Claude Desktop or Claude Code to unload the skill.");
96
+ return 0;
97
+ }
98
+ catch (err) {
99
+ const msg = err instanceof Error ? err.message : String(err);
100
+ console.error(`[asc-mcp] uninstall failed: ${msg}`);
101
+ return 1;
102
+ }
103
+ }
104
+ //# sourceMappingURL=skill-installer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-installer.js","sourceRoot":"","sources":["../src/skill-installer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * draft_review_response tool (Pro). Drafts a public reply to a single
3
+ * App Store review via Sampling, in the review's locale. Never posts.
4
+ *
5
+ * Pipeline:
6
+ * 1. Fetch the target review
7
+ * 2. If `tone` not provided and client supports Elicitation, ask for it
8
+ * 3. Sampling request to draft the reply
9
+ * 4. Post-filter draft for Apple guideline 1.2 violations (disputes,
10
+ * promo-only content, personal info)
11
+ * 5. Return draft with a warning. Never call Apple's POST endpoint.
12
+ */
13
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
14
+ import type { ASCClient } from "../client.js";
15
+ import type { Tier } from "../types.js";
16
+ type Tone = "apologetic" | "factual" | "promotional" | "curious";
17
+ export interface DraftArgs {
18
+ app_id: string;
19
+ review_id: string;
20
+ tone?: Tone;
21
+ include_support_link?: boolean;
22
+ context_note?: string;
23
+ }
24
+ export interface DraftResult {
25
+ app_id: string;
26
+ review_id: string;
27
+ locale: string;
28
+ tone_used: Tone | "default_factual";
29
+ draft: string;
30
+ warning: string;
31
+ degraded: boolean;
32
+ note?: string;
33
+ }
34
+ export declare function draftReviewResponse(server: McpServer, client: ASCClient, args: DraftArgs, tier: Tier): Promise<DraftResult>;
35
+ export declare function formatDraftForAgent(res: DraftResult): string;
36
+ export {};
37
+ //# sourceMappingURL=draft-review-response.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"draft-review-response.d.ts","sourceRoot":"","sources":["../../src/tools/draft-review-response.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAaxC,KAAK,IAAI,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;AAGjE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,GAAG,iBAAiB,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAYD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,WAAW,CAAC,CAkJtB;AAwED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAY5D"}
@@ -0,0 +1,236 @@
1
+ "use strict";
2
+ /**
3
+ * draft_review_response tool (Pro). Drafts a public reply to a single
4
+ * App Store review via Sampling, in the review's locale. Never posts.
5
+ *
6
+ * Pipeline:
7
+ * 1. Fetch the target review
8
+ * 2. If `tone` not provided and client supports Elicitation, ask for it
9
+ * 3. Sampling request to draft the reply
10
+ * 4. Post-filter draft for Apple guideline 1.2 violations (disputes,
11
+ * promo-only content, personal info)
12
+ * 5. Return draft with a warning. Never call Apple's POST endpoint.
13
+ */
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.draftReviewResponse = draftReviewResponse;
16
+ exports.formatDraftForAgent = formatDraftForAgent;
17
+ const sampling_js_1 = require("../sampling.js");
18
+ const elicitation_js_1 = require("../elicitation.js");
19
+ const TONES = ["apologetic", "factual", "promotional", "curious"];
20
+ const APPLE_GUIDELINE_DISCLAIMER = "This is a draft, not a posted response. Always review before posting via App Store Connect. We never post on your behalf.";
21
+ const FORBIDDEN_PATTERNS = [
22
+ { re: /refund\s+(your|you)|contact\s+apple/i, reason: "avoid directing users to Apple for refunds" },
23
+ { re: /lawyer|legal action|sue|attorney/i, reason: "no legal threats" },
24
+ { re: /\b\d{3}[-\s]?\d{3}[-\s]?\d{4}\b/, reason: "remove phone numbers" },
25
+ { re: /\b[\w.+-]+@[\w-]+\.[\w.-]+\b/, reason: "replace email with a generic support link" },
26
+ ];
27
+ async function draftReviewResponse(server, client, args, tier) {
28
+ if (tier !== "pro") {
29
+ return emptyResult(args, "default_factual", {
30
+ note: "draft_review_response requires a Pro license ($9/mo). Get your license at https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu",
31
+ });
32
+ }
33
+ let review;
34
+ try {
35
+ const response = await client.get(`/v1/customerReviews/${args.review_id}`, { "fields[customerReviews]": "rating,title,body,reviewerNickname,createdDate,territory" });
36
+ const data = Array.isArray(response.data) ? response.data[0] : response.data;
37
+ if (!data) {
38
+ return emptyResult(args, "default_factual", {
39
+ note: `Review ${args.review_id} not found.`,
40
+ });
41
+ }
42
+ review = data.attributes;
43
+ }
44
+ catch (err) {
45
+ return emptyResult(args, "default_factual", {
46
+ note: `Could not fetch review: ${err instanceof Error ? err.message : String(err)}`,
47
+ });
48
+ }
49
+ const locale = localeFromTerritory(review.territory);
50
+ let tone = args.tone ?? "default_factual";
51
+ let includeSupportLink = args.include_support_link ?? false;
52
+ let contextNote = (args.context_note ?? "").slice(0, 500);
53
+ if (!args.tone && (0, elicitation_js_1.clientSupportsElicitation)(server)) {
54
+ const elicitResult = await (0, elicitation_js_1.elicit)(server, {
55
+ message: `Drafting a response to a ${review.rating}-star review from ${review.territory}. Set the tone.`,
56
+ schema: {
57
+ type: "object",
58
+ properties: {
59
+ tone: {
60
+ type: "string",
61
+ enum: TONES,
62
+ description: "Response tone.",
63
+ },
64
+ include_support_link: {
65
+ type: "boolean",
66
+ description: "Mention that users can reach support with questions.",
67
+ },
68
+ context_note: {
69
+ type: "string",
70
+ description: "Optional context to weave in (release notes, known-fix mention).",
71
+ maxLength: 500,
72
+ },
73
+ },
74
+ required: ["tone"],
75
+ },
76
+ });
77
+ if (elicitResult.ok) {
78
+ const v = elicitResult.values;
79
+ if (typeof v.tone === "string" && TONES.includes(v.tone)) {
80
+ tone = v.tone;
81
+ }
82
+ if (typeof v.include_support_link === "boolean") {
83
+ includeSupportLink = v.include_support_link;
84
+ }
85
+ if (typeof v.context_note === "string") {
86
+ contextNote = v.context_note.slice(0, 500);
87
+ }
88
+ }
89
+ // declined/cancelled/unsupported all fall through to defaults
90
+ }
91
+ const toneDirective = toneToDirective(tone);
92
+ const supportClause = includeSupportLink
93
+ ? "Remind the user they can reach us for further help. Do not include a specific email or phone."
94
+ : "";
95
+ const contextClause = contextNote ? `Customer context to respect: ${contextNote}` : "";
96
+ const systemPrompt = [
97
+ "You are drafting a public App Store developer response to a customer review.",
98
+ "Rules:",
99
+ ` - Write in the language matching locale ${locale} (ISO code). For en, write English.`,
100
+ " - Apple guideline 1.2 applies: stay factual, courteous, avoid disputing the customer.",
101
+ " - Keep under 500 characters (Apple's practical limit for readability).",
102
+ " - Never include: email addresses, phone numbers, legal threats, refund promises, competitor names, AI disclosures.",
103
+ " - Do not quote the reviewer back at length.",
104
+ " - One paragraph maximum. No headers, no markdown, no emoji unless locale-appropriate.",
105
+ toneDirective,
106
+ supportClause,
107
+ contextClause,
108
+ "Reply with the draft text only, no preamble, no quotes around it.",
109
+ ]
110
+ .filter(Boolean)
111
+ .join("\n");
112
+ const userPrompt = [
113
+ `Review (${review.rating}/5):`,
114
+ `Title: ${review.title || "(none)"}`,
115
+ `Body: ${review.body || "(none)"}`,
116
+ `Reviewer: ${review.reviewerNickname || "Anonymous"}`,
117
+ `Territory: ${review.territory}`,
118
+ ].join("\n");
119
+ const samplingResult = await (0, sampling_js_1.sample)(server, {
120
+ system: systemPrompt,
121
+ user: userPrompt,
122
+ maxTokens: 500,
123
+ temperature: 0.4,
124
+ modelPreferences: sampling_js_1.MODEL_HINTS.balanced,
125
+ });
126
+ if (!samplingResult.ok) {
127
+ if ("unsupported" in samplingResult && samplingResult.unsupported) {
128
+ return emptyResult(args, tone, {
129
+ locale,
130
+ note: "Your MCP client does not support Sampling. Drafting unavailable. Upgrade Claude Desktop or Claude Code, or draft by hand.",
131
+ });
132
+ }
133
+ return emptyResult(args, tone, {
134
+ locale,
135
+ note: `Sampling failed: ${"error" in samplingResult ? samplingResult.error : "unknown"}`,
136
+ });
137
+ }
138
+ const draft = cleanDraft(samplingResult.text);
139
+ const filterViolation = filterForbidden(draft);
140
+ if (filterViolation) {
141
+ return {
142
+ app_id: args.app_id,
143
+ review_id: args.review_id,
144
+ locale,
145
+ tone_used: tone,
146
+ draft: "",
147
+ warning: `Draft rejected by post-filter: ${filterViolation}. Try a different tone, or edit manually.`,
148
+ degraded: true,
149
+ };
150
+ }
151
+ return {
152
+ app_id: args.app_id,
153
+ review_id: args.review_id,
154
+ locale,
155
+ tone_used: tone,
156
+ draft,
157
+ warning: APPLE_GUIDELINE_DISCLAIMER,
158
+ degraded: false,
159
+ };
160
+ }
161
+ function emptyResult(args, tone, extras) {
162
+ return {
163
+ app_id: args.app_id,
164
+ review_id: args.review_id,
165
+ locale: extras.locale ?? "en",
166
+ tone_used: tone,
167
+ draft: "",
168
+ warning: APPLE_GUIDELINE_DISCLAIMER,
169
+ degraded: true,
170
+ note: extras.note,
171
+ };
172
+ }
173
+ function localeFromTerritory(territory) {
174
+ const map = {
175
+ US: "en", GB: "en", CA: "en", AU: "en", IE: "en", NZ: "en",
176
+ DE: "de", AT: "de", CH: "de",
177
+ FR: "fr", BE: "fr",
178
+ ES: "es", MX: "es", AR: "es", CO: "es", CL: "es",
179
+ IT: "it",
180
+ NL: "nl",
181
+ JP: "ja",
182
+ KR: "ko",
183
+ CN: "zh-Hans", HK: "zh-Hant", TW: "zh-Hant",
184
+ BR: "pt-BR", PT: "pt",
185
+ RU: "ru",
186
+ PL: "pl",
187
+ TR: "tr",
188
+ SE: "sv",
189
+ NO: "nb",
190
+ DK: "da",
191
+ FI: "fi",
192
+ };
193
+ return map[territory] ?? "en";
194
+ }
195
+ function toneToDirective(tone) {
196
+ switch (tone) {
197
+ case "apologetic":
198
+ return "Tone: warmly apologetic. Acknowledge the issue, avoid excuses.";
199
+ case "promotional":
200
+ return "Tone: brief, forward-looking. Mention an upcoming improvement only if it is real and concrete.";
201
+ case "curious":
202
+ return "Tone: curious and inviting. Ask one clarifying question in case they want to share more detail.";
203
+ case "factual":
204
+ case "default_factual":
205
+ default:
206
+ return "Tone: neutral and factual. Acknowledge, then state what you intend to do next.";
207
+ }
208
+ }
209
+ function cleanDraft(text) {
210
+ return text
211
+ .trim()
212
+ .replace(/^["']|["']$/g, "")
213
+ .replace(/^\s*(draft|reply|response)\s*[:\-]\s*/i, "")
214
+ .slice(0, 1200);
215
+ }
216
+ function filterForbidden(draft) {
217
+ for (const { re, reason } of FORBIDDEN_PATTERNS) {
218
+ if (re.test(draft))
219
+ return reason;
220
+ }
221
+ return null;
222
+ }
223
+ function formatDraftForAgent(res) {
224
+ if (!res.draft) {
225
+ return res.note ?? "No draft produced.";
226
+ }
227
+ const lines = [
228
+ `# Draft response (locale ${res.locale}, tone ${res.tone_used})`,
229
+ "",
230
+ res.draft,
231
+ "",
232
+ `_${res.warning}_`,
233
+ ];
234
+ return lines.join("\n");
235
+ }
236
+ //# sourceMappingURL=draft-review-response.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"draft-review-response.js","sourceRoot":"","sources":["../../src/tools/draft-review-response.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * triage_reviews tool (Pro). Uses MCP Sampling to cluster customer reviews
3
+ * into themes on the user's own Claude (zero cost to us).
4
+ *
5
+ * Pipeline:
6
+ * 1. Fetch up to `limit` reviews via the ASC API (reuses list_reviews logic)
7
+ * 2. If none, return empty result, skip Sampling
8
+ * 3. Ask the user's client to cluster via Sampling
9
+ * 4. Parse JSON response from the model; degrade gracefully on parse error
10
+ */
11
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
12
+ import type { ASCClient } from "../client.js";
13
+ import type { Tier } from "../types.js";
14
+ interface Theme {
15
+ theme: string;
16
+ count: number;
17
+ action_bucket: "bug" | "missing_feature" | "pricing" | "ux" | "content" | "other";
18
+ quote: string;
19
+ }
20
+ export interface TriageResult {
21
+ app_id: string;
22
+ reviews_analyzed: number;
23
+ themes: Theme[];
24
+ note?: string;
25
+ degraded: boolean;
26
+ }
27
+ export declare function triageReviews(server: McpServer, client: ASCClient, args: {
28
+ app_id: string;
29
+ rating?: number;
30
+ limit?: number;
31
+ days?: number;
32
+ }, tier: Tier): Promise<TriageResult>;
33
+ export declare function formatTriageForAgent(res: TriageResult): string;
34
+ export {};
35
+ //# sourceMappingURL=triage-reviews.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"triage-reviews.d.ts","sourceRoot":"","sources":["../../src/tools/triage-reviews.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAYxC,UAAU,KAAK;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,KAAK,GAAG,iBAAiB,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IAClF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAuBD,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACxE,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,YAAY,CAAC,CA4GvB;AA2CD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAkB9D"}