fodda-mcp 1.46.31 → 1.46.97

package/dist/test_zero_retention_alerts.js

@@ -0,0 +1,76 @@
+/**
+ * Test suite for Zero Retention Alert Suppression and Query Privacy.
+ *
+ * Verifies:
+ * 1. buildGapAlertText redacts raw query to '[zero-retention contract]' when zeroQueryRetention is true.
+ * 2. buildFrustrationAlertText redacts queries to '[zero-retention contract]' when zeroQueryRetention is true.
+ * 3. Standard unflagged accounts continue to emit original query strings.
+ * 4. createSessionTracker tracks and updates zeroQueryRetention state correctly.
+ * 5. get_my_account status mapping logic surfaces queryRetention correctly.
+ *
+ * Run: node dist/test_zero_retention_alerts.js
+ */
+import { createSessionTracker, buildGapAlertText, buildFrustrationAlertText, } from './sessionTracker.js';
+delete process.env.SLACK_BOT_TOKEN; // prevent accidental live posts
+let failures = 0;
+function check(label, actual, expected) {
+    const pass = JSON.stringify(actual) === JSON.stringify(expected);
+    if (!pass)
+        failures++;
+    console.log(`${pass ? 'PASS' : 'FAIL'}  ${label}  (got ${JSON.stringify(actual)}, want ${JSON.stringify(expected)})`);
+}
+console.log('--- TEST: Data Gap Alert Suppression ---');
+const thinCoverage = { status: 'thin', results_returned: 5, results_on_topic: 1, layers_searched: ['retail', 'technology'] };
+// Standard account data gap
+const standardGapText = buildGapAlertText('user@enterprise.com', 'search_graph', 'Internal M&A Strategy 2026', thinCoverage, false);
+check('Standard gap alert includes raw query', standardGapText.includes('"Internal M&A Strategy 2026"'), true);
+check('Standard gap alert does not have redacted placeholder', standardGapText.includes('[zero-retention contract]'), false);
+// Zero retention account data gap
+const zeroGapText = buildGapAlertText('user@enterprise.com', 'search_graph', 'Internal M&A Strategy 2026', thinCoverage, true);
+check('Zero retention gap alert has redacted placeholder', zeroGapText.includes('🔎 Query: [zero-retention contract]'), true);
+check('Zero retention gap alert omits raw query text', zeroGapText.includes('Internal M&A Strategy 2026'), false);
+check('Zero retention gap alert preserves coverage metrics', zeroGapText.includes('thin — 1 of 5 results on-topic'), true);
+check('Zero retention gap alert preserves searched layers', zeroGapText.includes('retail, technology'), true);
+console.log('\n--- TEST: Frustration Alert Suppression ---');
+const frustrationDetails = {
+    pattern: 'LOW_YIELD',
+    graphsTried: ['retail', 'finance'],
+    recentQueries: ['secret initiative project titan', 'titan roadmap Q3'],
+    score: 2,
+};
+// Standard frustration alert
+const standardFrustrationText = buildFrustrationAlertText('user@enterprise.com', frustrationDetails, false);
+check('Standard frustration alert includes queries', standardFrustrationText.includes('secret initiative project titan, titan roadmap Q3'), true);
+check('Standard frustration alert does not have redacted placeholder', standardFrustrationText.includes('[zero-retention contract]'), false);
+// Zero retention frustration alert
+const zeroFrustrationText = buildFrustrationAlertText('user@enterprise.com', frustrationDetails, true);
+check('Zero retention frustration alert has redacted placeholder', zeroFrustrationText.includes('🔎 Queries: [zero-retention contract]'), true);
+check('Zero retention frustration alert omits raw queries', zeroFrustrationText.includes('secret initiative project titan'), false);
+check('Zero retention frustration alert preserves pattern', zeroFrustrationText.includes('🔍 Pattern: LOW_YIELD'), true);
+check('Zero retention frustration alert preserves graphs tried', zeroFrustrationText.includes('📊 Graphs tried: retail, finance'), true);
+check('Zero retention frustration alert preserves score', zeroFrustrationText.includes('📈 Frustration score: 2/3'), true);
+console.log('\n--- TEST: SessionTracker State Management ---');
+const defaultTracker = createSessionTracker();
+check('Default tracker zeroQueryRetention is false', defaultTracker.isZeroQueryRetention(), false);
+const flaggedTracker = createSessionTracker({ zeroQueryRetention: true });
+check('Flagged tracker zeroQueryRetention is true', flaggedTracker.isZeroQueryRetention(), true);
+defaultTracker.setZeroQueryRetention(true);
+check('Dynamically updated tracker zeroQueryRetention is true', defaultTracker.isZeroQueryRetention(), true);
+console.log('\n--- TEST: get_my_account queryRetention Resolution ---');
+function resolveQueryRetention(account) {
+    const isZero = Boolean(account?.zero_query_retention ||
+        account?.zeroQueryRetention ||
+        account?.query_retention === 'zero (contract)' ||
+        (typeof account?.query_retention === 'string' && account.query_retention.startsWith('zero')) ||
+        account?.queryRetention === 'zero (contract)' ||
+        (typeof account?.queryRetention === 'string' && account.queryRetention.startsWith('zero')));
+    return account?.query_retention || (isZero ? 'zero (contract)' : 'standard');
+}
+check('Standard account without flags resolves to standard', resolveQueryRetention({ plan: 'Pro' }), 'standard');
+check('Explicit query_retention: "standard" resolves to standard', resolveQueryRetention({ query_retention: 'standard' }), 'standard');
+check('Account with zero_query_retention: true resolves to zero (contract)', resolveQueryRetention({ zero_query_retention: true }), 'zero (contract)');
+check('Account with zeroQueryRetention: true resolves to zero (contract)', resolveQueryRetention({ zeroQueryRetention: true }), 'zero (contract)');
+check('Account with query_retention: "zero (contract)" resolves to zero (contract)', resolveQueryRetention({ query_retention: 'zero (contract)' }), 'zero (contract)');
+console.log(failures === 0 ? '\nALL ZERO RETENTION TESTS PASSED' : `\n${failures} CHECK(S) FAILED`);
+process.exit(failures === 0 ? 0 : 1);
+//# sourceMappingURL=test_zero_retention_alerts.js.map

package/dist/test_zero_retention_alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_zero_retention_alerts.js","sourceRoot":"","sources":["../src/test_zero_retention_alerts.ts"],"names":[],"mappings":"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"}

package/dist/toolHandlers.d.ts

@@ -3,17 +3,54 @@
  *
  * Extracted from index.ts to reduce monolith size.
  * Contains createServer() which registers all 30+ MCP tools.
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ * WARNING — TOOL DESCRIPTIONS IN THIS FILE MAY BE AIRTABLE-OWNED.
+ *
+ * `npm run build` runs scripts/sync-descriptions-from-airtable.mjs BEFORE tsc.
+ * That script reads the Airtable Offerings table (tbl93DJ627r81zKVP) and
+ * regex-rewrites the description string in `server.tool('<name>', '...')` for
+ * EVERY tool that has a row there. If you hand-edit such a description here,
+ * it is silently reverted on the next build.
+ *
+ *   Tool has an Offerings row  -> edit the Airtable row, then build.
+ *   Tool has no Offerings row  -> edit it here; the sync leaves it alone.
+ *
+ * The script exits 0 when AIRTABLE_API_KEY is unset, so a local build can
+ * appear to keep your edit while CI/deploy discards it. Verify by running the
+ * build and re-reading the description here before you ship.
+ *
+ * Airtable is the source of truth for published, customer-visible text.
+ * See Fodda API docs/bibles/system_clarifications.md section 2.
+ * ──────────────────────────────────────────────────────────────────────────
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function resolveAnalystAlias(analystIdInput: string, companyInput?: string): {
     analyst_id: string;
     company?: string | undefined;
 };
+/**
+ * Response hygiene filter for ChatGPT Apps Directory submission.
+ * Drops internal keys:
+ * - starting with `_` (e.g. `_account`, `_raw`, `_upstream_usage`)
+ * - `record_id`, `airtable_*` / keys matching airtable
+ * - `debug`, `trace`, `internal`
+ * - values matching `^rec[A-Za-z0-9]{14}$` (Airtable record IDs)
+ * Preserves all chainable IDs: analyst_id, graph_id, node_id, job_id, trend_id, id, session_id.
+ */
+export declare function sanitizePayloadForChatGpt(obj: any): any;
+/**
+ * Format pre-materialized earnings corroboration attached to trend hits.
+ * Formats executive quotes and analyst question themes with proper attribution:
+ * E.g. `[Earnings Call Corroboration]: Fabrizio Freda (CEO) [EL]: "Prestige beauty showed resilience across European travel retail." (Q2-2026)`
+ * Or: `[Earnings Call Corroboration]: [ULTA] Mass vs Prestige dynamic (Q2-2026)`
+ */
+export declare function formatEarningsCorroboration(corroboration: any): string | null;
 export type { FoddaRequestFn, WaverunnerRequestFn } from './types.js';
 import type { FoddaRequestFn, WaverunnerRequestFn } from './types.js';
 export declare function createServer(apiKey: string, userId: string, foddaRequest: FoddaRequestFn, waverunnerRequest: WaverunnerRequestFn, storeWidget: (html: string) => string, getServiceUrl: () => string, entryId?: string, sptCtx?: {
     token: string;
     maxAmountCents: number | null;
     prices: Record<string, number>;
-}, allowedTools?: Set<string> | string[]): Promise<McpServer>;
+}, allowedTools?: Set<string> | string[], sessionSource?: string): Promise<McpServer>;
 //# sourceMappingURL=toolHandlers.d.ts.map

package/dist/toolHandlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolHandlers.d.ts","sourceRoot":"","sources":["../src/toolHandlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCpE,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA+CvI;AAwGD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA8DtE,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,cAAc,EAC5B,iBAAiB,EAAE,mBAAmB,EACtC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,aAAa,EAAE,MAAM,MAAM,EAC3B,OAAO,GAAE,MAAW,EAEpB,MAAM,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACzF,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,GACtC,OAAO,CAAC,SAAS,CAAC,CA8iJpB"}
+{"version":3,"file":"toolHandlers.d.ts","sourceRoot":"","sources":["../src/toolHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCpE,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA+CvI;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAuBvD;AAyED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAmC7E;AAoBD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA0EtE,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,cAAc,EAC5B,iBAAiB,EAAE,mBAAmB,EACtC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,aAAa,EAAE,MAAM,MAAM,EAC3B,OAAO,GAAE,MAAW,EAEpB,MAAM,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACzF,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,EACrC,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,SAAS,CAAC,CA+iPpB"}