freshcontext-mcp 0.3.13 → 0.3.15

package/SESSION_SAVE_V5.md

@@ -0,0 +1,121 @@
+# FreshContext — Session Save V5
+**Date:** 2026-03-27
+**npm:** freshcontext-mcp@0.3.13
+**Tools:** 19 live
+
+---
+
+## What Was Done This Session
+
+- npm tokens renewed: freshcontext-publish + NPM_TOKEN (both renewed, NPM_TOKEN updated in GitHub secrets)
+- GitHub granular token renewed
+- v0.3.13 pushed — extract_gebiz added (Singapore GeBIZ procurement via data.gov.sg)
+- README fully rewritten — 19 tools, company landscape section with PLTR demo, all unique adapters documented
+- GovTech Singapore follow-up sent (delivered on commitment: GeBIZ tool built and live)
+- Palantir follow-up sent (references PLTR company landscape report, $1.1B contracts, Rule of 40 127%)
+- 10 follow-up drafts created in Gmail (PatSnap, Mistral, HF, Klarna, SAP, Moonshot, MiniMax, Apify, Cloudflare, Sea)
+- PLTR company landscape report confirmed working — full intelligence output documented
+- Apify rebuild needed for v0.3.13 (manual trigger required)
+
+---
+
+## Current Tool Count: 19
+
+**Standard (11):** extract_github, extract_hackernews, extract_scholar, extract_arxiv,
+extract_reddit, extract_yc, extract_producthunt, search_repos, package_trends,
+extract_finance, search_jobs
+
+**Composite landscapes (4):**
+- extract_landscape — YC + GitHub + HN + Reddit + Product Hunt + npm
+- extract_gov_landscape — govcontracts + HN + GitHub + changelog
+- extract_finance_landscape — finance + HN + Reddit + GitHub + changelog
+- extract_company_landscape — SEC + govcontracts + GDELT + changelog + finance
+
+**Unique — not in any other MCP server (4 + GeBIZ):**
+- extract_changelog — release history from any repo/package/site
+- extract_govcontracts — US federal contract awards (USASpending.gov)
+- extract_sec_filings — 8-K material event disclosures (SEC EDGAR)
+- extract_gdelt — global news events (GDELT Project, 100+ languages)
+- extract_gebiz — Singapore Government procurement (data.gov.sg) ← NEW
+
+---
+
+## Outreach Status
+
+**Active threads:**
+- GovTech Singapore — delivered GeBIZ tool, awaiting response
+- Palantir — follow-up sent with PLTR company landscape report
+
+**Follow-up drafts sitting in Gmail (10):**
+- PatSnap — contact@patsnap.com
+- Mistral AI — contact@mistral.ai
+- Hugging Face — api-enterprise@huggingface.co
+- Klarna — partnerships@klarna.com
+- SAP Startups — startups@sap.com
+- Moonshot AI — support@moonshot.cn
+- MiniMax — contact@minimax.io
+- Apify / Jan — jan@apify.com
+- Cloudflare Startups — startups@cloudflare.com
+- Sea / Shopee — ir@sea.com
+
+**Bounced — need correct addresses (9):**
+- Revolut — bd@revolut.com + press@revolut.com both dead
+- Zalando — partnerships@zalando.de + tech@zalando.de both dead
+- Celonis — partnerships@celonis.com dead
+- Grab — partnerships@grab.com + developer@grab.com both dead
+- Sea Limited — partnerships@sea.com dead (ir@sea.com delivered but wrong team)
+- Zhipu AI — bd@zhipuai.cn + contact@zhipuai.cn both dead
+- MiniMax — bd@minimaxi.com dead (contact@minimax.io delivered)
+- Moonshot AI — business@moonshot.cn dead (support@moonshot.cn delivered)
+- Apollo — hello@apollo.io dead
+
+**New targets identified (not yet contacted):**
+- IMDA Singapore (Infocomm Media Development Authority)
+- Australian Digital Transformation Agency
+- UK Government Digital Service (GDS)
+- LangChain / LangSmith
+- LlamaIndex
+- CrewAI
+- Vercel AI SDK
+- FactSet
+- Morningstar
+
+**Correct addresses to find for bounced:**
+- Revolut → try partnerships@revolut.com
+- Grab → try business@grab.com
+- Celonis → try hello@celonis.com
+- Apollo.io → try partnerships@apollo.io
+- Zhipu AI → LinkedIn outreach (email dead)
+
+---
+
+## Pending Items
+
+- Send 10 follow-up drafts from Gmail Drafts folder
+- Trigger Apify rebuild for v0.3.13
+- Find correct addresses for 9 bounced companies
+- Contact new targets: IMDA, GDS, LangChain, LlamaIndex, CrewAI, FactSet
+- GKG upgrade for extract_gdelt (tone scores, goldstein scale) — deferred
+- Agnost AI analytics integration — sign up at app.agnost.ai, one line in server.ts
+- Synthesis endpoint (/briefing/now) — needs ANTHROPIC_KEY + $5 credits
+
+---
+
+## Demo Assets
+1. intelligence-report.html — Anthropic/OpenAI/Palantir government intelligence report
+2. PLTR company landscape — Q4 2025 earnings, $1.1B contracts, Rule of 40 127%
+
+Both are best-in-class product demos. Use these in outreach.
+
+---
+
+## Resume Prompt
+"I'm building freshcontext-mcp — 19 tools live at v0.3.13. Last session: built extract_gebiz
+(Singapore GeBIZ), sent GovTech and Palantir follow-ups, drafted 10 follow-up emails.
+Next: send the 10 drafts, fix bounced email addresses, contact new targets.
+See SESSION_SAVE_V5.md."
+
+---
+
+*"The work isn't gone. It's just waiting to be continued."*
+*— Prince Gabriel, Grootfontein, Namibia 🇳🇦*

package/SESSION_SAVE_V6.md

@@ -0,0 +1,194 @@
+# FreshContext — Session Save V6
+**Date:** 2026-04-07
+**Version:** 0.3.14 (npm) / 0.21 (Apify)
+**Tools:** 20 live
+**Spec:** v1.1
+**Author:** Immanuel Gabriel (Prince Gabriel), Grootfontein, Namibia 🇳🇦
+
+---
+
+## RESUME PROMPT FOR NEXT CHAT
+
+Paste this at the start of a new conversation:
+
+"I'm Immanuel Gabriel from Grootfontein, Namibia. I'm building FreshContext
+— a web intelligence MCP server and open data freshness standard.
+20 tools, v0.3.14, live at https://freshcontext-mcp.gimmanuel73.workers.dev/mcp
+
+Read SESSION_SAVE_V6.md in
+C:\Users\Immanuel Gabriel\Downloads\freshcontext-mcp\
+to get full context. Then continue exactly where we left off."
+
+---
+
+## WHAT WAS DONE THIS SESSION
+
+### FreshContext
+- README updated to 20 tools, extract_idea_landscape added, standard framing sharpened
+- FRESHCONTEXT_SPEC.md updated to v1.1:
+  - Reference implementation updated 11 → 20 adapters
+  - Domain-specific decay rate table added (financial 5.0 → academic 0.3)
+  - Composite Adapters section added
+  - Compatibility Levels table added (compatible / aware / scored)
+  - Changelog section added
+  - Apify Store + MCP Registry added to reference listings
+- Apify build fixed — was failing due to GitHub clone block
+  - Switched to `apify push` from local machine (bypasses GitHub)
+  - Version format fixed: 0.3.14 → 0.21 (Apify only accepts MAJOR.MINOR)
+  - Build 0.21.2 successful and tested — clean FreshContext envelope output confirmed
+- All changes pushed to GitHub (commits: 22ae867, 3186561)
+- npm downloads: 191 organic in first week (zero marketing)
+- HN post: SUBMITTED ✅
+- OpenAI partner intake form: SUBMITTED ✅
+- Calm partnerships form: SUBMITTED ✅
+
+### Outreach — Emails Sent This Session
+**AGI leasing pitch (all sent):**
+- OpenAI — partnerships@openai.com (auto-reply → partner form submitted)
+- Anthropic — partnerships@anthropic.com
+- Google (DeepMind) — partnerships@google.com (deepmind.com bounced)
+- xAI — partnerships@x.ai
+- Cohere — partnerships@cohere.com
+- Meta AI — ai-partnerships@meta.com
+- Perplexity — partnerships@perplexity.ai
+- Mistral — partnerships@mistral.ai (upgrade from old email)
+- Hugging Face — partnerships@huggingface.co (upgrade)
+- DeepSeek — partnerships@deepseek.com
+
+**Bounced/dead (do not retry by email):**
+- Adept — acquired by Amazon, defunct
+- DeepMind direct — partnerships@deepmind.com dead, use partnerships@google.com
+
+**Corrected and sent:**
+- LlamaIndex — hello@llamaindex.ai (contact@ bounced)
+- CrewAI — joao@crewai.com founder direct (contact@ bounced)
+- Zalando — opensource@zalando.de (tech@ bounced)
+- Celonis — press@celonis.com (hello@ bounced)
+
+### Catatonica Outreach — All Sent
+**Wellness / wearables:**
+- Calm — partnerships@calm.com (+ Calm Partnerships Monday.com form submitted)
+- Headspace — partnerships@headspace.com
+- Whoop — partnerships@whoop.com
+- Oura — partnerships@ouraring.com
+- WellHub — partnerships@wellhub.com
+- Eight Sleep — partnerships@eightsleep.com
+
+**Japan:**
+- Recruit Holdings — partnerships@recruit.co.jp
+- LY Corporation (LINE) — partnerships@lycorp.co.jp
+- Mercari — bd@mercari.com
+- DeNA — biz-dev@dena.com
+- KDDI — partnerships@kddi.com
+- Meiji Yasuda Life — wellness@meijiyasuda.co.jp
+
+---
+
+## CURRENT STATUS
+
+### Pending / Next Actions
+| Task | Status |
+|---|---|
+| HN post | ✅ Submitted |
+| OpenAI partner intake | ✅ Submitted |
+| Calm partnerships form | ✅ Submitted |
+| LinkedIn post | ⏳ Post this week — drafts ready (see below) |
+| LinkedIn group posts (AGI groups) | ⏳ After LinkedIn profile post |
+| Apify store description update | ⏳ Still shows old tool count — update to 20 |
+| Follow-up emails (no reply >1 week) | ⏳ Due ~April 14 |
+
+### LinkedIn Posts — Ready to Publish
+
+**POST 1 (origin story — most shareable):**
+> I asked Claude to help me find a job.
+> It gave me listings. I applied to three of them.
+> Two didn't exist anymore. One had been closed for two years.
+> Claude had no idea. It presented everything with the same confidence as results from this morning.
+> That's not a Claude problem. That's a structural problem — AI agents have no standard way to know how old their data is.
+> So I built one.
+> FreshContext is a data freshness layer for AI agents — an open standard that wraps every piece of retrieved web data in a structured envelope: when it was retrieved, where it came from, how confident we are the date is accurate.
+> 20 tools. No API keys. Live on Cloudflare's global edge.
+> Built alone. From Grootfontein, Namibia.
+> 191 organic downloads in the first week with zero marketing.
+> The spec is MIT. If you're building agents that retrieve external data, this is the layer that makes that data trustworthy.
+> → github.com/PrinceGabriel-lgtm/freshcontext-mcp
+
+**POST 2 (standard framing — AGI/technical audience):**
+> There is no standard for how fresh AI-retrieved data is.
+> Every agent pipeline in production is solving this privately — adding their own timestamps, their own confidence signals, their own staleness logic — and none of it is interoperable.
+> The problem isn't retrieval. Retrieval is solved. The problem is trust.
+> FreshContext is the attempt to name that problem and fix it before the fragmentation sets in.
+> Open standard. MIT licensed. 20 adapters. SEC filings, US federal contracts, global news in 100+ languages, Singapore government procurement, and more.
+> The window to be early is still open.
+> Built by Prince Gabriel — Grootfontein, Namibia 🇳🇦
+> → github.com/PrinceGabriel-lgtm/freshcontext-mcp/blob/main/FRESHCONTEXT_SPEC.md
+
+**LinkedIn GROUP post (discussion opener for AI/AGI groups):**
+> Title: Should there be a standard for data freshness in AI agent pipelines?
+> Every agent that retrieves external data faces the same invisible problem: it can't tell how old the data is.
+> A result from this morning and one from two years ago look identical to the model without explicit metadata. For agents making real decisions — job recommendations, market analysis, competitive intelligence — this is a silent reliability gap.
+> I've been working on a proposed standard called the FreshContext Specification. The idea: wrap every retrieved result in a structured envelope with a retrieval timestamp, publication date estimate, and confidence level.
+> Curious whether others building agent systems have hit this problem — and whether a shared standard makes sense or whether everyone's better off solving it internally.
+> Spec is MIT: github.com/PrinceGabriel-lgtm/freshcontext-mcp/blob/main/FRESHCONTEXT_SPEC.md
+
+**LinkedIn groups to post in:**
+- "Artificial Intelligence" (largest)
+- "AI Professionals"
+- "Machine Learning & Data Science"
+- "Future of AI"
+- "Model Context Protocol" (search for this — MCP-specific group if it exists)
+
+---
+
+## INFRASTRUCTURE STATE
+
+| Layer | Status |
+|---|---|
+| npm | freshcontext-mcp@0.3.14 — auto-publishes via GitHub Actions |
+| Cloudflare Worker | Live — global edge, KV cache, rate limiting, relevancy scoring |
+| D1 Database | 18 watched queries, 6h cron, hash-based dedup |
+| Apify Actor | v0.21 live, build 0.21.2 tested and confirmed working |
+| MCP Registry | Listed — io.github.PrinceGabriel-lgtm/freshcontext |
+| GitHub Actions | Live — push to main = auto build + publish |
+| Spec | v1.1 — composite adapters, decay rates, compatibility levels |
+
+---
+
+## DEAL BIBLE — VALUATIONS
+
+### FreshContext
+- White-label: Ask $8K/mo, accept $2–3K/mo, walk below $1,500/mo
+- Acquisition: Ask $500K, accept $80–150K, walk below $50K
+- Good deal signals: want you involved post-deal, commit to spec maintenance, 12-mo minimum
+- Bad deal signals: want code not spec, month-to-month, under $50K full ownership
+
+### Catatonica
+- White-label: Ask $5K/mo, accept $1.5–2.5K/mo, walk below $800/mo
+- Acquisition: Ask $250K, accept $30–75K, walk below $20K
+- Good deal signals: reference Cataton mechanic specifically, understand Japan angle
+- Bad deal signals: "just another mindfulness app", want codebase not philosophy
+
+---
+
+## KEY ASSETS
+
+- Deal Bible artifact: prince-gabriel-deal-bible.html (in /mnt/user-data/outputs/)
+- Intelligence report: AI Government Intelligence Report — March 2026.html (Downloads)
+- HANDOFF.md — complete transfer guide for acquisition/partnership
+- FRESHCONTEXT_SPEC.md v1.1 — the open standard
+- ROADMAP.md — 10-layer product vision
+
+---
+
+## CATATONICA
+
+Live at: https://catatonica.pages.dev
+Stack: Vanilla JS, Cloudflare Pages, Supabase (magic link auth), Stripe
+Pricing: Free / $9/mo Deep / $29/mo The Order
+Philosophy: The Art of Doing Nothing — structured stillness practice for high-intensity minds
+Mechanics: Situations → Sessions → Catatons → Planned Obsolescence → Chronicle
+
+---
+
+*"The work isn't gone. It's just waiting to be continued."*
+*— Prince Gabriel, Grootfontein, Namibia*

package/SESSION_SAVE_V9.md

@@ -0,0 +1,170 @@
+# FreshContext — Session Save V9 (Updated)
+**Date:** 2026-04-29
+**Version:** 0.3.15
+**Status:** DAR engine LIVE. Bot filter shipped. Workers Paid — $5/mo. Cron running.
+
+---
+
+## SESSION TIMELINE
+
+### Earlier in this session
+1. DAR engine shipped (`intelligence.ts`) — exponential decay scoring with proprietary λ constants
+2. `worker.ts` rewritten — DAR wired into cron, intel feed endpoint live
+3. ToolResult type fix + ScheduledController + ok() helper
+4. Semantic deduplication shipped
+5. METHODOLOGY.md written — formal IP documentation
+6. CONTEXT_SKILL.md created — token-efficient session resumption
+
+### This continuation
+7. **Diagnosed the 59k errors** — they're bot-noise + unhandled paths falling through to MCP transport
+8. **Fixed the bot-error noise** — added `GET /` landing page, `GET /health`, and clean 404s for unknown paths
+9. **Enhanced `/debug/db`** — now shows DAR engine coverage stats (signals_scored, unique_fingerprints, scoring_coverage %)
+10. **README.md updated** — added "Intelligence Layer (v0.3.15)" section with DAR math, provenance schema, endpoint table; updated roadmap
+11. **HANDOFF.md updated** — bumped to v0.3.15, added Intelligence Layer section, updated Pending Items
+12. **LAUNCH_POSTS_V9.md drafted** — Show HN, LinkedIn (long + short), Twitter thread, posting strategy
+
+### Two weeks later (2026-04-29)
+13. **309k requests / 309k errors over 24h** observed on Cloudflare dashboard — bot saturation on the `.workers.dev` URL
+14. **Daily request limit (100k) hit** — Workers Paid plan activated for $5/month
+15. **Bot filter shipped to worker.ts** — BLOCKED_PATH_PATTERNS + BLOCKED_USER_AGENTS + isBotProbe() runs FIRST in fetch handler
+    - Returns 410 Gone for known scanner paths (wp-, .env, .git, .php, owa, ecp, _ignition, etc.)
+    - Returns 410 Gone for known scanner user-agents (masscan, nmap, sqlmap, nikto, etc.)
+    - Zero KV/DB calls before reject — cheapest possible CPU footprint
+    - Expected outcome: error rate drops dramatically + paid CPU costs minimised
+
+---
+
+## THE 59K ERRORS EXPLAINED
+
+The Cloudflare dashboard showed ~100% error rate across 24 hours. Diagnosis:
+
+The fetch handler routes explicit paths (/mcp, /briefing, /v1/intel/feed/*, /debug/*, etc.) and falls through everything else to the MCP transport. Bots, crawlers, OPTIONS preflights, and any non-MCP traffic hitting the Worker triggered MCP SDK to throw 500s.
+
+**Real MCP traffic worked fine** — the wrangler tail log confirmed POST /mcp returning Ok consistently. The errors are noise floor of a discoverable public Workers.dev URL.
+
+**Fix shipped in this session:**
+- `GET /` returns service info JSON instead of falling through
+- `GET /health` returns liveness check
+- Any path that isn't `/mcp` or `/mcp/` returns clean 404 before reaching transport
+- Expected outcome: error rate drops from ~100% to <5% within 24 hours of redeploy
+
+---
+
+## DEPLOY COMMANDS (run these now)
+
+```powershell
+cd "C:\Users\Immanuel Gabriel\Downloads\freshcontext-mcp\worker"
+npx wrangler deploy
+```
+
+```powershell
+cd "C:\Users\Immanuel Gabriel\Downloads\freshcontext-mcp"
+git add worker/src/worker.ts README.md HANDOFF.md LAUNCH_POSTS_V9.md SESSION_SAVE_V9.md
+git commit -m "v0.3.15: bot-error fix + landing page + /health; README/HANDOFF: Intelligence Layer; launch posts drafted"
+git push origin main
+```
+
+---
+
+## VERIFICATION COMMANDS
+
+After deploy:
+
+```powershell
+# Test the new landing page
+curl.exe https://freshcontext-mcp.gimmanuel73.workers.dev/
+
+# Liveness
+curl.exe https://freshcontext-mcp.gimmanuel73.workers.dev/health
+
+# DAR engine coverage stats
+curl.exe https://freshcontext-mcp.gimmanuel73.workers.dev/debug/db
+
+# Intel feed
+curl.exe "https://freshcontext-mcp.gimmanuel73.workers.dev/v1/intel/feed/default?limit=5"
+
+# 404 for bots
+curl.exe -v https://freshcontext-mcp.gimmanuel73.workers.dev/wp-admin
+```
+
+D1 inspection:
+
+```powershell
+cd worker
+
+# Total signal count
+npx wrangler d1 execute freshcontext-db --remote --command "SELECT COUNT(*) FROM scrape_results"
+
+# DAR coverage by adapter
+npx wrangler d1 execute freshcontext-db --remote --command "SELECT adapter, COUNT(*) as total, AVG(rt_score) as avg_rt, AVG(base_score) as avg_r0 FROM scrape_results WHERE rt_score IS NOT NULL GROUP BY adapter"
+
+# Top 10 highest R_t signals right now
+npx wrangler d1 execute freshcontext-db --remote --command "SELECT adapter, query, rt_score, entropy_level, published_at FROM scrape_results WHERE rt_score IS NOT NULL ORDER BY rt_score DESC LIMIT 10"
+
+# Dedup effectiveness
+npx wrangler d1 execute freshcontext-db --remote --command "SELECT COUNT(*) as total_signals, COUNT(DISTINCT semantic_fingerprint) as unique_stories FROM scrape_results WHERE semantic_fingerprint IS NOT NULL"
+
+# Backup the entire D1 database
+npx wrangler d1 export freshcontext-db --remote --output=backup-2026-04-14.sql
+
+# Live tail
+npx wrangler tail
+```
+
+---
+
+## CURRENT INFRASTRUCTURE STATE
+
+| Layer | Status |
+|---|---|
+| npm @0.3.15 | LIVE |
+| Cloudflare Worker | LIVE — DAR + new endpoints deployed in this session |
+| D1 freshcontext-db | LIVE — accumulating with new schema columns |
+| KV RATE_LIMITER + CACHE | LIVE |
+| Cron 0 */6 * * * | RUNNING — every 6 hours |
+| Spec site freshcontext-site.pages.dev | LIVE |
+| GitHub Actions auto-publish | LIVE |
+| ANTHROPIC_KEY | NOT SET — formatBriefing() fallback active |
+| Apify Actor | NEEDS REBUILD (apify push) |
+
+---
+
+## NEW FILE STATE
+
+```
+worker/src/intelligence.ts    [DAR engine — written V9 part 1]
+worker/src/worker.ts          [REWRITTEN + bot-error fix this turn]
+worker/src/synthesize.ts      [unchanged]
+METHODOLOGY.md                [V9 part 1 — IP documentation]
+README.md                     [UPDATED this turn — Intelligence Layer section]
+HANDOFF.md                    [UPDATED this turn — v0.3.15]
+LAUNCH_POSTS_V9.md            [NEW this turn — HN + LinkedIn + Twitter drafts]
+SESSION_SAVE_V9.md            [UPDATED this turn]
+CONTEXT_SKILL.md              [V9 part 1 — token-efficient resumption]
+```
+
+---
+
+## NEXT BUILD PRIORITIES
+
+1. **Run the deploy + verify commands above** (ensure 404 fix is live, error rate drops)
+2. **Wait 24h then check Cloudflare dashboard** — error count should be way down
+3. **Post Show HN** — Tuesday/Wednesday 09:00-10:30 ET. Use draft in LAUNCH_POSTS_V9.md
+4. **Post LinkedIn** — 24h after HN
+5. **Post Twitter thread** — same day as LinkedIn
+6. **Webhook trigger system** — push high-R_t low-entropy signals to user webhooks
+7. **Mining/industrial domain queries** — the moat
+8. **Profile creation API** — populate user_profiles table
+9. **Apify rebuild** — `apify push` from local
+10. **tsconfig skipLibCheck** — silence the 130 cosmetic node_modules conflicts
+
+---
+
+## RESUME PROMPT FOR NEXT SESSION
+
+"Load FreshContext context. Read CONTEXT_SKILL.md and SESSION_SAVE_V9.md from C:\Users\Immanuel Gabriel\Downloads\freshcontext-mcp\, generate the context map, then ask me what we're working on today."
+
+---
+
+*"The work isn't gone. It's just waiting to be continued."*
+*— Prince Gabriel, Grootfontein, Namibia*

package/dist/apify.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * Apify Actor entry point — FreshContext MCP v0.3.13
+ *
+ * Reads Actor input, calls the appropriate adapter, pushes to dataset, exits.
+ * All 19 tools supported. Robust error handling throughout.
+ */
+import { Actor } from "apify";
+import { githubAdapter } from "./adapters/github.js";
+import { hackerNewsAdapter } from "./adapters/hackernews.js";
+import { scholarAdapter } from "./adapters/scholar.js";
+import { arxivAdapter } from "./adapters/arxiv.js";
+import { redditAdapter } from "./adapters/reddit.js";
+import { ycAdapter } from "./adapters/yc.js";
+import { productHuntAdapter } from "./adapters/productHunt.js";
+import { repoSearchAdapter } from "./adapters/repoSearch.js";
+import { packageTrendsAdapter } from "./adapters/packageTrends.js";
+import { financeAdapter } from "./adapters/finance.js";
+import { jobsAdapter } from "./adapters/jobs.js";
+import { changelogAdapter } from "./adapters/changelog.js";
+import { govContractsAdapter } from "./adapters/govcontracts.js";
+import { secFilingsAdapter } from "./adapters/secFilings.js";
+import { gdeltAdapter } from "./adapters/gdelt.js";
+import { gebizAdapter } from "./adapters/gebiz.js";
+import { stampFreshness } from "./tools/freshnessStamp.js";
+async function main() {
+    await Actor.init();
+    let input;
+    try {
+        const raw = await Actor.getInput();
+        if (!raw || !raw.tool) {
+            await Actor.fail("Missing input. Provide a 'tool' field. E.g. { \"tool\": \"extract_hackernews\", \"url\": \"https://news.ycombinator.com\" }");
+            return;
+        }
+        input = raw;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        await Actor.fail(`Failed to read input: ${msg}`);
+        return;
+    }
+    // Resolve the primary string input — different tools use different field names
+    const url = input.url ?? input.query ?? input.topic ?? input.company ?? input.tickers ?? "";
+    const maxLength = input.max_length ?? 8000;
+    console.log(`FreshContext Actor | tool: ${input.tool} | input: "${url}"`);
+    try {
+        let result;
+        switch (input.tool) {
+            // ── Standard tools ────────────────────────────────────────────
+            case "extract_github":
+                result = await githubAdapter({ url, maxLength });
+                break;
+            case "extract_hackernews":
+                result = await hackerNewsAdapter({ url, maxLength });
+                break;
+            case "extract_scholar":
+                result = await scholarAdapter({ url, maxLength });
+                break;
+            case "extract_arxiv":
+                result = await arxivAdapter({ url, maxLength });
+                break;
+            case "extract_reddit":
+                result = await redditAdapter({ url, maxLength });
+                break;
+            case "extract_yc":
+                result = await ycAdapter({ url, maxLength });
+                break;
+            case "extract_producthunt":
+                result = await productHuntAdapter({ url, maxLength });
+                break;
+            case "search_repos":
+                result = await repoSearchAdapter({ url, maxLength });
+                break;
+            case "package_trends":
+                result = await packageTrendsAdapter({ url, maxLength });
+                break;
+            case "extract_finance":
+                result = await financeAdapter({ url, maxLength });
+                break;
+            case "search_jobs":
+                result = await jobsAdapter({ url, maxLength });
+                break;
+            case "extract_changelog":
+                result = await changelogAdapter({ url, maxLength });
+                break;
+            // ── Unique tools ──────────────────────────────────────────────
+            case "extract_govcontracts":
+                result = await govContractsAdapter({ url, maxLength });
+                break;
+            case "extract_sec_filings":
+                result = await secFilingsAdapter({ url, maxLength });
+                break;
+            case "extract_gdelt":
+                result = await gdeltAdapter({ url, maxLength });
+                break;
+            case "extract_gebiz":
+                result = await gebizAdapter({ url, maxLength });
+                break;
+            default:
+                await Actor.fail(`Unknown tool: "${input.tool}". Valid tools: ` +
+                    "extract_github, extract_hackernews, extract_scholar, extract_arxiv, " +
+                    "extract_reddit, extract_yc, extract_producthunt, search_repos, " +
+                    "package_trends, extract_finance, search_jobs, extract_changelog, " +
+                    "extract_govcontracts, extract_sec_filings, extract_gdelt, extract_gebiz");
+                return;
+        }
+        const ctx = stampFreshness(result, { url, maxLength }, input.tool);
+        await Actor.pushData({
+            tool: ctx.adapter,
+            source_url: ctx.source_url,
+            content: ctx.content,
+            retrieved_at: ctx.retrieved_at,
+            content_date: ctx.content_date ?? null,
+            freshness_confidence: ctx.freshness_confidence,
+        });
+        console.log(`✓ Done | retrieved: ${ctx.retrieved_at} | confidence: ${ctx.freshness_confidence}`);
+        await Actor.exit();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`FreshContext error: ${message}`);
+        await Actor.fail(message);
+    }
+}
+main().catch(async (err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Fatal error: ${message}`);
+    try {
+        await Actor.fail(message);
+    }
+    catch { /* ignore */ }
+    process.exit(1);
+});