@aliyunrds/ctxdb 1.0.8-beta.4 → 1.0.8

package/dist/{chunk-WJTV7JNR.js → chunk-AAWG5SPO.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   listKnowledgeBases
-} from "./chunk-ZW7YXNJ6.js";
+} from "./chunk-LZD55CWE.js";
 import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-5DGRNP55.js";
+} from "./chunk-MWAFAK5M.js";
 import {
   CtxdbError,
   isDataApiReady,
   resolveDataApiCredential
-} from "./chunk-SVO6H62S.js";
+} from "./chunk-3FAQREIU.js";
 
 // src/lib/kb-catalog.ts
 function sanitizeKeyEntities(raw) {

package/dist/{chunk-O6MKQ2I3.js → chunk-AH2QEUK4.js}

@@ -2,7 +2,7 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-WJTV7JNR.js";
+} from "./chunk-AAWG5SPO.js";
 
 // src/lib/user-prompt-submit-compose.ts
 async function composeUserPromptSubmit(cfg, agent, client, prompt, sessionId = null) {

package/dist/{chunk-ZW7YXNJ6.js → chunk-LZD55CWE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CtxdbError
-} from "./chunk-SVO6H62S.js";
+} from "./chunk-3FAQREIU.js";
 
 // src/lib/kb.ts
 import {
@@ -90,14 +90,44 @@ async function listKnowledgeBases(client) {
   }
   return [];
 }
-async function createKb(client, kbName, description = "") {
-  return client.postJson(KB_COLLECTION, { name: kbName, description: description || "" });
+async function createKb(client, kbName, descriptionOrOptions = "") {
+  const options = typeof descriptionOrOptions === "string" ? { description: descriptionOrOptions } : descriptionOrOptions;
+  const body = {
+    name: kbName,
+    description: options.description ?? ""
+  };
+  if (options.graphEnabled !== void 0) body.graph_enabled = options.graphEnabled;
+  if (options.reviewEnabled !== void 0) body.review_enabled = options.reviewEnabled;
+  return client.postJson(KB_COLLECTION, body);
 }
-async function uploadText(client, kbName, docName, text, mimeType = "text/plain", filePath) {
-  return client.postJson(
-    DOCUMENTS,
-    buildTextDocumentBody(kbName, docName, text, mimeType, filePath)
-  );
+function knowledgeBaseLocatorParams(locator) {
+  if ("knowledgeBaseId" in locator && locator.knowledgeBaseId.trim() !== "") {
+    return { knowledge_base_id: locator.knowledgeBaseId };
+  }
+  if ("knowledgeBaseName" in locator && locator.knowledgeBaseName.trim() !== "") {
+    return { knowledge_base_name: locator.knowledgeBaseName };
+  }
+  throw new CtxdbError("knowledge base locator must be a non-empty ID or name");
+}
+function getKb(client, locator) {
+  return client.get(KB_DETAIL, knowledgeBaseLocatorParams(locator));
+}
+function updateKb(client, knowledgeBaseId, options) {
+  const body = {};
+  if (options.knowledgeBaseName !== void 0) body.knowledge_base_name = options.knowledgeBaseName;
+  if (options.description !== void 0) body.description = options.description;
+  if (options.graphEnabled !== void 0) body.graph_enabled = options.graphEnabled;
+  if (options.reviewEnabled !== void 0) body.review_enabled = options.reviewEnabled;
+  if (Object.keys(body).length === 0) throw new CtxdbError("KB update requires at least one field");
+  return client.putJson(KB_COLLECTION, body, { knowledge_base_id: knowledgeBaseId });
+}
+function deleteKb(client, locator) {
+  return client.delete(KB_COLLECTION, knowledgeBaseLocatorParams(locator));
+}
+async function uploadText(client, kbName, docName, text, mimeType = "text/plain", filePath, reviewEnabled) {
+  const body = buildTextDocumentBody(kbName, docName, text, mimeType, filePath);
+  if (reviewEnabled !== void 0) body.review_enabled = reviewEnabled;
+  return client.postJson(DOCUMENTS, body);
 }
 async function updateText(client, locator, text) {
   const body = {
@@ -155,7 +185,8 @@ async function uploadFile(client, kbName, localPath, options = {}) {
       mode: "create",
       kbName,
       docName: options.docName,
-      filePath: options.filePath
+      filePath: options.filePath,
+      reviewEnabled: options.reviewEnabled
     },
     localPath,
     options.timeoutMs
@@ -178,7 +209,8 @@ async function writeFile(client, target, localPath, requestedTimeoutMs) {
   const fields = target.mode === "create" ? {
     knowledge_base_name: target.kbName,
     name: target.docName ?? filename,
-    ...target.filePath ? { file_path: target.filePath } : {}
+    ...target.filePath ? { file_path: target.filePath } : {},
+    ...target.reviewEnabled === void 0 ? {} : { review_enabled: String(target.reviewEnabled) }
   } : buildUpdateLocatorFields(target.locator);
   const timeoutMs = requestedTimeoutMs ?? DEFAULT_FILE_UPLOAD_TIMEOUT_MS;
   try {
@@ -237,6 +269,7 @@ async function writeFileInChunks(client, options) {
     initParams.knowledge_base_id = expectedKnowledgeBaseId;
     initParams.name = options.target.docName ?? options.filename;
     if (options.target.filePath) initParams.file_path = options.target.filePath;
+    if (options.target.reviewEnabled !== void 0) initParams.review_enabled = options.target.reviewEnabled;
   } else if ("documentId" in options.target.locator) {
     initParams.document_id = options.target.locator.documentId;
   } else {
@@ -614,6 +647,233 @@ function minimalChunk(raw) {
 function minimalKbQueryResponse(raw) {
   return projectKbQueryResponse(raw, minimalChunk);
 }
+var GRAPH_ENTITIES = "/v1/knowledge/entities";
+var GRAPH_ENTITY_DETAIL = "/v1/knowledge/entities/detail";
+var GRAPH_ENTITY_CHUNKS = "/v1/knowledge/entities/chunks";
+var GRAPH_ENTITY_RELATIONS = "/v1/knowledge/entity-relations";
+async function listKnowledgeEntities(client, params = {}) {
+  return client.get(GRAPH_ENTITIES, params);
+}
+async function getKnowledgeEntity(client, knowledgeBaseId, entityId) {
+  return client.get(GRAPH_ENTITY_DETAIL, {
+    knowledge_base_id: knowledgeBaseId,
+    entity_id: entityId
+  });
+}
+async function listKnowledgeEntityChunks(client, knowledgeBaseId, entityIds, limit) {
+  const params = {
+    knowledge_base_id: knowledgeBaseId,
+    entity_ids: entityIds.join(",")
+  };
+  if (limit !== void 0) params.limit = limit;
+  return client.get(GRAPH_ENTITY_CHUNKS, params);
+}
+async function listKnowledgeEntityRelations(client, params = {}) {
+  const { entity_ids, ...rest } = params;
+  return client.get(GRAPH_ENTITY_RELATIONS, {
+    ...rest,
+    ...entity_ids !== void 0 ? { entity_ids: entity_ids.join(",") } : {}
+  });
+}
+function graphRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function graphFieldArray(record, field) {
+  return Array.isArray(record[field]) ? record[field] : [];
+}
+function graphString(record, field) {
+  const value = record[field];
+  return typeof value === "string" ? value : "";
+}
+function graphStringArray(record, field) {
+  return graphFieldArray(record, field).filter(
+    (item) => typeof item === "string"
+  );
+}
+function graphNumber(record, field) {
+  const value = record[field];
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function graphBoolean(record, field) {
+  const value = record[field];
+  return typeof value === "boolean" ? value : void 0;
+}
+function minimalGraphEntity(raw) {
+  const r = graphRecord(raw);
+  const out = {
+    entity_id: graphString(r, "entity_id"),
+    entity_name: graphString(r, "entity_name"),
+    entity_type: graphString(r, "entity_type")
+  };
+  const matchType = graphString(r, "match_type");
+  if (matchType !== "") out.match_type = matchType;
+  const score = graphNumber(r, "score");
+  if (score !== void 0) out.score = score;
+  return out;
+}
+function compactGraphEntity(raw) {
+  const r = graphRecord(raw);
+  const out = {
+    ...minimalGraphEntity(raw),
+    knowledge_base_id: graphString(r, "knowledge_base_id"),
+    description: graphString(r, "description"),
+    aliases: graphStringArray(r, "aliases"),
+    source_document_ids: graphStringArray(r, "source_document_ids")
+  };
+  const sourceDocumentCount = graphNumber(r, "source_document_count");
+  if (sourceDocumentCount !== void 0) out.source_document_count = sourceDocumentCount;
+  const pagerank = graphNumber(r, "pagerank");
+  if (pagerank !== void 0) out.pagerank = pagerank;
+  const updatedAt = graphString(r, "updated_at");
+  if (updatedAt !== "") out.updated_at = updatedAt;
+  return out;
+}
+function projectGraphEntityList(raw, projectItem) {
+  const r = graphRecord(raw);
+  const out = {
+    entities: graphFieldArray(r, "entities").map(projectItem)
+  };
+  const total = graphNumber(r, "total");
+  if (total !== void 0) out.total = total;
+  const page = graphNumber(r, "page");
+  if (page !== void 0) out.page = page;
+  const pageSize = graphNumber(r, "page_size");
+  if (pageSize !== void 0) out.page_size = pageSize;
+  return out;
+}
+function minimalGraphEntityListResponse(raw) {
+  return projectGraphEntityList(raw, minimalGraphEntity);
+}
+function compactGraphEntityListResponse(raw) {
+  return projectGraphEntityList(raw, compactGraphEntity);
+}
+function minimalGraphEntityDetail(response) {
+  const data = graphRecord(unwrapBox(response, "entity detail"));
+  return {
+    entity_id: graphString(data, "entity_id"),
+    entity_name: graphString(data, "entity_name"),
+    entity_type: graphString(data, "entity_type"),
+    description: graphString(data, "description")
+  };
+}
+function compactGraphEntityDetail(response) {
+  const data = graphRecord(unwrapBox(response, "entity detail"));
+  const out = {
+    ...minimalGraphEntityDetail(response),
+    knowledge_base_id: graphString(data, "knowledge_base_id"),
+    aliases: graphStringArray(data, "aliases"),
+    source_document_ids: graphStringArray(data, "source_document_ids")
+  };
+  const updatedAt = graphString(data, "updated_at");
+  if (updatedAt !== "") out.updated_at = updatedAt;
+  return out;
+}
+function minimalEntitySourceChunk(raw) {
+  const r = graphRecord(raw);
+  const out = { content: graphString(r, "content") };
+  const matched = graphStringArray(r, "matched_entity_ids");
+  if (matched.length > 0) out.matched_entity_ids = matched;
+  return out;
+}
+function compactEntitySourceChunk(raw) {
+  const r = graphRecord(raw);
+  const out = {
+    ...minimalEntitySourceChunk(raw),
+    chunk_id: graphString(r, "chunk_id"),
+    document_id: graphString(r, "document_id"),
+    document_name: graphString(r, "document_name"),
+    knowledge_base_id: graphString(r, "knowledge_base_id")
+  };
+  const chunkIndex = graphNumber(r, "chunk_index");
+  if (chunkIndex !== void 0) out.chunk_index = chunkIndex;
+  const tocPath = graphString(r, "toc_path");
+  if (tocPath !== "") out.toc_path = tocPath;
+  return out;
+}
+function projectEntityChunks(raw, projectChunk) {
+  const r = graphRecord(raw);
+  const out = {
+    chunks: graphFieldArray(r, "chunks").map(projectChunk)
+  };
+  const knowledgeBaseId = graphString(r, "knowledge_base_id");
+  if (knowledgeBaseId !== "") out.knowledge_base_id = knowledgeBaseId;
+  const entityIds = graphStringArray(r, "entity_ids");
+  if (entityIds.length > 0) out.entity_ids = entityIds;
+  const total = graphNumber(r, "total");
+  if (total !== void 0) out.total = total;
+  const candidateTotal = graphNumber(r, "candidate_total");
+  if (candidateTotal !== void 0) out.candidate_total = candidateTotal;
+  const truncated = graphBoolean(r, "truncated");
+  if (truncated !== void 0) out.truncated = truncated;
+  return out;
+}
+function minimalEntityChunksResponse(raw) {
+  return projectEntityChunks(raw, minimalEntitySourceChunk);
+}
+function compactEntityChunksResponse(raw) {
+  return projectEntityChunks(raw, compactEntitySourceChunk);
+}
+function minimalGraphRelation(raw) {
+  const r = graphRecord(raw);
+  return {
+    source_entity_id: graphString(r, "source_entity_id"),
+    source_entity_name: graphString(r, "source_entity_name"),
+    relation_type: graphString(r, "relation_type"),
+    target_entity_id: graphString(r, "target_entity_id"),
+    target_entity_name: graphString(r, "target_entity_name")
+  };
+}
+function compactGraphRelation(raw) {
+  const r = graphRecord(raw);
+  const out = {
+    ...minimalGraphRelation(raw),
+    knowledge_base_id: graphString(r, "knowledge_base_id"),
+    relation_id: graphString(r, "relation_id"),
+    description: graphString(r, "description"),
+    keywords: graphStringArray(r, "keywords")
+  };
+  const weight = graphNumber(r, "weight");
+  if (weight !== void 0) out.weight = weight;
+  const updatedAt = graphString(r, "updated_at");
+  if (updatedAt !== "") out.updated_at = updatedAt;
+  return out;
+}
+function graphRelationNode(raw) {
+  const r = graphRecord(raw);
+  const out = {
+    knowledge_base_id: graphString(r, "knowledge_base_id"),
+    entity_id: graphString(r, "entity_id"),
+    entity_name: graphString(r, "entity_name"),
+    entity_type: graphString(r, "entity_type")
+  };
+  const description = graphString(r, "description");
+  if (description !== "") out.description = description;
+  const sourceDocumentIds = graphStringArray(r, "source_document_ids");
+  if (sourceDocumentIds.length > 0) out.source_document_ids = sourceDocumentIds;
+  return out;
+}
+function projectGraphRelationList(raw, projectItem, options) {
+  const r = graphRecord(raw);
+  const out = {
+    relations: graphFieldArray(r, "relations").map(projectItem)
+  };
+  const total = graphNumber(r, "total");
+  if (total !== void 0) out.total = total;
+  const page = graphNumber(r, "page");
+  if (page !== void 0) out.page = page;
+  const pageSize = graphNumber(r, "page_size");
+  if (pageSize !== void 0) out.page_size = pageSize;
+  if (options.includeNodes) {
+    out.nodes = graphFieldArray(r, "nodes").map(graphRelationNode);
+  }
+  return out;
+}
+function minimalGraphRelationListResponse(raw) {
+  return projectGraphRelationList(raw, minimalGraphRelation, { includeNodes: false });
+}
+function compactGraphRelationListResponse(raw) {
+  return projectGraphRelationList(raw, compactGraphRelation, { includeNodes: true });
+}
 
 export {
   DEFAULT_INGEST_TIMEOUT_MS,
@@ -621,6 +881,9 @@ export {
   DEFAULT_FILE_UPLOAD_TIMEOUT_MS,
   listKnowledgeBases,
   createKb,
+  getKb,
+  updateKb,
+  deleteKb,
   uploadText,
   updateText,
   uploadFile,
@@ -631,5 +894,17 @@ export {
   pollIngest,
   pollIngestByKnowledgeBaseId,
   compactKbQueryResponse,
-  minimalKbQueryResponse
+  minimalKbQueryResponse,
+  listKnowledgeEntities,
+  getKnowledgeEntity,
+  listKnowledgeEntityChunks,
+  listKnowledgeEntityRelations,
+  minimalGraphEntityListResponse,
+  compactGraphEntityListResponse,
+  minimalGraphEntityDetail,
+  compactGraphEntityDetail,
+  minimalEntityChunksResponse,
+  compactEntityChunksResponse,
+  minimalGraphRelationListResponse,
+  compactGraphRelationListResponse
 };

package/dist/{chunk-5DGRNP55.js → chunk-MWAFAK5M.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   configDir
-} from "./chunk-SVO6H62S.js";
+} from "./chunk-3FAQREIU.js";
 
 // src/lib/circuit.ts
 import { statSync, writeFileSync, unlinkSync, mkdirSync, readdirSync, readFileSync } from "fs";

package/dist/{chunk-6MEWI73Y.js → chunk-RRDQCZJ4.js}

@@ -2,10 +2,10 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-WJTV7JNR.js";
+} from "./chunk-AAWG5SPO.js";
 import {
   debug
-} from "./chunk-SVO6H62S.js";
+} from "./chunk-3FAQREIU.js";
 
 // src/lib/warmup-recall.ts
 import { execSync } from "child_process";

package/dist/{chunk-76AXXLVE.js → chunk-YTCXHO4F.js}

@@ -4,13 +4,13 @@ import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-5DGRNP55.js";
+} from "./chunk-MWAFAK5M.js";
 import {
   CtxdbError,
   debug,
   isDataApiReady,
   isDebug
-} from "./chunk-SVO6H62S.js";
+} from "./chunk-3FAQREIU.js";
 
 // src/lib/capture-orchestrator.ts
 import {