cograph 0.1.15 → 0.1.16

package/README.md

@@ -2,12 +2,92 @@
 
 Node.js SDK and CLI for [Cograph](https://cograph.cloud) — turn raw data into a queryable knowledge graph.
 
+## Quickstart
+
+```bash
+npx cograph
+```
+
+That's it. The first run opens your browser to sign in, saves a key to `~/.cograph/config.json`, and drops you into the interactive shell:
+
+```text
+  /ingest <file>      Ingest a CSV/JSON/text file
+  /ask <question>     Ask in natural language
+  /kg list|switch|create|delete <name>
+  /types [query]      Types in the active KG, with entity counts
+  /type <name>        Drill into one type — attributes & relationships
+  /enrich <Type> <attrs...>   Plan + run an enrichment job (interactive)
+  /enrich watch <job_id>      Live progress for a running job
+  /enrich jobs                List recent enrichment jobs
+  /enrich review <job_id>     Walk through conflicts and accept/reject
+  /status             Graph stats
+  /login              Re-authenticate
+  /quit
+```
+
+Bare lines (no leading `/`) auto-route to `/ask`. Full walkthrough at [cograph.cloud/docs/quickstart](https://cograph.cloud/docs/quickstart).
+
+## Self-hosted mode
+
+Pointing the CLI at your own backend skips the browser sign-in:
+
+```bash
+cograph --local                         # defaults to http://localhost:8000
+cograph --no-login                      # uses COGRAPH_API_URL env var
+COGRAPH_API_URL=http://my-host:8000 cograph
+```
+
+When self-hosted, the prompt shows the host suffix: `cograph@localhost:8000 (kg) ▸`. Bare `cograph` still triggers the hosted-version login flow.
+
+## Auto-enrichment
+
+Fill and verify attributes on entities of a given type by looking them up in external sources, with a human review step before any write:
+
+```text
+> /enrich LineItem brand manufacturer
+Plan: enrich LineItem.brand, .manufacturer · tier: lite · policy: stage
+Job queued: enr_xxxxxxxx · 12,450 entities
+[████████████████████] filled 6,200 · verified 1,400 · conflicts 320
+Status: review · 320 conflicts pending. Run /enrich review enr_xxxxxxxx
+```
+
+Use `/enrich watch <job_id>` for live progress, `/enrich jobs` to list recent jobs, and `/enrich review <job_id>` to walk through conflicts and accept/reject each one. The `lite` tier uses Wikidata only (free, no API key).
+
 ## Install
 
 ```bash
-npm install cograph
+npm install cograph        # or: npm install -g cograph
+```
+
+Requires Node 20+.
+
+## Browsing what got ingested
+
+After ingest, look around before asking questions:
+
+```text
+cograph (mentors) [37,715] ▸ /types
+  Type           Entities
+  Mentor              988
+  Skill               412
+  Industry             38
+
+cograph (mentors) [37,715] ▸ /type Mentor
+  Mentor  1,000 entities
+
+  Attributes (6)
+    .name           string      988  ( 99%)
+    .level          string      714  ( 71%)
+    ...
+
+  Relationships (6)
+    .title         → JobTitle    988  ( 99%) (+775 string)
+    .skills        → Skill       987  ( 99%)
+    ...
 ```
 
+`/types <query>` filters by substring; `/type <name>` accepts case-insensitive prefix. Auto-attached system metadata (`rdfs:label`, `ingested_at`, `source`) is hidden by default — pass `--system` to see it. The `(+775 string)` annotation appears when the resolver produced both a literal value and a typed-entity link for the same column.
+
 ## SDK
 
 ```ts
@@ -32,14 +112,18 @@ new Client({
 
 ### Methods
 
-- `ingest(pathOrText, { kg?, contentType? })` — auto-detects CSV by extension and uses two-step schema/rows flow; otherwise sends raw content.
+- `ingest(pathOrText, { kg?, contentType? })` — auto-detects CSV by extension and uses the two-step schema/rows flow; otherwise sends raw content.
 - `ask(question, { kg? })` — returns `{ answer, sparql?, ... }`.
-- `listKgs()` — list knowledge graphs.
-- `deleteKg(name)` — delete a knowledge graph.
+- `listKgs()`, `createKg(name, description?)`, `deleteKg(name)` — knowledge-graph CRUD.
+- `ontologyTypes()` — list every type in the tenant ontology with attributes and parents.
+- `typeCounts(kg)` — `[{ name, entity_count }]` for the given KG, sorted desc. Powers `/types`.
+- `typeUsage(kg, name, { includeSystem? })` — full breakdown for one type: attributes (with usage counts), relationships, and 3 sample entities. Powers `/type`. System predicates filtered by default.
 
 All errors throw `CographError`.
 
-## CLI
+## One-shot CLI
+
+For scripts and CI — every command is a single HTTP round-trip:
 
 ```bash
 # List / create / delete knowledge graphs
@@ -62,9 +146,9 @@ npx cograph clear --kg my-data --yes
 
 ### Environment
 
-- `COGRAPH_API_KEY` — required
-- `COGRAPH_API_URL` — default `https://api.cograph.cloud`
-- `COGRAPH_TENANT` — default `demo-tenant`
+- `COGRAPH_API_KEY` — required for headless / CI use; interactive `cograph login` writes one to `~/.cograph/config.json` automatically.
+- `COGRAPH_API_URL` — default `https://api.cograph.cloud`.
+- `COGRAPH_TENANT` — default `demo-tenant`. The login flow sets this to your user ID.
 
 Legacy `OMNIX_*` vars are also accepted.
 

package/dist/{chunk-K45ZTU6U.js → chunk-K7B4PPX2.js}

@@ -103,6 +103,35 @@ var Client = class {
   base() {
     return `${this.baseUrl}/graphs/${this.tenant}`;
   }
+  /**
+   * Probe the backend to determine reachability and whether endpoints
+   * require an X-API-Key header. Used at shell startup to distinguish
+   * cloud (auth required) from self-hosted open-access deployments.
+   */
+  async healthCheck() {
+    const healthUrl = `${this.baseUrl}/health`;
+    try {
+      const res = await fetch(healthUrl, {
+        signal: AbortSignal.timeout(5e3)
+      });
+      if (!res.ok) return { ok: false, requiresAuth: false, url: this.baseUrl };
+    } catch {
+      return { ok: false, requiresAuth: false, url: this.baseUrl };
+    }
+    try {
+      const res = await fetch(`${this.base()}/kgs`, {
+        headers: { "Content-Type": "application/json" },
+        signal: AbortSignal.timeout(5e3)
+      });
+      return {
+        ok: true,
+        requiresAuth: res.status === 401,
+        url: this.baseUrl
+      };
+    } catch {
+      return { ok: true, requiresAuth: true, url: this.baseUrl };
+    }
+  }
   async request(method, url, body, timeoutMs = 12e4) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -319,6 +348,62 @@ var Client = class {
     );
     return Array.isArray(data) ? data : [];
   }
+  /** Plan + run an enrichment job. Returns immediately with the job id. */
+  async enrichRun(req) {
+    return this.request(
+      "POST",
+      `${this.base()}/enrich/jobs`,
+      req,
+      3e4
+    );
+  }
+  /** List recent enrichment jobs for the current tenant. */
+  async enrichJobs() {
+    const data = await this.request(
+      "GET",
+      `${this.base()}/enrich/jobs`,
+      void 0,
+      15e3
+    );
+    return Array.isArray(data) ? data : [];
+  }
+  /** Fetch a single enrichment job (with truncated results). */
+  async enrichJob(jobId) {
+    return this.request(
+      "GET",
+      `${this.base()}/enrich/jobs/${encodeURIComponent(jobId)}`,
+      void 0,
+      15e3
+    );
+  }
+  /** Fetch the conflict review queue for a job. */
+  async enrichConflicts(jobId) {
+    const data = await this.request(
+      "GET",
+      `${this.base()}/enrich/jobs/${encodeURIComponent(jobId)}/conflicts`,
+      void 0,
+      3e4
+    );
+    return Array.isArray(data) ? data : [];
+  }
+  /** Apply a set of conflict review decisions to a job. */
+  async enrichApply(jobId, decisions) {
+    return this.request(
+      "POST",
+      `${this.base()}/enrich/jobs/${encodeURIComponent(jobId)}/apply`,
+      { decisions },
+      6e4
+    );
+  }
+  /** Cancel an enrichment job. */
+  async enrichCancel(jobId) {
+    await this.request(
+      "DELETE",
+      `${this.base()}/enrich/jobs/${encodeURIComponent(jobId)}`,
+      void 0,
+      15e3
+    );
+  }
   /** Per-type breakdown for one type in one KG: definition + counts + samples.
    *
    * System predicates (rdfs:label, ingested_at, source) are hidden by default
@@ -339,4 +424,4 @@ export {
   CographError,
   Client
 };
-//# sourceMappingURL=chunk-K45ZTU6U.js.map
+//# sourceMappingURL=chunk-K7B4PPX2.js.map

package/dist/chunk-K7B4PPX2.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  /** Rows per batch for CSV ingest. Default 200. Larger = fewer round-trips\n   *  but higher per-request memory; 200 is a good balance for typical KGs. */\n  batchSize?: number;\n  /** Max number of batches in flight at once. Default 4. Higher saturates\n   *  the backend faster but risks 429s on large ingests. */\n  concurrency?: number;\n  /** Called after each batch completes during CSV ingest, in batch order.\n   *  Use for progress UI. Not invoked for text/json ingest. */\n  onProgress?: (progress: IngestProgress) => void;\n}\n\nexport interface IngestProgress {\n  rowsProcessed: number;\n  totalRows: number;\n  entitiesResolved: number;\n  triplesInserted: number;\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  /**\n   * Probe the backend to determine reachability and whether endpoints\n   * require an X-API-Key header. Used at shell startup to distinguish\n   * cloud (auth required) from self-hosted open-access deployments.\n   */\n  async healthCheck(): Promise<{\n    ok: boolean;\n    requiresAuth: boolean;\n    url: string;\n  }> {\n    const healthUrl = `${this.baseUrl}/health`;\n    try {\n      const res = await fetch(healthUrl, {\n        signal: AbortSignal.timeout(5000),\n      });\n      if (!res.ok) return { ok: false, requiresAuth: false, url: this.baseUrl };\n    } catch {\n      return { ok: false, requiresAuth: false, url: this.baseUrl };\n    }\n    // Probe whether endpoints require auth by hitting /kgs without X-API-Key.\n    // 401 = requires auth; 200/empty = open access; anything else = treat as\n    // auth-required to be safe.\n    try {\n      const res = await fetch(`${this.base()}/kgs`, {\n        headers: { \"Content-Type\": \"application/json\" },\n        signal: AbortSignal.timeout(5000),\n      });\n      return {\n        ok: true,\n        requiresAuth: res.status === 401,\n        url: this.baseUrl,\n      };\n    } catch {\n      return { ok: true, requiresAuth: true, url: this.baseUrl };\n    }\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);\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    opts: IngestOptions,\n  ): Promise<Record<string, unknown>> {\n    const kgName = opts.kg;\n    const batchSize = opts.batchSize ?? 200;\n    const concurrency = opts.concurrency ?? 4;\n\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    // Pick the rows with the most non-empty fields for schema inference.\n    // Mostly-empty leading rows (e.g. soft-deleted records) otherwise feed\n    // the LLM a near-blank sample and reliably produce malformed JSON.\n    // Stable on ties — original order preserved within equal scores.\n    const sampleRows = rows\n      .map((row, idx) => ({\n        row,\n        idx,\n        score: Object.values(row).filter(\n          (v) => v != null && String(v).trim() !== \"\",\n        ).length,\n      }))\n      .sort((a, b) => b.score - a.score || a.idx - b.idx)\n      .slice(0, 10)\n      .map((s) => s.row);\n\n    const schemaBody = {\n      headers,\n      sample_rows: sampleRows,\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    // Slice rows into batches up front so we can fire them off in a\n    // bounded worker pool. Sequential 50-row batches over 891 rows took\n    // ~60s end-to-end (18 round-trips); 200-row batches × 4 in flight\n    // brings that to ~5s on the same backend.\n    const batches: Array<Record<string, string>[]> = [];\n    for (let i = 0; i < rows.length; i += batchSize) {\n      batches.push(rows.slice(i, i + batchSize));\n    }\n\n    let totalEntities = 0;\n    let totalTriples = 0;\n    let rowsProcessed = 0;\n    let nextBatch = 0;\n\n    const postBatch = async (batch: Record<string, string>[]) => {\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      return {\n        entities: result.entities_resolved ?? 0,\n        triples: result.triples_inserted ?? 0,\n        size: batch.length,\n      };\n    };\n\n    const worker = async (): Promise<void> => {\n      while (true) {\n        const idx = nextBatch++;\n        if (idx >= batches.length) return;\n        const r = await postBatch(batches[idx]!);\n        totalEntities += r.entities;\n        totalTriples += r.triples;\n        rowsProcessed += r.size;\n        opts.onProgress?.({\n          rowsProcessed,\n          totalRows: rows.length,\n          entitiesResolved: totalEntities,\n          triplesInserted: totalTriples,\n        });\n      }\n    };\n\n    const workers: Array<Promise<void>> = [];\n    for (let i = 0; i < Math.min(concurrency, batches.length); i++) {\n      workers.push(worker());\n    }\n    await Promise.all(workers);\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  /** Per-KG type counts: every type with ≥1 instance, sorted desc. */\n  async typeCounts(kg: string): Promise<TypeCount[]> {\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/kgs/${encodeURIComponent(kg)}/type-counts`,\n      undefined,\n      30_000,\n    );\n    return Array.isArray(data) ? (data as TypeCount[]) : [];\n  }\n\n  /** Plan + run an enrichment job. Returns immediately with the job id. */\n  async enrichRun(req: EnrichRequest): Promise<EnrichJobCreate> {\n    return this.request<EnrichJobCreate>(\n      \"POST\",\n      `${this.base()}/enrich/jobs`,\n      req,\n      30_000,\n    );\n  }\n\n  /** List recent enrichment jobs for the current tenant. */\n  async enrichJobs(): Promise<JobSummary[]> {\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/enrich/jobs`,\n      undefined,\n      15_000,\n    );\n    return Array.isArray(data) ? (data as JobSummary[]) : [];\n  }\n\n  /** Fetch a single enrichment job (with truncated results). */\n  async enrichJob(jobId: string): Promise<EnrichJob> {\n    return this.request<EnrichJob>(\n      \"GET\",\n      `${this.base()}/enrich/jobs/${encodeURIComponent(jobId)}`,\n      undefined,\n      15_000,\n    );\n  }\n\n  /** Fetch the conflict review queue for a job. */\n  async enrichConflicts(jobId: string): Promise<ConflictReview[]> {\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/enrich/jobs/${encodeURIComponent(jobId)}/conflicts`,\n      undefined,\n      30_000,\n    );\n    return Array.isArray(data) ? (data as ConflictReview[]) : [];\n  }\n\n  /** Apply a set of conflict review decisions to a job. */\n  async enrichApply(\n    jobId: string,\n    decisions: ConflictReview[],\n  ): Promise<{ applied: number }> {\n    return this.request<{ applied: number }>(\n      \"POST\",\n      `${this.base()}/enrich/jobs/${encodeURIComponent(jobId)}/apply`,\n      { decisions },\n      60_000,\n    );\n  }\n\n  /** Cancel an enrichment job. */\n  async enrichCancel(jobId: string): Promise<void> {\n    await this.request<void>(\n      \"DELETE\",\n      `${this.base()}/enrich/jobs/${encodeURIComponent(jobId)}`,\n      undefined,\n      15_000,\n    );\n  }\n\n  /** Per-type breakdown for one type in one KG: definition + counts + samples.\n   *\n   * System predicates (rdfs:label, ingested_at, source) are hidden by default\n   * — they're attached to every entity at 100% and drown out the columns the\n   * user cares about. Pass `includeSystem: true` to see them. */\n  async typeUsage(\n    kg: string,\n    typeName: string,\n    opts: { includeSystem?: boolean } = {},\n  ): Promise<TypeUsage> {\n    const qs = opts.includeSystem ? \"?include_system=true\" : \"\";\n    return this.request<TypeUsage>(\n      \"GET\",\n      `${this.base()}/kgs/${encodeURIComponent(kg)}/types/${encodeURIComponent(typeName)}/usage${qs}`,\n      undefined,\n      30_000,\n    );\n  }\n}\n\nexport interface TypeCount {\n  name: string;\n  entity_count: number;\n}\n\nexport interface AttributeUsage {\n  name: string;\n  datatype: string;\n  count: number;\n}\n\nexport interface RelationshipUsage {\n  name: string;\n  target_type: string | null;\n  count: number;\n}\n\nexport interface EntitySample {\n  uri: string;\n  label: string;\n}\n\nexport interface TypeUsage {\n  name: string;\n  description: string;\n  parent_type: string | null;\n  entity_count: number;\n  attributes: AttributeUsage[];\n  relationships: RelationshipUsage[];\n  samples: EntitySample[];\n}\n\nexport type EnrichmentTier = \"lite\" | \"base\" | \"core\" | \"pro\";\nexport type JobStatus =\n  | \"queued\"\n  | \"running\"\n  | \"review\"\n  | \"applied\"\n  | \"cancelled\"\n  | \"failed\";\nexport type ConflictPolicy = \"skip\" | \"verify\" | \"overwrite\" | \"stage\";\nexport type RowAction =\n  | \"filled\"\n  | \"verified\"\n  | \"conflict\"\n  | \"skipped\"\n  | \"no_match\";\nexport type ReviewDecision = \"accept\" | \"reject\" | \"skip\";\n\nexport interface EnrichRequest {\n  type_name: string;\n  attributes: string[];\n  tier?: EnrichmentTier;\n  kg_name: string;\n  conflict_policy?: ConflictPolicy;\n  confidence_min?: number;\n  limit?: number;\n}\n\nexport interface EnrichJobCreate {\n  job_id: string;\n  status: JobStatus;\n  estimated_cost_usd: number;\n  total_entities: number;\n}\n\nexport interface Verdict {\n  value: string;\n  confidence: number;\n  source: string;\n  source_url?: string | null;\n  reasoning?: string | null;\n}\n\nexport interface JobProgress {\n  total: number;\n  processed: number;\n  filled: number;\n  verified: number;\n  conflicts: number;\n  skipped: number;\n  cache_hits: number;\n}\n\nexport interface RowResult {\n  entity_uri: string;\n  attribute: string;\n  existing_value: string | null;\n  verdict: Verdict | null;\n  action: RowAction;\n}\n\nexport interface JobSummary {\n  id: string;\n  tenant_id: string;\n  kg_name: string;\n  type_name: string;\n  attributes: string[];\n  tier: EnrichmentTier;\n  status: JobStatus;\n  progress: JobProgress;\n  created_at: string;\n  started_at?: string | null;\n  completed_at?: string | null;\n  conflict_policy: ConflictPolicy;\n  confidence_min: number;\n  error?: string | null;\n}\n\nexport interface EnrichJob extends JobSummary {\n  results?: RowResult[];\n  limit?: number | null;\n}\n\nexport interface ConflictReview {\n  entity_uri: string;\n  attribute: string;\n  existing_value: string;\n  proposed: Verdict;\n  decision?: ReviewDecision | null;\n}\n"],"mappings":"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","names":["text"]}

package/dist/cli.js

@@ -2,12 +2,24 @@
 import {
   Client,
   CographError
-} from "./chunk-K45ZTU6U.js";
+} from "./chunk-K7B4PPX2.js";
 import "./chunk-7VVBEUZQ.js";
 
 // src/cli.ts
 import { createInterface } from "readline";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 import { Command } from "commander";
+function pkgVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf-8"));
+    return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
 function client() {
   return new Client();
 }
@@ -35,9 +47,13 @@ async function confirm(prompt) {
   });
 }
 var program = new Command();
-program.name("cograph").description("Cograph Knowledge Graph CLI").version("0.1.7").action(async () => {
-  const { runShell } = await import("./shell-H2JCK5AT.js");
-  await runShell({});
+program.name("cograph").description("Cograph Knowledge Graph CLI").version(pkgVersion()).option("--local", "Use http://localhost:8000 and skip login (self-hosted)").option("--no-login", "Skip browser login (assume open-access backend)").action(async (opts) => {
+  const { runShell } = await import("./shell-VPPIRJSS.js");
+  await runShell({
+    local: opts.local,
+    // commander's --no-login inverts: opts.login === false when flag passed.
+    noLogin: opts.login === false
+  });
 });
 var kg = program.command("kg").description("Manage knowledge graphs");
 kg.command("list").description("List knowledge graphs").action(async () => {
@@ -285,10 +301,17 @@ program.command("login").description("Sign in via your browser and save an API k
   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-H2JCK5AT.js");
-  await runShell({ kg: opts.kg });
-});
+program.command("shell").description("Start an interactive REPL").option("--kg <name>", "Knowledge graph to use").option("--local", "Use http://localhost:8000 and skip login (self-hosted)").option("--no-login", "Skip browser login (assume open-access backend)").action(
+  async (opts) => {
+    const parentOpts = program.opts();
+    const { runShell } = await import("./shell-VPPIRJSS.js");
+    await runShell({
+      kg: opts.kg,
+      local: opts.local || parentOpts.local,
+      noLogin: opts.login === false || parentOpts.login === false
+    });
+  }
+);
 program.parseAsync(process.argv).catch((err) => {
   fail(`Error: ${err instanceof Error ? err.message : String(err)}`);
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { createInterface } from \"node:readline\";\nimport { Command } from \"commander\";\nimport { Client, CographError } from \"./client.js\";\n\nfunction client(): Client {\n  return new Client();\n}\n\nfunction printJson(data: unknown): void {\n  process.stdout.write(JSON.stringify(data, null, 2) + \"\\n\");\n}\n\nfunction fail(msg: string, code = 1): never {\n  process.stderr.write(msg.endsWith(\"\\n\") ? msg : msg + \"\\n\");\n  process.exit(code);\n}\n\nasync function withErrors<T>(fn: () => Promise<T>): Promise<T | void> {\n  try {\n    return await fn();\n  } catch (err) {\n    if (err instanceof CographError) {\n      fail(`Error: ${err.message}`);\n    }\n    fail(`Error: ${err instanceof Error ? err.message : String(err)}`);\n  }\n}\n\nasync function confirm(prompt: string): Promise<boolean> {\n  const rl = createInterface({ input: process.stdin, output: process.stdout });\n  return new Promise((resolve) => {\n    rl.question(`${prompt} [y/N] `, (ans) => {\n      rl.close();\n      resolve(ans.trim().toLowerCase() === \"y\");\n    });\n  });\n}\n\nconst program = new Command();\nprogram\n  .name(\"cograph\")\n  .description(\"Cograph Knowledge Graph CLI\")\n  .version(\"0.1.7\")\n  // Default action when no subcommand is given: drop into the interactive\n  // shell. So `cograph` (or `npx cograph`) Just Works for the common case;\n  // subcommands like `cograph ingest <file>` still route to their own\n  // actions because commander dispatches subcommands first.\n  .action(async () => {\n    const { runShell } = await import(\"./shell.js\");\n    await runShell({});\n  });\n\n// ---------------------------------------------------------------------------\n// kg\n// ---------------------------------------------------------------------------\n\nconst kg = program.command(\"kg\").description(\"Manage knowledge graphs\");\n\nkg.command(\"list\")\n  .description(\"List knowledge graphs\")\n  .action(async () => {\n    await withErrors(async () => {\n      const kgs = await client().listKgs();\n      if (!kgs.length) {\n        process.stdout.write(\n          \"No knowledge graphs. Create one with: cograph kg create <name>\\n\",\n        );\n        return;\n      }\n      for (const k of kgs) {\n        const name = String(k.name ?? \"?\");\n        const triples = Number(k.triple_count ?? 0);\n        const desc = k.description ? ` — ${k.description}` : \"\";\n        const padName = name.padEnd(20, \" \");\n        const padTriples = String(triples).padStart(6, \" \");\n        process.stdout.write(`  ${padName} ${padTriples} triples${desc}\\n`);\n      }\n    });\n  });\n\nkg.command(\"create <name>\")\n  .description(\"Create a knowledge graph\")\n  .option(\"-d, --description <text>\", \"Description\")\n  .action(async (name: string, opts: { description?: string }) => {\n    await withErrors(async () => {\n      const created = await client().createKg(name, opts.description);\n      process.stdout.write(`Created knowledge graph: ${created.name ?? name}\\n`);\n    });\n  });\n\nkg.command(\"delete <name>\")\n  .description(\"Delete a knowledge graph\")\n  .action(async (name: string) => {\n    await withErrors(async () => {\n      await client().deleteKg(name);\n      process.stdout.write(`Deleted knowledge graph: ${name}\\n`);\n    });\n  });\n\n// ---------------------------------------------------------------------------\n// ingest\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"ingest [file]\")\n  .description(\"Ingest data from a file or --text\")\n  .option(\"-t, --text <text>\", \"Inline text to ingest\")\n  .option(\"--kg <name>\", \"Target knowledge graph name\")\n  .option(\n    \"-f, --format <fmt>\",\n    \"Override format detection (text|csv|json)\",\n  )\n  .action(\n    async (\n      file: string | undefined,\n      opts: { text?: string; kg?: string; format?: string },\n    ) => {\n      await withErrors(async () => {\n        const c = client();\n        if (opts.text) {\n          process.stdout.write(\n            `Ingesting text (${opts.text.length.toLocaleString()} chars)...\\n`,\n          );\n          const result = await c.ingest(opts.text, {\n            kg: opts.kg,\n            contentType: opts.format ?? \"text\",\n          });\n          printIngestResult(result);\n          return;\n        }\n        if (!file) {\n          fail(\"Provide a file or --text\");\n        }\n        // ingest() handles file reading + format detection + CSV two-step flow.\n        process.stdout.write(`Ingesting ${file}...\\n`);\n        const result = await c.ingest(file, {\n          kg: opts.kg,\n          contentType: opts.format,\n        });\n        printIngestResult(result);\n      });\n    },\n  );\n\nfunction printIngestResult(result: Record<string, unknown>): void {\n  const num = (k: string) => Number(result[k] ?? 0);\n  process.stdout.write(`  Entities extracted: ${num(\"entities_extracted\")}\\n`);\n  process.stdout.write(`  Entities resolved:  ${num(\"entities_resolved\")}\\n`);\n  process.stdout.write(`  Triples inserted:   ${num(\"triples_inserted\")}\\n`);\n  const types = result.types_created;\n  if (Array.isArray(types) && types.length) {\n    process.stdout.write(`  Types created:      ${types.join(\", \")}\\n`);\n  }\n  const rejections = result.rejections;\n  if (Array.isArray(rejections) && rejections.length) {\n    process.stdout.write(`  Rejections:         ${rejections.length}\\n`);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// ask\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"ask <question>\")\n  .description(\"Ask a natural language question\")\n  .option(\"--kg <name>\", \"Knowledge graph to query\")\n  .option(\"-d, --debug\", \"Show SPARQL and latency breakdown\")\n  .option(\"-m, --model <model>\", \"Override query model\")\n  .action(\n    async (\n      question: string,\n      opts: { kg?: string; debug?: boolean; model?: string },\n    ) => {\n      await withErrors(async () => {\n        if (opts.model) process.stdout.write(`Model: ${opts.model}\\n`);\n        process.stdout.write(`Q: ${question}\\n`);\n        process.stdout.write(\"Generating answer...\\n\");\n        const t0 = Date.now();\n        const result = await client().ask(question, {\n          kg: opts.kg,\n          model: opts.model,\n        });\n        const roundtripMs = Date.now() - t0;\n        process.stdout.write(`\\nA: ${result.answer ?? \"No answer\"}\\n`);\n        if (opts.debug) {\n          process.stdout.write(`\\nSPARQL:\\n${result.sparql ?? \"\"}\\n`);\n          const timing = (result.timing ?? {}) as Record<string, unknown>;\n          if (Object.keys(timing).length) {\n            process.stdout.write(`\\n${\"─\".repeat(40)}\\n`);\n            process.stdout.write(\n              `${\"Stage\".padEnd(25)} ${\"Time\".padStart(10)}\\n`,\n            );\n            process.stdout.write(`${\"─\".repeat(40)}\\n`);\n            for (const [key, val] of Object.entries(timing)) {\n              if (key === \"attempts\") {\n                process.stdout.write(\n                  `${\"Attempts\".padEnd(25)} ${String(val).padStart(10)}\\n`,\n                );\n              } else if (typeof val === \"string\") {\n                const label = key\n                  .replace(/_/g, \" \")\n                  .replace(/\\b\\w/g, (c) => c.toUpperCase());\n                process.stdout.write(\n                  `${label.padEnd(25)} ${val.padStart(10)}\\n`,\n                );\n              } else {\n                const label = key\n                  .replace(/_ms$/, \"\")\n                  .replace(/_/g, \" \")\n                  .replace(/\\b\\w/g, (c) => c.toUpperCase());\n                const num = typeof val === \"number\" ? val : Number(val);\n                process.stdout.write(\n                  `${label.padEnd(25)} ${num.toFixed(1).padStart(8)}ms\\n`,\n                );\n              }\n            }\n            process.stdout.write(`${\"─\".repeat(40)}\\n`);\n            process.stdout.write(\n              `${\"Client roundtrip\".padEnd(25)} ${roundtripMs.toFixed(1).padStart(8)}ms\\n`,\n            );\n          }\n        }\n      });\n    },\n  );\n\n// ---------------------------------------------------------------------------\n// ontology\n// ---------------------------------------------------------------------------\n\nconst onto = program.command(\"ontology\").description(\"View ontology\");\n\nonto\n  .command(\"types\")\n  .description(\"List ontology types\")\n  .action(async () => {\n    await withErrors(async () => {\n      const types = await client().ontologyTypes();\n      if (!types.length) {\n        process.stdout.write(\"No ontology types defined.\\n\");\n        return;\n      }\n      for (const t of types) {\n        const parent = t.parent_type\n          ? ` (subClassOf ${t.parent_type})`\n          : \"\";\n        const desc = t.description ? ` — ${t.description}` : \"\";\n        process.stdout.write(`  ${t.name}${parent}${desc}\\n`);\n        const attrs = (t.attributes ?? []) as Array<Record<string, unknown>>;\n        for (const a of attrs) {\n          process.stdout.write(\n            `    .${a.name} (${a.datatype ?? \"string\"})\\n`,\n          );\n        }\n      }\n    });\n  });\n\n// ---------------------------------------------------------------------------\n// clear\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"clear\")\n  .description(\"Clear data\")\n  .option(\"--kg <name>\", \"Clear a specific knowledge graph\")\n  .option(\n    \"--include-ontology\",\n    \"Also clear the ontology (only meaningful when --kg is omitted)\",\n    false,\n  )\n  .option(\"-y, --yes\", \"Skip confirmation\", false)\n  .action(\n    async (opts: { kg?: string; includeOntology?: boolean; yes?: boolean }) => {\n      await withErrors(async () => {\n        let msg: string;\n        if (opts.kg) {\n          msg = `Clear KG '${opts.kg}'?`;\n        } else if (opts.includeOntology) {\n          msg = \"Clear EVERYTHING including ontology?\";\n        } else {\n          msg = \"Clear all instance data (ontology preserved)?\";\n        }\n\n        if (!opts.yes) {\n          const ok = await confirm(msg);\n          if (!ok) {\n            process.stdout.write(\"Cancelled.\\n\");\n            return;\n          }\n        }\n\n        const c = client();\n        if (opts.kg) {\n          await c.deleteKg(opts.kg);\n          process.stdout.write(`Cleared KG: ${opts.kg}\\n`);\n          return;\n        }\n\n        // Bulk-clear via /query + DELETE /triples — same loop the Python CLI uses.\n        const tenant = c.tenant;\n        const baseUrl = `${c.baseUrl}/graphs/${tenant}`;\n        const headers: Record<string, string> = {\n          \"Content-Type\": \"application/json\",\n        };\n        if (c.apiKey) headers[\"X-API-Key\"] = c.apiKey;\n\n        const filters = opts.includeOntology\n          ? \"\"\n          : `FILTER(CONTAINS(STR(?s), '/entities/') || CONTAINS(STR(?s), '/onto/') || CONTAINS(STR(?s), '/kgs/'))`;\n        const query = `SELECT ?s ?p ?o FROM <https://cograph.tech/graphs/${tenant}> WHERE { ?s ?p ?o . ${filters} } LIMIT 1000`;\n\n        process.stdout.write(\"Clearing...\\n\");\n        let deleted = 0;\n        for (let i = 0; i < 50; i++) {\n          const fetchRes = await fetch(`${baseUrl}/query`, {\n            method: \"POST\",\n            headers,\n            body: JSON.stringify({ query }),\n          });\n          if (!fetchRes.ok) break;\n          const data = (await fetchRes.json()) as {\n            bindings?: Array<Record<string, unknown>>;\n          };\n          const bindings = data.bindings ?? [];\n          if (!bindings.length) break;\n          const triples = bindings\n            .filter((b) => b.s)\n            .map((b) => ({\n              subject: b.s,\n              predicate: b.p,\n              object: b.o,\n            }));\n          for (let j = 0; j < triples.length; j += 100) {\n            await fetch(`${baseUrl}/triples`, {\n              method: \"DELETE\",\n              headers,\n              body: JSON.stringify({ triples: triples.slice(j, j + 100) }),\n            });\n          }\n          deleted += triples.length;\n        }\n        process.stdout.write(`Deleted ${deleted} triples\\n`);\n      });\n    },\n  );\n\n// ---------------------------------------------------------------------------\n// login\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"login\")\n  .description(\"Sign in via your browser and save an API key\")\n  .action(async () => {\n    const { runLogin } = await import(\"./login.js\");\n    await runLogin();\n  });\n\n// ---------------------------------------------------------------------------\n// shell\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"shell\")\n  .description(\"Start an interactive REPL\")\n  .option(\"--kg <name>\", \"Knowledge graph to use\")\n  .action(async (opts: { kg?: string }) => {\n    const { runShell } = await import(\"./shell.js\");\n    await runShell({ kg: opts.kg });\n  });\n\n// ---------------------------------------------------------------------------\n\nprogram.parseAsync(process.argv).catch((err) => {\n  fail(`Error: ${err instanceof Error ? err.message : String(err)}`);\n});\n\n// silence unused import warning if ever needed\nvoid printJson;\n"],"mappings":"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","names":["result"]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { createInterface } from \"node:readline\";\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { Command } from \"commander\";\nimport { Client, CographError } from \"./client.js\";\n\n// Read version from package.json at runtime so we never drift again.\n// dist/cli.js sits next to package.json once published; in dev (`npm link`)\n// dist/cli.js sits inside packages/cograph/dist/, so the parent dir is the\n// package root either way.\nfunction pkgVersion(): string {\n  try {\n    const here = dirname(fileURLToPath(import.meta.url));\n    const pkg = JSON.parse(readFileSync(join(here, \"..\", \"package.json\"), \"utf-8\"));\n    return typeof pkg.version === \"string\" ? pkg.version : \"0.0.0\";\n  } catch {\n    return \"0.0.0\";\n  }\n}\n\nfunction client(): Client {\n  return new Client();\n}\n\nfunction printJson(data: unknown): void {\n  process.stdout.write(JSON.stringify(data, null, 2) + \"\\n\");\n}\n\nfunction fail(msg: string, code = 1): never {\n  process.stderr.write(msg.endsWith(\"\\n\") ? msg : msg + \"\\n\");\n  process.exit(code);\n}\n\nasync function withErrors<T>(fn: () => Promise<T>): Promise<T | void> {\n  try {\n    return await fn();\n  } catch (err) {\n    if (err instanceof CographError) {\n      fail(`Error: ${err.message}`);\n    }\n    fail(`Error: ${err instanceof Error ? err.message : String(err)}`);\n  }\n}\n\nasync function confirm(prompt: string): Promise<boolean> {\n  const rl = createInterface({ input: process.stdin, output: process.stdout });\n  return new Promise((resolve) => {\n    rl.question(`${prompt} [y/N] `, (ans) => {\n      rl.close();\n      resolve(ans.trim().toLowerCase() === \"y\");\n    });\n  });\n}\n\nconst program = new Command();\nprogram\n  .name(\"cograph\")\n  .description(\"Cograph Knowledge Graph CLI\")\n  .version(pkgVersion())\n  // Default action when no subcommand is given: drop into the interactive\n  // shell. So `cograph` (or `npx cograph`) Just Works for the common case;\n  // subcommands like `cograph ingest <file>` still route to their own\n  // actions because commander dispatches subcommands first.\n  .option(\"--local\", \"Use http://localhost:8000 and skip login (self-hosted)\")\n  .option(\"--no-login\", \"Skip browser login (assume open-access backend)\")\n  .action(async (opts: { local?: boolean; login?: boolean }) => {\n    const { runShell } = await import(\"./shell.js\");\n    await runShell({\n      local: opts.local,\n      // commander's --no-login inverts: opts.login === false when flag passed.\n      noLogin: opts.login === false,\n    });\n  });\n\n// ---------------------------------------------------------------------------\n// kg\n// ---------------------------------------------------------------------------\n\nconst kg = program.command(\"kg\").description(\"Manage knowledge graphs\");\n\nkg.command(\"list\")\n  .description(\"List knowledge graphs\")\n  .action(async () => {\n    await withErrors(async () => {\n      const kgs = await client().listKgs();\n      if (!kgs.length) {\n        process.stdout.write(\n          \"No knowledge graphs. Create one with: cograph kg create <name>\\n\",\n        );\n        return;\n      }\n      for (const k of kgs) {\n        const name = String(k.name ?? \"?\");\n        const triples = Number(k.triple_count ?? 0);\n        const desc = k.description ? ` — ${k.description}` : \"\";\n        const padName = name.padEnd(20, \" \");\n        const padTriples = String(triples).padStart(6, \" \");\n        process.stdout.write(`  ${padName} ${padTriples} triples${desc}\\n`);\n      }\n    });\n  });\n\nkg.command(\"create <name>\")\n  .description(\"Create a knowledge graph\")\n  .option(\"-d, --description <text>\", \"Description\")\n  .action(async (name: string, opts: { description?: string }) => {\n    await withErrors(async () => {\n      const created = await client().createKg(name, opts.description);\n      process.stdout.write(`Created knowledge graph: ${created.name ?? name}\\n`);\n    });\n  });\n\nkg.command(\"delete <name>\")\n  .description(\"Delete a knowledge graph\")\n  .action(async (name: string) => {\n    await withErrors(async () => {\n      await client().deleteKg(name);\n      process.stdout.write(`Deleted knowledge graph: ${name}\\n`);\n    });\n  });\n\n// ---------------------------------------------------------------------------\n// ingest\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"ingest [file]\")\n  .description(\"Ingest data from a file or --text\")\n  .option(\"-t, --text <text>\", \"Inline text to ingest\")\n  .option(\"--kg <name>\", \"Target knowledge graph name\")\n  .option(\n    \"-f, --format <fmt>\",\n    \"Override format detection (text|csv|json)\",\n  )\n  .action(\n    async (\n      file: string | undefined,\n      opts: { text?: string; kg?: string; format?: string },\n    ) => {\n      await withErrors(async () => {\n        const c = client();\n        if (opts.text) {\n          process.stdout.write(\n            `Ingesting text (${opts.text.length.toLocaleString()} chars)...\\n`,\n          );\n          const result = await c.ingest(opts.text, {\n            kg: opts.kg,\n            contentType: opts.format ?? \"text\",\n          });\n          printIngestResult(result);\n          return;\n        }\n        if (!file) {\n          fail(\"Provide a file or --text\");\n        }\n        // ingest() handles file reading + format detection + CSV two-step flow.\n        process.stdout.write(`Ingesting ${file}...\\n`);\n        const result = await c.ingest(file, {\n          kg: opts.kg,\n          contentType: opts.format,\n        });\n        printIngestResult(result);\n      });\n    },\n  );\n\nfunction printIngestResult(result: Record<string, unknown>): void {\n  const num = (k: string) => Number(result[k] ?? 0);\n  process.stdout.write(`  Entities extracted: ${num(\"entities_extracted\")}\\n`);\n  process.stdout.write(`  Entities resolved:  ${num(\"entities_resolved\")}\\n`);\n  process.stdout.write(`  Triples inserted:   ${num(\"triples_inserted\")}\\n`);\n  const types = result.types_created;\n  if (Array.isArray(types) && types.length) {\n    process.stdout.write(`  Types created:      ${types.join(\", \")}\\n`);\n  }\n  const rejections = result.rejections;\n  if (Array.isArray(rejections) && rejections.length) {\n    process.stdout.write(`  Rejections:         ${rejections.length}\\n`);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// ask\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"ask <question>\")\n  .description(\"Ask a natural language question\")\n  .option(\"--kg <name>\", \"Knowledge graph to query\")\n  .option(\"-d, --debug\", \"Show SPARQL and latency breakdown\")\n  .option(\"-m, --model <model>\", \"Override query model\")\n  .action(\n    async (\n      question: string,\n      opts: { kg?: string; debug?: boolean; model?: string },\n    ) => {\n      await withErrors(async () => {\n        if (opts.model) process.stdout.write(`Model: ${opts.model}\\n`);\n        process.stdout.write(`Q: ${question}\\n`);\n        process.stdout.write(\"Generating answer...\\n\");\n        const t0 = Date.now();\n        const result = await client().ask(question, {\n          kg: opts.kg,\n          model: opts.model,\n        });\n        const roundtripMs = Date.now() - t0;\n        process.stdout.write(`\\nA: ${result.answer ?? \"No answer\"}\\n`);\n        if (opts.debug) {\n          process.stdout.write(`\\nSPARQL:\\n${result.sparql ?? \"\"}\\n`);\n          const timing = (result.timing ?? {}) as Record<string, unknown>;\n          if (Object.keys(timing).length) {\n            process.stdout.write(`\\n${\"─\".repeat(40)}\\n`);\n            process.stdout.write(\n              `${\"Stage\".padEnd(25)} ${\"Time\".padStart(10)}\\n`,\n            );\n            process.stdout.write(`${\"─\".repeat(40)}\\n`);\n            for (const [key, val] of Object.entries(timing)) {\n              if (key === \"attempts\") {\n                process.stdout.write(\n                  `${\"Attempts\".padEnd(25)} ${String(val).padStart(10)}\\n`,\n                );\n              } else if (typeof val === \"string\") {\n                const label = key\n                  .replace(/_/g, \" \")\n                  .replace(/\\b\\w/g, (c) => c.toUpperCase());\n                process.stdout.write(\n                  `${label.padEnd(25)} ${val.padStart(10)}\\n`,\n                );\n              } else {\n                const label = key\n                  .replace(/_ms$/, \"\")\n                  .replace(/_/g, \" \")\n                  .replace(/\\b\\w/g, (c) => c.toUpperCase());\n                const num = typeof val === \"number\" ? val : Number(val);\n                process.stdout.write(\n                  `${label.padEnd(25)} ${num.toFixed(1).padStart(8)}ms\\n`,\n                );\n              }\n            }\n            process.stdout.write(`${\"─\".repeat(40)}\\n`);\n            process.stdout.write(\n              `${\"Client roundtrip\".padEnd(25)} ${roundtripMs.toFixed(1).padStart(8)}ms\\n`,\n            );\n          }\n        }\n      });\n    },\n  );\n\n// ---------------------------------------------------------------------------\n// ontology\n// ---------------------------------------------------------------------------\n\nconst onto = program.command(\"ontology\").description(\"View ontology\");\n\nonto\n  .command(\"types\")\n  .description(\"List ontology types\")\n  .action(async () => {\n    await withErrors(async () => {\n      const types = await client().ontologyTypes();\n      if (!types.length) {\n        process.stdout.write(\"No ontology types defined.\\n\");\n        return;\n      }\n      for (const t of types) {\n        const parent = t.parent_type\n          ? ` (subClassOf ${t.parent_type})`\n          : \"\";\n        const desc = t.description ? ` — ${t.description}` : \"\";\n        process.stdout.write(`  ${t.name}${parent}${desc}\\n`);\n        const attrs = (t.attributes ?? []) as Array<Record<string, unknown>>;\n        for (const a of attrs) {\n          process.stdout.write(\n            `    .${a.name} (${a.datatype ?? \"string\"})\\n`,\n          );\n        }\n      }\n    });\n  });\n\n// ---------------------------------------------------------------------------\n// clear\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"clear\")\n  .description(\"Clear data\")\n  .option(\"--kg <name>\", \"Clear a specific knowledge graph\")\n  .option(\n    \"--include-ontology\",\n    \"Also clear the ontology (only meaningful when --kg is omitted)\",\n    false,\n  )\n  .option(\"-y, --yes\", \"Skip confirmation\", false)\n  .action(\n    async (opts: { kg?: string; includeOntology?: boolean; yes?: boolean }) => {\n      await withErrors(async () => {\n        let msg: string;\n        if (opts.kg) {\n          msg = `Clear KG '${opts.kg}'?`;\n        } else if (opts.includeOntology) {\n          msg = \"Clear EVERYTHING including ontology?\";\n        } else {\n          msg = \"Clear all instance data (ontology preserved)?\";\n        }\n\n        if (!opts.yes) {\n          const ok = await confirm(msg);\n          if (!ok) {\n            process.stdout.write(\"Cancelled.\\n\");\n            return;\n          }\n        }\n\n        const c = client();\n        if (opts.kg) {\n          await c.deleteKg(opts.kg);\n          process.stdout.write(`Cleared KG: ${opts.kg}\\n`);\n          return;\n        }\n\n        // Bulk-clear via /query + DELETE /triples — same loop the Python CLI uses.\n        const tenant = c.tenant;\n        const baseUrl = `${c.baseUrl}/graphs/${tenant}`;\n        const headers: Record<string, string> = {\n          \"Content-Type\": \"application/json\",\n        };\n        if (c.apiKey) headers[\"X-API-Key\"] = c.apiKey;\n\n        const filters = opts.includeOntology\n          ? \"\"\n          : `FILTER(CONTAINS(STR(?s), '/entities/') || CONTAINS(STR(?s), '/onto/') || CONTAINS(STR(?s), '/kgs/'))`;\n        const query = `SELECT ?s ?p ?o FROM <https://cograph.tech/graphs/${tenant}> WHERE { ?s ?p ?o . ${filters} } LIMIT 1000`;\n\n        process.stdout.write(\"Clearing...\\n\");\n        let deleted = 0;\n        for (let i = 0; i < 50; i++) {\n          const fetchRes = await fetch(`${baseUrl}/query`, {\n            method: \"POST\",\n            headers,\n            body: JSON.stringify({ query }),\n          });\n          if (!fetchRes.ok) break;\n          const data = (await fetchRes.json()) as {\n            bindings?: Array<Record<string, unknown>>;\n          };\n          const bindings = data.bindings ?? [];\n          if (!bindings.length) break;\n          const triples = bindings\n            .filter((b) => b.s)\n            .map((b) => ({\n              subject: b.s,\n              predicate: b.p,\n              object: b.o,\n            }));\n          for (let j = 0; j < triples.length; j += 100) {\n            await fetch(`${baseUrl}/triples`, {\n              method: \"DELETE\",\n              headers,\n              body: JSON.stringify({ triples: triples.slice(j, j + 100) }),\n            });\n          }\n          deleted += triples.length;\n        }\n        process.stdout.write(`Deleted ${deleted} triples\\n`);\n      });\n    },\n  );\n\n// ---------------------------------------------------------------------------\n// login\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"login\")\n  .description(\"Sign in via your browser and save an API key\")\n  .action(async () => {\n    const { runLogin } = await import(\"./login.js\");\n    await runLogin();\n  });\n\n// ---------------------------------------------------------------------------\n// shell\n// ---------------------------------------------------------------------------\n\nprogram\n  .command(\"shell\")\n  .description(\"Start an interactive REPL\")\n  .option(\"--kg <name>\", \"Knowledge graph to use\")\n  .option(\"--local\", \"Use http://localhost:8000 and skip login (self-hosted)\")\n  .option(\"--no-login\", \"Skip browser login (assume open-access backend)\")\n  .action(\n    async (opts: { kg?: string; local?: boolean; login?: boolean }) => {\n      // Parent program also accepts --local/--no-login (so `cograph --local`\n      // works without a subcommand). When commander parses\n      // `cograph shell --local`, the parent sees --local first and the\n      // subcommand never gets it — so merge from program.opts() too.\n      const parentOpts = program.opts() as {\n        local?: boolean;\n        login?: boolean;\n      };\n      const { runShell } = await import(\"./shell.js\");\n      await runShell({\n        kg: opts.kg,\n        local: opts.local || parentOpts.local,\n        noLogin: opts.login === false || parentOpts.login === false,\n      });\n    },\n  );\n\n// ---------------------------------------------------------------------------\n\nprogram.parseAsync(process.argv).catch((err) => {\n  fail(`Error: ${err instanceof Error ? err.message : String(err)}`);\n});\n\n// silence unused import warning if ever needed\nvoid printJson;\n"],"mappings":"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","names":["result"]}

package/dist/index.d.ts

@@ -41,6 +41,16 @@ declare class Client {
     constructor(opts?: ClientOptions);
     private headers;
     private base;
+    /**
+     * Probe the backend to determine reachability and whether endpoints
+     * require an X-API-Key header. Used at shell startup to distinguish
+     * cloud (auth required) from self-hosted open-access deployments.
+     */
+    healthCheck(): Promise<{
+        ok: boolean;
+        requiresAuth: boolean;
+        url: string;
+    }>;
     private request;
     /**
      * Ingest a file path or raw text into a knowledge graph.
@@ -64,6 +74,20 @@ declare class Client {
     ontologyTypes(): Promise<Array<Record<string, unknown>>>;
     /** Per-KG type counts: every type with ≥1 instance, sorted desc. */
     typeCounts(kg: string): Promise<TypeCount[]>;
+    /** Plan + run an enrichment job. Returns immediately with the job id. */
+    enrichRun(req: EnrichRequest): Promise<EnrichJobCreate>;
+    /** List recent enrichment jobs for the current tenant. */
+    enrichJobs(): Promise<JobSummary[]>;
+    /** Fetch a single enrichment job (with truncated results). */
+    enrichJob(jobId: string): Promise<EnrichJob>;
+    /** Fetch the conflict review queue for a job. */
+    enrichConflicts(jobId: string): Promise<ConflictReview[]>;
+    /** Apply a set of conflict review decisions to a job. */
+    enrichApply(jobId: string, decisions: ConflictReview[]): Promise<{
+        applied: number;
+    }>;
+    /** Cancel an enrichment job. */
+    enrichCancel(jobId: string): Promise<void>;
     /** Per-type breakdown for one type in one KG: definition + counts + samples.
      *
      * System predicates (rdfs:label, ingested_at, source) are hidden by default
@@ -100,5 +124,75 @@ interface TypeUsage {
     relationships: RelationshipUsage[];
     samples: EntitySample[];
 }
+type EnrichmentTier = "lite" | "base" | "core" | "pro";
+type JobStatus = "queued" | "running" | "review" | "applied" | "cancelled" | "failed";
+type ConflictPolicy = "skip" | "verify" | "overwrite" | "stage";
+type RowAction = "filled" | "verified" | "conflict" | "skipped" | "no_match";
+type ReviewDecision = "accept" | "reject" | "skip";
+interface EnrichRequest {
+    type_name: string;
+    attributes: string[];
+    tier?: EnrichmentTier;
+    kg_name: string;
+    conflict_policy?: ConflictPolicy;
+    confidence_min?: number;
+    limit?: number;
+}
+interface EnrichJobCreate {
+    job_id: string;
+    status: JobStatus;
+    estimated_cost_usd: number;
+    total_entities: number;
+}
+interface Verdict {
+    value: string;
+    confidence: number;
+    source: string;
+    source_url?: string | null;
+    reasoning?: string | null;
+}
+interface JobProgress {
+    total: number;
+    processed: number;
+    filled: number;
+    verified: number;
+    conflicts: number;
+    skipped: number;
+    cache_hits: number;
+}
+interface RowResult {
+    entity_uri: string;
+    attribute: string;
+    existing_value: string | null;
+    verdict: Verdict | null;
+    action: RowAction;
+}
+interface JobSummary {
+    id: string;
+    tenant_id: string;
+    kg_name: string;
+    type_name: string;
+    attributes: string[];
+    tier: EnrichmentTier;
+    status: JobStatus;
+    progress: JobProgress;
+    created_at: string;
+    started_at?: string | null;
+    completed_at?: string | null;
+    conflict_policy: ConflictPolicy;
+    confidence_min: number;
+    error?: string | null;
+}
+interface EnrichJob extends JobSummary {
+    results?: RowResult[];
+    limit?: number | null;
+}
+interface ConflictReview {
+    entity_uri: string;
+    attribute: string;
+    existing_value: string;
+    proposed: Verdict;
+    decision?: ReviewDecision | null;
+}
 
-export { type AskOptions, Client, type ClientOptions, CographError, type IngestOptions };
+export { type AskOptions, Client, type ClientOptions, CographError, type ConflictPolicy, type ConflictReview, type EnrichJob, type EnrichJobCreate, type EnrichRequest, type EnrichmentTier, type IngestOptions, type JobProgress, type JobStatus, type JobSummary, type ReviewDecision, type RowAction, type RowResult, type Verdict };