@4ort/cli 0.3.0 → 0.5.0

package/dist/config.d.ts

@@ -1,10 +1,35 @@
+export interface KgConfig {
+    apiKey: string;
+    recoveryCode?: string;
+    server: string;
+    name?: string;
+    tier?: string;
+}
+export interface VaultConfig {
+    token: string;
+    server: string;
+}
 export interface Config {
     apiKey: string;
     recoveryCode?: string;
     server: string;
     agentName: string;
+    kg?: KgConfig;
+    vault?: VaultConfig;
 }
 export declare function loadConfig(): Config | null;
 export declare function saveConfig(config: Config): void;
+/** Save just the KG block, preserving any existing 4ort.net config. */
+export declare function saveKgConfig(kg: KgConfig): void;
 export declare function requireConfig(): Config;
+export declare function requireKgConfig(): KgConfig;
+/**
+ * Like requireKgConfig, but never exits — for public KG endpoints (e.g.
+ * /api/v1/route). Returns the KG key if present, else the 4ort.net key, else an
+ * empty key against the canonical server. Callers should treat auth as optional.
+ */
+export declare function optionalKgConfig(): KgConfig;
 export declare function getConfigPath(): string;
+/** Save just the vault block, preserving the rest of the config. */
+export declare function saveVaultConfig(vault: VaultConfig): void;
+export declare function requireVaultConfig(): VaultConfig;

package/dist/config.js

@@ -1,3 +1,24 @@
+/**
+ * Persisted CLI config at ~/.4ort/config.json (mode 0600).
+ *
+ * Layout:
+ *   {
+ *     "apiKey": "...",            // 4ort.net agent key (4n_-prefixed going forward)
+ *     "recoveryCode": "...",
+ *     "server": "https://4ort.net",
+ *     "agentName": "ryan",
+ *     "kg": {                      // 4ort.xyz knowledge graph (optional)
+ *       "apiKey": "4kg_...",
+ *       "recoveryCode": "...",
+ *       "server": "https://4ort.xyz",
+ *       "name": "my-agent",
+ *       "tier": "free"
+ *     }
+ *   }
+ *
+ * Both blocks are independent — a user can sign in to 4ort.net only,
+ * 4ort.xyz only, or both. The CLI picks the right block per command.
+ */
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
@@ -16,15 +37,73 @@ export function saveConfig(config) {
     fs.mkdirSync(CONFIG_DIR, { recursive: true });
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", { mode: 0o600 });
 }
+/** Save just the KG block, preserving any existing 4ort.net config. */
+export function saveKgConfig(kg) {
+    const existing = loadConfig();
+    const next = existing
+        ? { ...existing, kg }
+        : { apiKey: "", server: "https://4ort.net", agentName: "", kg };
+    saveConfig(next);
+}
 export function requireConfig() {
     const config = loadConfig();
-    if (!config) {
+    if (!config || !config.apiKey) {
         console.error("Not logged in. Run: 4ort register <name>");
         process.exit(1);
+        throw new Error("unreachable");
     }
     return config;
 }
+export function requireKgConfig() {
+    const config = loadConfig();
+    if (config?.kg?.apiKey)
+        return config.kg;
+    // Fall back to 4ort.net membership if present — federated keys validate
+    // against 4ort.net automatically.
+    if (config?.apiKey) {
+        return {
+            apiKey: config.apiKey,
+            server: "https://4ort.xyz",
+        };
+    }
+    console.error("Not signed in to 4ort.xyz. Run one of:");
+    console.error("  4ort kg register     # one-shot, no email needed");
+    console.error("  4ort kg auth login   # paste an existing key");
+    process.exit(1);
+    throw new Error("unreachable");
+}
+/**
+ * Like requireKgConfig, but never exits — for public KG endpoints (e.g.
+ * /api/v1/route). Returns the KG key if present, else the 4ort.net key, else an
+ * empty key against the canonical server. Callers should treat auth as optional.
+ */
+export function optionalKgConfig() {
+    const config = loadConfig();
+    if (config?.kg?.apiKey)
+        return config.kg;
+    if (config?.apiKey)
+        return { apiKey: config.apiKey, server: "https://4ort.xyz" };
+    return { apiKey: "", server: "https://4ort.xyz" };
+}
 export function getConfigPath() {
     return CONFIG_FILE;
 }
+/** Save just the vault block, preserving the rest of the config. */
+export function saveVaultConfig(vault) {
+    const existing = loadConfig();
+    const next = existing
+        ? { ...existing, vault }
+        : { apiKey: "", server: "https://4ort.net", agentName: "", vault };
+    saveConfig(next);
+}
+export function requireVaultConfig() {
+    const config = loadConfig();
+    if (config?.vault?.token) {
+        return config.vault;
+    }
+    console.error("Not signed in to the 4ort.ai vault. Run:");
+    console.error("  4ort vault login   # paste a token from the Secrets panel");
+    process.exit(1);
+    throw new Error("unreachable");
+}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACpD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AASzD,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -6,13 +6,30 @@ import { list } from "./commands/list.js";
 import { deleteSite } from "./commands/delete.js";
 import { whoami } from "./commands/whoami.js";
 import { checkMail, readMail, sendMail, deleteMail } from "./commands/mail.js";
-import { provisionService, provisionAll, provisionStatus, provisionCredentials, listServices } from "./commands/provision.js";
+import { provisionService, provisionAll, provisionStatus, provisionCredentials, listServices, } from "./commands/provision.js";
+import { kgRegister, kgLogin, kgStatus } from "./commands/kg/auth.js";
+import { kgSearch } from "./commands/kg/search.js";
+import { kgEntity } from "./commands/kg/entity.js";
+import { kgAsk } from "./commands/kg/ask.js";
+import { kgMatch } from "./commands/kg/match.js";
+import { kgPopularity } from "./commands/kg/popularity.js";
+import { kgTrending } from "./commands/kg/trending.js";
+import { kgAgentContext } from "./commands/kg/agent-context.js";
+import { kgArticleContext } from "./commands/kg/article-context.js";
+import { webGet } from "./commands/web.js";
+import { searchCommand } from "./commands/search.js";
+import { mcpStdioCommand, mcpServeCommand } from "./commands/mcp.js";
+import { vaultLogin, vaultStatus, vaultLogout } from "./commands/vault.js";
+import { runCommand } from "./commands/run.js";
 import { loadConfig, getConfigPath } from "./config.js";
 const program = new Command();
 program
     .name("4ort")
-    .description("CLI for 4ort.net — where AI agents build websites")
-    .version("0.1.0");
+    .description("Unified CLI for the 4ort ecosystem — hosting, knowledge graph, and more")
+    .version("0.5.0-dev");
+// ─────────────────────────────────────────────────────────────────────
+// 4ort.net subdomain hosting
+// ─────────────────────────────────────────────────────────────────────
 program
     .command("register <name>")
     .description("Register a new agent and claim your subdomain")
@@ -23,47 +40,49 @@ program
     .command("push [directory]")
     .description("Deploy your site (defaults to current directory)")
     .action((dir = ".") => push(dir));
+program.command("list").description("List your sites").action(list);
+// ─────────────────────────────────────────────────────────────────────
+// Secrets vault — `4ort run` resolves 4ort:// references at runtime
+// ─────────────────────────────────────────────────────────────────────
+const vault = program
+    .command("vault")
+    .description("Link this machine to the 4ort.ai secrets vault");
+vault
+    .command("login [token]")
+    .description("Link the vault with a token from the Secrets panel")
+    .option("-s, --server <url>", "Vault server URL", "https://4ort.ai")
+    .action((token, opts) => vaultLogin(token, opts));
+vault.command("status").description("Show vault link status").action(vaultStatus);
+vault.command("logout").description("Unlink the vault").action(vaultLogout);
 program
-    .command("list")
-    .description("List your sites")
-    .action(list);
+    .command("run")
+    .description("Run a command with 4ort:// secret references resolved into env vars")
+    .argument("[parts...]", "command and args (use -- to separate, e.g. 4ort run -- node app.js)")
+    .action((parts) => runCommand(parts));
 program
     .command("delete [subdomain]")
     .description("Delete a site")
     .action(deleteSite);
-program
-    .command("whoami")
-    .description("Show current agent info")
-    .action(whoami);
+program.command("whoami").description("Show current agent info").action(whoami);
 const mail = program.command("mail").description("Manage your @4ort.net inbox");
 mail
     .command("inbox")
     .description("Check your inbox")
     .option("-u, --unread", "Show unread only")
     .action(checkMail);
-mail
-    .command("read <id>")
-    .description("Read a message")
-    .action(readMail);
+mail.command("read <id>").description("Read a message").action(readMail);
 mail
     .command("send <to>")
     .description("Send a message to another agent")
     .option("-s, --subject <subject>", "Subject line")
     .option("-b, --body <body>", "Message body")
     .action(sendMail);
-mail
-    .command("delete <id>")
-    .description("Delete a message")
-    .action(deleteMail);
-const provision = program.command("provision").description("Auto-provision third-party service accounts");
-provision
-    .command("run <service>")
-    .description("Provision a specific service")
-    .action(provisionService);
-provision
-    .command("all")
-    .description("Provision all available Tier A services")
-    .action(provisionAll);
+mail.command("delete <id>").description("Delete a message").action(deleteMail);
+const provision = program
+    .command("provision")
+    .description("Auto-provision third-party service accounts");
+provision.command("run <service>").description("Provision a specific service").action(provisionService);
+provision.command("all").description("Provision all available Tier A services").action(provisionAll);
 provision
     .command("status [service]")
     .description("Check provisioning status")
@@ -72,23 +91,134 @@ provision
     .command("credentials [service]")
     .description("Show stored credentials")
     .action((service) => provisionCredentials(service));
-provision
-    .command("services")
-    .description("List available services")
-    .action(listServices);
+provision.command("services").description("List available services").action(listServices);
+// ─────────────────────────────────────────────────────────────────────
+// Search — the smart router / front door (4ort.xyz entity + phonebook + web)
+// ─────────────────────────────────────────────────────────────────────
+program
+    .command("search <query>")
+    .description("Smart router: KG entity + curated sources (phonebook) + web hits")
+    .option("-p, --pages <n>", "Max web-index hits", "20")
+    .option("-s, --sources <n>", "Max authoritative-source routes", "12")
+    .option("--json", "Output the full structured payload as JSON")
+    .action(searchCommand);
+// ─────────────────────────────────────────────────────────────────────
+// 4ort knowledge graph (Popularity Graph)
+// ─────────────────────────────────────────────────────────────────────
+const kg = program
+    .command("kg")
+    .description("Query the 4ort knowledge graph (Popularity Graph)");
+kg.command("register")
+    .description("One-shot register a new 4ort.xyz API key")
+    .option("-n, --name <name>", "Display name for this key")
+    .option("-e, --email <email>", "Optional contact email for billing/recovery")
+    .option("-s, --server <url>", "KG server URL", "https://4ort.xyz")
+    .action(kgRegister);
+const kgAuth = kg.command("auth").description("Manage 4ort.xyz authentication");
+kgAuth
+    .command("login")
+    .description("Sign in by pasting an existing 4ort.xyz API key")
+    .option("-s, --server <url>", "KG server URL", "https://4ort.xyz")
+    .action(kgLogin);
+kgAuth
+    .command("status")
+    .description("Show the current 4ort.xyz identity")
+    .action(kgStatus);
+kg.command("search <query>")
+    .description("Hybrid search across the entity graph")
+    .option("-l, --limit <n>", "Max results", "20")
+    .option("--json", "Output JSON instead of a table")
+    .action(kgSearch);
+kg.command("entity <key>")
+    .description("Fetch one entity (slug, UUID, or Q-id)")
+    .option("-d, --detail <level>", "tiny | small | medium | full", "medium")
+    .option("--json", "Output JSON")
+    .action(kgEntity);
+kg.command("ask <question>")
+    .description("Ask the graph anything — streams cited tokens")
+    .option("-s, --scope <slug>", "Scope the question to one entity")
+    .option("--json", "Skip streaming, return one structured payload")
+    .option("--plain", "Strip markdown formatting (no bold, italic, code marks)")
+    .action(kgAsk);
+kg.command("match <text>")
+    .description("Resolve a string to its canonical KG entity")
+    .option("-l, --limit <n>", "Max candidates", "5")
+    .option("-t, --types <list>", "Comma-separated entity-type filter")
+    .option("--json", "Output JSON")
+    .action(kgMatch);
+kg.command("popularity <key>")
+    .description("Pageview-derived 'real-world search volume' for an entity")
+    .option("--json", "Output JSON")
+    .action(kgPopularity);
+kg.command("trending")
+    .description("Top entities by Wikipedia pageview velocity")
+    .option("-h, --hours <n>", "Window size in hours", "1")
+    .option("-l, --limit <n>", "Max results", "50")
+    .option("-d, --domain <name>", "Filter to a specific domain")
+    .option("--json", "Output JSON")
+    .action(kgTrending);
+kg.command("agent-context <key>")
+    .description("Memory-bank bundle for autonomous agents")
+    .option("--json", "Output JSON")
+    .action(kgAgentContext);
+kg.command("article-context <key>")
+    .description("Fat bundle for SEO writers — facts, citations, hooks")
+    .option("--json", "Output JSON")
+    .action(kgArticleContext);
+// ─────────────────────────────────────────────────────────────────────
+// Web — read the public internet (Reader-Mode fetch, no browser)
+// ─────────────────────────────────────────────────────────────────────
+const web = program
+    .command("web")
+    .description("Read the public internet — Reader-Mode fetch, no browser/JS");
+web
+    .command("get <url>")
+    .description("Fetch a URL and return its readable text (our own pages → structured)")
+    .option("--json", "Output the structured payload as JSON")
+    .option("-m, --max-chars <n>", "Cap extracted text length (default 50000)")
+    .action(webGet);
+// ─────────────────────────────────────────────────────────────────────
+// MCP — expose search + web get + kg tools to MCP-native agents over stdio
+// ─────────────────────────────────────────────────────────────────────
+const mcp = program
+    .command("mcp")
+    .description("4ort MCP server — stdio (default), or `mcp serve` for Streamable HTTP");
+mcp
+    .command("stdio", { isDefault: true })
+    .description("Run over stdio — for Claude Desktop & local MCP clients that spawn the process")
+    .action(mcpStdioCommand);
+mcp
+    .command("serve")
+    .description("Run as a Streamable HTTP server (deploy behind a reverse proxy → mcp.4ort.xyz)")
+    .option("-p, --port <n>", "Port to listen on", "8003")
+    .option("-H, --host <addr>", "Bind address", "127.0.0.1")
+    .action(mcpServeCommand);
+// ─────────────────────────────────────────────────────────────────────
+// Config inspection
+// ─────────────────────────────────────────────────────────────────────
 program
     .command("config")
     .description("Show config location and current settings")
     .action(() => {
     const config = loadConfig();
     if (!config) {
-        console.log("Not configured. Run: 4ort register <name>");
+        console.log("Not configured. Run: 4ort register <name>  or  4ort kg register");
+        return;
+    }
+    console.log(`Config: ${getConfigPath()}`);
+    if (config.apiKey) {
+        console.log(`\n4ort.net`);
+        console.log(`  agent:    ${config.agentName || "(unset)"}`);
+        console.log(`  server:   ${config.server}`);
+        console.log(`  api key:  ${config.apiKey.slice(0, 12)}…`);
     }
-    else {
-        console.log(`Config: ${getConfigPath()}`);
-        console.log(`Agent: ${config.agentName}`);
-        console.log(`Server: ${config.server}`);
-        console.log(`API Key: ${config.apiKey.slice(0, 8)}...`);
+    if (config.kg?.apiKey) {
+        console.log(`\n4ort.xyz (knowledge graph)`);
+        console.log(`  name:     ${config.kg.name || "(unset)"}`);
+        console.log(`  server:   ${config.kg.server}`);
+        console.log(`  api key:  ${config.kg.apiKey.slice(0, 12)}…`);
+        if (config.kg.tier)
+            console.log(`  tier:     ${config.kg.tier}`);
     }
 });
 program.parse();

package/dist/index.js.map

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

package/dist/kg-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * HTTP + SSE client for the 4ort.xyz knowledge graph API.
+ *
+ * Sends Authorization: Bearer <key> for auth (the federation-aware shape).
+ * Treats 4ort.xyz as the canonical KG server but lets KgConfig.server
+ * override it for local dev or alternate deployments.
+ *
+ * Honors HTTP_PROXY / HTTPS_PROXY / NO_PROXY env vars via undici's
+ * EnvHttpProxyAgent. Node's global fetch ignores these by default —
+ * setting a global dispatcher fixes that. Critical for the 4ort.ai
+ * sandbox use case where outbound HTTP must go through tinyproxy.
+ */
+import { KgConfig } from "./config.js";
+export interface RequestOptions {
+    method?: string;
+    body?: unknown;
+    query?: Record<string, string | number | boolean | undefined>;
+}
+export declare function kgRequest<T = unknown>(config: KgConfig, path: string, options?: RequestOptions): Promise<T>;
+/**
+ * Anonymous POST — used by /api/v1/register before the user has a key.
+ */
+export declare function kgRegisterRequest(server: string, body: {
+    name: string;
+    email?: string;
+}): Promise<{
+    apiKey: string;
+    recoveryCode: string;
+    keyPrefix: string;
+    name: string;
+    tier: string;
+    docsUrl?: string;
+}>;
+export interface SSEEvent {
+    event?: string;
+    data: string;
+}
+/**
+ * Read a Server-Sent Events stream. Calls onEvent for every parsed message.
+ * Supports the FastAPI/Starlette SSE shape used by /api/qa/stream.
+ */
+export declare function streamKgSSE(config: KgConfig, path: string, body: unknown, onEvent: (ev: SSEEvent) => void): Promise<void>;

package/dist/kg-client.js

@@ -0,0 +1,125 @@
+import { EnvHttpProxyAgent, setGlobalDispatcher } from "undici";
+// Wire env-var proxy support for fetch on module load. Idempotent + cheap.
+if (process.env.HTTP_PROXY ||
+    process.env.HTTPS_PROXY ||
+    process.env.http_proxy ||
+    process.env.https_proxy) {
+    setGlobalDispatcher(new EnvHttpProxyAgent());
+}
+function buildUrl(server, path, query) {
+    const url = new URL(path, server);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined && v !== null && v !== "") {
+                url.searchParams.set(k, String(v));
+            }
+        }
+    }
+    return url.toString();
+}
+export async function kgRequest(config, path, options = {}) {
+    const url = buildUrl(config.server, path, options.query);
+    const headers = {
+        "User-Agent": "4ort-cli/0.5.0",
+        Accept: "application/json",
+    };
+    // Only send auth when we actually have a key — some public endpoints (e.g.
+    // /api/v1/route) work keyless, and a `Bearer ` (empty) header trips some
+    // proxies/WAFs.
+    if (config.apiKey)
+        headers.Authorization = `Bearer ${config.apiKey}`;
+    const init = {
+        method: options.method ?? "GET",
+        headers,
+    };
+    if (options.body !== undefined) {
+        init.headers["Content-Type"] = "application/json";
+        init.body = JSON.stringify(options.body);
+    }
+    const res = await fetch(url, init);
+    const text = await res.text();
+    let data;
+    try {
+        data = text ? JSON.parse(text) : null;
+    }
+    catch {
+        data = text;
+    }
+    if (!res.ok) {
+        const detail = data?.detail || data?.error || text || res.statusText;
+        throw new Error(`HTTP ${res.status}: ${detail}`);
+    }
+    return data;
+}
+/**
+ * Anonymous POST — used by /api/v1/register before the user has a key.
+ */
+export async function kgRegisterRequest(server, body) {
+    const res = await fetch(buildUrl(server, "/api/v1/register"), {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "User-Agent": "4ort-cli/0.5.0",
+            Accept: "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    const text = await res.text();
+    const data = text ? JSON.parse(text) : null;
+    if (!res.ok) {
+        const detail = data?.detail || data?.error || text || res.statusText;
+        throw new Error(`Register failed: ${detail}`);
+    }
+    return data;
+}
+/**
+ * Read a Server-Sent Events stream. Calls onEvent for every parsed message.
+ * Supports the FastAPI/Starlette SSE shape used by /api/qa/stream.
+ */
+export async function streamKgSSE(config, path, body, onEvent) {
+    const url = buildUrl(config.server, path);
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${config.apiKey}`,
+            "Content-Type": "application/json",
+            Accept: "text/event-stream",
+            "User-Agent": "4ort-cli/0.5.0",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`HTTP ${res.status}: ${text || res.statusText}`);
+    }
+    if (!res.body) {
+        throw new Error("Streaming not supported by runtime");
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder("utf-8");
+    let buffer = "";
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        // Events are separated by a blank line ("\n\n").
+        let sep;
+        while ((sep = buffer.indexOf("\n\n")) >= 0) {
+            const block = buffer.slice(0, sep);
+            buffer = buffer.slice(sep + 2);
+            let event;
+            const dataLines = [];
+            for (const line of block.split("\n")) {
+                if (line.startsWith("event: "))
+                    event = line.slice(7).trim();
+                else if (line.startsWith("data: "))
+                    dataLines.push(line.slice(6));
+            }
+            if (dataLines.length > 0) {
+                onEvent({ event, data: dataLines.join("\n") });
+            }
+        }
+    }
+}
+//# sourceMappingURL=kg-client.js.map

package/dist/kg-client.js.map

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

package/dist/kg-output.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ */
+export type RenderMode = "raw" | "plain" | "ansi";
+/** Pick render mode from CLI flags + TTY detection. */
+export declare function pickRenderMode(plain?: boolean): RenderMode;
+/**
+ * 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 declare function renderMarkdown(text: string, mode: RenderMode): string;
+/** Wrap a heading line in ANSI bold for TTY output. */
+export declare function styleHeading(text: string, mode: RenderMode): string;
+export declare function printJson(data: unknown): void;
+/**
+ * Render a list of objects as a column-aligned text table.
+ * `columns` is an ordered list of [header, accessor] pairs.
+ */
+export declare function printTable<T>(rows: T[], columns: Array<[string, (row: T) => string | number | undefined]>): void;
+export declare function truncate(s: string | undefined | null, max: number): string;
+/** Pretty-format an integer with thousands separators. */
+export declare function fmtInt(n: number | null | undefined): string;
+/** Pretty-format a float with one decimal, e.g. 1.3 → "1.3". */
+export declare function fmtFloat(n: number | null | undefined, digits?: number): string;
+/** Print an entity card in the human-readable view. */
+export declare function printEntity(e: any): void;