pi-vault-mind 0.16.19 → 0.16.21

package/agents/personalization.agent.md

@@ -0,0 +1,31 @@
+---
+type: PersonalizationAgent
+role: personalization
+capabilities: [read, write, edit]
+allowed_tools: [read, write, edit]
+write_collections: []
+can_publish: false
+llm_provider: ollama
+---
+
+# Personalization Agent
+
+Resolves user comments and annotations on personalized agent files
+(.pi/agent/system.md and AGENTS.md). Invoked via @agent-personalization
+in chat after the user has reviewed and annotated proposed personalization
+changes.
+
+## Capability Boundary
+
+- **MAY**: read, write, and edit .pi/agent/system.md and AGENTS.md
+- **MUST NOT**: modify any other files
+- **MUST NOT**: run bash commands
+- **MUST NOT**: publish to the human-facing vault
+- **MUST NOT**: spawn sub-agents
+
+## Workflow
+
+1. User runs personalization, reviews proposed changes
+2. User opens files in editor, adds comments/annotations
+3. User types @agent-personalization in chat with instructions
+4. Agent reads the annotated files, resolves comments, writes updates

package/dist/src/agents/PersonalizationAgent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PersonalizationAgent — resolves user comments on personalized agent files.
+ *
+ * After personalization proposes changes to .pi/agent/system.md and AGENTS.md,
+ * the user can open those files in the editor, add comments/annotations, and
+ * then invoke @agent-personalization in chat to have this agent resolve them.
+ */
+import { Agent, type AgentConfig } from "../agent-bus/Agent.js";
+import type { LLMProvider } from "../agent-bus/LLMProvider.js";
+import type { Message, MessageBus } from "../agent-bus/MessageBus.js";
+export declare class PersonalizationAgent extends Agent {
+    constructor(config: AgentConfig, bus: MessageBus, llm?: LLMProvider);
+    tick(): Promise<void>;
+    protected handleMessage(msg: Message): Promise<void>;
+}

package/dist/src/agents/PersonalizationAgent.js

@@ -0,0 +1,66 @@
+/**
+ * PersonalizationAgent — resolves user comments on personalized agent files.
+ *
+ * After personalization proposes changes to .pi/agent/system.md and AGENTS.md,
+ * the user can open those files in the editor, add comments/annotations, and
+ * then invoke @agent-personalization in chat to have this agent resolve them.
+ */
+import { Agent } from "../agent-bus/Agent.js";
+export class PersonalizationAgent extends Agent {
+    constructor(config, bus, llm) {
+        super(config, bus, llm);
+    }
+    async tick() {
+        // Event-driven agent — no polling loop needed.
+    }
+    async handleMessage(msg) {
+        if (!this.llm) {
+            await this.bus.publish(`direct:${msg.senderId}`, this.config.id, {
+                type: "personalization_result",
+                dispatchId: msg.payload.dispatchId,
+                agentId: this.config.id,
+                status: "failed",
+                error: "No LLM provider configured for PersonalizationAgent",
+            });
+            return;
+        }
+        try {
+            const instruction = msg.payload.instruction;
+            const plan = await this.askLLM(`You are the Personalization agent. Resolve user comments in personalized agent files.
+
+The user has reviewed proposed personalization changes and added comments/annotations.
+Read the current state of .pi/agent/system.md and AGENTS.md, resolve any user comments,
+and return updated content for each file that needs changes.
+
+Instructions: ${instruction}
+
+Return JSON: { "files": [{"path": "...", "action": "update"|"skip", "content": "..."}] }`);
+            if (plan?.files) {
+                for (const file of plan.files) {
+                    if (file.action === "update") {
+                        await this.invokePiTool("write", {
+                            file_path: file.path,
+                            content: file.content,
+                        });
+                    }
+                }
+            }
+            await this.bus.publish(`direct:${msg.senderId}`, this.config.id, {
+                type: "personalization_result",
+                dispatchId: msg.payload.dispatchId,
+                agentId: this.config.id,
+                status: "done",
+            });
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            await this.bus.publish(`direct:${msg.senderId}`, this.config.id, {
+                type: "personalization_result",
+                dispatchId: msg.payload.dispatchId,
+                agentId: this.config.id,
+                status: "failed",
+                error: errorMsg,
+            });
+        }
+    }
+}

package/dist/src/agents/index.d.ts

@@ -2,3 +2,4 @@ export { BroadcasterAgent } from "./BroadcasterAgent.js";
 export { type DispatchJob, HeavyLifterAgent } from "./HeavyLifterAgent.js";
 export { ManagerAgent } from "./ManagerAgent.js";
 export { MinerAgent } from "./MinerAgent.js";
+export { PersonalizationAgent } from "./PersonalizationAgent.js";

package/dist/src/agents/index.js

@@ -2,3 +2,4 @@ export { BroadcasterAgent } from "./BroadcasterAgent.js";
 export { HeavyLifterAgent } from "./HeavyLifterAgent.js";
 export { ManagerAgent } from "./ManagerAgent.js";
 export { MinerAgent } from "./MinerAgent.js";
+export { PersonalizationAgent } from "./PersonalizationAgent.js";

package/dist/src/engine.js

@@ -14,7 +14,7 @@ import * as path from "node:path";
 import { AgentLoader } from "./agent-bus/AgentLoader.js";
 import { AgentRegistry } from "./agent-bus/AgentRegistry.js";
 import { AgentModelProvider } from "./agent-bus/LLMProvider.js";
-import { BroadcasterAgent, HeavyLifterAgent, ManagerAgent, MinerAgent } from "./agents/index.js";
+import { BroadcasterAgent, HeavyLifterAgent, ManagerAgent, MinerAgent, PersonalizationAgent, } from "./agents/index.js";
 import { registerAgentIdentity } from "./bridge.js";
 import { EXT_ROOT, loadConfig, resolveVaultFolder } from "./utils.js";
 // ── Agent registry setup ─────────────────────────────────────────────────────
@@ -24,6 +24,7 @@ export function registerAgentTypes() {
     AgentRegistry.register("MinerAgent", MinerAgent);
     AgentRegistry.register("BroadcasterAgent", BroadcasterAgent);
     AgentRegistry.register("ManagerAgent", ManagerAgent);
+    AgentRegistry.register("PersonalizationAgent", PersonalizationAgent);
 }
 /**
  * Create and start the agent engine.

package/dist/src/personalize.js

@@ -3,6 +3,7 @@ import * as path from "node:path";
 import { parseFrontmatter } from "@earendil-works/pi-coding-agent";
 import { enableACM } from "./context-capture.js";
 import { getStatus } from "./lance.js";
+import { scaffoldVaultConfig } from "./scaffold.js";
 import { expandHome, getPersonalizedMarkerPath, hasPiContextTools, isPersonalized, loadConfig, resolveAgentDir, } from "./utils.js";
 class PersonalizationCancelledError extends Error {
     constructor() {
@@ -620,13 +621,14 @@ export const runPersonalize = async (ctx, pi) => {
         throwIfPersonalizationCancelled(signal);
         const result = await presentAndApplyDiff(suggestions, ctx, currentConfig, signal);
         throwIfPersonalizationCancelled(signal);
+        // Scaffold collections and injectors before marking complete
+        throwIfPersonalizationCancelled(signal);
+        scaffoldVaultConfig(vaultPath);
         const markerPath = getPersonalizedMarkerPath(vaultPath);
         throwIfPersonalizationCancelled(signal);
         await fs.promises.mkdir(path.dirname(markerPath), { recursive: true });
         throwIfPersonalizationCancelled(signal);
-        // The durable marker is the personalization commit point. Keep the final
-        // abort check and synchronous write in one event-loop turn so cancellation
-        // cannot report an aborted run after the marker has been committed.
+        // The durable marker is the personalization commit point.
         fs.writeFileSync(markerPath, JSON.stringify({ completed: true, completedAt: new Date().toISOString() }, null, 2));
         const sessionCfg = loadConfig(ctx.cwd);
         const piCtxCfg = sessionCfg.extensionCompatibility?.["pi-context"];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-vault-mind",
-	"version": "0.16.19",
+	"version": "0.16.21",
 	"description": "Passive Obsidian vault extension for pi. Watches @agent markers, dispatches forked subagents (Miner, Broadcaster, Heavy-Lifter), stores in LanceDB with vector + FTS + graph. Multi-agent 'Drop & Forget' workflow for the pi agent ecosystem.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",