What problem does it solve?
This Skill assists in diagnosing, fixing, and preventing "tool execution blocked" errors in Pi AI agent systems. It covers root causes such as extension.js issues, Gleam result unwrapping, database schema mismatches, import aliasing, hook failures, and PromiseLayer handling.
Core Features & Use Cases
- Error Diagnosis: Identifies and analyzes the exact cause of "blocked" tool execution.
- Root Cause Analysis: Covers extension.js, Gleam result unwrapping, database schema mismatches, import aliasing, hook failures, and PromiseLayer handling.
- Prevention Guide: Offers prevention measures like build hygiene, import verification, and error handling best practices.
- Troubleshooting Workflow: Provides a step-by-step process to diagnose and fix errors, including event hooks, build artifacts, unwrapGleamResult checks, database schema, and regeneration of extension.js.
- Quick Reference: Includes essential commands and file checks for resolving common issues.
Quick Start
To diagnose and resolve "tool execution blocked" errors in Pi AI agent systems, start by running the affected tool and noting the exact error message. Follow the troubleshooting workflow outlined in the Skill unit.