@agenr/openclaw-plugin 0.13.4 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.14.0] - 2026-03-24
+
+### Surgeon — Budget Model Overhaul
+
+- **`--budget` now means dollars, not tokens.** The cumulative token budget that double-counted context re-sends across turns is gone. The surgeon is now constrained by two things: cost (dollars) and context window (tokens). Config `surgeon.budget` is dollars per run. Default: $5.
+- **Context-aware limits.** New `surgeon.contextLimit` config field and `--context-limit` CLI flag. Auto-detects from `model.contextWindow * 0.85` if not set. The surgeon stops when context is full, not from artificial token counting.
+- **`costCap` removed.** Replaced by `budget`. Old `costCap` values are accepted as backward-compatible alias with deprecation warning.
+
+### Surgeon — Contradiction Improvements
+
+- **`coexists` relation for `log_conflict`.** The surgeon can now log reviewed false-positive pairs as coexisting rather than forcing them into `contradicts` or `supersedes`. Coexists conflicts are auto-resolved as `keep-both` so they don't accumulate as pending conflicts and future scans skip them.
+- **Improved contradiction candidate filtering.** Suppresses historical series pairs (release versions, prompt paths, roadmap snapshots) from claim divergence scanning. Prioritizes `current_state` claim divergence pairs.
+
+### Surgeon — Retirement Candidate Scoping
+
+- **Scoped candidate queries.** `query_candidates` now accepts `scope` parameter: `actionable` (default) filters to entries with high retirement probability — temporary, ephemeral, todos, low-importance events, mislabeled temporal artifacts. `all` shows the full candidate pool for deep sweeps.
+- **Improved candidate ordering.** Actionable scope returns temporary entries first, then ephemeral, then todos, then low-importance events. Durable permanent decisions and preferences are excluded from the default scope.
+- **Two-phase retirement in auto mode.** Surgeon starts with actionable candidates, widens to full pool only if budget remains after exhausting the actionable set.
+
 ## [0.13.4] - 2026-03-23
 
 ### Surgeon

package/dist/index.js

@@ -3894,7 +3894,7 @@ function isAgenrAuthMethod(value) {
 function resolveDefaultKnowledgeDbPath() {
   return path3.join(os3.homedir(), ".agenr", "knowledge.db");
 }
-var SCORING_SET_KEYS, AUTH_METHOD_DEFINITIONS, AUTH_METHOD_SET, MODEL_TASK_KEYS, DEFAULT_EMBEDDING_PROVIDER, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_DIMENSIONS, DEFAULT_FORGETTING_SCORE_THRESHOLD, DEFAULT_FORGETTING_MAX_AGE_DAYS, DEFAULT_FORGETTING_LOW_SCORE_TRIGGER_COUNT, DEFAULT_SCORING_FTS_BOOST, DEFAULT_SCORING_VECTOR_EXPONENT, DEFAULT_SCORING_IMPORTANCE_FLOOR, DEFAULT_SCORING_FRESHNESS_HIGH_HOURS, DEFAULT_SCORING_FRESHNESS_MEDIUM_HOURS, DEFAULT_SCORING_FRESHNESS_LOW_HOURS, DEFAULT_SCORING_RECENCY_HALFLIFE_PERMANENT, DEFAULT_SCORING_RECENCY_HALFLIFE_TEMPORARY, DEFAULT_SCORING_FRESHNESS_MIN_IMPORTANCE, DEFAULT_SCORING_CONTRADICTION_PENALTY, DEFAULT_SCORING_QUALITY_MIN, DEFAULT_SCORING_QUALITY_MAX, DEFAULT_SCORING_IMPORTANCE_BLEND, DEFAULT_SCORING_RECALL_BLEND, DEFAULT_SCORING_TODO_HALFLIFE_DAYS, DEFAULT_SCORING_TODO_FLOOR_HIGH, DEFAULT_SCORING_TODO_FLOOR_LOW, DEFAULT_CONTRADICTION_ENABLED, DEFAULT_TASK_MODEL, DEFAULT_SURGEON_MODEL, DEFAULT_AUTO_SUPERSEDE_CONFIDENCE, DEFAULT_CONTRADICTION_BLOCKING_THRESHOLD, DEFAULT_CLAIM_EXTRACTION_BATCH_SIZE, MAX_CLAIM_EXTRACTION_BATCH_SIZE, DEFAULT_CLAIM_EXTRACTION_CONCURRENCY, MAX_CLAIM_EXTRACTION_CONCURRENCY, DEFAULT_SURGEON_BUDGET, DEFAULT_SURGEON_COST_CAP, DEFAULT_SURGEON_DAILY_COST_CAP, DEFAULT_SURGEON_RETIREMENT_PROTECT_RECALLED_DAYS, DEFAULT_SURGEON_RETIREMENT_PROTECT_MIN_IMPORTANCE, DEFAULT_SURGEON_RETIREMENT_MAX_ACTIONS_PER_RUN, DEFAULT_SURGEON_SKIP_RECENTLY_EVALUATED_DAYS, DEFAULT_SURGEON_DEDUP_MAX_MERGES_PER_RUN, DEFAULT_SURGEON_CONTRADICTIONS_MAX_ACTIONS_PER_RUN;
+var SCORING_SET_KEYS, AUTH_METHOD_DEFINITIONS, AUTH_METHOD_SET, MODEL_TASK_KEYS, DEFAULT_EMBEDDING_PROVIDER, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_DIMENSIONS, DEFAULT_FORGETTING_SCORE_THRESHOLD, DEFAULT_FORGETTING_MAX_AGE_DAYS, DEFAULT_FORGETTING_LOW_SCORE_TRIGGER_COUNT, DEFAULT_SCORING_FTS_BOOST, DEFAULT_SCORING_VECTOR_EXPONENT, DEFAULT_SCORING_IMPORTANCE_FLOOR, DEFAULT_SCORING_FRESHNESS_HIGH_HOURS, DEFAULT_SCORING_FRESHNESS_MEDIUM_HOURS, DEFAULT_SCORING_FRESHNESS_LOW_HOURS, DEFAULT_SCORING_RECENCY_HALFLIFE_PERMANENT, DEFAULT_SCORING_RECENCY_HALFLIFE_TEMPORARY, DEFAULT_SCORING_FRESHNESS_MIN_IMPORTANCE, DEFAULT_SCORING_CONTRADICTION_PENALTY, DEFAULT_SCORING_QUALITY_MIN, DEFAULT_SCORING_QUALITY_MAX, DEFAULT_SCORING_IMPORTANCE_BLEND, DEFAULT_SCORING_RECALL_BLEND, DEFAULT_SCORING_TODO_HALFLIFE_DAYS, DEFAULT_SCORING_TODO_FLOOR_HIGH, DEFAULT_SCORING_TODO_FLOOR_LOW, DEFAULT_CONTRADICTION_ENABLED, DEFAULT_TASK_MODEL, DEFAULT_SURGEON_MODEL, DEFAULT_AUTO_SUPERSEDE_CONFIDENCE, DEFAULT_CONTRADICTION_BLOCKING_THRESHOLD, DEFAULT_CLAIM_EXTRACTION_BATCH_SIZE, MAX_CLAIM_EXTRACTION_BATCH_SIZE, DEFAULT_CLAIM_EXTRACTION_CONCURRENCY, MAX_CLAIM_EXTRACTION_CONCURRENCY, DEFAULT_SURGEON_CONTEXT_LIMIT, DEFAULT_SURGEON_COST_CAP, DEFAULT_SURGEON_DAILY_COST_CAP, DEFAULT_SURGEON_RETIREMENT_PROTECT_RECALLED_DAYS, DEFAULT_SURGEON_RETIREMENT_PROTECT_MIN_IMPORTANCE, DEFAULT_SURGEON_RETIREMENT_MAX_ACTIONS_PER_RUN, DEFAULT_SURGEON_SKIP_RECENTLY_EVALUATED_DAYS, DEFAULT_SURGEON_DEDUP_MAX_MERGES_PER_RUN, DEFAULT_SURGEON_CONTRADICTIONS_MAX_ACTIONS_PER_RUN;
 var init_schema2 = __esm({
   "src/shared/infrastructure/config/schema.ts"() {
     "use strict";
@@ -3993,7 +3993,7 @@ var init_schema2 = __esm({
     MAX_CLAIM_EXTRACTION_BATCH_SIZE = 25;
     DEFAULT_CLAIM_EXTRACTION_CONCURRENCY = 5;
     MAX_CLAIM_EXTRACTION_CONCURRENCY = 50;
-    DEFAULT_SURGEON_BUDGET = 2e5;
+    DEFAULT_SURGEON_CONTEXT_LIMIT = null;
     DEFAULT_SURGEON_COST_CAP = 5;
     DEFAULT_SURGEON_DAILY_COST_CAP = 15;
     DEFAULT_SURGEON_RETIREMENT_PROTECT_RECALLED_DAYS = 14;
@@ -4650,7 +4650,7 @@ function normalizeContradictionConfig(input) {
 }
 function normalizeSurgeonConfig(input) {
   const normalized = {
-    budget: DEFAULT_SURGEON_BUDGET,
+    contextLimit: DEFAULT_SURGEON_CONTEXT_LIMIT,
     costCap: DEFAULT_SURGEON_COST_CAP,
     dailyCostCap: DEFAULT_SURGEON_DAILY_COST_CAP,
     passes: {
@@ -4676,8 +4676,12 @@ function normalizeSurgeonConfig(input) {
   if (typeof record.model === "string" && record.model.trim()) {
     normalized.model = record.model.trim();
   }
-  if (typeof record.budget === "number" && Number.isFinite(record.budget) && record.budget > 0) {
-    normalized.budget = Math.floor(record.budget);
+  if (typeof record.contextLimit === "number" && Number.isFinite(record.contextLimit) && record.contextLimit > 0) {
+    normalized.contextLimit = Math.floor(record.contextLimit);
+  } else if (record.contextLimit === null) {
+    normalized.contextLimit = null;
+  } else if (typeof record.budget === "number" && Number.isFinite(record.budget) && record.budget > 0) {
+    normalized.contextLimit = Math.floor(record.budget);
   }
   if (typeof record.costCap === "number" && Number.isFinite(record.costCap) && record.costCap > 0) {
     normalized.costCap = record.costCap;
@@ -5407,6 +5411,7 @@ __export(config_exports, {
   AUTH_METHOD_DEFINITIONS: () => AUTH_METHOD_DEFINITIONS,
   DEFAULT_CLAIM_EXTRACTION_BATCH_SIZE: () => DEFAULT_CLAIM_EXTRACTION_BATCH_SIZE,
   DEFAULT_CLAIM_EXTRACTION_CONCURRENCY: () => DEFAULT_CLAIM_EXTRACTION_CONCURRENCY,
+  DEFAULT_SURGEON_CONTEXT_LIMIT: () => DEFAULT_SURGEON_CONTEXT_LIMIT,
   DEFAULT_SURGEON_MODEL: () => DEFAULT_SURGEON_MODEL,
   DEFAULT_SURGEON_SKIP_RECENTLY_EVALUATED_DAYS: () => DEFAULT_SURGEON_SKIP_RECENTLY_EVALUATED_DAYS,
   DEFAULT_TASK_MODEL: () => DEFAULT_TASK_MODEL,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenr/openclaw-plugin",
-  "version": "0.13.4",
+  "version": "0.14.0",
   "description": "agenr memory plugin for OpenClaw — lightweight plugin-only package without the CLI",
   "license": "AGPL-3.0",
   "author": "agenr-ai",