@byte5ai/palaia 1.8.1 → 2.0.2

package/index.ts

@@ -7,7 +7,8 @@
  * - memory_search: Semantic search over Palaia memory
  * - memory_get: Read a specific memory entry
  * - memory_write: Write new entries (optional, opt-in)
- * - before_prompt_build: HOT memory injection (opt-in)
+ * - before_prompt_build: Query-based contextual recall (opt-in, Issue #65)
+ * - agent_end: Auto-capture of significant exchanges (opt-in, Issue #64)
  * - palaia-recovery: WAL replay on startup
  *
  * Activation:
@@ -19,6 +20,12 @@ import { registerTools } from "./src/tools.js";
 import { registerHooks } from "./src/hooks.js";
 
 export default function palaiaPlugin(api: any) {
+  // Issue #66: Plugin config is currently resolved GLOBALLY via api.getConfig("palaia").
+  // OpenClaw does NOT provide per-agent config resolution — all agents share the same
+  // plugin config from openclaw.json → plugins.config.palaia.
+  // A per-agent resolver would require an OpenClaw upstream change where api.getConfig()
+  // accepts an agentId parameter or automatically scopes to the current agent context.
+  // See: https://github.com/iret77/palaia/issues/66
   const rawConfig = api.getConfig?.("palaia") as
     | Partial<PalaiaPluginConfig>
     | undefined;

package/openclaw.plugin.json

@@ -28,13 +28,73 @@
       },
       "memoryInject": {
         "type": "boolean",
-        "default": false,
+        "default": true,
         "description": "Inject HOT memory into agent context on prompt build"
       },
       "maxInjectedChars": {
         "type": "number",
-        "default": 4000,
+        "default": 8000,
         "description": "Max characters for injected memory context"
+      },
+      "autoCapture": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable automatic memory capture after agent exchanges"
+      },
+      "captureFrequency": {
+        "type": "string",
+        "enum": ["every", "significant"],
+        "default": "significant",
+        "description": "How often to capture: every exchange or only significant ones"
+      },
+      "captureMinTurns": {
+        "type": "number",
+        "default": 1,
+        "description": "Minimum exchange turns before capture is attempted"
+      },
+      "captureModel": {
+        "type": "string",
+        "description": "Model override for LLM-based extraction (e.g. 'anthropic/claude-haiku-4', 'cheap')"
+      },
+      "captureMinSignificance": {
+        "type": "number",
+        "default": 0.3,
+        "description": "Minimum significance score (0.0-1.0) for LLM-extracted items to be captured"
+      },
+      "captureScope": {
+        "type": "string",
+        "default": "team",
+        "description": "Static scope override for auto-capture (private|team|public|shared:<name>)"
+      },
+      "captureProject": {
+        "type": "string",
+        "description": "Static project override for auto-capture"
+      },
+      "showMemorySources": {
+        "type": "boolean",
+        "default": true,
+        "description": "Show memory source footnotes in agent responses"
+      },
+      "showCaptureConfirm": {
+        "type": "boolean",
+        "default": true,
+        "description": "Show capture confirmations in agent responses"
+      },
+      "recallMode": {
+        "type": "string",
+        "enum": ["list", "query"],
+        "default": "query",
+        "description": "Recall mode: list (context-independent) or query (context-relevant)"
+      },
+      "recallTypeWeight": {
+        "type": "object",
+        "default": { "process": 1.5, "task": 1.2, "memory": 1.0 },
+        "description": "Type-aware weighting for recall results",
+        "properties": {
+          "process": { "type": "number", "default": 1.5 },
+          "task": { "type": "number", "default": 1.2 },
+          "memory": { "type": "number", "default": 1.0 }
+        }
       }
     }
   },
@@ -46,6 +106,30 @@
     "workspace": {
       "label": "Workspace Path",
       "placeholder": "agent workspace"
+    },
+    "memoryInject": {
+      "label": "Memory Injection",
+      "description": "Inject relevant memories into agent context before each prompt (recommended: on)"
+    },
+    "maxInjectedChars": {
+      "label": "Max Injected Characters",
+      "description": "Maximum characters of memory context injected per prompt (recommended: 8000)"
+    },
+    "autoCapture": {
+      "label": "Auto-Capture",
+      "description": "Automatically capture significant exchanges as memories (recommended: on)"
+    },
+    "showMemorySources": {
+      "label": "Memory Source Footnotes",
+      "description": "Show which memories were used in agent responses (recommended: on)"
+    },
+    "showCaptureConfirm": {
+      "label": "Capture Confirmations",
+      "description": "Show confirmation when exchanges are saved to memory (recommended: on)"
+    },
+    "recallMode": {
+      "label": "Recall Mode",
+      "description": "How memories are retrieved: query (semantic) or list (tier-based)"
     }
   }
 }

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@byte5ai/palaia",
-  "version": "1.8.1",
+  "version": "2.0.2",
   "description": "Palaia memory backend for OpenClaw",
   "main": "index.ts",
   "openclaw": {
-    "extensions": ["./index.ts"]
+    "extensions": [
+      "./index.ts"
+    ]
   },
   "files": [
     "index.ts",
@@ -28,8 +30,11 @@
   "peerDependencies": {
     "openclaw": ">=2025.1.0"
   },
+  "dependencies": {
+    "@sinclair/typebox": "^0.32.0"
+  },
   "devDependencies": {
-    "@sinclair/typebox": "^0.32.0",
+    "typescript": "^5.9.3",
     "vitest": "^1.0.0"
   }
 }

package/src/config.ts

@@ -2,6 +2,13 @@
  * Plugin configuration schema and defaults for @byte5ai/palaia.
  */
 
+export interface RecallTypeWeights {
+  process: number;
+  task: number;
+  memory: number;
+  [key: string]: number;
+}
+
 export interface PalaiaPluginConfig {
   /** Path to palaia binary (default: auto-detect) */
   binaryPath?: string;
@@ -17,14 +24,58 @@ export interface PalaiaPluginConfig {
   memoryInject: boolean;
   /** Max characters for injected memory context */
   maxInjectedChars: number;
+
+  // ── Auto-Capture (Issue #64) ─────────────────────────────────
+  /** Enable automatic memory capture after agent exchanges */
+  autoCapture: boolean;
+  /** How often to capture: "every" | "significant" (default: "significant") */
+  captureFrequency: "every" | "significant";
+  /** Minimum exchange turns before capture is attempted */
+  captureMinTurns: number;
+  /** Model override for LLM-based extraction (e.g. "anthropic/claude-haiku-3", or "cheap") */
+  captureModel?: string;
+  /** Minimum significance score for LLM-extracted items (0.0-1.0, default: 0.3) */
+  captureMinSignificance: number;
+
+  // ── Metadata Overrides (Issue #81) ─────────────────────────
+  /** Static scope override for auto-capture (default: undefined → LLM detection) */
+  captureScope?: string;
+  /** Static project override for auto-capture (default: undefined → LLM detection) */
+  captureProject?: string;
+
+  // ── Transparency Features (Issue #87) ────────────────────────
+  /** Show memory source footnotes in agent responses (default: true) */
+  showMemorySources: boolean;
+  /** Show capture confirmation in agent responses (default: true) */
+  showCaptureConfirm: boolean;
+
+  // ── Query-based Recall (Issue #65) ───────────────────────────
+  /** Recall mode: "list" (context-independent) or "query" (context-relevant) */
+  recallMode: "list" | "query";
+  /** Type-aware weighting for recall results */
+  recallTypeWeight: RecallTypeWeights;
 }
 
+export const DEFAULT_RECALL_TYPE_WEIGHTS: RecallTypeWeights = {
+  process: 1.5,
+  task: 1.2,
+  memory: 1.0,
+};
+
 export const DEFAULT_CONFIG: PalaiaPluginConfig = {
   tier: "hot",
   maxResults: 10,
   timeoutMs: 3000,
-  memoryInject: false,
-  maxInjectedChars: 4000,
+  memoryInject: true,
+  maxInjectedChars: 8000,
+  autoCapture: true,
+  captureFrequency: "significant",
+  captureMinTurns: 2,
+  captureMinSignificance: 0.3,
+  showMemorySources: true,
+  showCaptureConfirm: true,
+  recallMode: "query",
+  recallTypeWeight: { ...DEFAULT_RECALL_TYPE_WEIGHTS },
 };
 
 /**
@@ -33,5 +84,13 @@ export const DEFAULT_CONFIG: PalaiaPluginConfig = {
 export function resolveConfig(
   userConfig: Partial<PalaiaPluginConfig> | undefined
 ): PalaiaPluginConfig {
-  return { ...DEFAULT_CONFIG, ...userConfig };
+  const base = { ...DEFAULT_CONFIG, ...userConfig };
+  // Deep-merge recallTypeWeight
+  if (userConfig?.recallTypeWeight) {
+    base.recallTypeWeight = {
+      ...DEFAULT_RECALL_TYPE_WEIGHTS,
+      ...userConfig.recallTypeWeight,
+    };
+  }
+  return base;
 }