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

package/README.md

@@ -129,6 +129,8 @@ Field reference:
 
 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: the Stop hook reads the host's `session_id` from the hook payload (Qoder / Codex / Claude Code all pass it at the top level; 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).
 
 ## Architecture

package/dist/chunk-UEKR2Z3S.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+// src/lib/hook-env.ts
+var CTXDB_SKIP_HOOKS = "CTXDB_SKIP_HOOKS";
+function shouldSkipHooks(env = process.env) {
+  return env[CTXDB_SKIP_HOOKS] === "TRUE";
+}
+
+export {
+  shouldSkipHooks
+};

package/dist/cli/main.js

@@ -2257,6 +2257,11 @@ 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
+  CTXDB_AGENT_ID  CTXDB_APP_ID
+
+HOOK ENV VARS:
+  CTXDB_SKIP_HOOKS=TRUE       Hook/plugin entrypoints exit immediately.
+                              Direct ctxdb CLI commands are unchanged.
 
 CONFIG: ~/.ctxdb/ctxdb.json (agents.default / agents.qoder / agents.qoderwork / agents.codex / agents.claude / agents.opencode)
 LOGS:   ~/.ctxdb/logs/ctxdb.log

package/dist/hooks/pre-tool-use.js

@@ -1,7 +1,11 @@
 #!/usr/bin/env node
+import {
+  shouldSkipHooks
+} from "../chunk-UEKR2Z3S.js";
 
 // src/hooks/pre-tool-use.ts
 async function main() {
+  if (shouldSkipHooks()) return 0;
   for await (const _chunk of process.stdin) {
   }
   return 0;

package/dist/hooks/session-start.js

@@ -15,6 +15,9 @@ import {
   load,
   setDebug
 } from "../chunk-TKMIWM6Q.js";
+import {
+  shouldSkipHooks
+} from "../chunk-UEKR2Z3S.js";
 
 // src/hooks/session-start.ts
 import { pathToFileURL } from "url";
@@ -120,6 +123,7 @@ async function readStdinJson() {
 }
 async function main() {
   try {
+    if (shouldSkipHooks()) return 0;
     const event = await readStdinJson();
     const { agent, fellBack } = agentFromArgvWithFallback();
     if (fellBack) {

package/dist/hooks/stop.js

@@ -14,6 +14,9 @@ import {
   load,
   setDebug
 } from "../chunk-TKMIWM6Q.js";
+import {
+  shouldSkipHooks
+} from "../chunk-UEKR2Z3S.js";
 
 // src/lib/capture-orchestrator.ts
 import {
@@ -513,6 +516,7 @@ function extractHookSessionId(event) {
 }
 async function main() {
   try {
+    if (shouldSkipHooks()) return 0;
     const event = await readStdinJson();
     const { agent, fellBack } = agentFromArgvWithFallback();
     if (fellBack) {

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

@@ -15,6 +15,9 @@ import {
   load,
   setDebug
 } from "../chunk-TKMIWM6Q.js";
+import {
+  shouldSkipHooks
+} from "../chunk-UEKR2Z3S.js";
 
 // src/hooks/user-prompt-submit.ts
 import { pathToFileURL } from "url";
@@ -52,6 +55,7 @@ async function readStdinJson() {
 }
 async function main() {
   try {
+    if (shouldSkipHooks()) return 0;
     const event = await readStdinJson();
     const { agent, fellBack } = agentFromArgvWithFallback();
     if (fellBack) {

package/dist/opencode/index.js

@@ -825,6 +825,12 @@ async function runCapture(messages, cfg, client, timeoutMs, lastFingerprint, ses
   };
 }
 
+// src/hook-env.ts
+var CTXDB_SKIP_HOOKS = "CTXDB_SKIP_HOOKS";
+function shouldSkipHooks(env = process.env) {
+  return env[CTXDB_SKIP_HOOKS] === "TRUE";
+}
+
 // src/hooks.ts
 var SESSION_TTL_MS = 15 * 60 * 1e3;
 var SESSION_MAX = 100;
@@ -870,6 +876,7 @@ function extractTextPrompt(parts) {
   return chunks.join("\n").trim();
 }
 async function buildHooks(input) {
+  if (shouldSkipHooks()) return {};
   const config = loadOpencodeConfig();
   if (!isConfigured(config)) {
     logDebug(

package/package.json

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