@remnic/plugin-pi 9.36.0 → 9.38.0

package/README.md

@@ -87,6 +87,8 @@ Supported config keys:
 | `statusEnabled` | `true` | Set Pi UI status from daemon health |
 | `requestTimeoutMs` | `60000` | HTTP/MCP request timeout for recall/observe/compaction/commands |
 | `startupRequestTimeoutMs` | `1000` | Shorter timeout for startup-sensitive probes (MCP `tools/list` registration and the `session_start` health/status check) so a slow or offline daemon can't stall Pi boot |
+| `recallTimeoutThreshold` | `7` | Permanently disable recall after this many explicit recall timeouts within the rolling window; must be a positive integer no greater than `recallTimeoutWindow` |
+| `recallTimeoutWindow` | `10` | Number of most recent recall calls included in the rolling timeout window; must be a positive integer at least `recallTimeoutThreshold`. Invalid settings fail config loading. |
 
 Boolean-like strings such as `"false"`, `"0"`, `"no"`, and `"off"` are treated as false.
 
@@ -107,7 +109,9 @@ Example:
   "mcpToolsEnabled": true,
   "statusEnabled": true,
   "requestTimeoutMs": 60000,
-  "startupRequestTimeoutMs": 1000
+  "startupRequestTimeoutMs": 1000,
+  "recallTimeoutThreshold": 7,
+  "recallTimeoutWindow": 10
 }
 ```
 

package/dist/chunk-HRZBFDYV.js

@@ -0,0 +1,262 @@
+// src/paths.ts
+import os from "os";
+import path from "path";
+import { expandTildePath } from "@remnic/core/utils/path";
+var REMNIC_PI_EXTENSION_DIR_NAME = "remnic";
+function resolvePiAgentHome(env) {
+  const explicitCodingAgentDir = env.PI_CODING_AGENT_DIR?.trim();
+  if (explicitCodingAgentDir) return path.resolve(expandTildePath(explicitCodingAgentDir));
+  const explicitAgentHome = env.PI_AGENT_HOME?.trim();
+  if (explicitAgentHome) return path.resolve(expandTildePath(explicitAgentHome));
+  const explicitPiHome = env.PI_HOME?.trim();
+  if (explicitPiHome) return path.join(path.resolve(expandTildePath(explicitPiHome)), "agent");
+  return path.join(env.HOME ?? env.USERPROFILE ?? os.homedir(), ".pi", "agent");
+}
+function resolvePiExtensionRoot(env) {
+  return path.join(resolvePiAgentHome(env), "extensions", REMNIC_PI_EXTENSION_DIR_NAME);
+}
+function resolveOmpProfile(env) {
+  const raw = env.OMP_PROFILE !== void 0 ? env.OMP_PROFILE : env.PI_PROFILE;
+  const trimmed = raw?.trim();
+  if (!trimmed || trimmed === "default") return void 0;
+  return trimmed;
+}
+function resolveOmpConfigRoot(env) {
+  const home = env.HOME ?? env.USERPROFILE ?? os.homedir();
+  const configDirName = env.PI_CONFIG_DIR?.trim() || ".omp";
+  return path.join(home, configDirName);
+}
+function resolveOmpAgentHome(env) {
+  const configRoot = resolveOmpConfigRoot(env);
+  const profile = resolveOmpProfile(env);
+  if (profile) {
+    return path.join(configRoot, "profiles", profile, "agent");
+  }
+  const explicitCodingAgentDir = env.PI_CODING_AGENT_DIR?.trim();
+  if (explicitCodingAgentDir) return path.resolve(expandTildePath(explicitCodingAgentDir));
+  return path.join(configRoot, "agent");
+}
+function resolveOmpExtensionRoot(env) {
+  return path.join(resolveOmpAgentHome(env), "extensions", REMNIC_PI_EXTENSION_DIR_NAME);
+}
+
+// src/config.ts
+import { existsSync, readFileSync } from "fs";
+import path2 from "path";
+import { expandTildePath as expandTildePath2 } from "@remnic/core/utils/path";
+var DEFAULT_CONFIG = {
+  remnicDaemonUrl: "http://127.0.0.1:4318",
+  recallMode: "auto",
+  recallTopK: 8,
+  recallBudgetChars: 12e3,
+  recallEnabled: true,
+  observeEnabled: true,
+  observeSkipExtraction: false,
+  compactionEnabled: true,
+  mcpToolsEnabled: true,
+  statusEnabled: true,
+  requestTimeoutMs: 6e4,
+  startupRequestTimeoutMs: 1e3,
+  // Default 20 s is comfortably under the Pi/omp 30 s handler budget (#1626).
+  turnRequestTimeoutMs: 2e4,
+  // Default 100 KiB leaves headroom under the daemon's 128 KiB default (#1600).
+  observeMaxBytes: 102400,
+  observeMaxRetries: 2,
+  // Base cooldown for the circuit breaker; doubles on consecutive failures (#1626).
+  daemonCooldownMs: 5e3,
+  // Recall-timeout circuit breaker: 7 timeouts in the last 10 recall calls trip permanently.
+  recallTimeoutThreshold: 7,
+  recallTimeoutWindow: 10
+};
+function defaultConfigPath(env) {
+  return path2.join(resolvePiAgentHome(env), "extensions", REMNIC_PI_EXTENSION_DIR_NAME, "remnic.config.json");
+}
+function coerceBoolean(value, fallback, fieldName) {
+  if (value === void 0 || value === null) return fallback;
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (["true", "1", "yes", "on"].includes(normalized)) return true;
+    if (["false", "0", "no", "off"].includes(normalized)) return false;
+  }
+  throw new Error(`Invalid boolean value for Remnic Pi config field ${fieldName}`);
+}
+function coercePositiveInt(value, fallback, max, fieldName) {
+  if (value === void 0 || value === null || value === "") return fallback;
+  let parsed;
+  if (typeof value === "number") {
+    parsed = value;
+  } else if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) return fallback;
+    if (!/^[+-]?\d+$/.test(trimmed)) {
+      throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 1 to ${max}`);
+    }
+    parsed = Number(trimmed);
+  } else {
+    throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 1 to ${max}`);
+  }
+  if (!Number.isInteger(parsed) || parsed <= 0 || parsed > max) {
+    throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 1 to ${max}`);
+  }
+  return parsed;
+}
+function coerceNonNegativeInt(value, fallback, max, fieldName) {
+  if (value === void 0 || value === null || value === "") return fallback;
+  let parsed;
+  if (typeof value === "number") {
+    parsed = value;
+  } else if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) return fallback;
+    if (!/^[+-]?\d+$/.test(trimmed)) {
+      throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 0 to ${max}`);
+    }
+    parsed = Number(trimmed);
+  } else {
+    throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 0 to ${max}`);
+  }
+  if (!Number.isInteger(parsed) || parsed < 0 || parsed > max) {
+    throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 0 to ${max}`);
+  }
+  return parsed;
+}
+function coerceOptionalNonEmptyString(value, fieldName) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "string" && value.trim().length > 0) return value.trim();
+  throw new Error(`Invalid string value for Remnic Pi config field ${fieldName}`);
+}
+function coerceOptionalString(value, fieldName) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : void 0;
+  }
+  throw new Error(`Invalid string value for Remnic Pi config field ${fieldName}`);
+}
+function coerceOptionalHttpUrl(value, fieldName) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value !== "string") {
+    throw new Error(`Invalid URL value for Remnic Pi config field ${fieldName}: expected an http or https URL`);
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return void 0;
+  try {
+    const parsed = new URL(trimmed);
+    if (parsed.protocol === "http:" || parsed.protocol === "https:") return trimTrailingSlashes(trimmed);
+  } catch {
+  }
+  throw new Error(`Invalid URL value for Remnic Pi config field ${fieldName}: expected an http or https URL`);
+}
+function coerceRecallMode(value) {
+  if (value === void 0 || value === null || value === "") return DEFAULT_CONFIG.recallMode;
+  if (value === "minimal" || value === "full" || value === "graph_mode" || value === "no_recall" || value === "auto") {
+    return value;
+  }
+  throw new Error(`Invalid recallMode value for Remnic Pi config: ${JSON.stringify(value)}`);
+}
+function readConfigFile(configPath) {
+  if (!existsSync(configPath)) return {};
+  try {
+    const raw = readFileSync(configPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+    throw new Error("expected a JSON object");
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    throw new Error(`Failed to load Remnic Pi config at ${configPath}: ${reason}`);
+  }
+}
+function trimTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end -= 1;
+  return value.slice(0, end);
+}
+function resolveConfigPath(options = {}) {
+  const env = options.env ?? process.env;
+  return expandTildePath2(
+    options.configPath || env.REMNIC_PI_CONFIG || env.REMNIC_OMP_CONFIG || defaultConfigPath(env)
+  );
+}
+function loadConfig(options = {}) {
+  const env = options.env ?? process.env;
+  const fileConfig = readConfigFile(resolveConfigPath(options));
+  const daemonUrl = coerceOptionalHttpUrl(fileConfig.remnicDaemonUrl, "remnicDaemonUrl") ?? coerceOptionalHttpUrl(env.REMNIC_DAEMON_URL, "REMNIC_DAEMON_URL") ?? DEFAULT_CONFIG.remnicDaemonUrl;
+  const authToken = coerceOptionalString(fileConfig.authToken, "authToken") ?? coerceOptionalString(env.REMNIC_PI_AUTH_TOKEN, "REMNIC_PI_AUTH_TOKEN");
+  const namespace = coerceOptionalNonEmptyString(fileConfig.namespace, "namespace");
+  const requestTimeoutMs = coercePositiveInt(
+    fileConfig.requestTimeoutMs,
+    DEFAULT_CONFIG.requestTimeoutMs,
+    6e4,
+    "requestTimeoutMs"
+  );
+  const turnFallback = Math.min(requestTimeoutMs, DEFAULT_CONFIG.turnRequestTimeoutMs);
+  const turnRequestTimeoutMs = coercePositiveInt(
+    fileConfig.turnRequestTimeoutMs,
+    turnFallback,
+    25e3,
+    "turnRequestTimeoutMs"
+  );
+  const recallTimeoutThreshold = coercePositiveInt(
+    fileConfig.recallTimeoutThreshold,
+    DEFAULT_CONFIG.recallTimeoutThreshold,
+    1e3,
+    "recallTimeoutThreshold"
+  );
+  const recallTimeoutWindow = coercePositiveInt(
+    fileConfig.recallTimeoutWindow,
+    DEFAULT_CONFIG.recallTimeoutWindow,
+    1e3,
+    "recallTimeoutWindow"
+  );
+  if (recallTimeoutThreshold > recallTimeoutWindow) {
+    throw new Error(
+      `Invalid recall timeout circuit breaker config: threshold (${recallTimeoutThreshold}) cannot exceed window (${recallTimeoutWindow})`
+    );
+  }
+  return {
+    remnicDaemonUrl: daemonUrl,
+    authToken,
+    namespace,
+    recallMode: coerceRecallMode(fileConfig.recallMode),
+    recallTopK: coercePositiveInt(fileConfig.recallTopK, DEFAULT_CONFIG.recallTopK, 50, "recallTopK"),
+    recallBudgetChars: coercePositiveInt(fileConfig.recallBudgetChars, DEFAULT_CONFIG.recallBudgetChars, 64e3, "recallBudgetChars"),
+    recallEnabled: coerceBoolean(fileConfig.recallEnabled, DEFAULT_CONFIG.recallEnabled, "recallEnabled"),
+    observeEnabled: coerceBoolean(fileConfig.observeEnabled, DEFAULT_CONFIG.observeEnabled, "observeEnabled"),
+    observeSkipExtraction: coerceBoolean(fileConfig.observeSkipExtraction, DEFAULT_CONFIG.observeSkipExtraction, "observeSkipExtraction"),
+    compactionEnabled: coerceBoolean(fileConfig.compactionEnabled, DEFAULT_CONFIG.compactionEnabled, "compactionEnabled"),
+    mcpToolsEnabled: coerceBoolean(fileConfig.mcpToolsEnabled, DEFAULT_CONFIG.mcpToolsEnabled, "mcpToolsEnabled"),
+    statusEnabled: coerceBoolean(fileConfig.statusEnabled, DEFAULT_CONFIG.statusEnabled, "statusEnabled"),
+    requestTimeoutMs,
+    startupRequestTimeoutMs: coercePositiveInt(
+      fileConfig.startupRequestTimeoutMs,
+      DEFAULT_CONFIG.startupRequestTimeoutMs,
+      6e4,
+      "startupRequestTimeoutMs"
+    ),
+    turnRequestTimeoutMs,
+    observeMaxBytes: coercePositiveInt(
+      fileConfig.observeMaxBytes,
+      DEFAULT_CONFIG.observeMaxBytes,
+      8388608,
+      "observeMaxBytes"
+    ),
+    observeMaxRetries: coerceNonNegativeInt(fileConfig.observeMaxRetries, DEFAULT_CONFIG.observeMaxRetries, 5, "observeMaxRetries"),
+    daemonCooldownMs: coercePositiveInt(fileConfig.daemonCooldownMs, DEFAULT_CONFIG.daemonCooldownMs, 6e4, "daemonCooldownMs"),
+    recallTimeoutThreshold,
+    recallTimeoutWindow
+  };
+}
+
+export {
+  resolvePiAgentHome,
+  resolvePiExtensionRoot,
+  resolveOmpConfigRoot,
+  resolveOmpAgentHome,
+  resolveOmpExtensionRoot,
+  DEFAULT_CONFIG,
+  loadConfig
+};
+//# sourceMappingURL=chunk-HRZBFDYV.js.map

package/dist/chunk-HRZBFDYV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/paths.ts","../src/config.ts"],"sourcesContent":["import os from \"node:os\";\nimport path from \"node:path\";\n\n// Leaf submodule (not the `@remnic/core` barrel) so the omp pre-bundle's\n// `bun build` does not pull the rest of core into the extension bundle.\nimport { expandTildePath } from \"@remnic/core/utils/path\";\n\nexport const REMNIC_PI_EXTENSION_DIR_NAME = \"remnic\";\n\nexport function resolvePiAgentHome(env: NodeJS.ProcessEnv): string {\n  const explicitCodingAgentDir = env.PI_CODING_AGENT_DIR?.trim();\n  if (explicitCodingAgentDir) return path.resolve(expandTildePath(explicitCodingAgentDir));\n\n  const explicitAgentHome = env.PI_AGENT_HOME?.trim();\n  if (explicitAgentHome) return path.resolve(expandTildePath(explicitAgentHome));\n\n  const explicitPiHome = env.PI_HOME?.trim();\n  if (explicitPiHome) return path.join(path.resolve(expandTildePath(explicitPiHome)), \"agent\");\n\n  return path.join(env.HOME ?? env.USERPROFILE ?? os.homedir(), \".pi\", \"agent\");\n}\n\nexport function resolvePiExtensionRoot(env: NodeJS.ProcessEnv): string {\n  return path.join(resolvePiAgentHome(env), \"extensions\", REMNIC_PI_EXTENSION_DIR_NAME);\n}\n\n/**\n * Resolve the active omp profile from the environment, mirroring omp's\n * `resolveProfileEnv`: `OMP_PROFILE` is authoritative, and `PI_PROFILE` is a\n * compatibility fallback consulted **only** when `OMP_PROFILE` is undefined\n * (an explicitly-empty `OMP_PROFILE` therefore selects the default profile).\n * The reserved name \"default\" and blank values resolve to the base (no profile).\n */\nfunction resolveOmpProfile(env: NodeJS.ProcessEnv): string | undefined {\n  const raw = env.OMP_PROFILE !== undefined ? env.OMP_PROFILE : env.PI_PROFILE;\n  const trimmed = raw?.trim();\n  if (!trimmed || trimmed === \"default\") return undefined;\n  return trimmed;\n}\n\n/**\n * Resolve the omp (oh-my-pi) agent home directory that omp auto-discovers\n * extensions from. Mirrors omp's `DirResolver` (packages/utils/src/dirs.ts):\n *\n *   - The config dir name is `PI_CONFIG_DIR` (default `.omp`).\n *   - When a profile (`OMP_PROFILE`, falling back to `PI_PROFILE`) is active it\n *     wins and resolves to `<configRoot>/profiles/<name>/agent`; omp discards\n *     the `PI_CODING_AGENT_DIR` override while a profile is active.\n *   - Otherwise `PI_CODING_AGENT_DIR` overrides the whole agent dir.\n *   - Otherwise the base agent dir is `<configRoot>/agent`.\n *\n * Note: omp's XDG redirection (`XDG_DATA_HOME`, etc.) applies to the `data`,\n * `state`, and `cache` categories (sessions/state/cache) — NOT to the base\n * agent dir that extensions are discovered from — so it is intentionally not\n * consulted here.\n */\n/**\n * The omp config root (`~/<PI_CONFIG_DIR or .omp>`), which contains the base\n * `agent/` dir and any `profiles/<name>/agent/` dirs.\n */\nexport function resolveOmpConfigRoot(env: NodeJS.ProcessEnv): string {\n  const home = env.HOME ?? env.USERPROFILE ?? os.homedir();\n  const configDirName = env.PI_CONFIG_DIR?.trim() || \".omp\";\n  return path.join(home, configDirName);\n}\n\nexport function resolveOmpAgentHome(env: NodeJS.ProcessEnv): string {\n  const configRoot = resolveOmpConfigRoot(env);\n\n  const profile = resolveOmpProfile(env);\n  if (profile) {\n    return path.join(configRoot, \"profiles\", profile, \"agent\");\n  }\n\n  const explicitCodingAgentDir = env.PI_CODING_AGENT_DIR?.trim();\n  if (explicitCodingAgentDir) return path.resolve(expandTildePath(explicitCodingAgentDir));\n\n  return path.join(configRoot, \"agent\");\n}\n\nexport function resolveOmpExtensionRoot(env: NodeJS.ProcessEnv): string {\n  return path.join(resolveOmpAgentHome(env), \"extensions\", REMNIC_PI_EXTENSION_DIR_NAME);\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\n// Leaf submodule (not the `@remnic/core` barrel) so the omp pre-bundle's\n// `bun build` does not pull the rest of core — including the LanceDB native\n// asset — into the extension bundle. See PR #1641.\nimport { expandTildePath } from \"@remnic/core/utils/path\";\n\nimport { REMNIC_PI_EXTENSION_DIR_NAME, resolvePiAgentHome } from \"./paths.js\";\n\nexport interface RemnicPiConfig {\n  remnicDaemonUrl: string;\n  authToken?: string;\n  namespace?: string;\n  recallMode: \"auto\" | \"minimal\" | \"full\" | \"graph_mode\" | \"no_recall\";\n  recallTopK: number;\n  recallBudgetChars: number;\n  recallEnabled: boolean;\n  observeEnabled: boolean;\n  observeSkipExtraction: boolean;\n  compactionEnabled: boolean;\n  mcpToolsEnabled: boolean;\n  statusEnabled: boolean;\n  requestTimeoutMs: number;\n  startupRequestTimeoutMs: number;\n  /**\n   * Per-turn request budget for observe/recall. MUST stay below the host's\n   * in-handler kill budget (Pi/omp kills handlers at 30 s). Defaults to 20 s,\n   * capped at 25 s so a misconfiguration can never produce a structurally\n   * unsatisfiable timeout (issue #1626).\n   */\n  turnRequestTimeoutMs: number;\n  /**\n   * Soft cap on a single observe POST body in bytes. The client chunks observe\n   * batches to stay under this; individual oversized messages are truncated\n   * with a marker. Defaults to 100 KiB, safely under the daemon's default\n   * 128 KiB `maxBodyBytes` (issue #1600).\n   */\n  observeMaxBytes: number;\n  /**\n   * Maximum retry attempts for observe/recall on transient connection-level\n   * failures (socket close, ECONNRESET, EPIPE). Observe is dedupe-safe so\n   * retrying is harmless (issue #1602).\n   */\n  observeMaxRetries: number;\n  /**\n   * Cooldown base for the daemon-reachability circuit breaker. When observe/\n   * recall fails on a timeout or connection error, subsequent turns skip fast\n   * for an exponentially growing window starting at this value (issue #1626).\n   */\n  daemonCooldownMs: number;\n  /**\n   * Number of explicit recall timeout errors in the last {@link recallTimeoutWindow}\n   * recall calls that permanently disables automatic recall for the process lifetime.\n   */\n  recallTimeoutThreshold: number;\n  /**\n   * Size of the rolling window of recent recall calls used by the recall-timeout\n   * circuit breaker.\n   */\n  recallTimeoutWindow: number;\n}\n\nexport interface LoadConfigOptions {\n  configPath?: string;\n  env?: NodeJS.ProcessEnv;\n}\n\nexport const DEFAULT_CONFIG: RemnicPiConfig = {\n  remnicDaemonUrl: \"http://127.0.0.1:4318\",\n  recallMode: \"auto\",\n  recallTopK: 8,\n  recallBudgetChars: 12000,\n  recallEnabled: true,\n  observeEnabled: true,\n  observeSkipExtraction: false,\n  compactionEnabled: true,\n  mcpToolsEnabled: true,\n  statusEnabled: true,\n  requestTimeoutMs: 60000,\n  startupRequestTimeoutMs: 1000,\n  // Default 20 s is comfortably under the Pi/omp 30 s handler budget (#1626).\n  turnRequestTimeoutMs: 20000,\n  // Default 100 KiB leaves headroom under the daemon's 128 KiB default (#1600).\n  observeMaxBytes: 102400,\n  observeMaxRetries: 2,\n  // Base cooldown for the circuit breaker; doubles on consecutive failures (#1626).\n  daemonCooldownMs: 5000,\n  // Recall-timeout circuit breaker: 7 timeouts in the last 10 recall calls trip permanently.\n  recallTimeoutThreshold: 7,\n  recallTimeoutWindow: 10,\n};\n\nfunction defaultConfigPath(env: NodeJS.ProcessEnv): string {\n  return path.join(resolvePiAgentHome(env), \"extensions\", REMNIC_PI_EXTENSION_DIR_NAME, \"remnic.config.json\");\n}\n\nfunction coerceBoolean(value: unknown, fallback: boolean, fieldName: string): boolean {\n  if (value === undefined || value === null) return fallback;\n  if (typeof value === \"boolean\") return value;\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if ([\"true\", \"1\", \"yes\", \"on\"].includes(normalized)) return true;\n    if ([\"false\", \"0\", \"no\", \"off\"].includes(normalized)) return false;\n  }\n  throw new Error(`Invalid boolean value for Remnic Pi config field ${fieldName}`);\n}\n\nfunction coercePositiveInt(value: unknown, fallback: number, max: number, fieldName: string): number {\n  if (value === undefined || value === null || value === \"\") return fallback;\n  let parsed: number;\n  if (typeof value === \"number\") {\n    parsed = value;\n  } else if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) return fallback;\n    if (!/^[+-]?\\d+$/.test(trimmed)) {\n      throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 1 to ${max}`);\n    }\n    parsed = Number(trimmed);\n  } else {\n    throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 1 to ${max}`);\n  }\n  if (!Number.isInteger(parsed) || parsed <= 0 || parsed > max) {\n    throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 1 to ${max}`);\n  }\n  return parsed;\n}\n\n/**\n * Like {@link coercePositiveInt} but allows 0, for knobs where 0 is a\n * meaningful \"disabled\" value (e.g. observeMaxRetries). Still rejects\n * negatives, non-integers, and values above the cap.\n */\nfunction coerceNonNegativeInt(value: unknown, fallback: number, max: number, fieldName: string): number {\n  if (value === undefined || value === null || value === \"\") return fallback;\n  let parsed: number;\n  if (typeof value === \"number\") {\n    parsed = value;\n  } else if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) return fallback;\n    if (!/^[+-]?\\d+$/.test(trimmed)) {\n      throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 0 to ${max}`);\n    }\n    parsed = Number(trimmed);\n  } else {\n    throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 0 to ${max}`);\n  }\n  if (!Number.isInteger(parsed) || parsed < 0 || parsed > max) {\n    throw new Error(`Invalid numeric value for Remnic Pi config field ${fieldName}: expected an integer from 0 to ${max}`);\n  }\n  return parsed;\n}\n\nfunction coerceOptionalNonEmptyString(value: unknown, fieldName: string): string | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (typeof value === \"string\" && value.trim().length > 0) return value.trim();\n  throw new Error(`Invalid string value for Remnic Pi config field ${fieldName}`);\n}\n\nfunction coerceOptionalString(value: unknown, fieldName: string): string | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n  throw new Error(`Invalid string value for Remnic Pi config field ${fieldName}`);\n}\n\nfunction coerceOptionalHttpUrl(value: unknown, fieldName: string): string | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (typeof value !== \"string\") {\n    throw new Error(`Invalid URL value for Remnic Pi config field ${fieldName}: expected an http or https URL`);\n  }\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return undefined;\n  try {\n    const parsed = new URL(trimmed);\n    if (parsed.protocol === \"http:\" || parsed.protocol === \"https:\") return trimTrailingSlashes(trimmed);\n  } catch {\n    // Fall through to the shared error below.\n  }\n  throw new Error(`Invalid URL value for Remnic Pi config field ${fieldName}: expected an http or https URL`);\n}\n\nfunction coerceRecallMode(value: unknown): RemnicPiConfig[\"recallMode\"] {\n  if (value === undefined || value === null || value === \"\") return DEFAULT_CONFIG.recallMode;\n  if (\n    value === \"minimal\" ||\n    value === \"full\" ||\n    value === \"graph_mode\" ||\n    value === \"no_recall\" ||\n    value === \"auto\"\n  ) {\n    return value;\n  }\n  throw new Error(`Invalid recallMode value for Remnic Pi config: ${JSON.stringify(value)}`);\n}\n\nfunction readConfigFile(configPath: string): Record<string, unknown> {\n  if (!existsSync(configPath)) return {};\n  try {\n    const raw = readFileSync(configPath, \"utf-8\");\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed as Record<string, unknown>;\n    }\n    throw new Error(\"expected a JSON object\");\n  } catch (err) {\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to load Remnic Pi config at ${configPath}: ${reason}`);\n  }\n}\n\nfunction trimTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) end -= 1;\n  return value.slice(0, end);\n}\n\nexport function resolveConfigPath(options: LoadConfigOptions = {}): string {\n  const env = options.env ?? process.env;\n  // REMNIC_PI_CONFIG keeps precedence for upstream Pi; REMNIC_OMP_CONFIG lets an\n  // omp (oh-my-pi) direct load (`omp -e npm:@remnic/plugin-pi`) point the shared\n  // runtime module at its own config without an explicit configPath. Connector\n  // installs always pass an explicit configPath, so this only affects direct loads.\n  return expandTildePath(\n    options.configPath || env.REMNIC_PI_CONFIG || env.REMNIC_OMP_CONFIG || defaultConfigPath(env),\n  );\n}\n\nexport function loadConfig(options: LoadConfigOptions = {}): RemnicPiConfig {\n  const env = options.env ?? process.env;\n  const fileConfig = readConfigFile(resolveConfigPath(options));\n  const daemonUrl =\n    coerceOptionalHttpUrl(fileConfig.remnicDaemonUrl, \"remnicDaemonUrl\") ??\n    coerceOptionalHttpUrl(env.REMNIC_DAEMON_URL, \"REMNIC_DAEMON_URL\") ??\n    DEFAULT_CONFIG.remnicDaemonUrl;\n  const authToken =\n    coerceOptionalString(fileConfig.authToken, \"authToken\") ??\n    coerceOptionalString(env.REMNIC_PI_AUTH_TOKEN, \"REMNIC_PI_AUTH_TOKEN\");\n  const namespace = coerceOptionalNonEmptyString(fileConfig.namespace, \"namespace\");\n\n  const requestTimeoutMs = coercePositiveInt(\n    fileConfig.requestTimeoutMs,\n    DEFAULT_CONFIG.requestTimeoutMs,\n    60_000,\n    \"requestTimeoutMs\",\n  );\n  // When turnRequestTimeoutMs is not explicitly set, derive it from the\n  // configured requestTimeoutMs (capped at the default turn budget) so an\n  // existing install that lowered requestTimeoutMs below 20s keeps its tighter\n  // per-turn budget instead of being silently raised back to 20s (codex review).\n  const turnFallback = Math.min(requestTimeoutMs, DEFAULT_CONFIG.turnRequestTimeoutMs);\n  const turnRequestTimeoutMs = coercePositiveInt(\n    fileConfig.turnRequestTimeoutMs,\n    turnFallback,\n    25_000,\n    \"turnRequestTimeoutMs\",\n  );\n  const recallTimeoutThreshold = coercePositiveInt(\n    fileConfig.recallTimeoutThreshold,\n    DEFAULT_CONFIG.recallTimeoutThreshold,\n    1000,\n    \"recallTimeoutThreshold\",\n  );\n  const recallTimeoutWindow = coercePositiveInt(\n    fileConfig.recallTimeoutWindow,\n    DEFAULT_CONFIG.recallTimeoutWindow,\n    1000,\n    \"recallTimeoutWindow\",\n  );\n  if (recallTimeoutThreshold > recallTimeoutWindow) {\n    throw new Error(\n      `Invalid recall timeout circuit breaker config: threshold (${recallTimeoutThreshold}) cannot exceed window (${recallTimeoutWindow})`,\n    );\n  }\n\n  return {\n    remnicDaemonUrl: daemonUrl,\n    authToken,\n    namespace,\n    recallMode: coerceRecallMode(fileConfig.recallMode),\n    recallTopK: coercePositiveInt(fileConfig.recallTopK, DEFAULT_CONFIG.recallTopK, 50, \"recallTopK\"),\n    recallBudgetChars: coercePositiveInt(fileConfig.recallBudgetChars, DEFAULT_CONFIG.recallBudgetChars, 64000, \"recallBudgetChars\"),\n    recallEnabled: coerceBoolean(fileConfig.recallEnabled, DEFAULT_CONFIG.recallEnabled, \"recallEnabled\"),\n    observeEnabled: coerceBoolean(fileConfig.observeEnabled, DEFAULT_CONFIG.observeEnabled, \"observeEnabled\"),\n    observeSkipExtraction: coerceBoolean(fileConfig.observeSkipExtraction, DEFAULT_CONFIG.observeSkipExtraction, \"observeSkipExtraction\"),\n    compactionEnabled: coerceBoolean(fileConfig.compactionEnabled, DEFAULT_CONFIG.compactionEnabled, \"compactionEnabled\"),\n    mcpToolsEnabled: coerceBoolean(fileConfig.mcpToolsEnabled, DEFAULT_CONFIG.mcpToolsEnabled, \"mcpToolsEnabled\"),\n    statusEnabled: coerceBoolean(fileConfig.statusEnabled, DEFAULT_CONFIG.statusEnabled, \"statusEnabled\"),\n    requestTimeoutMs,\n    startupRequestTimeoutMs: coercePositiveInt(\n      fileConfig.startupRequestTimeoutMs,\n      DEFAULT_CONFIG.startupRequestTimeoutMs,\n      60_000,\n      \"startupRequestTimeoutMs\",\n    ),\n    turnRequestTimeoutMs,\n    observeMaxBytes: coercePositiveInt(\n      fileConfig.observeMaxBytes,\n      DEFAULT_CONFIG.observeMaxBytes,\n      8_388_608,\n      \"observeMaxBytes\",\n    ),\n    observeMaxRetries: coerceNonNegativeInt(fileConfig.observeMaxRetries, DEFAULT_CONFIG.observeMaxRetries, 5, \"observeMaxRetries\"),\n    daemonCooldownMs: coercePositiveInt(fileConfig.daemonCooldownMs, DEFAULT_CONFIG.daemonCooldownMs, 60_000, \"daemonCooldownMs\"),\n    recallTimeoutThreshold,\n    recallTimeoutWindow,\n  };\n}\n"],"mappings":"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","names":["path","expandTildePath","path","expandTildePath"]}

package/dist/index.d.ts

@@ -41,6 +41,16 @@ interface RemnicPiConfig {
      * for an exponentially growing window starting at this value (issue #1626).
      */
     daemonCooldownMs: number;
+    /**
+     * Number of explicit recall timeout errors in the last {@link recallTimeoutWindow}
+     * recall calls that permanently disables automatic recall for the process lifetime.
+     */
+    recallTimeoutThreshold: number;
+    /**
+     * Size of the rolling window of recent recall calls used by the recall-timeout
+     * circuit breaker.
+     */
+    recallTimeoutWindow: number;
 }
 interface LoadConfigOptions {
     configPath?: string;
@@ -79,6 +89,8 @@ interface McpTool {
 }
 interface RequestOptions {
     timeoutMs?: number;
+    /** Optional caller abort signal (e.g. shared breaker trip). */
+    signal?: AbortSignal;
     /** Transient-retry budget for connection-level failures (socket close, ECONNRESET). */
     maxRetries?: number;
 }
@@ -140,7 +152,7 @@ declare class RemnicClient {
     lcmCompactionRecord(sessionKey: string, tokensBefore: number, tokensAfter: number): Promise<Record<string, unknown>>;
     contextCheckpoint(sessionKey: string, context: string): Promise<Record<string, unknown>>;
     mcpListTools(options?: RequestOptions): Promise<McpTool[]>;
-    mcpTool(name: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    mcpTool(name: string, args: Record<string, unknown>, options?: RequestOptions): Promise<Record<string, unknown>>;
     /**
      * Single HTTP attempt with the configured timeout. No retry — retry of
      * transient connection failures lives in {@link requestWithRetry}.
@@ -169,9 +181,11 @@ type PiApi = {
     registerTool(tool: Record<string, unknown>): void;
     appendEntry<T = unknown>(customType: string, data?: T): void;
 };
+type RemnicPiConfigInput = Omit<RemnicPiConfig, "recallTimeoutThreshold" | "recallTimeoutWindow"> & Partial<Pick<RemnicPiConfig, "recallTimeoutThreshold" | "recallTimeoutWindow">>;
 interface RemnicPiExtensionOptions extends LoadConfigOptions {
-    config?: RemnicPiConfig;
+    config?: RemnicPiConfigInput;
 }
+declare function resetProcessRecallBreakerForTest(config: Pick<RemnicPiConfig, "remnicDaemonUrl" | "namespace" | "authToken" | "recallTimeoutThreshold" | "recallTimeoutWindow">): void;
 declare function createRemnicPiExtension(options?: RemnicPiExtensionOptions): (pi: PiApi) => Promise<void>;
 declare function remnicPiExtension(pi: PiApi): Promise<void>;
 declare function toPiToolParametersSchema(inputSchema: unknown): TSchema;
@@ -181,4 +195,4 @@ declare function observeMessages(ctx: any, client: RemnicClient, rawMessages: un
 declare function buildCompactionSummary(preparation: any): string;
 declare function isDaemonUnreachableError(err: unknown): boolean;
 
-export { type RemnicPiExtensionOptions, buildCompactionSummary, createRemnicPiExtension, remnicPiExtension as default, isDaemonUnreachableError, observeMessages, stripSessionOwnedRuntimeFields, stripSessionOwnedSchemaFields, textFromMessage, toPiToolParametersSchema };
+export { type PiApi, type RemnicPiConfigInput, type RemnicPiExtensionOptions, buildCompactionSummary, createRemnicPiExtension, remnicPiExtension as default, isDaemonUnreachableError, observeMessages, resetProcessRecallBreakerForTest, stripSessionOwnedRuntimeFields, stripSessionOwnedSchemaFields, textFromMessage, toPiToolParametersSchema };