@pofky/asc-mcp 1.2.0 → 1.8.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.
Files changed (119) hide show
  1. package/LIMITATIONS.md +41 -0
  2. package/README.md +91 -10
  3. package/USER_GUIDE.md +185 -0
  4. package/dist/client.d.ts +5 -0
  5. package/dist/client.d.ts.map +1 -1
  6. package/dist/client.js +58 -1
  7. package/dist/client.js.map +1 -1
  8. package/dist/doctor.d.ts +28 -0
  9. package/dist/doctor.d.ts.map +1 -0
  10. package/dist/doctor.js +178 -0
  11. package/dist/doctor.js.map +1 -0
  12. package/dist/editable.d.ts +9 -0
  13. package/dist/editable.d.ts.map +1 -0
  14. package/dist/editable.js +20 -0
  15. package/dist/editable.js.map +1 -0
  16. package/dist/elicitation.d.ts +39 -0
  17. package/dist/elicitation.d.ts.map +1 -0
  18. package/dist/elicitation.js +63 -0
  19. package/dist/elicitation.js.map +1 -0
  20. package/dist/gate.d.ts +8 -0
  21. package/dist/gate.d.ts.map +1 -0
  22. package/dist/gate.js +17 -0
  23. package/dist/gate.js.map +1 -0
  24. package/dist/index.js +308 -16
  25. package/dist/index.js.map +1 -1
  26. package/dist/license.js +1 -1
  27. package/dist/prompts.d.ts.map +1 -1
  28. package/dist/prompts.js +101 -0
  29. package/dist/prompts.js.map +1 -1
  30. package/dist/sampling.d.ts +53 -0
  31. package/dist/sampling.d.ts.map +1 -0
  32. package/dist/sampling.js +109 -0
  33. package/dist/sampling.js.map +1 -0
  34. package/dist/setup.d.ts +19 -0
  35. package/dist/setup.d.ts.map +1 -0
  36. package/dist/setup.js +153 -0
  37. package/dist/setup.js.map +1 -0
  38. package/dist/tools/age-rating.d.ts +14 -0
  39. package/dist/tools/age-rating.d.ts.map +1 -0
  40. package/dist/tools/age-rating.js +125 -0
  41. package/dist/tools/age-rating.js.map +1 -0
  42. package/dist/tools/app-details.js +2 -2
  43. package/dist/tools/availability.d.ts +20 -0
  44. package/dist/tools/availability.d.ts.map +1 -0
  45. package/dist/tools/availability.js +96 -0
  46. package/dist/tools/availability.js.map +1 -0
  47. package/dist/tools/builds.d.ts +26 -0
  48. package/dist/tools/builds.d.ts.map +1 -0
  49. package/dist/tools/builds.js +108 -0
  50. package/dist/tools/builds.js.map +1 -0
  51. package/dist/tools/draft-review-response.d.ts +37 -0
  52. package/dist/tools/draft-review-response.d.ts.map +1 -0
  53. package/dist/tools/draft-review-response.js +236 -0
  54. package/dist/tools/draft-review-response.js.map +1 -0
  55. package/dist/tools/eu-trader.d.ts +12 -0
  56. package/dist/tools/eu-trader.d.ts.map +1 -0
  57. package/dist/tools/eu-trader.js +25 -0
  58. package/dist/tools/eu-trader.js.map +1 -0
  59. package/dist/tools/guide.d.ts +38 -0
  60. package/dist/tools/guide.d.ts.map +1 -0
  61. package/dist/tools/guide.js +273 -0
  62. package/dist/tools/guide.js.map +1 -0
  63. package/dist/tools/iap.d.ts +43 -0
  64. package/dist/tools/iap.d.ts.map +1 -0
  65. package/dist/tools/iap.js +360 -0
  66. package/dist/tools/iap.js.map +1 -0
  67. package/dist/tools/list-apps.js +1 -1
  68. package/dist/tools/list-reviews.js +2 -2
  69. package/dist/tools/local-build.d.ts +26 -0
  70. package/dist/tools/local-build.d.ts.map +1 -0
  71. package/dist/tools/local-build.js +100 -0
  72. package/dist/tools/local-build.js.map +1 -0
  73. package/dist/tools/privacy.d.ts +15 -0
  74. package/dist/tools/privacy.d.ts.map +1 -0
  75. package/dist/tools/privacy.js +32 -0
  76. package/dist/tools/privacy.js.map +1 -0
  77. package/dist/tools/release-control.d.ts +22 -0
  78. package/dist/tools/release-control.d.ts.map +1 -0
  79. package/dist/tools/release-control.js +85 -0
  80. package/dist/tools/release-control.js.map +1 -0
  81. package/dist/tools/release-preflight.d.ts.map +1 -1
  82. package/dist/tools/release-preflight.js +139 -0
  83. package/dist/tools/release-preflight.js.map +1 -1
  84. package/dist/tools/review-screenshot.d.ts +14 -0
  85. package/dist/tools/review-screenshot.d.ts.map +1 -0
  86. package/dist/tools/review-screenshot.js +72 -0
  87. package/dist/tools/review-screenshot.js.map +1 -0
  88. package/dist/tools/review-status.js +2 -2
  89. package/dist/tools/sales-report.js +3 -3
  90. package/dist/tools/sales-report.js.map +1 -1
  91. package/dist/tools/screenshots.d.ts +15 -0
  92. package/dist/tools/screenshots.d.ts.map +1 -0
  93. package/dist/tools/screenshots.js +106 -0
  94. package/dist/tools/screenshots.js.map +1 -0
  95. package/dist/tools/signing.d.ts +21 -0
  96. package/dist/tools/signing.d.ts.map +1 -0
  97. package/dist/tools/signing.js +101 -0
  98. package/dist/tools/signing.js.map +1 -0
  99. package/dist/tools/submission.d.ts +47 -0
  100. package/dist/tools/submission.d.ts.map +1 -0
  101. package/dist/tools/submission.js +199 -0
  102. package/dist/tools/submission.js.map +1 -0
  103. package/dist/tools/testflight.d.ts +20 -0
  104. package/dist/tools/testflight.d.ts.map +1 -0
  105. package/dist/tools/testflight.js +75 -0
  106. package/dist/tools/testflight.js.map +1 -0
  107. package/dist/tools/triage-reviews.d.ts +35 -0
  108. package/dist/tools/triage-reviews.d.ts.map +1 -0
  109. package/dist/tools/triage-reviews.js +194 -0
  110. package/dist/tools/triage-reviews.js.map +1 -0
  111. package/dist/tools/update-version-metadata.d.ts +17 -0
  112. package/dist/tools/update-version-metadata.d.ts.map +1 -0
  113. package/dist/tools/update-version-metadata.js +148 -0
  114. package/dist/tools/update-version-metadata.js.map +1 -0
  115. package/dist/tools/version-control.d.ts +21 -0
  116. package/dist/tools/version-control.d.ts.map +1 -0
  117. package/dist/tools/version-control.js +144 -0
  118. package/dist/tools/version-control.js.map +1 -0
  119. package/package.json +5 -2
@@ -0,0 +1 @@
1
+ {"version":3,"file":"availability.js","sourceRoot":"","sources":["../../src/tools/availability.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ import type { ASCClient } from "../client.js";
2
+ import type { Tier } from "../types.js";
3
+ /** List recent builds for an app with their processing state. */
4
+ export declare function listBuilds(client: ASCClient, args: {
5
+ app_id: string;
6
+ limit?: number;
7
+ }, tier: Tier): Promise<string>;
8
+ /**
9
+ * Poll until the newest build for an app finishes processing (state VALID),
10
+ * so the ship flow can be one call instead of manual polling. Bounded by
11
+ * max_wait_seconds; returns as soon as a VALID build appears or it times out.
12
+ */
13
+ export declare function waitForBuild(client: ASCClient, args: {
14
+ app_id: string;
15
+ max_wait_seconds?: number;
16
+ poll_seconds?: number;
17
+ }, tier: Tier): Promise<string>;
18
+ /**
19
+ * Attach a build to the editable App Store version. If no build_id is given,
20
+ * picks the newest VALID (processed) build automatically.
21
+ */
22
+ export declare function attachBuild(client: ASCClient, args: {
23
+ app_id: string;
24
+ build_id?: string;
25
+ }, tier: Tier): Promise<string>;
26
+ //# sourceMappingURL=builds.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"builds.d.ts","sourceRoot":"","sources":["../../src/tools/builds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAexC,iEAAiE;AACjE,wBAAsB,UAAU,CAC9B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1E,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,CA2CjB"}
@@ -0,0 +1,108 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.listBuilds = listBuilds;
4
+ exports.waitForBuild = waitForBuild;
5
+ exports.attachBuild = attachBuild;
6
+ const gate_js_1 = require("../gate.js");
7
+ const editable_js_1 = require("../editable.js");
8
+ /** List recent builds for an app with their processing state. */
9
+ async function listBuilds(client, args, tier) {
10
+ const gate = (0, gate_js_1.requirePro)(tier, "Listing builds");
11
+ if (gate)
12
+ return gate;
13
+ const res = await client.get("/v1/builds", {
14
+ "filter[app]": args.app_id,
15
+ sort: "-uploadedDate",
16
+ "fields[builds]": "version,processingState,uploadedDate,expired",
17
+ limit: String(Math.min(args.limit ?? 10, 50)),
18
+ });
19
+ const builds = Array.isArray(res.data) ? res.data : [res.data];
20
+ if (!builds.length) {
21
+ return "No builds found. Upload one with upload_binary (or Xcode/Transporter) first.";
22
+ }
23
+ const lines = builds.map((b) => {
24
+ const a = b.attributes;
25
+ const flag = a.expired ? " (expired)" : "";
26
+ return `- Build ${a.version} [${b.id}]: ${a.processingState}${flag}, uploaded ${a.uploadedDate?.slice(0, 10) ?? "?"}`;
27
+ });
28
+ return `Builds for app ${args.app_id}:\n${lines.join("\n")}`;
29
+ }
30
+ /**
31
+ * Poll until the newest build for an app finishes processing (state VALID),
32
+ * so the ship flow can be one call instead of manual polling. Bounded by
33
+ * max_wait_seconds; returns as soon as a VALID build appears or it times out.
34
+ */
35
+ async function waitForBuild(client, args, tier) {
36
+ const gate = (0, gate_js_1.requirePro)(tier, "Waiting for a build");
37
+ if (gate)
38
+ return gate;
39
+ const maxWait = Math.min(args.max_wait_seconds ?? 1800, 3600) * 1000;
40
+ const poll = Math.max(args.poll_seconds ?? 30, 10) * 1000;
41
+ const start = Date.now();
42
+ let last = "";
43
+ while (Date.now() - start < maxWait) {
44
+ const res = await client.get("/v1/builds", {
45
+ "filter[app]": args.app_id,
46
+ sort: "-uploadedDate",
47
+ "fields[builds]": "version,processingState",
48
+ limit: "1",
49
+ });
50
+ const builds = Array.isArray(res.data) ? res.data : [res.data];
51
+ const newest = builds[0];
52
+ if (!newest) {
53
+ last = "no builds yet";
54
+ }
55
+ else {
56
+ last = `${newest.attributes.version}: ${newest.attributes.processingState}`;
57
+ if (newest.attributes.processingState === "VALID") {
58
+ return `Build ${newest.attributes.version} is VALID and ready [${newest.id}]. Attach it with attach_build.`;
59
+ }
60
+ if (newest.attributes.processingState === "FAILED" || newest.attributes.processingState === "INVALID") {
61
+ return `Build ${newest.attributes.version} processing ${newest.attributes.processingState}. Check App Store Connect for details.`;
62
+ }
63
+ }
64
+ await new Promise((r) => setTimeout(r, poll));
65
+ }
66
+ return `Timed out after ${Math.round(maxWait / 1000)}s waiting for a VALID build. Last seen: ${last}.`;
67
+ }
68
+ /**
69
+ * Attach a build to the editable App Store version. If no build_id is given,
70
+ * picks the newest VALID (processed) build automatically.
71
+ */
72
+ async function attachBuild(client, args, tier) {
73
+ const gate = (0, gate_js_1.requirePro)(tier, "Attaching a build");
74
+ if (gate)
75
+ return gate;
76
+ // Find the editable version.
77
+ const versionsRes = await client.get(`/v1/apps/${args.app_id}/appStoreVersions`, { "fields[appStoreVersions]": "versionString,appStoreState", limit: "5" });
78
+ const versions = Array.isArray(versionsRes.data) ? versionsRes.data : [versionsRes.data];
79
+ const version = versions.find((v) => editable_js_1.EDITABLE_VERSION_STATES.has(v.attributes.appStoreState));
80
+ if (!version) {
81
+ return "No editable version to attach a build to. Create one with create_version first.";
82
+ }
83
+ // Resolve build: explicit id, else newest processed (VALID) build.
84
+ let buildId = args.build_id;
85
+ let buildVersion = buildId ?? "";
86
+ if (!buildId) {
87
+ const res = await client.get("/v1/builds", {
88
+ "filter[app]": args.app_id,
89
+ "filter[processingState]": "VALID",
90
+ sort: "-uploadedDate",
91
+ "fields[builds]": "version",
92
+ limit: "1",
93
+ });
94
+ const builds = Array.isArray(res.data) ? res.data : [res.data];
95
+ const newest = builds[0];
96
+ if (!newest) {
97
+ return "No processed (VALID) build available yet. Wait for processing or check list_builds.";
98
+ }
99
+ buildId = newest.id;
100
+ buildVersion = newest.attributes.version;
101
+ }
102
+ await client.patch(`/v1/appStoreVersions/${version.id}/relationships/build`, {
103
+ data: { type: "builds", id: buildId },
104
+ });
105
+ return (`Attached build ${buildVersion} [${buildId}] to version ${version.attributes.versionString}.\n` +
106
+ "Run release_preflight, then submit_for_review.");
107
+ }
108
+ //# sourceMappingURL=builds.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"builds.js","sourceRoot":"","sources":["../../src/tools/builds.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":";AAAA;;;;;;;;;;;GAWG;;AAiDH,kDAuJC;AAwED,kDAYC;AAvRD,gDAAqD;AACrD,sDAAsE;AAYtE,MAAM,KAAK,GAAW,CAAC,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;AAqB1E,MAAM,0BAA0B,GAC9B,2HAA2H,CAAC;AAE9H,MAAM,kBAAkB,GAA0C;IAChE,EAAE,EAAE,EAAE,sCAAsC,EAAE,MAAM,EAAE,4CAA4C,EAAE;IACpG,EAAE,EAAE,EAAE,mCAAmC,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACvE,EAAE,EAAE,EAAE,iCAAiC,EAAE,MAAM,EAAE,sBAAsB,EAAE;IACzE,EAAE,EAAE,EAAE,8BAA8B,EAAE,MAAM,EAAE,2CAA2C,EAAE;CAC5F,CAAC;AAEK,KAAK,UAAU,mBAAmB,CACvC,MAAiB,EACjB,MAAiB,EACjB,IAAe,EACf,IAAU;IAEV,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE;YAC1C,IAAI,EAAE,qJAAqJ;SAC5J,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,uBAAuB,IAAI,CAAC,SAAS,EAAE,EACvC,EAAE,yBAAyB,EAAE,0DAA0D,EAAE,CAC1F,CAAC;QACF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7E,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE;gBAC1C,IAAI,EAAE,UAAU,IAAI,CAAC,SAAS,aAAa;aAC5C,CAAC,CAAC;QACL,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE;YAC1C,IAAI,EAAE,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACpF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAErD,IAAI,IAAI,GAA6B,IAAI,CAAC,IAAI,IAAI,iBAAiB,CAAC;IACpE,IAAI,kBAAkB,GAAG,IAAI,CAAC,oBAAoB,IAAI,KAAK,CAAC;IAC5D,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE1D,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAA,0CAAyB,EAAC,MAAM,CAAC,EAAE,CAAC;QACpD,MAAM,YAAY,GAAG,MAAM,IAAA,uBAAM,EAAC,MAAM,EAAE;YACxC,OAAO,EAAE,4BAA4B,MAAM,CAAC,MAAM,qBAAqB,MAAM,CAAC,SAAS,iBAAiB;YACxG,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,KAAK;wBACX,WAAW,EAAE,gBAAgB;qBAC9B;oBACD,oBAAoB,EAAE;wBACpB,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,sDAAsD;qBACpE;oBACD,YAAY,EAAE;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,kEAAkE;wBAC/E,SAAS,EAAE,GAAG;qBACf;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;SACF,CAAC,CAAC;QACH,IAAI,YAAY,CAAC,EAAE,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;YAC9B,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAK,KAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvE,IAAI,GAAG,CAAC,CAAC,IAAY,CAAC;YACxB,CAAC;YACD,IAAI,OAAO,CAAC,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;gBAChD,kBAAkB,GAAG,CAAC,CAAC,oBAAoB,CAAC;YAC9C,CAAC;YACD,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACvC,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,8DAA8D;IAChE,CAAC;IAED,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,kBAAkB;QACtC,CAAC,CAAC,+FAA+F;QACjG,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvF,MAAM,YAAY,GAAG;QACnB,8EAA8E;QAC9E,QAAQ;QACR,6CAA6C,MAAM,qCAAqC;QACxF,yFAAyF;QACzF,0EAA0E;QAC1E,sHAAsH;QACtH,+CAA+C;QAC/C,yFAAyF;QACzF,aAAa;QACb,aAAa;QACb,aAAa;QACb,mEAAmE;KACpE;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,UAAU,GAAG;QACjB,WAAW,MAAM,CAAC,MAAM,MAAM;QAC9B,UAAU,MAAM,CAAC,KAAK,IAAI,QAAQ,EAAE;QACpC,SAAS,MAAM,CAAC,IAAI,IAAI,QAAQ,EAAE;QAClC,aAAa,MAAM,CAAC,gBAAgB,IAAI,WAAW,EAAE;QACrD,cAAc,MAAM,CAAC,SAAS,EAAE;KACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,cAAc,GAAG,MAAM,IAAA,oBAAM,EAAC,MAAM,EAAE;QAC1C,MAAM,EAAE,YAAY;QACpB,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,GAAG;QAChB,gBAAgB,EAAE,yBAAW,CAAC,QAAQ;KACvC,CAAC,CAAC;IAEH,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC;QACvB,IAAI,aAAa,IAAI,cAAc,IAAI,cAAc,CAAC,WAAW,EAAE,CAAC;YAClE,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE;gBAC7B,MAAM;gBACN,IAAI,EAAE,2HAA2H;aAClI,CAAC,CAAC;QACL,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE;YAC7B,MAAM;YACN,IAAI,EAAE,oBAAoB,OAAO,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE;SACzF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM;YACN,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,kCAAkC,eAAe,2CAA2C;YACrG,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM;QACN,SAAS,EAAE,IAAI;QACf,KAAK;QACL,OAAO,EAAE,0BAA0B;QACnC,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,IAAe,EACf,IAA8B,EAC9B,MAA0C;IAE1C,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,0BAA0B;QACnC,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,SAAiB;IAC5C,MAAM,GAAG,GAA2B;QAClC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI;QAC1D,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI;QAC5B,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI;QAClB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI;QAChD,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS;QAC3C,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI;QACrB,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;KACT,CAAC;IACF,OAAO,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;AAChC,CAAC;AAED,SAAS,eAAe,CAAC,IAA8B;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,gEAAgE,CAAC;QAC1E,KAAK,aAAa;YAChB,OAAO,gGAAgG,CAAC;QAC1G,KAAK,SAAS;YACZ,OAAO,iGAAiG,CAAC;QAC3G,KAAK,SAAS,CAAC;QACf,KAAK,iBAAiB,CAAC;QACvB;YACE,OAAO,gFAAgF,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,IAAI,EAAE;SACN,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,wCAAwC,EAAE,EAAE,CAAC;SACrD,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,KAAK,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,kBAAkB,EAAE,CAAC;QAChD,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,mBAAmB,CAAC,GAAgB;IAClD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,IAAI,IAAI,oBAAoB,CAAC;IAC1C,CAAC;IACD,MAAM,KAAK,GAAG;QACZ,4BAA4B,GAAG,CAAC,MAAM,UAAU,GAAG,CAAC,SAAS,GAAG;QAChE,EAAE;QACF,GAAG,CAAC,KAAK;QACT,EAAE;QACF,IAAI,GAAG,CAAC,OAAO,GAAG;KACnB,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,12 @@
1
+ import type { Tier } from "../types.js";
2
+ export interface EUTraderArgs {
3
+ app_id: string;
4
+ }
5
+ /**
6
+ * EU Digital Services Act "trader status" is required before an app can stay
7
+ * available in the EU. Apple does not expose it through the public App Store
8
+ * Connect API (no trader attribute on apps; no dedicated resource, probed live
9
+ * 2026-06-26), so this returns the exact steps plus a deep link.
10
+ */
11
+ export declare function setEUTraderStatus(args: EUTraderArgs, tier: Tier): Promise<string>;
12
+ //# sourceMappingURL=eu-trader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"eu-trader.d.ts","sourceRoot":"","sources":["../../src/tools/eu-trader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBvF"}
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.setEUTraderStatus = setEUTraderStatus;
4
+ const gate_js_1 = require("../gate.js");
5
+ /**
6
+ * EU Digital Services Act "trader status" is required before an app can stay
7
+ * available in the EU. Apple does not expose it through the public App Store
8
+ * Connect API (no trader attribute on apps; no dedicated resource, probed live
9
+ * 2026-06-26), so this returns the exact steps plus a deep link.
10
+ */
11
+ async function setEUTraderStatus(args, tier) {
12
+ const gate = (0, gate_js_1.requirePro)(tier, "Declaring EU trader status");
13
+ if (gate)
14
+ return gate;
15
+ const url = `https://appstoreconnect.apple.com/apps/${args.app_id}/distribution/info`;
16
+ return ("EU trader status (Digital Services Act) is not API-addressable; declare it once in App Store Connect:\n\n" +
17
+ `1. Open ${url} (App Information).\n` +
18
+ "2. Find 'Trader Status' and choose Trader or Non-Trader.\n" +
19
+ " - If you sell paid apps or in-app purchases in the EU, you are a Trader and must publish your\n" +
20
+ " name, address, email, and phone, which Apple shows on your EU product pages.\n" +
21
+ " - Non-Trader removes EU availability for paid distribution.\n" +
22
+ "3. Complete the contact details under Business > and save.\n\n" +
23
+ "Required before an app with EU availability can pass review. This is a legal decision: confirm with the account owner.");
24
+ }
25
+ //# sourceMappingURL=eu-trader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"eu-trader.js","sourceRoot":"","sources":["../../src/tools/eu-trader.ts"],"names":[],"mappings":";;AAaA,8CAgBC;AA5BD,wCAAwC;AAMxC;;;;;GAKG;AACI,KAAK,UAAU,iBAAiB,CAAC,IAAkB,EAAE,IAAU;IACpE,MAAM,IAAI,GAAG,IAAA,oBAAU,EAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC;IAC5D,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,GAAG,GAAG,0CAA0C,IAAI,CAAC,MAAM,oBAAoB,CAAC;IAEtF,OAAO,CACL,2GAA2G;QAC3G,WAAW,GAAG,uBAAuB;QACrC,4DAA4D;QAC5D,oGAAoG;QACpG,qFAAqF;QACrF,kEAAkE;QAClE,gEAAgE;QAChE,wHAAwH,CACzH,CAAC;AACJ,CAAC"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * asc_guide - the orientation layer.
3
+ *
4
+ * The MCP has 30+ tools and a control plane with real, non-obvious limits
5
+ * (atomic PATCH, V2 age rating, per-territory pricing, first-IAP-on-version,
6
+ * ASC-UI-only privacy/trader). An agent that just sees a flat tool list will
7
+ * stumble into those. This tool is the map: it returns the exact end-to-end
8
+ * playbook for a given goal, with the manual ASC-website / Xcode interruptions
9
+ * called out inline at the step where they bite.
10
+ *
11
+ * Free tier: orientation is never gated. Users should be able to read the flows
12
+ * (and see what Pro unlocks) before paying.
13
+ */
14
+ export type GuideTopic = "overview" | "setup" | "first-app" | "update" | "screenshots" | "iap" | "subscriptions" | "reviews" | "testflight" | "binary" | "limitations";
15
+ export interface GuideArgs {
16
+ topic?: GuideTopic;
17
+ }
18
+ interface Flow {
19
+ title: string;
20
+ when: string;
21
+ /** Ordered steps. A step starting with "MANUAL:" is a hand-step in the ASC website / Xcode that no API can do. */
22
+ steps: string[];
23
+ /** Manual interruptions specific to this flow, restated so they are impossible to miss. */
24
+ manual: string[];
25
+ }
26
+ declare const FLOWS: Record<Exclude<GuideTopic, "overview" | "limitations">, Flow>;
27
+ declare const LIMITATIONS: {
28
+ item: string;
29
+ why: string;
30
+ doInstead: string;
31
+ }[];
32
+ declare function renderFlow(f: Flow): string;
33
+ declare function renderOverview(): string;
34
+ declare function renderLimitations(): string;
35
+ export declare function ascGuide(args: GuideArgs): Promise<string>;
36
+ /** Exposed so docs generation and tests can reuse the same source of truth. */
37
+ export { FLOWS, LIMITATIONS, renderFlow, renderOverview, renderLimitations };
38
+ //# sourceMappingURL=guide.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/tools/guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,OAAO,GACP,WAAW,GACX,QAAQ,GACR,aAAa,GACb,KAAK,GACL,eAAe,GACf,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,UAAU,IAAI;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,kHAAkH;IAClH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2FAA2F;IAC3F,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,QAAA,MAAM,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,CAAC,EAAE,IAAI,CA2JxE,CAAC;AAEF,QAAA,MAAM,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EA8ClE,CAAC;AAEF,iBAAS,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAcnC;AAED,iBAAS,cAAc,IAAI,MAAM,CAuBhC;AAED,iBAAS,iBAAiB,IAAI,MAAM,CAUnC;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAO/D;AAED,+EAA+E;AAC/E,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC"}