@aliyunrds/ctxdb 0.0.4 → 0.0.7

package/README.md

@@ -1,6 +1,6 @@
 # @aliyunrds/ctxdb
 
-Unified access layer for RDS ContextDatabase. One `ctxdb` CLI (memory + KB ops), one `setup --agent <…>` installer, per-agent SKILL.md — supports multiple code agents from a single package.
+Unified access layer for RDS ContextDatabase. One `ctxdb` CLI (memory + KB ops), one `setup` installer (`--agent <…>` for hooks/skills, bare for CLI-only), per-agent SKILL.md — supports multiple code agents from a single package.
 
 | Agent | Hooks | Skill install path | Skill style |
 |---|---|---|---|
@@ -51,15 +51,15 @@ Implementation note: qoder/Claude consume the JSON `hookSpecificOutput.additiona
 
 ## CLI
 
-`ctxdb` ships 19 subcommands:
+`ctxdb` ships 18 subcommands:
 
-- **Top-level**: `init` / `status` / `ping` / `setup` / `teardown`
+- **Top-level**: `setup` / `status` / `ping` / `uninstall` / `upgrade`
 - **Memory**: `memory add|search|list|get|update|delete`
 - **KB**: `kb upload-text|upload-file|list|documents-list|document-get|search`
 
 See `ctxdb --help`.
 
-`setup` mandates `--agent <qoder|codex|claude>` because it mutates that agent's hooks/skills. Memory and KB commands also accept `--agent <name>` so agents use their own config section; when omitted, `CTXDB_AGENT` wins, otherwise `qoder` is used for backward compatibility. `teardown` loops every supported agent.
+`setup` without `--agent` writes `agents.default` in `~/.ctxdb/ctxdb.json` (CLI-only, no hooks or skills); with `--agent <qoder|codex|claude>` it writes agent config and installs hooks + skills for that harness. 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
@@ -100,7 +100,7 @@ Lives at `~/.ctxdb/ctxdb.json` (co-located with logs at `~/.ctxdb/logs/`). Schem
 }
 ```
 
-Agent selection is driven by `--agent <qoder|codex|claude>` on every CLI invocation, falling back to `CTXDB_AGENT` env, then to `qoder`. 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|codex|claude|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:
 
@@ -132,19 +132,19 @@ Two npm packages total. `@aliyunrds/ctxdb-shared` stays separate because OpenCla
 
 ## Uninstall
 
-> ⚠️ **Order matters.** npm 7+ removed the `preuninstall` / `postuninstall` lifecycle hooks — `npm uninstall -g` does **not** run any cleanup we ship. If you `npm uninstall` first you'll leave agent hook entries pointing at a now-missing binary, plus orphaned skills and `~/.ctxdb/` state. Always run **`ctxdb teardown` first, then `npm uninstall -g`**.
+> ⚠️ **Order matters.** npm 7+ removed the `preuninstall` / `postuninstall` lifecycle hooks — `npm uninstall -g` does **not** run any cleanup we ship. If you `npm uninstall` first you'll leave agent hook entries pointing at a now-missing binary, plus orphaned skills and `~/.ctxdb/` state. Always run **`ctxdb uninstall` first, then `npm uninstall -g`**.
 
 ### Full removal (recommended)
 
 ```sh
 # 1. Strip hooks + skills + (optionally) config + logs while the binary still works.
-ctxdb teardown --purge-all     # everything: hooks, skills, ~/.ctxdb/ctxdb.json, ~/.ctxdb/logs/
+ctxdb uninstall --purge-all     # everything: hooks, skills, ~/.ctxdb/ctxdb.json, ~/.ctxdb/logs/
 
 # 2. Then drop the npm binaries.
 npm uninstall -g @aliyunrds/ctxdb @aliyunrds/ctxdb-shared
 ```
 
-After step 1, `ctxdb teardown` prints the exact `npm uninstall` command to run next — copy it from your terminal.
+After step 1, `ctxdb uninstall` prints the exact `npm uninstall` command to run next — copy it from your terminal.
 
 ### Partial removal
 
@@ -154,23 +154,23 @@ After step 1, `ctxdb teardown` prints the exact `npm uninstall` command to run n
 # preserved verbatim. If <X> was the last configured agent, ~/.ctxdb/ctxdb.json
 # itself is unlinked so a future `ctxdb setup --agent <X>` runs through the
 # first-time install path cleanly.
-ctxdb setup --remove --agent qoder
-ctxdb setup --remove --agent codex
-ctxdb setup --remove --agent claude
+ctxdb uninstall --agent qoder
+ctxdb uninstall --agent codex
+ctxdb uninstall --agent claude
 
 # Wholesale across all agents, but keep config + logs for re-setup later:
-ctxdb teardown                  # all agents, keeps ~/.ctxdb/{ctxdb.json,logs/}
-ctxdb teardown --purge-config   # also deletes ~/.ctxdb/ctxdb.json
-ctxdb teardown --purge-logs     # also deletes ~/.ctxdb/logs/
+ctxdb uninstall                  # all agents, keeps ~/.ctxdb/{ctxdb.json,logs/}
+ctxdb uninstall --purge-config   # also deletes ~/.ctxdb/ctxdb.json
+ctxdb uninstall --purge-logs     # also deletes ~/.ctxdb/logs/
 ```
 
-### What teardown does (and doesn't) touch
+### What uninstall does (and doesn't) touch
 
 - **Hook entries in `~/.qoder/settings.json`, `~/.codex/hooks.json`, and `~/.claude/settings.json`**: 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; teardown 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.
-- **`npm` itself**: never. `ctxdb teardown` does not call your host package manager — that's the second command above.
+- **`~/.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.
+- **`npm` itself**: never. `ctxdb uninstall` does not call your host package manager — that's the second command above.
 
 ## Remote SSH (Qoder IDE)
 

package/dist/chunk-6S5RJYBC.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+
+// src/lib/kb.ts
+import { readFileSync, existsSync, statSync } from "fs";
+import { basename, extname } from "path";
+import { homedir } from "os";
+import { resolve } from "path";
+var KB_COLLECTION = "/v1/knowledge/knowledge_bases";
+var DOCUMENTS = "/v1/knowledge/documents";
+var FILES = "/v1/knowledge/files";
+var DOCUMENT_DETAIL = "/v1/knowledge/documents/detail";
+var DEFAULT_POLL_INTERVAL_MS = 1500;
+var DEFAULT_INGEST_TIMEOUT_MS = 3e4;
+var DEFAULT_FILE_INGEST_TIMEOUT_MS = 6e4;
+var MIME_BY_EXT = {
+  ".pdf": "application/pdf",
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".markdown": "text/markdown",
+  ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  ".doc": "application/msword",
+  ".html": "text/html",
+  ".htm": "text/html",
+  ".json": "application/json",
+  ".csv": "text/csv",
+  ".xml": "application/xml",
+  ".rtf": "application/rtf"
+};
+async function listKnowledgeBases(client) {
+  const resp = await client.get(KB_COLLECTION);
+  if (Array.isArray(resp)) return resp;
+  if (resp && typeof resp === "object") {
+    const o = resp;
+    return o.knowledge_bases ?? o.results ?? [];
+  }
+  return [];
+}
+async function createKb(client, kbName, description = "") {
+  return client.postJson(KB_COLLECTION, { name: kbName, description: description || "" });
+}
+async function uploadText(client, kbName, docName, text, mimeType = "text/plain", filePath) {
+  const body = {
+    knowledge_base_name: kbName,
+    name: docName,
+    text,
+    mime_type: mimeType
+  };
+  if (filePath !== void 0 && filePath !== "") body.file_path = filePath;
+  return client.postJson(DOCUMENTS, body);
+}
+async function uploadFile(client, kbName, localPath, options = {}) {
+  const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
+  const expanded = expandHome(localPath);
+  if (!existsSync(expanded)) throw new Error(`file not found: ${expanded}`);
+  const stat = statSync(expanded);
+  if (!stat.isFile()) throw new Error(`not a file: ${expanded}`);
+  if (stat.size > MAX_UPLOAD_BYTES) {
+    throw new Error(
+      `file too large (${(stat.size / 1024 / 1024).toFixed(1)} MB), maximum is 100 MB`
+    );
+  }
+  const filename = basename(expanded);
+  const docName = options.docName ?? filename;
+  const content = readFileSync(expanded);
+  const mime = guessMime(expanded);
+  const fields = {
+    knowledge_base_name: kbName,
+    name: docName
+  };
+  if (options.filePath !== void 0 && options.filePath !== "") {
+    fields.file_path = options.filePath;
+  }
+  return client.postMultipart(
+    FILES,
+    fields,
+    { file: { filename, content, mimeType: mime } },
+    { timeoutMs: options.timeoutMs }
+  );
+}
+function guessMime(path) {
+  const ext = extname(path).toLowerCase();
+  if (ext in MIME_BY_EXT) return MIME_BY_EXT[ext];
+  return "application/octet-stream";
+}
+async function getDocument(client, kbName, docId) {
+  return client.get(DOCUMENT_DETAIL, {
+    knowledge_base_name: kbName,
+    document_id: docId
+  });
+}
+async function listDocuments(client, kbName) {
+  const resp = await client.get(DOCUMENTS, { knowledge_base_name: kbName });
+  if (Array.isArray(resp)) return resp;
+  if (resp && typeof resp === "object") {
+    const o = resp;
+    return o.documents ?? o.results ?? [];
+  }
+  return [];
+}
+async function pollIngest(client, kbName, docId, options = {}) {
+  const timeoutMs = options.timeoutMs ?? DEFAULT_INGEST_TIMEOUT_MS;
+  const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+  const sleep = options.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  const now = options.now ?? (() => performance.now());
+  const deadline = now() + timeoutMs;
+  let doc = await getDocument(client, kbName, docId);
+  let timedOut = false;
+  while (ingestInFlight(doc)) {
+    if (now() >= deadline) {
+      timedOut = true;
+      break;
+    }
+    await sleep(intervalMs);
+    try {
+      doc = await getDocument(client, kbName, docId);
+    } catch {
+      break;
+    }
+  }
+  if (doc && typeof doc === "object") {
+    return { ...doc, _pollingTimedOut: timedOut };
+  }
+  return { _pollingTimedOut: timedOut };
+}
+function ingestInFlight(doc) {
+  if (!doc || typeof doc !== "object") return false;
+  const status = doc.ingest_status;
+  return status === "processing" || status === "pending" || status === "in_progress";
+}
+function expandHome(p) {
+  if (p.startsWith("~/") || p === "~") {
+    return resolve(homedir(), p.slice(2));
+  }
+  return resolve(p);
+}
+function compactChunk(raw) {
+  const c = raw ?? {};
+  const content = c.content_with_weight ?? c.content ?? c.chunk ?? c.text ?? "";
+  const doc_name = c.docnm_kwd ?? c.doc_name ?? c.docnm ?? "";
+  const kbRaw = c.kb_id ?? c.dataset_id;
+  const kb_id = Array.isArray(kbRaw) ? typeof kbRaw[0] === "string" ? kbRaw[0] : "" : typeof kbRaw === "string" ? kbRaw : "";
+  const docIdRaw = c.doc_id;
+  const scoreRaw = c.similarity ?? c.rerank_score;
+  const tagsRaw = c.tag_kwd;
+  const out = {
+    content,
+    doc_name,
+    kb_id,
+    score: typeof scoreRaw === "number" ? scoreRaw : 0
+  };
+  if (typeof docIdRaw === "string" && docIdRaw.length > 0) {
+    out.doc_id = docIdRaw;
+  }
+  if (Array.isArray(tagsRaw) && tagsRaw.length > 0) {
+    out.tags = tagsRaw;
+  }
+  return out;
+}
+function compactKbQueryResponse(raw) {
+  if (!raw || typeof raw !== "object") return { chunks: [] };
+  const r = raw;
+  const chunksIn = Array.isArray(r.chunks) ? r.chunks : [];
+  const out = {
+    chunks: chunksIn.map(compactChunk)
+  };
+  if (typeof r.total === "number") out.total = r.total;
+  return out;
+}
+function minimalChunk(raw) {
+  const c = compactChunk(raw);
+  return { content: c.content, score: c.score };
+}
+function minimalKbQueryResponse(raw) {
+  if (!raw || typeof raw !== "object") return { chunks: [] };
+  const r = raw;
+  const chunksIn = Array.isArray(r.chunks) ? r.chunks : [];
+  const out = {
+    chunks: chunksIn.map(minimalChunk)
+  };
+  if (typeof r.total === "number") out.total = r.total;
+  return out;
+}
+
+export {
+  DEFAULT_INGEST_TIMEOUT_MS,
+  DEFAULT_FILE_INGEST_TIMEOUT_MS,
+  listKnowledgeBases,
+  createKb,
+  uploadText,
+  uploadFile,
+  getDocument,
+  listDocuments,
+  pollIngest,
+  compactChunk,
+  compactKbQueryResponse,
+  minimalChunk,
+  minimalKbQueryResponse
+};

package/dist/{chunk-7NOXAU2X.js → chunk-LIC44DR6.js}

@@ -1,7 +1,12 @@
 #!/usr/bin/env node
+import {
+  isConnectionError,
+  resetCircuit,
+  tripCircuit
+} from "./chunk-Q2EEP4CE.js";
 import {
   CtxdbError
-} from "./chunk-QSSNPN3M.js";
+} from "./chunk-S45GOYUU.js";
 
 // src/lib/recall-orchestrator.ts
 import {
@@ -83,7 +88,7 @@ var EMPTY = {
   memoryCount: 0,
   knowledgeChunkCount: 0
 };
-async function recallTurn(prompt, cfg, client) {
+async function recallTurn(prompt, cfg, client, agent = "default") {
   if (!prompt.trim()) return { ...EMPTY, reason: "empty_prompt" };
   if (!cfg.apiKey || !cfg.baseUrl) {
     return { ...EMPTY, reason: "config_incomplete" };
@@ -101,8 +106,10 @@ async function recallTurn(prompt, cfg, client) {
   let resp;
   try {
     resp = await client.postJson("/v3/memories/search/", body);
+    resetCircuit(agent);
   } catch (err) {
     const msg = err instanceof CtxdbError ? err.message : String(err);
+    if (isConnectionError(err)) tripCircuit(agent, cfg.baseUrl, msg);
     return { ...EMPTY, reason: `http_error: ${msg}` };
   }
   if (!resp || typeof resp !== "object") {

package/dist/chunk-Q2EEP4CE.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import {
+  configDir
+} from "./chunk-S45GOYUU.js";
+
+// src/lib/circuit.ts
+import { statSync, writeFileSync, unlinkSync, mkdirSync, readdirSync, readFileSync } from "fs";
+import { join } from "path";
+var CIRCUIT_DIR_NAME = "circuit";
+var COOLDOWN_MS = 6e4;
+function circuitDir() {
+  const dir = join(configDir(), CIRCUIT_DIR_NAME);
+  try {
+    mkdirSync(dir, { recursive: true });
+  } catch {
+  }
+  return dir;
+}
+function circuitPath(agent) {
+  return join(circuitDir(), `${agent}.circuit`);
+}
+function isCircuitOpen(agent, baseUrl) {
+  const own = checkFile(circuitPath(agent), baseUrl);
+  if (own) return true;
+  try {
+    for (const f of readdirSync(circuitDir())) {
+      if (!f.endsWith(".circuit") || f === `${agent}.circuit`) continue;
+      if (checkFile(join(circuitDir(), f), baseUrl)) return true;
+    }
+  } catch {
+  }
+  return false;
+}
+function checkFile(path, baseUrl) {
+  try {
+    const st = statSync(path);
+    if (Date.now() - st.mtimeMs > COOLDOWN_MS) return false;
+    const line = readFileSync(path, "utf-8").split("\n")[0] || "";
+    return line.startsWith(baseUrl);
+  } catch {
+    return false;
+  }
+}
+function tripCircuit(agent, baseUrl, reason) {
+  try {
+    writeFileSync(circuitPath(agent), `${baseUrl}|${reason}|${(/* @__PURE__ */ new Date()).toISOString()}
+`);
+  } catch {
+  }
+}
+function resetCircuit(agent) {
+  try {
+    unlinkSync(circuitPath(agent));
+  } catch {
+  }
+}
+function isConnectionError(err) {
+  if (!err || typeof err !== "object") return false;
+  if (err.name === "CtxdbHttpError") return false;
+  const msg = err.message ?? "";
+  return /timeout|ECONNREFUSED|ETIMEDOUT|EHOSTUNREACH|ENETUNREACH|network error/i.test(msg);
+}
+
+export {
+  isCircuitOpen,
+  tripCircuit,
+  resetCircuit,
+  isConnectionError
+};

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

@@ -16,7 +16,14 @@ function isDebug() {
 }
 function debug(tag, msg, data) {
   if (_enabled !== true) return;
-  const ts = (/* @__PURE__ */ new Date()).toISOString();
+  const now = /* @__PURE__ */ new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  const ms = String(now.getMilliseconds()).padStart(3, "0");
+  const tz = -now.getTimezoneOffset();
+  const tzSign = tz >= 0 ? "+" : "-";
+  const tzH = pad(Math.floor(Math.abs(tz) / 60));
+  const tzM = pad(Math.abs(tz) % 60);
+  const ts = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}T${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}.${ms}${tzSign}${tzH}:${tzM}`;
   let line = `${ts} [${tag}] ${msg}`;
   if (data !== void 0) {
     const s = typeof data === "string" ? data : JSON.stringify(data, null, 2);
@@ -251,9 +258,13 @@ function extractErrorDetail(text, fallback) {
 import { homedir as homedir2 } from "os";
 import { join as join3 } from "path";
 var SUPPORTED_AGENTS = ["qoder", "codex", "claude"];
-function isAgent(v) {
+function isBuiltinAgent(v) {
   return typeof v === "string" && SUPPORTED_AGENTS.includes(v);
 }
+function isAgentSlug(v) {
+  return v === "default" || isBuiltinAgent(v);
+}
+var isAgent = isAgentSlug;
 function agentHomeDir(agent) {
   switch (agent) {
     case "qoder":
@@ -265,17 +276,17 @@ function agentHomeDir(agent) {
   }
 }
 function agentFromEnv(env = process.env) {
-  return isAgent(env.CTXDB_AGENT) ? env.CTXDB_AGENT : "qoder";
+  return isAgentSlug(env.CTXDB_AGENT) ? env.CTXDB_AGENT : "default";
 }
 function agentFromArgvWithFallback(argv = process.argv.slice(2), env = process.env) {
   for (let i = 0; i < argv.length; i++) {
     const tok = argv[i];
-    if (tok === "--agent" && isAgent(argv[i + 1])) {
+    if (tok === "--agent" && isAgentSlug(argv[i + 1])) {
       return { agent: argv[i + 1], fellBack: false };
     }
     if (tok.startsWith("--agent=")) {
       const raw = tok.slice("--agent=".length);
-      if (isAgent(raw)) return { agent: raw, fellBack: false };
+      if (isAgentSlug(raw)) return { agent: raw, fellBack: false };
     }
   }
   return { agent: agentFromEnv(env), fellBack: true };
@@ -289,6 +300,9 @@ function defaultConfigPath() {
   return join4(homedir3(), ".ctxdb", "ctxdb.json");
 }
 var DEFAULT_CONFIG_PATH = join4(homedir3(), ".ctxdb", "ctxdb.json");
+function configDir() {
+  return join4(homedir3(), ".ctxdb");
+}
 var DEFAULT_BASE_URL = "https://context-database.aliyuncs.com";
 var DEFAULT_USER_ID = "default";
 var DEFAULT_TOP_K = 5;
@@ -297,8 +311,8 @@ var DEFAULT_KNOWLEDGE_TOP_K = 6;
 function isComplete(cfg) {
   return Boolean(cfg.apiKey && cfg.baseUrl);
 }
-function resolveConfigAgent(options = {}) {
-  if (isAgent(options.agent)) return options.agent;
+function resolveConfigAgent(options = {}, preloadedRaw) {
+  if (isAgentSlug(options.agent)) return options.agent;
   return agentFromEnv(options.env);
 }
 function coerceInt(v, fallback) {
@@ -365,8 +379,8 @@ function applyEnv(cfg, env) {
 function load(options = {}) {
   const path = options.path ?? defaultConfigPath();
   const env = options.env ?? process.env;
-  const agent = resolveConfigAgent({ agent: options.agent, env });
   const raw = readRaw(path);
+  const agent = resolveConfigAgent({ ...options, path, env }, raw);
   if (!isV2Schema(raw)) {
     try {
       process.stderr.write(
@@ -377,7 +391,18 @@ function load(options = {}) {
     }
     return applyEnv(configFromDisk({}), env);
   }
-  return applyEnv(configFromDisk(agentRawFromFile(raw, agent)), env);
+  const agentRaw = agentRawFromFile(raw, agent);
+  if (agent !== "default") {
+    const defaultRaw = agentRawFromFile(raw, "default");
+    if (Object.keys(defaultRaw).length > 0) {
+      for (const [k, v] of Object.entries(defaultRaw)) {
+        if (!(k in agentRaw)) {
+          agentRaw[k] = v;
+        }
+      }
+    }
+  }
+  return applyEnv(configFromDisk(agentRaw), env);
 }
 function configToDisk(cfg) {
   return {
@@ -446,23 +471,32 @@ function configuredAgents(path) {
   if (!isV2Schema(raw) || !raw.agents || typeof raw.agents !== "object") return [];
   return Object.keys(raw.agents).filter(isAgent);
 }
+function writeInstalledPkgVersion(version, path) {
+  const target = path ?? defaultConfigPath();
+  const raw = readRaw(target);
+  const updated = { ...raw, installed_pkg_version: version };
+  mkdirSync2(dirname3(target), { recursive: true });
+  writeFileSync(target, JSON.stringify(updated, null, 2) + "\n", "utf-8");
+}
 
 export {
   setDebug,
   debug,
   CtxdbError,
-  NotFoundError,
   HttpClient,
   SUPPORTED_AGENTS,
-  isAgent,
+  isBuiltinAgent,
+  isAgentSlug,
   agentHomeDir,
   agentFromEnv,
   agentFromArgvWithFallback,
+  configDir,
   DEFAULT_BASE_URL,
   DEFAULT_USER_ID,
   isComplete,
   load,
   removeAgent,
   save,
-  configuredAgents
+  configuredAgents,
+  writeInstalledPkgVersion
 };