@4ort/cli 0.4.0 → 0.5.0

package/dist/kg-output.js

@@ -0,0 +1,132 @@
+/**
+ * Output helpers for KG commands.
+ *
+ * Default: human-readable, simple text-aligned tables, no color deps.
+ * --json flag (handled per-command): straight JSON.stringify with indent.
+ * Markdown rendering: TTY → ANSI escape codes, pipe → raw, --plain → stripped.
+ */
+// ─────────────────────────────────────────────────────────────────────
+// Markdown rendering
+// ─────────────────────────────────────────────────────────────────────
+const ANSI = {
+    bold: "\x1b[1m",
+    italic: "\x1b[3m",
+    cyan: "\x1b[36m",
+    dim: "\x1b[2m",
+    reset: "\x1b[0m",
+};
+/** Pick render mode from CLI flags + TTY detection. */
+export function pickRenderMode(plain) {
+    if (plain)
+        return "plain";
+    if (process.stdout.isTTY)
+        return "ansi";
+    return "raw";
+}
+/**
+ * Apply markdown → ANSI (or strip in plain mode). Handles **bold**, *italic*,
+ * _italic_, and `code` inline. Does not touch citation refs like [11].
+ *
+ * Order matters: `**bold**` is replaced first so the leftover `*italic*`
+ * regex doesn't double-match.
+ */
+export function renderMarkdown(text, mode) {
+    if (mode === "raw")
+        return text;
+    if (mode === "plain") {
+        return text
+            .replace(/\*\*(.+?)\*\*/g, "$1")
+            .replace(/\*(.+?)\*/g, "$1")
+            .replace(/_(.+?)_/g, "$1")
+            .replace(/`(.+?)`/g, "$1");
+    }
+    return text
+        .replace(/\*\*(.+?)\*\*/g, `${ANSI.bold}$1${ANSI.reset}`)
+        .replace(/\*(.+?)\*/g, `${ANSI.italic}$1${ANSI.reset}`)
+        .replace(/_(.+?)_/g, `${ANSI.italic}$1${ANSI.reset}`)
+        .replace(/`(.+?)`/g, `${ANSI.cyan}$1${ANSI.reset}`);
+}
+/** Wrap a heading line in ANSI bold for TTY output. */
+export function styleHeading(text, mode) {
+    if (mode === "ansi")
+        return `${ANSI.bold}${text}${ANSI.reset}`;
+    return text;
+}
+export function printJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+}
+/**
+ * Render a list of objects as a column-aligned text table.
+ * `columns` is an ordered list of [header, accessor] pairs.
+ */
+export function printTable(rows, columns) {
+    if (rows.length === 0) {
+        console.log("(no results)");
+        return;
+    }
+    const headers = columns.map(([h]) => h);
+    const data = rows.map((row) => columns.map(([, fn]) => {
+        const v = fn(row);
+        return v === undefined || v === null ? "" : String(v);
+    }));
+    const widths = headers.map((h, i) => Math.max(h.length, ...data.map((r) => r[i].length)));
+    const formatRow = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ");
+    console.log(formatRow(headers));
+    console.log(widths.map((w) => "─".repeat(w)).join("  "));
+    for (const row of data)
+        console.log(formatRow(row));
+}
+export function truncate(s, max) {
+    if (!s)
+        return "";
+    return s.length <= max ? s : s.slice(0, max - 1) + "…";
+}
+/** Pretty-format an integer with thousands separators. */
+export function fmtInt(n) {
+    if (n === null || n === undefined)
+        return "—";
+    return Math.round(n).toLocaleString("en-US");
+}
+/** Pretty-format a float with one decimal, e.g. 1.3 → "1.3". */
+export function fmtFloat(n, digits = 2) {
+    if (n === null || n === undefined)
+        return "—";
+    return n.toFixed(digits);
+}
+/** Print an entity card in the human-readable view. */
+export function printEntity(e) {
+    console.log(`${e.name}${e.type ? `  (${e.type})` : ""}`);
+    if (e.slug)
+        console.log(`  slug:        ${e.slug}`);
+    if (e.wikidata_id)
+        console.log(`  wikidata:    ${e.wikidata_id}`);
+    if (e.domain)
+        console.log(`  domain:      ${e.domain}`);
+    if (e.description)
+        console.log(`  description: ${truncate(e.description, 200)}`);
+    if (e.summary)
+        console.log(`  summary:     ${truncate(e.summary, 300)}`);
+    if (e.popularity?.monthly_pageviews !== undefined) {
+        console.log(`  monthly views: ${fmtInt(e.popularity.monthly_pageviews)}`);
+    }
+    if (Array.isArray(e.facts) && e.facts.length > 0) {
+        console.log(`\n  facts (${e.facts.length}):`);
+        for (const f of e.facts.slice(0, 10)) {
+            const verified = f.verified ? " ✓" : "";
+            console.log(`    ${f.predicate_label || f.predicate}: ${f.value}${verified}`);
+        }
+        if (e.facts.length > 10)
+            console.log(`    … ${e.facts.length - 10} more`);
+    }
+    if (Array.isArray(e.relationships) && e.relationships.length > 0) {
+        console.log(`\n  relationships (${e.relationships.length}):`);
+        for (const r of e.relationships.slice(0, 10)) {
+            console.log(`    ${r.predicate_label || r.predicate} → ${r.target_name}`);
+        }
+        if (e.relationships.length > 10)
+            console.log(`    … ${e.relationships.length - 10} more`);
+    }
+    if (e.license)
+        console.log(`\n  license: ${e.license}`);
+}
+//# sourceMappingURL=kg-output.js.map

package/dist/kg-output.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1,5 @@
+export declare function runMcpStdio(): Promise<void>;
+export declare function runMcpHttp(opts: {
+    host: string;
+    port: number;
+}): Promise<void>;

package/dist/mcp-server.js

@@ -0,0 +1,363 @@
+/**
+ * `4ort mcp` — the 4ort MCP server. Two transports, one set of tools:
+ *   • `4ort mcp` (stdio)        — for Claude Desktop / local clients that spawn it
+ *   • `4ort mcp serve` (HTTP)   — Streamable HTTP, deploy behind a reverse proxy
+ *                                 → mcp.4ort.xyz (public)
+ *
+ * Tools wrap the same logic the CLI commands use (smart-router search, the web
+ * reader, KG entity/match/agent-context) — they call kgRequest / webRead
+ * directly (NOT the CLI command wrappers, which print to stdout and exit).
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { createServer } from "node:http";
+import { optionalKgConfig } from "./config.js";
+import { kgRequest } from "./kg-client.js";
+import { webRead } from "./web-client.js";
+const VERSION = "0.5.0-dev";
+const TOOLS = [
+    {
+        name: "kg_search",
+        description: "Smart router / front door. Given a query, returns: the canonical 4ort.xyz knowledge-graph entity it names (if any) plus that entity's official site & verified social links; a curated 'phonebook' of authoritative-source search URLs for the detected vertical (Wikipedia, TMDB, OpenAlex, SEC EDGAR, GitHub, MusicBrainz, …) that you then fetch with web_get; and ranked hits from our Common Crawl web index. Use this FIRST to decide where to look next. No auth required.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "The search query." },
+                limit_pages: { type: "integer", description: "Max web-index hits (default 15)." },
+                limit_sources: { type: "integer", description: "Max phonebook routes (default 12)." },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "web_get",
+        description: "Fetch a URL and return its readable text (Reader-Mode extraction — no browser, no JS). If the URL is a 4ort.xyz entity page, returns the structured entity instead of scraping. On a bot wall / 403 / paywall / PDF / binary body it returns ok:false WITH the URL so you can fall back. Use this to read phonebook routes from kg_search, web-index hits, or any arbitrary page.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "Absolute http(s) URL." },
+                max_chars: { type: "integer", description: "Cap on extracted text length (default 50000)." },
+            },
+            required: ["url"],
+        },
+    },
+    {
+        name: "kg_entity",
+        description: "Fetch one 4ort.xyz knowledge-graph entity by slug, UUID, or Wikidata Q-id. detail: tiny | small | medium | full (full includes facts, relationships/connections, citations). Use this to 'walk the graph' once you have an entity (e.g. from kg_search). Requires a 4ort.xyz API key on the server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: { type: "string", description: "Entity slug, UUID, or Q-id." },
+                detail: { type: "string", enum: ["tiny", "small", "medium", "full"], description: "Default: medium." },
+            },
+            required: ["key"],
+        },
+    },
+    {
+        name: "kg_match",
+        description: "Resolve a free-text string to its canonical 4ort.xyz knowledge-graph entity (entity linking / disambiguation). Returns ranked candidates with slug, type, and confidence. Requires a 4ort.xyz API key on the server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                text: { type: "string", description: "The string to resolve." },
+                limit: { type: "integer", description: "Max candidates (default 5)." },
+                entity_types: { type: "string", description: "Optional comma-separated entity-type filter." },
+            },
+            required: ["text"],
+        },
+    },
+    {
+        name: "kg_agent_context",
+        description: "Memory-bank bundle for an autonomous agent about one entity: short + long summaries, facts grouped by predicate, key connected actors, world context (country / domain rank / monthly views). Requires a 4ort.xyz API key on the server.",
+        inputSchema: {
+            type: "object",
+            properties: { key: { type: "string", description: "Entity slug, UUID, or Q-id." } },
+            required: ["key"],
+        },
+    },
+    {
+        name: "kg_article_context",
+        description: "Fat bundle of facts + writing hooks for an SEO writer about one entity: full entity card PLUS deduplicated citations across all facts, last-7-day Wikidata edit narrative, popularity signals, top connections, and 3-5 LLM-synthesized writing hooks ('recently controversial because X' / 'top-3 in domain Y'). Use this when you're about to draft an article. Requires a 4ort.xyz API key on the server.",
+        inputSchema: {
+            type: "object",
+            properties: { key: { type: "string", description: "Entity slug, UUID, or Q-id." } },
+            required: ["key"],
+        },
+    },
+    {
+        name: "kg_popularity",
+        description: "Real-world popularity score for an entity, derived from measured Wikipedia pageviews — a free CC0 alternative to Google Keyword Planner / Ahrefs / SEMrush. Returns current monthly volume, 12-month trend, 30-day daily breakdown, year-over-year change, country mix, and rank within the entity's domain. Requires a 4ort.xyz API key on the server.",
+        inputSchema: {
+            type: "object",
+            properties: { key: { type: "string", description: "Entity slug, UUID, or Q-id." } },
+            required: ["key"],
+        },
+    },
+    {
+        name: "kg_trending",
+        description: "What's trending RIGHT NOW on Wikipedia — live attention signal from hourly pageview deltas. Use to answer 'what's hot' / 'what are people reading about' / 'news today' type questions. Updated continuously. Requires a 4ort.xyz API key on the server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                period: { type: "string", enum: ["hour", "day", "week"], description: "Trend window. Default: day." },
+                country: { type: "string", description: "ISO 3166 alpha-2 (e.g. 'US', 'DE', 'JP') to filter to one country. Omit for global." },
+                category: { type: "string", description: "Filter to one harvest_domain (e.g. 'people', 'companies', 'software'). Omit for all." },
+                rank_by: { type: "string", enum: ["views", "velocity", "novelty", "weird"], description: "views=raw (default), velocity=% increase vs baseline, novelty=new-to-trending, weird=chronically-popular entities (TLDs, country pages)." },
+                limit: { type: "integer", description: "Max entities (1-100, default 20)." },
+            },
+        },
+    },
+    {
+        name: "deep_research",
+        description: "Kick off a DEEP, multi-step research job — an autonomous multi-agent run that searches, reads 10+ sources, and synthesizes a cited markdown briefing. ASYNC + long-running (several minutes): returns a job_id IMMEDIATELY, then poll deep_research_result until status is 'done'. Use for open-ended 'research X and write me a sourced report' tasks — NOT quick lookups (use kg_search for those). Gated: requires an authorized bearer token.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "The research question / brief." },
+                depth: { type: "string", enum: ["quick", "standard", "deep"], description: "Effort level. Default: standard." },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "deep_research_result",
+        description: "Poll a deep_research job by its job_id. Returns { status: queued | running | done | error, progress, report (clean markdown, when done), citations, sources_read }. Call repeatedly (a few seconds apart) until status is 'done' or 'error'. Gated: requires an authorized bearer token.",
+        inputSchema: {
+            type: "object",
+            properties: { job_id: { type: "string", description: "The job_id returned by deep_research." } },
+            required: ["job_id"],
+        },
+    },
+    // kg_qa removed 2026-05-17 — the backing /api/v1/qa endpoint was
+    // deprecated. Live LLM synthesis didn't belong in the API request path.
+    // To revive: re-enable the qa.router in app/main.py first.
+];
+// Expensive/abusable tools gated at the HTTP transport (see runMcpHttp). The
+// cheap read tools stay open for discovery; these burn tokens + minutes of
+// compute per call, so they require a bearer token from DEEP_RESEARCH_KEYS.
+const GATED_TOOLS = new Set(["deep_research", "deep_research_result"]);
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function fail(message) {
+    return { content: [{ type: "text", text: JSON.stringify({ error: message }) }], isError: true };
+}
+/** Build a fresh MCP Server with the tool handlers wired. */
+function buildServer() {
+    const server = new Server({ name: "4ort", version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const name = req.params.name;
+        const args = (req.params.arguments ?? {});
+        try {
+            switch (name) {
+                case "kg_search": {
+                    const data = await kgRequest(optionalKgConfig(), "/api/v1/route", {
+                        query: {
+                            q: String(args.query ?? ""),
+                            limit_pages: typeof args.limit_pages === "number" ? args.limit_pages : 15,
+                            limit_sources: typeof args.limit_sources === "number" ? args.limit_sources : 12,
+                        },
+                    });
+                    return ok(data);
+                }
+                case "web_get": {
+                    const url = String(args.url ?? "");
+                    if (!url)
+                        return fail("url is required");
+                    const r = await webRead(url, { maxChars: typeof args.max_chars === "number" ? args.max_chars : undefined });
+                    return ok(r);
+                }
+                case "kg_entity": {
+                    const key = String(args.key ?? "");
+                    if (!key)
+                        return fail("key is required");
+                    const data = await kgRequest(optionalKgConfig(), `/api/v1/entities/${encodeURIComponent(key)}`, {
+                        query: { detail: args.detail ?? "medium" },
+                    });
+                    return ok(data);
+                }
+                case "kg_match": {
+                    const text = String(args.text ?? "");
+                    if (!text)
+                        return fail("text is required");
+                    const entity_types = typeof args.entity_types === "string" && args.entity_types.trim()
+                        ? args.entity_types.split(",").map((t) => t.trim()).filter(Boolean)
+                        : undefined;
+                    const data = await kgRequest(optionalKgConfig(), "/api/v1/match", {
+                        method: "POST",
+                        body: { text, entity_types, limit: typeof args.limit === "number" ? args.limit : 5 },
+                    });
+                    return ok(data);
+                }
+                case "kg_agent_context": {
+                    const key = String(args.key ?? "");
+                    if (!key)
+                        return fail("key is required");
+                    const data = await kgRequest(optionalKgConfig(), `/api/v1/entities/${encodeURIComponent(key)}/agent-context`);
+                    return ok(data);
+                }
+                case "kg_article_context": {
+                    const key = String(args.key ?? "");
+                    if (!key)
+                        return fail("key is required");
+                    const data = await kgRequest(optionalKgConfig(), `/api/v1/entities/${encodeURIComponent(key)}/article-context`);
+                    return ok(data);
+                }
+                case "kg_popularity": {
+                    const key = String(args.key ?? "");
+                    if (!key)
+                        return fail("key is required");
+                    const data = await kgRequest(optionalKgConfig(), `/api/v1/popularity/${encodeURIComponent(key)}`);
+                    return ok(data);
+                }
+                case "kg_trending": {
+                    const query = {};
+                    if (typeof args.period === "string")
+                        query.period = args.period;
+                    if (typeof args.country === "string" && args.country)
+                        query.country = args.country;
+                    if (typeof args.category === "string" && args.category)
+                        query.category = args.category;
+                    if (typeof args.rank_by === "string")
+                        query.rank_by = args.rank_by;
+                    if (typeof args.limit === "number")
+                        query.limit = args.limit;
+                    const data = await kgRequest(optionalKgConfig(), "/api/v1/trending", { query });
+                    return ok(data);
+                }
+                case "deep_research": {
+                    const query = String(args.query ?? "");
+                    if (!query)
+                        return fail("query is required");
+                    const data = await kgRequest(optionalKgConfig(), "/api/v1/research", {
+                        method: "POST",
+                        body: { query, depth: typeof args.depth === "string" ? args.depth : "standard" },
+                    });
+                    return ok(data);
+                }
+                case "deep_research_result": {
+                    const job_id = String(args.job_id ?? "");
+                    if (!job_id)
+                        return fail("job_id is required");
+                    const data = await kgRequest(optionalKgConfig(), `/api/v1/research/${encodeURIComponent(job_id)}`);
+                    return ok(data);
+                }
+                // kg_qa case removed 2026-05-17 — see TOOLS array note above.
+                default:
+                    return fail(`unknown tool: ${name}`);
+            }
+        }
+        catch (e) {
+            return fail(e?.message ?? String(e));
+        }
+    });
+    return server;
+}
+// ── stdio transport (local: Claude Desktop spawns the process) ──────────────
+export async function runMcpStdio() {
+    const server = buildServer();
+    await server.connect(new StdioServerTransport());
+    // Stays alive on stdio until the client disconnects.
+}
+// ── Streamable HTTP transport (hosted: behind a reverse proxy → mcp.4ort.xyz) ─
+const MAX_REQUEST_BYTES = 1_000_000;
+function sendJson(res, status, body) {
+    res.writeHead(status, { "content-type": "application/json" });
+    res.end(JSON.stringify(body));
+}
+export async function runMcpHttp(opts) {
+    const httpServer = createServer(async (req, res) => {
+        try {
+            const u = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+            // health / discovery
+            if (req.method === "GET" && (u.pathname === "/" || u.pathname === "/health")) {
+                return sendJson(res, 200, {
+                    ok: true,
+                    service: "4ort-mcp",
+                    version: VERSION,
+                    transport: "streamable-http",
+                    endpoint: "/mcp",
+                    tools: TOOLS.map((t) => t.name),
+                });
+            }
+            if (u.pathname !== "/mcp") {
+                return sendJson(res, 404, { error: "not found — the MCP endpoint is POST /mcp" });
+            }
+            if (req.method !== "POST") {
+                // Stateless server: no long-lived GET/SSE stream to resume.
+                res.setHeader("allow", "POST");
+                return sendJson(res, 405, { error: "method not allowed — POST /mcp with a JSON-RPC body" });
+            }
+            // read + parse the JSON-RPC body (we manage the body so we can cap it)
+            const chunks = [];
+            let total = 0;
+            for await (const c of req) {
+                const buf = c;
+                total += buf.length;
+                if (total > MAX_REQUEST_BYTES)
+                    return sendJson(res, 413, { error: "request too large" });
+                chunks.push(buf);
+            }
+            const raw = Buffer.concat(chunks).toString("utf8");
+            let body;
+            try {
+                body = raw ? JSON.parse(raw) : undefined;
+            }
+            catch {
+                return sendJson(res, 400, { error: "invalid JSON body" });
+            }
+            // Gate the expensive tools (deep_research*) at the transport — read tools
+            // stay open for discovery. These burn tokens + minutes of compute, so they
+            // require a bearer token from DEEP_RESEARCH_KEYS (comma-separated). Fail
+            // CLOSED: if no keys are configured, the gated tools are unusable.
+            const calls = Array.isArray(body) ? body : [body];
+            const wantsGated = calls.some((m) => m?.method === "tools/call" && GATED_TOOLS.has(m?.params?.name));
+            if (wantsGated) {
+                const allow = (process.env.DEEP_RESEARCH_KEYS ?? "")
+                    .split(",").map((s) => s.trim()).filter(Boolean);
+                const token = (req.headers.authorization ?? "").replace(/^Bearer\s+/i, "").trim();
+                if (allow.length === 0 || !token || !allow.includes(token)) {
+                    return sendJson(res, 401, { error: "deep_research requires an authorized bearer token" });
+                }
+            }
+            // Stateless: a fresh Server + transport per request. Sidesteps session
+            // management entirely (read tools are stateless; deep_research* only enqueue).
+            const server = buildServer();
+            const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+            res.on("close", () => {
+                try {
+                    transport.close();
+                }
+                catch { /* ignore */ }
+                try {
+                    server.close();
+                }
+                catch { /* ignore */ }
+            });
+            await server.connect(transport);
+            await transport.handleRequest(req, res, body);
+        }
+        catch (e) {
+            if (!res.headersSent) {
+                sendJson(res, 500, { error: e?.message ?? String(e) });
+            }
+            else {
+                try {
+                    res.end();
+                }
+                catch { /* ignore */ }
+            }
+        }
+    });
+    await new Promise((resolve) => {
+        httpServer.listen(opts.port, opts.host, () => {
+            process.stderr.write(`4ort MCP (Streamable HTTP) listening on http://${opts.host}:${opts.port}/mcp — tools: ${TOOLS.map((t) => t.name).join(", ")}\n`);
+            resolve();
+        });
+    });
+    // Keep the process alive (the http server holds the event loop).
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/web-client.d.ts

@@ -0,0 +1,20 @@
+export interface WebReadResult {
+    ok: boolean;
+    url: string;
+    final_url?: string;
+    source: "live" | "4ort.xyz";
+    status?: number;
+    content_type?: string;
+    title?: string;
+    byline?: string | null;
+    word_count?: number;
+    excerpt?: string;
+    text?: string;
+    truncated?: boolean;
+    reason?: string;
+    size?: number;
+    entity?: unknown;
+}
+export declare function webRead(rawUrl: string, opts?: {
+    maxChars?: number;
+}): Promise<WebReadResult>;