fodda-mcp 1.3.2 → 1.30.0

package/dist/agents/fodda-researcher/index.js

@@ -0,0 +1,62 @@
+/**
+ * Fodda Research Agent — System Instruction Builder
+ *
+ * Loads the 5 skill files and assembles a system instruction for the
+ * Gemini Interactions API. This is the "agent" — a skill-injected system
+ * prompt that tells Gemini how to conduct Fodda-style research.
+ *
+ * Usage:
+ *   import { buildResearcherInstruction } from './agents/fodda-researcher/index.js';
+ *   const systemInstruction = buildResearcherInstruction(query, graphContext);
+ */
+import { SKILL_RESEARCH_METHODOLOGY, SKILL_EVIDENCE_CATEGORIES, SKILL_OUTPUT_FORMAT, SKILL_GRAPH_AWARENESS, SKILL_SOURCE_QUALITY, } from './skills.js';
+/**
+ * Build the complete system instruction for the Fodda Research Agent.
+ *
+ * Concatenates all 5 skill files with a mission preamble and any
+ * graph context that was pre-fetched from Fodda's knowledge graphs.
+ */
+export function buildResearcherInstruction(query, context) {
+    const sections = [];
+    // ── Mission preamble ──
+    sections.push(`You are the Fodda Research Agent — an autonomous deep researcher that produces 
+editorial-quality intelligence reports by combining curated knowledge graph data 
+with web research.
+
+Your research query is: "${query}"
+${context?.focusGraphId ? `\nFocus graph: ${context.focusGraphId}` : 'Search all accessible knowledge graphs.'}
+
+Follow the skills below precisely. They encode Fodda's research methodology, 
+evidence standards, output format, graph attribution rules, and source quality 
+requirements.
+
+---`);
+    // ── Skills ──
+    sections.push(SKILL_RESEARCH_METHODOLOGY);
+    sections.push('---');
+    sections.push(SKILL_EVIDENCE_CATEGORIES);
+    sections.push('---');
+    sections.push(SKILL_OUTPUT_FORMAT);
+    sections.push('---');
+    sections.push(SKILL_GRAPH_AWARENESS);
+    sections.push('---');
+    sections.push(SKILL_SOURCE_QUALITY);
+    // ── Pre-fetched graph context ──
+    if (context?.graphResults) {
+        sections.push('---');
+        sections.push(`# Pre-Loaded Knowledge Graph Data
+
+The following trends and evidence were pre-fetched from Fodda's knowledge graphs. 
+Use this as your PRIMARY source material. Supplement with Google Search only for 
+themes not covered here.
+
+Graphs searched: ${context.graphsSearched?.join(', ') || 'unknown'}
+Total trends found: ${context.totalTrends ?? 'unknown'}
+Total evidence pieces: ${context.totalEvidence ?? 'unknown'}
+
+## Graph Data
+${context.graphResults}`);
+    }
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/fodda-researcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/fodda-researcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACH,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,aAAa,CAAC;AAmBrB;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACtC,KAAa,EACb,OAAsB;IAEtB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC;;;;2BAIS,KAAK;EAC9B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,yCAAyC;;;;;;IAM1G,CAAC,CAAC;IAEF,eAAe;IACf,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAEpC,kCAAkC;IAClC,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC;;;;;;mBAMH,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS;sBAC5C,OAAO,CAAC,WAAW,IAAI,SAAS;yBAC7B,OAAO,CAAC,aAAa,IAAI,SAAS;;;EAGzD,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/agents/fodda-researcher/skills.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Fodda Research Agent — Skill Definitions
+ *
+ * These are static skill instruction files that encode the Fodda research
+ * methodology. The agent's system instruction is assembled from these skills
+ * at runtime.
+ * Converted to NLSpec v2 format.
+ *
+ * To modify a skill, edit the constant below and redeploy.
+ */
+export declare const SKILL_RESEARCH_METHODOLOGY = "---\nid: FODDA-SKILL-METHODOLOGY-001\ntitle: Fodda Research Methodology Skill\nversion: 2.0.0\ncompliance: RFC-2119\n---\n\n### SEQUENCE: DeepResearch\n1. **Phase 1: PLAN** \u2014 seconds:\n   - Decompose the query into 2-4 research dimensions.\n   - Identify which knowledge graph verticals are most relevant.\n   - Determine if supplemental data sources (Google Trends, BLS, Census, OECD) are needed.\n   - Estimate research depth: light (3-4 sources) vs comprehensive (6+ sources).\n2. **Phase 2: SEARCH** \u2014 primary:\n   - Analyze pre-loaded Fodda knowledge graph results.\n   - Identify convergence patterns across multiple graphs.\n   - Track which graphs yielded strong results and which were sparse.\n   - Note signal_score values: 80+ is strong, 60-79 is moderate, below 60 is weak.\n3. **Phase 3: READ** \u2014 deepen:\n   - Examine evidence snippets and source URLs for key themes.\n   - Use Google Search to find additional context for high-signal trends.\n   - Use URL Context for primary source verification if external URLs are referenced.\n   - Flag conflicting evidence explicitly.\n4. **Phase 4: SYNTHESIZE** \u2014 connect:\n   - Identify the 3-5 strongest themes.\n   - Rank by signal strength, evidence count, recency, and cross-graph convergence.\n   - Build narrative arc: What is happening -> Why it matters -> What comes next.\n   - Note gaps in coverage.\n5. **Phase 5: CITE** \u2014 attribute:\n   - Every claim MUST reference its source graph and evidence.\n   - Attribute findings to source graph by name.\n   - Include source URLs as inline citations.\n   - Suggest 2-3 follow-up research questions.\n";
+export declare const SKILL_EVIDENCE_CATEGORIES = "---\nid: FODDA-SKILL-EVIDENCE-001\ntitle: Fodda Evidence Categories Skill\nversion: 2.0.0\ncompliance: RFC-2119\n---\n\n### TOKEN: EvidenceCategories\n\n| Category | What it covers | When to use |\n|----------|---------------|-------------|\n| Case Study | Innovation, strategic moves, novel approaches | Must demonstrate innovation or strategic intent \u2014 NOT routine news |\n| Statistic | Quantitative data \u2014 market sizes, growth rates, survey results | Numbers with clear methodology |\n| Data Point | Factual brand/industry news without innovation | Routine business activity, personnel changes, earnings, regulatory |\n| Analysis | Expert interpretation, industry reports, competitive assessments | Qualitative expert judgment |\n| Interview | Direct quotes from practitioners, executives, researchers | Verbatim attributed speech |\n\n### RULE: EvidenceClassification\n- Case Study REQUIRES demonstrated innovation or strategic intent.\n- Routine brand news (store openings, executive hires) MUST map to Data Point.\n- If an article contains both a stat and analysis, classify by PRIMARY value.\n- \"Report\" MUST map to Analysis.\n- The agent MUST NOT invent a 6th category; all evidence must fit into these 5.\n- A finding MAY cite multiple evidence pieces of different types.\n";
+export declare const SKILL_OUTPUT_FORMAT = "---\nid: FODDA-SKILL-OUTPUT-001\ntitle: Fodda Output Format Skill\nversion: 2.0.0\ncompliance: RFC-2119\n---\n\n### RECORD: ResearchReport\n- executive_summary: String \u2014 2-3 sentences. The single most important finding, stated as a provocative editorial claim.\n- thematic_sections: List[ThematicSection] \u2014 3-5 thematic narrative sections.\n- strategic_agenda: List[Implication] \u2014 2-3 concrete moves.\n- source_landscape: List[SourceLink] \u2014 bulleted list of all source URLs referenced.\n\n### RULE: OutputFormat\n- Thematic sections MUST:\n  - Open with a declarative statement.\n  - Use flowing paragraphs with embedded data points (no bullet lists).\n  - Weave in source citations inline: \"Sephora's AI Color Match drove a 28% conversion lift (PSFK Retail Graph)\".\n  - Close with a practical implication: what this means for the practitioner.\n- Tone MUST read like a senior strategist briefing a CMO, not a consultant deck. Strongest findings first.\n- The agent MUST NOT use italicized terms followed by parenthetical attribution for trends. Instead, weave attribution into the narrative sentence as the subject (e.g. \"One trend, [Trend Name] from [Graph/Expert], highlights how...\").\n- Ground every trend in a named example ONLY IF one is provided in the graph evidence. Do NOT hunt via Google Search for missing examples.\n- If a trend lacks recent statistics, the agent SHOULD use the google_search tool to find recent (2025-2026) statistics.\n- Prefer Fodda graph stats over web stats. Cite Fodda stats as: \"According to research tracked in the [Graph/Expert Name] graph...\".\n";
+export declare const SKILL_GRAPH_AWARENESS = "---\nid: FODDA-SKILL-AWARENESS-001\ntitle: Fodda Graph Awareness Skill\nversion: 2.0.0\ncompliance: RFC-2119\n---\n\n### RULE: GraphAwareness\n- Each graph is a curated knowledge graph representing an editorial viewpoint with evidence, not a generic database.\n- Multi-graph convergence (same theme in 2+ graphs) indicates a high-confidence finding.\n- Contradicting graphs MUST be noted explicitly as a tension.\n- Match expert graph terminology on concepts, not labels.\n- Industry report graphs are deep but narrow; excellent for specific verticals.\n\n### TOKEN: GraphTypes\n- PSFK curated graphs: retail, beauty, fashion, sports, sic, ce-design, pew.\n- Expert graphs: individual specialist perspectives (e.g., ezra-eeman-wayfinder, alyson-stevens-macro).\n- Industry report graphs: single-report deep dives (e.g., pwc/sxsw-2026-key-insights, delta/the-connection-index).\n\n### RULE: GraphAttribution\n- The agent MUST NEVER say \"the Fodda graph\" or \"according to Fodda\". Fodda is the platform; graphs are created by named experts.\n- Format: \"According to PSFK's Retail Graph...\" or \"Ezra Eeman's Wayfinder Graph identifies...\".\n- Include graph_id for programmatic reference.\n";
+export declare const SKILL_SOURCE_QUALITY = "---\nid: FODDA-SKILL-QUALITY-001\ntitle: Fodda Source Quality Skill\nversion: 2.0.0\ncompliance: RFC-2119\n---\n\n### TOKEN: SourceCredibilityTiers\n- Tier 5 (Primary Research): Earnings reports, PubMed, OECD, Census, BLS, government filings.\n- Tier 4 (Expert Analysis): PSFK original research, McKinsey, Deloitte, named expert graphs.\n- Tier 3 (Quality Journalism): Financial Times, Bloomberg, Business of Fashion, Wired.\n- Tier 2 (Industry Sources): Trade publications, brand press releases, industry blogs.\n- Tier 1 (Unverified): Social media posts, individual opinions, unattributed claims.\n\n### RULE: SourcePreferenceHierarchy\n- The agent MUST follow this preference order:\n  1. Fodda knowledge graph evidence (pre-vetted, always prefer).\n  2. Supplemental structured data (BLS, Census, Google Trends, OECD).\n  3. Google Search results (web-sourced context for themes not covered).\n  4. URL-fetched primary sources (for deep verification).\n\n### RULE: SourceQualityGate\n- At least 60% of cited evidence SHOULD be tier 3 or above.\n- The agent MUST NOT present a tier 1-2 source without qualification (\"industry reports suggest...\").\n- Acknowledge explicitly if a finding relies on a single source.\n- Recency: Prefer evidence less than 12 months old.\n- Note geographic concentration (e.g., US-only).\n- Trust the graph over web sources in case of conflicts.\n";
+//# sourceMappingURL=skills.d.ts.map

package/dist/agents/fodda-researcher/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/agents/fodda-researcher/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,eAAO,MAAM,0BAA0B,wmDAiCtC,CAAC;AAMF,eAAO,MAAM,yBAAyB,mxCAwBrC,CAAC;AAMF,eAAO,MAAM,mBAAmB,klDAwB/B,CAAC;AAMF,eAAO,MAAM,qBAAqB,8qCAuBjC,CAAC;AAMF,eAAO,MAAM,oBAAoB,02CA4BhC,CAAC"}

package/dist/agents/fodda-researcher/skills.js

@@ -0,0 +1,163 @@
+/**
+ * Fodda Research Agent — Skill Definitions
+ *
+ * These are static skill instruction files that encode the Fodda research
+ * methodology. The agent's system instruction is assembled from these skills
+ * at runtime.
+ * Converted to NLSpec v2 format.
+ *
+ * To modify a skill, edit the constant below and redeploy.
+ */
+// ---------------------------------------------------------------------------
+// Skill 1: Research Methodology
+// ---------------------------------------------------------------------------
+export const SKILL_RESEARCH_METHODOLOGY = `---
+id: FODDA-SKILL-METHODOLOGY-001
+title: Fodda Research Methodology Skill
+version: 2.0.0
+compliance: RFC-2119
+---
+
+### SEQUENCE: DeepResearch
+1. **Phase 1: PLAN** — seconds:
+   - Decompose the query into 2-4 research dimensions.
+   - Identify which knowledge graph verticals are most relevant.
+   - Determine if supplemental data sources (Google Trends, BLS, Census, OECD) are needed.
+   - Estimate research depth: light (3-4 sources) vs comprehensive (6+ sources).
+2. **Phase 2: SEARCH** — primary:
+   - Analyze pre-loaded Fodda knowledge graph results.
+   - Identify convergence patterns across multiple graphs.
+   - Track which graphs yielded strong results and which were sparse.
+   - Note signal_score values: 80+ is strong, 60-79 is moderate, below 60 is weak.
+3. **Phase 3: READ** — deepen:
+   - Examine evidence snippets and source URLs for key themes.
+   - Use Google Search to find additional context for high-signal trends.
+   - Use URL Context for primary source verification if external URLs are referenced.
+   - Flag conflicting evidence explicitly.
+4. **Phase 4: SYNTHESIZE** — connect:
+   - Identify the 3-5 strongest themes.
+   - Rank by signal strength, evidence count, recency, and cross-graph convergence.
+   - Build narrative arc: What is happening -> Why it matters -> What comes next.
+   - Note gaps in coverage.
+5. **Phase 5: CITE** — attribute:
+   - Every claim MUST reference its source graph and evidence.
+   - Attribute findings to source graph by name.
+   - Include source URLs as inline citations.
+   - Suggest 2-3 follow-up research questions.
+`;
+// ---------------------------------------------------------------------------
+// Skill 2: Evidence Categories
+// ---------------------------------------------------------------------------
+export const SKILL_EVIDENCE_CATEGORIES = `---
+id: FODDA-SKILL-EVIDENCE-001
+title: Fodda Evidence Categories Skill
+version: 2.0.0
+compliance: RFC-2119
+---
+
+### TOKEN: EvidenceCategories
+
+| Category | What it covers | When to use |
+|----------|---------------|-------------|
+| Case Study | Innovation, strategic moves, novel approaches | Must demonstrate innovation or strategic intent — NOT routine news |
+| Statistic | Quantitative data — market sizes, growth rates, survey results | Numbers with clear methodology |
+| Data Point | Factual brand/industry news without innovation | Routine business activity, personnel changes, earnings, regulatory |
+| Analysis | Expert interpretation, industry reports, competitive assessments | Qualitative expert judgment |
+| Interview | Direct quotes from practitioners, executives, researchers | Verbatim attributed speech |
+
+### RULE: EvidenceClassification
+- Case Study REQUIRES demonstrated innovation or strategic intent.
+- Routine brand news (store openings, executive hires) MUST map to Data Point.
+- If an article contains both a stat and analysis, classify by PRIMARY value.
+- "Report" MUST map to Analysis.
+- The agent MUST NOT invent a 6th category; all evidence must fit into these 5.
+- A finding MAY cite multiple evidence pieces of different types.
+`;
+// ---------------------------------------------------------------------------
+// Skill 3: Output Format
+// ---------------------------------------------------------------------------
+export const SKILL_OUTPUT_FORMAT = `---
+id: FODDA-SKILL-OUTPUT-001
+title: Fodda Output Format Skill
+version: 2.0.0
+compliance: RFC-2119
+---
+
+### RECORD: ResearchReport
+- executive_summary: String — 2-3 sentences. The single most important finding, stated as a provocative editorial claim.
+- thematic_sections: List[ThematicSection] — 3-5 thematic narrative sections.
+- strategic_agenda: List[Implication] — 2-3 concrete moves.
+- source_landscape: List[SourceLink] — bulleted list of all source URLs referenced.
+
+### RULE: OutputFormat
+- Thematic sections MUST:
+  - Open with a declarative statement.
+  - Use flowing paragraphs with embedded data points (no bullet lists).
+  - Weave in source citations inline: "Sephora's AI Color Match drove a 28% conversion lift (PSFK Retail Graph)".
+  - Close with a practical implication: what this means for the practitioner.
+- Tone MUST read like a senior strategist briefing a CMO, not a consultant deck. Strongest findings first.
+- The agent MUST NOT use italicized terms followed by parenthetical attribution for trends. Instead, weave attribution into the narrative sentence as the subject (e.g. "One trend, [Trend Name] from [Graph/Expert], highlights how...").
+- Ground every trend in a named example ONLY IF one is provided in the graph evidence. Do NOT hunt via Google Search for missing examples.
+- If a trend lacks recent statistics, the agent SHOULD use the google_search tool to find recent (2025-2026) statistics.
+- Prefer Fodda graph stats over web stats. Cite Fodda stats as: "According to research tracked in the [Graph/Expert Name] graph...".
+`;
+// ---------------------------------------------------------------------------
+// Skill 4: Graph Awareness
+// ---------------------------------------------------------------------------
+export const SKILL_GRAPH_AWARENESS = `---
+id: FODDA-SKILL-AWARENESS-001
+title: Fodda Graph Awareness Skill
+version: 2.0.0
+compliance: RFC-2119
+---
+
+### RULE: GraphAwareness
+- Each graph is a curated knowledge graph representing an editorial viewpoint with evidence, not a generic database.
+- Multi-graph convergence (same theme in 2+ graphs) indicates a high-confidence finding.
+- Contradicting graphs MUST be noted explicitly as a tension.
+- Match expert graph terminology on concepts, not labels.
+- Industry report graphs are deep but narrow; excellent for specific verticals.
+
+### TOKEN: GraphTypes
+- PSFK curated graphs: retail, beauty, fashion, sports, sic, ce-design, pew.
+- Expert graphs: individual specialist perspectives (e.g., ezra-eeman-wayfinder, alyson-stevens-macro).
+- Industry report graphs: single-report deep dives (e.g., pwc/sxsw-2026-key-insights, delta/the-connection-index).
+
+### RULE: GraphAttribution
+- The agent MUST NEVER say "the Fodda graph" or "according to Fodda". Fodda is the platform; graphs are created by named experts.
+- Format: "According to PSFK's Retail Graph..." or "Ezra Eeman's Wayfinder Graph identifies...".
+- Include graph_id for programmatic reference.
+`;
+// ---------------------------------------------------------------------------
+// Skill 5: Source Quality
+// ---------------------------------------------------------------------------
+export const SKILL_SOURCE_QUALITY = `---
+id: FODDA-SKILL-QUALITY-001
+title: Fodda Source Quality Skill
+version: 2.0.0
+compliance: RFC-2119
+---
+
+### TOKEN: SourceCredibilityTiers
+- Tier 5 (Primary Research): Earnings reports, PubMed, OECD, Census, BLS, government filings.
+- Tier 4 (Expert Analysis): PSFK original research, McKinsey, Deloitte, named expert graphs.
+- Tier 3 (Quality Journalism): Financial Times, Bloomberg, Business of Fashion, Wired.
+- Tier 2 (Industry Sources): Trade publications, brand press releases, industry blogs.
+- Tier 1 (Unverified): Social media posts, individual opinions, unattributed claims.
+
+### RULE: SourcePreferenceHierarchy
+- The agent MUST follow this preference order:
+  1. Fodda knowledge graph evidence (pre-vetted, always prefer).
+  2. Supplemental structured data (BLS, Census, Google Trends, OECD).
+  3. Google Search results (web-sourced context for themes not covered).
+  4. URL-fetched primary sources (for deep verification).
+
+### RULE: SourceQualityGate
+- At least 60% of cited evidence SHOULD be tier 3 or above.
+- The agent MUST NOT present a tier 1-2 source without qualification ("industry reports suggest...").
+- Acknowledge explicitly if a finding relies on a single source.
+- Recency: Prefer evidence less than 12 months old.
+- Note geographic concentration (e.g., US-only).
+- Trust the graph over web sources in case of conflicts.
+`;
+//# sourceMappingURL=skills.js.map

package/dist/agents/fodda-researcher/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/agents/fodda-researcher/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCzC,CAAC;AAEF,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBxC,CAAC;AAEF,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBlC,CAAC;AAEF,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBpC,CAAC;AAEF,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BnC,CAAC"}

package/dist/brandTemplate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Brand Intelligence Widget Template Engine
+ *
+ * Server-side slot filling for the Fodda brand intelligence widget.
+ * Fills ~90% of slots mechanically. Returns near-complete HTML with
+ * only editorial slots open for Claude to fill (~200 tokens).
+ */
+export declare function renderBrandWidget(profile: any): Promise<{
+    widget_html: string;
+    editorial_context: any;
+    open_slots: string[];
+}>;
+export declare const TEMPLATE = "\n<style>\n:root{--p:#663399;--pl:#F5F0FF;--pm:#9B72CC;--pl-on:#663399;}\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.bh{display:flex;justify-content:space-between;align-items:flex-start;margin-bottom:.75rem;}\n.bn{font-family:var(--font-serif);font-style:italic;font-weight:400;font-size:22px;letter-spacing:-0.01em;}\n.vc{font-size:9px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;padding:3px 8px;border:1px solid currentColor;border-radius:2px;font-family:var(--font-mono);}\n.vc-up{color:var(--color-text-success);}\n.vc-build{color:var(--color-text-info);}\n.vc-steady{color:var(--color-text-secondary);}\n.vc-slow{color:var(--color-text-warning);}\n.pv{font-size:14px;font-family:var(--font-serif);font-style:italic;font-weight:400;line-height:1.65;padding:14px 16px;background:var(--pl);border:1px solid var(--p);border-left-width:3px;border-radius:4px;margin-bottom:1.25rem;color:var(--color-text-primary);}\n.lcb{display:flex;height:8px;border-radius:4px;overflow:hidden;margin-bottom:.75rem;gap:2px;}\n.lcl{display:flex;gap:12px;margin-bottom:1.25rem;flex-wrap:wrap;}\n.lci{display:flex;align-items:center;gap:5px;font-size:10px;color:var(--color-text-secondary);}\n.lcd{width:8px;height:8px;border-radius:2px;}\n.card{background:var(--color-background-primary);border:1px solid var(--color-border-tertiary);border-radius:4px;padding:1rem 1.25rem;margin-bottom:8px;transition:border-color .15s,background .15s;}\n.card:hover{border-color:var(--p);background:var(--pl);}\n.th{display:flex;justify-content:space-between;align-items:flex-start;margin-bottom:6px;gap:8px;}\n.tn{font-size:13px;font-weight:500;}\n.ta{display:flex;align-items:center;gap:4px;flex-shrink:0;}\n.td{font-size:12px;color:var(--color-text-secondary);margin-bottom:5px;line-height:1.5;}\n.lb{font-size:9px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;padding:3px 8px;border:1px solid currentColor;border-radius:2px;white-space:nowrap;font-family:var(--font-mono);background:transparent;}\n.lb-b{color:var(--color-text-info);}\n.lb-e{color:var(--color-text-success);}\n.lb-m{color:var(--color-text-secondary);}\n.lb-f{color:var(--color-text-warning);}\n.bd{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);font-family:var(--font-mono);}\n.bd-fast{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:#7A4000;font-family:var(--font-mono);}\n.bdp{font-size:10px;padding:2px 8px;border-radius:20px;background:var(--pl);color:var(--pl-on);font-family:var(--font-mono);}\n.brow{display:flex;gap:6px;flex-wrap:wrap;margin-top:8px;}\n.wl{font-size:11px;color:var(--color-text-secondary);margin:1.25rem 0 8px;display:flex;align-items:center;gap:6px;}\n.wd{width:6px;height:6px;border-radius:50%;background:var(--color-text-warning);display:inline-block;}\n.ec{border:1px dashed var(--color-border-tertiary);border-radius:4px;margin-bottom:8px;padding:1rem 1.25rem;}\n.et a{color:var(--color-text-info);text-decoration:none;font-size:13px;font-weight:500;}.et a:hover{text-decoration:underline;}\n.ex{font-size:12px;color:var(--color-text-secondary);line-height:1.5;margin:6px 0 8px;}\n.em{display:flex;gap:6px;flex-wrap:wrap;}\n.cit{font-size:10px;color:var(--color-text-secondary);margin-top:8px;padding-top:8px;border-top:.5px solid var(--color-border-tertiary);}\n.cit a{color:var(--color-text-info);text-decoration:none;}\n.cat-cs{background:var(--color-background-info);color:var(--color-text-info);}\n.cat-si{background:var(--pl);color:var(--p);}\n.cat-me{background:var(--color-background-success);color:var(--color-text-success);}\n.cat-qu{background:var(--color-background-warning);color:var(--color-text-warning);}\n.cat-in{background:var(--color-background-secondary);color:var(--color-text-secondary);}\n.cc{background:var(--color-background-primary);border:1px solid var(--color-border-tertiary);border-radius:4px;padding:.875rem 1.25rem;margin-bottom:6px;display:flex;justify-content:space-between;align-items:center;}\n.cn{font-size:13px;font-weight:500;margin-bottom:3px;}\n.cd{font-size:11px;color:var(--color-text-secondary);}\n.ca{display:flex;flex-direction:column;align-items:flex-end;gap:6px;}\n.pb{font-size:9px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;padding:3px 8px;border:1px solid currentColor;border-radius:2px;font-family:var(--font-mono);background:transparent;}\n.sl2, .sec{font-size:13px;font-weight:500;color:var(--color-text-primary);margin:1.25rem 0 8px;}.sl2:first-child, .sec:first-child{margin-top:0;}\n.br{display:flex;align-items:center;gap:8px;margin-bottom:5px;font-size:12px;}\n.brl{width:120px;color:var(--color-text-secondary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;flex-shrink:0;}\n.brt{flex:1;height:4px;background:var(--color-background-secondary);border-radius:3px;overflow:hidden;}\n.brf{height:100%;background:var(--p);border-radius:3px;}\n.brc{min-width:44px;text-align:right;color:var(--color-text-secondary);font-size:11px;}\n.sg{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin-bottom:1rem;}\n.sk{background:var(--color-background-secondary);border-radius:8px;padding:10px 12px;}\n.skl{font-size:10px;color:var(--color-text-secondary);margin-bottom:3px;}\n.skv{font-family:var(--font-serif);font-style:italic;font-size:22px;font-weight:400;}.sks{font-size:10px;color:var(--color-text-secondary);margin-top:2px;}\n.rq{display:flex;gap:5px;flex-wrap:wrap;margin-bottom:.75rem;}\n.rqp{font-size:10px;padding:3px 9px;border-radius:20px;background:var(--color-background-secondary);color:var(--color-text-secondary);border:.5px solid var(--color-border-tertiary);}\n.xb{display:flex;align-items:center;gap:10px;padding:12px 16px;background:var(--color-background-secondary);border:.5px solid var(--color-border-tertiary);border-radius:8px;cursor:pointer;text-align:left;width:100%;margin-bottom:8px;font-family:var(--font-mono);transition:all .15s;}\n.xb:hover{background:var(--pl);border-color:var(--pm);}\n.xi{font-size:11px;width:28px;font-weight:500;flex-shrink:0;color:var(--color-text-secondary);}\n.xd{font-size:11px;color:var(--color-text-secondary);margin-top:2px;}\n.xbl{font-weight:500;font-size:12px;}\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.ap{background:var(--color-background-secondary);border-radius:8px;margin-bottom:6px;padding:.75rem 1rem;display:flex;justify-content:space-between;align-items:center;}\n.an2{font-size:12px;font-weight:500;}\n.am2{font-size:11px;color:var(--color-text-secondary);margin-top:2px;}\n.astar{font-size:11px;color:var(--p);}\n.note{font-size:10px;color:var(--color-text-secondary);margin-bottom:1.25rem;}\n.btn-out{font-size:9px;padding:2px 7px;cursor:pointer;border:.5px solid var(--pm);border-radius:20px;background:var(--pl);color:var(--pl-on);font-family:var(--font-mono);}\n.btn-out:hover{background:var(--p);color:#fff;border-color:var(--p);}\n.cp{font-size:11px;background:var(--pl);color:var(--pl-on);border:.5px solid var(--pm);border-radius:20px;padding:3px 10px;cursor:pointer;font-family:var(--font-mono);transition:all .15s;}\n.cp:hover{background:var(--p);color:#fff;}\n.cv{font-size:10px;background:var(--pl);color:var(--pl-on);border:.5px solid var(--pm);border-radius:20px;padding:2px 8px;cursor:pointer;font-family:var(--font-mono);transition:all .15s;}\n.cv:hover{background:var(--p);color:#fff;}\n.an{font-size:13px;line-height:1.7;color:var(--color-text-primary);}\n.an p{margin:0 0 .75rem;}\n.an strong{font-weight:500;}\n.si{font-size:12px;line-height:1.65;color:var(--color-text-secondary);font-style:italic;margin:0 0 1rem;}\n</style>\n\n<div class=\"w\">\n  <div class=\"hd\">\n    <div class=\"logo\">\n      <img src=\"https://cdn.jsdelivr.net/gh/piers-fawkes/fodda-demo@main/public/fodda-mini-logo-claude.png\" alt=\"Fodda\" style=\"height:24px;width:24px;\"/>\n      <div><div class=\"lt\">Fodda</div><div class=\"ls\">Brand Intelligence</div></div>\n    </div>\n    <div class=\"bfolio\">{{FOLIO}}</div>\n  </div>\n\n  <div class=\"bh\">\n    <div class=\"bn\">{{BRAND_NAME}}</div>\n    <span class=\"vc {{VELOCITY_CLASS}}\">{{VELOCITY_LABEL}}</span>\n  </div>\n\n  <div class=\"pv\">{{ONE_LINER}}</div>\n\n  <div class=\"sec\">Case Studies</div>\n  {{EVIDENCE_HTML}}\n\n  {{EARNINGS_SECTION_HTML}}\n\n  <div class=\"sec\">Relevant trends</div>\n  {{TREND_FOOTPRINT_INTRO}}\n  <div class=\"lcb\">{{LIFECYCLE_BAR}}</div>\n  <div class=\"lcl\">{{LIFECYCLE_LEGEND}}</div>\n  {{TRENDS_HTML}}\n  {{WEAK_SIGNALS_HTML}}\n\n  <div class=\"sec\">Competitive</div>\n  {{COMPETITOR_LIST_HTML}}\n\n  <div class=\"sec\">Market data</div>\n  {{MARKET_DATA_INTRO}}\n  <div class=\"sl2\">US retail sales \u2014 Census Bureau</div>\n  <div class=\"sg\">\n    <div class=\"sk\"><div class=\"skl\">{{BEA_STAT_1_LABEL}}</div><div class=\"skv\">{{BEA_STAT_1_VALUE}}</div><div class=\"sks\">{{BEA_STAT_1_SUB}}</div></div>\n    <div class=\"sk\"><div class=\"skl\">{{BEA_STAT_2_LABEL}}</div><div class=\"skv\">{{BEA_STAT_2_VALUE}}</div><div class=\"sks\">{{BEA_STAT_2_SUB}}</div></div>\n  </div>\n\n  {{GT_SECTION_HTML}}\n  {{GT_COMPARISON_SECTION_HTML}}\n  {{RELATED_QUERIES_SECTION_HTML}}\n\n  <div class=\"sl2\">Wikipedia \u2014 avg daily pageviews</div>\n  {{WIKI_BARS_HTML}}\n  <p class=\"note\">{{WIKI_NOTE}}</p>\n\n  <div class=\"sl2\">Amazon footprint</div>\n  <div class=\"sg\">\n    <div class=\"sk\"><div class=\"skl\">{{AMAZON_STAT_1_LABEL}}</div><div class=\"skv\">{{AMAZON_STAT_1_VALUE}}</div><div class=\"sks\">{{AMAZON_STAT_1_SUB}}</div></div>\n    <div class=\"sk\"><div class=\"skl\">{{AMAZON_STAT_2_LABEL}}</div><div class=\"skv\">{{AMAZON_STAT_2_VALUE}}</div><div class=\"sks\">{{AMAZON_STAT_2_SUB}}</div></div>\n    <div class=\"sk\"><div class=\"skl\">{{AMAZON_STAT_3_LABEL}}</div><div class=\"skv\">{{AMAZON_STAT_3_VALUE}}</div><div class=\"sks\">{{AMAZON_STAT_3_SUB}}</div></div>\n    <div class=\"sk\"><div class=\"skl\">{{AMAZON_STAT_4_LABEL}}</div><div class=\"skv\">{{AMAZON_STAT_4_VALUE}}</div><div class=\"sks\">{{AMAZON_STAT_4_SUB}}</div></div>\n  </div>\n  {{AMAZON_PRODUCTS_HTML}}\n  <p class=\"note\">{{AMAZON_CAPTION}}</p>\n\n  {{GEO_SECTION_HTML}}\n\n  <div class=\"sec\">Explore further</div>\n  {{SUGGESTED_NEXT_HTML}}\n  <button class=\"xb\" onclick=\"sendPrompt('{{EXPORT_1_PROMPT}}')\"><span class=\"xi\">\u2197</span><div><div class=\"xbl\">{{EXPORT_1_LABEL}}</div><div class=\"xd\">{{EXPORT_1_DESC}}</div></div></button>\n  <button class=\"xb\" onclick=\"sendPrompt('{{EXPORT_2_PROMPT}}')\"><span class=\"xi\">\u2197</span><div><div class=\"xbl\">{{EXPORT_2_LABEL}}</div><div class=\"xd\">{{EXPORT_2_DESC}}</div></div></button>\n  <button class=\"xb\" onclick=\"sendPrompt('{{EXPORT_3_PROMPT}}')\"><span class=\"xi\">\u2197</span><div><div class=\"xbl\">{{EXPORT_3_LABEL}}</div><div class=\"xd\">{{EXPORT_3_DESC}}</div></div></button>\n  <button class=\"xb\" onclick=\"sendPrompt('{{EXPORT_4_PROMPT}}')\"><span class=\"xi\">\u2197</span><div><div class=\"xbl\">{{EXPORT_4_LABEL}}</div><div class=\"xd\">{{EXPORT_4_DESC}}</div></div></button>\n\n  <div class=\"gf\">\n    <span class=\"gfl\">Sources:</span>\n    {{SOURCE_PILLS_HTML}}\n</div>";
+//# sourceMappingURL=brandTemplate.d.ts.map

package/dist/brandTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brandTemplate.d.ts","sourceRoot":"","sources":["../src/brandTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6PH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8WpI;AAGD,eAAO,MAAM,QAAQ,6iYAiKd,CAAC"}