@aliyunrds/ctxdb 0.0.7 → 0.0.8-beta.2

package/dist/{chunk-Q2EEP4CE.js → chunk-52IAVJRK.js}

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

package/dist/{chunk-LIC44DR6.js → chunk-73OY44GY.js}

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
+import {
+  listKnowledgeBases
+} from "./chunk-6S5RJYBC.js";
 import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-Q2EEP4CE.js";
+} from "./chunk-52IAVJRK.js";
 import {
   CtxdbError
-} from "./chunk-S45GOYUU.js";
+} from "./chunk-BWPFGTF7.js";
 
 // src/lib/recall-orchestrator.ts
 import {
@@ -138,6 +141,34 @@ async function recallTurn(prompt, cfg, client, agent = "default") {
   };
 }
 
+// src/lib/kb-catalog.ts
+function sanitizeKeyEntities(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const e of raw) {
+    if (typeof e !== "string") continue;
+    const cleaned = e.replace(/\s+/g, " ").trim();
+    if (cleaned.length > 0) out.push(cleaned);
+  }
+  return out;
+}
+async function fetchKbCatalogBlock(client, agent) {
+  const kbs = await listKnowledgeBases(client);
+  const active = kbs.filter((kb) => kb.status === "active");
+  if (active.length === 0) return "";
+  const lines = active.map((kb) => {
+    const ents = sanitizeKeyEntities(kb.key_entities);
+    return ents.length > 0 ? `\xB7 ${kb.name}: ${ents.join(", ")}` : `\xB7 ${kb.name}`;
+  });
+  return [
+    "<available-knowledge-bases>",
+    `When you identify that relevant information may exist in the knowledge bases below, you MUST run \`ctxdb kb search "<query>" --kb=<name> --agent=${agent}\` with targeted keywords after initial analysis to supplement and correct your approach. Knowledge bases:`,
+    ...lines,
+    "</available-knowledge-bases>"
+  ].join("\n");
+}
+
 export {
-  recallTurn
+  recallTurn,
+  fetchKbCatalogBlock
 };

package/dist/{chunk-S45GOYUU.js → chunk-BWPFGTF7.js}

@@ -39,23 +39,27 @@ ${s}`;
   }
 }
 
-// src/lib/http-client.ts
+// src/lib/package-version.ts
 import { readFileSync } from "fs";
-import { fileURLToPath } from "url";
 import { dirname as dirname2, join as join2 } from "path";
+import { fileURLToPath } from "url";
 function findPackageVersion() {
   let dir = dirname2(fileURLToPath(import.meta.url));
   for (let i = 0; i < 5; i++) {
     try {
       const pkg = JSON.parse(readFileSync(join2(dir, "package.json"), "utf-8"));
-      if (pkg.name === "@aliyunrds/ctxdb") return pkg.version;
+      if (pkg.name === "@aliyunrds/ctxdb" && typeof pkg.version === "string") {
+        return pkg.version;
+      }
     } catch {
     }
     dir = dirname2(dir);
   }
   return "0.0.0";
 }
-var PKG_VERSION = findPackageVersion();
+var PACKAGE_VERSION = findPackageVersion();
+
+// src/lib/http-client.ts
 var DEFAULT_TIMEOUT_MS = 3e4;
 var CtxdbError = class extends Error {
   constructor(message) {
@@ -108,7 +112,7 @@ var HttpClient = class {
     this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
     this.apiKey = opts.apiKey;
     this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    this.userAgent = opts.userAgent ?? `ctxdb-cli/${PKG_VERSION}`;
+    this.userAgent = opts.userAgent ?? `ctxdb-cli/${PACKAGE_VERSION}`;
     this.extraHeaders = { ...opts.extraHeaders ?? {} };
     const f = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
     this.fetchImpl = f;
@@ -257,7 +261,7 @@ function extractErrorDetail(text, fallback) {
 // src/lib/agents.ts
 import { homedir as homedir2 } from "os";
 import { join as join3 } from "path";
-var SUPPORTED_AGENTS = ["qoder", "codex", "claude"];
+var SUPPORTED_AGENTS = ["qoder", "qoderwork", "codex", "claude"];
 function isBuiltinAgent(v) {
   return typeof v === "string" && SUPPORTED_AGENTS.includes(v);
 }
@@ -269,6 +273,8 @@ function agentHomeDir(agent) {
   switch (agent) {
     case "qoder":
       return join3(homedir2(), ".qoder");
+    case "qoderwork":
+      return join3(homedir2(), ".qoderwork");
     case "codex":
       return join3(homedir2(), ".codex");
     case "claude":
@@ -308,6 +314,7 @@ var DEFAULT_USER_ID = "default";
 var DEFAULT_TOP_K = 5;
 var DEFAULT_THRESHOLD = 0.4;
 var DEFAULT_KNOWLEDGE_TOP_K = 6;
+var DEFAULT_KB_CATALOG_INJECTION = "session_start";
 function isComplete(cfg) {
   return Boolean(cfg.apiKey && cfg.baseUrl);
 }
@@ -330,6 +337,12 @@ function coerceBool(v, fallback) {
   if (v === void 0 || v === null) return fallback;
   return Boolean(v);
 }
+function coerceKbCatalogInjection(v) {
+  if (v === "session_start" || v === "user_prompt_submit" || v === "off") {
+    return v;
+  }
+  return DEFAULT_KB_CATALOG_INJECTION;
+}
 function readRaw(path) {
   if (!existsSync(path)) return {};
   try {
@@ -367,7 +380,8 @@ function configFromDisk(raw) {
     topK: coerceInt(raw.top_k, DEFAULT_TOP_K),
     threshold: coerceFloat(raw.threshold, DEFAULT_THRESHOLD),
     knowledgeTopK: coerceInt(raw.knowledge_top_k, DEFAULT_KNOWLEDGE_TOP_K),
-    debug: coerceBool(raw.debug, false)
+    debug: coerceBool(raw.debug, false),
+    kbCatalogInjection: coerceKbCatalogInjection(raw.kb_catalog_injection)
   };
 }
 function applyEnv(cfg, env) {
@@ -416,7 +430,8 @@ function configToDisk(cfg) {
     top_k: cfg.topK,
     threshold: cfg.threshold,
     knowledge_top_k: cfg.knowledgeTopK,
-    debug: cfg.debug
+    debug: cfg.debug,
+    kb_catalog_injection: cfg.kbCatalogInjection
   };
 }
 function removeAgent(agent, path, options = {}) {
@@ -481,7 +496,9 @@ function writeInstalledPkgVersion(version, path) {
 
 export {
   setDebug,
+  isDebug,
   debug,
+  PACKAGE_VERSION,
   CtxdbError,
   HttpClient,
   SUPPORTED_AGENTS,

package/dist/cli/main.js

@@ -18,6 +18,7 @@ import {
   DEFAULT_BASE_URL,
   DEFAULT_USER_ID,
   HttpClient,
+  PACKAGE_VERSION,
   SUPPORTED_AGENTS,
   agentFromEnv,
   agentHomeDir,
@@ -29,7 +30,7 @@ import {
   removeAgent,
   save,
   writeInstalledPkgVersion
-} from "../chunk-S45GOYUU.js";
+} from "../chunk-BWPFGTF7.js";
 
 // src/cli/util.ts
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
@@ -216,7 +217,6 @@ function fail(message, code = 1) {
 `);
   process.exit(code);
 }
-var PACKAGE_VERSION = "0.0.7";
 
 // src/setup/installer.ts
 import {
@@ -242,6 +242,8 @@ function skillInstallRoot(agent) {
   switch (agent) {
     case "qoder":
       return join(homedir(), ".qoder", "skills");
+    case "qoderwork":
+      return join(homedir(), ".qoderwork", "skills");
     case "codex":
       return join(homedir(), ".codex", "skills");
     case "claude":
@@ -257,6 +259,8 @@ function hookConfigPath(agent) {
   switch (agent) {
     case "qoder":
       return join(homedir(), ".qoder", "settings.json");
+    case "qoderwork":
+      return join(homedir(), ".qoderwork", "settings.json");
     case "codex":
       return join(homedir(), ".codex", "hooks.json");
     case "claude":
@@ -306,6 +310,14 @@ async function runSetup(options) {
     ok: true,
     detail: `${agent}: ${cfg.baseUrl} (user_id=${cfg.userId})`
   });
+  if (isBuiltinAgent(agent) && !configuredAgents().includes("default")) {
+    save(cfg, void 0, { agent: "default" });
+    steps.push({
+      step: "write-default-config",
+      ok: true,
+      detail: `default: copied from ${agent}`
+    });
+  }
   if (installSkill && isBuiltinAgent(agent)) {
     const installRoot = skillInstallRoot(agent);
     const skillResult = installSkillsTo(installRoot, agent);
@@ -624,8 +636,10 @@ function checkHookNodePaths(agent) {
       if (!entryIsCtxdb(entry)) continue;
       for (const h of entry.hooks ?? []) {
         if (h?.type !== "command" || typeof h.command !== "string") continue;
-        const cmd = h.command;
-        if (cmd.includes("@aliyunrds/ctxdb")) {
+        if (Array.isArray(h.args) && h.args.length > 0) {
+          nodePaths.add(h.command);
+        } else {
+          const cmd = h.command;
           const parts = cmd.split(" ");
           if (parts.length >= 2 && !parts[0].endsWith(".js") && !parts[0].endsWith(".ts")) {
             nodePaths.add(parts[0]);
@@ -804,6 +818,7 @@ function copySkillDir(src, dest, agent) {
 }
 var SKILL_INSTALL_TARGETS = {
   qoder: join(homedir(), ".qoder", "skills"),
+  qoderwork: join(homedir(), ".qoderwork", "skills"),
   codex: join(homedir(), ".codex", "skills"),
   claude: join(homedir(), ".claude", "skills"),
   openclaw: join(homedir(), ".openclaw", "skills"),
@@ -865,16 +880,18 @@ var LEGACY_MARKER_KEYS = ["_ctxdbQoder", "_ctxdbPackage"];
 var LEGACY_MARKER_VALUES = ["@aliyunrds/ctxdb-qoder"];
 var TOOL_SCOPED_EVENTS = /* @__PURE__ */ new Set(["PreToolUse", "PostToolUse"]);
 function appendOne(hooks, event, command, agent) {
-  const commandWithAgent = `${process.execPath} ${command} --agent=${agent}`;
   if (!Array.isArray(hooks[event])) hooks[event] = [];
+  const useExecForm = agent === "claude";
+  const shellCmd = `${process.execPath} ${command} --agent=${agent}`;
   const dup = hooks[event].some(
     (entry2) => Array.isArray(entry2?.hooks) && entry2.hooks.some(
-      (h) => h?.type === "command" && typeof h.command === "string" && h.command === commandWithAgent
+      (h) => h?.type === "command" && (Array.isArray(h.args) && h.args[0] === command || typeof h.command === "string" && h.command.includes(command))
     )
   );
   if (dup) return;
+  const inner = useExecForm ? { type: "command", command: process.execPath, args: [command, `--agent=${agent}`], timeout: 60 } : { type: "command", command: shellCmd, timeout: 60 };
   const entry = {
-    hooks: [{ type: "command", command: commandWithAgent, timeout: 60 }],
+    hooks: [inner],
     [ENTRY_MARKER_KEY]: ENTRY_MARKER_VALUE,
     [ENTRY_AGENT_KEY]: agent
   };
@@ -1237,7 +1254,7 @@ async function ping(args) {
 var HELP = `ctxdb setup \u2014 configure an agent
 
 USAGE
-  ctxdb setup [--agent <qoder|codex|claude>]
+  ctxdb setup [--agent <qoder|qoderwork|codex|claude>]
               [--api-key=K] [--base-url=URL] [--user-id=ID]
               [--no-install-skill] [--no-validate] [--json]
 
@@ -1248,7 +1265,7 @@ BEHAVIOR
                    specified agent harness.
 
 FLAGS
-  --agent <name>        Target agent (qoder|codex|claude)
+  --agent <name>        Target agent (qoder|qoderwork|codex|claude)
   --api-key <key>       API key (required on first setup)
   --base-url <url>      Server URL (default: https://context-database.aliyuncs.com)
   --user-id <id>        User bucket (default: "default")
@@ -1275,7 +1292,7 @@ async function setup(args) {
   const json = !!args.flags.json;
   if (agent === "default" && !json && !configuredAgents().includes("default")) {
     process.stderr.write(
-      `hint: creating CLI-only "default" agent (no hooks/skills). Use --agent <claude|qoder|codex> for full setup.
+      `hint: creating CLI-only "default" agent (no hooks/skills). Use --agent <claude|qoder|qoderwork|codex> for full setup.
 `
     );
   }
@@ -1300,11 +1317,11 @@ ${h}
 var HELP2 = `ctxdb uninstall \u2014 remove hooks + skills
 
 USAGE
-  ctxdb uninstall [--agent <qoder|codex|claude>] [--purge-config] [--purge-logs] [--purge-all] [--json]
+  ctxdb uninstall [--agent <qoder|qoderwork|codex|claude>] [--purge-config] [--purge-logs] [--purge-all] [--json]
 
 DEFAULT BEHAVIOR (no --agent, no purge flags)
   Strips ctxdb hook entries and skill directories for ALL agents (qoder,
-  codex, claude). Keeps ~/.ctxdb/ctxdb.json (credentials) and ~/.ctxdb/logs/
+  qoderwork, codex, claude). Keeps ~/.ctxdb/ctxdb.json (credentials) and ~/.ctxdb/logs/
   so you can re-run \`ctxdb setup\` later without losing configuration.
 
 WITH --agent <name>
@@ -1312,7 +1329,7 @@ WITH --agent <name>
   Other agents remain untouched.
 
 FLAGS
-  --agent <name>   Target a single agent (qoder|codex|claude)
+  --agent <name>   Target a single agent (qoder|qoderwork|codex|claude)
   --purge-config   Also delete ~/.ctxdb/ctxdb.json
   --purge-logs     Also delete ~/.ctxdb/logs/
   --purge-all      Delete everything under ~/.ctxdb/
@@ -1454,7 +1471,7 @@ function runSelfUpdate(currentVersion, passthroughArgs = []) {
 var HELP3 = `ctxdb upgrade \u2014 refresh skills + hooks
 
 USAGE
-  ctxdb upgrade [--agent <qoder|codex|claude>] [--self-update] [--json]
+  ctxdb upgrade [--agent <qoder|qoderwork|codex|claude>] [--self-update] [--json]
 
 BEHAVIOR
   Refreshes skill files and hook entries for configured agents without
@@ -1464,7 +1481,7 @@ BEHAVIOR
   With --agent:    upgrades only the specified agent.
 
 FLAGS
-  --agent <name>   Target a single agent (qoder|codex|claude)
+  --agent <name>   Target a single agent (qoder|qoderwork|codex|claude)
   --self-update    Also pull latest package from npm before upgrading
   --json           Machine-readable JSON output
 `;
@@ -1570,7 +1587,8 @@ function skillInstall(args) {
     }
     targetRoot = resolved;
   }
-  const result = installSkillsTo(targetRoot);
+  const templateAgent = target && isBuiltinAgent(target) ? target : "default";
+  const result = installSkillsTo(targetRoot, templateAgent);
   const ok = result.ok;
   const output = {
     ok,
@@ -1826,13 +1844,14 @@ USAGE
   ctxdb <command> [args] [--flags]
 
 COMMANDS
-  setup [--agent <qoder|codex|claude>]
+  setup [--agent <qoder|qoderwork|codex|claude>]
         [--api-key=K] [--base-url=URL] [--user-id=ID]
         [--no-install-skill] [--no-validate] [--json]
                                  Without --agent \u2192 writes agents.default (CLI-only, no hooks/skills)
-                                 Qoder    \u2192 writes agents.qoder config + ~/.qoder/settings.json hooks + skill
-                                 Codex    \u2192 writes agents.codex config + ~/.codex/hooks.json hooks + skill
-                                 Claude   \u2192 writes agents.claude config + ~/.claude/settings.json hooks + skill
+                                 Qoder      \u2192 writes agents.qoder config + ~/.qoder/settings.json hooks + skill
+                                 QoderWork  \u2192 writes agents.qoderwork config + ~/.qoderwork/settings.json hooks + skill
+                                 Codex      \u2192 writes agents.codex config + ~/.codex/hooks.json hooks + skill
+                                 Claude     \u2192 writes agents.claude config + ~/.claude/settings.json hooks + skill
   status [--agent <name>] [--json]
   ping [--agent <name>] [--json]
   uninstall [--agent <name>] [--purge-config] [--purge-logs] [--purge-all] [--json]
@@ -1875,7 +1894,7 @@ COMMANDS
                                  doc_id?/tags? for citation.
                                  --raw: server response verbatim (curl parity).
 
-  skill install --target <qoder|codex|claude|openclaw|hermes> [--json]
+  skill install --target <qoder|qoderwork|codex|claude|openclaw|hermes> [--json]
   skill install --path <dir> [--json]
                                  Install skill files (contextdb-memory,
                                  contextdb-knowledge) to an agent's skill directory.
@@ -1888,7 +1907,7 @@ AGENT RESOLUTION (when --agent is omitted):
 ENV VARS (override selected ~/.ctxdb/ctxdb.json agent config):
   CTXDB_AGENT  CTXDB_API_KEY  CTXDB_BASE_URL  CTXDB_USER_ID
 
-CONFIG: ~/.ctxdb/ctxdb.json (agents.default / agents.qoder / agents.codex / agents.claude)
+CONFIG: ~/.ctxdb/ctxdb.json (agents.default / agents.qoder / agents.qoderwork / agents.codex / agents.claude)
 LOGS:   ~/.ctxdb/logs/ctxdb.log
 `;
 var ROUTES = {

package/dist/hooks/session-start.js

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 import {
+  fetchKbCatalogBlock,
   recallTurn
-} from "../chunk-LIC44DR6.js";
+} from "../chunk-73OY44GY.js";
+import "../chunk-6S5RJYBC.js";
 import {
   isCircuitOpen
-} from "../chunk-Q2EEP4CE.js";
+} from "../chunk-52IAVJRK.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -12,7 +14,10 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-S45GOYUU.js";
+} from "../chunk-BWPFGTF7.js";
+
+// src/hooks/session-start.ts
+import { pathToFileURL } from "url";
 
 // src/lib/warmup-recall.ts
 import { execSync } from "child_process";
@@ -67,6 +72,41 @@ async function warmupRecall(cwd, cfg, client) {
 
 // src/hooks/session-start.ts
 var HOOK_TIMEOUT_MS = 5e3;
+function timeout(ms) {
+  return new Promise((resolve) => setTimeout(() => resolve(null), ms));
+}
+async function composeSessionStart(cfg, agent, client, cwd, timeoutMs = HOOK_TIMEOUT_MS) {
+  const kbInjectHere = cfg.kbCatalogInjection === "session_start";
+  const warmupPromise = cfg.warmupRecall ? Promise.race([warmupRecall(cwd, cfg, client), timeout(timeoutMs).then(() => null)]) : Promise.resolve(null);
+  const kbPromise = kbInjectHere ? Promise.race([fetchKbCatalogBlock(client, agent).catch(() => ""), timeout(timeoutMs).then(() => "")]) : Promise.resolve("");
+  const [result, kbBlock] = await Promise.all([warmupPromise, kbPromise]);
+  const warmupTimedOut = cfg.warmupRecall && result === null;
+  const warmupCtx = result && result.ok ? result.additionalContext || "" : "";
+  if (!warmupCtx && result && !result.ok) {
+    debug("warmup", `no result: ${result.reason}`);
+  }
+  let ctx = warmupCtx;
+  if (kbBlock) ctx = ctx ? `${ctx}
+
+${kbBlock}` : kbBlock;
+  return {
+    ctx,
+    memoryCount: result?.ok ? result.memoryCount : 0,
+    kbChunkCount: result?.ok ? result.knowledgeChunkCount : 0,
+    kbCatalogLines: kbBlock ? kbBlock.split("\n").length : 0,
+    warmupTimedOut
+  };
+}
+function formatSessionStartStdout(agent, ctx) {
+  if (agent === "codex") return ctx + "\n";
+  const out = {
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: ctx
+    }
+  };
+  return JSON.stringify(out) + "\n";
+}
 async function readStdinJson() {
   let raw = "";
   for await (const chunk of process.stdin) raw += chunk;
@@ -78,9 +118,6 @@ async function readStdinJson() {
     return {};
   }
 }
-function timeout(ms) {
-  return new Promise((resolve) => setTimeout(() => resolve(null), ms));
-}
 async function main() {
   try {
     const event = await readStdinJson();
@@ -96,8 +133,9 @@ async function main() {
     const cfg = load({ agent });
     setDebug(cfg.debug);
     debug("warmup", "start", { cwd, userId: cfg.userId });
-    if (!isComplete(cfg) || !cfg.warmupRecall) {
-      debug("warmup", "skip (config incomplete or warmupRecall=false)");
+    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)) {
@@ -109,34 +147,21 @@ async function main() {
       apiKey: cfg.apiKey,
       timeoutMs: HOOK_TIMEOUT_MS
     });
-    const result = await Promise.race([
-      warmupRecall(cwd, cfg, client),
-      timeout(HOOK_TIMEOUT_MS).then(() => null)
-    ]);
-    if (!result) {
+    const composed = await composeSessionStart(cfg, agent, client, cwd);
+    if (composed.warmupTimedOut) {
       process.stderr.write("ctxdb warmup: timeout\n");
-      return 0;
     }
-    if (!result.ok || !result.additionalContext) {
-      debug("warmup", `no result: ${result.reason}`);
-      return 0;
-    }
-    debug("warmup", `ok, memories=${result.memoryCount} kb=${result.knowledgeChunkCount}`);
+    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 (${result.memoryCount} memories, ${result.knowledgeChunkCount} kb chunks)
+      `ctxdb warmup: ok (${memoryCount} memories, ${kbChunkCount} kb chunks, kb_catalog=${kbCatalogLines} lines)
 `
     );
-    if (agent === "codex") {
-      process.stdout.write(result.additionalContext + "\n");
-    } else {
-      const out = {
-        hookSpecificOutput: {
-          hookEventName: "SessionStart",
-          additionalContext: result.additionalContext
-        }
-      };
-      process.stdout.write(JSON.stringify(out) + "\n");
-    }
+    process.stdout.write(formatSessionStartStdout(agent, ctx));
     return 0;
   } catch (err) {
     process.stderr.write(`ctxdb warmup: unexpected error: ${err?.message ?? err}
@@ -144,4 +169,11 @@ async function main() {
     return 0;
   }
 }
-main().then((code) => process.exit(code));
+if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
+  main().then((code) => process.exit(code));
+}
+export {
+  HOOK_TIMEOUT_MS,
+  composeSessionStart,
+  formatSessionStartStdout
+};