@cliangdev/conductor 0.52.0 → 0.53.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 (62) hide show
  1. package/assets/claude/skills/conductor-marketing-report/SKILL.md +2 -2
  2. package/assets/cli-manifest.json +257 -19
  3. package/dist/mcp/index.d.ts +10979 -187
  4. package/dist/mcp/index.d.ts.map +1 -1
  5. package/dist/mcp/index.js +569 -3
  6. package/dist/mcp/index.js.map +1 -1
  7. package/dist/mcp/tools/ai-visibility.d.ts +18 -0
  8. package/dist/mcp/tools/ai-visibility.d.ts.map +1 -0
  9. package/dist/mcp/tools/ai-visibility.js +124 -0
  10. package/dist/mcp/tools/ai-visibility.js.map +1 -0
  11. package/dist/mcp/tools/budget.d.ts +35 -0
  12. package/dist/mcp/tools/budget.d.ts.map +1 -0
  13. package/dist/mcp/tools/budget.js +205 -0
  14. package/dist/mcp/tools/budget.js.map +1 -0
  15. package/dist/mcp/tools/creators.d.ts +15 -0
  16. package/dist/mcp/tools/creators.d.ts.map +1 -0
  17. package/dist/mcp/tools/creators.js +69 -0
  18. package/dist/mcp/tools/creators.js.map +1 -0
  19. package/dist/mcp/tools/growth-signals.d.ts +38 -0
  20. package/dist/mcp/tools/growth-signals.d.ts.map +1 -0
  21. package/dist/mcp/tools/growth-signals.js +135 -0
  22. package/dist/mcp/tools/growth-signals.js.map +1 -0
  23. package/dist/mcp/tools/insights.d.ts +9 -0
  24. package/dist/mcp/tools/insights.d.ts.map +1 -1
  25. package/dist/mcp/tools/insights.js +6 -1
  26. package/dist/mcp/tools/insights.js.map +1 -1
  27. package/dist/mcp/tools/links.d.ts +26 -0
  28. package/dist/mcp/tools/links.d.ts.map +1 -0
  29. package/dist/mcp/tools/links.js +92 -0
  30. package/dist/mcp/tools/links.js.map +1 -0
  31. package/dist/mcp/tools/marketing-changes.d.ts +25 -0
  32. package/dist/mcp/tools/marketing-changes.d.ts.map +1 -0
  33. package/dist/mcp/tools/marketing-changes.js +108 -0
  34. package/dist/mcp/tools/marketing-changes.js.map +1 -0
  35. package/dist/mcp/tools/marketing-definitions.d.ts +11 -0
  36. package/dist/mcp/tools/marketing-definitions.d.ts.map +1 -0
  37. package/dist/mcp/tools/marketing-definitions.js +37 -0
  38. package/dist/mcp/tools/marketing-definitions.js.map +1 -0
  39. package/dist/mcp/tools/marketing-report.d.ts +7 -0
  40. package/dist/mcp/tools/marketing-report.d.ts.map +1 -1
  41. package/dist/mcp/tools/marketing-report.js +43 -5
  42. package/dist/mcp/tools/marketing-report.js.map +1 -1
  43. package/dist/mcp/tools/posts.d.ts.map +1 -1
  44. package/dist/mcp/tools/posts.js +16 -0
  45. package/dist/mcp/tools/posts.js.map +1 -1
  46. package/dist/mcp/tools/promises.d.ts +39 -0
  47. package/dist/mcp/tools/promises.d.ts.map +1 -0
  48. package/dist/mcp/tools/promises.js +98 -0
  49. package/dist/mcp/tools/promises.js.map +1 -0
  50. package/dist/mcp/tools/proposals.d.ts +26 -0
  51. package/dist/mcp/tools/proposals.d.ts.map +1 -0
  52. package/dist/mcp/tools/proposals.js +102 -0
  53. package/dist/mcp/tools/proposals.js.map +1 -0
  54. package/dist/mcp/tools/switchback.d.ts +36 -0
  55. package/dist/mcp/tools/switchback.d.ts.map +1 -0
  56. package/dist/mcp/tools/switchback.js +123 -0
  57. package/dist/mcp/tools/switchback.js.map +1 -0
  58. package/dist/mcp/tools/verification.d.ts +24 -0
  59. package/dist/mcp/tools/verification.d.ts.map +1 -0
  60. package/dist/mcp/tools/verification.js +124 -0
  61. package/dist/mcp/tools/verification.js.map +1 -0
  62. package/package.json +1 -1
@@ -0,0 +1,124 @@
1
+ import { apiGet, apiPost, apiPut } from '../api.js';
2
+ /**
3
+ * AI-assistant visibility (`/marketing/ai-visibility`): a weekly check of whether AI assistants name the brand for a
4
+ * fixed set of questions. Outputs are compacted per `docs/mcp-tool-guidelines.md`. `named: false` is kept as an
5
+ * explicit false (an assistant answered and did not name the brand); an assistant with no credential, an error or an
6
+ * unchecked week never appears as a reading, so it can never be mistaken for "not named".
7
+ */
8
+ export const MAX_EXCERPT = 240;
9
+ const MAX_WEEKS = 52;
10
+ const MAX_QUESTIONS = 20;
11
+ const MAX_QUESTION_LENGTH = 400;
12
+ const MAX_BRAND_TERMS = 10;
13
+ const MAX_TERM_LENGTH = 80;
14
+ function base(config) {
15
+ return `/api/v2/projects/${config.projectId}/marketing/ai-visibility`;
16
+ }
17
+ function shorten(text) {
18
+ if (typeof text !== 'string' || text === '')
19
+ return undefined;
20
+ const flat = text.replace(/\s+/g, ' ').trim();
21
+ return flat.length > MAX_EXCERPT ? `${flat.slice(0, MAX_EXCERPT)}...` : flat;
22
+ }
23
+ function compactAssistant(a) {
24
+ const latest = a.latest ?? {};
25
+ const out = { assistant: a.assistant };
26
+ if (latest.weekStart)
27
+ out['week'] = latest.weekStart;
28
+ if (typeof latest.named === 'boolean')
29
+ out['named'] = latest.named;
30
+ if (typeof latest.rankInAnswer === 'number')
31
+ out['rank'] = latest.rankInAnswer;
32
+ const excerpt = shorten(latest.excerpt);
33
+ if (excerpt)
34
+ out['excerpt'] = excerpt;
35
+ if (latest.model)
36
+ out['model'] = latest.model;
37
+ out['trend'] = (a.trend ?? []).map((t) => `${t.weekStart}:${t.named ? 'named' : 'not-named'}`);
38
+ return out;
39
+ }
40
+ function compactQuestion(q) {
41
+ const out = { id: q.id, question: q.question };
42
+ if (q.active === false)
43
+ out['active'] = false;
44
+ out['assistants'] = (q.assistants ?? []).map(compactAssistant);
45
+ return out;
46
+ }
47
+ export async function getAiVisibility(config, p) {
48
+ let path = base(config);
49
+ if (p.weeks !== undefined) {
50
+ if (!Number.isInteger(p.weeks) || p.weeks < 1 || p.weeks > MAX_WEEKS) {
51
+ throw new Error(`weeks must be a whole number from 1 to ${MAX_WEEKS}`);
52
+ }
53
+ path = `${path}?weeks=${p.weeks}`;
54
+ }
55
+ const v = await apiGet(path, config);
56
+ const out = {
57
+ brandTerms: v.brandTerms ?? [],
58
+ questions: (v.questions ?? []).map(compactQuestion),
59
+ };
60
+ if (v.skipped && v.skipped.length > 0)
61
+ out['skipped'] = v.skipped;
62
+ return out;
63
+ }
64
+ function checkQuestions(questions) {
65
+ if (!Array.isArray(questions))
66
+ throw new Error('questions must be a list of strings (an empty list switches every question off)');
67
+ const cleaned = questions.map((q) => (typeof q === 'string' ? q.trim() : ''));
68
+ if (cleaned.some((q) => q === ''))
69
+ throw new Error('A question cannot be blank');
70
+ if (cleaned.some((q) => q.length > MAX_QUESTION_LENGTH)) {
71
+ throw new Error(`A question is at most ${MAX_QUESTION_LENGTH} characters`);
72
+ }
73
+ if (cleaned.length > MAX_QUESTIONS)
74
+ throw new Error(`At most ${MAX_QUESTIONS} questions are checked`);
75
+ return cleaned;
76
+ }
77
+ function checkBrandTerms(terms) {
78
+ if (!Array.isArray(terms) || terms.some((t) => typeof t !== 'string')) {
79
+ throw new Error('brandTerms must be a list of strings (an empty list goes back to the workspace name)');
80
+ }
81
+ const cleaned = terms.map((t) => t.trim()).filter((t) => t !== '');
82
+ if (cleaned.some((t) => t.length > MAX_TERM_LENGTH))
83
+ throw new Error(`A brand term is at most ${MAX_TERM_LENGTH} characters`);
84
+ if (cleaned.length > MAX_BRAND_TERMS)
85
+ throw new Error(`At most ${MAX_BRAND_TERMS} brand terms`);
86
+ return cleaned;
87
+ }
88
+ export async function setAiQuestions(config, p) {
89
+ // Check both inputs before the first call so a bad brandTerms cannot leave the questions half applied.
90
+ const questions = checkQuestions(p.questions);
91
+ const brandTerms = p.brandTerms === undefined ? undefined : checkBrandTerms(p.brandTerms);
92
+ const saved = await apiPut(`${base(config)}/questions`, { questions }, config);
93
+ const all = saved.questions ?? [];
94
+ const out = { questions: all.filter((q) => q.active).map((q) => q.question) };
95
+ const inactive = all.filter((q) => !q.active).map((q) => q.question);
96
+ if (inactive.length > 0)
97
+ out['inactive'] = inactive;
98
+ if (brandTerms !== undefined) {
99
+ const terms = await apiPut(`${base(config)}/brand-terms`, { brandTerms }, config);
100
+ out['brandTerms'] = terms.brandTerms ?? [];
101
+ }
102
+ return out;
103
+ }
104
+ export async function runAiVisibilityCheck(config) {
105
+ const r = await apiPost(`${base(config)}/run`, {}, config);
106
+ const out = {
107
+ week: r.weekStart,
108
+ recorded: r.recorded,
109
+ alreadyRecorded: r.alreadyRecorded,
110
+ };
111
+ if (r.skipped && r.skipped.length > 0)
112
+ out['skipped'] = r.skipped;
113
+ if (r.errors && r.errors.length > 0) {
114
+ out['errors'] = r.errors.map((e) => {
115
+ const item = { assistant: e.assistant };
116
+ if (e.question)
117
+ item['question'] = e.question;
118
+ item['reason'] = e.reason;
119
+ return item;
120
+ });
121
+ }
122
+ return out;
123
+ }
124
+ //# sourceMappingURL=ai-visibility.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ai-visibility.js","sourceRoot":"","sources":["../../../src/mcp/tools/ai-visibility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEnD;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA;AAE9B,MAAM,SAAS,GAAG,EAAE,CAAA;AACpB,MAAM,aAAa,GAAG,EAAE,CAAA;AACxB,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAC/B,MAAM,eAAe,GAAG,EAAE,CAAA;AAC1B,MAAM,eAAe,GAAG,EAAE,CAAA;AAgC1B,SAAS,IAAI,CAAC,MAAc;IAC1B,OAAO,oBAAoB,MAAM,CAAC,SAAS,0BAA0B,CAAA;AACvE,CAAC;AAED,SAAS,OAAO,CAAC,IAA+B;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7C,OAAO,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9E,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAmB;IAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAA;IAC7B,MAAM,GAAG,GAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAA;IAC3C,IAAI,MAAM,CAAC,SAAS;QAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,CAAA;IACpD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAA;IAClE,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;QAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAA;IAC9E,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,OAAO;QAAE,GAAG,CAAC,SAAS,CAAC,GAAG,OAAO,CAAA;IACrC,IAAI,MAAM,CAAC,KAAK;QAAE,GAAG,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAA;IAC7C,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;IAC9F,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,CAAkB;IACzC,MAAM,GAAG,GAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAA;IACnD,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK;QAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAA;IAC7C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC9D,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,CAAqB;IACzE,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IACvB,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,SAAS,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,0CAA0C,SAAS,EAAE,CAAC,CAAA;QACxE,CAAC;QACD,IAAI,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,CAAA;IACnC,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,MAAM,CAAoB,IAAI,EAAE,MAAM,CAAC,CAAA;IACvD,MAAM,GAAG,GAA4B;QACnC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;QAC9B,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC;KACpD,CAAA;IACD,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;IACjE,OAAO,GAAG,CAAA;AACZ,CAAC;AAOD,SAAS,cAAc,CAAC,SAAkB;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAA;IACjI,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC7E,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAChF,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,mBAAmB,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,yBAAyB,mBAAmB,aAAa,CAAC,CAAA;IAC5E,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,aAAa,wBAAwB,CAAC,CAAA;IACrG,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAA;IACzG,CAAC;IACD,MAAM,OAAO,GAAI,KAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;IAChF,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,eAAe,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,eAAe,aAAa,CAAC,CAAA;IAC7H,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,eAAe,cAAc,CAAC,CAAA;IAC/F,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,CAAqB;IACxE,uGAAuG;IACvG,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC7C,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAEzF,MAAM,KAAK,GAAG,MAAM,MAAM,CACxB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAC3B,EAAE,SAAS,EAAE,EACb,MAAM,CACP,CAAA;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAA;IACjC,MAAM,GAAG,GAA4B,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAA;IACtG,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACpE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAA;IAEnD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,MAAM,CAA4B,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,CAAC,CAAA;QAC5G,GAAG,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAA;IAC5C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAc;IACvD,MAAM,CAAC,GAAG,MAAM,OAAO,CAAa,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IACtE,MAAM,GAAG,GAA4B;QACnC,IAAI,EAAE,CAAC,CAAC,SAAS;QACjB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,eAAe,EAAE,CAAC,CAAC,eAAe;KACnC,CAAA;IACD,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;IACjE,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,MAAM,IAAI,GAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAA;YAC5C,IAAI,CAAC,CAAC,QAAQ;gBAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;YAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;YACzB,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { Config } from '../config.js';
2
+ /**
3
+ * The monthly paid budget (`/marketing/budget`) and the stop rules that guard each paid channel
4
+ * (`/marketing/stop-rules`). Conductor only records and evaluates; the bid or budget change itself is made by a
5
+ * human in the ad platform. The pacing payload carries full daily series per channel, so this compacts it per
6
+ * `docs/mcp-tool-guidelines.md`: absent stays absent, but a null that means something ("no cap", "no installs")
7
+ * is kept explicit.
8
+ */
9
+ export declare const RULE_METRICS: readonly ["cost_per_install", "spend", "installs", "taps", "tap_through_rate", "install_rate"];
10
+ export declare const RECENT_DAILY_DAYS = 7;
11
+ export declare const MAX_WINDOW_DAYS = 90;
12
+ export declare function getBudgetPacing(config: Config, params: {
13
+ month?: string;
14
+ }): Promise<Record<string, unknown>>;
15
+ export interface SetBudgetParams {
16
+ month: string;
17
+ capAmount: number;
18
+ currency?: string;
19
+ }
20
+ export declare function setMarketingBudget(config: Config, p: SetBudgetParams): Promise<Record<string, unknown>>;
21
+ export interface SetStopRuleParams {
22
+ channel: string;
23
+ metric: string;
24
+ comparator: string;
25
+ threshold: number;
26
+ minSample?: number;
27
+ windowDays?: number;
28
+ scope?: string;
29
+ note?: string;
30
+ }
31
+ export declare function setStopRule(config: Config, p: SetStopRuleParams): Promise<Record<string, unknown>>;
32
+ export declare function removeStopRule(config: Config, p: {
33
+ ruleId: string;
34
+ }): Promise<Record<string, unknown>>;
35
+ //# sourceMappingURL=budget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGrC;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,gGAAiG,CAAA;AAC1H,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAClC,eAAO,MAAM,eAAe,KAAK,CAAA;AAoKjC,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2ClH;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAc7G;AAID,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0CxG;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAI5G"}
@@ -0,0 +1,205 @@
1
+ import { apiGet, apiPut, apiPost, apiDelete } from '../api.js';
2
+ /**
3
+ * The monthly paid budget (`/marketing/budget`) and the stop rules that guard each paid channel
4
+ * (`/marketing/stop-rules`). Conductor only records and evaluates; the bid or budget change itself is made by a
5
+ * human in the ad platform. The pacing payload carries full daily series per channel, so this compacts it per
6
+ * `docs/mcp-tool-guidelines.md`: absent stays absent, but a null that means something ("no cap", "no installs")
7
+ * is kept explicit.
8
+ */
9
+ export const RULE_METRICS = ['cost_per_install', 'spend', 'installs', 'taps', 'tap_through_rate', 'install_rate'];
10
+ export const RECENT_DAILY_DAYS = 7;
11
+ export const MAX_WINDOW_DAYS = 90;
12
+ const MONTH = /^\d{4}-(0[1-9]|1[0-2])$/;
13
+ const SCOPE = /^(channel|(campaign|keyword):[A-Za-z0-9._-]{1,100})$/i;
14
+ function round(n, places = 2) {
15
+ if (n === null || n === undefined || !Number.isFinite(n))
16
+ return null;
17
+ const f = 10 ** places;
18
+ return Math.round(n * f) / f;
19
+ }
20
+ function checkMonth(month) {
21
+ if (!MONTH.test(month))
22
+ throw new Error('month must be YYYY-MM, for example 2026-11');
23
+ }
24
+ /** A null cost per install is never "0": say why it is missing. */
25
+ function cpiNote(spend, installs) {
26
+ if (installs === 0)
27
+ return 'no installs';
28
+ if (installs === null || installs === undefined) {
29
+ return spend === null || spend === undefined ? 'no data' : 'installs not reported';
30
+ }
31
+ return 'no data';
32
+ }
33
+ function compactWindow(w) {
34
+ const cpi = round(w.cpi);
35
+ return {
36
+ from: w.from,
37
+ to: w.to ?? null,
38
+ spend: round(w.spend),
39
+ installs: round(w.installs),
40
+ cpi,
41
+ ...(cpi === null ? { cpiNote: cpiNote(w.spend, w.installs) } : {}),
42
+ };
43
+ }
44
+ function ruleState(r) {
45
+ if (r.tripped)
46
+ return 'TRIPPED';
47
+ if (r.belowMinSample)
48
+ return 'BELOW_MIN_SAMPLE';
49
+ if (r.observed === null || r.observed === undefined)
50
+ return 'NO_DATA';
51
+ return 'OK';
52
+ }
53
+ function compactRule(r) {
54
+ return {
55
+ ruleId: r.ruleId,
56
+ scope: r.scope,
57
+ metric: r.metric,
58
+ comparator: r.comparator,
59
+ threshold: r.threshold,
60
+ minSample: r.minSample,
61
+ windowDays: r.windowDays,
62
+ observed: round(r.observed, 4),
63
+ sample: round(r.sample),
64
+ state: ruleState(r),
65
+ ...(r.note ? { note: r.note } : {}),
66
+ ...(r.detail ? { detail: r.detail } : {}),
67
+ };
68
+ }
69
+ function compactChannel(c) {
70
+ const cpi = round(c.cpi);
71
+ return {
72
+ channel: c.channel,
73
+ through: c.through ?? null,
74
+ mtdSpend: round(c.mtdSpend),
75
+ provisionalSpend: round(c.provisionalSpend),
76
+ installs: round(c.installs),
77
+ cpi,
78
+ ...(cpi === null ? { cpiNote: cpiNote(c.mtdSpend, c.installs) } : {}),
79
+ compliant: c.compliant,
80
+ ...(c.complianceReason ? { complianceReason: c.complianceReason } : {}),
81
+ rules: c.rules.map(compactRule),
82
+ ...(c.marginalCpi
83
+ ? {
84
+ marginalCpi: {
85
+ last7: compactWindow(c.marginalCpi.last7),
86
+ prior7: compactWindow(c.marginalCpi.prior7),
87
+ monthToDate: compactWindow(c.marginalCpi.monthToDate),
88
+ },
89
+ }
90
+ : {}),
91
+ };
92
+ }
93
+ function compactDay(d) {
94
+ return {
95
+ day: d.day,
96
+ spend: round(d.spend),
97
+ ...(d.provisionalSpend !== null && d.provisionalSpend !== undefined ? { provisionalSpend: round(d.provisionalSpend) } : {}),
98
+ cumulativeSpend: round(d.cumulativeSpend),
99
+ expectedSpend: round(d.expectedSpend),
100
+ };
101
+ }
102
+ export async function getBudgetPacing(config, params) {
103
+ if (params.month !== undefined)
104
+ checkMonth(params.month);
105
+ const query = params.month ? `?month=${encodeURIComponent(params.month)}` : '';
106
+ const p = await apiGet(`/api/v2/projects/${config.projectId}/marketing/budget${query}`, config);
107
+ const channels = p.channels ?? [];
108
+ const tripped = channels.flatMap((c) => (c.rules ?? [])
109
+ .filter((r) => r.tripped)
110
+ .map((r) => ({
111
+ ruleId: r.ruleId,
112
+ channel: c.channel,
113
+ scope: r.scope,
114
+ metric: r.metric,
115
+ comparator: r.comparator,
116
+ threshold: r.threshold,
117
+ observed: round(r.observed, 4),
118
+ sample: round(r.sample),
119
+ windowFrom: r.windowFrom ?? null,
120
+ windowTo: r.windowTo ?? null,
121
+ ...(r.note ? { note: r.note } : {}),
122
+ ...(r.detail ? { detail: r.detail } : {}),
123
+ })));
124
+ const hasCap = p.capAmount !== null && p.capAmount !== undefined;
125
+ return {
126
+ month: p.month,
127
+ // null = no cap is set for the month; pace and expected spend are then null too, never computed against 0
128
+ cap: hasCap ? round(p.capAmount) : null,
129
+ currency: p.currency ?? null,
130
+ ...(hasCap ? {} : { capNote: 'no cap set for this month: spend is shown without a pace' }),
131
+ through: p.through ?? null,
132
+ daysElapsed: p.daysElapsed,
133
+ daysInMonth: p.daysInMonth,
134
+ mtdSpend: round(p.mtdSpend),
135
+ provisionalSpend: round(p.provisionalSpend),
136
+ expectedSpend: round(p.expectedSpend),
137
+ pacePct: round(p.pacePct, 4),
138
+ projectedSpend: round(p.projectedSpend),
139
+ nonCompliantChannels: channels.filter((c) => !c.compliant).map((c) => c.channel),
140
+ trippedRules: tripped,
141
+ channels: channels.map(compactChannel),
142
+ daily: (p.daily ?? []).slice(-RECENT_DAILY_DAYS).map(compactDay),
143
+ };
144
+ }
145
+ export async function setMarketingBudget(config, p) {
146
+ checkMonth(p.month);
147
+ if (typeof p.capAmount !== 'number' || !Number.isFinite(p.capAmount) || p.capAmount <= 0) {
148
+ throw new Error('capAmount must be a number greater than 0 (a month with no cap simply has none)');
149
+ }
150
+ if (p.currency !== undefined && !/^[A-Za-z]{3}$/.test(p.currency)) {
151
+ throw new Error('currency must be a three-letter code such as USD');
152
+ }
153
+ const saved = await apiPut(`/api/v2/projects/${config.projectId}/marketing/budget/${encodeURIComponent(p.month)}`, { capAmount: p.capAmount, currency: p.currency }, config);
154
+ return { month: saved['month'], capAmount: saved['capAmount'], currency: saved['currency'] };
155
+ }
156
+ export async function setStopRule(config, p) {
157
+ if (!p.channel?.trim())
158
+ throw new Error('channel is required (for example ADS)');
159
+ if (!RULE_METRICS.includes(p.metric)) {
160
+ throw new Error(`metric must be one of ${RULE_METRICS.join(', ')}`);
161
+ }
162
+ if (p.comparator !== 'GT' && p.comparator !== 'LT')
163
+ throw new Error('comparator must be GT (above) or LT (below)');
164
+ if (typeof p.threshold !== 'number' || !Number.isFinite(p.threshold) || p.threshold < 0) {
165
+ throw new Error('threshold must be a number of 0 or more');
166
+ }
167
+ if (p.minSample !== undefined && (!Number.isInteger(p.minSample) || p.minSample < 0)) {
168
+ throw new Error('minSample must be a whole number of 0 or more');
169
+ }
170
+ if (p.windowDays !== undefined && (!Number.isInteger(p.windowDays) || p.windowDays < 1 || p.windowDays > MAX_WINDOW_DAYS)) {
171
+ throw new Error(`windowDays must be a whole number from 1 to ${MAX_WINDOW_DAYS}`);
172
+ }
173
+ if (p.scope !== undefined && !SCOPE.test(p.scope))
174
+ throw new Error('scope must be channel, campaign:<id> or keyword:<id>');
175
+ const saved = await apiPost(`/api/v2/projects/${config.projectId}/marketing/stop-rules`, {
176
+ channel: p.channel,
177
+ scope: p.scope,
178
+ metric: p.metric,
179
+ comparator: p.comparator,
180
+ threshold: p.threshold,
181
+ minSample: p.minSample,
182
+ windowDays: p.windowDays,
183
+ note: p.note,
184
+ }, config);
185
+ const out = {
186
+ ruleId: saved['id'],
187
+ channel: saved['channel'],
188
+ scope: saved['scope'],
189
+ metric: saved['metric'],
190
+ comparator: saved['comparator'],
191
+ threshold: saved['threshold'],
192
+ minSample: saved['minSample'],
193
+ windowDays: saved['windowDays'],
194
+ };
195
+ if (saved['note'])
196
+ out['note'] = saved['note'];
197
+ return out;
198
+ }
199
+ export async function removeStopRule(config, p) {
200
+ if (!p.ruleId?.trim())
201
+ throw new Error('ruleId is required (get_budget_pacing lists each rule with its ruleId)');
202
+ await apiDelete(`/api/v2/projects/${config.projectId}/marketing/stop-rules/${encodeURIComponent(p.ruleId)}`, config);
203
+ return { removed: p.ruleId };
204
+ }
205
+ //# sourceMappingURL=budget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/mcp/tools/budget.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import { Config } from '../config.js';
2
+ /**
3
+ * Creator results (`/marketing/creators/{id}/results`): what one creator (a Work Item on the CREATORS workflow)
4
+ * has produced: its posts with their views, the downloads of its campaign links and the redemptions of its offer
5
+ * code. Compacted per `docs/mcp-tool-guidelines.md`. A figure the sources did not report stays an explicit null
6
+ * with its note, never 0: Apple omits campaign rows under its reporting threshold and a product backend may not
7
+ * send redemptions at all. A handle or offer code that is not set is left out.
8
+ */
9
+ export declare const MAX_CREATOR_POSTS = 20;
10
+ export declare function getCreatorResults(config: Config, params: {
11
+ creatorId: string;
12
+ from?: string;
13
+ to?: string;
14
+ }): Promise<Record<string, unknown>>;
15
+ //# sourceMappingURL=creators.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creators.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/creators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGrC;;;;;;GAMG;AAEH,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAkDnC,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwClC"}
@@ -0,0 +1,69 @@
1
+ import { apiGet } from '../api.js';
2
+ /**
3
+ * Creator results (`/marketing/creators/{id}/results`): what one creator (a Work Item on the CREATORS workflow)
4
+ * has produced: its posts with their views, the downloads of its campaign links and the redemptions of its offer
5
+ * code. Compacted per `docs/mcp-tool-guidelines.md`. A figure the sources did not report stays an explicit null
6
+ * with its note, never 0: Apple omits campaign rows under its reporting threshold and a product backend may not
7
+ * send redemptions at all. A handle or offer code that is not set is left out.
8
+ */
9
+ export const MAX_CREATOR_POSTS = 20;
10
+ const DATE = /^\d{4}-\d{2}-\d{2}$/;
11
+ /** The object with the listed keys dropped when they are null or undefined. Everything else is kept as is. */
12
+ function withoutNulls(obj, keys) {
13
+ const out = { ...obj };
14
+ for (const key of keys) {
15
+ if (out[key] === null || out[key] === undefined)
16
+ delete out[key];
17
+ }
18
+ return out;
19
+ }
20
+ function checkDate(value, name) {
21
+ if (value === undefined || value === '')
22
+ return undefined;
23
+ if (!DATE.test(value))
24
+ throw new Error(`${name} must be a real date, YYYY-MM-DD`);
25
+ const parsed = new Date(`${value}T00:00:00Z`);
26
+ // 2026-02-30 parses in some engines by rolling over; reading it back catches that too
27
+ if (Number.isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== value) {
28
+ throw new Error(`${name} must be a real date, YYYY-MM-DD`);
29
+ }
30
+ return value;
31
+ }
32
+ function query(from, to) {
33
+ const parts = [];
34
+ if (from)
35
+ parts.push(`from=${from}`);
36
+ if (to)
37
+ parts.push(`to=${to}`);
38
+ return parts.length > 0 ? `?${parts.join('&')}` : '';
39
+ }
40
+ export async function getCreatorResults(config, params) {
41
+ const creatorId = typeof params.creatorId === 'string' ? params.creatorId.trim() : '';
42
+ if (!creatorId)
43
+ throw new Error('creatorId is required: the creator Work Item id or display id, e.g. RE-12');
44
+ const from = checkDate(params.from, 'from');
45
+ const to = checkDate(params.to, 'to');
46
+ if (from && to && from > to)
47
+ throw new Error(`from ${from} is after to ${to}: a window runs from the earlier day to the later one`);
48
+ const r = await apiGet(`/api/v2/projects/${config.projectId}/marketing/creators/${encodeURIComponent(creatorId)}/results${query(from, to)}`, config);
49
+ return {
50
+ window: { from: r.window.from, to: r.window.to },
51
+ creator: withoutNulls({ id: r.creator.workItemId, displayId: r.creator.displayId, handle: r.creator.handle, status: r.creator.status }, ['handle']),
52
+ postCount: r.postCount,
53
+ posts: (r.posts ?? []).slice(0, MAX_CREATOR_POSTS).map((p) => ({
54
+ id: p.workItemId,
55
+ displayId: p.displayId,
56
+ title: p.title,
57
+ status: p.status,
58
+ views: p.views ?? null,
59
+ })),
60
+ linkDownloads: withoutNulls({
61
+ tokens: r.linkDownloads.tokens,
62
+ downloads: r.linkDownloads.downloads ?? null,
63
+ belowThreshold: r.linkDownloads.belowThreshold,
64
+ note: r.linkDownloads.note,
65
+ }, ['note']),
66
+ offerRedemptions: withoutNulls({ code: r.offerRedemptions.code, value: r.offerRedemptions.value ?? null, note: r.offerRedemptions.note }, ['code', 'note']),
67
+ };
68
+ }
69
+ //# sourceMappingURL=creators.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creators.js","sourceRoot":"","sources":["../../../src/mcp/tools/creators.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ import { Config } from '../config.js';
2
+ /**
3
+ * Growth signals (`/marketing/growth-signals` and its write endpoints): the seasonal moments calendar, the weekly
4
+ * ratings program and the competitor watch, all from public data. Outputs are compacted per
5
+ * `docs/mcp-tool-guidelines.md`: nulls and empties dropped, review text shortened, dates not times. A missing value
6
+ * stays absent, never 0; `weeklyGrowth` is kept as an explicit null so "no previous snapshot" is not read as "no change".
7
+ */
8
+ export declare const MAX_REVIEW_BODY = 240;
9
+ export declare function getGrowthSignals(config: Config): Promise<Record<string, unknown>>;
10
+ export interface SetMomentParams {
11
+ key: string;
12
+ name: string;
13
+ date: string;
14
+ leadDays?: number;
15
+ surfaces: Array<{
16
+ surface: string;
17
+ dueOn: string;
18
+ }>;
19
+ }
20
+ export declare function setMarketingMoment(config: Config, p: SetMomentParams): Promise<Record<string, unknown>>;
21
+ export declare function linkMomentChange(config: Config, p: {
22
+ key: string;
23
+ surfaceId: string;
24
+ workItemId: string;
25
+ }): Promise<Record<string, unknown>>;
26
+ export declare function addCompetitor(config: Config, p: {
27
+ appId: string;
28
+ name: string;
29
+ country?: string;
30
+ }): Promise<Record<string, unknown>>;
31
+ export declare function removeCompetitor(config: Config, p: {
32
+ appId: string;
33
+ }): Promise<Record<string, unknown>>;
34
+ export declare function setTrackedKeywords(config: Config, p: {
35
+ keywords: string[];
36
+ country?: string;
37
+ }): Promise<Record<string, unknown>>;
38
+ //# sourceMappingURL=growth-signals.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"growth-signals.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/growth-signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAIrC;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,MAAM,CAAA;AAuElC,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwBvF;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACpD;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkB7G;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUlC;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASlC;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAI7G;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWlC"}