@remnic/core 9.3.612 → 9.3.614

package/dist/{chunk-NZPF2SYV.js → chunk-T7N6KQGS.js}

@@ -47,6 +47,60 @@ function parseBoundedIntegerMs(value, fallback, min, max) {
   if (coerced === void 0) return fallback;
   return Math.min(max, Math.max(min, Math.floor(coerced)));
 }
+function isQualifiedModelString(value) {
+  const slash = value.indexOf("/");
+  return slash > 0 && slash < value.length - 1;
+}
+function parseModelChainConfig(value, keyName) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(
+      `${keyName} must be an object like { "primary": "provider/model", "fallbacks": ["provider/model", ...] }; got ${JSON.stringify(value)}`
+    );
+  }
+  const raw = value;
+  const unknownKeys = Object.keys(raw).filter((k) => k !== "primary" && k !== "fallbacks");
+  if (unknownKeys.length > 0) {
+    throw new Error(
+      `${keyName} has unknown propert${unknownKeys.length === 1 ? "y" : "ies"}: ${unknownKeys.join(", ")}. Allowed: "primary", "fallbacks".`
+    );
+  }
+  if (typeof raw.primary !== "string" || raw.primary.trim().length === 0) {
+    throw new Error(
+      `${keyName}.primary is required and must be a non-empty "provider/model" string; got ${JSON.stringify(raw.primary)}`
+    );
+  }
+  const primary = raw.primary.trim();
+  if (!isQualifiedModelString(primary)) {
+    throw new Error(
+      `${keyName}.primary must be in "provider/model" form (e.g. "zai/glm-4.7-flash"); got ${JSON.stringify(primary)}`
+    );
+  }
+  let dedupedFallbacks;
+  if (raw.fallbacks !== void 0) {
+    if (!Array.isArray(raw.fallbacks)) {
+      throw new Error(
+        `${keyName}.fallbacks must be an array of "provider/model" strings; got ${JSON.stringify(raw.fallbacks)}`
+      );
+    }
+    if (raw.fallbacks.some((item) => typeof item !== "string")) {
+      throw new Error(`${keyName}.fallbacks must contain only strings`);
+    }
+    const trimmed = raw.fallbacks.map((item) => item.trim()).filter((item) => item.length > 0 && item !== primary);
+    for (const fb of trimmed) {
+      if (!isQualifiedModelString(fb)) {
+        throw new Error(
+          `${keyName}.fallbacks entries must be in "provider/model" form; got ${JSON.stringify(fb)}`
+        );
+      }
+    }
+    dedupedFallbacks = [...new Set(trimmed)];
+  }
+  return {
+    primary,
+    ...dedupedFallbacks && dedupedFallbacks.length > 0 ? { fallbacks: dedupedFallbacks } : {}
+  };
+}
 function parsePositiveInteger(value, keyName) {
   if (value === void 0 || value === null) return void 0;
   const coerced = coerceNumber(value);
@@ -96,6 +150,44 @@ function parseQmdChunkStrategy(value) {
   if (normalized === "auto" || normalized === "regex") return normalized;
   throw new Error(`qmdChunkStrategy must be "auto" or "regex"; got ${JSON.stringify(value)}`);
 }
+function parseQmdSearchStrategy(value) {
+  if (value === void 0 || value === null) return "hybrid";
+  if (typeof value !== "string") {
+    throw new Error(
+      `qmdSearchStrategy must be one of "hybrid", "lex-vec", or "lex"; got ${JSON.stringify(value)}`
+    );
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "hybrid" || normalized === "lex-vec" || normalized === "lex") {
+    return normalized;
+  }
+  throw new Error(
+    `qmdSearchStrategy must be one of "hybrid", "lex-vec", or "lex"; got ${JSON.stringify(value)}`
+  );
+}
+function parseQmdDaemonTimeoutMs(value) {
+  if (value === void 0 || value === null) return 8e3;
+  const coerced = coerceNumber(value);
+  if (coerced === void 0 || !Number.isInteger(coerced)) {
+    throw new Error(
+      `qmdDaemonTimeoutMs must be an integer number of milliseconds between 1000 and 120000; got ${JSON.stringify(value)}`
+    );
+  }
+  return Math.min(12e4, Math.max(1e3, coerced));
+}
+function parseQmdSubprocessStrategy(value) {
+  if (value === void 0 || value === null) return "query";
+  if (typeof value !== "string") {
+    throw new Error(
+      `qmdSubprocessStrategy must be one of "query" or "search"; got ${JSON.stringify(value)}`
+    );
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "query" || normalized === "search") return normalized;
+  throw new Error(
+    `qmdSubprocessStrategy must be one of "query" or "search"; got ${JSON.stringify(value)}`
+  );
+}
 function parseOptionalNonEmptyString(value) {
   if (typeof value !== "string") return void 0;
   const normalized = value.trim();
@@ -149,6 +241,29 @@ function coerceBooleanLike(value) {
   }
   return void 0;
 }
+function resolveEmitLegacyTools(configValue) {
+  const ACCEPTED = "true/false/1/0/yes/no/on/off";
+  if (configValue !== void 0 && configValue !== null) {
+    const coerced = coerceBooleanLike(configValue);
+    if (coerced === void 0) {
+      throw new Error(
+        `emitLegacyTools must be a boolean-like value (${ACCEPTED}); got ${JSON.stringify(configValue)}`
+      );
+    }
+    return coerced;
+  }
+  const envRaw = readEnvVar("REMNIC_EMIT_LEGACY_TOOLS") ?? readEnvVar("ENGRAM_EMIT_LEGACY_TOOLS");
+  if (envRaw !== void 0) {
+    const coerced = coerceBooleanLike(envRaw);
+    if (coerced === void 0) {
+      throw new Error(
+        `REMNIC_EMIT_LEGACY_TOOLS must be a boolean-like value (${ACCEPTED}); got "${envRaw}"`
+      );
+    }
+    return coerced;
+  }
+  return true;
+}
 function isOpenaiApiKeyDisabled(value) {
   return value === false || typeof value === "string" && value.trim().toLowerCase() === "false";
 }
@@ -755,6 +870,9 @@ function parseConfig(raw) {
     qmdChunkStrategy: parseQmdChunkStrategy(cfg.qmdChunkStrategy),
     qmdCandidateLimit: parsePositiveInteger(cfg.qmdCandidateLimit, "qmdCandidateLimit"),
     qmdQueryRerankEnabled: coerceBooleanLike(cfg.qmdQueryRerankEnabled) ?? true,
+    qmdSearchStrategy: parseQmdSearchStrategy(cfg.qmdSearchStrategy),
+    qmdSubprocessStrategy: parseQmdSubprocessStrategy(cfg.qmdSubprocessStrategy),
+    qmdDaemonTimeoutMs: parseQmdDaemonTimeoutMs(cfg.qmdDaemonTimeoutMs),
     qmdIndexName: parseOptionalNonEmptyString(cfg.qmdIndexName),
     qmdForceCpu: coerceBooleanLike(cfg.qmdForceCpu) ?? false,
     qmdGpuBackend: parseQmdGpuBackend(cfg.qmdGpuBackend),
@@ -1404,6 +1522,7 @@ function parseConfig(raw) {
     modelSource,
     gatewayAgentId: typeof cfg.gatewayAgentId === "string" && cfg.gatewayAgentId.length > 0 ? cfg.gatewayAgentId : "",
     fastGatewayAgentId: typeof cfg.fastGatewayAgentId === "string" && cfg.fastGatewayAgentId.length > 0 ? cfg.fastGatewayAgentId : "",
+    taskModelChain: parseModelChainConfig(cfg.taskModelChain, "taskModelChain"),
     // v3.0 namespaces (default off)
     namespacesEnabled: cfg.namespacesEnabled === true,
     defaultNamespace: typeof cfg.defaultNamespace === "string" && cfg.defaultNamespace.length > 0 ? cfg.defaultNamespace : "default",
@@ -1602,14 +1721,24 @@ function parseConfig(raw) {
     behaviorLoopMaxDeltaPerCycle: typeof cfg.behaviorLoopMaxDeltaPerCycle === "number" ? Math.min(1, Math.max(0, cfg.behaviorLoopMaxDeltaPerCycle)) : 0.1,
     behaviorLoopProtectedParams: Array.isArray(cfg.behaviorLoopProtectedParams) ? cfg.behaviorLoopProtectedParams.filter((param) => typeof param === "string" && param.trim().length > 0) : [...DEFAULT_BEHAVIOR_LOOP_PROTECTED_PARAMS],
     // v8.0 phase 1
-    recallPlannerEnabled: cfg.recallPlannerEnabled !== false,
+    // All recallPlanner boolean gates coerce boolean-like strings so CLI/env
+    // surfaces (`--config recallPlanner*=true|false`) behave correctly — the
+    // shadow-mode/telemetry/enable flags are documented rollout switches and
+    // must not silently ignore string values (gotcha #36, #1428 review).
+    recallPlannerEnabled: coerceBooleanLike(cfg.recallPlannerEnabled) ?? true,
+    // Issue #1367 / Option C: LLM-based recall planning is opt-in so the
+    // default recall path stays heuristic (no added latency / LLM call unless
+    // the operator asks for it — gotcha #30). Coerce boolean-like strings so
+    // CLI/env surfaces (`--config recallPlannerLlmEnabled=true`) actually
+    // enable it (gotcha #36); defaults off.
+    recallPlannerLlmEnabled: coerceBooleanLike(cfg.recallPlannerLlmEnabled) ?? false,
     recallPlannerModel: typeof cfg.recallPlannerModel === "string" && cfg.recallPlannerModel.trim().length > 0 ? cfg.recallPlannerModel.trim() : DEFAULT_REASONING_MODEL,
     recallPlannerTimeoutMs: typeof cfg.recallPlannerTimeoutMs === "number" ? cfg.recallPlannerTimeoutMs : 1500,
-    recallPlannerUseResponsesApi: cfg.recallPlannerUseResponsesApi !== false,
+    recallPlannerUseResponsesApi: coerceBooleanLike(cfg.recallPlannerUseResponsesApi) ?? true,
     recallPlannerMaxPromptChars: typeof cfg.recallPlannerMaxPromptChars === "number" ? cfg.recallPlannerMaxPromptChars : 4e3,
     recallPlannerMaxMemoryHints: typeof cfg.recallPlannerMaxMemoryHints === "number" ? cfg.recallPlannerMaxMemoryHints : 24,
-    recallPlannerShadowMode: cfg.recallPlannerShadowMode === true,
-    recallPlannerTelemetryEnabled: cfg.recallPlannerTelemetryEnabled !== false,
+    recallPlannerShadowMode: coerceBooleanLike(cfg.recallPlannerShadowMode) ?? false,
+    recallPlannerTelemetryEnabled: coerceBooleanLike(cfg.recallPlannerTelemetryEnabled) ?? true,
     recallPlannerMaxQmdResultsMinimal: typeof cfg.recallPlannerMaxQmdResultsMinimal === "number" ? cfg.recallPlannerMaxQmdResultsMinimal : 4,
     recallPlannerMaxQmdResultsFull: typeof cfg.recallPlannerMaxQmdResultsFull === "number" ? cfg.recallPlannerMaxQmdResultsFull : 8,
     intentRoutingEnabled: cfg.intentRoutingEnabled === true,
@@ -2021,6 +2150,10 @@ function parseConfig(raw) {
       return "none";
     })(),
     binaryLifecycleBackendPath: typeof cfg.binaryLifecycleBackendPath === "string" ? cfg.binaryLifecycleBackendPath.trim() : "",
+    // Legacy MCP tool aliases opt-out (issue #1427). Config field wins; then
+    // the REMNIC_/ENGRAM_ env var (gotcha #9); default true for back-compat.
+    // Malformed values fail fast rather than silently defaulting (gotcha #51).
+    emitLegacyTools: resolveEmitLegacyTools(cfg.emitLegacyTools),
     // Codex citation parity (issue #379)
     citationsEnabled: cfg.citationsEnabled === true,
     citationsAutoDetect: cfg.citationsAutoDetect !== false,
@@ -2303,4 +2436,4 @@ export {
   VALID_MEMORY_CATEGORIES,
   parseConfig
 };
-//# sourceMappingURL=chunk-NZPF2SYV.js.map
+//# sourceMappingURL=chunk-T7N6KQGS.js.map