@llblab/pi-actors 0.32.0 → 0.34.0

package/docs/template-recipes.md

@@ -69,7 +69,7 @@ A file-backed recipe's id comes from its filename, not a JSON `name` field. Lega
 
 ## Markdown Authoring
 
-Markdown recipes use `.md` files with YAML-like frontmatter for recipe metadata and one fenced executable block for the recipe/template body. Runtime behavior comes only from frontmatter plus the fenced block; surrounding prose is advisory for humans and future recipe-context use.
+Markdown recipes use `.md` files with YAML-like frontmatter for recipe metadata and one fenced executable block for the recipe/template body. Runtime behavior comes only from frontmatter plus the fenced block; surrounding prose is advisory for humans and future recipes-context use.
 
 ````markdown
 ---

package/docs/tool-registry.md

@@ -10,7 +10,7 @@ The registry source is location-discovered recipes, not a live tool-only JSON fi
 
 - `~/.pi/agent/recipes/*.json` and `*.md` are the highest-priority user recipe root and the operator-managed tool set.
 - Recipes in that root are tools by location.
-- `~/.pi/agent/recipes/candidates/*.json` stores captured inline-spawn draft recipes, not registered tools. The directory name is retained for compatibility; model-facing output calls them drafts. Promote one by moving or copying it up one level into `~/.pi/agent/recipes`. `inspect target=recipes view=summary` reports their count, and verbose output lists their paths/descriptions for explicit replay by file path.
+- `~/.pi/agent/recipes/drafts/*.json` stores captured inline-spawn draft recipes, not registered tools. Promote one by moving or copying it up one level into `~/.pi/agent/recipes`. `inspect target=recipes view=summary` reports their count, and verbose output lists their paths/descriptions for explicit replay by file path.
 - Packaged pi-actors recipes are the lower-priority standard library of declarative actor config components, not automatically registered tools.
 - Ad hoc recipe files outside the user recipe root are components unless explicitly registered/copied into `~/.pi/agent/recipes`.
 - Recipe identity is the filename basename; `~/.pi/agent/recipes/docs_review.json` and `docs_review.md` both have id/tool name `docs_review`.
@@ -31,9 +31,9 @@ inspect target=recipes view=summary verbose=true
 
 `tool:pi-actors` is a reserved runtime-status actor: it reports the loaded package version, package root, source/dist mode, entrypoint path, recipe roots, and git commit when available. Use it after reloads to confirm which extension code is actually live.
 
-The recipe summary reports active, shadowed, invalid, disabled, and diagnostic entries so operators can answer why a tool is present, hidden, broken, or disabled. The doctor view keeps the same registry evidence but promotes an advisory action surface: compact output includes the highest-priority `top` remediation plus ordered actions for invalid/blocking, disabled, risky shell-boundary, and shadowed recipes. Verbose inspection keeps the structured `remediations`, `top_action`, diagnostic details, and blocked lower-priority candidate paths when a broken or disabled higher-priority recipe masks a fallback.
+The recipe summary reports active, shadowed, invalid, disabled, and diagnostic entries so operators can answer why a tool is present, hidden, broken, or disabled. The doctor view keeps the same registry evidence but promotes an advisory action surface: compact output includes the highest-priority `top` remediation plus ordered actions for invalid/blocking, disabled, risky shell-boundary, and shadowed recipes. Verbose inspection keeps the structured `remediations`, `top_action`, diagnostic details, and blocked lower-priority fallback paths when a broken or disabled higher-priority recipe masks a fallback.
 
-Routine shadowing is quiet. If a bare `spawn` recipe launch already fails because an invalid or `disabled: true` user recipe blocks a lower-priority candidate, the launch error adds compact tokens such as `reason=shadowed_invalid` or `reason=shadowed_disabled`, `active_path`, `blocked_candidate`, and `hint=inspect_recipes_doctor`.
+Routine shadowing is quiet. If a bare `spawn` recipe launch already fails because an invalid or `disabled: true` user recipe blocks a lower-priority fallback, the launch error adds compact tokens such as `reason=shadowed_invalid` or `reason=shadowed_disabled`, `active_path`, `blocked_fallback`, and `hint=inspect_recipes_doctor`.
 
 ## Registering Tools
 

package/index.ts

@@ -5,9 +5,9 @@
  * Wraps command templates as callable pi tools, stores durable user tools as recipe files, and exposes actor orchestration across reloads and sessions.
  */
 
-import * as ActorInspectorTui from "./lib/actor-inspector-tui.ts";
 import * as AsyncRuns from "./lib/async-runs.ts";
 import * as CommandTemplates from "./lib/command-templates.ts";
+import * as Inspector from "./lib/inspector.ts";
 import * as Observability from "./lib/observability.ts";
 import * as Paths from "./lib/paths.ts";
 import * as Pi from "./lib/pi.ts";
@@ -22,8 +22,7 @@ export default function toolRegistryExtension(pi: Pi.ExtensionAPI) {
   let activeRunContext: Pi.ExtensionContext | undefined;
   const runUi = Observability.createRunUiObservationState();
   const retirementAttempts = new Set<string>();
-  const actorInspector =
-    ActorInspectorTui.createActorInspectorControllerState();
+  const actorInspector = Inspector.createActorInspectorControllerState();
   const getRunOwnerId = Pi.getSessionId;
   const retireCandidateRuns = (
     ctx: Pi.ExtensionContext,
@@ -50,7 +49,7 @@ export default function toolRegistryExtension(pi: Pi.ExtensionAPI) {
         ? () => ({
             invalidate() {},
             render(width: number) {
-              return ActorInspectorTui.renderActorInspectorPanel({
+              return Inspector.renderActorInspectorPanel({
                 stateRoot: Paths.EXTENSION_RUNTIME_PATHS.runStateRoot,
                 state: actorInspector,
                 ownerId,
@@ -102,7 +101,7 @@ export default function toolRegistryExtension(pi: Pi.ExtensionAPI) {
     onChange: () =>
       activeRunContext && scheduleRunEventUpdate(activeRunContext),
   });
-  const actorToolDefinitions = new Map<string, any>();
+  const actorToolDefinitions = new Map<string, Tools.ActorToolDefinition>();
   const runtime = Runtime.createAutoToolsRuntime({
     configPath: Paths.EXTENSION_RUNTIME_PATHS.configPath,
     exec: CommandTemplates.execCommandTemplate,
@@ -142,39 +141,33 @@ export default function toolRegistryExtension(pi: Pi.ExtensionAPI) {
     recipeReload.close();
   });
   pi.registerCommand("actors-inspector-toggle", {
-    description: ActorInspectorTui.ACTOR_INSPECTOR_COMMAND_DESCRIPTIONS.toggle,
+    description: Inspector.ACTOR_INSPECTOR_COMMAND_DESCRIPTIONS.toggle,
     handler: async (args, ctx) => {
-      const result = ActorInspectorTui.handleActorInspectorToggle(
-        actorInspector,
-        args,
-      );
+      const result = Inspector.handleActorInspectorToggle(actorInspector, args);
       if (result.update) updateRunUi(ctx);
       ctx.ui.notify(result.notify, result.type);
     },
   });
   pi.registerCommand("actors-inspector-filter", {
-    description: ActorInspectorTui.ACTOR_INSPECTOR_COMMAND_DESCRIPTIONS.filter,
+    description: Inspector.ACTOR_INSPECTOR_COMMAND_DESCRIPTIONS.filter,
     handler: async (args, ctx) => {
-      const result = ActorInspectorTui.handleActorInspectorFilter(
-        actorInspector,
-        args,
-      );
+      const result = Inspector.handleActorInspectorFilter(actorInspector, args);
       if (result.update) updateRunUi(ctx);
       ctx.ui.notify(result.notify, result.type);
     },
   });
   pi.registerCommand("actors-inspect", {
-    description: ActorInspectorTui.ACTOR_INSPECTOR_COMMAND_DESCRIPTIONS.inspect,
+    description: Inspector.ACTOR_INSPECTOR_COMMAND_DESCRIPTIONS.inspect,
     handler: async (args, ctx) => {
-      const previews = ActorInspectorTui.readActorInspectorPreviews(
+      const previews = Inspector.readActorInspectorPreviews(
         Paths.EXTENSION_RUNTIME_PATHS.runStateRoot,
         actorInspector.rows,
-        ActorInspectorTui.getActorInspectorPreviewOptions(
+        Inspector.getActorInspectorPreviewOptions(
           actorInspector,
           getRunOwnerId(ctx),
         ),
       );
-      const result = ActorInspectorTui.handleActorInspectorInspect(
+      const result = Inspector.handleActorInspectorInspect(
         actorInspector,
         args,
         previews,