cograph 0.1.0 → 0.1.2

package/dist/chunk-7VVBEUZQ.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+// src/config.ts
+import { homedir } from "os";
+import { join } from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from "fs";
+function configDir() {
+  return join(homedir(), ".cograph");
+}
+function configPath() {
+  return join(configDir(), "config.json");
+}
+function readConfig() {
+  const path = configPath();
+  if (!existsSync(path)) return {};
+  try {
+    const raw = readFileSync(path, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object") {
+      return parsed;
+    }
+  } catch {
+  }
+  return {};
+}
+function writeConfig(patch) {
+  const dir = configDir();
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true, mode: 448 });
+  }
+  const merged = { ...readConfig(), ...patch };
+  const path = configPath();
+  writeFileSync(path, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+  try {
+    chmodSync(path, 384);
+  } catch {
+  }
+}
+function configPathForDisplay() {
+  return configPath();
+}
+
+export {
+  readConfig,
+  writeConfig,
+  configPathForDisplay
+};
+//# sourceMappingURL=chunk-7VVBEUZQ.js.map

package/dist/chunk-7VVBEUZQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from \"node:fs\";\n\nexport interface CographConfig {\n  apiKey?: string;\n  apiUrl?: string;\n  tenant?: string;\n  email?: string;\n}\n\nfunction configDir(): string {\n  return join(homedir(), \".cograph\");\n}\n\nfunction configPath(): string {\n  return join(configDir(), \"config.json\");\n}\n\n/**\n * Read `~/.cograph/config.json`. Returns an empty object if the file is\n * missing or unreadable — callers should treat fields as optional.\n */\nexport function readConfig(): CographConfig {\n  const path = configPath();\n  if (!existsSync(path)) return {};\n  try {\n    const raw = readFileSync(path, \"utf-8\");\n    const parsed = JSON.parse(raw) as unknown;\n    if (parsed && typeof parsed === \"object\") {\n      return parsed as CographConfig;\n    }\n  } catch {\n    // Corrupt or unreadable; behave as if absent so a fresh login can rewrite.\n  }\n  return {};\n}\n\n/**\n * Write `~/.cograph/config.json` with `chmod 600`. Creates the directory if\n * needed. Merges with the existing config so callers can update one field\n * without clobbering the others.\n */\nexport function writeConfig(patch: CographConfig): void {\n  const dir = configDir();\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true, mode: 0o700 });\n  }\n  const merged = { ...readConfig(), ...patch };\n  const path = configPath();\n  writeFileSync(path, JSON.stringify(merged, null, 2) + \"\\n\", \"utf-8\");\n  try {\n    chmodSync(path, 0o600);\n  } catch {\n    // best-effort; some filesystems (e.g., FAT) don't honor chmod\n  }\n}\n\nexport function configPathForDisplay(): string {\n  return configPath();\n}\n"],"mappings":";;;AAAA,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,YAAY,WAAW,cAAc,eAAe,iBAAiB;AAS9E,SAAS,YAAoB;AAC3B,SAAO,KAAK,QAAQ,GAAG,UAAU;AACnC;AAEA,SAAS,aAAqB;AAC5B,SAAO,KAAK,UAAU,GAAG,aAAa;AACxC;AAMO,SAAS,aAA4B;AAC1C,QAAM,OAAO,WAAW;AACxB,MAAI,CAAC,WAAW,IAAI,EAAG,QAAO,CAAC;AAC/B,MAAI;AACF,UAAM,MAAM,aAAa,MAAM,OAAO;AACtC,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,QAAI,UAAU,OAAO,WAAW,UAAU;AACxC,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO,CAAC;AACV;AAOO,SAAS,YAAY,OAA4B;AACtD,QAAM,MAAM,UAAU;AACtB,MAAI,CAAC,WAAW,GAAG,GAAG;AACpB,cAAU,KAAK,EAAE,WAAW,MAAM,MAAM,IAAM,CAAC;AAAA,EACjD;AACA,QAAM,SAAS,EAAE,GAAG,WAAW,GAAG,GAAG,MAAM;AAC3C,QAAM,OAAO,WAAW;AACxB,gBAAc,MAAM,KAAK,UAAU,QAAQ,MAAM,CAAC,IAAI,MAAM,OAAO;AACnE,MAAI;AACF,cAAU,MAAM,GAAK;AAAA,EACvB,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,uBAA+B;AAC7C,SAAO,WAAW;AACpB;","names":[]}

package/dist/chunk-YVKKUWD7.js

@@ -0,0 +1,280 @@
+#!/usr/bin/env node
+import {
+  readConfig
+} from "./chunk-7VVBEUZQ.js";
+
+// src/client.ts
+import { existsSync, readFileSync, statSync } from "fs";
+import { extname } from "path";
+var CographError = class extends Error {
+  status;
+  body;
+  constructor(message, opts) {
+    super(message);
+    this.name = "CographError";
+    this.status = opts?.status;
+    this.body = opts?.body;
+  }
+};
+function envVar(name, fallback) {
+  return process.env[`COGRAPH_${name}`] || process.env[`OMNIX_${name}`] || fallback;
+}
+var EXT_FORMAT = {
+  ".csv": "csv",
+  ".json": "json",
+  ".jsonl": "json",
+  ".txt": "text"
+};
+function parseCsv(content) {
+  const rows = [];
+  let cur = [];
+  let field = "";
+  let inQuotes = false;
+  for (let i = 0; i < content.length; i++) {
+    const ch = content[i];
+    if (inQuotes) {
+      if (ch === '"') {
+        if (content[i + 1] === '"') {
+          field += '"';
+          i++;
+        } else {
+          inQuotes = false;
+        }
+      } else {
+        field += ch;
+      }
+    } else {
+      if (ch === '"') {
+        inQuotes = true;
+      } else if (ch === ",") {
+        cur.push(field);
+        field = "";
+      } else if (ch === "\n") {
+        cur.push(field);
+        rows.push(cur);
+        cur = [];
+        field = "";
+      } else if (ch === "\r") {
+        if (content[i + 1] !== "\n") {
+          cur.push(field);
+          rows.push(cur);
+          cur = [];
+          field = "";
+        }
+      } else {
+        field += ch;
+      }
+    }
+  }
+  if (field.length > 0 || cur.length > 0) {
+    cur.push(field);
+    rows.push(cur);
+  }
+  if (rows.length === 0) return [];
+  const headers = rows[0].map((h) => h.trim());
+  const out = [];
+  for (let r = 1; r < rows.length; r++) {
+    const row = rows[r];
+    if (row.length === 1 && row[0] === "") continue;
+    const obj = {};
+    for (let c = 0; c < headers.length; c++) {
+      obj[headers[c]] = row[c] ?? "";
+    }
+    out.push(obj);
+  }
+  return out;
+}
+var Client = class {
+  apiKey;
+  baseUrl;
+  tenant;
+  constructor(opts = {}) {
+    const cfg = readConfig();
+    this.apiKey = opts.apiKey ?? envVar("API_KEY") ?? cfg.apiKey;
+    const url = opts.baseUrl ?? envVar("API_URL") ?? cfg.apiUrl ?? "https://api.cograph.cloud";
+    this.baseUrl = url.replace(/\/+$/, "");
+    this.tenant = opts.tenant ?? envVar("TENANT") ?? cfg.tenant ?? "demo-tenant";
+  }
+  headers() {
+    const h = { "Content-Type": "application/json" };
+    if (this.apiKey) h["X-API-Key"] = this.apiKey;
+    return h;
+  }
+  base() {
+    return `${this.baseUrl}/graphs/${this.tenant}`;
+  }
+  async request(method, url, body, timeoutMs = 12e4) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let res;
+    try {
+      res = await fetch(url, {
+        method,
+        headers: this.headers(),
+        body: body === void 0 ? void 0 : JSON.stringify(body),
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new CographError(`Request to ${url} timed out after ${timeoutMs}ms`);
+      }
+      throw new CographError(
+        `Network error contacting ${url}: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+    clearTimeout(timer);
+    if (!res.ok) {
+      let text2 = "";
+      try {
+        text2 = await res.text();
+      } catch {
+      }
+      throw new CographError(`HTTP ${res.status}: ${text2}`, {
+        status: res.status,
+        body: text2
+      });
+    }
+    if (res.status === 204) return void 0;
+    const ct = res.headers.get("content-type") ?? "";
+    if (ct.includes("application/json")) {
+      return await res.json();
+    }
+    const text = await res.text();
+    try {
+      return JSON.parse(text);
+    } catch {
+      return text;
+    }
+  }
+  /**
+   * Ingest a file path or raw text into a knowledge graph.
+   *
+   * If `pathOrText` points to an existing file, its contents are read and the
+   * format is inferred from the extension (.csv, .json, .txt) unless
+   * `contentType` is given. CSV files use the two-step schema-inference + row
+   * mapping flow.
+   */
+  async ingest(pathOrText, opts = {}) {
+    let content;
+    let fmt;
+    let isFile = false;
+    try {
+      isFile = existsSync(pathOrText) && statSync(pathOrText).isFile();
+    } catch {
+      isFile = false;
+    }
+    if (isFile) {
+      const ext = extname(pathOrText).toLowerCase();
+      if (ext === ".pdf") {
+        throw new CographError(
+          "PDF ingest not yet supported in the Node CLI; use the Python CLI or POST raw bytes to the API."
+        );
+      }
+      content = readFileSync(pathOrText, "utf-8");
+      fmt = opts.contentType ?? EXT_FORMAT[ext] ?? "text";
+      if (fmt === "csv") {
+        return this.ingestCsv(content, opts.kg);
+      }
+    } else {
+      content = pathOrText;
+      fmt = opts.contentType ?? "text";
+    }
+    const body = {
+      content,
+      content_type: fmt,
+      source: "client"
+    };
+    if (opts.kg) body.kg_name = opts.kg;
+    return this.request("POST", `${this.base()}/ingest`, body, 12e4);
+  }
+  async ingestCsv(content, kgName) {
+    const rows = parseCsv(content);
+    if (rows.length === 0) throw new CographError("CSV is empty");
+    const headers = Object.keys(rows[0]);
+    const schemaBody = {
+      headers,
+      sample_rows: rows.slice(0, 5),
+      total_rows: rows.length
+    };
+    const mapping = await this.request(
+      "POST",
+      `${this.base()}/ingest/csv/schema`,
+      schemaBody,
+      3e5
+    );
+    const batchSize = 50;
+    let totalEntities = 0;
+    let totalTriples = 0;
+    for (let i = 0; i < rows.length; i += batchSize) {
+      const batch = rows.slice(i, i + batchSize);
+      const body = {
+        mapping,
+        rows: batch,
+        source: "client"
+      };
+      if (kgName) body.kg_name = kgName;
+      const result = await this.request("POST", `${this.base()}/ingest/csv/rows`, body, 3e5);
+      totalEntities += result.entities_resolved ?? 0;
+      totalTriples += result.triples_inserted ?? 0;
+    }
+    return {
+      entities_resolved: totalEntities,
+      triples_inserted: totalTriples,
+      mapping
+    };
+  }
+  /** Ask a natural language question and return the parsed response. */
+  async ask(question, opts = {}) {
+    const body = { question };
+    if (opts.kg) body.kg_name = opts.kg;
+    if (opts.model) body.model = opts.model;
+    return this.request("POST", `${this.base()}/ask`, body, 6e4);
+  }
+  /** List all knowledge graphs for the current tenant. */
+  async listKgs() {
+    const data = await this.request(
+      "GET",
+      `${this.base()}/kgs`,
+      void 0,
+      15e3
+    );
+    if (Array.isArray(data)) return data;
+    if (data && typeof data === "object" && "kgs" in data) {
+      const kgs = data.kgs;
+      if (Array.isArray(kgs)) return kgs;
+    }
+    return [];
+  }
+  /** Create a knowledge graph. */
+  async createKg(name, description) {
+    const body = { name };
+    if (description) body.description = description;
+    return this.request("POST", `${this.base()}/kgs`, body, 15e3);
+  }
+  /** Delete a knowledge graph by name. */
+  async deleteKg(name) {
+    return this.request(
+      "DELETE",
+      `${this.base()}/kgs/${encodeURIComponent(name)}`,
+      void 0,
+      3e4
+    );
+  }
+  /** List ontology types. */
+  async ontologyTypes() {
+    const data = await this.request(
+      "GET",
+      `${this.base()}/ontology/types`,
+      void 0,
+      15e3
+    );
+    return Array.isArray(data) ? data : [];
+  }
+};
+
+export {
+  CographError,
+  Client
+};
+//# sourceMappingURL=chunk-YVKKUWD7.js.map

package/dist/chunk-YVKKUWD7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } from \"node:fs\";\nimport { extname } from \"node:path\";\nimport { readConfig } from \"./config.js\";\n\nexport class CographError extends Error {\n  status?: number;\n  body?: string;\n\n  constructor(message: string, opts?: { status?: number; body?: string }) {\n    super(message);\n    this.name = \"CographError\";\n    this.status = opts?.status;\n    this.body = opts?.body;\n  }\n}\n\nexport interface ClientOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  tenant?: string;\n}\n\nexport interface IngestOptions {\n  kg?: string;\n  contentType?: \"text\" | \"csv\" | \"json\" | string;\n}\n\nexport interface AskOptions {\n  kg?: string;\n  model?: string;\n}\n\nfunction envVar(name: string, fallback?: string): string | undefined {\n  // Prefer COGRAPH_, fall back to OMNIX_ so old configs keep working.\n  return (\n    process.env[`COGRAPH_${name}`] ||\n    process.env[`OMNIX_${name}`] ||\n    fallback\n  );\n}\n\nconst EXT_FORMAT: Record<string, string> = {\n  \".csv\": \"csv\",\n  \".json\": \"json\",\n  \".jsonl\": \"json\",\n  \".txt\": \"text\",\n};\n\n/**\n * Parse a CSV string into an array of row objects.\n *\n * Minimal RFC-4180-ish parser: handles quoted fields with commas, escaped\n * quotes (`\"\"`), CRLF/LF line endings. Does not handle BOM stripping or\n * encoding detection — we assume UTF-8 text in.\n */\nexport function parseCsv(content: string): Record<string, string>[] {\n  const rows: string[][] = [];\n  let cur: string[] = [];\n  let field = \"\";\n  let inQuotes = false;\n\n  for (let i = 0; i < content.length; i++) {\n    const ch = content[i];\n    if (inQuotes) {\n      if (ch === '\"') {\n        if (content[i + 1] === '\"') {\n          field += '\"';\n          i++;\n        } else {\n          inQuotes = false;\n        }\n      } else {\n        field += ch;\n      }\n    } else {\n      if (ch === '\"') {\n        inQuotes = true;\n      } else if (ch === \",\") {\n        cur.push(field);\n        field = \"\";\n      } else if (ch === \"\\n\") {\n        cur.push(field);\n        rows.push(cur);\n        cur = [];\n        field = \"\";\n      } else if (ch === \"\\r\") {\n        // swallow; handled by the following \\n in CRLF, or treat lone \\r as line end\n        if (content[i + 1] !== \"\\n\") {\n          cur.push(field);\n          rows.push(cur);\n          cur = [];\n          field = \"\";\n        }\n      } else {\n        field += ch;\n      }\n    }\n  }\n  // flush trailing field/row\n  if (field.length > 0 || cur.length > 0) {\n    cur.push(field);\n    rows.push(cur);\n  }\n\n  if (rows.length === 0) return [];\n  const headers = rows[0]!.map((h) => h.trim());\n  const out: Record<string, string>[] = [];\n  for (let r = 1; r < rows.length; r++) {\n    const row = rows[r]!;\n    // skip blank trailing lines\n    if (row.length === 1 && row[0] === \"\") continue;\n    const obj: Record<string, string> = {};\n    for (let c = 0; c < headers.length; c++) {\n      obj[headers[c]!] = row[c] ?? \"\";\n    }\n    out.push(obj);\n  }\n  return out;\n}\n\nexport class Client {\n  apiKey: string | undefined;\n  baseUrl: string;\n  tenant: string;\n\n  constructor(opts: ClientOptions = {}) {\n    // Resolution order for each field: explicit opts → env var → ~/.cograph/config.json\n    // (written by `cograph login`) → built-in default. Reading the config eagerly\n    // is cheap (small JSON file) and lets users skip env vars entirely after login.\n    const cfg = readConfig();\n    this.apiKey = opts.apiKey ?? envVar(\"API_KEY\") ?? cfg.apiKey;\n    const url =\n      opts.baseUrl ?? envVar(\"API_URL\") ?? cfg.apiUrl ?? \"https://api.cograph.cloud\";\n    this.baseUrl = url.replace(/\\/+$/, \"\");\n    this.tenant = opts.tenant ?? envVar(\"TENANT\") ?? cfg.tenant ?? \"demo-tenant\";\n  }\n\n  private headers(): Record<string, string> {\n    const h: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (this.apiKey) h[\"X-API-Key\"] = this.apiKey;\n    return h;\n  }\n\n  private base(): string {\n    return `${this.baseUrl}/graphs/${this.tenant}`;\n  }\n\n  private async request<T = unknown>(\n    method: string,\n    url: string,\n    body?: unknown,\n    timeoutMs: number = 120_000,\n  ): Promise<T> {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    let res: Response;\n    try {\n      res = await fetch(url, {\n        method,\n        headers: this.headers(),\n        body: body === undefined ? undefined : JSON.stringify(body),\n        signal: controller.signal,\n      });\n    } catch (err) {\n      clearTimeout(timer);\n      if (err instanceof Error && err.name === \"AbortError\") {\n        throw new CographError(`Request to ${url} timed out after ${timeoutMs}ms`);\n      }\n      throw new CographError(\n        `Network error contacting ${url}: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n    clearTimeout(timer);\n\n    if (!res.ok) {\n      let text = \"\";\n      try {\n        text = await res.text();\n      } catch {\n        // ignore\n      }\n      throw new CographError(`HTTP ${res.status}: ${text}`, {\n        status: res.status,\n        body: text,\n      });\n    }\n\n    // 204 No Content\n    if (res.status === 204) return undefined as T;\n\n    const ct = res.headers.get(\"content-type\") ?? \"\";\n    if (ct.includes(\"application/json\")) {\n      return (await res.json()) as T;\n    }\n    // fall back to text\n    const text = await res.text();\n    try {\n      return JSON.parse(text) as T;\n    } catch {\n      return text as unknown as T;\n    }\n  }\n\n  /**\n   * Ingest a file path or raw text into a knowledge graph.\n   *\n   * If `pathOrText` points to an existing file, its contents are read and the\n   * format is inferred from the extension (.csv, .json, .txt) unless\n   * `contentType` is given. CSV files use the two-step schema-inference + row\n   * mapping flow.\n   */\n  async ingest(\n    pathOrText: string,\n    opts: IngestOptions = {},\n  ): Promise<Record<string, unknown>> {\n    let content: string;\n    let fmt: string;\n\n    let isFile = false;\n    try {\n      isFile = existsSync(pathOrText) && statSync(pathOrText).isFile();\n    } catch {\n      isFile = false;\n    }\n\n    if (isFile) {\n      const ext = extname(pathOrText).toLowerCase();\n      if (ext === \".pdf\") {\n        throw new CographError(\n          \"PDF ingest not yet supported in the Node CLI; use the Python CLI or POST raw bytes to the API.\",\n        );\n      }\n      content = readFileSync(pathOrText, \"utf-8\");\n      fmt = opts.contentType ?? EXT_FORMAT[ext] ?? \"text\";\n      if (fmt === \"csv\") {\n        return this.ingestCsv(content, opts.kg);\n      }\n    } else {\n      content = pathOrText;\n      fmt = opts.contentType ?? \"text\";\n    }\n\n    const body: Record<string, unknown> = {\n      content,\n      content_type: fmt,\n      source: \"client\",\n    };\n    if (opts.kg) body.kg_name = opts.kg;\n    return this.request(\"POST\", `${this.base()}/ingest`, body, 120_000);\n  }\n\n  private async ingestCsv(\n    content: string,\n    kgName: string | undefined,\n  ): Promise<Record<string, unknown>> {\n    const rows = parseCsv(content);\n    if (rows.length === 0) throw new CographError(\"CSV is empty\");\n    const headers = Object.keys(rows[0]!);\n\n    const schemaBody = {\n      headers,\n      sample_rows: rows.slice(0, 5),\n      total_rows: rows.length,\n    };\n    const mapping = await this.request<Record<string, unknown>>(\n      \"POST\",\n      `${this.base()}/ingest/csv/schema`,\n      schemaBody,\n      300_000,\n    );\n\n    const batchSize = 50;\n    let totalEntities = 0;\n    let totalTriples = 0;\n    for (let i = 0; i < rows.length; i += batchSize) {\n      const batch = rows.slice(i, i + batchSize);\n      const body: Record<string, unknown> = {\n        mapping,\n        rows: batch,\n        source: \"client\",\n      };\n      if (kgName) body.kg_name = kgName;\n      const result = await this.request<{\n        entities_resolved?: number;\n        triples_inserted?: number;\n      }>(\"POST\", `${this.base()}/ingest/csv/rows`, body, 300_000);\n      totalEntities += result.entities_resolved ?? 0;\n      totalTriples += result.triples_inserted ?? 0;\n    }\n\n    return {\n      entities_resolved: totalEntities,\n      triples_inserted: totalTriples,\n      mapping,\n    };\n  }\n\n  /** Ask a natural language question and return the parsed response. */\n  async ask(\n    question: string,\n    opts: AskOptions = {},\n  ): Promise<Record<string, unknown>> {\n    const body: Record<string, unknown> = { question };\n    if (opts.kg) body.kg_name = opts.kg;\n    if (opts.model) body.model = opts.model;\n    return this.request(\"POST\", `${this.base()}/ask`, body, 60_000);\n  }\n\n  /** List all knowledge graphs for the current tenant. */\n  async listKgs(): Promise<Array<Record<string, unknown>>> {\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/kgs`,\n      undefined,\n      15_000,\n    );\n    if (Array.isArray(data)) return data as Array<Record<string, unknown>>;\n    if (data && typeof data === \"object\" && \"kgs\" in data) {\n      const kgs = (data as { kgs?: unknown }).kgs;\n      if (Array.isArray(kgs)) return kgs as Array<Record<string, unknown>>;\n    }\n    return [];\n  }\n\n  /** Create a knowledge graph. */\n  async createKg(\n    name: string,\n    description?: string,\n  ): Promise<Record<string, unknown>> {\n    const body: Record<string, unknown> = { name };\n    if (description) body.description = description;\n    return this.request(\"POST\", `${this.base()}/kgs`, body, 15_000);\n  }\n\n  /** Delete a knowledge graph by name. */\n  async deleteKg(name: string): Promise<Record<string, unknown>> {\n    return this.request(\n      \"DELETE\",\n      `${this.base()}/kgs/${encodeURIComponent(name)}`,\n      undefined,\n      30_000,\n    );\n  }\n\n  /** List ontology types. */\n  async ontologyTypes(): Promise<Array<Record<string, unknown>>> {\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/ontology/types`,\n      undefined,\n      15_000,\n    );\n    return Array.isArray(data) ? (data as Array<Record<string, unknown>>) : [];\n  }\n}\n"],"mappings":"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","names":["text"]}

package/dist/cli.js

@@ -1,279 +1,13 @@
 #!/usr/bin/env node
+import {
+  Client,
+  CographError
+} from "./chunk-YVKKUWD7.js";
+import "./chunk-7VVBEUZQ.js";
 
 // src/cli.ts
 import { createInterface } from "readline";
 import { Command } from "commander";
-
-// src/client.ts
-import { existsSync, readFileSync, statSync } from "fs";
-import { extname } from "path";
-var CographError = class extends Error {
-  status;
-  body;
-  constructor(message, opts) {
-    super(message);
-    this.name = "CographError";
-    this.status = opts?.status;
-    this.body = opts?.body;
-  }
-};
-function envVar(name, fallback) {
-  return process.env[`COGRAPH_${name}`] || process.env[`OMNIX_${name}`] || fallback;
-}
-var EXT_FORMAT = {
-  ".csv": "csv",
-  ".json": "json",
-  ".jsonl": "json",
-  ".txt": "text"
-};
-function parseCsv(content) {
-  const rows = [];
-  let cur = [];
-  let field = "";
-  let inQuotes = false;
-  for (let i = 0; i < content.length; i++) {
-    const ch = content[i];
-    if (inQuotes) {
-      if (ch === '"') {
-        if (content[i + 1] === '"') {
-          field += '"';
-          i++;
-        } else {
-          inQuotes = false;
-        }
-      } else {
-        field += ch;
-      }
-    } else {
-      if (ch === '"') {
-        inQuotes = true;
-      } else if (ch === ",") {
-        cur.push(field);
-        field = "";
-      } else if (ch === "\n") {
-        cur.push(field);
-        rows.push(cur);
-        cur = [];
-        field = "";
-      } else if (ch === "\r") {
-        if (content[i + 1] !== "\n") {
-          cur.push(field);
-          rows.push(cur);
-          cur = [];
-          field = "";
-        }
-      } else {
-        field += ch;
-      }
-    }
-  }
-  if (field.length > 0 || cur.length > 0) {
-    cur.push(field);
-    rows.push(cur);
-  }
-  if (rows.length === 0) return [];
-  const headers = rows[0].map((h) => h.trim());
-  const out = [];
-  for (let r = 1; r < rows.length; r++) {
-    const row = rows[r];
-    if (row.length === 1 && row[0] === "") continue;
-    const obj = {};
-    for (let c = 0; c < headers.length; c++) {
-      obj[headers[c]] = row[c] ?? "";
-    }
-    out.push(obj);
-  }
-  return out;
-}
-var Client = class {
-  apiKey;
-  baseUrl;
-  tenant;
-  constructor(opts = {}) {
-    this.apiKey = opts.apiKey ?? envVar("API_KEY");
-    const url = opts.baseUrl ?? envVar("API_URL") ?? "https://api.cograph.cloud";
-    this.baseUrl = url.replace(/\/+$/, "");
-    this.tenant = opts.tenant ?? envVar("TENANT") ?? "demo-tenant";
-  }
-  headers() {
-    const h = { "Content-Type": "application/json" };
-    if (this.apiKey) h["X-API-Key"] = this.apiKey;
-    return h;
-  }
-  base() {
-    return `${this.baseUrl}/graphs/${this.tenant}`;
-  }
-  async request(method, url, body, timeoutMs = 12e4) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    let res;
-    try {
-      res = await fetch(url, {
-        method,
-        headers: this.headers(),
-        body: body === void 0 ? void 0 : JSON.stringify(body),
-        signal: controller.signal
-      });
-    } catch (err) {
-      clearTimeout(timer);
-      if (err instanceof Error && err.name === "AbortError") {
-        throw new CographError(`Request to ${url} timed out after ${timeoutMs}ms`);
-      }
-      throw new CographError(
-        `Network error contacting ${url}: ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-    clearTimeout(timer);
-    if (!res.ok) {
-      let text2 = "";
-      try {
-        text2 = await res.text();
-      } catch {
-      }
-      throw new CographError(`HTTP ${res.status}: ${text2}`, {
-        status: res.status,
-        body: text2
-      });
-    }
-    if (res.status === 204) return void 0;
-    const ct = res.headers.get("content-type") ?? "";
-    if (ct.includes("application/json")) {
-      return await res.json();
-    }
-    const text = await res.text();
-    try {
-      return JSON.parse(text);
-    } catch {
-      return text;
-    }
-  }
-  /**
-   * Ingest a file path or raw text into a knowledge graph.
-   *
-   * If `pathOrText` points to an existing file, its contents are read and the
-   * format is inferred from the extension (.csv, .json, .txt) unless
-   * `contentType` is given. CSV files use the two-step schema-inference + row
-   * mapping flow.
-   */
-  async ingest(pathOrText, opts = {}) {
-    let content;
-    let fmt;
-    let isFile = false;
-    try {
-      isFile = existsSync(pathOrText) && statSync(pathOrText).isFile();
-    } catch {
-      isFile = false;
-    }
-    if (isFile) {
-      const ext = extname(pathOrText).toLowerCase();
-      if (ext === ".pdf") {
-        throw new CographError(
-          "PDF ingest not yet supported in the Node CLI; use the Python CLI or POST raw bytes to the API."
-        );
-      }
-      content = readFileSync(pathOrText, "utf-8");
-      fmt = opts.contentType ?? EXT_FORMAT[ext] ?? "text";
-      if (fmt === "csv") {
-        return this.ingestCsv(content, opts.kg);
-      }
-    } else {
-      content = pathOrText;
-      fmt = opts.contentType ?? "text";
-    }
-    const body = {
-      content,
-      content_type: fmt,
-      source: "client"
-    };
-    if (opts.kg) body.kg_name = opts.kg;
-    return this.request("POST", `${this.base()}/ingest`, body, 12e4);
-  }
-  async ingestCsv(content, kgName) {
-    const rows = parseCsv(content);
-    if (rows.length === 0) throw new CographError("CSV is empty");
-    const headers = Object.keys(rows[0]);
-    const schemaBody = {
-      headers,
-      sample_rows: rows.slice(0, 5),
-      total_rows: rows.length
-    };
-    const mapping = await this.request(
-      "POST",
-      `${this.base()}/ingest/csv/schema`,
-      schemaBody,
-      3e5
-    );
-    const batchSize = 50;
-    let totalEntities = 0;
-    let totalTriples = 0;
-    for (let i = 0; i < rows.length; i += batchSize) {
-      const batch = rows.slice(i, i + batchSize);
-      const body = {
-        mapping,
-        rows: batch,
-        source: "client"
-      };
-      if (kgName) body.kg_name = kgName;
-      const result = await this.request("POST", `${this.base()}/ingest/csv/rows`, body, 3e5);
-      totalEntities += result.entities_resolved ?? 0;
-      totalTriples += result.triples_inserted ?? 0;
-    }
-    return {
-      entities_resolved: totalEntities,
-      triples_inserted: totalTriples,
-      mapping
-    };
-  }
-  /** Ask a natural language question and return the parsed response. */
-  async ask(question, opts = {}) {
-    const body = { question };
-    if (opts.kg) body.kg_name = opts.kg;
-    if (opts.model) body.model = opts.model;
-    return this.request("POST", `${this.base()}/ask`, body, 6e4);
-  }
-  /** List all knowledge graphs for the current tenant. */
-  async listKgs() {
-    const data = await this.request(
-      "GET",
-      `${this.base()}/kgs`,
-      void 0,
-      15e3
-    );
-    if (Array.isArray(data)) return data;
-    if (data && typeof data === "object" && "kgs" in data) {
-      const kgs = data.kgs;
-      if (Array.isArray(kgs)) return kgs;
-    }
-    return [];
-  }
-  /** Create a knowledge graph. */
-  async createKg(name, description) {
-    const body = { name };
-    if (description) body.description = description;
-    return this.request("POST", `${this.base()}/kgs`, body, 15e3);
-  }
-  /** Delete a knowledge graph by name. */
-  async deleteKg(name) {
-    return this.request(
-      "DELETE",
-      `${this.base()}/kgs/${encodeURIComponent(name)}`,
-      void 0,
-      3e4
-    );
-  }
-  /** List ontology types. */
-  async ontologyTypes() {
-    const data = await this.request(
-      "GET",
-      `${this.base()}/ontology/types`,
-      void 0,
-      15e3
-    );
-    return Array.isArray(data) ? data : [];
-  }
-};
-
-// src/cli.ts
 function client() {
   return new Client();
 }
@@ -544,6 +278,14 @@ program.command("clear").description("Clear data").option("--kg <name>", "Clear
     });
   }
 );
+program.command("login").description("Sign in via your browser and save an API key").action(async () => {
+  const { runLogin } = await import("./login-Z3IUOAOB.js");
+  await runLogin();
+});
+program.command("shell").description("Start an interactive REPL").option("--kg <name>", "Knowledge graph to use").action(async (opts) => {
+  const { runShell } = await import("./shell-HXPNICDN.js");
+  await runShell({ kg: opts.kg });
+});
 program.parseAsync(process.argv).catch((err) => {
   fail(`Error: ${err instanceof Error ? err.message : String(err)}`);
 });