npm - @aliyunrds/ctxdb - Versions diffs - 1.0.6-beta.0 → 1.0.7 - Mend

@aliyunrds/ctxdb 1.0.6-beta.0 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/README.md +51 -12
package/dist/{chunk-6BB65W5W.js → chunk-DC5NWGDW.js} +2 -2
package/dist/{chunk-VHNHVMCA.js → chunk-DPLMBHLU.js} +3 -3
package/dist/{chunk-BHRWAU3E.js → chunk-NFTGG6WK.js} +2 -2
package/dist/{chunk-L4GVGVOP.js → chunk-QVXDI77N.js} +235 -43
package/dist/{chunk-7EIJB5LA.js → chunk-R2QS6ACP.js} +1 -1
package/dist/{chunk-ARZX2RLR.js → chunk-S5W4FQ7M.js} +27 -10
package/dist/{chunk-B7JCQL4O.js → chunk-X2BX6LR6.js} +1 -1
package/dist/cli/main.js +121 -4
package/dist/hooks/hermes-post-llm-call.js +3 -3
package/dist/hooks/hermes-pre-llm-call.js +6 -6
package/dist/hooks/session-start.js +5 -5
package/dist/hooks/stop.js +3 -3
package/dist/hooks/user-prompt-submit.js +5 -5
package/dist/setup/skills/contextdb-knowledge/SKILL.md +46 -8
package/dist/setup/skills/contextdb-memory/SKILL.md +1 -1
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -217,7 +217,7 @@ For **qoder**, **qoderwork**, **qwenwork**, **codex**, and **claude**, hooks fir
 |---|---|---|
 | Session starts | `SessionStart` | Build a short cwd/git-signal query, recall relevant memories, and inject warm-up context as `additionalContext` |
 | User submits a prompt | `UserPromptSubmit` | Search `/v3/memories/search/`, format a `<recalled-memories>` block, inject as additional context. **By default only memory is recalled.** Set `recall_knowledge: true` in the selected agent config to also pull KB context into an `<external-knowledge>` block; graph synthesis and document evidence are labeled separately inside that wrapper. Otherwise the recommended path for KB is the agent calling `ctxdb kb search --agent <name>` explicitly when the user asks (see SKILL.md) |
-| Agent finishes its turn | `Stop` | Read transcript, detect KB-upload turns and skip capture (so uploaded content doesn't bleed into long-term memory), slice the current turn, sanitize the input, POST to memory store |
+| Agent finishes its turn | `Stop` | Read transcript, detect KB create/update turns and skip capture (so document content doesn't bleed into long-term memory), slice the current turn, sanitize the input, POST to memory store |
 Implementation note: qoder/Claude consume the JSON `hookSpecificOutput.additionalContext` shape; Codex has been verified on this machine through `~/.codex/hooks.json`, `[features].hooks = true`, and hook audit logs, where non-empty stdout from `UserPromptSubmit`/`SessionStart` is treated as injected context. The same hook core is shared; setup passes `--agent=<name>` so each hook reads its own config section.
@@ -227,7 +227,7 @@ For **hermes**, `ctxdb setup --agent hermes` writes two shell hooks under `~/.he
 - `pre_llm_call` maps to recall on each user prompt and first-turn warmup. Hermes does not persist hook context into conversation history, so ctxdb re-injects the KB catalog on every user turn even when `kb_catalog_injection` keeps its default `"session_start"` value; this prevents the catalog from disappearing after turn one.
 - stdout uses Hermes' `{"context":"..."}` protocol.
-- `post_llm_call` captures `extra.user_message` + `extra.assistant_response` without a transcript file, while `extra.conversation_history` supplies current-turn tool calls for the B-3c KB-upload guard.
+- `post_llm_call` captures `extra.user_message` + `extra.assistant_response` without a transcript file, while `extra.conversation_history` supplies current-turn tool calls for the B-3c KB create/update guard.
 ## CLI
@@ -235,7 +235,7 @@ For **hermes**, `ctxdb setup --agent hermes` writes two shell hooks under `~/.he
 - **Top-level**: `setup` / `status` / `ping` / `debug` / `uninstall` / `update` (`upgrade` alias)
 - **Memory**: `memory add|search|list|get|update|delete`
-- **KB**: `kb upload-text|upload-file|list|documents-list|document-get|search`
+- **KB**: `kb upload-text|upload-file|update-text|update-file|list|documents-list|document-get|search`
 See `ctxdb --help`.
@@ -293,10 +293,10 @@ fact-extraction). Use it when the user explicitly asks for a verbatim
 memory ("记住 / 请记忆 / 原文记下"); without `--no-infer` the server may
 rewrite, merge, or skip details.
-### KB upload completion mode
+### KB create/update completion mode
-**Breaking change:** `kb upload-text` and `kb upload-file` now return as soon
-as the service accepts the document. The returned document may still have
+`kb upload-text`, `kb upload-file`, `kb update-text`, and `kb update-file`
+return as soon as the service accepts the document. The returned document may still have
 `ingest_status: "processing"`; acceptance does not mean ingestion succeeded.
 - Add `--wait` when a script needs the previous behavior: poll until ingestion
@@ -309,23 +309,62 @@ Scripts that relied on implicit terminal polling must migrate to:
 ```sh
 ctxdb kb upload-text <kb-name> <doc-name> --text="<body>" --wait
 ctxdb kb upload-file <kb-name> <local-path> --wait
+ctxdb kb update-text <document-id> --text="<body>" --wait
+ctxdb kb update-file <document-id> <local-path> --wait
 ```
+### Explicit KB document updates
+Create and update are separate operations. `upload-text` / `upload-file` use
+create-only POST routes, so an existing logical document produces HTTP 409 and
+is never silently overwritten. `update-text` / `update-file` use PUT and accept
+exactly one locator family: the canonical document ID (preferred), or an
+explicit knowledge-base name + logical document name + optional normalized
+`--file-path`.
+```sh
+# Preferred: no KB/name/path lookup or reconstruction
+ctxdb kb update-text <document-id> --text="<new-body>"
+ctxdb kb update-file <document-id> <local-path>
+# Alternative when the exact document ID is unavailable
+ctxdb kb update-text --kb-name=<kb-name> --doc-name=<logical-name> --text="<new-body>" [--file-path=<logical-parent>]
+ctxdb kb update-file <local-path> --kb-name=<kb-name> [--doc-name=<existing-logical-name>] [--file-path=<logical-parent>]
+```
+Do not combine a positional document ID with `--kb-name`, `--doc-name`, or
+`--file-path`. ID mode derives the existing document's KB and logical metadata
+on the server; a replacement file's basename remains only its physical upload
+filename. Logical-key file mode defaults `--doc-name` to that basename, so pass
+the existing logical name when the replacement basename differs.
+Every successful update returns the canonical `document.id` and
+`document.knowledge_base_id`. Changed content can replace the input ID, while
+same-content updates may reuse it. Callers must retain the returned ID for the
+next update; `--wait` also polls the returned ID/KB pair rather than caller input.
 ### KB file upload policy and large files
-`kb upload-file` does not maintain a client-side format allowlist or file-size
+`kb upload-file` and `kb update-file` do not maintain a client-side format allowlist or file-size
 table. It validates only that the local path exists, is a readable regular
 file, then lets the service decide whether the format, per-type size, quota,
 and logical document identity are acceptable. Unknown extensions are sent as
 `application/octet-stream`.
 File bytes are streamed from disk with a known multipart size; the CLI does
-not read the complete file into a Buffer. It always attempts the ordinary
-upload endpoint first. If the service returns the dedicated
+not read the complete file into a Buffer. Each command attempts its ordinary
+direct endpoint first. If the service returns the dedicated
 `KNOWLEDGE_DIRECT_UPLOAD_REQUIRES_CHUNK` error (`errorCode=6001`) or an
-unstructured HTTP 413, the CLI resolves the KB ID and automatically uses the
-chunk init/part/complete protocol. `--doc-name` and `--file-path` have the same
-logical meaning in both modes.
+unstructured HTTP 413, the CLI automatically uses the chunk init/part/complete
+protocol. Create init uses POST and update init uses PUT; parts, complete, and
+abort stay on POST. Document-ID update init sends the ID and physical filename
+without resolving a KB. Logical-key update init resolves the KB and sends the
+same KB/name/path identity as direct mode.
+Chunk init and complete accept the release_pre bare response objects. Create
+also accepts the previous `Box.data` init/complete shape during rolling
+deployment; part and abort responses remain Box-wrapped. This response-shape
+compatibility does not fall back from logical-key PUT to an older update contract.
 The first chunk-routing release intentionally sends init, each part, and
 complete only once. It does not automatically retry timeout, connection-loss,

package/dist/{chunk-6BB65W5W.js → chunk-DC5NWGDW.js} RENAMED Viewed

@@ -4,12 +4,12 @@ import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-B7JCQL4O.js";
+} from "./chunk-X2BX6LR6.js";
 import {
   CtxdbError,
   debug,
   isDebug
-} from "./chunk-ARZX2RLR.js";
+} from "./chunk-S5W4FQ7M.js";
 // src/lib/capture-orchestrator.ts
 import {

package/dist/{chunk-VHNHVMCA.js → chunk-DPLMBHLU.js} RENAMED Viewed

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   listKnowledgeBases
-} from "./chunk-L4GVGVOP.js";
+} from "./chunk-QVXDI77N.js";
 import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-B7JCQL4O.js";
+} from "./chunk-X2BX6LR6.js";
 import {
   CtxdbError
-} from "./chunk-ARZX2RLR.js";
+} from "./chunk-S5W4FQ7M.js";
 // src/lib/kb-catalog.ts
 function sanitizeKeyEntities(raw) {

package/dist/{chunk-BHRWAU3E.js → chunk-NFTGG6WK.js} RENAMED Viewed

@@ -2,10 +2,10 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-VHNHVMCA.js";
+} from "./chunk-DPLMBHLU.js";
 import {
   debug
-} from "./chunk-ARZX2RLR.js";
+} from "./chunk-S5W4FQ7M.js";
 // src/lib/warmup-recall.ts
 import { execSync } from "child_process";

package/dist/{chunk-L4GVGVOP.js → chunk-QVXDI77N.js} RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CtxdbError
-} from "./chunk-ARZX2RLR.js";
+} from "./chunk-S5W4FQ7M.js";
 // src/lib/kb.ts
 import {
@@ -94,6 +94,51 @@ async function createKb(client, kbName, description = "") {
   return client.postJson(KB_COLLECTION, { name: kbName, description: description || "" });
 }
 async function uploadText(client, kbName, docName, text, mimeType = "text/plain", filePath) {
+  return client.postJson(
+    DOCUMENTS,
+    buildTextDocumentBody(kbName, docName, text, mimeType, filePath)
+  );
+}
+async function updateText(client, locator, text) {
+  const body = {
+    ...buildUpdateLocatorFields(locator),
+    text
+  };
+  const response = await client.putJson(DOCUMENTS, body);
+  return readCanonicalUpdateDocument(response, "text update");
+}
+function buildUpdateLocatorFields(locator) {
+  if (!locator || typeof locator !== "object") {
+    throw new CtxdbError("update requires exactly one document locator");
+  }
+  const candidate = locator;
+  const hasDocumentId = Object.hasOwn(candidate, "documentId");
+  const hasLogicalField = ["kbName", "docName", "filePath"].some((field) => Object.hasOwn(candidate, field));
+  if (hasDocumentId === hasLogicalField) {
+    throw new CtxdbError("update requires exactly one document locator");
+  }
+  if (hasDocumentId) {
+    if (typeof candidate.documentId !== "string" || candidate.documentId.trim() === "") {
+      throw new CtxdbError("update requires a non-empty document ID");
+    }
+    return { document_id: candidate.documentId };
+  }
+  if (typeof candidate.kbName !== "string" || candidate.kbName.trim() === "" || typeof candidate.docName !== "string" || candidate.docName.trim() === "") {
+    throw new CtxdbError("logical update requires KB name and document name");
+  }
+  if (candidate.filePath !== void 0 && (typeof candidate.filePath !== "string" || candidate.filePath.trim() === "")) {
+    throw new CtxdbError("logical update file path must be a non-empty string");
+  }
+  const fields = {
+    knowledge_base_name: candidate.kbName,
+    name: candidate.docName
+  };
+  if (typeof candidate.filePath === "string") {
+    fields.file_path = candidate.filePath;
+  }
+  return fields;
+}
+function buildTextDocumentBody(kbName, docName, text, mimeType, filePath) {
   const body = {
     knowledge_base_name: kbName,
     name: docName,
@@ -101,74 +146,133 @@ async function uploadText(client, kbName, docName, text, mimeType = "text/plain"
     mime_type: mimeType
   };
   if (filePath !== void 0 && filePath !== "") body.file_path = filePath;
-  return client.postJson(DOCUMENTS, body);
+  return body;
 }
 async function uploadFile(client, kbName, localPath, options = {}) {
-  const expanded = expandHome(localPath);
-  if (!existsSync(expanded)) throw new Error(`file not found: ${expanded}`);
-  const stat = statSync(expanded);
-  if (!stat.isFile()) throw new Error(`not a file: ${expanded}`);
-  try {
-    accessSync(expanded, fsConstants.R_OK);
-  } catch (error) {
-    throw new Error(
-      `file is not readable: ${expanded}${error?.message ? ` (${error.message})` : ""}`
-    );
-  }
+  return writeFile(
+    client,
+    {
+      mode: "create",
+      kbName,
+      docName: options.docName,
+      filePath: options.filePath
+    },
+    localPath,
+    options.timeoutMs
+  );
+}
+async function updateFile(client, locator, localPath, options = {}) {
+  buildUpdateLocatorFields(locator);
+  return writeFile(
+    client,
+    { mode: "update", locator },
+    localPath,
+    options.timeoutMs
+  );
+}
+async function writeFile(client, target, localPath, requestedTimeoutMs) {
+  const { expanded, stat } = inspectLocalFile(localPath);
   const filename = basename(expanded);
-  const docName = options.docName ?? filename;
   const mime = guessMime(expanded);
   const content = await openAsBlob(expanded, { type: mime });
-  const fields = {
-    knowledge_base_name: kbName,
-    name: docName
-  };
-  if (options.filePath !== void 0 && options.filePath !== "") {
-    fields.file_path = options.filePath;
-  }
-  const timeoutMs = options.timeoutMs ?? DEFAULT_FILE_UPLOAD_TIMEOUT_MS;
+  const fields = target.mode === "create" ? {
+    knowledge_base_name: target.kbName,
+    name: target.docName ?? filename,
+    ...target.filePath ? { file_path: target.filePath } : {}
+  } : buildUpdateLocatorFields(target.locator);
+  const timeoutMs = requestedTimeoutMs ?? DEFAULT_FILE_UPLOAD_TIMEOUT_MS;
   try {
-    return await client.postMultipart(
+    const response = target.mode === "create" ? await client.postMultipart(
+      FILES,
+      fields,
+      { file: { filename, content, mimeType: mime } },
+      { timeoutMs }
+    ) : await client.putMultipart(
       FILES,
       fields,
       { file: { filename, content, mimeType: mime } },
       { timeoutMs }
     );
+    return target.mode === "update" ? readCanonicalUpdateDocument(response, "file update") : response;
   } catch (error) {
     if (!shouldFallbackToChunk(error)) throw error;
   }
-  return uploadFileInChunks(client, {
-    kbName,
+  return writeFileInChunks(client, {
+    target,
     filename,
-    docName,
-    filePath: options.filePath,
     mime,
     content,
     fileSize: stat.size,
     timeoutMs
   });
 }
-async function uploadFileInChunks(client, options) {
-  const kb = await client.get(KB_DETAIL, {
-    knowledge_base_name: options.kbName
-  });
-  const knowledgeBaseId = readRequiredString(kb, "id", "knowledge base detail");
+function validateLocalFile(localPath) {
+  inspectLocalFile(localPath);
+}
+function inspectLocalFile(localPath) {
+  const expanded = expandHome(localPath);
+  if (!existsSync(expanded)) throw new Error(`file not found: ${expanded}`);
+  const stat = statSync(expanded);
+  if (!stat.isFile()) throw new Error(`not a file: ${expanded}`);
+  try {
+    accessSync(expanded, fsConstants.R_OK);
+  } catch (error) {
+    throw new Error(
+      `file is not readable: ${expanded}${error?.message ? ` (${error.message})` : ""}`
+    );
+  }
+  return { expanded, stat };
+}
+async function writeFileInChunks(client, options) {
+  let expectedKnowledgeBaseId;
   const initParams = {
-    knowledge_base_id: knowledgeBaseId,
     file_name: options.filename,
-    name: options.docName,
     mime_type: options.mime
   };
-  if (options.filePath !== void 0 && options.filePath !== "") {
-    initParams.file_path = options.filePath;
+  if (options.target.mode === "create") {
+    expectedKnowledgeBaseId = await resolveKnowledgeBaseId(
+      client,
+      options.target.kbName
+    );
+    initParams.knowledge_base_id = expectedKnowledgeBaseId;
+    initParams.name = options.target.docName ?? options.filename;
+    if (options.target.filePath) initParams.file_path = options.target.filePath;
+  } else if ("documentId" in options.target.locator) {
+    initParams.document_id = options.target.locator.documentId;
+  } else {
+    expectedKnowledgeBaseId = await resolveKnowledgeBaseId(
+      client,
+      options.target.locator.kbName
+    );
+    initParams.knowledge_base_id = expectedKnowledgeBaseId;
+    initParams.name = options.target.locator.docName;
+    if (options.target.locator.filePath) {
+      initParams.file_path = options.target.locator.filePath;
+    }
   }
-  const initResponse = await client.postJson(
+  const initResponse = options.target.mode === "create" ? await client.postJson(
+    CHUNK_INIT,
+    {},
+    initParams,
+    { timeoutMs: options.timeoutMs }
+  ) : await client.putJson(
     CHUNK_INIT,
     {},
     initParams,
     { timeoutMs: options.timeoutMs }
   );
-  const init = unwrapBox(initResponse, "chunk init");
+  const normalizedInit = unwrapBareOrBox(initResponse, "chunk init");
+  const init = normalizedInit.value;
+  const initKnowledgeBaseId = readOptionalString(init, "knowledge_base_id");
+  if (!initKnowledgeBaseId) {
+    if (!(options.target.mode === "create" && normalizedInit.boxed)) {
+      throw new CtxdbError("chunk init returned invalid knowledge_base_id");
+    }
+  } else if (expectedKnowledgeBaseId && initKnowledgeBaseId !== expectedKnowledgeBaseId) {
+    throw new CtxdbError(
+      `chunk init returned mismatched knowledge_base_id ${initKnowledgeBaseId}`
+    );
+  }
   const uploadTicket = readRequiredString(
     init,
     "upload_ticket",
@@ -237,19 +341,56 @@ async function uploadFileInChunks(client, options) {
         headers: { "X-Upload-Ticket": uploadTicket }
       }
     );
-    const completed = unwrapBox(completeResponse, "chunk complete");
+    const normalizedComplete = unwrapBareOrBox(
+      completeResponse,
+      "chunk complete"
+    );
+    const completed = normalizedComplete.value;
+    const completedKnowledgeBaseId = readOptionalString(
+      completed,
+      "knowledge_base_id"
+    );
+    if (!completedKnowledgeBaseId) {
+      if (!(options.target.mode === "create" && normalizedComplete.boxed)) {
+        throw new CtxdbError(
+          "chunk complete returned invalid knowledge_base_id"
+        );
+      }
+    } else if (initKnowledgeBaseId && completedKnowledgeBaseId !== initKnowledgeBaseId) {
+      throw new CtxdbError(
+        `chunk complete returned mismatched knowledge_base_id ${completedKnowledgeBaseId}`
+      );
+    }
     const completedDocumentId = readRequiredString(
       completed,
       "document_id",
       "chunk complete"
     );
-    const reusedSucceededDocument = completedDocumentId !== documentId && completed.status === "succeeded";
+    const completedStatus = readOptionalString(completed, "status");
+    if (!completedStatus && !normalizedComplete.boxed) {
+      throw new CtxdbError("chunk complete returned invalid status");
+    }
+    const reusedSucceededDocument = completedDocumentId !== documentId && completedStatus === "succeeded";
     if (completedDocumentId !== documentId && !reusedSucceededDocument) {
       throw new CtxdbError(
         `chunk complete returned mismatched document_id ${completedDocumentId}`
       );
     }
-    return getDocument(client, options.kbName, completedDocumentId);
+    if (options.target.mode === "update") {
+      const canonicalKnowledgeBaseId = completedKnowledgeBaseId ?? initKnowledgeBaseId;
+      if (!canonicalKnowledgeBaseId) {
+        throw new CtxdbError(
+          "chunk update returned invalid knowledge_base_id"
+        );
+      }
+      const detail = await getDocumentByKnowledgeBaseId(
+        client,
+        canonicalKnowledgeBaseId,
+        completedDocumentId
+      );
+      return readCanonicalUpdateDocument(detail, "chunk update detail");
+    }
+    return getDocument(client, options.target.kbName, completedDocumentId);
   } catch (error) {
     if (!completeStarted) {
       try {
@@ -268,6 +409,10 @@ async function uploadFileInChunks(client, options) {
     throw error;
   }
 }
+async function resolveKnowledgeBaseId(client, kbName) {
+  const kb = await client.get(KB_DETAIL, { knowledge_base_name: kbName });
+  return readRequiredString(kb, "id", "knowledge base detail");
+}
 function shouldFallbackToChunk(error) {
   if (!error || typeof error !== "object") return false;
   const candidate = error;
@@ -303,6 +448,31 @@ function unwrapBox(response, operation) {
   }
   return box.data;
 }
+function unwrapBareOrBox(response, operation) {
+  if (!response || typeof response !== "object" || Array.isArray(response)) {
+    throw new CtxdbError(`${operation} returned an invalid response`);
+  }
+  const object = response;
+  if (Object.hasOwn(object, "data")) {
+    return { value: unwrapBox(response, operation), boxed: true };
+  }
+  return { value: object, boxed: false };
+}
+function readCanonicalUpdateDocument(response, operation) {
+  if (!response || typeof response !== "object" || Array.isArray(response)) {
+    throw new CtxdbError(`${operation} returned an invalid response`);
+  }
+  readRequiredString(response, "id", operation);
+  readRequiredString(response, "knowledge_base_id", operation);
+  return response;
+}
+function readOptionalString(value, field) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const result = value[field];
+  return typeof result === "string" && result.trim() !== "" ? result : void 0;
+}
 function readRequiredString(value, field, source) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     throw new CtxdbError(`${source} returned an invalid response`);
@@ -334,6 +504,12 @@ async function getDocument(client, kbName, docId) {
     document_id: docId
   });
 }
+async function getDocumentByKnowledgeBaseId(client, knowledgeBaseId, docId) {
+  return client.get(DOCUMENT_DETAIL, {
+    knowledge_base_id: knowledgeBaseId,
+    document_id: docId
+  });
+}
 async function listDocuments(client, kbName) {
   const resp = await client.get(DOCUMENTS, { knowledge_base_name: kbName });
   if (Array.isArray(resp)) return resp;
@@ -344,12 +520,24 @@ async function listDocuments(client, kbName) {
   return [];
 }
 async function pollIngest(client, kbName, docId, options = {}) {
+  return pollIngestWith(
+    () => getDocument(client, kbName, docId),
+    options
+  );
+}
+async function pollIngestByKnowledgeBaseId(client, knowledgeBaseId, docId, options = {}) {
+  return pollIngestWith(
+    () => getDocumentByKnowledgeBaseId(client, knowledgeBaseId, docId),
+    options
+  );
+}
+async function pollIngestWith(getLatest, options) {
   const timeoutMs = options.timeoutMs ?? DEFAULT_INGEST_TIMEOUT_MS;
   const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
   const sleep = options.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
   const now = options.now ?? (() => performance.now());
   const deadline = now() + timeoutMs;
-  let doc = await getDocument(client, kbName, docId);
+  let doc = await getLatest();
   let timedOut = false;
   while (ingestInFlight(doc)) {
     if (now() >= deadline) {
@@ -358,7 +546,7 @@ async function pollIngest(client, kbName, docId, options = {}) {
     }
     await sleep(intervalMs);
     try {
-      doc = await getDocument(client, kbName, docId);
+      doc = await getLatest();
     } catch {
       break;
     }
@@ -434,10 +622,14 @@ export {
   listKnowledgeBases,
   createKb,
   uploadText,
+  updateText,
   uploadFile,
+  updateFile,
+  validateLocalFile,
   getDocument,
   listDocuments,
   pollIngest,
+  pollIngestByKnowledgeBaseId,
   compactKbQueryResponse,
   minimalKbQueryResponse
 };

package/dist/{chunk-7EIJB5LA.js → chunk-R2QS6ACP.js} RENAMED Viewed

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

package/dist/{chunk-ARZX2RLR.js → chunk-S5W4FQ7M.js} RENAMED Viewed

@@ -248,10 +248,13 @@ var HttpClient = class {
       headers: options.headers
     });
   }
-  putJson(path, body) {
+  putJson(path, body, params, options = {}) {
     return this.doRequest("PUT", path, {
       body: JSON.stringify(body),
-      contentType: "application/json"
+      contentType: "application/json",
+      params,
+      timeoutMs: options.timeoutMs,
+      headers: options.headers
     });
   }
   delete(path, params) {
@@ -266,14 +269,7 @@ var HttpClient = class {
    * boundary itself.
    */
   postMultipart(path, fields = {}, files = {}, options = {}) {
-    const fd = new FormData();
-    for (const [name, value] of Object.entries(fields)) {
-      fd.append(name, value);
-    }
-    for (const [name, part] of Object.entries(files)) {
-      const blob = part.content instanceof Blob ? part.content : new Blob([part.content], { type: part.mimeType });
-      fd.append(name, blob, part.filename);
-    }
+    const fd = buildMultipartForm(fields, files);
     return this.doRequest("POST", path, {
       body: fd,
       params: options.params,
@@ -281,7 +277,28 @@ var HttpClient = class {
       headers: options.headers
     });
   }
+  /** PUT multipart/form-data with the same runtime-owned boundary as POST. */
+  putMultipart(path, fields = {}, files = {}, options = {}) {
+    const fd = buildMultipartForm(fields, files);
+    return this.doRequest("PUT", path, {
+      body: fd,
+      params: options.params,
+      timeoutMs: options.timeoutMs,
+      headers: options.headers
+    });
+  }
 };
+function buildMultipartForm(fields, files) {
+  const fd = new FormData();
+  for (const [name, value] of Object.entries(fields)) {
+    fd.append(name, value);
+  }
+  for (const [name, part] of Object.entries(files)) {
+    const blob = part.content instanceof Blob ? part.content : new Blob([part.content], { type: part.mimeType });
+    fd.append(name, blob, part.filename);
+  }
+  return fd;
+}
 function maybeJson(text) {
   try {
     return JSON.parse(text);

package/dist/{chunk-B7JCQL4O.js → chunk-X2BX6LR6.js} RENAMED Viewed

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

package/dist/cli/main.js CHANGED Viewed

@@ -10,9 +10,13 @@ import {
   listKnowledgeBases,
   minimalKbQueryResponse,
   pollIngest,
+  pollIngestByKnowledgeBaseId,
+  updateFile,
+  updateText,
   uploadFile,
-  uploadText
-} from "../chunk-L4GVGVOP.js";
+  uploadText,
+  validateLocalFile
+} from "../chunk-QVXDI77N.js";
 import {
   DEFAULT_BASE_URL,
   DEFAULT_USER_ID,
@@ -35,7 +39,7 @@ import {
   save,
   updateConfiguredDebug,
   writeInstalledPkgVersion
-} from "../chunk-ARZX2RLR.js";
+} from "../chunk-S5W4FQ7M.js";
 import {
   beginUpdateNotification,
   completeUpdateNotification,
@@ -2612,8 +2616,61 @@ function parseMetadataFlags(raw) {
 }
 // src/cli/kb-cli.ts
+import { basename } from "path";
 var UPLOAD_TEXT_USAGE = "usage: ctxdb kb upload-text <kb-name> <doc-name> --text=<body> [--file-path=<server-logical-path>] [--wait|--no-wait]";
 var UPLOAD_FILE_USAGE = "usage: ctxdb kb upload-file <kb-name> <local-path> [--doc-name=...] [--file-path=<server-logical-path>] [--wait|--no-wait]";
+var UPDATE_TEXT_USAGE = "usage: ctxdb kb update-text <document-id> --text=<body> [--wait|--no-wait]\n   or: ctxdb kb update-text --kb-name=<kb-name> --doc-name=<logical-name> --text=<body> [--file-path=<server-logical-path>] [--wait|--no-wait]";
+var UPDATE_FILE_USAGE = "usage: ctxdb kb update-file <document-id> <local-path> [--wait|--no-wait]\n   or: ctxdb kb update-file <local-path> --kb-name=<kb-name> [--doc-name=<logical-name>] [--file-path=<server-logical-path>] [--wait|--no-wait]";
+var UPDATE_LOCATOR_FLAGS = ["kb-name", "doc-name", "file-path"];
+function nonEmptyFlag(args, name) {
+  const value = args.flags[name];
+  return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+function hasAnyLocatorFlag(args) {
+  return UPDATE_LOCATOR_FLAGS.some((name) => Object.hasOwn(args.flags, name));
+}
+function parseTextUpdateLocator(args) {
+  if (args.positional.length === 1 && !hasAnyLocatorFlag(args)) {
+    const documentId = args.positional[0];
+    if (documentId) return { documentId };
+  }
+  if (args.positional.length === 0) {
+    const kbName = nonEmptyFlag(args, "kb-name");
+    const docName = nonEmptyFlag(args, "doc-name");
+    const filePath = nonEmptyFlag(args, "file-path");
+    const filePathValid = !Object.hasOwn(args.flags, "file-path") || !!filePath;
+    if (kbName && docName && filePathValid) {
+      return { kbName, docName, ...filePath ? { filePath } : {} };
+    }
+  }
+  fail(UPDATE_TEXT_USAGE, 2);
+}
+function parseFileUpdate(args) {
+  if (args.positional.length === 2 && !hasAnyLocatorFlag(args)) {
+    const [documentId, localPath] = args.positional;
+    if (documentId && localPath) return { locator: { documentId }, localPath };
+  }
+  if (args.positional.length === 1) {
+    const [localPath] = args.positional;
+    const kbName = nonEmptyFlag(args, "kb-name");
+    const docNameFlag = nonEmptyFlag(args, "doc-name");
+    const filePath = nonEmptyFlag(args, "file-path");
+    const optionalFlagsValid = ["doc-name", "file-path"].every(
+      (name) => !Object.hasOwn(args.flags, name) || !!nonEmptyFlag(args, name)
+    );
+    if (localPath && kbName && optionalFlagsValid) {
+      return {
+        locator: {
+          kbName,
+          docName: docNameFlag ?? basename(localPath),
+          ...filePath ? { filePath } : {}
+        },
+        localPath
+      };
+    }
+  }
+  fail(UPDATE_FILE_USAGE, 2);
+}
 function shouldWaitForIngest(args, usage) {
   const waitRequested = args.flags.wait !== void 0;
   const noWaitRequested = args.flags["no-wait"] !== void 0;
@@ -2665,6 +2722,57 @@ async function kbUploadFile(args) {
   printResult({ document: final }, !!args.flags.json);
   return 0;
 }
+async function kbUpdateText(args) {
+  const shouldWait = shouldWaitForIngest(args, UPDATE_TEXT_USAGE);
+  const text = args.flags.text;
+  if (typeof text !== "string" || text.length === 0) {
+    fail(UPDATE_TEXT_USAGE, 2);
+  }
+  const locator = parseTextUpdateLocator(args);
+  const ctx = buildContext(args);
+  const doc = await updateText(ctx.client, locator, text);
+  if (!shouldWait) {
+    printResult({ document: doc }, !!args.flags.json);
+    return 0;
+  }
+  const final = await pollIngestByKnowledgeBaseId(
+    ctx.client,
+    doc.knowledge_base_id,
+    doc.id,
+    {
+      timeoutMs: DEFAULT_INGEST_TIMEOUT_MS
+    }
+  );
+  printResult({ document: final }, !!args.flags.json);
+  return 0;
+}
+async function kbUpdateFile(args) {
+  const shouldWait = shouldWaitForIngest(args, UPDATE_FILE_USAGE);
+  const { locator, localPath } = parseFileUpdate(args);
+  try {
+    validateLocalFile(localPath);
+  } catch (error) {
+    fail(error instanceof Error ? error.message : String(error), 2);
+  }
+  const ctx = buildContext(args);
+  const doc = await updateFile(ctx.client, locator, localPath, {
+    timeoutMs: DEFAULT_FILE_UPLOAD_TIMEOUT_MS
+  });
+  if (!shouldWait) {
+    printResult({ document: doc }, !!args.flags.json);
+    return 0;
+  }
+  const final = await pollIngestByKnowledgeBaseId(
+    ctx.client,
+    doc.knowledge_base_id,
+    doc.id,
+    {
+      timeoutMs: DEFAULT_FILE_INGEST_TIMEOUT_MS
+    }
+  );
+  printResult({ document: final }, !!args.flags.json);
+  return 0;
+}
 async function kbCreate(args) {
   const kbName = args.positional[0];
   if (!kbName) fail("usage: ctxdb kb create <kb-name> [--description=<desc>]");
@@ -2944,9 +3052,16 @@ COMMANDS
                  [--file-path=<server-logical-path>] [--wait|--no-wait]
   kb upload-file <kb-name> <local-path> [--agent=<name>] [--doc-name=...]
                  [--file-path=<server-logical-path>] [--wait|--no-wait]
-                                 Uploads return immediately by default.
+  kb update-text <document-id> --text=<body> [--agent=<name>] [--wait|--no-wait]
+    or: update-text --kb-name=<kb-name> --doc-name=<logical-name> --text=<body>
+                    [--file-path=<server-logical-path>] [--wait|--no-wait]
+  kb update-file <document-id> <local-path> [--agent=<name>] [--wait|--no-wait]
+    or: update-file <local-path> --kb-name=<kb-name> [--doc-name=<logical-name>]
+                    [--file-path=<server-logical-path>] [--wait|--no-wait]
+                                 Uploads return immediately by default; updates do too.
                                  --wait polls for terminal ingest status.
                                  --no-wait is a compatibility alias for the default.
+                                 Keep the returned ID for the next update.
   kb list [--agent=<name>]
   kb documents-list <kb-name> [--agent=<name>]
   kb document-get <kb-name> <doc-id> [--agent=<name>]
@@ -3012,6 +3127,8 @@ var ROUTES = {
     create: kbCreate,
     "upload-text": kbUploadText,
     "upload-file": kbUploadFile,
+    "update-text": kbUpdateText,
+    "update-file": kbUpdateFile,
     list: kbList,
     "documents-list": kbDocumentsList,
     "document-get": kbDocumentGet,

package/dist/hooks/hermes-post-llm-call.js CHANGED Viewed

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   captureParsedMessages
-} from "../chunk-6BB65W5W.js";
-import "../chunk-B7JCQL4O.js";
+} from "../chunk-DC5NWGDW.js";
+import "../chunk-X2BX6LR6.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
   debug,
   load,
   setDebug
-} from "../chunk-ARZX2RLR.js";
+} from "../chunk-S5W4FQ7M.js";
 import {
   shouldSkipHooks
 } from "../chunk-UEKR2Z3S.js";

package/dist/hooks/hermes-pre-llm-call.js CHANGED Viewed

@@ -2,17 +2,17 @@
 import {
   HOOK_TIMEOUT_MS,
   composeSessionStart
-} from "../chunk-BHRWAU3E.js";
+} from "../chunk-NFTGG6WK.js";
 import {
   composeUserPromptSubmit
-} from "../chunk-7EIJB5LA.js";
+} from "../chunk-R2QS6ACP.js";
 import {
   fetchKbCatalogBlock
-} from "../chunk-VHNHVMCA.js";
-import "../chunk-L4GVGVOP.js";
+} from "../chunk-DPLMBHLU.js";
+import "../chunk-QVXDI77N.js";
 import {
   isCircuitOpen
-} from "../chunk-B7JCQL4O.js";
+} from "../chunk-X2BX6LR6.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -20,7 +20,7 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-ARZX2RLR.js";
+} from "../chunk-S5W4FQ7M.js";
 import {
   shouldSkipHooks
 } from "../chunk-UEKR2Z3S.js";

package/dist/hooks/session-start.js CHANGED Viewed

@@ -3,12 +3,12 @@ import {
   HOOK_TIMEOUT_MS,
   composeSessionStart,
   formatSessionStartStdout
-} from "../chunk-BHRWAU3E.js";
-import "../chunk-VHNHVMCA.js";
-import "../chunk-L4GVGVOP.js";
+} from "../chunk-NFTGG6WK.js";
+import "../chunk-DPLMBHLU.js";
+import "../chunk-QVXDI77N.js";
 import {
   isCircuitOpen
-} from "../chunk-B7JCQL4O.js";
+} from "../chunk-X2BX6LR6.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -16,7 +16,7 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-ARZX2RLR.js";
+} from "../chunk-S5W4FQ7M.js";
 import {
   shouldSkipHooks
 } from "../chunk-UEKR2Z3S.js";

package/dist/hooks/stop.js CHANGED Viewed

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   captureTurn
-} from "../chunk-6BB65W5W.js";
-import "../chunk-B7JCQL4O.js";
+} from "../chunk-DC5NWGDW.js";
+import "../chunk-X2BX6LR6.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
   debug,
   load,
   setDebug
-} from "../chunk-ARZX2RLR.js";
+} from "../chunk-S5W4FQ7M.js";
 import {
   shouldSkipHooks
 } from "../chunk-UEKR2Z3S.js";

package/dist/hooks/user-prompt-submit.js CHANGED Viewed

@@ -2,12 +2,12 @@
 import {
   composeUserPromptSubmit,
   formatUserPromptSubmitStdout
-} from "../chunk-7EIJB5LA.js";
-import "../chunk-VHNHVMCA.js";
-import "../chunk-L4GVGVOP.js";
+} from "../chunk-R2QS6ACP.js";
+import "../chunk-DPLMBHLU.js";
+import "../chunk-QVXDI77N.js";
 import {
   isCircuitOpen
-} from "../chunk-B7JCQL4O.js";
+} from "../chunk-X2BX6LR6.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -15,7 +15,7 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-ARZX2RLR.js";
+} from "../chunk-S5W4FQ7M.js";
 import {
   shouldSkipHooks
 } from "../chunk-UEKR2Z3S.js";

package/dist/setup/skills/contextdb-knowledge/SKILL.md CHANGED Viewed

@@ -12,7 +12,8 @@ description: contextdb 知识库高频操作（查询 / 浏览 KB / 上传或更
 - 用户想**找已有 KB 里的内容** → §2 recipe 1
 - 用户**不知道有哪些 KB** → §2 recipe 2
 - 用户想**了解某个 KB 收了哪些文档** → §2 recipe 3
-- 用户要**写入/上传/更新内容** → §2 recipe 4/5
+- 用户要**新建/上传内容** → §2 recipe 4/5
+- 用户要**更新已有文档** → §2 recipe 6/7
 配套 skill：**contextdb-memory**（长期记忆操作）。两者用同一份 `~/.ctxdb/ctxdb.json` 配置和同一个 `--agent` 路由。
@@ -101,7 +102,40 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 **何时不适用**：要上传的内容是字符串而非本地文件 → recipe 4。
-> **同名文档更新**：同一 KB、同一 `--file-path` 下，以相同文档名再次上传，服务端按更新（替换）语义处理；继续调用对应的 `kb upload-text` / `kb upload-file` 命令即可（`upload-file` 必要时用 `--doc-name` 保持文档名不变）。
+### Recipe 6：更新已有文本文档
+**场景**：用户明确要替换某个已存在 KB 文本文档的内容。
+```sh
+ctxdb kb update-text <document-id> --text="<new-body>" --agent={{agent}}
+# 只有拿不到精确 document ID、但已知完整逻辑键时才用：
+ctxdb kb update-text --kb-name=<kb-name> --doc-name=<logical-name> --text="<new-body>" [--file-path=<logical-parent-path>] --agent={{agent}}
+```
+已有精确 `document-id` 时优先用第一种，不需要再向用户索取 KB，也不要同时传
+`--kb-name` / `--doc-name` / `--file-path`。服务端会从文档 ID 校验权限并解析所属 KB。
+命令返回的 `document.id` 是后续更新的新权威 ID：内容变化时通常会换 ID，相同内容也可能
+复用原 ID，Agent 都必须以本次返回值为准。只有拿不到 ID、但已确认完整 **KB + 文档名 +
+`file_path`** 逻辑键时才用第二种；目标信息不完整时先核对或向用户确认，不能模糊猜测。
+重复调用 `upload-text` 是创建冲突，不会自动转成更新。
+### Recipe 7：更新已有文件文档
+**场景**：用户用新的本地文件内容替换某个已存在 KB 文件文档。
+```sh
+ctxdb kb update-file <document-id> <local-path> --agent={{agent}}
+# 只有拿不到精确 document ID、但已知完整逻辑键时才用：
+ctxdb kb update-file <local-path> --kb-name=<kb-name> [--doc-name=<existing-logical-name>] [--file-path=<logical-parent-path>] --agent={{agent}}
+```
+ID 模式只用 `document-id` 定位远端文档，本地文件名只是上传的物理文件名；替换文件改了
+文件名也不需要补远端名称或 KB。逻辑键模式下，远端逻辑文档名默认取本地文件名；若替换
+文件名不同，必须用 `--doc-name` 继续传已有逻辑名。两种定位方式不能混用。分片更新只在
+init 使用 PUT，part/complete 保持原协议；网络结果不明确时不自动重试或删除旧文档。
+成功后同样必须保存返回的 `document.id`，不要继续沿用输入 ID。
 ## 3. 命令速查
@@ -116,6 +150,8 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 | `kb create` | `ctxdb kb create <kb-name> --agent=<name>` |
 | `kb upload-text` | `ctxdb kb upload-text <kb-name> <doc-name> --text="<body>" --agent=<name>` |
 | `kb upload-file` | `ctxdb kb upload-file <kb-name> <local-path> --agent=<name>` |
+| `kb update-text` | `ctxdb kb update-text <document-id> --text="<body>" --agent=<name>` |
+| `kb update-file` | `ctxdb kb update-file <document-id> <local-path> --agent=<name>` |
 所有命令 JSON 写 stdout、错误写 stderr 非零退出码。
@@ -127,7 +163,7 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 **`<external-knowledge>` 块**：开启 KB 自动召回时，内部按 `## 图谱合成上下文` / `## 文档证据` 分区。图谱区只用于关系理解和检索导航，文档区才是回答与引用证据；图谱区被独立限制长度，不会挤掉已选中的文档证据。
-**B-3c 守卫**：含 `kb upload-text` / `kb upload-file` 的对话轮次，其内容**不会**被 autoCapture 写入记忆（防文档原文混进记忆桶）。
+**B-3c 守卫**：含 `kb upload-text` / `kb upload-file` / `kb update-text` / `kb update-file` 的对话轮次，其内容**不会**被 autoCapture 写入记忆（防文档原文混进记忆桶）。
 **纯 CLI 模式**：对话里没有上面任何块 → 说明当前不在 hook 环境（agent 是裸 CLI 调用），所有信息只能主动调命令拿。
@@ -145,11 +181,12 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 - **根因**：shell + python -c 的引号是两层独立 escape，组合时极容易漏
 - **正确做法**：`ctxdb kb list --agent={{agent}} | jq '.knowledge_bases[].name'`；jq 表达式在单引号里不需要 escape
-### 注意事项 3：`upload-*` / `create` 是副作用，没明示 KB 名前必须先确认
+### 注意事项 3：创建和逻辑键更新没明示 KB 名前必须先确认
 - **现象**：用户只说"把这段记进知识库"没指定 KB，agent 直接用了某个猜的 KB 名 → 写到错的桶
 - **根因**：写命令不会跟 agent 二次确认；KB 不存在时报错，但**KB 名拼错却恰好命中另一个真实 KB**时会静默写错
-- **正确做法**：用户没明示 → 必须先 `kb list` 拿候选清单，跟用户确认目标后才执行
+- **正确做法**：`upload-*` / `create` / 逻辑键 `update-*` 在用户没明示 KB 时，必须先
+  `kb list` 拿候选清单并确认；精确 document-ID 更新已经绑定目标，不再额外要求 KB
 ### 注意事项 4：`kb search` 空结果时降阈值再试一次
@@ -175,12 +212,13 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 | `--verbose` | 每个 chunk 加 `doc_name` / `kb_id` / `doc_id` / `tags` | false |
 | `--raw` | 服务端原始响应（13+ 字段，图结果仍混在 `chunks`，含 tokenizer 细节） | false |
-### `kb upload-file` / `kb upload-text` 全部 flag
+### `kb upload-*` / `kb update-*` 全部 flag
 | 参数 | 说明 |
 |------|------|
-| `--doc-name` | （`upload-file`）服务端文档名，默认取本地文件名 |
-| `--file-path` | KB 内的逻辑父目录，不包含文档名/文件名 |
+| `--kb-name` | 仅逻辑键更新使用；不能与位置参数中的 document ID 混用 |
+| `--doc-name` | `upload-file` 的逻辑文档名，或逻辑键更新的精确文档名；ID 更新不使用 |
+| `--file-path` | 创建/逻辑键更新时 KB 内的逻辑父目录；ID 更新不使用 |
 | `--wait` | 等到 ingest 成功、失败或达到原有超时；用于迁移旧的默认等待行为 |
 | `--no-wait` | 兼容参数；与新的“受理后立即返回”默认行为相同 |

package/dist/setup/skills/contextdb-memory/SKILL.md CHANGED Viewed

@@ -95,7 +95,7 @@ ctxdb memory delete <memory-id> --agent={{agent}}
 **autoCapture（Stop / post_llm_call / plugin）**：每轮对话结束后服务端异步提炼事实写记忆，**不用 agent 主动调** `memory add`。`memory add` 用于用户**明确强调**的内容（强加重要性）。
-**B-3c 守卫**：含 `kb upload-text` / `kb upload-file` 的轮次，**autoCapture 跳过**这一轮（防文档原文进记忆桶）。
+**B-3c 守卫**：含 `kb upload-text` / `kb upload-file` / `kb update-text` / `kb update-file` 的轮次，**autoCapture 跳过**这一轮（防新建或更新的文档原文进记忆桶）。
 **纯 CLI 模式**：对话里没 `<recalled-memories>` 块 → 不在 hook 环境（裸 CLI），所有 recall / capture 只能主动 `ctxdb memory search` / `ctxdb memory add`。

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@aliyunrds/ctxdb",
-  "version": "1.0.6-beta.0",
+  "version": "1.0.7",
   "type": "module",
   "description": "Unified access layer for RDS ContextDatabase: `ctxdb` CLI (memory + KB ops), one-shot `setup --agent <qoder|qoderwork|codex|claude|opencode|hermes>` installer, per-agent config, hooks/plugins, and SKILL.md.",
   "license": "Apache-2.0",
@@ -32,7 +32,7 @@
   "dependencies": {
     "semver": "^7.8.5",
     "yaml": "^2.9.0",
-    "@aliyunrds/ctxdb-shared": "~0.0.6"
+    "@aliyunrds/ctxdb-shared": "~0.0.7"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",