clawvault 2.6.0 → 3.0.0

package/openclaw.plugin.json

@@ -0,0 +1,56 @@
+{
+  "id": "clawvault",
+  "kind": "memory",
+  "uiHints": {
+    "vaultPath": {
+      "label": "Vault Path",
+      "placeholder": "~/clawvault",
+      "help": "Path to your ClawVault vault directory"
+    },
+    "collection": {
+      "label": "QMD Collection",
+      "placeholder": "clawvault",
+      "help": "Name of the qmd search collection",
+      "advanced": true
+    },
+    "autoRecall": {
+      "label": "Auto-Recall",
+      "help": "Automatically inject relevant memories before each agent turn"
+    },
+    "autoCapture": {
+      "label": "Auto-Capture",
+      "help": "Automatically observe and capture important information from conversations"
+    },
+    "recallLimit": {
+      "label": "Recall Limit",
+      "help": "Max memories to inject per turn (default: 5)",
+      "advanced": true
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "vaultPath": {
+        "type": "string"
+      },
+      "collection": {
+        "type": "string"
+      },
+      "autoRecall": {
+        "type": "boolean",
+        "default": true
+      },
+      "autoCapture": {
+        "type": "boolean",
+        "default": true
+      },
+      "recallLimit": {
+        "type": "number",
+        "minimum": 1,
+        "maximum": 20,
+        "default": 5
+      }
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clawvault",
-  "version": "2.6.0",
-  "description": "Structured memory system for AI agents — typed storage, knowledge graph, context profiles, canvas dashboards, neural graph themes, and Obsidian-native task views. An elephant never forgets. 🐘",
+  "version": "3.0.0",
+  "description": "Structured memory system for AI agents \u2014 typed storage, knowledge graph, context profiles, canvas dashboards, neural graph themes, and Obsidian-native task views. An elephant never forgets. \ud83d\udc18",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -11,6 +11,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "import": "./dist/plugin/index.js",
+      "require": "./dist/plugin/index.cjs"
     }
   },
   "bin": {
@@ -19,17 +24,18 @@
   "files": [
     "dist",
     "bin",
-    "dashboard",
     "templates",
-    "hooks"
+    "hooks",
+    "openclaw.plugin.json"
   ],
   "openclaw": {
     "hooks": [
       "./hooks/clawvault"
-    ]
+    ],
+    "plugin": "./openclaw.plugin.json"
   },
   "scripts": {
-    "build": "tsup src/commands/archive.ts src/commands/backlog.ts src/commands/blocked.ts src/commands/canvas.ts src/commands/checkpoint.ts src/commands/compat.ts src/commands/context.ts src/commands/doctor.ts src/commands/embed.ts src/commands/entities.ts src/commands/graph.ts src/commands/inject.ts src/commands/kanban.ts src/commands/link.ts src/commands/migrate-observations.ts src/commands/observe.ts src/commands/project.ts src/commands/rebuild.ts src/commands/recover.ts src/commands/reflect.ts src/commands/repair-session.ts src/commands/replay.ts src/commands/session-recap.ts src/commands/setup.ts src/commands/shell-init.ts src/commands/sleep.ts src/commands/status.ts src/commands/sync-bd.ts src/commands/tailscale.ts src/commands/task.ts src/commands/template.ts src/commands/wake.ts src/cli/index.ts src/index.ts src/lib/auto-linker.ts src/lib/canvas-layout.ts src/lib/config.ts src/lib/entity-index.ts src/lib/project-utils.ts src/lib/session-repair.ts src/lib/session-utils.ts src/lib/tailscale.ts src/lib/task-utils.ts src/lib/template-engine.ts src/lib/webdav.ts --format esm --dts --clean",
+    "build": "tsup src/commands/archive.ts src/commands/backlog.ts src/commands/blocked.ts src/commands/checkpoint.ts src/commands/compat.ts src/commands/context.ts src/commands/doctor.ts src/commands/embed.ts src/commands/entities.ts src/commands/graph.ts src/commands/inject.ts src/commands/kanban.ts src/commands/link.ts src/commands/migrate-observations.ts src/commands/observe.ts src/commands/project.ts src/commands/rebuild.ts src/commands/recover.ts src/commands/reflect.ts src/commands/repair-session.ts src/commands/replay.ts src/commands/session-recap.ts src/commands/setup.ts src/commands/shell-init.ts src/commands/sleep.ts src/commands/status.ts src/commands/tailscale.ts src/commands/task.ts src/commands/template.ts src/commands/wake.ts src/cli/index.ts src/index.ts src/lib/auto-linker.ts src/lib/canvas-layout.ts src/lib/config.ts src/lib/entity-index.ts src/lib/project-utils.ts src/lib/session-repair.ts src/lib/session-utils.ts src/lib/tailscale.ts src/lib/task-utils.ts src/lib/template-engine.ts src/lib/webdav.ts src/plugin/index.ts src/plugin/types.ts src/plugin/vault.ts src/plugin/observe.ts src/plugin/inject.ts src/plugin/templates.ts --format esm,cjs --dts --clean",
     "dev": "tsup src/index.ts src/commands/*.ts src/lib/*.ts --format esm --dts --watch",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",
@@ -65,6 +71,7 @@
     "node": ">=18"
   },
   "dependencies": {
+    "@sinclair/typebox": "^0.34.48",
     "chalk": "^5.3.0",
     "chokidar": "^5.0.0",
     "commander": "^12.0.0",
@@ -90,5 +97,8 @@
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^1.2.0"
-  }
+  },
+  "workspaces": [
+    "packages/*"
+  ]
 }

package/templates/memory-event.md

@@ -0,0 +1,67 @@
+---
+primitive: memory_event
+description: Canonical schema for append-only observer memory events.
+fields:
+  type:
+    type: string
+    required: true
+    default: memory_event
+    description: Primitive discriminator for memory events.
+  status:
+    type: string
+    required: true
+    default: recorded
+    enum:
+      - recorded
+      - superseded
+      - corrected
+    description: Memory event lifecycle state.
+  created:
+    type: datetime
+    required: true
+    default: "{{datetime}}"
+    description: Event ingestion timestamp.
+  observed_at:
+    type: datetime
+    required: true
+    description: Source session timestamp for observed behavior.
+  source:
+    type: string
+    required: true
+    enum:
+      - openclaw
+      - claude-code
+      - replay
+      - manual-correction
+    description: Event source channel.
+  session_id:
+    type: string
+    description: Runtime session identifier.
+  continuity_event:
+    type: string
+    enum:
+      - none
+      - new
+      - reset
+    default: none
+    description: Continuity marker for /new or /reset transitions.
+  confidence:
+    type: number
+    description: Confidence score for extracted event.
+  importance:
+    type: number
+    description: Importance score used by promotion and retrieval.
+  run_id:
+    type: string
+    description: Related run primitive identifier.
+  summary:
+    type: string
+    required: true
+    description: Structured summary of the observed memory event.
+---
+
+# {{title}}
+
+{{links_line}}
+
+{{content}}

package/templates/party.md

@@ -0,0 +1,63 @@
+---
+primitive: party
+description: Canonical schema for parties (humans, agents, systems).
+fields:
+  type:
+    type: string
+    required: true
+    default: party
+    description: Primitive discriminator for party documents.
+  status:
+    type: string
+    required: true
+    default: active
+    enum:
+      - active
+      - inactive
+      - archived
+    description: Party lifecycle state.
+  created:
+    type: datetime
+    required: true
+    default: "{{datetime}}"
+    description: ISO timestamp when party was added.
+  updated:
+    type: datetime
+    required: true
+    default: "{{datetime}}"
+    description: ISO timestamp of the latest update.
+  party_type:
+    type: string
+    required: true
+    enum:
+      - human
+      - agent
+      - runtime
+      - service
+    description: Role classification.
+  handle:
+    type: string
+    required: true
+    description: Primary identifier for routing and ownership.
+  owner:
+    type: string
+    description: Owner or steward for this party entry.
+  capabilities:
+    type: string[]
+    description: Capability tags used for assignment.
+  runtime:
+    type: string
+    description: Runtime name when party_type is agent/runtime.
+  policy_profile:
+    type: string
+    description: Policy profile applied to this party.
+  description:
+    type: string
+    description: One-line party summary.
+---
+
+# {{title}}
+
+{{links_line}}
+
+{{content}}