@agenr/openclaw-plugin 0.12.2 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.12.3] - 2026-03-22
+
+### Fixed
+
+- **Plugin DB tables in core schema.** `session_projects`, `seen_sessions`, and `session_identity_breadcrumbs` tables are now created as part of the main schema init, fixing `SQLITE_ERROR: no such table: session_projects` errors when calling `agenr_set_session_project` or `agenr_get_session_project`. Previously these tables depended on a lazy plugin-db init path that could fail to run.
+- **Tool schema Codex compatibility.** Replaced `Type.Union([Type.Literal(...)])` with `Type.String({ enum: [...] })` for the `expiry` and recall `context` fields in tool schemas. Codex and other providers that reject `anyOf`/`oneOf` at top level now get clean schemas.
+- **Support-aware cluster validation.** Consolidation cluster validation now uses support-aware entry resolution, preventing false merge candidates from stale or unsupported cluster assignments.
+
 ## [0.12.2] - 2026-03-22
 
 ### Recall Scoping Fixes

package/dist/index.js

@@ -107,7 +107,7 @@ var init_logger = __esm({
 });
 
 // src/db/schema/definitions.ts
-var CREATE_IDX_ENTRIES_EMBEDDING_SQL, CREATE_ENTRIES_FTS_TABLE_SQL, CREATE_ENTRIES_FTS_TRIGGER_AI_SQL, CREATE_ENTRIES_FTS_TRIGGER_AD_SQL, CREATE_ENTRIES_FTS_TRIGGER_AU_SQL, CREATE_TABLE_AND_TRIGGER_STATEMENTS, COLUMN_MIGRATIONS, CREATE_INDEX_STATEMENTS;
+var CREATE_IDX_ENTRIES_EMBEDDING_SQL, CREATE_ENTRIES_FTS_TABLE_SQL, CREATE_ENTRIES_FTS_TRIGGER_AI_SQL, CREATE_ENTRIES_FTS_TRIGGER_AD_SQL, CREATE_ENTRIES_FTS_TRIGGER_AU_SQL, CREATE_SEEN_SESSIONS_TABLE_SQL, CREATE_SEEN_SESSIONS_SEEN_AT_INDEX_SQL, CREATE_SESSION_PROJECTS_TABLE_SQL, CREATE_SESSION_IDENTITY_BREADCRUMBS_TABLE_SQL, CREATE_SESSION_IDENTITY_BREADCRUMBS_UPDATED_AT_INDEX_SQL, ADD_SESSION_PROJECT_STATE_COLUMN_SQL, OPENCLAW_PLUGIN_SCHEMA_STATEMENTS, OPENCLAW_PLUGIN_COLUMN_MIGRATIONS, CREATE_TABLE_AND_TRIGGER_STATEMENTS, COLUMN_MIGRATIONS, CREATE_INDEX_STATEMENTS;
 var init_definitions = __esm({
   "src/db/schema/definitions.ts"() {
     "use strict";
@@ -146,6 +146,60 @@ var init_definitions = __esm({
     WHERE new.retired = 0 AND new.superseded_by IS NULL;
   END
 `;
+    CREATE_SEEN_SESSIONS_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS seen_sessions (
+    dedupe_key TEXT PRIMARY KEY,
+    seen_at INTEGER NOT NULL
+  )
+`;
+    CREATE_SEEN_SESSIONS_SEEN_AT_INDEX_SQL = `
+  CREATE INDEX IF NOT EXISTS idx_seen_sessions_seen_at
+  ON seen_sessions(seen_at)
+`;
+    CREATE_SESSION_PROJECTS_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS session_projects (
+    session_key TEXT PRIMARY KEY,
+    project TEXT NOT NULL,
+    state TEXT NOT NULL DEFAULT 'set',
+    updated_at TEXT NOT NULL
+  )
+`;
+    CREATE_SESSION_IDENTITY_BREADCRUMBS_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS session_identity_breadcrumbs (
+    session_id TEXT PRIMARY KEY,
+    session_key TEXT,
+    family TEXT NOT NULL,
+    lane_id TEXT,
+    origin_surface TEXT,
+    delivery_channel TEXT,
+    family_source TEXT,
+    lane_source TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  )
+`;
+    CREATE_SESSION_IDENTITY_BREADCRUMBS_UPDATED_AT_INDEX_SQL = `
+  CREATE INDEX IF NOT EXISTS idx_session_identity_breadcrumbs_updated_at
+  ON session_identity_breadcrumbs(updated_at)
+`;
+    ADD_SESSION_PROJECT_STATE_COLUMN_SQL = `
+  ALTER TABLE session_projects
+  ADD COLUMN state TEXT NOT NULL DEFAULT 'set'
+`;
+    OPENCLAW_PLUGIN_SCHEMA_STATEMENTS = [
+      CREATE_SEEN_SESSIONS_TABLE_SQL,
+      CREATE_SEEN_SESSIONS_SEEN_AT_INDEX_SQL,
+      CREATE_SESSION_PROJECTS_TABLE_SQL,
+      CREATE_SESSION_IDENTITY_BREADCRUMBS_TABLE_SQL,
+      CREATE_SESSION_IDENTITY_BREADCRUMBS_UPDATED_AT_INDEX_SQL
+    ];
+    OPENCLAW_PLUGIN_COLUMN_MIGRATIONS = [
+      {
+        table: "session_projects",
+        column: "state",
+        sql: ADD_SESSION_PROJECT_STATE_COLUMN_SQL
+      }
+    ];
     CREATE_TABLE_AND_TRIGGER_STATEMENTS = [
       `
   CREATE TABLE IF NOT EXISTS _meta (
@@ -419,9 +473,11 @@ var init_definitions = __esm({
       CREATE_ENTRIES_FTS_TABLE_SQL,
       CREATE_ENTRIES_FTS_TRIGGER_AI_SQL,
       CREATE_ENTRIES_FTS_TRIGGER_AD_SQL,
-      CREATE_ENTRIES_FTS_TRIGGER_AU_SQL
+      CREATE_ENTRIES_FTS_TRIGGER_AU_SQL,
+      ...OPENCLAW_PLUGIN_SCHEMA_STATEMENTS
     ];
     COLUMN_MIGRATIONS = [
+      ...OPENCLAW_PLUGIN_COLUMN_MIGRATIONS,
       {
         table: "co_recall_edges",
         column: "edge_type",
@@ -8552,6 +8608,7 @@ function formatMidSessionRecall(results, options = {}) {
 
 // src/runtime/openclaw-defaults.ts
 init_client();
+init_schema();
 
 // src/db/signals.ts
 async function fetchNewSignalEntries(db, sinceSeq, minImportance, limit, maxAgeSec = 0) {
@@ -8668,7 +8725,9 @@ function resolveOpenClawPluginDbDefaults() {
   return {
     getDb: shared.getDbFn,
     initDb: shared.initDbFn,
-    closeDb: shared.closeDbFn
+    closeDb: shared.closeDbFn,
+    pluginSchemaStatements: OPENCLAW_PLUGIN_SCHEMA_STATEMENTS,
+    pluginColumnMigrations: OPENCLAW_PLUGIN_COLUMN_MIGRATIONS
   };
 }
 function resolveOpenClawSignalDefaults() {
@@ -8688,46 +8747,6 @@ function resolveOpenClawHandoffDefaults() {
 }
 
 // src/openclaw-plugin/plugin-db.ts
-var CREATE_SEEN_SESSIONS_TABLE_SQL = `
-  CREATE TABLE IF NOT EXISTS seen_sessions (
-    dedupe_key TEXT PRIMARY KEY,
-    seen_at INTEGER NOT NULL
-  )
-`;
-var CREATE_SEEN_SESSIONS_SEEN_AT_INDEX_SQL = `
-  CREATE INDEX IF NOT EXISTS idx_seen_sessions_seen_at
-  ON seen_sessions(seen_at)
-`;
-var CREATE_SESSION_PROJECTS_TABLE_SQL = `
-  CREATE TABLE IF NOT EXISTS session_projects (
-    session_key TEXT PRIMARY KEY,
-    project TEXT NOT NULL,
-    state TEXT NOT NULL DEFAULT 'set',
-    updated_at TEXT NOT NULL
-  )
-`;
-var CREATE_SESSION_IDENTITY_BREADCRUMBS_TABLE_SQL = `
-  CREATE TABLE IF NOT EXISTS session_identity_breadcrumbs (
-    session_id TEXT PRIMARY KEY,
-    session_key TEXT,
-    family TEXT NOT NULL,
-    lane_id TEXT,
-    origin_surface TEXT,
-    delivery_channel TEXT,
-    family_source TEXT,
-    lane_source TEXT,
-    created_at TEXT NOT NULL,
-    updated_at TEXT NOT NULL
-  )
-`;
-var CREATE_SESSION_IDENTITY_BREADCRUMBS_UPDATED_AT_INDEX_SQL = `
-  CREATE INDEX IF NOT EXISTS idx_session_identity_breadcrumbs_updated_at
-  ON session_identity_breadcrumbs(updated_at)
-`;
-var ADD_SESSION_PROJECT_STATE_COLUMN_SQL = `
-  ALTER TABLE session_projects
-  ADD COLUMN state TEXT NOT NULL DEFAULT 'set'
-`;
 var PLUGIN_DB_STATE_KEY = "__agenrOpenClawPluginDbState";
 function getPluginDbState() {
   const globalState = globalThis;
@@ -8747,18 +8766,19 @@ function closePluginDbState(state) {
   state.init = null;
 }
 async function ensurePluginDbTables(client) {
-  await resolveOpenClawPluginDbDefaults().initDb(client);
-  await client.execute(CREATE_SEEN_SESSIONS_TABLE_SQL);
-  await client.execute(CREATE_SEEN_SESSIONS_SEEN_AT_INDEX_SQL);
-  await client.execute(CREATE_SESSION_PROJECTS_TABLE_SQL);
-  await client.execute(CREATE_SESSION_IDENTITY_BREADCRUMBS_TABLE_SQL);
-  await client.execute(CREATE_SESSION_IDENTITY_BREADCRUMBS_UPDATED_AT_INDEX_SQL);
-  const sessionProjectsInfo = await client.execute("PRAGMA table_info(session_projects)");
-  const hasStateColumn = sessionProjectsInfo.rows.some(
-    (row) => String(row.name) === "state"
-  );
-  if (!hasStateColumn) {
-    await client.execute(ADD_SESSION_PROJECT_STATE_COLUMN_SQL);
+  const defaults = resolveOpenClawPluginDbDefaults();
+  await defaults.initDb(client);
+  for (const statement of defaults.pluginSchemaStatements) {
+    await client.execute(statement);
+  }
+  for (const migration of defaults.pluginColumnMigrations) {
+    const tableInfo = await client.execute(`PRAGMA table_info(${migration.table})`);
+    const hasColumn2 = tableInfo.rows.some(
+      (row) => String(row.name) === migration.column
+    );
+    if (!hasColumn2) {
+      await client.execute(migration.sql);
+    }
   }
 }
 function registerDbShutdown(state) {
@@ -33348,11 +33368,7 @@ async function runClearSessionProjectTool(sessionKey, pluginConfig) {
 }
 
 // src/openclaw-plugin/hooks/register-tools.ts
-var EXPIRY_SCHEMA = Type6.Union([
-  Type6.Literal("core"),
-  Type6.Literal("permanent"),
-  Type6.Literal("temporary")
-]);
+var EXPIRY_SCHEMA = Type6.String({ enum: ["core", "permanent", "temporary"] });
 function optionalExpirySchema(description) {
   return Type6.Optional({
     ...EXPIRY_SCHEMA,
@@ -33398,12 +33414,10 @@ function registerAgenrTools(api, params) {
       parameters: Type6.Object({
         query: Type6.Optional(Type6.String({ description: "What to search for." })),
         context: Type6.Optional(
-          Type6.Union(
-            [Type6.Literal("default"), Type6.Literal("session-start"), Type6.Literal("browse")],
-            {
-              description: "Use session-start for fast bootstrap without embedding. Use browse for recency-dominant temporal browsing with secondary importance tie-breaking (no query needed, no semantic search)."
-            }
-          )
+          Type6.String({
+            enum: ["default", "session-start", "browse"],
+            description: "Use session-start for fast bootstrap without embedding. Use browse for recency-dominant temporal browsing with secondary importance tie-breaking (no query needed, no semantic search)."
+          })
         ),
         limit: Type6.Optional(Type6.Number({ description: "Max results (default: 10)." })),
         types: Type6.Optional(Type6.String({ description: "Comma-separated entry types to filter." })),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenr/openclaw-plugin",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "description": "agenr memory plugin for OpenClaw — lightweight plugin-only package without the CLI",
   "license": "AGPL-3.0",
   "author": "agenr-ai",
@@ -26,7 +26,8 @@
   "dependencies": {
     "@libsql/client": "^0.17.2",
     "@mariozechner/pi-ai": "^0.61.1",
-    "@sinclair/typebox": "^0.34.48"
+    "@sinclair/typebox": "^0.34.48",
+    "agenr": "0.13.0"
   },
   "openclaw": {
     "extensions": [
@@ -39,4 +40,4 @@
     "memory",
     "plugin"
   ]
-}
+}

package/skills/skills/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: agenr
+description: Use when storing new knowledge (decisions, preferences, lessons, todos) or recalling context mid-session. The agenr plugin auto-injects memory at session start - this skill covers proactive store and on-demand recall.
+---
+
+## agenr_store
+
+Use proactively for durable knowledge - decisions, preferences, lessons, and facts that future sessions need to make better decisions.
+
+**The future-session test:** Before storing, ask: "If I woke up in a fresh session and recalled this, would it change how I act?" If the answer is just "it tells me something that already happened and is done" - do not store it.
+
+**Store:**
+- Architecture decisions and design rationale
+- Workflow constraints and operational rules
+- Lessons learned from problems (recurring bugs, what worked, what did not)
+- User preferences and working-style observations
+- Durable facts about systems, environments, people, projects
+- Important open risks or unresolved hazards
+
+**Do not store:**
+- Version or release shipping events ("v1.2.3 shipped") - changelogs are the system of record
+- Issue or PR filing records ("filed #123, #124") - the issue tracker is the system of record
+- Phase plans or release packaging decisions - transient coordination artifacts, stale within a session
+- Progress snapshots ("3 of 5 tasks done") - stale within minutes
+- Prompt file paths or internal build logistics - look-up-able, not memory-worthy
+- Anything whose only value is duplicating files, the issue tracker, or git history
+
+Do not ask before storing - but do ask whether future-you needs it.
+
+Required: `type`, `content`, `importance`.
+Optional: `subject` (short label), `tags` (array), `scope` (`private`|`personal`|`public`), `project`, `platform`, `source`.
+
+Types: `fact | decision | preference | todo | lesson | event | relationship`
+Do not store secrets/credentials, temporary state, or verbatim conversation.
+
+### Importance calibration
+
+- **10**: Once-per-project permanent constraints. At most 1-2 per project lifetime.
+- **9**: Critical breaking changes or immediate cross-session decisions. At most 1 per significant session, often 0.
+- **8**: Things an active parallel session would act on right now. Fires a cross-session signal. Use conservatively.
+- **7**: Default. Project facts, decisions, preferences, milestones. No signal fired.
+- **6**: Routine dev observations (verified X, tests passing). Cap here unless the result is surprising.
+- **5**: Borderline. Only store if clearly durable beyond today.
+- **Importance is not recency.** Something that just happened is not automatically important. A shipping event is importance 5-6 at best unless it teaches a lesson. A recurring operational hazard is importance 7-8 because it affects future decisions.
+
+Entries at 7 are saved silently. Use 8+ only if other active sessions need to know NOW.
+
+### Confidence-aware extraction (OpenClaw transcripts)
+
+OpenClaw transcripts include `[user]` / `[assistant]` role labels. The extractor uses this signal:
+- Hedged or unverified assistant factual claims are tagged `unverified` and hard-capped at importance 5.
+- Tool-verified assistant claims follow normal importance rules.
+- User messages are never capped.
+
+This means: if you say something unverified, it will be stored at max importance 5. To store a fact at higher importance, verify it with a tool call first.
+
+## agenr_recall
+
+Use mid-session when you need context you don't already have. Session-start recall is handled automatically - do not call at turn 1 unless you need extra context beyond the injected summary.
+
+Parameters:
+- `query` (required): semantic search string
+- `limit`: max results (default 10)
+- `context`: `"default"` (semantic+vector) or `"session-start"` (fast bootstrap)
+- `since`: lower date bound - only entries newer than this (ISO or relative, e.g. `"7d"`, `"2026-01-01"`)
+- `until`: upper date bound - only entries older than this ceiling (e.g. `"7d"` = entries created before 7 days ago). Use with `since` for a date window.
+- `types`: comma-separated entry types (`fact,decision,preference,todo,lesson,event`)
+- `platform`: filter by platform (`openclaw`, `claude-code`, `codex`)
+- `project`: filter by project scope (pass `*` for all projects)
+
+## agenr_retire
+
+Soft-deletes an entry. Use when something is outdated, wrong, or superseded. Pass `entry_id` (from recall results) and optionally `reason` and `persist: true` to write to the retirements ledger.
+
+## agenr_extract
+
+Extracts structured knowledge entries from raw text without storing them. Useful for previewing what would be stored from a block of text before committing.