@harperfast/agent 0.16.0 → 0.16.1

package/dist/agent.js

@@ -1148,7 +1148,23 @@ async function execute11(operation) {
     if (needed) {
       const content = await execute10({ skill: needed });
       console.error(`Understanding ${needed} is necessary before applying this patch.`);
-      return { status: "failed, skill guarded", output: content };
+      return {
+        status: "skill_required",
+        output: `apply_patch blocked: you must understand the "${needed}" skill before writing to "${operation.path}".
+
+REQUIRED NEXT STEP: Call apply_patch again with the EXACT same arguments:
+  type="${operation.type}", path="${operation.path}", diff=<same diff as before>
+
+PROHIBITED \u2014 do NOT attempt any of the following to work around this:
+  - Use the shell tool to write or create files
+  - Call set_patch_auto_approve or set_shell_auto_approve
+  - Use any other workaround
+
+Read the skill content below, then retry apply_patch immediately.
+
+--- Skill: ${needed} ---
+${content}`
+      };
     }
     switch (operation.type) {
       case "create_file":
@@ -1179,7 +1195,12 @@ async function execute11(operation) {
 function createApplyPatchTool() {
   return tool11({
     name: "apply_patch",
-    description: "Applies a patch (create, update, or delete a file) to the workspace.",
+    description: `Applies a patch (create, update, or delete a file) to the workspace.
+
+SKILL GUARD: Some file paths require reading a specific Harper skill before writing. If this tool returns status "skill_required", you MUST:
+  1. Read the skill content included in the response carefully.
+  2. Call apply_patch again with the EXACT same type, path, and diff arguments.
+Do NOT use shell, set_patch_auto_approve, set_shell_auto_approve, or any other workaround to bypass this requirement.`,
     parameters: ApplyPatchParameters,
     needsApproval,
     execute: execute11
@@ -3810,7 +3831,7 @@ async function runAgentForOnePass(agent, session, input, controller, isPrompt) {
 }
 
 // agent/AgentManager.ts
-var AgentManager = class {
+var AgentManager = class _AgentManager {
   isInitialized = false;
   controller = null;
   queuedUserInputs = [];
@@ -3818,17 +3839,20 @@ var AgentManager = class {
   agent = null;
   session = null;
   initialMessages = [];
-  async initialize() {
-    if (this.isInitialized) {
-      return;
-    }
-    this.agent = new Agent3({
+  static instantiateAgent(tools) {
+    return new Agent3({
       name: "Harper Agent",
       model: isOpenAIModel(trackedState.model) ? trackedState.model : getModel(trackedState.model),
       modelSettings: getModelSettings(trackedState.model),
       instructions: readAgentSkillsRoot() || defaultInstructions(),
-      tools: createTools()
+      tools
     });
+  }
+  async initialize() {
+    if (this.isInitialized) {
+      return;
+    }
+    this.agent = _AgentManager.instantiateAgent(createTools());
     this.session = createSession(trackedState.sessionPath);
     try {
       const plan = await this.session?.getPlanState?.();

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@harperfast/agent",
 	"description": "AI to help you with Harper app management",
-	"version": "0.16.0",
+	"version": "0.16.1",
 	"main": "dist/agent.js",
 	"repository": "github:HarperFast/harper-agent",
 	"bugs": {