@aliyunrds/ctxdb 0.0.8-beta.1 → 0.0.8-beta.2

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

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

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

@@ -6,10 +6,10 @@ import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-KEQMJ6IO.js";
+} from "./chunk-52IAVJRK.js";
 import {
   CtxdbError
-} from "./chunk-U3T5O6NX.js";
+} from "./chunk-BWPFGTF7.js";
 
 // src/lib/recall-orchestrator.ts
 import {

package/dist/{chunk-U3T5O6NX.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":
@@ -490,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-U3T5O6NX.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);
@@ -628,11 +640,9 @@ function checkHookNodePaths(agent) {
           nodePaths.add(h.command);
         } else {
           const cmd = h.command;
-          if (cmd.includes("@aliyunrds/ctxdb")) {
-            const parts = cmd.split(" ");
-            if (parts.length >= 2 && !parts[0].endsWith(".js") && !parts[0].endsWith(".ts")) {
-              nodePaths.add(parts[0]);
-            }
+          const parts = cmd.split(" ");
+          if (parts.length >= 2 && !parts[0].endsWith(".js") && !parts[0].endsWith(".ts")) {
+            nodePaths.add(parts[0]);
           }
         }
       }
@@ -808,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"),
@@ -870,14 +881,17 @@ var LEGACY_MARKER_VALUES = ["@aliyunrds/ctxdb-qoder"];
 var TOOL_SCOPED_EVENTS = /* @__PURE__ */ new Set(["PreToolUse", "PostToolUse"]);
 function appendOne(hooks, event, command, 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" && Array.isArray(h.args) && h.args[0] === command
+      (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: process.execPath, args: [command, `--agent=${agent}`], timeout: 60 }],
+    hooks: [inner],
     [ENTRY_MARKER_KEY]: ENTRY_MARKER_VALUE,
     [ENTRY_AGENT_KEY]: agent
   };
@@ -1240,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]
 
@@ -1251,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")
@@ -1278,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.
 `
     );
   }
@@ -1303,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>
@@ -1315,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/
@@ -1457,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
@@ -1467,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
 `;
@@ -1573,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,
@@ -1829,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]
@@ -1878,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.
@@ -1891,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

@@ -2,11 +2,11 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "../chunk-C62I23HL.js";
+} from "../chunk-73OY44GY.js";
 import "../chunk-6S5RJYBC.js";
 import {
   isCircuitOpen
-} from "../chunk-KEQMJ6IO.js";
+} from "../chunk-52IAVJRK.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -14,7 +14,7 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-U3T5O6NX.js";
+} from "../chunk-BWPFGTF7.js";
 
 // src/hooks/session-start.ts
 import { pathToFileURL } from "url";

package/dist/hooks/stop.js

@@ -4,15 +4,16 @@ import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "../chunk-KEQMJ6IO.js";
+} from "../chunk-52IAVJRK.js";
 import {
   CtxdbError,
   HttpClient,
   agentFromArgvWithFallback,
   debug,
+  isDebug,
   load,
   setDebug
-} from "../chunk-U3T5O6NX.js";
+} from "../chunk-BWPFGTF7.js";
 
 // src/lib/capture-orchestrator.ts
 import {
@@ -122,6 +123,48 @@ function toKbDetectionMessages(rows) {
   }
   return out;
 }
+function selectTurnRows(rows) {
+  let turnStart = -1;
+  for (let ri = rows.length - 1; ri >= 0; ri--) {
+    if (hasExtractableUserText(rows[ri])) {
+      turnStart = ri;
+      while (turnStart > 0 && hasExtractableUserText(rows[turnStart - 1])) {
+        turnStart--;
+      }
+      break;
+    }
+  }
+  return turnStart >= 0 ? rows.slice(turnStart) : [];
+}
+function hasExtractableUserText(row) {
+  if (!row || typeof row !== "object") return false;
+  if (row.type === CODEX_RESPONSE_ITEM) {
+    const p = row.payload;
+    if (!p || typeof p !== "object") return false;
+    if (p.type !== "message" || p.role !== "user") return false;
+    const content2 = p.content;
+    if (!Array.isArray(content2)) return false;
+    return content2.some((block) => {
+      if (!block || typeof block !== "object") return false;
+      if (block.type !== "input_text") return false;
+      const text = block.text;
+      return typeof text === "string" && text.trim() && !isCodexScaffoldingText(text);
+    });
+  }
+  if (row.isMeta === true) return false;
+  const msg = row.message;
+  if (!msg || typeof msg !== "object") return false;
+  if (msg.role !== "user") return false;
+  const content = msg.content;
+  if (typeof content === "string") return Boolean(content.trim());
+  if (!Array.isArray(content)) return false;
+  return content.some((block) => {
+    if (!block || typeof block !== "object") return false;
+    if (block.type !== "text") return false;
+    const text = block.text;
+    return typeof text === "string" && Boolean(text.trim());
+  });
+}
 function parseArgs(raw) {
   if (typeof raw !== "string") return {};
   try {
@@ -275,15 +318,10 @@ async function captureTurn(transcriptPath, cfg, client, agent = "default") {
   if (rows.length === 0) {
     return { captured: false, reason: "empty_transcript", messageCount: 0 };
   }
-  const kb = isKnowledgeBaseUploadTurn(toKbDetectionMessages(rows));
-  if (kb.detected) {
-    return {
-      captured: false,
-      reason: `b3c_skip: ${kb.reason ?? "(no reason)"}`,
-      messageCount: 0
-    };
-  }
+  const dbg = isDebug();
+  if (dbg) debug("capture", "transcript rows", summarizeTranscriptRows(rows));
   const parsed = toParsedMessages(rows);
+  if (dbg) debug("capture", "parsed messages", summarizeTextMessages(parsed));
   if (parsed.length === 0) {
     return {
       captured: false,
@@ -292,14 +330,26 @@ async function captureTurn(transcriptPath, cfg, client, agent = "default") {
     };
   }
   const turn = selectTurnMessages(parsed);
+  if (dbg) debug("capture", "selected turn", summarizeTextMessages(turn));
   if (turn.length === 0) {
     return { captured: false, reason: "empty_turn_slice", messageCount: 0 };
   }
   if (!turn.some((m) => m.role === "user")) {
     return { captured: false, reason: "no_user_in_turn", messageCount: 0 };
   }
+  const turnRows = selectTurnRows(rows);
+  if (dbg) debug("capture", "current turn rows", summarizeTranscriptRows(turnRows));
+  const kb = isKnowledgeBaseUploadTurn(toKbDetectionMessages(turnRows));
+  if (kb.detected) {
+    return {
+      captured: false,
+      reason: `b3c_skip: ${kb.reason ?? "(no reason)"}`,
+      messageCount: 0
+    };
+  }
   const rawMessages = turn.map((m) => ({ role: m.role, content: m.content }));
   const filtered = filterMessagesForExtraction(rawMessages);
+  if (dbg) debug("capture", "filtered messages", summarizeTextMessages(filtered));
   if (filtered.length === 0) {
     return { captured: false, reason: "all_filtered", messageCount: 0 };
   }
@@ -310,7 +360,9 @@ async function captureTurn(transcriptPath, cfg, client, agent = "default") {
   if (skills.length > 0) bg.skills = skills.map(
     ({ skill, trigger, args }) => args ? { skill, trigger, args } : { skill, trigger }
   );
-  const messages = bg.git || bg.skills ? [{ role: "background", content: JSON.stringify(bg) }, ...filtered] : filtered;
+  const hasBackground = Boolean(bg.git || bg.skills);
+  if (hasBackground) debug("capture", "background", bg);
+  const messages = hasBackground ? [{ role: "background", content: JSON.stringify(bg) }, ...filtered] : filtered;
   const payload = {
     messages,
     user_id: cfg.userId,
@@ -336,6 +388,104 @@ async function captureTurn(transcriptPath, cfg, client, agent = "default") {
     messageCount: filtered.length
   };
 }
+var DEBUG_TAIL_LIMIT = 25;
+var DEBUG_TEXT_LIMIT = 240;
+var DEBUG_BLOCK_LIMIT = 8;
+function summarizeTextMessages(messages) {
+  return {
+    count: messages.length,
+    roles: countRoles(messages),
+    tail: tailWithIndex(messages).map(({ index, item }) => ({
+      index,
+      parsedIndex: typeof item.index === "number" ? item.index : void 0,
+      role: item.role ?? "(unknown)",
+      content: summarizeText(item.content)
+    }))
+  };
+}
+function summarizeTranscriptRows(rows) {
+  return {
+    count: rows.length,
+    tail: tailWithIndex(rows).map(({ index, item: row }) => ({
+      index,
+      type: row.type,
+      role: rowRole(row),
+      isMeta: row.isMeta === true || void 0,
+      payloadType: row.payload?.type,
+      content: summarizeRowContent(row)
+    }))
+  };
+}
+function tailWithIndex(items) {
+  const start = Math.max(0, items.length - DEBUG_TAIL_LIMIT);
+  return items.slice(start).map((item, offset) => ({ index: start + offset, item }));
+}
+function countRoles(messages) {
+  const counts = {};
+  for (const msg of messages) {
+    const role = msg.role ?? "(unknown)";
+    counts[role] = (counts[role] ?? 0) + 1;
+  }
+  return counts;
+}
+function rowRole(row) {
+  const msgRole = row.message && typeof row.message === "object" ? row.message.role : void 0;
+  if (typeof msgRole === "string") return msgRole;
+  const payloadRole = row.payload && typeof row.payload === "object" ? row.payload.role : void 0;
+  return typeof payloadRole === "string" ? payloadRole : void 0;
+}
+function summarizeRowContent(row) {
+  if (row.type === "response_item") {
+    const p = row.payload;
+    if (!p || typeof p !== "object") return { kind: "missing" };
+    if (p.type === "function_call") {
+      return {
+        kind: "function_call",
+        name: p.name,
+        arguments: summarizeText(p.arguments)
+      };
+    }
+    return summarizeContent(p.content);
+  }
+  return summarizeContent(row.message?.content);
+}
+function summarizeContent(content) {
+  if (typeof content === "string") return summarizeText(content);
+  if (!Array.isArray(content)) {
+    return { kind: content === void 0 ? "missing" : typeof content };
+  }
+  return {
+    kind: "blocks",
+    count: content.length,
+    blocks: content.slice(0, DEBUG_BLOCK_LIMIT).map((block) => summarizeBlock(block)),
+    truncated: content.length > DEBUG_BLOCK_LIMIT || void 0
+  };
+}
+function summarizeBlock(block) {
+  if (!block || typeof block !== "object") return { kind: typeof block };
+  const b = block;
+  const summary = { type: b.type };
+  if (typeof b.name === "string") summary.name = b.name;
+  if (typeof b.text === "string") summary.text = summarizeText(b.text);
+  if (typeof b.thinking === "string") summary.thinking = summarizeText(b.thinking);
+  if (typeof b.content === "string") summary.content = summarizeText(b.content);
+  const input = b.input;
+  if (input && typeof input === "object" && !Array.isArray(input)) {
+    const i = input;
+    summary.inputKeys = Object.keys(i).sort();
+    if (typeof i.command === "string") summary.command = summarizeText(i.command);
+  }
+  return summary;
+}
+function summarizeText(text) {
+  if (typeof text !== "string") return { kind: text === void 0 ? "missing" : typeof text };
+  const normalized = text.replace(/\s+/g, " ").trim();
+  return {
+    kind: "text",
+    length: text.length,
+    snippet: normalized.length > DEBUG_TEXT_LIMIT ? `${normalized.slice(0, DEBUG_TEXT_LIMIT)}...` : normalized
+  };
+}
 
 // src/hooks/stop.ts
 async function readStdinJson() {

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

@@ -2,11 +2,11 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "../chunk-C62I23HL.js";
+} from "../chunk-73OY44GY.js";
 import "../chunk-6S5RJYBC.js";
 import {
   isCircuitOpen
-} from "../chunk-KEQMJ6IO.js";
+} from "../chunk-52IAVJRK.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -14,7 +14,7 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-U3T5O6NX.js";
+} from "../chunk-BWPFGTF7.js";
 
 // src/hooks/user-prompt-submit.ts
 import { pathToFileURL } from "url";

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

@@ -18,14 +18,14 @@ description: contextdb 知识库高频操作（查询 / 浏览 KB / 上传文档
 
 ## 2. 高频 recipes
 
-> 命令里 `--agent=qoder` 是必填参数。如果用户跑别的 agent（codex / claude），把 `qoder` 替换成对应名字。
+> 命令里的 `--agent={{agent}}` 是当前 skill 安装目标。不要把示例改成 `qoder`；如果读到未替换的双花括号 agent 模板，先按 §6 判定真实 agent，再替换成 `qoder` / `qoderwork` / `codex` / `claude` / `default`。
 
 ### Recipe 1：在已知 KB 中查内容（最常见）
 
 **场景**：用户问"X KB 里关于 Y 的内容"、"在知识库 Z 查一下 W"。
 
 ```sh
-ctxdb kb search "<query>" --kb=<kb-name> --top-k=6 --agent=qoder
+ctxdb kb search "<query>" --kb=<kb-name> --top-k=6 --agent={{agent}}
 ```
 
 返回 `chunks` 数组，按 `score` 倒序判断相关性；默认 threshold 0.4，空结果时见 §5 注意事项 4。
@@ -37,7 +37,7 @@ ctxdb kb search "<query>" --kb=<kb-name> --top-k=6 --agent=qoder
 **场景**：用户问"有哪些知识库"、"列一下 KB"，或本身在写 recipe 1 之前需要确认 KB 名。
 
 ```sh
-ctxdb kb list --agent=qoder
+ctxdb kb list --agent={{agent}}
 ```
 
 返回 `knowledge_bases` 数组，每项含 `name` / `id` / `document_count`。跨多 KB 查 chunk 时把 `name` 拼起来：`--kb=a,b,c`。
@@ -49,7 +49,7 @@ ctxdb kb list --agent=qoder
 **场景**：用户问"X KB 收了哪些文档"、"X KB 里有几篇"。
 
 ```sh
-ctxdb kb documents-list <kb-name> --agent=qoder
+ctxdb kb documents-list <kb-name> --agent={{agent}}
 ```
 
 返回 `documents` 数组，每项含 `name` / `id` / `size`。
@@ -61,7 +61,7 @@ ctxdb kb documents-list <kb-name> --agent=qoder
 **场景**：用户说"把这段记进 X KB"、"上传这段文字到知识库 Y"。
 
 ```sh
-ctxdb kb upload-text <kb-name> <doc-name> --text="<body>" --agent=qoder
+ctxdb kb upload-text <kb-name> <doc-name> --text="<body>" --agent={{agent}}
 ```
 
 副作用操作。**用户没明示 KB 名前先 recipe 2 列出来确认**（见 §5 注意事项 3）。KB 不存在会直接报错，不自动创建。
@@ -73,7 +73,7 @@ ctxdb kb upload-text <kb-name> <doc-name> --text="<body>" --agent=qoder
 **场景**：用户说"把 X.pdf 上传到 Y KB"、"灌这个文件进知识库 Z"。
 
 ```sh
-ctxdb kb upload-file <kb-name> <local-path> --agent=qoder
+ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 ```
 
 支持格式：PDF / DOCX / MD / TXT。默认等待 chunking 完成；想立即返回加 `--no-wait`（见 §6）。
@@ -118,7 +118,7 @@ ctxdb kb upload-file <kb-name> <local-path> --agent=qoder
 
 - **现象**：在 shell 里写 `ctxdb kb list | python3 -c "import json,sys; ..."` 经常因为单/双引号嵌套 escape 失败
 - **根因**：shell + python -c 的引号是两层独立 escape，组合时极容易漏
-- **正确做法**：`ctxdb kb list --agent=qoder | jq '.knowledge_bases[].name'`；jq 表达式在单引号里不需要 escape
+- **正确做法**：`ctxdb kb list --agent={{agent}} | jq '.knowledge_bases[].name'`；jq 表达式在单引号里不需要 escape
 
 ### 注意事项 3：`upload-*` / `create` 是副作用，没明示 KB 名前必须先确认
 
@@ -136,7 +136,7 @@ ctxdb kb upload-file <kb-name> <local-path> --agent=qoder
 
 - **现象**：`kb upload-text foo bar --text=...` 报错 "kb 'foo' not found"
 - **根因**：上传命令只写已有 KB，**不会**为了你 implicit 建一个
-- **正确做法**：先 `ctxdb kb create foo --agent=qoder`，再 upload
+- **正确做法**：先 `ctxdb kb create foo --agent={{agent}}`，再 upload
 
 ## 6. 高级参数
 
@@ -172,18 +172,20 @@ ctxdb kb upload-file <kb-name> <local-path> --agent=qoder
 
 | 参数 | 说明 |
 |------|------|
-| `--agent=<name>` | **必填**。指定操作哪个 agent 的配置桶（`qoder` / `codex` / `claude` / `default`） |
+| `--agent=<name>` | **必填**。指定操作哪个 agent 的配置桶（`qoder` / `qoderwork` / `codex` / `claude` / `default`） |
 
 `--agent` 解析顺序：
 1. 命令行显式 `--agent=<name>` → 用它
 2. 缺省 → 读 `CTXDB_AGENT` 环境变量
 3. env 也没有 → 落到 `"default"` 桶
-4. 若 `"default"` 桶未通过 `ctxdb setup --api-key=... --base-url=...` 配置过 → exit 2 "config incomplete for agent default"
+4. 新版本 `ctxdb setup --agent <qoder|qoderwork|codex|claude>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
+5. 若 `"default"` 桶仍不存在或未配置完整 → exit 2 "config incomplete for agent default"
 
 ## 7. 配置
 
-- 配置文件：`~/.ctxdb/ctxdb.json`，分 `agents.<name>` 段（`qoder` / `codex` / `claude` / `default`），互不复用
+- 配置文件：`~/.ctxdb/ctxdb.json`，分 `agents.<name>` 段（`qoder` / `qoderwork` / `codex` / `claude` / `default`），互不复用
 - 配置命令：`ctxdb setup --agent <name> --api-key=<key> --base-url=<url> [--user-id=<id>]`
-  - 带 `--agent` 时还会装 hooks + skill；不带 `--agent` 时只写 `agents.default` 段（仅 CLI 用）
+  - 带 `--agent` 时还会装 hooks + skill；若 `agents.default` 缺失，会复制当前 agent 配置作为 CLI 兜底
+  - `--agent default` 只写 `agents.default` 段（仅 CLI 用，不装 hooks / skill）
 - 连接检查：`ctxdb ping --agent=<name>`
 - 状态查看：`ctxdb status --agent=<name>`

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

@@ -18,14 +18,14 @@ description: contextdb 长期记忆高频操作（主动记忆 / 搜索过往 /
 
 ## 2. 高频 recipes
 
-> 命令里 `--agent=qoder` 是必填参数。如果用户跑别的 agent（codex / claude），把 `qoder` 替换成对应名字。
+> 命令里的 `--agent={{agent}}` 是当前 skill 安装目标。不要把示例改成 `qoder`；如果读到未替换的双花括号 agent 模板，先按 §6 判定真实 agent，再替换成 `qoder` / `qoderwork` / `codex` / `claude` / `default`。
 
 ### Recipe 1：主动记忆（"记住 X"）
 
 **场景**：用户明确说"记住"、"帮我记一下"、"把这条写进记忆"。
 
 ```sh
-ctxdb memory add "<text>" --agent=qoder
+ctxdb memory add "<text>" --agent={{agent}}
 ```
 
 默认走 LLM fact-extraction（同步等结果）。想原文存（项目代号 / 精确数值）加 `--no-infer`（见 §6）。
@@ -39,7 +39,7 @@ ctxdb memory add "<text>" --agent=qoder
 **场景**：用户问"之前我们讨论过 X 吗"、"上次怎么说的"、"我之前提过 Y 没"。
 
 ```sh
-ctxdb memory search "<query>" --agent=qoder
+ctxdb memory search "<query>" --agent={{agent}}
 ```
 
 返回 `results` 数组，每项含 `id` / `memory` / `score`，按 score 倒序。top-5 默认。想同时搜知识库 chunks 加 `--knowledge`（见 §6）。
@@ -51,7 +51,7 @@ ctxdb memory search "<query>" --agent=qoder
 **场景**：排查"刚才那条记进去没"、用户想看"系统记了我什么"。
 
 ```sh
-ctxdb memory list --page-size=20 --agent=qoder
+ctxdb memory list --page-size=20 --agent={{agent}}
 ```
 
 返回 `results` 数组（含 `total` 计数）。按 category 过滤加 `--category=<cat>`（见 §6）。
@@ -64,10 +64,10 @@ ctxdb memory list --page-size=20 --agent=qoder
 
 ```sh
 # 改
-ctxdb memory update <memory-id> --text="<new-text>" --agent=qoder
+ctxdb memory update <memory-id> --text="<new-text>" --agent={{agent}}
 
 # 删单条
-ctxdb memory delete <memory-id> --agent=qoder
+ctxdb memory delete <memory-id> --agent={{agent}}
 ```
 
 `<memory-id>` 必须先用 recipe 2 或 recipe 3 拿到。
@@ -165,18 +165,20 @@ ctxdb memory delete <memory-id> --agent=qoder
 
 | 参数 | 说明 |
 |------|------|
-| `--agent=<name>` | **必填**。指定操作哪个 agent 的配置桶（`qoder` / `codex` / `claude` / `default`） |
+| `--agent=<name>` | **必填**。指定操作哪个 agent 的配置桶（`qoder` / `qoderwork` / `codex` / `claude` / `default`） |
 
 `--agent` 解析顺序：
 1. 命令行显式 `--agent=<name>` → 用它
 2. 缺省 → 读 `CTXDB_AGENT` 环境变量
 3. env 也没有 → 落到 `"default"` 桶
-4. 若 `"default"` 桶未通过 `ctxdb setup --api-key=... --base-url=...` 配置过 → exit 2 "config incomplete for agent default"
+4. 新版本 `ctxdb setup --agent <qoder|qoderwork|codex|claude>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
+5. 若 `"default"` 桶仍不存在或未配置完整 → exit 2 "config incomplete for agent default"
 
 ## 7. 配置
 
-- 配置文件：`~/.ctxdb/ctxdb.json`，分 `agents.<name>` 段（`qoder` / `codex` / `claude` / `default`），互不复用
+- 配置文件：`~/.ctxdb/ctxdb.json`，分 `agents.<name>` 段（`qoder` / `qoderwork` / `codex` / `claude` / `default`），互不复用
 - 配置命令：`ctxdb setup --agent <name> --api-key=<key> --base-url=<url> [--user-id=<id>]`
-  - 带 `--agent` 时还会装 hooks + skill；不带 `--agent` 时只写 `agents.default` 段（仅 CLI 用）
+  - 带 `--agent` 时还会装 hooks + skill；若 `agents.default` 缺失，会复制当前 agent 配置作为 CLI 兜底
+  - `--agent default` 只写 `agents.default` 段（仅 CLI 用，不装 hooks / skill）
 - 连接检查：`ctxdb ping --agent=<name>`
 - 状态查看：`ctxdb status --agent=<name>`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliyunrds/ctxdb",
-  "version": "0.0.8-beta.1",
+  "version": "0.0.8-beta.2",
   "type": "module",
   "description": "Unified access layer for RDS ContextDatabase: `ctxdb` CLI (memory + KB ops), one-shot `setup --agent <qoder|codex|claude>` installer, per-agent config, hooks, and SKILL.md.",
   "license": "Apache-2.0",