agent-blocked 0.1.3 → 0.1.5

package/README.md

@@ -16,9 +16,9 @@ Report a blocker manually:
 npx agent-blocked@latest report --event=needs_direction --severity=medium --reason="Need human direction"
 ```
 
-The installer adds a small `.agent-blocked/` directory plus tool-specific config or instruction files for the selected agent tools. Those files tell the agent when to escalate and provide a local reporter command that sends blocker events to your Agent Blocked alert profile.
+The installer adds a small `.agent-blocked/` directory plus tool-specific config or instruction files for the selected agent tools. Those files tell the agent when to escalate during goal mode, autonomous mode, background execution, hook-driven automation, CI-style runs, or another CLI-specific automated mode. They also provide a local reporter command that sends blocker events to your Agent Blocked alert profile.
 
-Agents should notify when continuing would waste time, create risk, or require a decision only the human can make:
+Agents should not notify during normal interactive paired work when the human is already present and responding in the current conversation. In automated modes, agents should notify when continuing would waste time, create risk, or require a decision only the human can make:
 
 - `needs_credentials` for missing API keys, OAuth, permissions, roles, or secrets.
 - `needs_direction` for ambiguous goals, tradeoffs, architecture, product behavior, or priorities.
@@ -27,12 +27,10 @@ Agents should notify when continuing would waste time, create risk, or require a
 - `low_confidence` when the agent can continue but the chance of being wrong is high.
 - `hard_blocked` when no productive path remains without human input.
 
-Set these environment variables in the shell where the agent runs:
+Set the scoped token in the shell or secret store where the agent runs:
 
 ```bash
-export AGENT_BLOCKED_WEBHOOK_URL="https://agentblocked.com/api/agent-blocked"
 export AGENT_BLOCKED_AGENT_TOKEN="your-scoped-token"
-export AGENT_NAME="prod-agent"
 ```
 
 Agents can report through the installed local reporter:

package/bin/agent-blocked.mjs

@@ -156,7 +156,11 @@ try {
 
 const instructions = `# Agent Blocked instructions for coding agents
 
-When you are blocked by missing credentials, unclear direction, approval requirements, repeated tool failures, low confidence, or external context, stop burning tokens and report the blockage.
+Use Agent Blocked only when this agent is running without an actively engaged human in the loop, such as goal mode, autonomous mode, background execution, hook-driven automation, CI-style runs, or another CLI-specific automated mode.
+
+Do not report during normal interactive paired work when the human is already present and responding in the current conversation. In that case, ask the human directly in chat instead of sending an Agent Blocked alert.
+
+When operating in an automated mode and blocked by missing credentials, unclear direction, approval requirements, repeated tool failures, low confidence, or external context, stop burning tokens and report the blockage.
 
 Notify the human when continuing would waste time, create risk, or require a decision only the human can make. Do not notify for routine recoverable errors that you can fix yourself in one or two attempts.
 
@@ -169,9 +173,7 @@ node .agent-blocked/report.mjs --event=needs_direction --severity=medium --reaso
 Environment expected by the report command:
 
 \`\`\`bash
-export AGENT_BLOCKED_WEBHOOK_URL="https://agentblocked.com/api/agent-blocked"
 export AGENT_BLOCKED_AGENT_TOKEN="your-scoped-token"
-export AGENT_NAME="your-agent-name"
 \`\`\`
 
 Event types:
@@ -325,7 +327,7 @@ function install() {
     installers[name]();
   }
 
-  console.log("\nNext: set AGENT_BLOCKED_WEBHOOK_URL, AGENT_BLOCKED_AGENT_TOKEN, and AGENT_NAME in the shell where your agent runs.");
+  console.log("\nNext: set AGENT_BLOCKED_AGENT_TOKEN in the shell or secret store where your agent runs.");
   console.log("Manual report command: node .agent-blocked/report.mjs --event=needs_direction --severity=medium --reason=\"Need human direction\"");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-blocked",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "CLI installer and reporter for Agent Blocked AI agent escalation alerts.",
   "type": "module",
   "bin": {