cograph 0.1.23 → 0.1.25

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

@@ -16,6 +16,13 @@ var CographError = class extends Error {
     this.body = opts?.body;
   }
 };
+var SCHEMA_SAMPLE_CAP = 5e3;
+function stridedSample(rows, cap = SCHEMA_SAMPLE_CAP) {
+  if (rows.length <= cap) return rows;
+  const out = [];
+  for (let i = 0; i < cap; i++) out.push(rows[Math.floor(i * rows.length / cap)]);
+  return out;
+}
 function envVar(name, fallback) {
   return process.env[`COGRAPH_${name}`] || process.env[`OMNIX_${name}`] || fallback;
 }
@@ -224,13 +231,7 @@ var Client = class {
     const rows = parseCsv(content);
     if (rows.length === 0) throw new CographError("CSV is empty");
     const headers = Object.keys(rows[0]);
-    const sampleRows = rows.map((row, idx) => ({
-      row,
-      idx,
-      score: Object.values(row).filter(
-        (v) => v != null && String(v).trim() !== ""
-      ).length
-    })).sort((a, b) => b.score - a.score || a.idx - b.idx).slice(0, 10).map((s) => s.row);
+    const sampleRows = stridedSample(rows);
     const schemaBody = {
       headers,
       sample_rows: sampleRows,
@@ -242,6 +243,17 @@ var Client = class {
       schemaBody,
       3e5
     );
+    let mappingToPost = mapping;
+    if (opts.onSchemaInferred) {
+      const reviewed = await opts.onSchemaInferred(mapping, {
+        totalRows: rows.length,
+        rowsProfiled: sampleRows.length
+      });
+      if (reviewed == null) {
+        return { cancelled: true, message: "Ingest cancelled before any rows were written." };
+      }
+      mappingToPost = reviewed;
+    }
     const batches = [];
     for (let i = 0; i < rows.length; i += batchSize) {
       batches.push(rows.slice(i, i + batchSize));
@@ -252,7 +264,7 @@ var Client = class {
     let nextBatch = 0;
     const postBatch = async (batch) => {
       const body = {
-        mapping,
+        mapping: mappingToPost,
         rows: batch,
         source: "client"
       };
@@ -309,6 +321,53 @@ var Client = class {
     if (opts.model) body.model = opts.model;
     return this.request("POST", `${this.base()}/ask`, body, 6e4);
   }
+  /**
+   * One turn of the unified Ask-AI agent — the SINGLE conversational surface
+   * (`POST /graphs/{tenant}/agent`, COG-118). Mirrors the HTTP contract exactly:
+   *
+   *  - `confirmPlanId` set → the server runs `execute_plan` (the only mutating
+   *    path) and returns `{kind:"result", steps}`.
+   *  - otherwise → the server runs `planner.handle(message)` and returns one of
+   *    `{kind:"answer"}` / `{kind:"clarify"}` / `{kind:"plan"}`.
+   *
+   * The agent classifies intent server-side and drives the underlying engines
+   * through its capability registry — the client never talks to `/ask`,
+   * `/enrich/*` etc. for an agent turn. ENTITLEMENT for any paid step a plan
+   * contains is enforced server-side at execute time (the same authorization the
+   * direct paid routes apply), so confirming a plan here cannot bypass a gate the
+   * direct path enforces — the gate lives behind the endpoint, not in this client.
+   */
+  async agent(opts) {
+    const body = {
+      message: opts.message ?? "",
+      context: {
+        kg_name: opts.kgName ?? "",
+        type_name: opts.typeName ?? null
+      }
+    };
+    if (opts.sessionId) body.session_id = opts.sessionId;
+    if (opts.confirmPlanId) body.confirm = { plan_id: opts.confirmPlanId };
+    return this.request(
+      "POST",
+      `${this.base()}/agent`,
+      body,
+      // Generous: a confirmed plan can kick off enrichment/dedup work, and a
+      // question turn runs an LLM round-trip server-side.
+      12e4
+    );
+  }
+  /** List the tenants the authenticated user can access (GET /v1/me/tenants).
+   *  Keyed by the API key (X-API-Key → user), so it's independent of the active
+   *  tenant. Throws CographError with status 501 on deployments without a tenant
+   *  provider (e.g. OSS-only). */
+  async listTenants() {
+    return this.request(
+      "GET",
+      `${this.baseUrl}/v1/me/tenants`,
+      void 0,
+      15e3
+    );
+  }
   /** List all knowledge graphs for the current tenant. */
   async listKgs() {
     const data = await this.request(
@@ -496,4 +555,4 @@ export {
   CographError,
   Client
 };
-//# sourceMappingURL=chunk-RBRPNURW.js.map
+//# sourceMappingURL=chunk-O3L4FCRY.js.map

package/dist/chunk-O3L4FCRY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } from \"node:fs\";\nimport { extname } from \"node:path\";\nimport { readConfig } from \"./config.js\";\n\nexport class CographError extends Error {\n  status?: number;\n  body?: string;\n\n  constructor(message: string, opts?: { status?: number; body?: string }) {\n    super(message);\n    this.name = \"CographError\";\n    this.status = opts?.status;\n    this.body = opts?.body;\n  }\n}\n\nexport interface ClientOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  tenant?: string;\n}\n\nexport interface IngestOptions {\n  kg?: string;\n  contentType?: \"text\" | \"csv\" | \"json\" | string;\n  /** Rows per batch for CSV ingest. Default 200. Larger = fewer round-trips\n   *  but higher per-request memory; 200 is a good balance for typical KGs. */\n  batchSize?: number;\n  /** Max number of batches in flight at once. Default 4. Higher saturates\n   *  the backend faster but risks 429s on large ingests. */\n  concurrency?: number;\n  /** Called after each batch completes during CSV ingest, in batch order.\n   *  Use for progress UI. Not invoked for text/json ingest. */\n  onProgress?: (progress: IngestProgress) => void;\n  /** CSV only. Called once after schema inference and BEFORE any rows are\n   *  written, with the inferred mapping. Return the (possibly edited/approved)\n   *  mapping to ingest, or `null` to cancel without writing anything. When\n   *  omitted the inferred mapping is applied as-is (non-interactive). This is\n   *  the same confirm/override gate the Explorer surfaces in its review step. */\n  onSchemaInferred?: (\n    mapping: Record<string, unknown>,\n    info: { totalRows: number; rowsProfiled: number },\n  ) => Promise<Record<string, unknown> | null>;\n}\n\nexport interface IngestProgress {\n  rowsProcessed: number;\n  totalRows: number;\n  entitiesResolved: number;\n  triplesInserted: number;\n}\n\n/** Rows sent to schema inference. Profile fidelity = decision quality, so we\n *  send the whole file up to this cap, evenly strided across it (never the\n *  head — head-of-file bias is exactly what evidence-grounded inference fixes).\n *  Matches the Explorer's SCHEMA_SAMPLE_CAP. */\nexport const SCHEMA_SAMPLE_CAP = 5000;\n\nfunction stridedSample<T>(rows: T[], cap: number = SCHEMA_SAMPLE_CAP): T[] {\n  if (rows.length <= cap) return rows;\n  const out: T[] = [];\n  for (let i = 0; i < cap; i++) out.push(rows[Math.floor((i * rows.length) / cap)]!);\n  return out;\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    // Send the whole file to the profiler, evenly strided across it (never the\n    // head — head-of-file bias, e.g. a key column that goes sparse later, is\n    // exactly what evidence-grounded inference fixes). Profile fidelity =\n    // decision quality. Mirrors the Explorer's upload flow.\n    const sampleRows = stridedSample(rows);\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    // Confirm/override gate (same contract as the Explorer's review step): the\n    // caller inspects the inferred mapping and returns what to ingest, or null\n    // to cancel before any rows are written. /ingest/csv/rows applies exactly\n    // what we post back. When no hook is given, apply the inference as-is.\n    let mappingToPost: Record<string, unknown> = mapping;\n    if (opts.onSchemaInferred) {\n      const reviewed = await opts.onSchemaInferred(mapping, {\n        totalRows: rows.length,\n        rowsProfiled: sampleRows.length,\n      });\n      if (reviewed == null) {\n        return { cancelled: true, message: \"Ingest cancelled before any rows were written.\" };\n      }\n      mappingToPost = reviewed;\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: mappingToPost,\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  /**\n   * One turn of the unified Ask-AI agent — the SINGLE conversational surface\n   * (`POST /graphs/{tenant}/agent`, COG-118). Mirrors the HTTP contract exactly:\n   *\n   *  - `confirmPlanId` set → the server runs `execute_plan` (the only mutating\n   *    path) and returns `{kind:\"result\", steps}`.\n   *  - otherwise → the server runs `planner.handle(message)` and returns one of\n   *    `{kind:\"answer\"}` / `{kind:\"clarify\"}` / `{kind:\"plan\"}`.\n   *\n   * The agent classifies intent server-side and drives the underlying engines\n   * through its capability registry — the client never talks to `/ask`,\n   * `/enrich/*` etc. for an agent turn. ENTITLEMENT for any paid step a plan\n   * contains is enforced server-side at execute time (the same authorization the\n   * direct paid routes apply), so confirming a plan here cannot bypass a gate the\n   * direct path enforces — the gate lives behind the endpoint, not in this client.\n   */\n  async agent(opts: AgentTurnOptions): Promise<AgentResult> {\n    const body: Record<string, unknown> = {\n      message: opts.message ?? \"\",\n      context: {\n        kg_name: opts.kgName ?? \"\",\n        type_name: opts.typeName ?? null,\n      },\n    };\n    if (opts.sessionId) body.session_id = opts.sessionId;\n    // confirm.plan_id present → the server routes to execute_plan (mutating).\n    if (opts.confirmPlanId) body.confirm = { plan_id: opts.confirmPlanId };\n    return this.request<AgentResult>(\n      \"POST\",\n      `${this.base()}/agent`,\n      body,\n      // Generous: a confirmed plan can kick off enrichment/dedup work, and a\n      // question turn runs an LLM round-trip server-side.\n      120_000,\n    );\n  }\n\n  /** List the tenants the authenticated user can access (GET /v1/me/tenants).\n   *  Keyed by the API key (X-API-Key → user), so it's independent of the active\n   *  tenant. Throws CographError with status 501 on deployments without a tenant\n   *  provider (e.g. OSS-only). */\n  async listTenants(): Promise<Array<{ id: string; label: string }>> {\n    return this.request<Array<{ id: string; label: string }>>(\n      \"GET\",\n      `${this.baseUrl}/v1/me/tenants`,\n      undefined,\n      15_000,\n    );\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\n// --- Unified Ask-AI agent (COG-118 / COG-125) -------------------------------- #\n\n/** Inputs to {@link Client.agent} — mirror the `/agent` HTTP body. */\nexport interface AgentTurnOptions {\n  /** The user's natural-language message. Optional when `confirmPlanId` is set\n   *  (a confirm turn carries no new message). */\n  message?: string;\n  /** Knowledge graph the turn operates within. */\n  kgName?: string;\n  /** Optional active type scope (needed for enrich/clean/dedup planning). */\n  typeName?: string;\n  /** Optional conversation/session id for multi-turn continuity. */\n  sessionId?: string;\n  /** When set, the server CONFIRMS + EXECUTES this previously-proposed plan\n   *  (the only mutating path) instead of classifying a new message. */\n  confirmPlanId?: string;\n}\n\n/**\n * The kind-tagged result of one agent turn. The server returns exactly one of:\n *  - `answer`  — a read-only answer (questions; an ontology INSPECT) with SPARQL.\n *  - `clarify` — the agent needs more detail; ask the user `question`.\n *  - `plan`    — a proposed (un-executed) plan with `plan_id` + `steps`; confirm\n *                by calling `agent({ confirmPlanId: plan_id })`.\n *  - `result`  — the outcome of executing a confirmed plan, per-step.\n *  - `error`   — e.g. an unknown/expired plan_id on confirm.\n * Extra fields vary by kind (answer/sparql/rows; question; plan_id/steps;\n * steps), so this is intentionally open beyond the discriminant.\n */\nexport interface AgentResult {\n  kind: \"answer\" | \"clarify\" | \"plan\" | \"result\" | \"error\";\n  [key: string]: unknown;\n}\n"],"mappings":"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","names":["text"]}

package/dist/cli.js

@@ -2,8 +2,12 @@
 import {
   Client,
   CographError
-} from "./chunk-RBRPNURW.js";
-import "./chunk-7VVBEUZQ.js";
+} from "./chunk-O3L4FCRY.js";
+import {
+  configPathForDisplay,
+  readConfig,
+  writeConfig
+} from "./chunk-7VVBEUZQ.js";
 
 // src/cli.ts
 import { createInterface } from "readline";
@@ -21,7 +25,11 @@ function pkgVersion() {
   }
 }
 function client() {
-  return new Client();
+  const g = program.opts();
+  return new Client({
+    ...g.tenant ? { tenant: g.tenant } : {},
+    ...g.local ? { baseUrl: "http://localhost:8000" } : {}
+  });
 }
 function fail(msg, code = 1) {
   process.stderr.write(msg.endsWith("\n") ? msg : msg + "\n");
@@ -46,9 +54,144 @@ async function confirm(prompt) {
     });
   });
 }
+async function confirmYes(prompt) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(`${prompt} [Y/n] `, (ans) => {
+      rl.close();
+      const a = ans.trim().toLowerCase();
+      resolve(a === "" || a === "y" || a === "yes");
+    });
+  });
+}
+var useColor = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+var sgr = (code) => (s) => useColor ? `\x1B[${code}m${s}\x1B[0m` : s;
+var bold = sgr("1");
+var dim = sgr("2");
+function entityViews(m) {
+  if (Array.isArray(m.entities) && m.entities.length > 0) {
+    return m.entities.map((e) => ({
+      name: e.name,
+      type_name: e.type_name,
+      id_column: e.id_column,
+      id_from: e.id_from,
+      key_strategy: e.key_strategy ?? null,
+      confidence: e.confidence,
+      why: e.why
+    }));
+  }
+  return [
+    {
+      name: m.entity_type,
+      type_name: m.entity_type,
+      key_strategy: m.key_strategy ?? null,
+      confidence: m.confidence,
+      why: m.why
+    }
+  ];
+}
+function heldTypes(m) {
+  const types = m.ontology_extensions?.types;
+  return Array.isArray(types) ? types.filter((t) => t.held_for_review) : [];
+}
+function buildMappingForIngest(m, approved) {
+  const out = { entity_type: m.entity_type, columns: m.columns };
+  if (m.entities) out.entities = m.entities;
+  if (m.relationships) out.relationships = m.relationships;
+  const types = m.ontology_extensions?.types;
+  if (Array.isArray(types)) {
+    out.ontology_extensions = {
+      types: types.filter(
+        (t) => !t.held_for_review || approved.has(t.type_name)
+      )
+    };
+  }
+  return out;
+}
+function fmtConf(v) {
+  if (v == null) return "";
+  const n = Number(v);
+  if (Number.isNaN(n)) return "";
+  return dim(` (${n.toFixed(2)}${n < 0.7 ? " !" : ""})`);
+}
+function renderMapping(m, info) {
+  const w = (s) => process.stdout.write(s);
+  w(
+    "\n" + bold("Proposed schema") + dim(
+      `  (profiled ${info.rowsProfiled.toLocaleString()} of ${info.totalRows.toLocaleString()} rows)`
+    ) + "\n"
+  );
+  w(dim("Review how the data maps to the graph before any rows are written.") + "\n\n");
+  const ents = entityViews(m);
+  const multi = Array.isArray(m.entities) && m.entities.length > 0;
+  w(bold("Entities & keys") + "\n");
+  for (const e of ents) {
+    const key = e.id_column ? `key: ${e.id_column}` : e.id_from && e.id_from.length ? `key: ${e.id_from.join(" + ")}` : e.key_strategy === "synthetic" ? "key: (synthetic)" : "key: \u2014";
+    w(`  \u2022 ${bold(e.type_name)}  ${dim(key)}${fmtConf(e.confidence)}
+`);
+    if (e.why) w(`      ${dim(e.why)}
+`);
+    const cols = (m.columns ?? []).filter(
+      (col) => multi ? col.entity === e.name : true
+    );
+    for (const col of cols) {
+      const role = col.role === "type_id" ? "key " : col.role === "relationship" ? "edge" : "attr";
+      let detail = "";
+      if (col.role === "relationship" && col.target_type)
+        detail = ` \u2192 ${col.target_type}`;
+      else if (col.role === "attribute" && col.attribute_name && col.attribute_name !== col.column_name)
+        detail = ` as ${col.attribute_name}`;
+      const dt = col.datatype && col.datatype !== "string" ? " " + dim(`[${col.datatype}]`) : "";
+      w(
+        `      ${dim("[" + role + "]")} ${col.column_name}${detail}${dt}${fmtConf(col.confidence)}
+`
+      );
+    }
+  }
+  const rels = m.relationships ?? [];
+  if (rels.length) {
+    w("\n" + bold("Edges") + "\n");
+    for (const r of rels)
+      w(`  \u2022 ${r.subject} ${dim(r.predicate)} ${r.object}${fmtConf(r.confidence)}
+`);
+  }
+  const vio = m.violations ?? [];
+  if (vio.length) {
+    w(
+      "\n" + dim(
+        `Refute pass corrected ${vio.length} issue${vio.length === 1 ? "" : "s"}: ${vio.map((v) => v.template).join(", ")}`
+      ) + "\n"
+    );
+  }
+}
+async function reviewMapping(m, info) {
+  renderMapping(m, info);
+  const approved = /* @__PURE__ */ new Set();
+  const held = heldTypes(m);
+  if (held.length) {
+    process.stdout.write(
+      "\n" + bold(`${held.length} new type${held.length === 1 ? "" : "s"} held for review`) + dim(" \u2014 approve to create, or skip to leave for later") + "\n"
+    );
+    for (const t of held) {
+      const from = t.promoted_from_attribute ? dim(` (from "${t.promoted_from_attribute}")`) : "";
+      process.stdout.write(`  \u2022 ${t.type_name}${from}${fmtConf(t.confidence)}
+`);
+      if (await confirm(`    Approve "${t.type_name}"?`)) approved.add(t.type_name);
+    }
+  }
+  process.stdout.write("\n");
+  const ok = await confirmYes(
+    `Apply this mapping and ingest ${info.totalRows.toLocaleString()} rows?`
+  );
+  if (!ok) return null;
+  return buildMappingForIngest(m, approved);
+}
 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-R5EEHLZJ.js");
+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)").option(
+  "--tenant <id>",
+  "Target a specific tenant for this command (overrides the saved default)"
+).action(async (opts) => {
+  const { runShell } = await import("./shell-ILZ322LT.js");
   await runShell({
     local: opts.local,
     // commander's --no-login inverts: opts.login === false when flag passed.
@@ -90,9 +233,60 @@ kg.command("delete <name>").description("Delete a knowledge graph").action(async
 `);
   });
 });
+var tenantCmd = program.command("tenant").description("Show or switch the active tenant");
+tenantCmd.command("current", { isDefault: true }).description("Show the active tenant").action(() => {
+  const active = client().tenant;
+  const saved = readConfig().tenant;
+  process.stdout.write(`Active tenant: ${bold(active)}
+`);
+  process.stdout.write(
+    saved ? dim(`  saved default in ${configPathForDisplay()}
+`) : dim(`  (built-in default \u2014 set one with: cograph tenant use <id>)
+`)
+  );
+});
+tenantCmd.command("list").description("List the tenants you can access").action(async () => {
+  await withErrors(async () => {
+    const c = client();
+    let tenants;
+    try {
+      tenants = await c.listTenants();
+    } catch (err) {
+      if (err instanceof CographError && err.status === 501) {
+        fail(
+          "This backend doesn't support tenant management (no tenant provider configured)."
+        );
+      }
+      throw err;
+    }
+    if (!tenants.length) {
+      process.stdout.write("No tenants found for your account.\n");
+      return;
+    }
+    const active = c.tenant;
+    for (const t of tenants) {
+      const marker = t.id === active ? "*" : " ";
+      process.stdout.write(`  ${marker} ${t.id.padEnd(24)} ${dim(t.label)}
+`);
+    }
+    process.stdout.write(dim(`
+Switch with: cograph tenant use <id>
+`));
+  });
+});
+tenantCmd.command("use <id>").description("Set the active tenant (saved to ~/.cograph/config.json)").action((id) => {
+  writeConfig({ tenant: id });
+  process.stdout.write(`${bold("\u2713")} Active tenant set to ${bold(id)}
+`);
+  process.stdout.write(dim(`Saved to ${configPathForDisplay()}
+`));
+});
 program.command("ingest [file]").description("Ingest data from a file or --text").option("-t, --text <text>", "Inline text to ingest").option("--kg <name>", "Target knowledge graph name").option(
   "-f, --format <fmt>",
   "Override format detection (text|csv|json)"
+).option(
+  "-y, --yes",
+  "Skip the CSV schema review and apply the inferred mapping non-interactively"
 ).action(
   async (file, opts) => {
     await withErrors(async () => {
@@ -112,12 +306,24 @@ program.command("ingest [file]").description("Ingest data from a file or --text"
       if (!file) {
         fail("Provide a file or --text");
       }
+      const interactive = Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY) && !opts.yes;
+      const onSchemaInferred = interactive ? reviewMapping : (m) => Promise.resolve(
+        buildMappingForIngest(
+          m,
+          new Set(heldTypes(m).map((t) => t.type_name))
+        )
+      );
       process.stdout.write(`Ingesting ${file}...
 `);
       const result = await c.ingest(file, {
         kg: opts.kg,
-        contentType: opts.format
+        contentType: opts.format,
+        onSchemaInferred
       });
+      if (result.cancelled) {
+        process.stdout.write("Cancelled \u2014 nothing was written.\n");
+        return;
+      }
       printIngestResult(result);
     });
   }
@@ -436,7 +642,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-R5EEHLZJ.js");
+    const { runShell } = await import("./shell-ILZ322LT.js");
     await runShell({
       kg: opts.kg,
       local: opts.local || parentOpts.local,