fodda-mcp 1.3.2 → 1.30.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.
- package/LICENSE +31 -0
- package/README.md +192 -20
- package/dist/a2aHandler.d.ts +20 -0
- package/dist/a2aHandler.d.ts.map +1 -0
- package/dist/a2aHandler.js +247 -0
- package/dist/a2aHandler.js.map +1 -0
- package/dist/agents/fodda-researcher/index.d.ts +35 -0
- package/dist/agents/fodda-researcher/index.d.ts.map +1 -0
- package/dist/agents/fodda-researcher/index.js +62 -0
- package/dist/agents/fodda-researcher/index.js.map +1 -0
- package/dist/agents/fodda-researcher/skills.d.ts +16 -0
- package/dist/agents/fodda-researcher/skills.d.ts.map +1 -0
- package/dist/agents/fodda-researcher/skills.js +163 -0
- package/dist/agents/fodda-researcher/skills.js.map +1 -0
- package/dist/brandTemplate.d.ts +14 -0
- package/dist/brandTemplate.d.ts.map +1 -0
- package/dist/brandTemplate.js +742 -0
- package/dist/brandTemplate.js.map +1 -0
- package/dist/catalogCache.d.ts +177 -0
- package/dist/catalogCache.d.ts.map +1 -0
- package/dist/catalogCache.js +708 -0
- package/dist/catalogCache.js.map +1 -0
- package/dist/editorialFill.d.ts +44 -0
- package/dist/editorialFill.d.ts.map +1 -0
- package/dist/editorialFill.js +377 -0
- package/dist/editorialFill.js.map +1 -0
- package/dist/enrichment.d.ts +74 -0
- package/dist/enrichment.d.ts.map +1 -0
- package/dist/enrichment.js +211 -0
- package/dist/enrichment.js.map +1 -0
- package/dist/errorHandling.d.ts +52 -0
- package/dist/errorHandling.d.ts.map +1 -0
- package/dist/errorHandling.js +327 -0
- package/dist/errorHandling.js.map +1 -0
- package/dist/index.d.ts +0 -1
- package/dist/index.js +595 -410
- package/dist/index.js.map +1 -1
- package/dist/pricingCache.d.ts +99 -0
- package/dist/pricingCache.d.ts.map +1 -0
- package/dist/pricingCache.js +414 -0
- package/dist/pricingCache.js.map +1 -0
- package/dist/queryCache.d.ts +25 -0
- package/dist/queryCache.d.ts.map +1 -0
- package/dist/queryCache.js +194 -0
- package/dist/queryCache.js.map +1 -0
- package/dist/searchTemplate.d.ts +16 -0
- package/dist/searchTemplate.d.ts.map +1 -0
- package/dist/searchTemplate.js +318 -0
- package/dist/searchTemplate.js.map +1 -0
- package/dist/sessionTracker.d.ts +39 -0
- package/dist/sessionTracker.d.ts.map +1 -0
- package/dist/sessionTracker.js +187 -0
- package/dist/sessionTracker.js.map +1 -0
- package/dist/skillClient.d.ts +142 -0
- package/dist/skillClient.d.ts.map +1 -0
- package/dist/skillClient.js +256 -0
- package/dist/skillClient.js.map +1 -0
- package/dist/svgVisuals.d.ts +77 -0
- package/dist/svgVisuals.d.ts.map +1 -0
- package/dist/svgVisuals.js +323 -0
- package/dist/svgVisuals.js.map +1 -0
- package/dist/systemPrompt.d.ts +26 -0
- package/dist/systemPrompt.d.ts.map +1 -0
- package/dist/systemPrompt.js +546 -0
- package/dist/systemPrompt.js.map +1 -0
- package/dist/test-waverunner-response.d.ts +2 -0
- package/dist/test-waverunner-response.d.ts.map +1 -0
- package/dist/test-waverunner-response.js +20 -0
- package/dist/test-waverunner-response.js.map +1 -0
- package/dist/test_analyst.d.ts +2 -0
- package/dist/test_analyst.d.ts.map +1 -0
- package/dist/test_analyst.js +39 -0
- package/dist/test_analyst.js.map +1 -0
- package/dist/test_analyst_local.d.ts +2 -0
- package/dist/test_analyst_local.d.ts.map +1 -0
- package/dist/test_analyst_local.js +51 -0
- package/dist/test_analyst_local.js.map +1 -0
- package/dist/test_live_mcp.d.ts +2 -0
- package/dist/test_live_mcp.d.ts.map +1 -0
- package/dist/test_live_mcp.js +49 -0
- package/dist/test_live_mcp.js.map +1 -0
- package/dist/test_skills.d.ts +9 -0
- package/dist/test_skills.d.ts.map +1 -0
- package/dist/test_skills.js +267 -0
- package/dist/test_skills.js.map +1 -0
- package/dist/toolHandlers.d.ts +11 -0
- package/dist/toolHandlers.d.ts.map +1 -0
- package/dist/toolHandlers.js +2829 -0
- package/dist/toolHandlers.js.map +1 -0
- package/dist/tools.d.ts +80 -3
- package/dist/tools.d.ts.map +1 -1
- package/dist/tools.js +89 -186
- package/dist/tools.js.map +1 -1
- package/dist/trialTracker.d.ts +58 -0
- package/dist/trialTracker.d.ts.map +1 -0
- package/dist/trialTracker.js +179 -0
- package/dist/trialTracker.js.map +1 -0
- package/dist/types.d.ts +3 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/verify_hmac.js +1 -1
- package/dist/verify_hmac.js.map +1 -1
- package/dist/verify_tools_endpoint.js +5 -5
- package/dist/verify_tools_endpoint.js.map +1 -1
- package/dist/widgetShell.d.ts +15 -0
- package/dist/widgetShell.d.ts.map +1 -0
- package/dist/widgetShell.js +151 -0
- package/dist/widgetShell.js.map +1 -0
- package/package.json +10 -6
- package/server.json +12 -17
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"verify_tools_endpoint.js","sourceRoot":"","sources":["../src/verify_tools_endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,KAAK,UAAU,OAAO;IAClB,OAAO,CAAC,GAAG,CAAC,
|
|
1
|
+
{"version":3,"file":"verify_tools_endpoint.js","sourceRoot":"","sources":["../src/verify_tools_endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,KAAK,UAAU,OAAO;IAClB,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;IAC9E,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,eAAe,CAAC,EAAE;QACzC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;KACxC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;IAClE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,CAAC;IAE1E,6BAA6B;IAC7B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAExD,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAExD,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,kBAAkB,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,gCAAgC,kBAAkB,SAAS,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;YAAS,CAAC;QACP,GAAG,CAAC,IAAI,EAAE,CAAC;IACf,CAAC;AACL,CAAC;AAED,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Fodda Widget Shell
|
|
3
|
+
*
|
|
4
|
+
* Shared wrapper for all Fodda widget responses.
|
|
5
|
+
* Provides consistent branding: logo, header, footer, base CSS.
|
|
6
|
+
*/
|
|
7
|
+
export declare const FODDA_LOGO_URL = "https://cdn.jsdelivr.net/gh/piers-fawkes/fodda-demo@main/public/fodda-mini-logo-claude.png";
|
|
8
|
+
export declare const PLAYFAIR_LINK = "";
|
|
9
|
+
declare function esc(s: string): string;
|
|
10
|
+
export { esc };
|
|
11
|
+
export declare const FODDA_SHELL_CSS = "\n:root{--p:#663399;--pl:#F5F0FF;--pm:#9B72CC;--pl-on:#663399;--font-display:var(--font-serif);}\n@media(prefers-color-scheme:dark){:root{--p:#9B72CC;--pl:rgba(155,114,204,0.14);--pm:#663399;--pl-on:#C4A7E8;}}\n.w{border:1px solid var(--p);border-top:3px solid var(--p);border-radius:6px;padding:1.25rem;font-family:var(--font-mono);}\n.hd{display:flex;align-items:center;justify-content:space-between;margin-bottom:1.25rem;padding-bottom:1rem;border-bottom:.5px solid var(--color-border-tertiary);}\n.logo{display:flex;align-items:center;gap:10px;}\n.logo img{height:24px;width:auto;display:block;}\n.lt{font-size:13px;font-weight:500;}.ls{font-size:10px;color:var(--color-text-secondary);}\n.bfolio{font-family:var(--font-mono);font-size:10px;letter-spacing:0.18em;text-transform:uppercase;color:var(--color-text-secondary);}\n.gf{display:flex;gap:5px;flex-wrap:wrap;margin-top:1.5rem;padding-top:1rem;border-top:.5px solid var(--color-border-tertiary);align-items:center;}\n.gfl{font-size:10px;color:var(--color-text-secondary);margin-right:2px;}\n.gp{font-size:10px;padding:2px 9px;border-radius:20px;background:var(--pl);color:var(--pl-on);border:.5px solid var(--pm);}\n.note{font-size:10px;color:var(--color-text-secondary);margin-bottom:1.25rem;}\n.sl2{font-size:13px;font-weight:500;color:var(--color-text-primary);margin:1.25rem 0 8px;}.sl2:first-child{margin-top:0;}\n.eyebrow{font-family:var(--font-mono);font-size:10px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;color:var(--color-text-secondary);margin-bottom:6px;display:flex;gap:8px;align-items:baseline;}\n.eyebrow .sep{color:var(--color-border-tertiary);}\n.eyebrow.brand{color:var(--p);}\n.stamp{display:inline-flex;align-items:center;gap:4px;font-family:var(--font-mono);font-size:9px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;padding:3px 8px;border:1px solid currentColor;border-radius:2px;background:transparent;color:var(--color-text-secondary);}\n.stamp.brand{color:var(--p);}\n.stamp.success{color:var(--color-text-success);}\n.stamp.warning{color:var(--color-text-warning);}\n.editors-note{background:var(--pl);border:1px solid var(--p);border-left-width:3px;border-radius:4px;padding:14px 16px;color:var(--color-text-primary);}\n.editors-note::before{content:\"Editor's note\";display:block;font-family:var(--font-mono);font-size:9px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;color:var(--p);margin-bottom:6px;}\n";
|
|
12
|
+
export declare function wrapWidget(subtitle: string, contentHtml: string, sources: string[], extraCss?: string): string;
|
|
13
|
+
export declare const FODDA_COMPONENT_GUIDE = "\n\u2500\u2500 FODDA COMPONENT LIBRARY \u2500\u2500\nWhen rendering Fodda data via show_widget, ALWAYS use the branded shell below.\n\nDESIGN LANGUAGE: editorial briefing. Mono base, italic serif accent. No gradients on surfaces. Lines, not lifts \u2014 no box-shadows. Paper, not pillow.\n\nSHELL: 1px border + 3px top spine. Folio timestamp top-right. 6px radius (not 12).\nBRANDING: ALWAYS include the Fodda logo (<img src=\"https://cdn.jsdelivr.net/gh/piers-fawkes/fodda-demo@main/public/fodda-mini-logo-claude.png\" height=\"24\" width=\"24\"/>) and \"Fodda\" wordmark in the header. The logo+wordmark must appear in every widget \u2014 it's the first thing the user sees.\n\nTYPOGRAPHY:\n- Display (brand name, stat values, insight blocks): var(--font-display) italic 400\n- Body/cards: system sans\n- UI chrome/tabs/pills: var(--font-mono)\n\nAVAILABLE COMPONENTS:\nCards: .card{border:1px solid var(--color-border-tertiary);border-radius:4px;padding:1rem 1.25rem;margin-bottom:8px;}\nEyebrow: .eyebrow{font-mono 10px 700 uppercase 0.18em tracking} \u2014 above every card title: \"[GRAPH] \u00B7 [STAGE]\"\nStamp badges: .stamp{border:1px solid currentColor;radius:2px;9px mono uppercase} \u2014 for status/stage/category (not source pills)\nSource pills: .gp{radius:20px;bg:var(--pl);color:var(--pl-on)} \u2014 keep rounded, navigational\nEditors note: .editors-note{bg:var(--pl);border-left:3px solid var(--p);radius:4px} \u2014 for LLM-authored insight/analysis\nStat grid: .sg .sk \u2014 same as before. .skv{font-family:var(--font-display);font-style:italic;font-size:22px;}\nBar rows: .br .brl .brt .brf \u2014 same as before\nTabs: .tb .t \u2014 same as before\n\nCOLORS: var(--p) primary (auto-switches: #663399 light, #9B72CC dark). var(--pl) light bg (auto-switches). var(--pl-on) text-on-light-bg.\nDARK MODE RULE: Always use var(--pl-on) for text on var(--pl) backgrounds. Never hardcode #663399 for dark-mode text.\nRULES: <12KB HTML, no CDN (except Google Fonts), graph attribution on every card, never say \"the Fodda graph\"\n";
|
|
14
|
+
export declare function getShellTemplate(subtitle?: string, sources?: string[]): string;
|
|
15
|
+
//# sourceMappingURL=widgetShell.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"widgetShell.d.ts","sourceRoot":"","sources":["../src/widgetShell.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,cAAc,+FAA+F,CAAC;AAG3H,eAAO,MAAM,aAAa,KAAK,CAAC;AAKhC,iBAAS,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9B;AAED,OAAO,EAAE,GAAG,EAAE,CAAC;AAKf,eAAO,MAAM,eAAe,u5EAuB3B,CAAC;AAKF,wBAAgB,UAAU,CACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,GAAE,MAAW,GACtB,MAAM,CAqCR;AAKD,eAAO,MAAM,qBAAqB,ugEA2BjC,CAAC;AAMF,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAgC9E"}
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Fodda Widget Shell
|
|
3
|
+
*
|
|
4
|
+
* Shared wrapper for all Fodda widget responses.
|
|
5
|
+
* Provides consistent branding: logo, header, footer, base CSS.
|
|
6
|
+
*/
|
|
7
|
+
// Logo (CDN-hosted — saves ~5KB per widget)
|
|
8
|
+
// ---------------------------------------------------------------------------
|
|
9
|
+
export const FODDA_LOGO_URL = 'https://cdn.jsdelivr.net/gh/piers-fawkes/fodda-demo@main/public/fodda-mini-logo-claude.png';
|
|
10
|
+
// Playfair Display italic — brand display font (removed, using Claude's built-in serif)
|
|
11
|
+
export const PLAYFAIR_LINK = '';
|
|
12
|
+
// ---------------------------------------------------------------------------
|
|
13
|
+
// Escape helper
|
|
14
|
+
// ---------------------------------------------------------------------------
|
|
15
|
+
function esc(s) {
|
|
16
|
+
return (s || '').replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"').replace(/'/g, ''');
|
|
17
|
+
}
|
|
18
|
+
export { esc };
|
|
19
|
+
// ---------------------------------------------------------------------------
|
|
20
|
+
// Shell CSS — shared across all templates
|
|
21
|
+
// ---------------------------------------------------------------------------
|
|
22
|
+
export const FODDA_SHELL_CSS = `
|
|
23
|
+
:root{--p:#663399;--pl:#F5F0FF;--pm:#9B72CC;--pl-on:#663399;--font-display:var(--font-serif);}
|
|
24
|
+
@media(prefers-color-scheme:dark){:root{--p:#9B72CC;--pl:rgba(155,114,204,0.14);--pm:#663399;--pl-on:#C4A7E8;}}
|
|
25
|
+
.w{border:1px solid var(--p);border-top:3px solid var(--p);border-radius:6px;padding:1.25rem;font-family:var(--font-mono);}
|
|
26
|
+
.hd{display:flex;align-items:center;justify-content:space-between;margin-bottom:1.25rem;padding-bottom:1rem;border-bottom:.5px solid var(--color-border-tertiary);}
|
|
27
|
+
.logo{display:flex;align-items:center;gap:10px;}
|
|
28
|
+
.logo img{height:24px;width:auto;display:block;}
|
|
29
|
+
.lt{font-size:13px;font-weight:500;}.ls{font-size:10px;color:var(--color-text-secondary);}
|
|
30
|
+
.bfolio{font-family:var(--font-mono);font-size:10px;letter-spacing:0.18em;text-transform:uppercase;color:var(--color-text-secondary);}
|
|
31
|
+
.gf{display:flex;gap:5px;flex-wrap:wrap;margin-top:1.5rem;padding-top:1rem;border-top:.5px solid var(--color-border-tertiary);align-items:center;}
|
|
32
|
+
.gfl{font-size:10px;color:var(--color-text-secondary);margin-right:2px;}
|
|
33
|
+
.gp{font-size:10px;padding:2px 9px;border-radius:20px;background:var(--pl);color:var(--pl-on);border:.5px solid var(--pm);}
|
|
34
|
+
.note{font-size:10px;color:var(--color-text-secondary);margin-bottom:1.25rem;}
|
|
35
|
+
.sl2{font-size:13px;font-weight:500;color:var(--color-text-primary);margin:1.25rem 0 8px;}.sl2:first-child{margin-top:0;}
|
|
36
|
+
.eyebrow{font-family:var(--font-mono);font-size:10px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;color:var(--color-text-secondary);margin-bottom:6px;display:flex;gap:8px;align-items:baseline;}
|
|
37
|
+
.eyebrow .sep{color:var(--color-border-tertiary);}
|
|
38
|
+
.eyebrow.brand{color:var(--p);}
|
|
39
|
+
.stamp{display:inline-flex;align-items:center;gap:4px;font-family:var(--font-mono);font-size:9px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;padding:3px 8px;border:1px solid currentColor;border-radius:2px;background:transparent;color:var(--color-text-secondary);}
|
|
40
|
+
.stamp.brand{color:var(--p);}
|
|
41
|
+
.stamp.success{color:var(--color-text-success);}
|
|
42
|
+
.stamp.warning{color:var(--color-text-warning);}
|
|
43
|
+
.editors-note{background:var(--pl);border:1px solid var(--p);border-left-width:3px;border-radius:4px;padding:14px 16px;color:var(--color-text-primary);}
|
|
44
|
+
.editors-note::before{content:"Editor's note";display:block;font-family:var(--font-mono);font-size:9px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;color:var(--p);margin-bottom:6px;}
|
|
45
|
+
`;
|
|
46
|
+
// ---------------------------------------------------------------------------
|
|
47
|
+
// Wrap content in the Fodda branded shell
|
|
48
|
+
// ---------------------------------------------------------------------------
|
|
49
|
+
export function wrapWidget(subtitle, contentHtml, sources, extraCss = '') {
|
|
50
|
+
const sourcePills = sources
|
|
51
|
+
.filter(Boolean)
|
|
52
|
+
.map(s => `<span class="gp">${esc(s)}</span>`)
|
|
53
|
+
.join('\n ');
|
|
54
|
+
// Dossier folio: timestamp of when this widget was assembled
|
|
55
|
+
const now = new Date();
|
|
56
|
+
const day = now.getDate();
|
|
57
|
+
const mon = now.toLocaleString('en-US', { month: 'short' }).toUpperCase();
|
|
58
|
+
const hh = String(now.getHours()).padStart(2, '0');
|
|
59
|
+
const mm = String(now.getMinutes()).padStart(2, '0');
|
|
60
|
+
const doy = Math.floor((now.getTime() - new Date(now.getFullYear(), 0, 0).getTime()) / 864e5);
|
|
61
|
+
const folio = `ISSUE ${doy} · ${day} ${mon} · ${hh}:${mm}`;
|
|
62
|
+
return `
|
|
63
|
+
<style>
|
|
64
|
+
${FODDA_SHELL_CSS}
|
|
65
|
+
${extraCss}
|
|
66
|
+
</style>
|
|
67
|
+
|
|
68
|
+
<div class="w">
|
|
69
|
+
<div class="hd">
|
|
70
|
+
<div class="logo">
|
|
71
|
+
<img src="${FODDA_LOGO_URL}" alt="Fodda" style="height:24px;width:24px;"/>
|
|
72
|
+
<div><div class="lt">Fodda</div><div class="ls">${esc(subtitle)}</div></div>
|
|
73
|
+
</div>
|
|
74
|
+
<div class="bfolio">${folio}</div>
|
|
75
|
+
</div>
|
|
76
|
+
|
|
77
|
+
${contentHtml}
|
|
78
|
+
|
|
79
|
+
<div class="gf">
|
|
80
|
+
<span class="gfl">Sources:</span>
|
|
81
|
+
${sourcePills}
|
|
82
|
+
</div>
|
|
83
|
+
</div>`;
|
|
84
|
+
}
|
|
85
|
+
// ---------------------------------------------------------------------------
|
|
86
|
+
// Component guide — sent to Claude for Layer 3 (creative compositions)
|
|
87
|
+
// ---------------------------------------------------------------------------
|
|
88
|
+
export const FODDA_COMPONENT_GUIDE = `
|
|
89
|
+
── FODDA COMPONENT LIBRARY ──
|
|
90
|
+
When rendering Fodda data via show_widget, ALWAYS use the branded shell below.
|
|
91
|
+
|
|
92
|
+
DESIGN LANGUAGE: editorial briefing. Mono base, italic serif accent. No gradients on surfaces. Lines, not lifts — no box-shadows. Paper, not pillow.
|
|
93
|
+
|
|
94
|
+
SHELL: 1px border + 3px top spine. Folio timestamp top-right. 6px radius (not 12).
|
|
95
|
+
BRANDING: ALWAYS include the Fodda logo (<img src="${FODDA_LOGO_URL}" height="24" width="24"/>) and "Fodda" wordmark in the header. The logo+wordmark must appear in every widget — it's the first thing the user sees.
|
|
96
|
+
|
|
97
|
+
TYPOGRAPHY:
|
|
98
|
+
- Display (brand name, stat values, insight blocks): var(--font-display) italic 400
|
|
99
|
+
- Body/cards: system sans
|
|
100
|
+
- UI chrome/tabs/pills: var(--font-mono)
|
|
101
|
+
|
|
102
|
+
AVAILABLE COMPONENTS:
|
|
103
|
+
Cards: .card{border:1px solid var(--color-border-tertiary);border-radius:4px;padding:1rem 1.25rem;margin-bottom:8px;}
|
|
104
|
+
Eyebrow: .eyebrow{font-mono 10px 700 uppercase 0.18em tracking} — above every card title: "[GRAPH] · [STAGE]"
|
|
105
|
+
Stamp badges: .stamp{border:1px solid currentColor;radius:2px;9px mono uppercase} — for status/stage/category (not source pills)
|
|
106
|
+
Source pills: .gp{radius:20px;bg:var(--pl);color:var(--pl-on)} — keep rounded, navigational
|
|
107
|
+
Editors note: .editors-note{bg:var(--pl);border-left:3px solid var(--p);radius:4px} — for LLM-authored insight/analysis
|
|
108
|
+
Stat grid: .sg .sk — same as before. .skv{font-family:var(--font-display);font-style:italic;font-size:22px;}
|
|
109
|
+
Bar rows: .br .brl .brt .brf — same as before
|
|
110
|
+
Tabs: .tb .t — same as before
|
|
111
|
+
|
|
112
|
+
COLORS: var(--p) primary (auto-switches: #663399 light, #9B72CC dark). var(--pl) light bg (auto-switches). var(--pl-on) text-on-light-bg.
|
|
113
|
+
DARK MODE RULE: Always use var(--pl-on) for text on var(--pl) backgrounds. Never hardcode #663399 for dark-mode text.
|
|
114
|
+
RULES: <12KB HTML, no CDN (except Google Fonts), graph attribution on every card, never say "the Fodda graph"
|
|
115
|
+
`;
|
|
116
|
+
// ---------------------------------------------------------------------------
|
|
117
|
+
// Shell template with open slots — for non-templated responses
|
|
118
|
+
// Claude fills {{SUBTITLE}}, {{CONTENT}}, and {{SOURCE_PILLS}}
|
|
119
|
+
// ---------------------------------------------------------------------------
|
|
120
|
+
export function getShellTemplate(subtitle, sources) {
|
|
121
|
+
const subtitleFilled = subtitle ? esc(subtitle) : '{{SUBTITLE}}';
|
|
122
|
+
const sourcePills = sources
|
|
123
|
+
? sources.filter(Boolean).map(s => `<span class="gp">${esc(s)}</span>`).join('\n ')
|
|
124
|
+
: '{{SOURCE_PILLS}}';
|
|
125
|
+
const now = new Date();
|
|
126
|
+
const doy = Math.floor((now.getTime() - new Date(now.getFullYear(), 0, 0).getTime()) / 864e5);
|
|
127
|
+
const folio = `ISSUE ${doy} \u00b7 ${now.getDate()} ${now.toLocaleString('en-US', { month: 'short' }).toUpperCase()} \u00b7 ${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}`;
|
|
128
|
+
return `
|
|
129
|
+
<style>
|
|
130
|
+
${FODDA_SHELL_CSS}
|
|
131
|
+
{{EXTRA_CSS}}
|
|
132
|
+
</style>
|
|
133
|
+
|
|
134
|
+
<div class="w">
|
|
135
|
+
<div class="hd">
|
|
136
|
+
<div class="logo">
|
|
137
|
+
<img src="${FODDA_LOGO_URL}" alt="Fodda" style="height:24px;width:24px;"/>
|
|
138
|
+
<div><div class="lt">Fodda</div><div class="ls">${subtitleFilled}</div></div>
|
|
139
|
+
</div>
|
|
140
|
+
<div class="bfolio">${folio}</div>
|
|
141
|
+
</div>
|
|
142
|
+
|
|
143
|
+
{{CONTENT}}
|
|
144
|
+
|
|
145
|
+
<div class="gf">
|
|
146
|
+
<span class="gfl">Sources:</span>
|
|
147
|
+
${sourcePills}
|
|
148
|
+
</div>
|
|
149
|
+
</div>`;
|
|
150
|
+
}
|
|
151
|
+
//# sourceMappingURL=widgetShell.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"widgetShell.js","sourceRoot":"","sources":["../src/widgetShell.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fodda-mcp",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"mcpName": "
|
|
3
|
+
"version": "1.30.0",
|
|
4
|
+
"mcpName": "ai.fodda/mcp-server",
|
|
5
5
|
"description": "Fodda MCP Server for accessing knowledge graph insights.",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"mcp",
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
],
|
|
13
13
|
"repository": {
|
|
14
14
|
"type": "git",
|
|
15
|
-
"url": "https://github.com/fodda
|
|
15
|
+
"url": "https://github.com/piers-fawkes/fodda-mcp.git"
|
|
16
16
|
},
|
|
17
17
|
"author": "Fodda",
|
|
18
18
|
"license": "SEE LICENSE IN LICENSE",
|
|
@@ -33,10 +33,14 @@
|
|
|
33
33
|
"test": "npm run build && node dist/verify_tools_endpoint.js"
|
|
34
34
|
},
|
|
35
35
|
"dependencies": {
|
|
36
|
-
"@
|
|
36
|
+
"@google-cloud/firestore": "^8.5.0",
|
|
37
|
+
"@google/genai": "^1.50.1",
|
|
38
|
+
"@modelcontextprotocol/sdk": "^1.27.1",
|
|
37
39
|
"axios": "^1.13.5",
|
|
38
40
|
"dotenv": "^17.2.4",
|
|
39
|
-
"express": "^5.2.1"
|
|
41
|
+
"express": "^5.2.1",
|
|
42
|
+
"neo4j-driver": "^6.0.1",
|
|
43
|
+
"resend": "^6.11.0"
|
|
40
44
|
},
|
|
41
45
|
"devDependencies": {
|
|
42
46
|
"@types/axios": "^0.9.36",
|
|
@@ -45,4 +49,4 @@
|
|
|
45
49
|
"ts-node": "^10.9.2",
|
|
46
50
|
"typescript": "^5.9.3"
|
|
47
51
|
}
|
|
48
|
-
}
|
|
52
|
+
}
|
package/server.json
CHANGED
|
@@ -2,31 +2,26 @@
|
|
|
2
2
|
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
3
|
"name": "io.github.piers-fawkes/fodda",
|
|
4
4
|
"title": "Fodda Knowledge Graphs",
|
|
5
|
-
"description": "Expert-curated knowledge graphs for AI agents —
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
"url": "https://github.com/piers-fawkes/fodda-mcp",
|
|
9
|
-
"source": "github"
|
|
10
|
-
},
|
|
11
|
-
"remotes": [
|
|
5
|
+
"description": "Expert-curated knowledge graphs for AI agents — retail, beauty, sports, plus institutional data",
|
|
6
|
+
"websiteUrl": "https://www.fodda.ai",
|
|
7
|
+
"icons": [
|
|
12
8
|
{
|
|
13
|
-
"
|
|
14
|
-
"
|
|
15
|
-
|
|
16
|
-
{
|
|
17
|
-
"name": "Authorization",
|
|
18
|
-
"description": "Bearer token with your Fodda API key (e.g. 'Bearer fk_live_...')",
|
|
19
|
-
"isRequired": true,
|
|
20
|
-
"isSecret": true
|
|
21
|
-
}
|
|
9
|
+
"src": "https://ucarecdn.com/6e7893d7-6b14-426b-83bc-574a3f72d6bc/foddafavicon.png",
|
|
10
|
+
"sizes": [
|
|
11
|
+
"any"
|
|
22
12
|
]
|
|
23
13
|
}
|
|
24
14
|
],
|
|
15
|
+
"version": "1.30.0",
|
|
16
|
+
"repository": {
|
|
17
|
+
"url": "https://github.com/piers-fawkes/fodda-mcp",
|
|
18
|
+
"source": "github"
|
|
19
|
+
},
|
|
25
20
|
"packages": [
|
|
26
21
|
{
|
|
27
22
|
"registryType": "npm",
|
|
28
23
|
"identifier": "fodda-mcp",
|
|
29
|
-
"version": "1.
|
|
24
|
+
"version": "1.7.0",
|
|
30
25
|
"transport": {
|
|
31
26
|
"type": "stdio"
|
|
32
27
|
},
|