TencentCloud/TencentDB-Agent-Memory · error · InvalidInstanceIdError

instance_id is empty or invalid after sanitization

Error message

instance_id is empty or invalid after sanitization

What it means

Error "instance_id is empty or invalid after sanitization" thrown in TencentCloud/TencentDB-Agent-Memory.

Source

Thrown at MemoryCore/src/metadata/store/db-name.ts:39

}

function normalizeDbPrefix(dbPrefix?: string): string {
  const trimmed = dbPrefix?.trim();
  return trimmed || DEFAULT_METADATA_DB_PREFIX;
}

/**
 * 解析逻辑库名，如 `tdai_metadata_default`。
 * @throws InvalidInstanceIdError 空或规范化后为空
 */
export function resolveMetadataDbName(
  instanceId: string,
  dbPrefix: string = DEFAULT_METADATA_DB_PREFIX,
): string {
  const prefix = normalizeDbPrefix(dbPrefix);
  const sanitized = sanitizeInstanceIdForDb(instanceId);
  if (!sanitized) {
    throw new InvalidInstanceIdError("instance_id is empty or invalid after sanitization");
  }
  const maxInstanceLen = 64 - prefix.length - 1;
  const truncated = sanitized.slice(0, maxInstanceLen);
  return `${prefix}_${truncated}`;
}

/** SQLite：{baseDir}/{dbName}/metadata.db */
export function resolveSqliteDbPath(
  baseDir: string,
  instanceId: string,
  dbPrefix?: string,
): string {
  const dbName = resolveMetadataDbName(instanceId, dbPrefix);
  return `${baseDir.replace(/\/$/, "")}/${dbName}/metadata.db`;
}

/** SQLite 实例库目录（destroy 时递归删除） */
export function resolveSqliteDbDir(

View on GitHub (pinned to 3efcd317b8)

When it happens

Trigger: Thrown at MemoryCore/src/metadata/store/db-name.ts:39 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of TencentCloud/TencentDB-Agent-Memory@3efcd317b8 (2026-09-01). Data as JSON: /api/errors/3f4bcc1bb617f18d. Report an issue: GitHub.