cograph 0.1.22 → 0.1.23

package/README.md

@@ -116,6 +116,8 @@ new Client({
 - `ask(question, { kg? })` — returns `{ answer, sparql?, ... }`.
 - `listKgs()`, `createKg(name, description?)`, `deleteKg(name)` — knowledge-graph CRUD.
 - `ontologyTypes()` — list every type in the tenant ontology with attributes and parents.
+- `ontologyResolve(ask, { knowledge_graph? })` — resolve a fuzzy natural-language ontology-evolution ask (no exact type/attribute/relationship names needed) against the current schema. Returns `{ applied, proposals, summary }`; high-confidence changes land automatically, ambiguous/new-type ones come back as `proposals`.
+- `ontologyApply(proposal)` — confirm and commit a single `ResolvedChange` from `ontologyResolve`'s `proposals`. Pass the object through unchanged; returns `{ applied, operations, summary }`.
 - `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.
 

package/dist/{chunk-X7YVTWAD.js → chunk-RBRPNURW.js}

@@ -349,6 +349,34 @@ var Client = class {
     );
     return Array.isArray(data) ? data : [];
   }
+  /**
+   * Resolve a natural-language ontology change against the existing ontology.
+   * The caller does not need to know exact type/attribute/relationship names —
+   * the server matches the plain-language `ask` to the current schema and
+   * returns auto-applied changes plus proposals that need confirmation.
+   */
+  async ontologyResolve(ask, opts = {}) {
+    const body = { ask };
+    if (opts.knowledge_graph) body.knowledge_graph = opts.knowledge_graph;
+    return this.request(
+      "POST",
+      `${this.base()}/ontology/resolve`,
+      body,
+      6e4
+    );
+  }
+  /**
+   * Apply a single resolved ontology change — one of the `proposals` returned
+   * by {@link ontologyResolve}. Pass the proposal object through unchanged.
+   */
+  async ontologyApply(proposal) {
+    return this.request(
+      "POST",
+      `${this.base()}/ontology/apply`,
+      proposal,
+      6e4
+    );
+  }
   /**
    * Second-pass entity resolution: re-run ER over an already-ingested KG to
    * collapse intra-batch fragments. Synchronous on the server; returns a
@@ -468,4 +496,4 @@ export {
   CographError,
   Client
 };
-//# sourceMappingURL=chunk-X7YVTWAD.js.map
+//# sourceMappingURL=chunk-RBRPNURW.js.map

package/dist/{chunk-X7YVTWAD.js.map → chunk-RBRPNURW.js.map}

@@ -1 +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    // All batches are in — kick off a background recompute of the Explorer\n    // type-stats for this KG so type-detail views load instantly. The endpoint\n    // returns immediately (the scan runs server-side in the background); this\n    // is best-effort and never fails the ingest.\n    if (kgName) {\n      try {\n        await this.request(\n          \"POST\",\n          `${this.base()}/explore/kgs/${encodeURIComponent(kgName)}/recompute-stats`,\n          {},\n          15_000,\n        );\n      } catch {\n        // non-fatal — stats fall back to a live scan until the next recompute\n      }\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  /**\n   * Second-pass entity resolution: re-run ER over an already-ingested KG to\n   * collapse intra-batch fragments. Synchronous on the server; returns a\n   * per-type before/after report. Generous timeout — it rewrites triples.\n   */\n  async erRebuild(kg: string): Promise<Record<string, unknown>> {\n    return this.request<Record<string, unknown>>(\n      \"POST\",\n      `${this.base()}/explore/kgs/${encodeURIComponent(kg)}/er-rebuild`,\n      {},\n      300_000,\n    );\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  /** Explorer summary for a type — like typeUsage but adds coverage_pct + avg_degree. */\n  async typeSummary(kg: string, typeName: string): Promise<TypeSummary> {\n    return this.request<TypeSummary>(\n      \"GET\",\n      `${this.base()}/explore/kgs/${encodeURIComponent(kg)}/types/${encodeURIComponent(typeName)}/summary`,\n      undefined,\n      30_000,\n    );\n  }\n\n  /** Search types or attributes by name substring within a KG. */\n  async exploreSearch(\n    kg: string,\n    q: string,\n    kind: \"type\" | \"attr\" = \"type\",\n  ): Promise<Array<Record<string, unknown>>> {\n    const qs = new URLSearchParams({ kg, q, kind }).toString();\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/explore/search?${qs}`,\n      undefined,\n      15_000,\n    );\n    return Array.isArray(data) ? (data as Array<Record<string, unknown>>) : [];\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 interface AttributeSummary {\n  name: string;\n  predicate_uri: string;\n  datatype: string;\n  count: number;\n  coverage_pct: number;\n}\n\nexport interface RelationshipSummary {\n  name: string;\n  predicate_uri: string;\n  target_type: string | null;\n  count: number;\n  coverage_pct: number;\n  avg_degree: number;\n}\n\nexport interface TypeSummary {\n  name: string;\n  description: string;\n  parent_type: string | null;\n  entity_count: number;\n  attributes: AttributeSummary[];\n  relationships: RelationshipSummary[];\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"]}
+{"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    // All batches are in — kick off a background recompute of the Explorer\n    // type-stats for this KG so type-detail views load instantly. The endpoint\n    // returns immediately (the scan runs server-side in the background); this\n    // is best-effort and never fails the ingest.\n    if (kgName) {\n      try {\n        await this.request(\n          \"POST\",\n          `${this.base()}/explore/kgs/${encodeURIComponent(kgName)}/recompute-stats`,\n          {},\n          15_000,\n        );\n      } catch {\n        // non-fatal — stats fall back to a live scan until the next recompute\n      }\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  /**\n   * Resolve a natural-language ontology change against the existing ontology.\n   * The caller does not need to know exact type/attribute/relationship names —\n   * the server matches the plain-language `ask` to the current schema and\n   * returns auto-applied changes plus proposals that need confirmation.\n   */\n  async ontologyResolve(\n    ask: string,\n    opts: { knowledge_graph?: string } = {},\n  ): Promise<OntologyResolveResult> {\n    const body: Record<string, unknown> = { ask };\n    if (opts.knowledge_graph) body.knowledge_graph = opts.knowledge_graph;\n    return this.request<OntologyResolveResult>(\n      \"POST\",\n      `${this.base()}/ontology/resolve`,\n      body,\n      60_000,\n    );\n  }\n\n  /**\n   * Apply a single resolved ontology change — one of the `proposals` returned\n   * by {@link ontologyResolve}. Pass the proposal object through unchanged.\n   */\n  async ontologyApply(\n    proposal: ResolvedChange,\n  ): Promise<OntologyApplyResult> {\n    return this.request<OntologyApplyResult>(\n      \"POST\",\n      `${this.base()}/ontology/apply`,\n      proposal,\n      60_000,\n    );\n  }\n\n  /**\n   * Second-pass entity resolution: re-run ER over an already-ingested KG to\n   * collapse intra-batch fragments. Synchronous on the server; returns a\n   * per-type before/after report. Generous timeout — it rewrites triples.\n   */\n  async erRebuild(kg: string): Promise<Record<string, unknown>> {\n    return this.request<Record<string, unknown>>(\n      \"POST\",\n      `${this.base()}/explore/kgs/${encodeURIComponent(kg)}/er-rebuild`,\n      {},\n      300_000,\n    );\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  /** Explorer summary for a type — like typeUsage but adds coverage_pct + avg_degree. */\n  async typeSummary(kg: string, typeName: string): Promise<TypeSummary> {\n    return this.request<TypeSummary>(\n      \"GET\",\n      `${this.base()}/explore/kgs/${encodeURIComponent(kg)}/types/${encodeURIComponent(typeName)}/summary`,\n      undefined,\n      30_000,\n    );\n  }\n\n  /** Search types or attributes by name substring within a KG. */\n  async exploreSearch(\n    kg: string,\n    q: string,\n    kind: \"type\" | \"attr\" = \"type\",\n  ): Promise<Array<Record<string, unknown>>> {\n    const qs = new URLSearchParams({ kg, q, kind }).toString();\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/explore/search?${qs}`,\n      undefined,\n      15_000,\n    );\n    return Array.isArray(data) ? (data as Array<Record<string, unknown>>) : [];\n  }\n}\n\n/**\n * A single ontology change resolved against the existing schema. The same\n * shape is returned under `applied`/`proposals` by {@link Client.ontologyResolve}\n * and accepted as the request body by {@link Client.ontologyApply}.\n */\nexport interface ResolvedChange {\n  kind: \"attribute\" | \"relationship\";\n  subject_type: string;\n  name: string;\n  datatype_or_target: string;\n  action: \"reuse\" | \"extend\" | \"create\";\n  confidence: number;\n  reason: string;\n}\n\nexport interface OntologyResolveResult {\n  applied: ResolvedChange[];\n  proposals: ResolvedChange[];\n  summary: string;\n}\n\nexport interface OntologyApplyResult {\n  applied: ResolvedChange;\n  operations: number;\n  summary: string;\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 interface AttributeSummary {\n  name: string;\n  predicate_uri: string;\n  datatype: string;\n  count: number;\n  coverage_pct: number;\n}\n\nexport interface RelationshipSummary {\n  name: string;\n  predicate_uri: string;\n  target_type: string | null;\n  count: number;\n  coverage_pct: number;\n  avg_degree: number;\n}\n\nexport interface TypeSummary {\n  name: string;\n  description: string;\n  parent_type: string | null;\n  entity_count: number;\n  attributes: AttributeSummary[];\n  relationships: RelationshipSummary[];\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":";;;;;;AAAA,SAAS,YAAY,cAAc,gBAAgB;AACnD,SAAS,eAAe;AAGjB,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAA2C;AACtE,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS,MAAM;AACpB,SAAK,OAAO,MAAM;AAAA,EACpB;AACF;AAkCA,SAAS,OAAO,MAAc,UAAuC;AAEnE,SACE,QAAQ,IAAI,WAAW,IAAI,EAAE,KAC7B,QAAQ,IAAI,SAAS,IAAI,EAAE,KAC3B;AAEJ;AAEA,IAAM,aAAqC;AAAA,EACzC,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,QAAQ;AACV;AASO,SAAS,SAAS,SAA2C;AAClE,QAAM,OAAmB,CAAC;AAC1B,MAAI,MAAgB,CAAC;AACrB,MAAI,QAAQ;AACZ,MAAI,WAAW;AAEf,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,UAAM,KAAK,QAAQ,CAAC;AACpB,QAAI,UAAU;AACZ,UAAI,OAAO,KAAK;AACd,YAAI,QAAQ,IAAI,CAAC,MAAM,KAAK;AAC1B,mBAAS;AACT;AAAA,QACF,OAAO;AACL,qBAAW;AAAA,QACb;AAAA,MACF,OAAO;AACL,iBAAS;AAAA,MACX;AAAA,IACF,OAAO;AACL,UAAI,OAAO,KAAK;AACd,mBAAW;AAAA,MACb,WAAW,OAAO,KAAK;AACrB,YAAI,KAAK,KAAK;AACd,gBAAQ;AAAA,MACV,WAAW,OAAO,MAAM;AACtB,YAAI,KAAK,KAAK;AACd,aAAK,KAAK,GAAG;AACb,cAAM,CAAC;AACP,gBAAQ;AAAA,MACV,WAAW,OAAO,MAAM;AAEtB,YAAI,QAAQ,IAAI,CAAC,MAAM,MAAM;AAC3B,cAAI,KAAK,KAAK;AACd,eAAK,KAAK,GAAG;AACb,gBAAM,CAAC;AACP,kBAAQ;AAAA,QACV;AAAA,MACF,OAAO;AACL,iBAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,KAAK,IAAI,SAAS,GAAG;AACtC,QAAI,KAAK,KAAK;AACd,SAAK,KAAK,GAAG;AAAA,EACf;AAEA,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAC/B,QAAM,UAAU,KAAK,CAAC,EAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AAC5C,QAAM,MAAgC,CAAC;AACvC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAElB,QAAI,IAAI,WAAW,KAAK,IAAI,CAAC,MAAM,GAAI;AACvC,UAAM,MAA8B,CAAC;AACrC,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,UAAI,QAAQ,CAAC,CAAE,IAAI,IAAI,CAAC,KAAK;AAAA,IAC/B;AACA,QAAI,KAAK,GAAG;AAAA,EACd;AACA,SAAO;AACT;AAEO,IAAM,SAAN,MAAa;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,OAAsB,CAAC,GAAG;AAIpC,UAAM,MAAM,WAAW;AACvB,SAAK,SAAS,KAAK,UAAU,OAAO,SAAS,KAAK,IAAI;AACtD,UAAM,MACJ,KAAK,WAAW,OAAO,SAAS,KAAK,IAAI,UAAU;AACrD,SAAK,UAAU,IAAI,QAAQ,QAAQ,EAAE;AACrC,SAAK,SAAS,KAAK,UAAU,OAAO,QAAQ,KAAK,IAAI,UAAU;AAAA,EACjE;AAAA,EAEQ,UAAkC;AACxC,UAAM,IAA4B,EAAE,gBAAgB,mBAAmB;AACvE,QAAI,KAAK,OAAQ,GAAE,WAAW,IAAI,KAAK;AACvC,WAAO;AAAA,EACT;AAAA,EAEQ,OAAe;AACrB,WAAO,GAAG,KAAK,OAAO,WAAW,KAAK,MAAM;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,cAIH;AACD,UAAM,YAAY,GAAG,KAAK,OAAO;AACjC,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,WAAW;AAAA,QACjC,QAAQ,YAAY,QAAQ,GAAI;AAAA,MAClC,CAAC;AACD,UAAI,CAAC,IAAI,GAAI,QAAO,EAAE,IAAI,OAAO,cAAc,OAAO,KAAK,KAAK,QAAQ;AAAA,IAC1E,QAAQ;AACN,aAAO,EAAE,IAAI,OAAO,cAAc,OAAO,KAAK,KAAK,QAAQ;AAAA,IAC7D;AAIA,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,QAAQ;AAAA,QAC5C,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,QAC9C,QAAQ,YAAY,QAAQ,GAAI;AAAA,MAClC,CAAC;AACD,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,cAAc,IAAI,WAAW;AAAA,QAC7B,KAAK,KAAK;AAAA,MACZ;AAAA,IACF,QAAQ;AACN,aAAO,EAAE,IAAI,MAAM,cAAc,MAAM,KAAK,KAAK,QAAQ;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAc,QACZ,QACA,KACA,MACA,YAAoB,MACR;AACZ,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS;AAC5D,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,MAAM,KAAK;AAAA,QACrB;AAAA,QACA,SAAS,KAAK,QAAQ;AAAA,QACtB,MAAM,SAAS,SAAY,SAAY,KAAK,UAAU,IAAI;AAAA,QAC1D,QAAQ,WAAW;AAAA,MACrB,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,mBAAa,KAAK;AAClB,UAAI,eAAe,SAAS,IAAI,SAAS,cAAc;AACrD,cAAM,IAAI,aAAa,cAAc,GAAG,oBAAoB,SAAS,IAAI;AAAA,MAC3E;AACA,YAAM,IAAI;AAAA,QACR,4BAA4B,GAAG,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,MACtF;AAAA,IACF;AACA,iBAAa,KAAK;AAElB,QAAI,CAAC,IAAI,IAAI;AACX,UAAIA,QAAO;AACX,UAAI;AACF,QAAAA,QAAO,MAAM,IAAI,KAAK;AAAA,MACxB,QAAQ;AAAA,MAER;AACA,YAAM,IAAI,aAAa,QAAQ,IAAI,MAAM,KAAKA,KAAI,IAAI;AAAA,QACpD,QAAQ,IAAI;AAAA,QACZ,MAAMA;AAAA,MACR,CAAC;AAAA,IACH;AAGA,QAAI,IAAI,WAAW,IAAK,QAAO;AAE/B,UAAM,KAAK,IAAI,QAAQ,IAAI,cAAc,KAAK;AAC9C,QAAI,GAAG,SAAS,kBAAkB,GAAG;AACnC,aAAQ,MAAM,IAAI,KAAK;AAAA,IACzB;AAEA,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAI;AACF,aAAO,KAAK,MAAM,IAAI;AAAA,IACxB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OACJ,YACA,OAAsB,CAAC,GACW;AAClC,QAAI;AACJ,QAAI;AAEJ,QAAI,SAAS;AACb,QAAI;AACF,eAAS,WAAW,UAAU,KAAK,SAAS,UAAU,EAAE,OAAO;AAAA,IACjE,QAAQ;AACN,eAAS;AAAA,IACX;AAEA,QAAI,QAAQ;AACV,YAAM,MAAM,QAAQ,UAAU,EAAE,YAAY;AAC5C,UAAI,QAAQ,QAAQ;AAClB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,gBAAU,aAAa,YAAY,OAAO;AAC1C,YAAM,KAAK,eAAe,WAAW,GAAG,KAAK;AAC7C,UAAI,QAAQ,OAAO;AACjB,eAAO,KAAK,UAAU,SAAS,IAAI;AAAA,MACrC;AAAA,IACF,OAAO;AACL,gBAAU;AACV,YAAM,KAAK,eAAe;AAAA,IAC5B;AAEA,UAAM,OAAgC;AAAA,MACpC;AAAA,MACA,cAAc;AAAA,MACd,QAAQ;AAAA,IACV;AACA,QAAI,KAAK,GAAI,MAAK,UAAU,KAAK;AACjC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,WAAW,MAAM,IAAO;AAAA,EACpE;AAAA,EAEA,MAAc,UACZ,SACA,MACkC;AAClC,UAAM,SAAS,KAAK;AACpB,UAAM,YAAY,KAAK,aAAa;AACpC,UAAM,cAAc,KAAK,eAAe;AAExC,UAAM,OAAO,SAAS,OAAO;AAC7B,QAAI,KAAK,WAAW,EAAG,OAAM,IAAI,aAAa,cAAc;AAC5D,UAAM,UAAU,OAAO,KAAK,KAAK,CAAC,CAAE;AAMpC,UAAM,aAAa,KAChB,IAAI,CAAC,KAAK,SAAS;AAAA,MAClB;AAAA,MACA;AAAA,MACA,OAAO,OAAO,OAAO,GAAG,EAAE;AAAA,QACxB,CAAC,MAAM,KAAK,QAAQ,OAAO,CAAC,EAAE,KAAK,MAAM;AAAA,MAC3C,EAAE;AAAA,IACJ,EAAE,EACD,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EACjD,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,MAAM,EAAE,GAAG;AAEnB,UAAM,aAAa;AAAA,MACjB;AAAA,MACA,aAAa;AAAA,MACb,YAAY,KAAK;AAAA,IACnB;AACA,UAAM,UAAU,MAAM,KAAK;AAAA,MACzB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAMA,UAAM,UAA2C,CAAC;AAClD,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,WAAW;AAC/C,cAAQ,KAAK,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC;AAAA,IAC3C;AAEA,QAAI,gBAAgB;AACpB,QAAI,eAAe;AACnB,QAAI,gBAAgB;AACpB,QAAI,YAAY;AAEhB,UAAM,YAAY,OAAO,UAAoC;AAC3D,YAAM,OAAgC;AAAA,QACpC;AAAA,QACA,MAAM;AAAA,QACN,QAAQ;AAAA,MACV;AACA,UAAI,OAAQ,MAAK,UAAU;AAC3B,YAAM,SAAS,MAAM,KAAK,QAGvB,QAAQ,GAAG,KAAK,KAAK,CAAC,oBAAoB,MAAM,GAAO;AAC1D,aAAO;AAAA,QACL,UAAU,OAAO,qBAAqB;AAAA,QACtC,SAAS,OAAO,oBAAoB;AAAA,QACpC,MAAM,MAAM;AAAA,MACd;AAAA,IACF;AAEA,UAAM,SAAS,YAA2B;AACxC,aAAO,MAAM;AACX,cAAM,MAAM;AACZ,YAAI,OAAO,QAAQ,OAAQ;AAC3B,cAAM,IAAI,MAAM,UAAU,QAAQ,GAAG,CAAE;AACvC,yBAAiB,EAAE;AACnB,wBAAgB,EAAE;AAClB,yBAAiB,EAAE;AACnB,aAAK,aAAa;AAAA,UAChB;AAAA,UACA,WAAW,KAAK;AAAA,UAChB,kBAAkB;AAAA,UAClB,iBAAiB;AAAA,QACnB,CAAC;AAAA,MACH;AAAA,IACF;AAEA,UAAM,UAAgC,CAAC;AACvC,aAAS,IAAI,GAAG,IAAI,KAAK,IAAI,aAAa,QAAQ,MAAM,GAAG,KAAK;AAC9D,cAAQ,KAAK,OAAO,CAAC;AAAA,IACvB;AACA,UAAM,QAAQ,IAAI,OAAO;AAMzB,QAAI,QAAQ;AACV,UAAI;AACF,cAAM,KAAK;AAAA,UACT;AAAA,UACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,MAAM,CAAC;AAAA,UACxD,CAAC;AAAA,UACD;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,kBAAkB;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,IACJ,UACA,OAAmB,CAAC,GACc;AAClC,UAAM,OAAgC,EAAE,SAAS;AACjD,QAAI,KAAK,GAAI,MAAK,UAAU,KAAK;AACjC,QAAI,KAAK,MAAO,MAAK,QAAQ,KAAK;AAClC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,QAAQ,MAAM,GAAM;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,UAAmD;AACvD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,QAAI,MAAM,QAAQ,IAAI,EAAG,QAAO;AAChC,QAAI,QAAQ,OAAO,SAAS,YAAY,SAAS,MAAM;AACrD,YAAM,MAAO,KAA2B;AACxC,UAAI,MAAM,QAAQ,GAAG,EAAG,QAAO;AAAA,IACjC;AACA,WAAO,CAAC;AAAA,EACV;AAAA;AAAA,EAGA,MAAM,SACJ,MACA,aACkC;AAClC,UAAM,OAAgC,EAAE,KAAK;AAC7C,QAAI,YAAa,MAAK,cAAc;AACpC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,QAAQ,MAAM,IAAM;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,SAAS,MAAgD;AAC7D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,IAAI,CAAC;AAAA,MAC9C;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,gBAAyD;AAC7D,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA0C,CAAC;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,gBACJ,KACA,OAAqC,CAAC,GACN;AAChC,UAAM,OAAgC,EAAE,IAAI;AAC5C,QAAI,KAAK,gBAAiB,MAAK,kBAAkB,KAAK;AACtD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,cACJ,UAC8B;AAC9B,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,IAA8C;AAC5D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,EAAE,CAAC;AAAA,MACpD,CAAC;AAAA,MACD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,WAAW,IAAkC;AACjD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,EAAE,CAAC;AAAA,MAC5C;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAAuB,CAAC;AAAA,EACxD;AAAA;AAAA,EAGA,MAAM,UAAU,KAA8C;AAC5D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAoC;AACxC,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAAwB,CAAC;AAAA,EACzD;AAAA;AAAA,EAGA,MAAM,UAAU,OAAmC;AACjD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,gBAAgB,OAA0C;AAC9D,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA4B,CAAC;AAAA,EAC7D;AAAA;AAAA,EAGA,MAAM,YACJ,OACA,WAC8B;AAC9B,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD,EAAE,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAa,OAA8B;AAC/C,UAAM,KAAK;AAAA,MACT;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UACJ,IACA,UACA,OAAoC,CAAC,GACjB;AACpB,UAAM,KAAK,KAAK,gBAAgB,yBAAyB;AACzD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,EAAE,CAAC,UAAU,mBAAmB,QAAQ,CAAC,SAAS,EAAE;AAAA,MAC7F;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,YAAY,IAAY,UAAwC;AACpE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,EAAE,CAAC,UAAU,mBAAmB,QAAQ,CAAC;AAAA,MAC1F;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,cACJ,IACA,GACA,OAAwB,QACiB;AACzC,UAAM,KAAK,IAAI,gBAAgB,EAAE,IAAI,GAAG,KAAK,CAAC,EAAE,SAAS;AACzD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,mBAAmB,EAAE;AAAA,MACnC;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA0C,CAAC;AAAA,EAC3E;AACF;","names":["text"]}

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   Client,
   CographError
-} from "./chunk-X7YVTWAD.js";
+} from "./chunk-RBRPNURW.js";
 import "./chunk-7VVBEUZQ.js";
 
 // src/cli.ts
@@ -48,7 +48,7 @@ async function confirm(prompt) {
 }
 var program = new Command();
 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-YE3K2LYX.js");
+  const { runShell } = await import("./shell-R5EEHLZJ.js");
   await runShell({
     local: opts.local,
     // commander's --no-login inverts: opts.login === false when flag passed.
@@ -436,7 +436,7 @@ program.command("login").description("Sign in via your browser and save an API k
 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-YE3K2LYX.js");
+    const { runShell } = await import("./shell-R5EEHLZJ.js");
     await runShell({
       kg: opts.kg,
       local: opts.local || parentOpts.local,

package/dist/index.d.ts

@@ -72,6 +72,20 @@ declare class Client {
     deleteKg(name: string): Promise<Record<string, unknown>>;
     /** List ontology types. */
     ontologyTypes(): Promise<Array<Record<string, unknown>>>;
+    /**
+     * Resolve a natural-language ontology change against the existing ontology.
+     * The caller does not need to know exact type/attribute/relationship names —
+     * the server matches the plain-language `ask` to the current schema and
+     * returns auto-applied changes plus proposals that need confirmation.
+     */
+    ontologyResolve(ask: string, opts?: {
+        knowledge_graph?: string;
+    }): Promise<OntologyResolveResult>;
+    /**
+     * Apply a single resolved ontology change — one of the `proposals` returned
+     * by {@link ontologyResolve}. Pass the proposal object through unchanged.
+     */
+    ontologyApply(proposal: ResolvedChange): Promise<OntologyApplyResult>;
     /**
      * Second-pass entity resolution: re-run ER over an already-ingested KG to
      * collapse intra-batch fragments. Synchronous on the server; returns a
@@ -107,6 +121,30 @@ declare class Client {
     /** Search types or attributes by name substring within a KG. */
     exploreSearch(kg: string, q: string, kind?: "type" | "attr"): Promise<Array<Record<string, unknown>>>;
 }
+/**
+ * A single ontology change resolved against the existing schema. The same
+ * shape is returned under `applied`/`proposals` by {@link Client.ontologyResolve}
+ * and accepted as the request body by {@link Client.ontologyApply}.
+ */
+interface ResolvedChange {
+    kind: "attribute" | "relationship";
+    subject_type: string;
+    name: string;
+    datatype_or_target: string;
+    action: "reuse" | "extend" | "create";
+    confidence: number;
+    reason: string;
+}
+interface OntologyResolveResult {
+    applied: ResolvedChange[];
+    proposals: ResolvedChange[];
+    summary: string;
+}
+interface OntologyApplyResult {
+    applied: ResolvedChange;
+    operations: number;
+    summary: string;
+}
 interface TypeCount {
     name: string;
     entity_count: number;
@@ -228,4 +266,4 @@ interface ConflictReview {
     decision?: ReviewDecision | null;
 }
 
-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 };
+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 OntologyApplyResult, type OntologyResolveResult, type ResolvedChange, type ReviewDecision, type RowAction, type RowResult, type Verdict };

package/dist/index.js

@@ -370,6 +370,34 @@ var Client = class {
     );
     return Array.isArray(data) ? data : [];
   }
+  /**
+   * Resolve a natural-language ontology change against the existing ontology.
+   * The caller does not need to know exact type/attribute/relationship names —
+   * the server matches the plain-language `ask` to the current schema and
+   * returns auto-applied changes plus proposals that need confirmation.
+   */
+  async ontologyResolve(ask, opts = {}) {
+    const body = { ask };
+    if (opts.knowledge_graph) body.knowledge_graph = opts.knowledge_graph;
+    return this.request(
+      "POST",
+      `${this.base()}/ontology/resolve`,
+      body,
+      6e4
+    );
+  }
+  /**
+   * Apply a single resolved ontology change — one of the `proposals` returned
+   * by {@link ontologyResolve}. Pass the proposal object through unchanged.
+   */
+  async ontologyApply(proposal) {
+    return this.request(
+      "POST",
+      `${this.base()}/ontology/apply`,
+      proposal,
+      6e4
+    );
+  }
   /**
    * Second-pass entity resolution: re-run ER over an already-ingested KG to
    * collapse intra-batch fragments. Synchronous on the server; returns a

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/config.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    // All batches are in — kick off a background recompute of the Explorer\n    // type-stats for this KG so type-detail views load instantly. The endpoint\n    // returns immediately (the scan runs server-side in the background); this\n    // is best-effort and never fails the ingest.\n    if (kgName) {\n      try {\n        await this.request(\n          \"POST\",\n          `${this.base()}/explore/kgs/${encodeURIComponent(kgName)}/recompute-stats`,\n          {},\n          15_000,\n        );\n      } catch {\n        // non-fatal — stats fall back to a live scan until the next recompute\n      }\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  /**\n   * Second-pass entity resolution: re-run ER over an already-ingested KG to\n   * collapse intra-batch fragments. Synchronous on the server; returns a\n   * per-type before/after report. Generous timeout — it rewrites triples.\n   */\n  async erRebuild(kg: string): Promise<Record<string, unknown>> {\n    return this.request<Record<string, unknown>>(\n      \"POST\",\n      `${this.base()}/explore/kgs/${encodeURIComponent(kg)}/er-rebuild`,\n      {},\n      300_000,\n    );\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  /** Explorer summary for a type — like typeUsage but adds coverage_pct + avg_degree. */\n  async typeSummary(kg: string, typeName: string): Promise<TypeSummary> {\n    return this.request<TypeSummary>(\n      \"GET\",\n      `${this.base()}/explore/kgs/${encodeURIComponent(kg)}/types/${encodeURIComponent(typeName)}/summary`,\n      undefined,\n      30_000,\n    );\n  }\n\n  /** Search types or attributes by name substring within a KG. */\n  async exploreSearch(\n    kg: string,\n    q: string,\n    kind: \"type\" | \"attr\" = \"type\",\n  ): Promise<Array<Record<string, unknown>>> {\n    const qs = new URLSearchParams({ kg, q, kind }).toString();\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/explore/search?${qs}`,\n      undefined,\n      15_000,\n    );\n    return Array.isArray(data) ? (data as Array<Record<string, unknown>>) : [];\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 interface AttributeSummary {\n  name: string;\n  predicate_uri: string;\n  datatype: string;\n  count: number;\n  coverage_pct: number;\n}\n\nexport interface RelationshipSummary {\n  name: string;\n  predicate_uri: string;\n  target_type: string | null;\n  count: number;\n  coverage_pct: number;\n  avg_degree: number;\n}\n\nexport interface TypeSummary {\n  name: string;\n  description: string;\n  parent_type: string | null;\n  entity_count: number;\n  attributes: AttributeSummary[];\n  relationships: RelationshipSummary[];\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","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,cAAAA,aAAY,gBAAAC,eAAc,gBAAgB;AACnD,SAAS,eAAe;;;ACDxB,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;;;ADhCO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAA2C;AACtE,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS,MAAM;AACpB,SAAK,OAAO,MAAM;AAAA,EACpB;AACF;AAkCA,SAAS,OAAO,MAAc,UAAuC;AAEnE,SACE,QAAQ,IAAI,WAAW,IAAI,EAAE,KAC7B,QAAQ,IAAI,SAAS,IAAI,EAAE,KAC3B;AAEJ;AAEA,IAAM,aAAqC;AAAA,EACzC,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,QAAQ;AACV;AASO,SAAS,SAAS,SAA2C;AAClE,QAAM,OAAmB,CAAC;AAC1B,MAAI,MAAgB,CAAC;AACrB,MAAI,QAAQ;AACZ,MAAI,WAAW;AAEf,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,UAAM,KAAK,QAAQ,CAAC;AACpB,QAAI,UAAU;AACZ,UAAI,OAAO,KAAK;AACd,YAAI,QAAQ,IAAI,CAAC,MAAM,KAAK;AAC1B,mBAAS;AACT;AAAA,QACF,OAAO;AACL,qBAAW;AAAA,QACb;AAAA,MACF,OAAO;AACL,iBAAS;AAAA,MACX;AAAA,IACF,OAAO;AACL,UAAI,OAAO,KAAK;AACd,mBAAW;AAAA,MACb,WAAW,OAAO,KAAK;AACrB,YAAI,KAAK,KAAK;AACd,gBAAQ;AAAA,MACV,WAAW,OAAO,MAAM;AACtB,YAAI,KAAK,KAAK;AACd,aAAK,KAAK,GAAG;AACb,cAAM,CAAC;AACP,gBAAQ;AAAA,MACV,WAAW,OAAO,MAAM;AAEtB,YAAI,QAAQ,IAAI,CAAC,MAAM,MAAM;AAC3B,cAAI,KAAK,KAAK;AACd,eAAK,KAAK,GAAG;AACb,gBAAM,CAAC;AACP,kBAAQ;AAAA,QACV;AAAA,MACF,OAAO;AACL,iBAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,KAAK,IAAI,SAAS,GAAG;AACtC,QAAI,KAAK,KAAK;AACd,SAAK,KAAK,GAAG;AAAA,EACf;AAEA,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAC/B,QAAM,UAAU,KAAK,CAAC,EAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AAC5C,QAAM,MAAgC,CAAC;AACvC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAElB,QAAI,IAAI,WAAW,KAAK,IAAI,CAAC,MAAM,GAAI;AACvC,UAAM,MAA8B,CAAC;AACrC,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,UAAI,QAAQ,CAAC,CAAE,IAAI,IAAI,CAAC,KAAK;AAAA,IAC/B;AACA,QAAI,KAAK,GAAG;AAAA,EACd;AACA,SAAO;AACT;AAEO,IAAM,SAAN,MAAa;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,OAAsB,CAAC,GAAG;AAIpC,UAAM,MAAM,WAAW;AACvB,SAAK,SAAS,KAAK,UAAU,OAAO,SAAS,KAAK,IAAI;AACtD,UAAM,MACJ,KAAK,WAAW,OAAO,SAAS,KAAK,IAAI,UAAU;AACrD,SAAK,UAAU,IAAI,QAAQ,QAAQ,EAAE;AACrC,SAAK,SAAS,KAAK,UAAU,OAAO,QAAQ,KAAK,IAAI,UAAU;AAAA,EACjE;AAAA,EAEQ,UAAkC;AACxC,UAAM,IAA4B,EAAE,gBAAgB,mBAAmB;AACvE,QAAI,KAAK,OAAQ,GAAE,WAAW,IAAI,KAAK;AACvC,WAAO;AAAA,EACT;AAAA,EAEQ,OAAe;AACrB,WAAO,GAAG,KAAK,OAAO,WAAW,KAAK,MAAM;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,cAIH;AACD,UAAM,YAAY,GAAG,KAAK,OAAO;AACjC,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,WAAW;AAAA,QACjC,QAAQ,YAAY,QAAQ,GAAI;AAAA,MAClC,CAAC;AACD,UAAI,CAAC,IAAI,GAAI,QAAO,EAAE,IAAI,OAAO,cAAc,OAAO,KAAK,KAAK,QAAQ;AAAA,IAC1E,QAAQ;AACN,aAAO,EAAE,IAAI,OAAO,cAAc,OAAO,KAAK,KAAK,QAAQ;AAAA,IAC7D;AAIA,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,QAAQ;AAAA,QAC5C,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,QAC9C,QAAQ,YAAY,QAAQ,GAAI;AAAA,MAClC,CAAC;AACD,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,cAAc,IAAI,WAAW;AAAA,QAC7B,KAAK,KAAK;AAAA,MACZ;AAAA,IACF,QAAQ;AACN,aAAO,EAAE,IAAI,MAAM,cAAc,MAAM,KAAK,KAAK,QAAQ;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAc,QACZ,QACA,KACA,MACA,YAAoB,MACR;AACZ,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS;AAC5D,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,MAAM,KAAK;AAAA,QACrB;AAAA,QACA,SAAS,KAAK,QAAQ;AAAA,QACtB,MAAM,SAAS,SAAY,SAAY,KAAK,UAAU,IAAI;AAAA,QAC1D,QAAQ,WAAW;AAAA,MACrB,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,mBAAa,KAAK;AAClB,UAAI,eAAe,SAAS,IAAI,SAAS,cAAc;AACrD,cAAM,IAAI,aAAa,cAAc,GAAG,oBAAoB,SAAS,IAAI;AAAA,MAC3E;AACA,YAAM,IAAI;AAAA,QACR,4BAA4B,GAAG,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,MACtF;AAAA,IACF;AACA,iBAAa,KAAK;AAElB,QAAI,CAAC,IAAI,IAAI;AACX,UAAIC,QAAO;AACX,UAAI;AACF,QAAAA,QAAO,MAAM,IAAI,KAAK;AAAA,MACxB,QAAQ;AAAA,MAER;AACA,YAAM,IAAI,aAAa,QAAQ,IAAI,MAAM,KAAKA,KAAI,IAAI;AAAA,QACpD,QAAQ,IAAI;AAAA,QACZ,MAAMA;AAAA,MACR,CAAC;AAAA,IACH;AAGA,QAAI,IAAI,WAAW,IAAK,QAAO;AAE/B,UAAM,KAAK,IAAI,QAAQ,IAAI,cAAc,KAAK;AAC9C,QAAI,GAAG,SAAS,kBAAkB,GAAG;AACnC,aAAQ,MAAM,IAAI,KAAK;AAAA,IACzB;AAEA,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAI;AACF,aAAO,KAAK,MAAM,IAAI;AAAA,IACxB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OACJ,YACA,OAAsB,CAAC,GACW;AAClC,QAAI;AACJ,QAAI;AAEJ,QAAI,SAAS;AACb,QAAI;AACF,eAASC,YAAW,UAAU,KAAK,SAAS,UAAU,EAAE,OAAO;AAAA,IACjE,QAAQ;AACN,eAAS;AAAA,IACX;AAEA,QAAI,QAAQ;AACV,YAAM,MAAM,QAAQ,UAAU,EAAE,YAAY;AAC5C,UAAI,QAAQ,QAAQ;AAClB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,gBAAUC,cAAa,YAAY,OAAO;AAC1C,YAAM,KAAK,eAAe,WAAW,GAAG,KAAK;AAC7C,UAAI,QAAQ,OAAO;AACjB,eAAO,KAAK,UAAU,SAAS,IAAI;AAAA,MACrC;AAAA,IACF,OAAO;AACL,gBAAU;AACV,YAAM,KAAK,eAAe;AAAA,IAC5B;AAEA,UAAM,OAAgC;AAAA,MACpC;AAAA,MACA,cAAc;AAAA,MACd,QAAQ;AAAA,IACV;AACA,QAAI,KAAK,GAAI,MAAK,UAAU,KAAK;AACjC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,WAAW,MAAM,IAAO;AAAA,EACpE;AAAA,EAEA,MAAc,UACZ,SACA,MACkC;AAClC,UAAM,SAAS,KAAK;AACpB,UAAM,YAAY,KAAK,aAAa;AACpC,UAAM,cAAc,KAAK,eAAe;AAExC,UAAM,OAAO,SAAS,OAAO;AAC7B,QAAI,KAAK,WAAW,EAAG,OAAM,IAAI,aAAa,cAAc;AAC5D,UAAM,UAAU,OAAO,KAAK,KAAK,CAAC,CAAE;AAMpC,UAAM,aAAa,KAChB,IAAI,CAAC,KAAK,SAAS;AAAA,MAClB;AAAA,MACA;AAAA,MACA,OAAO,OAAO,OAAO,GAAG,EAAE;AAAA,QACxB,CAAC,MAAM,KAAK,QAAQ,OAAO,CAAC,EAAE,KAAK,MAAM;AAAA,MAC3C,EAAE;AAAA,IACJ,EAAE,EACD,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EACjD,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,MAAM,EAAE,GAAG;AAEnB,UAAM,aAAa;AAAA,MACjB;AAAA,MACA,aAAa;AAAA,MACb,YAAY,KAAK;AAAA,IACnB;AACA,UAAM,UAAU,MAAM,KAAK;AAAA,MACzB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAMA,UAAM,UAA2C,CAAC;AAClD,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,WAAW;AAC/C,cAAQ,KAAK,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC;AAAA,IAC3C;AAEA,QAAI,gBAAgB;AACpB,QAAI,eAAe;AACnB,QAAI,gBAAgB;AACpB,QAAI,YAAY;AAEhB,UAAM,YAAY,OAAO,UAAoC;AAC3D,YAAM,OAAgC;AAAA,QACpC;AAAA,QACA,MAAM;AAAA,QACN,QAAQ;AAAA,MACV;AACA,UAAI,OAAQ,MAAK,UAAU;AAC3B,YAAM,SAAS,MAAM,KAAK,QAGvB,QAAQ,GAAG,KAAK,KAAK,CAAC,oBAAoB,MAAM,GAAO;AAC1D,aAAO;AAAA,QACL,UAAU,OAAO,qBAAqB;AAAA,QACtC,SAAS,OAAO,oBAAoB;AAAA,QACpC,MAAM,MAAM;AAAA,MACd;AAAA,IACF;AAEA,UAAM,SAAS,YAA2B;AACxC,aAAO,MAAM;AACX,cAAM,MAAM;AACZ,YAAI,OAAO,QAAQ,OAAQ;AAC3B,cAAM,IAAI,MAAM,UAAU,QAAQ,GAAG,CAAE;AACvC,yBAAiB,EAAE;AACnB,wBAAgB,EAAE;AAClB,yBAAiB,EAAE;AACnB,aAAK,aAAa;AAAA,UAChB;AAAA,UACA,WAAW,KAAK;AAAA,UAChB,kBAAkB;AAAA,UAClB,iBAAiB;AAAA,QACnB,CAAC;AAAA,MACH;AAAA,IACF;AAEA,UAAM,UAAgC,CAAC;AACvC,aAAS,IAAI,GAAG,IAAI,KAAK,IAAI,aAAa,QAAQ,MAAM,GAAG,KAAK;AAC9D,cAAQ,KAAK,OAAO,CAAC;AAAA,IACvB;AACA,UAAM,QAAQ,IAAI,OAAO;AAMzB,QAAI,QAAQ;AACV,UAAI;AACF,cAAM,KAAK;AAAA,UACT;AAAA,UACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,MAAM,CAAC;AAAA,UACxD,CAAC;AAAA,UACD;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,kBAAkB;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,IACJ,UACA,OAAmB,CAAC,GACc;AAClC,UAAM,OAAgC,EAAE,SAAS;AACjD,QAAI,KAAK,GAAI,MAAK,UAAU,KAAK;AACjC,QAAI,KAAK,MAAO,MAAK,QAAQ,KAAK;AAClC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,QAAQ,MAAM,GAAM;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,UAAmD;AACvD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,QAAI,MAAM,QAAQ,IAAI,EAAG,QAAO;AAChC,QAAI,QAAQ,OAAO,SAAS,YAAY,SAAS,MAAM;AACrD,YAAM,MAAO,KAA2B;AACxC,UAAI,MAAM,QAAQ,GAAG,EAAG,QAAO;AAAA,IACjC;AACA,WAAO,CAAC;AAAA,EACV;AAAA;AAAA,EAGA,MAAM,SACJ,MACA,aACkC;AAClC,UAAM,OAAgC,EAAE,KAAK;AAC7C,QAAI,YAAa,MAAK,cAAc;AACpC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,QAAQ,MAAM,IAAM;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,SAAS,MAAgD;AAC7D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,IAAI,CAAC;AAAA,MAC9C;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,gBAAyD;AAC7D,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA0C,CAAC;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,IAA8C;AAC5D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,EAAE,CAAC;AAAA,MACpD,CAAC;AAAA,MACD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,WAAW,IAAkC;AACjD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,EAAE,CAAC;AAAA,MAC5C;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAAuB,CAAC;AAAA,EACxD;AAAA;AAAA,EAGA,MAAM,UAAU,KAA8C;AAC5D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAoC;AACxC,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAAwB,CAAC;AAAA,EACzD;AAAA;AAAA,EAGA,MAAM,UAAU,OAAmC;AACjD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,gBAAgB,OAA0C;AAC9D,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA4B,CAAC;AAAA,EAC7D;AAAA;AAAA,EAGA,MAAM,YACJ,OACA,WAC8B;AAC9B,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD,EAAE,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAa,OAA8B;AAC/C,UAAM,KAAK;AAAA,MACT;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UACJ,IACA,UACA,OAAoC,CAAC,GACjB;AACpB,UAAM,KAAK,KAAK,gBAAgB,yBAAyB;AACzD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,EAAE,CAAC,UAAU,mBAAmB,QAAQ,CAAC,SAAS,EAAE;AAAA,MAC7F;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,YAAY,IAAY,UAAwC;AACpE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,EAAE,CAAC,UAAU,mBAAmB,QAAQ,CAAC;AAAA,MAC1F;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,cACJ,IACA,GACA,OAAwB,QACiB;AACzC,UAAM,KAAK,IAAI,gBAAgB,EAAE,IAAI,GAAG,KAAK,CAAC,EAAE,SAAS;AACzD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,mBAAmB,EAAE;AAAA,MACnC;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA0C,CAAC;AAAA,EAC3E;AACF;","names":["existsSync","readFileSync","text","existsSync","readFileSync"]}
+{"version":3,"sources":["../src/client.ts","../src/config.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    // All batches are in — kick off a background recompute of the Explorer\n    // type-stats for this KG so type-detail views load instantly. The endpoint\n    // returns immediately (the scan runs server-side in the background); this\n    // is best-effort and never fails the ingest.\n    if (kgName) {\n      try {\n        await this.request(\n          \"POST\",\n          `${this.base()}/explore/kgs/${encodeURIComponent(kgName)}/recompute-stats`,\n          {},\n          15_000,\n        );\n      } catch {\n        // non-fatal — stats fall back to a live scan until the next recompute\n      }\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  /**\n   * Resolve a natural-language ontology change against the existing ontology.\n   * The caller does not need to know exact type/attribute/relationship names —\n   * the server matches the plain-language `ask` to the current schema and\n   * returns auto-applied changes plus proposals that need confirmation.\n   */\n  async ontologyResolve(\n    ask: string,\n    opts: { knowledge_graph?: string } = {},\n  ): Promise<OntologyResolveResult> {\n    const body: Record<string, unknown> = { ask };\n    if (opts.knowledge_graph) body.knowledge_graph = opts.knowledge_graph;\n    return this.request<OntologyResolveResult>(\n      \"POST\",\n      `${this.base()}/ontology/resolve`,\n      body,\n      60_000,\n    );\n  }\n\n  /**\n   * Apply a single resolved ontology change — one of the `proposals` returned\n   * by {@link ontologyResolve}. Pass the proposal object through unchanged.\n   */\n  async ontologyApply(\n    proposal: ResolvedChange,\n  ): Promise<OntologyApplyResult> {\n    return this.request<OntologyApplyResult>(\n      \"POST\",\n      `${this.base()}/ontology/apply`,\n      proposal,\n      60_000,\n    );\n  }\n\n  /**\n   * Second-pass entity resolution: re-run ER over an already-ingested KG to\n   * collapse intra-batch fragments. Synchronous on the server; returns a\n   * per-type before/after report. Generous timeout — it rewrites triples.\n   */\n  async erRebuild(kg: string): Promise<Record<string, unknown>> {\n    return this.request<Record<string, unknown>>(\n      \"POST\",\n      `${this.base()}/explore/kgs/${encodeURIComponent(kg)}/er-rebuild`,\n      {},\n      300_000,\n    );\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  /** Explorer summary for a type — like typeUsage but adds coverage_pct + avg_degree. */\n  async typeSummary(kg: string, typeName: string): Promise<TypeSummary> {\n    return this.request<TypeSummary>(\n      \"GET\",\n      `${this.base()}/explore/kgs/${encodeURIComponent(kg)}/types/${encodeURIComponent(typeName)}/summary`,\n      undefined,\n      30_000,\n    );\n  }\n\n  /** Search types or attributes by name substring within a KG. */\n  async exploreSearch(\n    kg: string,\n    q: string,\n    kind: \"type\" | \"attr\" = \"type\",\n  ): Promise<Array<Record<string, unknown>>> {\n    const qs = new URLSearchParams({ kg, q, kind }).toString();\n    const data = await this.request<unknown>(\n      \"GET\",\n      `${this.base()}/explore/search?${qs}`,\n      undefined,\n      15_000,\n    );\n    return Array.isArray(data) ? (data as Array<Record<string, unknown>>) : [];\n  }\n}\n\n/**\n * A single ontology change resolved against the existing schema. The same\n * shape is returned under `applied`/`proposals` by {@link Client.ontologyResolve}\n * and accepted as the request body by {@link Client.ontologyApply}.\n */\nexport interface ResolvedChange {\n  kind: \"attribute\" | \"relationship\";\n  subject_type: string;\n  name: string;\n  datatype_or_target: string;\n  action: \"reuse\" | \"extend\" | \"create\";\n  confidence: number;\n  reason: string;\n}\n\nexport interface OntologyResolveResult {\n  applied: ResolvedChange[];\n  proposals: ResolvedChange[];\n  summary: string;\n}\n\nexport interface OntologyApplyResult {\n  applied: ResolvedChange;\n  operations: number;\n  summary: string;\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 interface AttributeSummary {\n  name: string;\n  predicate_uri: string;\n  datatype: string;\n  count: number;\n  coverage_pct: number;\n}\n\nexport interface RelationshipSummary {\n  name: string;\n  predicate_uri: string;\n  target_type: string | null;\n  count: number;\n  coverage_pct: number;\n  avg_degree: number;\n}\n\nexport interface TypeSummary {\n  name: string;\n  description: string;\n  parent_type: string | null;\n  entity_count: number;\n  attributes: AttributeSummary[];\n  relationships: RelationshipSummary[];\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","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,cAAAA,aAAY,gBAAAC,eAAc,gBAAgB;AACnD,SAAS,eAAe;;;ACDxB,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;;;ADhCO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAA2C;AACtE,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS,MAAM;AACpB,SAAK,OAAO,MAAM;AAAA,EACpB;AACF;AAkCA,SAAS,OAAO,MAAc,UAAuC;AAEnE,SACE,QAAQ,IAAI,WAAW,IAAI,EAAE,KAC7B,QAAQ,IAAI,SAAS,IAAI,EAAE,KAC3B;AAEJ;AAEA,IAAM,aAAqC;AAAA,EACzC,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,QAAQ;AACV;AASO,SAAS,SAAS,SAA2C;AAClE,QAAM,OAAmB,CAAC;AAC1B,MAAI,MAAgB,CAAC;AACrB,MAAI,QAAQ;AACZ,MAAI,WAAW;AAEf,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,UAAM,KAAK,QAAQ,CAAC;AACpB,QAAI,UAAU;AACZ,UAAI,OAAO,KAAK;AACd,YAAI,QAAQ,IAAI,CAAC,MAAM,KAAK;AAC1B,mBAAS;AACT;AAAA,QACF,OAAO;AACL,qBAAW;AAAA,QACb;AAAA,MACF,OAAO;AACL,iBAAS;AAAA,MACX;AAAA,IACF,OAAO;AACL,UAAI,OAAO,KAAK;AACd,mBAAW;AAAA,MACb,WAAW,OAAO,KAAK;AACrB,YAAI,KAAK,KAAK;AACd,gBAAQ;AAAA,MACV,WAAW,OAAO,MAAM;AACtB,YAAI,KAAK,KAAK;AACd,aAAK,KAAK,GAAG;AACb,cAAM,CAAC;AACP,gBAAQ;AAAA,MACV,WAAW,OAAO,MAAM;AAEtB,YAAI,QAAQ,IAAI,CAAC,MAAM,MAAM;AAC3B,cAAI,KAAK,KAAK;AACd,eAAK,KAAK,GAAG;AACb,gBAAM,CAAC;AACP,kBAAQ;AAAA,QACV;AAAA,MACF,OAAO;AACL,iBAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,KAAK,IAAI,SAAS,GAAG;AACtC,QAAI,KAAK,KAAK;AACd,SAAK,KAAK,GAAG;AAAA,EACf;AAEA,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAC/B,QAAM,UAAU,KAAK,CAAC,EAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AAC5C,QAAM,MAAgC,CAAC;AACvC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAElB,QAAI,IAAI,WAAW,KAAK,IAAI,CAAC,MAAM,GAAI;AACvC,UAAM,MAA8B,CAAC;AACrC,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,UAAI,QAAQ,CAAC,CAAE,IAAI,IAAI,CAAC,KAAK;AAAA,IAC/B;AACA,QAAI,KAAK,GAAG;AAAA,EACd;AACA,SAAO;AACT;AAEO,IAAM,SAAN,MAAa;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,OAAsB,CAAC,GAAG;AAIpC,UAAM,MAAM,WAAW;AACvB,SAAK,SAAS,KAAK,UAAU,OAAO,SAAS,KAAK,IAAI;AACtD,UAAM,MACJ,KAAK,WAAW,OAAO,SAAS,KAAK,IAAI,UAAU;AACrD,SAAK,UAAU,IAAI,QAAQ,QAAQ,EAAE;AACrC,SAAK,SAAS,KAAK,UAAU,OAAO,QAAQ,KAAK,IAAI,UAAU;AAAA,EACjE;AAAA,EAEQ,UAAkC;AACxC,UAAM,IAA4B,EAAE,gBAAgB,mBAAmB;AACvE,QAAI,KAAK,OAAQ,GAAE,WAAW,IAAI,KAAK;AACvC,WAAO;AAAA,EACT;AAAA,EAEQ,OAAe;AACrB,WAAO,GAAG,KAAK,OAAO,WAAW,KAAK,MAAM;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,cAIH;AACD,UAAM,YAAY,GAAG,KAAK,OAAO;AACjC,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,WAAW;AAAA,QACjC,QAAQ,YAAY,QAAQ,GAAI;AAAA,MAClC,CAAC;AACD,UAAI,CAAC,IAAI,GAAI,QAAO,EAAE,IAAI,OAAO,cAAc,OAAO,KAAK,KAAK,QAAQ;AAAA,IAC1E,QAAQ;AACN,aAAO,EAAE,IAAI,OAAO,cAAc,OAAO,KAAK,KAAK,QAAQ;AAAA,IAC7D;AAIA,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,QAAQ;AAAA,QAC5C,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,QAC9C,QAAQ,YAAY,QAAQ,GAAI;AAAA,MAClC,CAAC;AACD,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,cAAc,IAAI,WAAW;AAAA,QAC7B,KAAK,KAAK;AAAA,MACZ;AAAA,IACF,QAAQ;AACN,aAAO,EAAE,IAAI,MAAM,cAAc,MAAM,KAAK,KAAK,QAAQ;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAc,QACZ,QACA,KACA,MACA,YAAoB,MACR;AACZ,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS;AAC5D,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,MAAM,KAAK;AAAA,QACrB;AAAA,QACA,SAAS,KAAK,QAAQ;AAAA,QACtB,MAAM,SAAS,SAAY,SAAY,KAAK,UAAU,IAAI;AAAA,QAC1D,QAAQ,WAAW;AAAA,MACrB,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,mBAAa,KAAK;AAClB,UAAI,eAAe,SAAS,IAAI,SAAS,cAAc;AACrD,cAAM,IAAI,aAAa,cAAc,GAAG,oBAAoB,SAAS,IAAI;AAAA,MAC3E;AACA,YAAM,IAAI;AAAA,QACR,4BAA4B,GAAG,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,MACtF;AAAA,IACF;AACA,iBAAa,KAAK;AAElB,QAAI,CAAC,IAAI,IAAI;AACX,UAAIC,QAAO;AACX,UAAI;AACF,QAAAA,QAAO,MAAM,IAAI,KAAK;AAAA,MACxB,QAAQ;AAAA,MAER;AACA,YAAM,IAAI,aAAa,QAAQ,IAAI,MAAM,KAAKA,KAAI,IAAI;AAAA,QACpD,QAAQ,IAAI;AAAA,QACZ,MAAMA;AAAA,MACR,CAAC;AAAA,IACH;AAGA,QAAI,IAAI,WAAW,IAAK,QAAO;AAE/B,UAAM,KAAK,IAAI,QAAQ,IAAI,cAAc,KAAK;AAC9C,QAAI,GAAG,SAAS,kBAAkB,GAAG;AACnC,aAAQ,MAAM,IAAI,KAAK;AAAA,IACzB;AAEA,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAI;AACF,aAAO,KAAK,MAAM,IAAI;AAAA,IACxB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OACJ,YACA,OAAsB,CAAC,GACW;AAClC,QAAI;AACJ,QAAI;AAEJ,QAAI,SAAS;AACb,QAAI;AACF,eAASC,YAAW,UAAU,KAAK,SAAS,UAAU,EAAE,OAAO;AAAA,IACjE,QAAQ;AACN,eAAS;AAAA,IACX;AAEA,QAAI,QAAQ;AACV,YAAM,MAAM,QAAQ,UAAU,EAAE,YAAY;AAC5C,UAAI,QAAQ,QAAQ;AAClB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,gBAAUC,cAAa,YAAY,OAAO;AAC1C,YAAM,KAAK,eAAe,WAAW,GAAG,KAAK;AAC7C,UAAI,QAAQ,OAAO;AACjB,eAAO,KAAK,UAAU,SAAS,IAAI;AAAA,MACrC;AAAA,IACF,OAAO;AACL,gBAAU;AACV,YAAM,KAAK,eAAe;AAAA,IAC5B;AAEA,UAAM,OAAgC;AAAA,MACpC;AAAA,MACA,cAAc;AAAA,MACd,QAAQ;AAAA,IACV;AACA,QAAI,KAAK,GAAI,MAAK,UAAU,KAAK;AACjC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,WAAW,MAAM,IAAO;AAAA,EACpE;AAAA,EAEA,MAAc,UACZ,SACA,MACkC;AAClC,UAAM,SAAS,KAAK;AACpB,UAAM,YAAY,KAAK,aAAa;AACpC,UAAM,cAAc,KAAK,eAAe;AAExC,UAAM,OAAO,SAAS,OAAO;AAC7B,QAAI,KAAK,WAAW,EAAG,OAAM,IAAI,aAAa,cAAc;AAC5D,UAAM,UAAU,OAAO,KAAK,KAAK,CAAC,CAAE;AAMpC,UAAM,aAAa,KAChB,IAAI,CAAC,KAAK,SAAS;AAAA,MAClB;AAAA,MACA;AAAA,MACA,OAAO,OAAO,OAAO,GAAG,EAAE;AAAA,QACxB,CAAC,MAAM,KAAK,QAAQ,OAAO,CAAC,EAAE,KAAK,MAAM;AAAA,MAC3C,EAAE;AAAA,IACJ,EAAE,EACD,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EACjD,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,MAAM,EAAE,GAAG;AAEnB,UAAM,aAAa;AAAA,MACjB;AAAA,MACA,aAAa;AAAA,MACb,YAAY,KAAK;AAAA,IACnB;AACA,UAAM,UAAU,MAAM,KAAK;AAAA,MACzB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAMA,UAAM,UAA2C,CAAC;AAClD,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,WAAW;AAC/C,cAAQ,KAAK,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC;AAAA,IAC3C;AAEA,QAAI,gBAAgB;AACpB,QAAI,eAAe;AACnB,QAAI,gBAAgB;AACpB,QAAI,YAAY;AAEhB,UAAM,YAAY,OAAO,UAAoC;AAC3D,YAAM,OAAgC;AAAA,QACpC;AAAA,QACA,MAAM;AAAA,QACN,QAAQ;AAAA,MACV;AACA,UAAI,OAAQ,MAAK,UAAU;AAC3B,YAAM,SAAS,MAAM,KAAK,QAGvB,QAAQ,GAAG,KAAK,KAAK,CAAC,oBAAoB,MAAM,GAAO;AAC1D,aAAO;AAAA,QACL,UAAU,OAAO,qBAAqB;AAAA,QACtC,SAAS,OAAO,oBAAoB;AAAA,QACpC,MAAM,MAAM;AAAA,MACd;AAAA,IACF;AAEA,UAAM,SAAS,YAA2B;AACxC,aAAO,MAAM;AACX,cAAM,MAAM;AACZ,YAAI,OAAO,QAAQ,OAAQ;AAC3B,cAAM,IAAI,MAAM,UAAU,QAAQ,GAAG,CAAE;AACvC,yBAAiB,EAAE;AACnB,wBAAgB,EAAE;AAClB,yBAAiB,EAAE;AACnB,aAAK,aAAa;AAAA,UAChB;AAAA,UACA,WAAW,KAAK;AAAA,UAChB,kBAAkB;AAAA,UAClB,iBAAiB;AAAA,QACnB,CAAC;AAAA,MACH;AAAA,IACF;AAEA,UAAM,UAAgC,CAAC;AACvC,aAAS,IAAI,GAAG,IAAI,KAAK,IAAI,aAAa,QAAQ,MAAM,GAAG,KAAK;AAC9D,cAAQ,KAAK,OAAO,CAAC;AAAA,IACvB;AACA,UAAM,QAAQ,IAAI,OAAO;AAMzB,QAAI,QAAQ;AACV,UAAI;AACF,cAAM,KAAK;AAAA,UACT;AAAA,UACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,MAAM,CAAC;AAAA,UACxD,CAAC;AAAA,UACD;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,kBAAkB;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,IACJ,UACA,OAAmB,CAAC,GACc;AAClC,UAAM,OAAgC,EAAE,SAAS;AACjD,QAAI,KAAK,GAAI,MAAK,UAAU,KAAK;AACjC,QAAI,KAAK,MAAO,MAAK,QAAQ,KAAK;AAClC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,QAAQ,MAAM,GAAM;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,UAAmD;AACvD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,QAAI,MAAM,QAAQ,IAAI,EAAG,QAAO;AAChC,QAAI,QAAQ,OAAO,SAAS,YAAY,SAAS,MAAM;AACrD,YAAM,MAAO,KAA2B;AACxC,UAAI,MAAM,QAAQ,GAAG,EAAG,QAAO;AAAA,IACjC;AACA,WAAO,CAAC;AAAA,EACV;AAAA;AAAA,EAGA,MAAM,SACJ,MACA,aACkC;AAClC,UAAM,OAAgC,EAAE,KAAK;AAC7C,QAAI,YAAa,MAAK,cAAc;AACpC,WAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,CAAC,QAAQ,MAAM,IAAM;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,SAAS,MAAgD;AAC7D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,IAAI,CAAC;AAAA,MAC9C;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,gBAAyD;AAC7D,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA0C,CAAC;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,gBACJ,KACA,OAAqC,CAAC,GACN;AAChC,UAAM,OAAgC,EAAE,IAAI;AAC5C,QAAI,KAAK,gBAAiB,MAAK,kBAAkB,KAAK;AACtD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,cACJ,UAC8B;AAC9B,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,IAA8C;AAC5D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,EAAE,CAAC;AAAA,MACpD,CAAC;AAAA,MACD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,WAAW,IAAkC;AACjD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,EAAE,CAAC;AAAA,MAC5C;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAAuB,CAAC;AAAA,EACxD;AAAA;AAAA,EAGA,MAAM,UAAU,KAA8C;AAC5D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAoC;AACxC,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC;AAAA,MACd;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAAwB,CAAC;AAAA,EACzD;AAAA;AAAA,EAGA,MAAM,UAAU,OAAmC;AACjD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,gBAAgB,OAA0C;AAC9D,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA4B,CAAC;AAAA,EAC7D;AAAA;AAAA,EAGA,MAAM,YACJ,OACA,WAC8B;AAC9B,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD,EAAE,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAa,OAA8B;AAC/C,UAAM,KAAK;AAAA,MACT;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,KAAK,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UACJ,IACA,UACA,OAAoC,CAAC,GACjB;AACpB,UAAM,KAAK,KAAK,gBAAgB,yBAAyB;AACzD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,QAAQ,mBAAmB,EAAE,CAAC,UAAU,mBAAmB,QAAQ,CAAC,SAAS,EAAE;AAAA,MAC7F;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,YAAY,IAAY,UAAwC;AACpE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,gBAAgB,mBAAmB,EAAE,CAAC,UAAU,mBAAmB,QAAQ,CAAC;AAAA,MAC1F;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,cACJ,IACA,GACA,OAAwB,QACiB;AACzC,UAAM,KAAK,IAAI,gBAAgB,EAAE,IAAI,GAAG,KAAK,CAAC,EAAE,SAAS;AACzD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,GAAG,KAAK,KAAK,CAAC,mBAAmB,EAAE;AAAA,MACnC;AAAA,MACA;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,IAAI,IAAK,OAA0C,CAAC;AAAA,EAC3E;AACF;","names":["existsSync","readFileSync","text","existsSync","readFileSync"]}

package/dist/{shell-YE3K2LYX.js → shell-R5EEHLZJ.js}

@@ -2,7 +2,7 @@
 import {
   Client,
   CographError
-} from "./chunk-X7YVTWAD.js";
+} from "./chunk-RBRPNURW.js";
 import "./chunk-7VVBEUZQ.js";
 
 // src/shell.ts
@@ -1100,4 +1100,4 @@ async function runShell(opts) {
 export {
   runShell
 };
-//# sourceMappingURL=shell-YE3K2LYX.js.map
+//# sourceMappingURL=shell-R5EEHLZJ.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cograph",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "Cograph SDK and CLI — knowledge graph platform for structured data",
   "type": "module",
   "main": "./dist/index.js",