@aliyunrds/ctxdb 1.0.1 → 1.0.3

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

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   captureParsedMessages
-} from "../chunk-IMYLU5C2.js";
-import "../chunk-TGVURF54.js";
+} from "../chunk-SAQT6VL6.js";
+import "../chunk-USMJLDBD.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
   debug,
   load,
   setDebug
-} from "../chunk-6FZL67GH.js";
+} from "../chunk-JFTKYEVN.js";
 import {
   shouldSkipHooks
 } from "../chunk-UEKR2Z3S.js";

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

@@ -2,17 +2,17 @@
 import {
   HOOK_TIMEOUT_MS,
   composeSessionStart
-} from "../chunk-RZONPKY4.js";
+} from "../chunk-CWGF5D52.js";
 import {
   composeUserPromptSubmit
-} from "../chunk-FD3AMXVU.js";
+} from "../chunk-BVCDRUU4.js";
 import {
   fetchKbCatalogBlock
-} from "../chunk-EUQ3OFCQ.js";
-import "../chunk-UH7AJF6F.js";
+} from "../chunk-Q4JYST7K.js";
+import "../chunk-3PFMHU3C.js";
 import {
   isCircuitOpen
-} from "../chunk-TGVURF54.js";
+} from "../chunk-USMJLDBD.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -20,7 +20,7 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-6FZL67GH.js";
+} from "../chunk-JFTKYEVN.js";
 import {
   shouldSkipHooks
 } from "../chunk-UEKR2Z3S.js";

package/dist/hooks/session-start.js

@@ -3,12 +3,94 @@ import {
   HOOK_TIMEOUT_MS,
   composeSessionStart,
   formatSessionStartStdout
-} from "../chunk-RZONPKY4.js";
-import "../chunk-EUQ3OFCQ.js";
-import "../chunk-UH7AJF6F.js";
-import "../chunk-TGVURF54.js";
-import "../chunk-6FZL67GH.js";
-import "../chunk-UEKR2Z3S.js";
+} from "../chunk-CWGF5D52.js";
+import "../chunk-Q4JYST7K.js";
+import "../chunk-3PFMHU3C.js";
+import {
+  isCircuitOpen
+} from "../chunk-USMJLDBD.js";
+import {
+  HttpClient,
+  agentFromArgvWithFallback,
+  debug,
+  isComplete,
+  load,
+  setDebug
+} from "../chunk-JFTKYEVN.js";
+import {
+  shouldSkipHooks
+} from "../chunk-UEKR2Z3S.js";
+
+// src/hooks/session-start.ts
+import { pathToFileURL } from "url";
+async function readStdinJson() {
+  let raw = "";
+  for await (const chunk of process.stdin) raw += chunk;
+  if (!raw.trim()) return {};
+  try {
+    const obj = JSON.parse(raw);
+    return obj && typeof obj === "object" && !Array.isArray(obj) ? obj : {};
+  } catch {
+    return {};
+  }
+}
+async function main() {
+  try {
+    if (shouldSkipHooks()) return 0;
+    const event = await readStdinJson();
+    const { agent, fellBack } = agentFromArgvWithFallback();
+    if (fellBack) {
+      process.stderr.write(
+        `ctxdb warmup: agent unspecified, defaulting to ${agent}
+`
+      );
+    }
+    const cwd = typeof event.cwd === "string" ? event.cwd : "";
+    if (!cwd) return 0;
+    const cfg = load({ agent });
+    setDebug(cfg.debug);
+    debug("warmup", "start", { cwd, userId: cfg.userId });
+    const kbInjectHere = cfg.kbCatalogInjection === "session_start";
+    if (!isComplete(cfg) || !cfg.warmupRecall && !kbInjectHere) {
+      debug("warmup", "skip (config incomplete or both warmup+kb off)");
+      return 0;
+    }
+    if (isCircuitOpen(agent, cfg.baseUrl)) {
+      debug("warmup", "skip (circuit open)");
+      return 0;
+    }
+    const client = new HttpClient({
+      baseUrl: cfg.baseUrl,
+      apiKey: cfg.apiKey,
+      timeoutMs: HOOK_TIMEOUT_MS
+    });
+    const composed = await composeSessionStart(cfg, agent, client, cwd);
+    if (composed.warmupTimedOut) {
+      process.stderr.write("ctxdb warmup: timeout\n");
+    }
+    if (!composed.ctx) return 0;
+    const { memoryCount, kbChunkCount, kbCatalogLines, ctx } = composed;
+    debug(
+      "warmup",
+      `ok, memories=${memoryCount} kb=${kbChunkCount} kb_catalog=${kbCatalogLines}`
+    );
+    process.stderr.write(
+      `ctxdb warmup: ok (${memoryCount} memories, ${kbChunkCount} kb chunks, kb_catalog=${kbCatalogLines} lines)
+`
+    );
+    process.stdout.write(formatSessionStartStdout(agent, ctx));
+    return 0;
+  } catch (err) {
+    process.stderr.write(`ctxdb warmup: unexpected error: ${err?.message ?? err}
+`);
+    return 0;
+  }
+}
+if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
+  main().then((code) => {
+    process.exitCode = code;
+  });
+}
 export {
   HOOK_TIMEOUT_MS,
   composeSessionStart,

package/dist/hooks/stop.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   captureTurn
-} from "../chunk-IMYLU5C2.js";
-import "../chunk-TGVURF54.js";
+} from "../chunk-SAQT6VL6.js";
+import "../chunk-USMJLDBD.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
   debug,
   load,
   setDebug
-} from "../chunk-6FZL67GH.js";
+} from "../chunk-JFTKYEVN.js";
 import {
   shouldSkipHooks
 } from "../chunk-UEKR2Z3S.js";

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

@@ -2,12 +2,89 @@
 import {
   composeUserPromptSubmit,
   formatUserPromptSubmitStdout
-} from "../chunk-FD3AMXVU.js";
-import "../chunk-EUQ3OFCQ.js";
-import "../chunk-UH7AJF6F.js";
-import "../chunk-TGVURF54.js";
-import "../chunk-6FZL67GH.js";
-import "../chunk-UEKR2Z3S.js";
+} from "../chunk-BVCDRUU4.js";
+import "../chunk-Q4JYST7K.js";
+import "../chunk-3PFMHU3C.js";
+import {
+  isCircuitOpen
+} from "../chunk-USMJLDBD.js";
+import {
+  HttpClient,
+  agentFromArgvWithFallback,
+  debug,
+  isComplete,
+  load,
+  setDebug
+} from "../chunk-JFTKYEVN.js";
+import {
+  shouldSkipHooks
+} from "../chunk-UEKR2Z3S.js";
+
+// src/hooks/user-prompt-submit.ts
+import { pathToFileURL } from "url";
+async function readStdinJson() {
+  let raw = "";
+  for await (const chunk of process.stdin) raw += chunk;
+  if (!raw.trim()) return {};
+  try {
+    const obj = JSON.parse(raw);
+    return obj && typeof obj === "object" && !Array.isArray(obj) ? obj : {};
+  } catch {
+    return {};
+  }
+}
+async function main() {
+  try {
+    if (shouldSkipHooks()) return 0;
+    const event = await readStdinJson();
+    const { agent, fellBack } = agentFromArgvWithFallback();
+    if (fellBack) {
+      process.stderr.write(
+        `ctxdb recall: agent unspecified, defaulting to ${agent}
+`
+      );
+    }
+    const prompt = typeof event.prompt === "string" ? event.prompt : "";
+    if (!prompt.trim()) return 0;
+    const cfg = load({ agent });
+    setDebug(cfg.debug);
+    debug("recall", "start", { prompt: prompt.slice(0, 200), userId: cfg.userId });
+    if (!isComplete(cfg) || !cfg.autoRecall) {
+      debug("recall", "skip (config incomplete or autoRecall=false)");
+      return 0;
+    }
+    if (isCircuitOpen(agent, cfg.baseUrl)) {
+      debug("recall", "skip (circuit open)");
+      process.stderr.write(`ctxdb recall: skip (circuit_open: ${cfg.baseUrl})
+`);
+      return 0;
+    }
+    const client = new HttpClient({ baseUrl: cfg.baseUrl, apiKey: cfg.apiKey, timeoutMs: 5e3 });
+    const { ctx, recall, kbBlock } = await composeUserPromptSubmit(cfg, agent, client, prompt);
+    if (!recall.ok && !recall.additionalContext && !kbBlock) {
+      const reason = recall.reason ?? "no_context";
+      debug("recall", `no result: ${reason}`, recall);
+      if (recall.reason && recall.reason.startsWith("http_error:")) {
+        process.stderr.write(`ctxdb recall: ${recall.reason}
+`);
+      }
+      return 0;
+    }
+    if (!ctx) return 0;
+    debug("recall", `ok, additionalContext length=${ctx.length}`);
+    process.stdout.write(formatUserPromptSubmitStdout(agent, ctx));
+    return 0;
+  } catch (err) {
+    process.stderr.write(`ctxdb recall: unexpected error: ${err?.message ?? err}
+`);
+    return 0;
+  }
+}
+if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
+  main().then((code) => {
+    process.exitCode = code;
+  });
+}
 export {
   composeUserPromptSubmit,
   formatUserPromptSubmitStdout

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

@@ -79,7 +79,9 @@ ctxdb kb documents-list <kb-name> --agent={{agent}}
 ctxdb kb upload-text <kb-name> <doc-name> --text="<body>" --agent={{agent}}
 ```
 
-副作用操作。**用户没明示 KB 名前先 recipe 2 列出来确认**（见 §5 注意事项 3）。KB 不存在会直接报错，不自动创建。
+副作用操作。命令默认在服务端接受文档后立即返回；此时
+`ingest_status=processing` 只表示已受理，不表示入库成功。调用方必须等到文本可检索时加
+`--wait`。**用户没明示 KB 名前先 recipe 2 列出来确认**（见 §5 注意事项 3）。KB 不存在会直接报错，不自动创建。
 
 **何时不适用**：内容是本地文件 → recipe 5。
 
@@ -91,7 +93,11 @@ ctxdb kb upload-text <kb-name> <doc-name> --text="<body>" --agent={{agent}}
 ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 ```
 
-支持格式：PDF / DOCX / MD / TXT。默认等待 chunking 完成；想立即返回加 `--no-wait`（见 §6）。
+文件格式和大小限制由服务端决定，CLI 不维护本地允许列表；未知扩展名也会提交给服务端
+判断。CLI 先尝试普通流式上传，服务端明确要求时会自动切换为分片上传。默认在服务端接受
+文档后立即返回；调用方必须等到 chunking 结束时加 `--wait`。`--no-wait` 仍可使用，
+行为与默认值相同（见 §6）。分片 init、part、complete 当前均为单次请求，超时或断网后
+不会自动重试，以免服务端已成功但响应丢失时产生重复副作用。
 
 **何时不适用**：要上传的内容是字符串而非本地文件 → recipe 4。
 
@@ -173,7 +179,11 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 |------|------|
 | `--doc-name` | （`upload-file`）服务端文档名，默认取本地文件名 |
 | `--file-path` | 服务端逻辑路径（归档/分类用） |
-| `--no-wait` | 不等 chunking 完成立即返回 |
+| `--wait` | 等到 ingest 成功、失败或达到原有超时；用于迁移旧的默认等待行为 |
+| `--no-wait` | 兼容参数；与新的“受理后立即返回”默认行为相同 |
+
+`--wait` 与 `--no-wait` 互斥。无等待模式返回的
+`ingest_status=processing` 不能当作终态成功。
 
 ### `kb create` 全部 flag
 

package/dist/workers/version-check.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import {
+  checkLatestVersion,
+  recordVersionCheckFailure,
+  recordVersionCheckSuccess,
+  releaseVersionCheckLock
+} from "../chunk-BQA7YSXT.js";
+
+// src/workers/version-check.ts
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+function runVersionCheckWorker(options) {
+  const now = options.now ?? Date.now;
+  try {
+    const result = (options.check ?? checkLatestVersion)(options.currentVersion);
+    if (result.error || result.latest === null) {
+      recordVersionCheckFailure(options.paths, options.currentVersion, now());
+    } else {
+      recordVersionCheckSuccess(
+        options.paths,
+        options.currentVersion,
+        result.latest,
+        now()
+      );
+    }
+  } catch {
+    recordVersionCheckFailure(options.paths, options.currentVersion, now());
+  } finally {
+    releaseVersionCheckLock(options.paths, options.lockToken);
+  }
+}
+function parseWorkerArgs(argv) {
+  const values = /* @__PURE__ */ new Map();
+  for (const argument of argv) {
+    if (!argument.startsWith("--")) continue;
+    const separator = argument.indexOf("=");
+    if (separator < 3) continue;
+    values.set(argument.slice(2, separator), argument.slice(separator + 1));
+  }
+  const currentVersion = values.get("current-version");
+  const statePath = values.get("state-path");
+  const lockPath = values.get("lock-path");
+  const lockToken = values.get("lock-token");
+  if (!currentVersion || !statePath || !lockPath || !lockToken) return null;
+  return {
+    currentVersion,
+    lockToken,
+    paths: { cacheDir: dirname(statePath), statePath, lockPath }
+  };
+}
+function isProcessEntryPoint() {
+  if (!process.argv[1]) return false;
+  try {
+    return resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+}
+if (isProcessEntryPoint()) {
+  const options = parseWorkerArgs(process.argv.slice(2));
+  if (options) runVersionCheckWorker(options);
+}
+export {
+  runVersionCheckWorker
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliyunrds/ctxdb",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "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",
@@ -30,11 +30,13 @@
     "node": ">=20"
   },
   "dependencies": {
+    "semver": "^7.8.5",
     "yaml": "^2.9.0",
     "@aliyunrds/ctxdb-shared": "~0.0.5"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",
+    "@types/semver": "^7.7.1",
     "@vitest/coverage-v8": "^4.0.18",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",

package/dist/chunk-FD3AMXVU.js

@@ -1,111 +0,0 @@
-#!/usr/bin/env node
-import {
-  fetchKbCatalogBlock,
-  recallTurn
-} from "./chunk-EUQ3OFCQ.js";
-import {
-  isCircuitOpen
-} from "./chunk-TGVURF54.js";
-import {
-  HttpClient,
-  agentFromArgvWithFallback,
-  debug,
-  isComplete,
-  load,
-  setDebug
-} from "./chunk-6FZL67GH.js";
-import {
-  shouldSkipHooks
-} from "./chunk-UEKR2Z3S.js";
-
-// src/hooks/user-prompt-submit.ts
-import { pathToFileURL } from "url";
-async function composeUserPromptSubmit(cfg, agent, client, prompt) {
-  const [recall, kbBlock] = await Promise.all([
-    recallTurn(prompt, cfg, client, agent),
-    cfg.kbCatalogInjection === "user_prompt_submit" ? fetchKbCatalogBlock(client, agent).catch(() => "") : Promise.resolve("")
-  ]);
-  let ctx = recall.additionalContext || "";
-  if (kbBlock) ctx = ctx ? `${ctx}
-
-${kbBlock}` : kbBlock;
-  return { ctx, recall, kbBlock };
-}
-function formatUserPromptSubmitStdout(agent, ctx) {
-  if (agent === "codex") return ctx + "\n";
-  const out = {
-    hookSpecificOutput: {
-      hookEventName: "UserPromptSubmit",
-      additionalContext: ctx
-    }
-  };
-  return JSON.stringify(out) + "\n";
-}
-async function readStdinJson() {
-  let raw = "";
-  for await (const chunk of process.stdin) raw += chunk;
-  if (!raw.trim()) return {};
-  try {
-    const obj = JSON.parse(raw);
-    return obj && typeof obj === "object" && !Array.isArray(obj) ? obj : {};
-  } catch {
-    return {};
-  }
-}
-async function main() {
-  try {
-    if (shouldSkipHooks()) return 0;
-    const event = await readStdinJson();
-    const { agent, fellBack } = agentFromArgvWithFallback();
-    if (fellBack) {
-      process.stderr.write(
-        `ctxdb recall: agent unspecified, defaulting to ${agent}
-`
-      );
-    }
-    const prompt = typeof event.prompt === "string" ? event.prompt : "";
-    if (!prompt.trim()) return 0;
-    const cfg = load({ agent });
-    setDebug(cfg.debug);
-    debug("recall", "start", { prompt: prompt.slice(0, 200), userId: cfg.userId });
-    if (!isComplete(cfg) || !cfg.autoRecall) {
-      debug("recall", "skip (config incomplete or autoRecall=false)");
-      return 0;
-    }
-    if (isCircuitOpen(agent, cfg.baseUrl)) {
-      debug("recall", "skip (circuit open)");
-      process.stderr.write(`ctxdb recall: skip (circuit_open: ${cfg.baseUrl})
-`);
-      return 0;
-    }
-    const client = new HttpClient({ baseUrl: cfg.baseUrl, apiKey: cfg.apiKey, timeoutMs: 5e3 });
-    const { ctx, recall, kbBlock } = await composeUserPromptSubmit(cfg, agent, client, prompt);
-    if (!recall.ok && !recall.additionalContext && !kbBlock) {
-      const reason = recall.reason ?? "no_context";
-      debug("recall", `no result: ${reason}`, recall);
-      if (recall.reason && recall.reason.startsWith("http_error:")) {
-        process.stderr.write(`ctxdb recall: ${recall.reason}
-`);
-      }
-      return 0;
-    }
-    if (!ctx) return 0;
-    debug("recall", `ok, additionalContext length=${ctx.length}`);
-    process.stdout.write(formatUserPromptSubmitStdout(agent, ctx));
-    return 0;
-  } catch (err) {
-    process.stderr.write(`ctxdb recall: unexpected error: ${err?.message ?? err}
-`);
-    return 0;
-  }
-}
-if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
-  main().then((code) => {
-    process.exitCode = code;
-  });
-}
-
-export {
-  composeUserPromptSubmit,
-  formatUserPromptSubmitStdout
-};