@christopherlittle51/postclaw 1.3.1 → 1.3.4

package/dist/dashboard/routes/workspace.js

@@ -2,20 +2,21 @@
 /**
  * Dashboard API Routes — Workspace & agent endpoints.
  *
- * GET /api/agents                      — List agents
- * GET /api/workspace-files             — List .md files from workspace dir
- * GET /api/workspace-files/:filename   — Read workspace .md file content
+ * GET  /api/agents                      — List agents
+ * GET  /api/workspace-files             — List .md files from workspace dir
+ * GET  /api/workspace-files/:filename   — Read workspace .md file content
+ * POST /api/workspace-import            — LLM-powered import of .md file as persona or memory
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerWorkspaceRoutes = registerWorkspaceRoutes;
 const helpers_js_1 = require("../helpers.js");
 const db_js_1 = require("../../services/db.js");
+const memoryService_js_1 = require("../../services/memoryService.js");
+const llm_js_1 = require("../../services/llm.js");
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
-// =============================================================================
-// CONFIG — workspace directory (set during startup)
-// =============================================================================
-// Workspace directory is now stored in the database per agent.
+const zod_1 = require("zod");
+const validation_js_1 = require("../../schemas/validation.js");
 // =============================================================================
 // REGISTER ROUTES
 // =============================================================================
@@ -78,5 +79,116 @@ function registerWorkspaceRoutes(router) {
             (0, helpers_js_1.sendError)(res, 404, `File not found in workspace`);
         }
     });
+    // WORKSPACE IMPORT — LLM-powered import of .md file as persona entries or memory chunks
+    router.post("/api/workspace-import", async (req, res, ctx) => {
+        const agentId = ctx.query.agentId || "main";
+        const body = await (0, helpers_js_1.parseBody)(req);
+        if (!body)
+            return (0, helpers_js_1.sendError)(res, 400, "Invalid JSON body");
+        try {
+            const data = validation_js_1.WorkspaceImportSchema.parse(body);
+            const sql = (0, db_js_1.getSql)();
+            // Read the workspace file
+            const agents = await sql `SELECT workspace_dir FROM agents WHERE id = ${agentId}`;
+            const workspaceDir = agents[0]?.workspace_dir;
+            if (!workspaceDir) {
+                return (0, helpers_js_1.sendError)(res, 400, "Workspace directory not configured for this agent");
+            }
+            // Security check
+            if (data.filename.includes("..") || data.filename.includes("/")) {
+                return (0, helpers_js_1.sendError)(res, 400, "No path traversal allowed");
+            }
+            const markdownText = await (0, promises_1.readFile)((0, node_path_1.join)(workspaceDir, data.filename), "utf-8");
+            await (0, memoryService_js_1.ensureAgent)(agentId);
+            if (data.target === "persona") {
+                // Use LLM to semantically chunk into persona entries (same as bootstrap_persona.ts)
+                const systemPrompt = `You are an expert data architect. Break down this Markdown file into discrete, atomic semantic chunks.
+Extract the core rules, behaviors, and instructions.
+
+Output your response EXCLUSIVELY as a raw JSON array of objects. Do not use markdown blocks.
+Each object must have:
+- "category": A short, unique identifier for this rule (max 50 chars, e.g., "communication_style", "discord_rules").
+- "content": The actual text of the rule or instruction.
+- "is_always_active": Boolean. Set to true ONLY for core identity traits that must be injected into every prompt. Set to false if situational.`;
+                const combined = `${systemPrompt}\n\nHere is the file to chunk:\n\n${markdownText}`;
+                const jsonString = await (0, llm_js_1.callLLMviaAgent)(combined, agentId);
+                let chunks;
+                try {
+                    chunks = zod_1.z.array(validation_js_1.PersonaChunkSchema).parse(JSON.parse(jsonString));
+                }
+                catch {
+                    return (0, helpers_js_1.sendError)(res, 500, "LLM returned invalid persona chunks");
+                }
+                let stored = 0;
+                for (const chunk of chunks) {
+                    try {
+                        const embedding = await (0, db_js_1.getEmbedding)(chunk.content);
+                        await sql.begin(async (tx) => {
+                            await tx `SELECT set_config('app.current_agent_id', ${agentId}, true)`;
+                            await tx `
+                INSERT INTO agent_persona (
+                  agent_id, access_scope, category, content, is_always_active, embedding
+                ) VALUES (
+                  ${agentId}, 'private', ${chunk.category}, ${chunk.content},
+                  ${chunk.is_always_active}, ${JSON.stringify(embedding)}
+                )
+                ON CONFLICT (agent_id, category)
+                DO UPDATE SET
+                  content = EXCLUDED.content,
+                  embedding = EXCLUDED.embedding,
+                  is_always_active = EXCLUDED.is_always_active
+              `;
+                        });
+                        stored++;
+                    }
+                    catch (err) {
+                        console.error(`[IMPORT] Failed to store persona "${chunk.category}":`, err);
+                    }
+                }
+                (0, helpers_js_1.sendJson)(res, 201, {
+                    ok: true,
+                    data: { target: "persona", imported: stored, total: chunks.length, filename: data.filename },
+                });
+            }
+            else {
+                // Memory target: use LLM to extract durable facts
+                const systemPrompt = `You are a knowledge extraction expert. Extract discrete, atomic facts from this Markdown file.
+Each fact should be a standalone piece of knowledge that is worth remembering.
+
+Output your response EXCLUSIVELY as a raw JSON array of strings. Do not use markdown blocks.
+Each string should be a single fact or piece of knowledge.`;
+                const combined = `${systemPrompt}\n\nHere is the file:\n\n${markdownText}`;
+                const jsonString = await (0, llm_js_1.callLLMviaAgent)(combined, agentId);
+                let facts;
+                try {
+                    facts = zod_1.z.array(zod_1.z.string().min(1)).parse(JSON.parse(jsonString));
+                }
+                catch {
+                    return (0, helpers_js_1.sendError)(res, 500, "LLM returned invalid memory facts");
+                }
+                const results = [];
+                for (const fact of facts) {
+                    const result = await (0, memoryService_js_1.storeMemory)(agentId, fact, "private", {
+                        tier: data.tier,
+                        source_uri: data.filename,
+                        category: "imported",
+                    });
+                    results.push(result);
+                }
+                (0, helpers_js_1.sendJson)(res, 201, {
+                    ok: true,
+                    data: {
+                        target: "memory",
+                        imported: results.filter((r) => r.status === "stored").length,
+                        total: facts.length,
+                        filename: data.filename,
+                    },
+                });
+            }
+        }
+        catch (err) {
+            (0, helpers_js_1.sendError)(res, 500, err instanceof Error ? err.message : "Import failed");
+        }
+    });
 }
 //# sourceMappingURL=workspace.js.map

package/dist/dashboard/routes/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../dashboard/routes/workspace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../dashboard/routes/workspace.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/server.js

@@ -48,7 +48,7 @@ function startDashboard(opts = {}) {
     // Static files are NOT compiled by tsc — they live in dashboard/public/
     const projectRoot = (0, node_path_1.join)((0, node_path_1.dirname)(__filename), "..", "..");
     const publicDir = (0, node_path_1.join)(projectRoot, "dashboard", "public");
-    const ambientDir = (0, node_path_1.join)(projectRoot, "node_modules", "@ambientcss", "css");
+    const ambientDir = (0, node_path_1.join)(projectRoot, "node_modules", "@ambientcss", "css", "dist");
     _server = (0, node_http_1.createServer)(async (req, res) => {
         const url = req.url || "/";
         const pathname = url.split("?")[0];

package/dist/dashboard/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../dashboard/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../dashboard/server.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { getSql, LM_STUDIO_URL, POSTCLAW_DB_URL, EMBEDDING_MODEL, getEmbedding, hashContent, setEmbeddingConfig, setDbUrl } from "./services/db.js";
+export { getSql, LM_STUDIO_URL, POSTCLAW_DB_URL, EMBEDDING_MODEL, getEmbedding, hashContent, setEmbeddingConfig, setDbUrl, validateEmbeddingDimension } from "./services/db.js";
 export { ensureAgent, searchPostgres, logEpisodicMemory, logEpisodicToolCall, fetchPersonaContext, storeMemory, updateMemory, linkMemories } from "./services/memoryService.js";
 export { listPersonas, getPersona, createPersona, updatePersona, deletePersona } from "./services/personaService.js";
 export type { ChatMessage, ContentPart, ToolCallRecord } from "./schemas/validation.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpJ,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChL,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAoBrH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAgDxF,QAAA,MAAM,sBAAsB;;;;kBAKZ,GAAG;CA2lBlB,CAAC;AAEF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAChL,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChL,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAoBrH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAgDxF,QAAA,MAAM,sBAAsB;;;;kBAKZ,GAAG;CAovBlB,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/index.js

@@ -3,7 +3,7 @@
 // RE-EXPORTS — Single entry point for downstream consumers
 // =============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deletePersona = exports.updatePersona = exports.createPersona = exports.getPersona = exports.listPersonas = exports.linkMemories = exports.updateMemory = exports.storeMemory = exports.fetchPersonaContext = exports.logEpisodicToolCall = exports.logEpisodicMemory = exports.searchPostgres = exports.ensureAgent = exports.setDbUrl = exports.setEmbeddingConfig = exports.hashContent = exports.getEmbedding = exports.EMBEDDING_MODEL = exports.POSTCLAW_DB_URL = exports.LM_STUDIO_URL = exports.getSql = void 0;
+exports.deletePersona = exports.updatePersona = exports.createPersona = exports.getPersona = exports.listPersonas = exports.linkMemories = exports.updateMemory = exports.storeMemory = exports.fetchPersonaContext = exports.logEpisodicToolCall = exports.logEpisodicMemory = exports.searchPostgres = exports.ensureAgent = exports.validateEmbeddingDimension = exports.setDbUrl = exports.setEmbeddingConfig = exports.hashContent = exports.getEmbedding = exports.EMBEDDING_MODEL = exports.POSTCLAW_DB_URL = exports.LM_STUDIO_URL = exports.getSql = void 0;
 var db_js_1 = require("./services/db.js");
 Object.defineProperty(exports, "getSql", { enumerable: true, get: function () { return db_js_1.getSql; } });
 Object.defineProperty(exports, "LM_STUDIO_URL", { enumerable: true, get: function () { return db_js_1.LM_STUDIO_URL; } });
@@ -13,6 +13,7 @@ Object.defineProperty(exports, "getEmbedding", { enumerable: true, get: function
 Object.defineProperty(exports, "hashContent", { enumerable: true, get: function () { return db_js_1.hashContent; } });
 Object.defineProperty(exports, "setEmbeddingConfig", { enumerable: true, get: function () { return db_js_1.setEmbeddingConfig; } });
 Object.defineProperty(exports, "setDbUrl", { enumerable: true, get: function () { return db_js_1.setDbUrl; } });
+Object.defineProperty(exports, "validateEmbeddingDimension", { enumerable: true, get: function () { return db_js_1.validateEmbeddingDimension; } });
 var memoryService_js_1 = require("./services/memoryService.js");
 Object.defineProperty(exports, "ensureAgent", { enumerable: true, get: function () { return memoryService_js_1.ensureAgent; } });
 Object.defineProperty(exports, "searchPostgres", { enumerable: true, get: function () { return memoryService_js_1.searchPostgres; } });
@@ -82,6 +83,11 @@ const openclawPostgresPlugin = {
         console.log("[PostClaw] Registering plugin hooks...");
         // Apply database URL from plugin config (plugins.entries.postclaw.config.dbUrl)
         const pluginConfig = api.config?.plugins?.entries?.postclaw?.config;
+        const debugLogging = pluginConfig?.debugLogging === true;
+        const debugLog = (...args) => {
+            if (debugLogging)
+                console.log("[PostClaw DEBUG]", ...args);
+        };
         if (pluginConfig?.dbUrl) {
             (0, db_js_3.setDbUrl)(pluginConfig.dbUrl);
             console.log("[PostClaw] Database URL configured via plugin config");
@@ -96,6 +102,12 @@ const openclawPostgresPlugin = {
         (0, memoryService_js_2.ensureAgent)(agentId, workspaceDir).then(() => {
             (0, config_js_1.loadConfig)(agentId).then(() => {
                 console.log("[PostClaw] Configuration loaded successfully");
+                // Verify that the configured embedding model dimensions match the schema
+                import("./services/db.js").then(({ validateEmbeddingDimension }) => {
+                    validateEmbeddingDimension(agentId).catch((err) => {
+                        console.error("[PostClaw] Failed initial embedding validation check:", err);
+                    });
+                });
             });
         });
         // -------------------------------------------------------------------------
@@ -117,6 +129,8 @@ const openclawPostgresPlugin = {
         // -------------------------------------------------------------------------
         api.on("before_prompt_build", async (event, ctx) => {
             try {
+                debugLog("before_prompt_build event:", JSON.stringify(event, null, 2));
+                debugLog("before_prompt_build ctx:", JSON.stringify(ctx, null, 2));
                 const messages = event.messages ?? [];
                 const userText = lastReceivedMessage || extractUserText(messages);
                 lastReceivedMessage = ""; // consume once — prevent stale leak into heartbeats
@@ -170,7 +184,8 @@ const openclawPostgresPlugin = {
                         hasUserText ? (0, memoryService_js_2.searchPostgres)(agentId, cleanText, {
                             semanticLimit: config.rag.semanticLimit,
                             linkedSimilarity: config.rag.linkedSimilarity,
-                            totalLimit: config.rag.totalLimit
+                            totalLimit: config.rag.totalLimit,
+                            trackAs: "injection"
                         }) : Promise.resolve(null),
                         // Persona: always fetch (core rules work without embedding)
                         (0, memoryService_js_2.fetchPersonaContext)(agentId, embedding, {
@@ -215,12 +230,17 @@ const openclawPostgresPlugin = {
         // --- memory_search: Semantic search across stored memories ---
         api.registerTool({
             name: "memory_search",
-            description: "Search the agent's long-term semantic memory using natural language. Returns the most relevant stored facts and their UUIDs.",
+            description: `Search the agent's long-term semantic memory using natural language. Returns the most relevant stored facts with their UUIDs and metadata.
+
+Each result includes: id (UUID), content, category, tier (permanent/stable/daily/session/volatile), volatility (low/medium/high), confidence (0.0–1.0), usefulness_score, access_count, injection_count, is_pointer, is_archived, metadata (JSON), created_at, updated_at, and expires_at.
+
+Results also include graph-linked memories discovered via multi-hop traversal of the entity_edges knowledge graph. Linked results include persona↔memory cross-links.`,
             parameters: typebox_1.Type.Object({
-                query: typebox_1.Type.String({ description: "Natural language search query" }),
+                query: typebox_1.Type.String({ description: "Natural language search query. Be specific — this drives vector cosine similarity matching against stored memory embeddings." }),
             }),
             async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
-                const agentId = ctx?.agentId || "main";
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("memory_search mapped agentId:", agentId);
                 await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
                 const config = (0, config_js_1.getCurrentConfig)();
                 const result = await (0, memoryService_js_2.searchPostgres)(agentId, args.query, {
@@ -234,17 +254,47 @@ const openclawPostgresPlugin = {
         // --- memory_store: Save a new durable fact ---
         api.registerTool({
             name: "memory_store",
-            description: "Store a new durable fact. You can categorize it, set volatility, and add metadata.",
+            description: `Store a new durable fact in the semantic memory database. Each memory is embedded as a vector for similarity search and can be linked in the knowledge graph.
+
+Columns you control:
+- content: The fact text (required). Will be embedded for vector search.
+- category: Short tag for grouping (e.g. 'preference', 'project_detail', 'family_details', 'technical', 'behavioral_rule'). Used for filtering.
+- tier: Permanence level. 'permanent' = never auto-archived. 'stable' = protected from low-value cleanup. 'daily' = standard. 'session' = current session only. 'volatile' = may be cleaned up quickly.
+- volatility: Expected change rate. 'low' = stable facts (names, dates). 'medium' = may change (preferences, statuses). 'high' = frequently changing (moods, temporary states). Affects sleep cycle scoring.
+- metadata: JSON object for additional context (e.g. {"source": "user_stated", "topic": "birthday"}).
+- confidence: Your confidence in the fact (0.0 to 1.0). Default is 0.5.
+- usefulness_score: How useful this fact is for future inference. Default is 0.0.
+- expires_at: For volatile or session-tied facts, the ISO timestamp when it should be archived.
+- scope: The access scope: 'private' (this agent only), 'shared' (accessible by some other agents in the same circle), or 'global' (accessible by all agents on the system).
+
+Auto-managed columns (do not set): access_count, injection_count, is_pointer, content_hash, embedding, token_count.`,
             parameters: typebox_1.Type.Object({
-                content: typebox_1.Type.String({ description: "The fact or knowledge to store" }),
-                scope: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("private"), typebox_1.Type.Literal("shared"), typebox_1.Type.Literal("global")], { default: "private" })),
-                category: typebox_1.Type.Optional(typebox_1.Type.String({ description: "A short categorical tag (e.g., 'preference', 'project_detail')" })),
-                volatility: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("low"), typebox_1.Type.Literal("medium"), typebox_1.Type.Literal("high")], { default: "low" })),
-                tier: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("volatile"), typebox_1.Type.Literal("session"), typebox_1.Type.Literal("daily"), typebox_1.Type.Literal("stable"), typebox_1.Type.Literal("permanent")], { default: "daily" })),
-                metadata: typebox_1.Type.Optional(typebox_1.Type.Any({ description: "A JSON object of additional contextual key-value pairs" }))
+                content: typebox_1.Type.String({ description: "The fact or knowledge to store. Should be a clear, self-contained statement." }),
+                scope: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("private"), typebox_1.Type.Literal("shared"), typebox_1.Type.Literal("global")], { default: "private", description: "Who can access this memory. Use 'private' for agent-specific data, 'shared' for circle data, or 'global' for facts all agents should know." })),
+                category: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Short categorical tag for grouping and filtering (e.g. 'preference', 'project_detail'). Memories without categories are harder to filter." })),
+                source_uri: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Optional URL or resource URI to trace the origin of the memory." })),
+                volatility: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("low"), typebox_1.Type.Literal("medium"), typebox_1.Type.Literal("high")], { default: "low", description: "Expected change rate for facts: 'low' for stable, 'high' for temporary state." })),
+                is_pointer: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: "Whether this memory is merely a soft pointer to external knowledge. Defaults to false." })),
+                embedding_model: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Optional override for the model used to embed this semantic value." })),
+                tier: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("volatile"), typebox_1.Type.Literal("session"), typebox_1.Type.Literal("daily"), typebox_1.Type.Literal("stable"), typebox_1.Type.Literal("permanent")], { default: "daily", description: "Permanence level. 'permanent' and 'stable' are protected from automatic archival." })),
+                confidence: typebox_1.Type.Optional(typebox_1.Type.Number({ description: "Your confidence in the fact (0.0 to 1.0). Default is 0.5." })),
+                usefulness_score: typebox_1.Type.Optional(typebox_1.Type.Number({ description: "Tracker for inference usefulness. Default is 0.0." })),
+                injection_count: typebox_1.Type.Optional(typebox_1.Type.Integer({ description: "Override auto-tracked injection count." })),
+                access_count: typebox_1.Type.Optional(typebox_1.Type.Integer({ description: "Override auto-tracked access count." })),
+                last_injected_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Timestamp of last injection (ISO string)." })),
+                last_accessed_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Timestamp of last access (ISO string)." })),
+                expires_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Optional expiration timestamp (ISO string) for volatile memories." })),
+                created_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Timestamp of creation (ISO string)." })),
+                updated_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Timestamp of last update (ISO string)." })),
+                is_archived: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: "Whether the memory is considered archived/inactive. Defaults to false." })),
+                superseded_by: typebox_1.Type.Optional(typebox_1.Type.String({ description: "UUID pointer to a memory replacing this one." })),
+                metadata: typebox_1.Type.Optional(typebox_1.Type.Any({ description: "JSON object of additional context (e.g. {source: 'user_stated', topic: 'birthday', related_to: 'family'}). Stored as JSONB for flexible querying." }))
             }),
             async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
-                const agentId = ctx?.agentId || "main";
+                debugLog("memory_store args:", JSON.stringify(args, null, 2));
+                debugLog("memory_store ctx (from execute params):", JSON.stringify(ctx, null, 2));
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("memory_store mapped agentId:", agentId);
                 await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
                 const { content, scope, ...options } = args;
                 const result = await (0, memoryService_js_2.storeMemory)(agentId, content, scope, options);
@@ -254,34 +304,72 @@ const openclawPostgresPlugin = {
         // --- memory_update: Supersede an old fact with a corrected one ---
         api.registerTool({
             name: "memory_update",
-            description: "Correct or update an existing memory. Archives the old fact and creates a new one with a causal chain link. You can assign categories, volatility, and metadata.",
+            description: `Correct or update an existing memory. Archives the old fact (sets is_archived=true, superseded_by=new_id) and creates a fresh memory with the corrected content, preserving the causal chain.
+
+The new memory inherits nothing from the old one — you must re-specify category, tier, volatility, metadata, and scope. The old memory remains searchable if you query archived content but won't appear in normal retrieval.
+
+Columns you can modify:
+- new_fact: The new corrected fact.
+- scope: The access scope: 'private' (this agent only), 'shared', or 'global' (accessible by all agents).
+- category: Short tag for grouping (e.g. 'preference', 'project_detail').
+- tier: Permanence level. 'permanent' = never auto-archived. 'stable' = protected from low-value cleanup. 'daily' = standard. 'session' = current session. 'volatile' = quickly cleaned.
+- volatility: Expected change rate. 'low' = stable facts, 'medium' = may change, 'high' = expected to change quickly.
+- metadata: JSON object for additional context.
+- confidence: Your confidence in the fact (0.0 to 1.0). Default is 0.5.
+- usefulness_score: How useful this fact is for future inference. Default is 0.0.
+- expires_at: For volatile or session-tied facts, the ISO timestamp when it should be archived.
+
+Use this instead of memory_store when you know the UUID of the outdated fact.`,
             parameters: typebox_1.Type.Object({
-                old_memory_id: typebox_1.Type.String({ description: "UUID of the outdated memory to supersede" }),
-                new_fact: typebox_1.Type.String({ description: "The corrected or updated fact" }),
-                category: typebox_1.Type.Optional(typebox_1.Type.String({ description: "A short categorical tag (e.g., 'preference', 'project_detail')" })),
-                volatility: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("low"), typebox_1.Type.Literal("medium"), typebox_1.Type.Literal("high")], { default: "low" })),
-                tier: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("volatile"), typebox_1.Type.Literal("session"), typebox_1.Type.Literal("daily"), typebox_1.Type.Literal("stable"), typebox_1.Type.Literal("permanent")], { default: "daily" })),
-                metadata: typebox_1.Type.Optional(typebox_1.Type.Any({ description: "A JSON object of additional contextual key-value pairs" }))
+                old_memory_id: typebox_1.Type.String({ description: "UUID of the outdated memory to supersede. This memory will be archived and linked via superseded_by." }),
+                new_fact: typebox_1.Type.String({ description: "The corrected or updated fact. Will be re-embedded for vector search." }),
+                scope: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("private"), typebox_1.Type.Literal("shared"), typebox_1.Type.Literal("global")], { default: "private", description: "Who can access this memory. Use 'private' for agent-specific data, 'shared' for circle data, or 'global' for facts all agents should know." })),
+                category: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Category for the new memory (e.g. 'preference', 'project_detail'). Does NOT carry over from old memory." })),
+                source_uri: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Optional URL or resource URI to trace the origin of the memory." })),
+                volatility: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("low"), typebox_1.Type.Literal("medium"), typebox_1.Type.Literal("high")], { default: "low", description: "Expected change rate for facts: 'low' for stable, 'high' for temporary state." })),
+                is_pointer: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: "Whether this memory is merely a soft pointer to external knowledge. Defaults to false." })),
+                embedding_model: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Optional override for the model used to embed this semantic value." })),
+                tier: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("volatile"), typebox_1.Type.Literal("session"), typebox_1.Type.Literal("daily"), typebox_1.Type.Literal("stable"), typebox_1.Type.Literal("permanent")], { default: "daily", description: "Permanence level for the new memory. Set to 'permanent' for core facts that should never be auto-archived." })),
+                confidence: typebox_1.Type.Optional(typebox_1.Type.Number({ description: "Your confidence in the fact (0.0 to 1.0). Default is 0.5." })),
+                usefulness_score: typebox_1.Type.Optional(typebox_1.Type.Number({ description: "Tracker for inference usefulness. Default is 0.0." })),
+                injection_count: typebox_1.Type.Optional(typebox_1.Type.Integer({ description: "Override auto-tracked injection count." })),
+                access_count: typebox_1.Type.Optional(typebox_1.Type.Integer({ description: "Override auto-tracked access count." })),
+                last_injected_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Timestamp of last injection (ISO string)." })),
+                last_accessed_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Timestamp of last access (ISO string)." })),
+                expires_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Optional expiration timestamp (ISO string) for volatile memories." })),
+                created_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Timestamp of creation (ISO string)." })),
+                updated_at: typebox_1.Type.Optional(typebox_1.Type.String({ description: "Timestamp of last update (ISO string)." })),
+                is_archived: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: "Whether the memory is considered archived/inactive. Defaults to false." })),
+                superseded_by: typebox_1.Type.Optional(typebox_1.Type.String({ description: "UUID pointer to a memory replacing this one." })),
+                metadata: typebox_1.Type.Optional(typebox_1.Type.Any({ description: "JSON metadata for the new memory. Does NOT carry over from old memory." }))
             }),
             async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
-                const agentId = ctx?.agentId || "main";
+                debugLog("memory_update args:", JSON.stringify(args, null, 2));
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("memory_update mapped agentId:", agentId);
                 await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
-                const { old_memory_id, new_fact, ...options } = args;
-                const result = await (0, memoryService_js_2.updateMemory)(agentId, old_memory_id, new_fact, options);
+                const { old_memory_id, new_fact, scope, ...options } = args;
+                const result = await (0, memoryService_js_2.updateMemory)(agentId, old_memory_id, new_fact, scope, options);
                 return JSON.stringify(result);
             },
         }, { names: ["memory_update"] });
         // --- memory_link: Create a knowledge graph edge between two memories ---
         api.registerTool({
             name: "memory_link",
-            description: "Create a directed relationship edge between two memories in the knowledge graph.",
+            description: `Create a directed relationship edge between two nodes in the knowledge graph (entity_edges table). Links can connect memory↔memory or persona↔memory. Linked memories are discovered during RAG retrieval via multi-hop graph traversal.
+
+Relationship types: 'related_to' (general topical), 'elaborates' (B adds detail to A), 'contradicts' (B conflicts with A), 'depends_on' (B needs A), 'part_of' (B is subset of A), 'defines' (A defines context for B, typically persona→memory), 'supports' (B provides evidence for A).
+
+The edge weight defaults to 1.0. Edges are also auto-discovered during the sleep cycle, but you should create them immediately when the relationship is obvious.`,
             parameters: typebox_1.Type.Object({
-                source_id: typebox_1.Type.String({ description: "UUID of the source memory" }),
-                target_id: typebox_1.Type.String({ description: "UUID of the target memory" }),
-                relationship: typebox_1.Type.String({ description: "Relationship type (e.g. related_to, elaborates, contradicts, depends_on, part_of)" }),
+                source_id: typebox_1.Type.String({ description: "UUID of the source node (memory or persona trait)" }),
+                target_id: typebox_1.Type.String({ description: "UUID of the target node (memory or persona trait)" }),
+                relationship: typebox_1.Type.String({ description: "Relationship type: 'related_to', 'elaborates', 'contradicts', 'depends_on', 'part_of', 'defines', or 'supports'" }),
             }),
             async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
-                const agentId = ctx?.agentId || "main";
+                debugLog("memory_link args:", JSON.stringify(args, null, 2));
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("memory_link mapped agentId:", agentId);
                 await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
                 const result = await (0, memoryService_js_2.linkMemories)(agentId, args.source_id, args.target_id, args.relationship);
                 return JSON.stringify(result);
@@ -290,10 +378,15 @@ const openclawPostgresPlugin = {
         // --- persona_list: List all persona entries ---
         api.registerTool({
             name: "persona_list",
-            description: "List all persona rules for the current agent.",
+            description: `List all persona traits for the current agent from the agent_persona table.
+
+Each entry includes: id (UUID), category (unique per agent, e.g. 'core_identity', 'communication_style'), content (the rule text), is_always_active (whether injected into every prompt), embedding (vector for situational matching), and created_at.
+
+Persona traits tagged is_always_active=true are always in the system prompt. Others are selected by cosine similarity to the current user message.`,
             parameters: typebox_1.Type.Object({}),
             async execute(_toolCallId, _args, _signal, _onUpdate, ctx) {
-                const agentId = ctx?.agentId || "main";
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("persona_list mapped agentId:", agentId);
                 await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
                 const personas = await (0, personaService_js_2.listPersonas)(agentId);
                 return JSON.stringify(personas);
@@ -302,44 +395,83 @@ const openclawPostgresPlugin = {
         // --- persona_get: Get a specific persona entry ---
         api.registerTool({
             name: "persona_get",
-            description: "Get a specific persona rule by its UUID.",
+            description: "Get a specific persona trait by its UUID. Returns the full record: id, category, content, is_always_active, embedding, and created_at.",
             parameters: typebox_1.Type.Object({
                 persona_id: typebox_1.Type.String({ description: "UUID of the persona entry" }),
             }),
             async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
-                const agentId = ctx?.agentId || "main";
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("persona_get mapped agentId:", agentId);
                 await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
                 const persona = await (0, personaService_js_2.getPersona)(agentId, args.persona_id);
                 return persona ? JSON.stringify(persona) : "Persona not found.";
             },
         }, { names: ["persona_get"] });
+        // --- persona_create: Create a new persona entry ---
+        api.registerTool({
+            name: "persona_create",
+            description: `Create a new persona trait for the current agent. 
+**CRITICAL INSTRUCTION**: You must explicitly report the creation of any new persona trait to the user. Do not use this tool unless explicitly instructed or permitted by the user to do so.
+
+Each entry requires a category (must be unique per agent, e.g. 'core_identity', 'communication_style') and content (the rule text). is_always_active determines whether it is injected into every system prompt (true) or selected by cosine similarity (false).`,
+            parameters: typebox_1.Type.Object({
+                category: typebox_1.Type.String({ description: "Category name (must be unique per agent, e.g. 'core_identity', 'communication_style', 'behavioral_rule')" }),
+                content: typebox_1.Type.String({ description: "The content text of the persona rule. Will be embedded for situational matching." }),
+                is_always_active: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: "If true, this persona trait is always injected into the system prompt. If false, it is only injected when contextually relevant. Defaults to false." })),
+                scope: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("private"), typebox_1.Type.Literal("shared"), typebox_1.Type.Literal("global")], { default: "private", description: "Who can access this persona. 'private' (this agent only) or 'global' (all agents share this trait)." })),
+            }),
+            async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("persona_create mapped agentId:", agentId);
+                await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
+                try {
+                    const newPersona = await (0, personaService_js_2.createPersona)(agentId, {
+                        category: args.category,
+                        content: args.content,
+                        is_always_active: args.is_always_active ?? false,
+                        access_scope: args.scope || "private"
+                    });
+                    return JSON.stringify(newPersona);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return `Error creating persona: ${msg}`;
+                }
+            },
+        }, { names: ["persona_create"] });
         // --- persona_update: Update a persona entry ---
         api.registerTool({
             name: "persona_update",
-            description: "Update an existing persona rule. You can change the category, content, or whether it is always active.",
+            description: `Update an existing persona trait. You can change the category, content, or is_always_active flag.
+
+Changing content will re-embed the persona for situational matching. Categories are unique per agent — changing a category effectively reclassifies the trait. Setting is_always_active=true means this persona is injected into every system prompt regardless of relevance.`,
             parameters: typebox_1.Type.Object({
                 persona_id: typebox_1.Type.String({ description: "UUID of the persona entry to update" }),
-                category: typebox_1.Type.Optional(typebox_1.Type.String({ description: "New category name" })),
-                content: typebox_1.Type.Optional(typebox_1.Type.String({ description: "New content text" })),
-                is_always_active: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: "Whether this rule is always injected" })),
+                category: typebox_1.Type.Optional(typebox_1.Type.String({ description: "New category name (must be unique per agent, e.g. 'core_identity', 'communication_style', 'behavioral_rule')" })),
+                content: typebox_1.Type.Optional(typebox_1.Type.String({ description: "New content text. Will be re-embedded for situational matching." })),
+                is_always_active: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: "If true, this persona trait is always injected into the system prompt. If false, it is only injected when contextually relevant." })),
+                scope: typebox_1.Type.Optional(typebox_1.Type.Union([typebox_1.Type.Literal("private"), typebox_1.Type.Literal("shared"), typebox_1.Type.Literal("global")], { description: "Update access scope. 'private', 'shared', or 'global'." })),
             }),
             async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
-                const agentId = ctx?.agentId || "main";
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("persona_update mapped agentId:", agentId);
                 await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
-                const { persona_id, ...updates } = args;
-                const result = await (0, personaService_js_2.updatePersona)(agentId, persona_id, updates);
+                const { persona_id, scope, ...updates } = args;
+                const payload = scope ? { ...updates, access_scope: scope } : updates;
+                const result = await (0, personaService_js_2.updatePersona)(agentId, persona_id, payload);
                 return result ? JSON.stringify(result) : "Persona not found.";
             },
         }, { names: ["persona_update"] });
         // --- persona_delete: Delete a persona entry ---
         api.registerTool({
             name: "persona_delete",
-            description: "Delete a persona rule by its UUID.",
+            description: "Delete a persona trait by its UUID. This also removes any persona↔memory edges in the entity_edges knowledge graph that reference this persona.",
             parameters: typebox_1.Type.Object({
-                persona_id: typebox_1.Type.String({ description: "UUID of the persona entry to delete" }),
+                persona_id: typebox_1.Type.String({ description: "UUID of the persona entry to delete. Cascades to remove associated graph edges." }),
             }),
             async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
-                const agentId = ctx?.agentId || "main";
+                const agentId = toolCallIdToAgentId.get(_toolCallId) || ctx?.agentId || "main";
+                debugLog("persona_delete mapped agentId:", agentId);
                 await (0, memoryService_js_2.ensureAgent)(agentId, ctx?.workspaceDir);
                 const deleted = await (0, personaService_js_2.deletePersona)(agentId, args.persona_id);
                 return deleted ? '{"status": "deleted"}' : "Persona not found.";
@@ -352,8 +484,19 @@ const openclawPostgresPlugin = {
         //   event = { messages: ChatMessage[], success: boolean, error?: string, durationMs: number }
         //   ctx   = { agentId, sessionKey, sessionId, workspaceDir, messageProvider }
         // -------------------------------------------------------------------------
+        const toolCallIdToAgentId = new Map();
+        api.on("before_tool_call", async (event, ctx) => {
+            debugLog("before_tool_call event:", JSON.stringify(event, null, 2));
+            debugLog("before_tool_call ctx:", JSON.stringify(ctx, null, 2));
+            const agentId = ctx?.agentId;
+            if (agentId && event.toolCallId) {
+                toolCallIdToAgentId.set(event.toolCallId, agentId);
+            }
+        });
         api.on("agent_end", async (event, ctx) => {
             try {
+                debugLog("agent_end event:", JSON.stringify(event, null, 2));
+                debugLog("agent_end ctx:", JSON.stringify(ctx, null, 2));
                 const messages = event.messages ?? [];
                 const agentId = ctx.agentId;
                 const provider = ctx?.messageProvider ?? "";
@@ -375,6 +518,10 @@ const openclawPostgresPlugin = {
                             ? lastUser.content.filter((p) => p.type === "text").map((p) => p.text).join(" ")
                             : ""
                     : "";
+                if (userMessage.includes("[POSTCLAW_INTERNAL_LLM_CALL_DO_NOT_LOG]")) {
+                    console.log("[PostClaw] Skipped episodic logging for internal script call");
+                    return;
+                }
                 const promises = [];
                 // Log user message as episodic event
                 if (userMessage.trim()) {
@@ -556,7 +703,6 @@ const openclawPostgresPlugin = {
             import("./scripts/sleep_cycle.js").then(({ startService }) => {
                 const config = (0, config_js_1.getCurrentConfig)();
                 startService({
-                    agentId: "main",
                     intervalHours: sleepIntervalHours || 6,
                     config: config.sleep
                 });