@aliyunrds/ctxdb 1.0.11-beta.0 → 1.0.12-beta.0

package/README.md

@@ -44,9 +44,9 @@ session remains available for `ctxdb setup --agent <name>` to retry. Hermes appr
 remain explicit, and successful setup includes the usual host restart/trust reminders.
 Ordinary setup preserves
 existing authentication and binds the default login only for an Agent without an authentication
-choice. Without `--base-url`, setup resets the selected credential's DATA endpoint to
-`https://api.cn-hangzhou.agentcontext.aliyuncs.com`, including existing keys and logins.
-All Agents sharing that login use its updated endpoint. `setup --all` applies the same policy to detected Agents.
+choice. Setup, setup --all, update and reauthorization retain each credential's saved DATA endpoint.
+A fresh installation defaults to China. To switch sites, authorize a new login with `--site`,
+or supply that site's API key with `setup --api-key ... --site ...`; setup never redirects an existing token.
 An explicit invalid `--base-url` (including a missing or empty value) fails before configuration
 changes and suggests the current production URL; it never acts like an omitted option.
 
@@ -85,13 +85,20 @@ Upgrade the CLI and the actual hooks/plugin artifacts together before enabling s
 New CLI reading old v2 configuration is supported; old CLI reading shared-login configuration is not.
 See [共享登录、完整命令与兼容契约](../../docs/cli-shared-login.md) for migration and concurrency details.
 
-The production Core origin `https://api.cn-hangzhou.agentcontext.aliyuncs.com` defaults to the console page
-`https://rdsnext.console.aliyun.com/contextDbCliAuthorization/cn-hangzhou`. CLI appends the current
-`user_code`; the console route uses the fixed `cn-hangzhou` region.
-Ordinary DATA requests and artifact-only `upgrade` keep the configured origin, without endpoint fallback.
-`setup` and every `login`, including reauthorization, use the default production origin unless
-`--base-url` is supplied. Relogin no longer inherits the previous session's origin.
-Explicitly selecting the legacy Core origin `https://context-database.aliyuncs.com` keeps the same console mapping.
+Official site presets live in `access_layer/shared/src/sites.ts` and are shared with debug policy.
+Use `ctxdb login --agent codex --site intl` for international Singapore, or `--site cn` for China.
+`setup --api-key <key> --site intl` and `openclaw ctxdb init --api-key <key> --site intl`
+select the same service. A matching `setup --site` preserves the credential's exact official alias.
+
+| Site | Core endpoint | Console authorization page |
+|---|---|---|
+| `cn` | `https://api.cn-hangzhou.agentcontext.aliyuncs.com` | `https://rdsnext.console.aliyun.com/contextDbCliAuthorization/cn-hangzhou` |
+| `intl` | `https://context-database.ap-southeast-1.aliyuncs.com` | `https://rds.console.alibabacloud.com/contextDbCliAuthorization/ap-southeast-1` |
+
+The China alias `https://context-database.aliyuncs.com` retains its China console mapping.
+Specifying the Singapore `--base-url` also selects the international authorization page automatically.
+CLI appends the current `user_code`. A site preset cannot be combined with `--base-url`, `--server`
+or `--login-url`; explicit `--site` uses its built-in authorization page.
 Use `--base-url` to select the Core service and `--login-url` to supply the HTTPS console page
 for this invocation. The latter does not change the service origin or persist a console mapping.
 The legacy `--server` alias for `--base-url` remains accepted; do not pass both.
@@ -155,7 +162,11 @@ ctxdb auth status --json
 
 The internal tarball bundles `@aliyunrds/ctxdb-shared`, so users install only
 one ContextDB package. `semver` and `yaml` remain normal registry dependencies.
-Maintainers should follow [`INTERNAL_PUBLISH.md`](./INTERNAL_PUBLISH.md).
+Maintainers should follow [`INTERNAL_PUBLISH.md`](./INTERNAL_PUBLISH.md) for Ali NPM.
+For public releases, use [`LOCAL_PUBLISH.md`](./LOCAL_PUBLISH.md) to build with
+`pnpm pack` and validate the exact tarballs, then follow [`PUBLISH.md`](./PUBLISH.md)
+to upload those tarballs with `npm publish`. npm publication does not update the
+separate [OSS installer scripts and agent manual](../../docs/bootstrap-release.md).
 
 ### Recommended: console-generated installer command
 
@@ -407,7 +418,8 @@ hooks, plugins, or skills. It requires that profile to already exist.
 
 The official-production URL allowlist contains
 `https://api.cn-hangzhou.agentcontext.aliyuncs.com` and the legacy
-`https://context-database.aliyuncs.com` (a trailing slash is equivalent).
+`https://context-database.aliyuncs.com`, plus Singapore
+`https://context-database.ap-southeast-1.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
@@ -1017,3 +1029,10 @@ Codex 0.153.4 has completed the automatic lifecycle against a local test center/
 上传时可用 `ctxdb kb upload-text` 或 `ctxdb kb upload-file` 的 `--review-enabled` / `--no-review-enabled` 覆盖本次文档评审开关；不传时沿用服务端默认，不修改知识库策略。两标志互斥，分片上传保留同一选择。上传回执不代表评审或入库完成，应查询实际状态。
 
 `memory get <fact-id> --verbose` 通过原生 Fact 详情接口读取状态、关联实体 ID、来源及参考/记录时间；默认 `memory get` 的 mem0 输出保持兼容。召回统计可从同一身份的 `memory list` 中按 ID 对应读取。
+
+
+### 删除记忆与自动采集
+
+Agent 本轮实际调用 `ctxdb memory delete` / `memory batch-delete` 或已注册的 ContextDB 删除工具后，该轮自动采集返回 `memory_cleanup_skip`。即使删除失败，也不会把清理请求和结果汇报再次自动写入记忆；同轮其他业务信息也会跳过。查询、搜索、列出记忆正常采集，下一轮正常判断。
+
+该规则不改变删除接口，不新增配置项。自动采集只发送当前轮正文，不重复加入前序摘要。命令示例和帮助命令不触发；隐藏在自定义脚本、动态命令或直接 HTTP/SDK 请求内的删除不在首版检测保证范围。宿主完成条件与验收范围见 [hooks 支持矩阵](../../docs/hooks-support-matrix.md)。

package/dist/{chunk-EWCB3UQS.js → chunk-4GYXLFNU.js}

@@ -1,28 +1,33 @@
 #!/usr/bin/env node
+import {
+  resolveMemoryUploadAgentId
+} from "./chunk-SR3M7AL5.js";
 import {
   isCircuitOpen,
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-7RMETV4M.js";
-import {
-  resolveMemoryUploadAgentId
-} from "./chunk-SR3M7AL5.js";
+} from "./chunk-7CZIQG6Z.js";
 import {
   CtxdbError,
   debug,
   extractSkillSignals,
   isDataApiReady,
   isDebug,
-  readTranscript,
+  normalizeTranscriptRows,
+  readTranscriptSnapshot,
   selectTurnRows,
   toKbDetectionMessages,
   toParsedMessages
-} from "./chunk-HHKQPWYI.js";
+} from "./chunk-HUX2XS5P.js";
 
 // src/lib/capture-orchestrator.ts
 import {
   filterMessagesForExtraction,
+  detectMemoryCleanup,
+  captureToolCalls,
+  selectCaptureTurn,
+  captureCompletionReason,
   isKnowledgeBaseUploadTurn,
   selectTurnMessages
 } from "@aliyunrds/ctxdb-shared";
@@ -48,10 +53,23 @@ function getGitContext() {
 }
 
 // src/lib/capture-orchestrator.ts
-async function captureTurn(transcriptPath, cfg, client, agent = "default", sessionId) {
+async function captureTurn(transcriptPath, cfg, client, agent = "default", sessionId, completion = {}) {
   const preflight = capturePreflight(cfg, agent);
   if (preflight) return preflight;
-  const rows = readTranscript(transcriptPath);
+  const snapshot = readTranscriptSnapshot(transcriptPath);
+  if (snapshot.incomplete) return { captured: false, reason: "transcript_incomplete", messageCount: 0 };
+  const rawTurn = selectCaptureTurn(snapshot.rawRows);
+  const toolCalls = captureToolCalls(rawTurn);
+  const cleanup = detectMemoryCleanup(toolCalls);
+  if (cleanup.detected) {
+    debug("capture", "memory cleanup skipped", { agent, sessionId, turnId: completion.turnId, operation: cleanup.operation, source: cleanup.source });
+    return { captured: false, reason: "memory_cleanup_skip", messageCount: 0 };
+  }
+  const rows = normalizeTranscriptRows(rawTurn);
+  if (!rawTurn.length && snapshot.rows.length) {
+    const reason = toParsedMessages(snapshot.rows).length ? "empty_turn_slice" : `transcript_schema_mismatch: rows=${snapshot.rows.length} parsed=0`;
+    return { captured: false, reason, messageCount: 0 };
+  }
   if (rows.length === 0) {
     return { captured: false, reason: "empty_transcript", messageCount: 0 };
   }
@@ -69,12 +87,19 @@ async function captureTurn(transcriptPath, cfg, client, agent = "default", sessi
   if (dbg) debug("capture", "current turn rows", summarizeTranscriptRows(turnRows));
   return captureParsedMessages(parsed, cfg, client, agent, sessionId, {
     kbDetectionMessages: toKbDetectionMessages(turnRows),
-    skills: extractSkillSignals(rows)
+    skills: extractSkillSignals(rows),
+    toolCalls,
+    completionReason: captureCompletionReason(rawTurn, completion)
   });
 }
 async function captureParsedMessages(parsed, cfg, client, agent = "default", sessionId, options = {}) {
   const preflight = capturePreflight(cfg, agent);
   if (preflight) return preflight;
+  const cleanup = detectMemoryCleanup(options.toolCalls ?? captureToolCalls(options.kbDetectionMessages ?? []));
+  if (cleanup.detected) {
+    debug("capture", "memory cleanup skipped", { agent, sessionId, operation: cleanup.operation, source: cleanup.source });
+    return { captured: false, reason: "memory_cleanup_skip", messageCount: 0 };
+  }
   if (parsed.length === 0) {
     return { captured: false, reason: "empty_messages", messageCount: 0 };
   }
@@ -101,6 +126,7 @@ async function captureParsedMessages(parsed, cfg, client, agent = "default", ses
       messageCount: 0
     };
   }
+  if (options.completionReason) return { captured: false, reason: options.completionReason, 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));

package/dist/{chunk-7RMETV4M.js → chunk-7CZIQG6Z.js}

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

package/dist/{chunk-6XK3RDZ6.js → chunk-BRCQTX2M.js}

@@ -2,7 +2,7 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-XEX5344F.js";
+} from "./chunk-C66FQHNI.js";
 
 // src/lib/user-prompt-submit-compose.ts
 async function composeUserPromptSubmit(cfg, agent, client, prompt, sessionId = null) {

package/dist/{chunk-XEX5344F.js → chunk-C66FQHNI.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
+import {
+  listKnowledgeBases
+} from "./chunk-EX6SM7I3.js";
 import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-7RMETV4M.js";
-import {
-  listKnowledgeBases
-} from "./chunk-JM7EOAQZ.js";
+} from "./chunk-7CZIQG6Z.js";
 import {
   CtxdbError,
   isDataApiReady,
   resolveDataApiCredential
-} from "./chunk-HHKQPWYI.js";
+} from "./chunk-HUX2XS5P.js";
 
 // src/lib/kb-catalog.ts
 function sanitizeKeyEntities(raw) {

package/dist/{chunk-WCVCSOFL.js → chunk-CGA7EITY.js}

@@ -2,10 +2,10 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-XEX5344F.js";
+} from "./chunk-C66FQHNI.js";
 import {
   debug
-} from "./chunk-HHKQPWYI.js";
+} from "./chunk-HUX2XS5P.js";
 
 // src/lib/warmup-recall.ts
 import { execSync } from "node:child_process";

package/dist/{chunk-JM7EOAQZ.js → chunk-EX6SM7I3.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CtxdbError
-} from "./chunk-HHKQPWYI.js";
+} from "./chunk-HUX2XS5P.js";
 
 // src/lib/kb.ts
 import {