freshcontext-mcp 0.3.16 → 0.3.18

package/dist/rest/handler.js

@@ -0,0 +1,126 @@
+import { evaluateSignal, evaluateSignals } from "../core/index.js";
+const SERVICE_VERSION = "0.1.0";
+const JSON_CONTENT_TYPE = "application/json";
+const MAX_BODY_BYTES = 256 * 1024;
+function jsonResponse(body, status = 200) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "Content-Type": JSON_CONTENT_TYPE },
+    });
+}
+function errorResponse(code, message, status, details = []) {
+    return jsonResponse({ error: { code, message, details } }, status);
+}
+function methodNotAllowed(allowed) {
+    return new Response(JSON.stringify({
+        error: {
+            code: "method_not_allowed",
+            message: `Method not allowed. Use ${allowed}.`,
+            details: [],
+        },
+    }), {
+        status: 405,
+        headers: {
+            "Content-Type": JSON_CONTENT_TYPE,
+            "Allow": allowed,
+        },
+    });
+}
+function isJsonContentType(request) {
+    return (request.headers.get("Content-Type") ?? "").toLowerCase().includes(JSON_CONTENT_TYPE);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readJsonBody(request) {
+    if (!isJsonContentType(request)) {
+        return {
+            ok: false,
+            response: errorResponse("unsupported_media_type", "POST requests require Content-Type: application/json.", 415),
+        };
+    }
+    const contentLength = request.headers.get("Content-Length");
+    if (contentLength !== null && Number(contentLength) > MAX_BODY_BYTES) {
+        return {
+            ok: false,
+            response: errorResponse("payload_too_large", `Request body exceeds ${MAX_BODY_BYTES} bytes.`, 413),
+        };
+    }
+    const text = await request.text();
+    if (new TextEncoder().encode(text).length > MAX_BODY_BYTES) {
+        return {
+            ok: false,
+            response: errorResponse("payload_too_large", `Request body exceeds ${MAX_BODY_BYTES} bytes.`, 413),
+        };
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (!isRecord(parsed)) {
+            return {
+                ok: false,
+                response: errorResponse("invalid_request", "Request body must be a JSON object.", 400),
+            };
+        }
+        return { ok: true, body: parsed };
+    }
+    catch {
+        return {
+            ok: false,
+            response: errorResponse("invalid_request", "Request body must be valid JSON.", 400),
+        };
+    }
+}
+function optionsFromBody(body) {
+    if (body.options === undefined)
+        return undefined;
+    return isRecord(body.options) ? body.options : {};
+}
+async function handleEvaluate(request) {
+    if (request.method !== "POST")
+        return methodNotAllowed("POST");
+    const parsed = await readJsonBody(request);
+    if (!parsed.ok)
+        return parsed.response;
+    if (!isRecord(parsed.body.signal)) {
+        return errorResponse("invalid_request", "Request body must include signal.", 400);
+    }
+    const result = evaluateSignal(parsed.body.signal, optionsFromBody(parsed.body));
+    return jsonResponse(result);
+}
+async function handleEvaluateBatch(request) {
+    if (request.method !== "POST")
+        return methodNotAllowed("POST");
+    const parsed = await readJsonBody(request);
+    if (!parsed.ok)
+        return parsed.response;
+    if (!Array.isArray(parsed.body.signals)) {
+        return errorResponse("invalid_request", "Request body must include signals array.", 400);
+    }
+    const result = evaluateSignals(parsed.body.signals, optionsFromBody(parsed.body));
+    return jsonResponse({ evaluations: result });
+}
+function handleHealth(request) {
+    if (request.method !== "GET")
+        return methodNotAllowed("GET");
+    return jsonResponse({
+        ok: true,
+        service: "freshcontext-rest",
+        version: SERVICE_VERSION,
+        core_available: true,
+    });
+}
+export async function handleRestRequest(request) {
+    const url = new URL(request.url);
+    try {
+        if (url.pathname === "/v1/health")
+            return handleHealth(request);
+        if (url.pathname === "/v1/evaluate")
+            return handleEvaluate(request);
+        if (url.pathname === "/v1/evaluate-batch")
+            return handleEvaluateBatch(request);
+        return errorResponse("not_found", `Not found: ${url.pathname}.`, 404);
+    }
+    catch {
+        return errorResponse("internal_error", "Unexpected REST host error.", 500);
+    }
+}

package/dist/security.js

@@ -11,7 +11,7 @@ export const ALLOWED_DOMAINS = {
     repoSearch: [], // uses GitHub API directly, no browser
     packageTrends: [], // uses npm/PyPI APIs directly, no browser
     reddit: [], // uses public Reddit JSON API, no browser
-    finance: [], // uses Yahoo Finance API, no browser
+    finance: [], // uses Stooq quote API, no browser
     productHunt: ["www.producthunt.com", "producthunt.com"],
 };
 // ─── Blocked IP ranges and internal hostnames ────────────────────────────────

package/dist/server.js

@@ -22,7 +22,7 @@ import { stampFreshness, formatForLLM } from "./tools/freshnessStamp.js";
 import { formatSecurityError } from "./security.js";
 const server = new McpServer({
     name: "freshcontext-mcp",
-    version: "0.1.0",
+    version: "0.3.18",
 });
 // ─── Tool: extract_github ────────────────────────────────────────────────────
 server.registerTool("extract_github", {
@@ -62,9 +62,9 @@ server.registerTool("extract_scholar", {
 });
 // ─── Tool: extract_hackernews ────────────────────────────────────────────────
 server.registerTool("extract_hackernews", {
-    description: "Extract top stories or search results from Hacker News. Real-time dev/tech community sentiment with post timestamps.",
+    description: "Extract top stories or search results from Hacker News. Accepts an HN/Algolia URL or a plain search query while preserving the url field for compatibility.",
     inputSchema: z.object({
-        url: z.string().url().describe("HN URL e.g. https://news.ycombinator.com or https://hn.algolia.com/?q=..."),
+        url: z.string().min(1).describe("HN URL e.g. https://news.ycombinator.com/news, Algolia API URL, or search query e.g. 'browser agents'"),
         max_length: z.number().optional().default(4000),
     }),
     annotations: { readOnlyHint: true, openWorldHint: true },
@@ -152,7 +152,7 @@ server.registerTool("extract_arxiv", {
 });
 // ─── Tool: extract_finance ───────────────────────────────────────────────────
 server.registerTool("extract_finance", {
-    description: "Live stock data via Yahoo Finance — price, change, market cap, P/E, 52w range, sector, business summary. Accepts up to 5 comma-separated tickers. Returns timestamped freshcontext.",
+    description: "No-key stock quote data via Stooq — close, open, high, low, volume, quote timestamp, and source. Accepts up to 5 comma-separated tickers. Returns timestamped freshcontext only for successful observations.",
     inputSchema: z.object({
         url: z.string().describe("Ticker symbol(s) e.g. 'AAPL' or 'MSFT,GOOG,PLTR'"),
         max_length: z.number().optional().default(5000),
@@ -355,7 +355,7 @@ server.registerTool("extract_gov_landscape", {
 // community sentiment, repo ecosystem size, and product release velocity.
 // Unique: Bloomberg Terminal doesn't read commit history as a company health signal.
 server.registerTool("extract_finance_landscape", {
-    description: "Composite financial intelligence tool for developers. Given one or more ticker symbols, simultaneously queries: (1) Yahoo Finance for live price/market data, (2) Hacker News for developer community sentiment, (3) Reddit for investor and tech community discussion, (4) GitHub for repo ecosystem activity around the company's tech, and (5) their product changelog for release velocity as a company health signal. Answers: What's the price? What are developers saying? Is the company actually shipping? Returns a unified 5-source timestamped report. Bloomberg Terminal doesn't give you this.",
+    description: "Composite financial intelligence tool for developers. Given one or more ticker symbols, simultaneously queries: (1) Stooq for no-key quote data, (2) Hacker News for developer community sentiment, (3) Reddit for investor and tech community discussion, (4) GitHub for repo ecosystem activity around the company's tech, and (5) their product changelog for release velocity as a company health signal. Answers: What's the price? What are developers saying? Is the company actually shipping? Returns a unified 5-source timestamped report.",
     inputSchema: z.object({
         tickers: z.string().describe("One or more ticker symbols e.g. 'PLTR' or 'PLTR,MSFT,GOOG'. Up to 5 tickers."),
         company_name: z.string().optional().describe("Company name for HN/Reddit/GitHub searches e.g. 'Palantir'. If omitted, derived from the ticker."),
@@ -381,10 +381,10 @@ server.registerTool("extract_finance_landscape", {
     const combined = [
         `# Finance + Developer Intelligence: "${tickers}"${company_name ? ` (${company_name})` : ""}`,
         `Generated: ${new Date().toISOString()}`,
-        `Sources: Yahoo Finance · Hacker News · Reddit · GitHub · Changelog`,
+        `Sources: Stooq · Hacker News · Reddit · GitHub · Changelog`,
         min_freshness_score ? `min_freshness_score: ${min_freshness_score}` : null,
         "",
-        sectionWithFreshnessCheck("📈 Market Data (Yahoo Finance)", priceResult, "finance", min_freshness_score),
+        sectionWithFreshnessCheck("📈 Market Data (Stooq)", priceResult, "finance", min_freshness_score),
         sectionWithFreshnessCheck("💬 Developer Sentiment (Hacker News)", hnResult, "hackernews", min_freshness_score),
         sectionWithFreshnessCheck("🗣️ Community Discussion (Reddit)", redditResult, "reddit", min_freshness_score),
         sectionWithFreshnessCheck("📦 Repo Ecosystem (GitHub)", repoResult, "reposearch", min_freshness_score),
@@ -442,7 +442,7 @@ server.registerTool("extract_gdelt", {
 // global news intelligence + product release velocity + market pricing.
 // Unique: this combination exists nowhere else.
 server.registerTool("extract_company_landscape", {
-    description: "Composite company intelligence tool. The most complete single-call company analysis available. Simultaneously queries 5 unique sources: (1) SEC EDGAR for 8-K material event filings — what the company legally just disclosed, (2) USASpending.gov for federal contract footprint — who is giving them government money, (3) GDELT for global news intelligence — what the world is saying about them right now, (4) their product changelog — are they actually shipping, (5) Yahoo Finance — what the market is pricing in. Returns a unified 5-source timestamped report. Unique: this combination is not available in any other MCP server.",
+    description: "Composite company intelligence tool. The most complete single-call company analysis available. Simultaneously queries 5 unique sources: (1) SEC EDGAR for 8-K material event filings — what the company legally just disclosed, (2) USASpending.gov for federal contract footprint — who is giving them government money, (3) GDELT for global news intelligence — what the world is saying about them right now, (4) their product changelog — are they actually shipping, (5) Stooq quote data — what the market is pricing in. Returns a unified 5-source timestamped report. Unique: this combination is not available in any other MCP server.",
     inputSchema: z.object({
         company: z.string().describe("Company name e.g. 'Palantir', 'Anthropic', 'OpenAI'"),
         ticker: z.string().optional().describe("Stock ticker for finance data e.g. 'PLTR'. Leave blank for private companies."),
@@ -464,14 +464,14 @@ server.registerTool("extract_company_landscape", {
     const combined = [
         `# Company Intelligence Landscape: "${company}"${ticker ? ` (${ticker})` : ""}`,
         `Generated: ${new Date().toISOString()}`,
-        `Sources: SEC EDGAR · USASpending.gov · GDELT · Changelog · Yahoo Finance`,
+        `Sources: SEC EDGAR · USASpending.gov · GDELT · Changelog · Stooq`,
         min_freshness_score ? `min_freshness_score: ${min_freshness_score}` : null,
         "",
         sectionWithFreshnessCheck("📋 SEC 8-K Filings — Legal Disclosures", secResult, "sec_filings", min_freshness_score),
         sectionWithFreshnessCheck("🏛️ Federal Contract Awards (USASpending.gov)", contractsResult, "govcontracts", min_freshness_score),
         sectionWithFreshnessCheck("🌍 Global News Intelligence (GDELT)", gdeltResult, "gdelt", min_freshness_score),
         sectionWithFreshnessCheck("🔄 Product Release Velocity (Changelog)", changelogResult, "changelog", min_freshness_score),
-        sectionWithFreshnessCheck("📈 Market Data (Yahoo Finance)", financeResult, "finance", min_freshness_score),
+        sectionWithFreshnessCheck("📈 Market Data (Stooq)", financeResult, "finance", min_freshness_score),
     ].filter(Boolean).join("\n\n");
     return { content: [{ type: "text", text: combined }] };
 });

package/dist/tools/freshnessStamp.js

@@ -1,117 +1 @@
-// ─── Decay rates per adapter ──────────────────────────────────────────────────
-// Spec-compliant exponential DAR model.
-// Higher lambda = data goes stale faster. Half-life formula: t½ = ln(2) / λ.
-// Lambda is measured per hour and mirrors the Worker/D1 intelligence engine.
-export const LAMBDA = {
-    hackernews: 0.050,
-    reddit: 0.010,
-    producthunt: 0.010,
-    jobs: 0.005,
-    finance: 0.001,
-    yc: 0.001,
-    packagetrends: 0.0005,
-    github: 0.0002,
-    reposearch: 0.0002,
-    google_scholar: 0.00005,
-    arxiv: 0.00005,
-    changelog: 0.0005,
-    gdelt: 0.020,
-    gebiz: 0.003,
-    govcontracts: 0.001,
-    sec_filings: 0.005,
-    landscape: 0.050,
-    gov_landscape: 0.001,
-    finance_landscape: 0.001,
-    company_landscape: 0.005,
-    idea_landscape: 0.050,
-    default: 0.001,
-};
-// ─── Score calculation ────────────────────────────────────────────────────────
-// Returns null when content_date is unknown — we can't calculate age without a date.
-// Returns a clamped 0-100 exponential freshness score.
-function calculateFreshnessScore(content_date, retrieved_at, adapter) {
-    if (!content_date)
-        return null;
-    const published = new Date(content_date).getTime();
-    const retrieved = new Date(retrieved_at).getTime();
-    // Guard against unparseable dates
-    if (isNaN(published) || isNaN(retrieved))
-        return null;
-    const hoursSinceRetrieved = Math.max(0, (retrieved - published) / (1000 * 60 * 60));
-    const lambda = LAMBDA[adapter] ?? LAMBDA.default;
-    return Math.max(0, Math.round(100 * Math.exp(-lambda * hoursSinceRetrieved)));
-}
-// ─── Score label ──────────────────────────────────────────────────────────────
-// Human-readable interpretation alongside the number, per the spec.
-function scoreLabel(score) {
-    if (score === null)
-        return "unknown";
-    if (score >= 90)
-        return "current";
-    if (score >= 70)
-        return "reliable";
-    if (score >= 50)
-        return "verify before acting";
-    return "use with caution";
-}
-// ─── Main stamp function ──────────────────────────────────────────────────────
-export function stampFreshness(result, options, adapter) {
-    const retrieved_at = new Date().toISOString();
-    const freshness_score = calculateFreshnessScore(result.content_date, retrieved_at, adapter);
-    return {
-        content: result.raw.slice(0, options.maxLength ?? 8000),
-        source_url: options.url,
-        content_date: result.content_date,
-        retrieved_at,
-        freshness_confidence: result.freshness_confidence,
-        freshness_score,
-        adapter,
-    };
-}
-// ─── Structured JSON form ─────────────────────────────────────────────────────
-// Returns the spec-compliant JSON object defined in FRESHCONTEXT_SPEC.md.
-// Programmatic consumers can parse this without touching the text envelope.
-export function toStructuredJSON(ctx) {
-    return {
-        freshcontext: {
-            source_url: ctx.source_url,
-            content_date: ctx.content_date,
-            retrieved_at: ctx.retrieved_at,
-            freshness_confidence: ctx.freshness_confidence,
-            freshness_score: ctx.freshness_score,
-            adapter: ctx.adapter,
-        },
-        content: ctx.content,
-    };
-}
-// ─── Text envelope formatter ──────────────────────────────────────────────────
-// Produces the [FRESHCONTEXT]...[/FRESHCONTEXT] envelope defined in the spec,
-// followed by a [FRESHCONTEXT_JSON]...[/FRESHCONTEXT_JSON] block so both the
-// human-readable envelope and the machine-parseable JSON travel together.
-export function formatForLLM(ctx) {
-    const dateInfo = ctx.content_date
-        ? `Published: ${ctx.content_date}`
-        : "Publish date: unknown";
-    const scoreLine = ctx.freshness_score !== null
-        ? `Score: ${ctx.freshness_score}/100 (${scoreLabel(ctx.freshness_score)})`
-        : `Score: unknown`;
-    const textEnvelope = [
-        `[FRESHCONTEXT]`,
-        `Source: ${ctx.source_url}`,
-        `${dateInfo}`,
-        `Retrieved: ${ctx.retrieved_at}`,
-        `Confidence: ${ctx.freshness_confidence}`,
-        `${scoreLine}`,
-        `---`,
-        ctx.content,
-        `[/FRESHCONTEXT]`,
-    ].join("\n");
-    // Append the structured JSON block so programmatic consumers
-    // can extract metadata without parsing the text envelope.
-    const jsonBlock = [
-        `[FRESHCONTEXT_JSON]`,
-        JSON.stringify(toStructuredJSON(ctx), null, 2),
-        `[/FRESHCONTEXT_JSON]`,
-    ].join("\n");
-    return `${textEnvelope}\n\n${jsonBlock}`;
-}
+export { LAMBDA, stampFreshness, toStructuredJSON, formatForLLM, } from "../core/index.js";

package/dist/types.js

@@ -1,2 +1 @@
-// Core data types for freshcontext-mcp
 export {};