@aliyunrds/ctxdb 1.0.3 → 1.0.6-beta.0

package/README.md

@@ -6,12 +6,13 @@ Unified access layer for RDS ContextDatabase. One `ctxdb` CLI (memory + KB ops),
 |---|---|---|---|
 | **qoder** | ✅ UserPromptSubmit + Stop + SessionStart | `~/.qoder/skills/ctxdb/` | hooks-driven (auto capture/recall) |
 | **qoderwork** | ✅ UserPromptSubmit + Stop + SessionStart | `~/.qoderwork/skills/ctxdb/` | hooks-driven (auto capture/recall) |
+| **qwenwork** | ✅ UserPromptSubmit + Stop + SessionStart | `~/.qwenwork/skills/ctxdb/` | hooks-driven (auto capture/recall) |
 | **codex** | ✅ UserPromptSubmit + Stop + SessionStart | `~/.codex/skills/ctxdb/` | hooks-driven (auto capture/recall) |
 | **claude** | ✅ UserPromptSubmit + Stop + SessionStart | `~/.claude/skills/ctxdb/` | hooks-driven (auto capture/recall) |
 | **opencode** | Plugin shim (`~/.config/opencode/plugins/ctxdb.ts`) | `~/.config/opencode/skills/` | in-process plugin (auto capture/recall + KB catalog injection) |
 | **hermes** | ✅ `pre_llm_call` + `post_llm_call` | `~/.hermes/skills/` | shell hooks (auto capture/recall + first-turn warmup) |
 
-Config and logs live under `~/.ctxdb/`. `~/.ctxdb/ctxdb.json` is one file, but runtime config is isolated per agent under `agents.qoder`, `agents.qoderwork`, `agents.codex`, `agents.claude`, `agents.opencode`, and `agents.hermes`. (Pre-2026-05-23 installs used `~/.ctxdb.json` at the home root; running `ctxdb setup --agent <name>` migrates the file into the selected agent section.)
+Config and logs live under `~/.ctxdb/`. `~/.ctxdb/ctxdb.json` is one file, but runtime config is isolated per agent under `agents.qoder`, `agents.qoderwork`, `agents.qwenwork`, `agents.codex`, `agents.claude`, `agents.opencode`, and `agents.hermes`. (Pre-2026-05-23 installs used `~/.ctxdb.json` at the home root; running `ctxdb setup --agent <name>` migrates the file into the selected agent section.)
 
 ## Install
 
@@ -103,6 +104,8 @@ npm install -g @aliyunrds/ctxdb
 ctxdb setup --agent qoder --api-key ctxdb-...
 # QoderWork (hooks + skill)
 ctxdb setup --agent qoderwork --api-key ctxdb-...
+# QwenWork (hooks + skill)
+ctxdb setup --agent qwenwork --api-key ctxdb-...
 # Codex (hooks + skill)
 ctxdb setup --agent codex --api-key ctxdb-...
 # Claude Code (hooks + skill)
@@ -161,9 +164,9 @@ ctxdb setup --agent codex --api-key 'ctxdb-new-...'
 ctxdb status --agent codex --json
 ```
 
-Setup first checks that the target agent home exists (`~/.qoder`, `~/.qoderwork`, `~/.codex`, or `~/.claude`). If the directory is missing, install or start that agent once before running `ctxdb setup --agent <name>`. OpenCode and Hermes are config-dir style: setup creates `~/.config/opencode` / `~/.hermes` when they are missing.
+Setup first checks that the target agent home exists (`~/.qoder`, `~/.qoderwork`, `~/.qwenwork`, `~/.codex`, or `~/.claude`; the declared CN variant home also satisfies this check). Setup writes hooks and skills only into homes that already exist, so a CN-only install does not create the international product home, and vice versa. If no home exists, install or start that agent once before running `ctxdb setup --agent <name>`. OpenCode and Hermes are config-dir style: setup creates `~/.config/opencode` / `~/.hermes` when they are missing.
 
-For **qoder**, **qoderwork**, **codex**, and **claude**, restart the harness (CLI: just exit + restart; app: Cmd+R or quit/relaunch) so it picks up the new hooks/skill. For **codex**, setup also writes `[features].hooks = true` into `~/.codex/config.toml` (creating the file if missing) — Codex won't fire any hook entries without it. On first use Codex may prompt you to trust the new hook commands. For **opencode**, restart OpenCode so it loads `~/.config/opencode/plugins/ctxdb.ts`. For **hermes**, setup also checks `~/.hermes/shell-hooks-allowlist.json`; it reports setup as incomplete until both ctxdb hook commands are approved.
+For **qoder**, **qoderwork**, **qwenwork**, **codex**, and **claude**, restart the harness (CLI: just exit + restart; app: Cmd+R or quit/relaunch) so it picks up the new hooks/skill. For **codex**, setup also writes `[features].hooks = true` into `~/.codex/config.toml` (creating the file if missing) — Codex won't fire any hook entries without it. On first use Codex may prompt you to trust the new hook commands. For **opencode**, restart OpenCode so it loads `~/.config/opencode/plugins/ctxdb.ts`. For **hermes**, setup also checks `~/.hermes/shell-hooks-allowlist.json`; it reports setup as incomplete until both ctxdb hook commands are approved.
 
 Hermes owns this security allowlist, so ctxdb only checks it and never writes approvals. Approve the ctxdb `pre_llm_call` and `post_llm_call` hooks with:
 
@@ -189,15 +192,15 @@ ctxdb update --agent codex
 ctxdb update --no-self-update
 ```
 
-For npm-installed copies, eligible interactive `ctxdb` commands also schedule a detached version check at most once every 24 hours. The command never waits for npm: a newly discovered release can be shown only on a later invocation. A successful command may append this hint to stderr:
+For npm-installed copies, eligible direct `ctxdb` commands use a detached version check regardless of whether stderr is a TTY or an Agent-routing flag is present. Checks run on a best-effort daily interval after either a recorded success or failure, so Agent shell tools can receive update information without following a specific invocation shape. The command never waits for npm: a newly discovered release can be shown only on a later invocation. A successful command may append this informational hint to stderr:
 
 ```text
-ctxdb: update available v1.0.2 → v1.1.0; run `ctxdb update`.
+ctxdb: update available v1.0.2 → v1.1.0; update with `ctxdb update` (informational only; do not run automatically).
 ```
 
-The same release is mentioned at most once every 24 hours. Failed registry checks retry with a one-hour exponential backoff capped at six hours. Checks and hints are suppressed for JSON output, non-interactive stderr, CI, `ctxdb update` / `ctxdb upgrade`, and non-npm layouts. Set `CTXDB_DISABLE_UPDATE_CHECK=1` to opt out completely.
+Hints use a best-effort global three-day quiet period, so a higher target version does not bypass a recent reminder. Explicit `--json`, CI, `ctxdb update` / `ctxdb upgrade`, and non-npm layouts remain silent. Non-JSON automation may receive the advisory stderr line; use `--json` when a single machine-readable document is required, or set `CTXDB_DISABLE_UPDATE_CHECK=1` to opt out completely. Concurrent commands may rarely duplicate an advisory hint; the notifier does not add locking to the requested command path.
 
-The notifier only reads/writes `~/.ctxdb/cache/version-check.json`; it never installs a package or changes agent setup. Updating remains an explicit `ctxdb update` action.
+The notifier only reads/writes `~/.ctxdb/cache/version-check.json`; it never installs a package or changes agent setup. Updating remains an explicit `ctxdb update` action for the Agent or user to choose after seeing the hint.
 
 The existing `--self-update` flag remains accepted for compatibility, but is no longer required. If the npm version check, global install, or setup pass fails, ctxdb prints the manual recovery commands:
 
@@ -208,7 +211,7 @@ ctxdb setup
 
 ## What it does
 
-For **qoder**, **qoderwork**, **codex**, and **claude**, hooks fire automatically:
+For **qoder**, **qoderwork**, **qwenwork**, **codex**, and **claude**, hooks fire automatically:
 
 | Trigger | Hook | What runs |
 |---|---|---|
@@ -230,13 +233,60 @@ For **hermes**, `ctxdb setup --agent hermes` writes two shell hooks under `~/.he
 
 `ctxdb` ships grouped non-interactive commands:
 
-- **Top-level**: `setup` / `status` / `ping` / `uninstall` / `update` (`upgrade` alias)
+- **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`
 
 See `ctxdb --help`.
 
-`setup` without `--agent` writes `agents.default` in `~/.ctxdb/ctxdb.json` (CLI-only, no hooks or skills); with `--agent <qoder|qoderwork|codex|claude|opencode|hermes>` it writes agent config and installs hooks/plugins + skills for that harness. Rerunning it repairs integration artifacts and may replace the selected Agent's API key. Memory and KB commands also accept `--agent <name>` so agents use their own config section; when omitted, `CTXDB_AGENT` env wins, otherwise `agents.default` is used. `uninstall` without `--agent` loops every supported agent; with `--agent <name>` it targets just that one. `teardown` is an alias for `uninstall`.
+### Debug control and recall replay
+
+Debug is configured per existing Agent profile without editing JSON manually:
+
+```sh
+ctxdb debug enable --agent=codex
+ctxdb debug disable --agent=codex
+ctxdb debug recall --session=<host-session-id>
+ctxdb debug recall --event=<recall-event-id> --full
+ctxdb debug recall --event=<recall-event-id> --json
+```
+
+Agent resolution follows the rest of the CLI: explicit `--agent`, then
+`CTXDB_AGENT`, then `agents.default`. Enable/disable is local-only: it updates
+only `agents.<name>.debug`, makes no network request, and does not reinstall
+hooks, plugins, or skills. It requires that profile to already exist.
+
+The only official-production URL currently allowlisted is exactly
+`https://context-database.aliyuncs.com` (a trailing slash is equivalent).
+Policy is evaluated after profile/default inheritance and `CTXDB_BASE_URL`.
+Any other complete URL—including pre-production domains, numeric IPs,
+localhost, HTTP, alternate ports or paths—and any invalid URL forces effective
+debug on. `ctxdb debug disable` then fails without modifying the profile. The
+stored preference is kept separately, so returning to the allowlisted URL
+restores it. `ctxdb status` reports `debug` (effective), `debug_configured`,
+`debug_forced`, and `debug_reason` (`non_production_base_url` when forced).
+
+Effective debug writes full-fidelity recall records for qoder, qoderwork,
+qwenwork, codex, claude, opencode, and hermes to
+`~/.ctxdb/logs/recall-trace.jsonl`. The trace contains the complete query,
+complete returned memory/KB candidates, local selected/excluded outcome, and
+the exact context injected into the model. **This can contain sensitive project
+or customer text.** The file is local-only, created with mode `0600`, rotated
+at 10 MiB, and retains at most five rotated generations. API keys,
+Authorization headers, full config objects, and unrelated HTTP bodies are not
+recorded. Trace I/O is fail-open and cannot block a hook.
+
+Each attempt has a `recall_event_id`; all attempts in one host conversation
+carry its local `session_id`. This is distinct from the service `run_id`:
+capture continues sending the host session as `run_id`, while automatic recall
+never sends `run_id` because doing so would narrow long-term retrieval to one
+session. A `recall.start` without a matching `recall.finish` means the hook was
+interrupted or terminated before it could record a completed outcome; it must
+not be interpreted as a completed `timeout`. Disabling debug stops future
+writes but leaves existing trace files available for replay; `ctxdb uninstall
+--purge-logs` removes them.
+
+`setup` without `--agent` writes `agents.default` in `~/.ctxdb/ctxdb.json` (CLI-only, no hooks or skills); with `--agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes>` it writes agent config and installs hooks/plugins + skills for that harness. Rerunning it repairs integration artifacts and may replace the selected Agent's API key. Memory and KB commands also accept `--agent <name>` so agents use their own config section; when omitted, `CTXDB_AGENT` env wins, otherwise `agents.default` is used. `uninstall` without `--agent` loops every supported agent; with `--agent <name>` it targets just that one. `teardown` is an alias for `uninstall`.
 
 `memory add … --no-infer` stores the text verbatim (skips server-side LLM
 fact-extraction). Use it when the user explicitly asks for a verbatim
@@ -338,6 +388,7 @@ Lives at `~/.ctxdb/ctxdb.json` (co-located with logs at `~/.ctxdb/logs/`). Schem
       "debug": false
     },
     "qoderwork": { "...": "same schema, independent values" },
+    "qwenwork": { "...": "same schema, independent values" },
     "codex": { "...": "same schema, independent values" },
     "claude": { "...": "same schema, independent values" },
     "opencode": { "...": "same schema, independent values" },
@@ -346,7 +397,7 @@ Lives at `~/.ctxdb/ctxdb.json` (co-located with logs at `~/.ctxdb/logs/`). Schem
 }
 ```
 
-Agent selection is driven by `--agent <qoder|qoderwork|codex|claude|opencode|hermes|default>` on every CLI invocation, falling back to `CTXDB_AGENT` env, then to `default`. There is no `default_agent` field — older installs that have one written get it dropped on the next save.
+Agent selection is driven by `--agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes|default>` on every CLI invocation, falling back to `CTXDB_AGENT` env, then to `default`. There is no `default_agent` field — older installs that have one written get it dropped on the next save.
 
 Field reference:
 
@@ -361,13 +412,13 @@ Field reference:
 | `recall_knowledge` | bool | `false` | When `auto_recall` is on, also pull KB chunks alongside memory. Default is **off** — the recommended KB-recall path is the agent calling `kb search --agent <name>` explicitly when the user asks |
 | `top_k` / `threshold` | int / float | `5` / `0.4` | Memory recall pagination + similarity floor. `5` keeps the codex TUI `hook context: ...` line short enough to scan and bounds token spend on the modal recall path; raise it per-agent if you want more candidates |
 | `knowledge_top_k` | int | `6` | KB chunks pulled per recall (only effective when `recall_knowledge: true`) |
-| `debug` | bool | `false` | Verbose hook logging (`~/.ctxdb/logs/ctxdb.log`) |
+| `debug` | bool | `false` | Configured preference for verbose hook logging and full recall tracing. Effective debug is forced on for every final `base_url` outside the exact official-production allowlist; see “Debug control and recall replay”. General logs go to `~/.ctxdb/logs/ctxdb.log`, structured full-content recall records to `~/.ctxdb/logs/recall-trace.jsonl` |
 
 Env-var overrides apply to the selected agent config (env wins): `CTXDB_AGENT` / `CTXDB_API_KEY` / `CTXDB_BASE_URL` / `CTXDB_USER_ID` / `CTXDB_AGENT_ID` / `CTXDB_APP_ID`. The last two default to unset — the request body omits `agent_id`/`app_id` entirely; set them only when you want per-agent / per-app scope isolation on the server.
 
 Hook/plugin escape hatch: set `CTXDB_SKIP_HOOKS=TRUE` on the agent process to make all ctxdb hook entrypoints exit immediately before reading config or calling the API. Direct `ctxdb memory` / `ctxdb kb` / `ctxdb setup` CLI commands are unchanged.
 
-`run_id` is **not** env-driven: capture reads the host's session id from the lifecycle payload (Qoder / Codex / Claude Code and Hermes pass `session_id`; opencode reads `ev.properties.sessionID`) and sends it as `run_id` on capture only, so the server can associate turns within one session for richer extraction context. Recall never sends `run_id`. If the payload has no session id, `run_id` is omitted and capture proceeds normally (the server falls back to baseMessages).
+`run_id` is **not** env-driven: capture reads the host's session id from the lifecycle payload (Qoder / Codex / Claude Code and Hermes pass `session_id`; opencode reads `ev.properties.sessionID`) and sends it as `run_id` on capture only, so the server can associate turns within one session for richer extraction context. Recall stores that host value locally as trace `session_id` but never sends `run_id`. If the payload has no session id, trace replay remains possible by `recall_event_id`; capture omits `run_id` and proceeds normally (the server falls back to baseMessages).
 
 ## Architecture
 
@@ -410,6 +461,7 @@ After step 1, `ctxdb uninstall` prints the exact `npm uninstall` command to run
 # first-time install path cleanly.
 ctxdb uninstall --agent qoder
 ctxdb uninstall --agent qoderwork
+ctxdb uninstall --agent qwenwork
 ctxdb uninstall --agent codex
 ctxdb uninstall --agent claude
 ctxdb uninstall --agent opencode
@@ -423,7 +475,7 @@ ctxdb uninstall --purge-logs     # also deletes ~/.ctxdb/logs/
 
 ### What uninstall does (and doesn't) touch
 
-- **Hook entries in `~/.qoder/settings.json`, `~/.qoderwork/settings.json`, `~/.codex/hooks.json`, `~/.claude/settings.json`, and `~/.hermes/config.yaml`**: stripped precisely by marker (`_ctxdb = @aliyunrds/ctxdb`, plus legacy keys `_ctxdbQoder` / `_ctxdbPackage` and the legacy `@aliyunrds/ctxdb-qoder` value for installs predating the unified marker). Any hooks you added yourself stay. A timestamped `*.bak-ctxdb-<TS>` is written before each modification (rotation keeps the 5 most recent).
+- **Hook entries in `~/.qoder/settings.json`, `~/.qoderwork/settings.json`, `~/.qwenwork/settings.json`, `~/.codex/hooks.json`, `~/.claude/settings.json`, and `~/.hermes/config.yaml`**: stripped precisely by marker (`_ctxdb = @aliyunrds/ctxdb`, plus legacy keys `_ctxdbQoder` / `_ctxdbPackage` and the legacy `@aliyunrds/ctxdb-qoder` value for installs predating the unified marker). Any hooks you added yourself stay. A timestamped `*.bak-ctxdb-<TS>` is written before each modification (rotation keeps the 5 most recent).
 - **Skill directories**: `~/.<agent>/skills/ctxdb/` for each set-up agent, plus legacy dirs (`ctxdb-qoder`, `rds-ctxdb-qoder`, `qoder-ctxdb`) under `~/.qoder/skills/` from older package names.
 - **`~/.ctxdb/` state**: only with `--purge-config` / `--purge-logs` / `--purge-all`. Defensive: `--purge-all` removes the `~/.ctxdb/` root only if it's empty after the named files are deleted (won't blanket-rm an unknown directory).
 - **`~/.codex/config.toml` `[features].hooks`**: **NOT** reverted. Setup adds `hooks = true` so Codex will fire ctxdb's hook entries; uninstall leaves the flag alone because (a) the user may have wanted it on for non-ctxdb hooks, and (b) it's harmless when `~/.codex/hooks.json` is empty. If you want it off, edit the file by hand.

package/dist/{chunk-SAQT6VL6.js → chunk-6BB65W5W.js}

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

package/dist/{chunk-BVCDRUU4.js → chunk-7EIJB5LA.js}

@@ -2,12 +2,16 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-Q4JYST7K.js";
+} from "./chunk-VHNHVMCA.js";
 
 // src/lib/user-prompt-submit-compose.ts
-async function composeUserPromptSubmit(cfg, agent, client, prompt) {
+async function composeUserPromptSubmit(cfg, agent, client, prompt, sessionId = null) {
   const [recall, kbBlock] = await Promise.all([
-    recallTurn(prompt, cfg, client, agent),
+    recallTurn(prompt, cfg, client, {
+      agent,
+      sessionId,
+      kind: "prompt"
+    }),
     cfg.kbCatalogInjection === "user_prompt_submit" ? fetchKbCatalogBlock(client, agent).catch(() => "") : Promise.resolve("")
   ]);
   let ctx = recall.additionalContext || "";

package/dist/{chunk-JFTKYEVN.js → chunk-ARZX2RLR.js}

@@ -326,7 +326,7 @@ function parseErrorResponse(text, fallback) {
 import { homedir as homedir2 } from "os";
 import { delimiter, join as join3, sep } from "path";
 import { accessSync, constants, existsSync, statSync } from "fs";
-var SUPPORTED_AGENTS = ["qoder", "qoderwork", "codex", "claude", "opencode", "hermes"];
+var SUPPORTED_AGENTS = ["qoder", "qoderwork", "qwenwork", "codex", "claude", "opencode", "hermes"];
 function isBuiltinAgent(v) {
   return typeof v === "string" && SUPPORTED_AGENTS.includes(v);
 }
@@ -340,6 +340,8 @@ function agentHomeDir(agent, home = homedir2()) {
       return join3(home, ".qoder");
     case "qoderwork":
       return join3(home, ".qoderwork");
+    case "qwenwork":
+      return join3(home, ".qwenwork");
     case "codex":
       return join3(home, ".codex");
     case "claude":
@@ -352,7 +354,8 @@ function agentHomeDir(agent, home = homedir2()) {
 }
 var AGENT_VARIANT_HOMES = {
   qoder: [".qoder-cn"],
-  qoderwork: [".qoderworkcn"]
+  qoderwork: [".qoderworkcn"],
+  qwenwork: [".qwenworkcn"]
 };
 function agentHomeDirs(agent, home = homedir2()) {
   const primary = agentHomeDir(agent, home);
@@ -602,6 +605,9 @@ import { createHmac, randomBytes as randomBytes2 } from "crypto";
 var PROCESS_FINGERPRINT_KEY = randomBytes2(32);
 
 // src/lib/config.ts
+import {
+  resolveDebugPolicy
+} from "@aliyunrds/ctxdb-shared";
 function defaultConfigPath() {
   return join4(homedir3(), ".ctxdb", "ctxdb.json");
 }
@@ -669,7 +675,8 @@ function isV2Schema(raw) {
   return raw.version === 2 && raw.agents !== null && typeof raw.agents === "object" && !Array.isArray(raw.agents);
 }
 function configFromDisk(raw) {
-  return {
+  const debugConfigured = coerceBool(raw.debug, false);
+  return applyDebugPolicy({
     apiKey: typeof raw.api_key === "string" && raw.api_key ? raw.api_key : null,
     baseUrl: typeof raw.base_url === "string" && raw.base_url ? String(raw.base_url).replace(/\/+$/, "") : DEFAULT_BASE_URL,
     userId: typeof raw.user_id === "string" && raw.user_id ? raw.user_id : DEFAULT_USER_ID,
@@ -682,9 +689,20 @@ 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: debugConfigured,
+    debugConfigured,
+    debugForced: false,
+    debugReason: null,
     kbCatalogInjection: coerceKbCatalogInjection(raw.kb_catalog_injection)
-  };
+  });
+}
+function applyDebugPolicy(cfg) {
+  const policy = resolveDebugPolicy(cfg.debugConfigured, cfg.baseUrl);
+  cfg.debug = policy.debug;
+  cfg.debugConfigured = policy.debugConfigured;
+  cfg.debugForced = policy.debugForced;
+  cfg.debugReason = policy.debugReason;
+  return cfg;
 }
 function applyEnv(cfg, env) {
   if (env.CTXDB_API_KEY) cfg.apiKey = env.CTXDB_API_KEY;
@@ -692,7 +710,7 @@ function applyEnv(cfg, env) {
   if (env.CTXDB_USER_ID) cfg.userId = env.CTXDB_USER_ID;
   if (env.CTXDB_AGENT_ID) cfg.agentId = env.CTXDB_AGENT_ID;
   if (env.CTXDB_APP_ID) cfg.appId = env.CTXDB_APP_ID;
-  return cfg;
+  return applyDebugPolicy(cfg);
 }
 function load(options = {}) {
   const path = options.path ?? defaultConfigPath();
@@ -736,7 +754,7 @@ function configToDisk(cfg) {
     top_k: cfg.topK,
     threshold: cfg.threshold,
     knowledge_top_k: cfg.knowledgeTopK,
-    debug: cfg.debug,
+    debug: cfg.debugConfigured,
     kb_catalog_injection: cfg.kbCatalogInjection
   };
 }
@@ -794,6 +812,34 @@ function configuredAgents(path) {
   if (!isV2Schema(raw) || !raw.agents || typeof raw.agents !== "object") return [];
   return Object.keys(raw.agents).filter(isAgent);
 }
+function hasConfiguredAgent(agent, path) {
+  const raw = readRaw(path ?? defaultConfigPath());
+  if (!isV2Schema(raw) || !raw.agents || typeof raw.agents !== "object" || Array.isArray(raw.agents)) {
+    return false;
+  }
+  const profile = raw.agents[agent];
+  return Boolean(
+    profile && typeof profile === "object" && !Array.isArray(profile)
+  );
+}
+function updateConfiguredDebug(agent, configured, path) {
+  const target = path ?? defaultConfigPath();
+  const raw = readRaw(target);
+  if (!isV2Schema(raw) || !raw.agents || typeof raw.agents !== "object" || Array.isArray(raw.agents)) {
+    return false;
+  }
+  const agents = { ...raw.agents };
+  const profile = agents[agent];
+  if (!profile || typeof profile !== "object" || Array.isArray(profile)) {
+    return false;
+  }
+  agents[agent] = { ...profile, debug: configured };
+  secureAtomicWrite(
+    target,
+    JSON.stringify({ ...raw, agents }, null, 2) + "\n"
+  );
+  return true;
+}
 function writeInstalledPkgVersion(version, path) {
   const target = path ?? defaultConfigPath();
   const raw = readRaw(target);
@@ -826,5 +872,7 @@ export {
   removeAgent,
   save,
   configuredAgents,
+  hasConfiguredAgent,
+  updateConfiguredDebug,
   writeInstalledPkgVersion
 };

package/dist/{chunk-USMJLDBD.js → chunk-B7JCQL4O.js}

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

package/dist/{chunk-CWGF5D52.js → chunk-BHRWAU3E.js}

@@ -2,10 +2,10 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-Q4JYST7K.js";
+} from "./chunk-VHNHVMCA.js";
 import {
   debug
-} from "./chunk-JFTKYEVN.js";
+} from "./chunk-ARZX2RLR.js";
 
 // src/lib/warmup-recall.ts
 import { execSync } from "child_process";
@@ -49,13 +49,17 @@ function buildWarmupQuery(cwd, git) {
   }
   return parts.join(", ");
 }
-async function warmupRecall(cwd, cfg, client) {
+async function warmupRecall(cwd, cfg, client, agent = "default", sessionId = null) {
   if (!cfg.warmupRecall) {
     return { ok: false, reason: "warmup_recall_disabled", additionalContext: "", memoryCount: 0, knowledgeChunkCount: 0 };
   }
   const git = collectGitSignals(cwd);
   const query = buildWarmupQuery(cwd, git);
-  return recallTurn(query, cfg, client);
+  return recallTurn(query, cfg, client, {
+    agent,
+    sessionId,
+    kind: "warmup"
+  });
 }
 
 // src/lib/session-start-compose.ts
@@ -63,9 +67,12 @@ 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) {
+async function composeSessionStart(cfg, agent, client, cwd, timeoutMs = HOOK_TIMEOUT_MS, sessionId = null) {
   const kbInjectHere = cfg.kbCatalogInjection === "session_start";
-  const warmupPromise = cfg.warmupRecall ? Promise.race([warmupRecall(cwd, cfg, client), timeout(timeoutMs).then(() => null)]) : Promise.resolve(null);
+  const warmupPromise = cfg.warmupRecall ? Promise.race([
+    warmupRecall(cwd, cfg, client, agent, sessionId),
+    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;

package/dist/{chunk-3PFMHU3C.js → chunk-L4GVGVOP.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CtxdbError
-} from "./chunk-JFTKYEVN.js";
+} from "./chunk-ARZX2RLR.js";
 
 // src/lib/kb.ts
 import {
@@ -243,12 +243,13 @@ async function uploadFileInChunks(client, options) {
       "document_id",
       "chunk complete"
     );
-    if (completedDocumentId !== documentId) {
+    const reusedSucceededDocument = completedDocumentId !== documentId && completed.status === "succeeded";
+    if (completedDocumentId !== documentId && !reusedSucceededDocument) {
       throw new CtxdbError(
         `chunk complete returned mismatched document_id ${completedDocumentId}`
       );
     }
-    return getDocument(client, options.kbName, documentId);
+    return getDocument(client, options.kbName, completedDocumentId);
   } catch (error) {
     if (!completeStarted) {
       try {