@llblab/pi-actors 0.41.1 → 0.42.1

package/dist/lib/inspector-actions.js

@@ -0,0 +1,57 @@
+/**
+ * Actor Inspector run actions.
+ * Owns: exact-session run-action authorization, canonical kill routing, and bounded operator feedback.
+ */
+import { join } from "node:path";
+import { safeRunId } from "./runs-identity.js";
+const FEEDBACK_LIMIT = 180;
+function bounded(value) {
+    const text = String(value ?? "").replaceAll(/\s+/g, " ").trim();
+    return text.length <= FEEDBACK_LIMIT
+        ? text
+        : `${text.slice(0, FEEDBACK_LIMIT - 1)}…`;
+}
+export function killOwnedInspectorRun(ownerId, run, stateRoot, expectedRunInstanceId, deps) {
+    let stateDir;
+    try {
+        stateDir = join(stateRoot, safeRunId(run));
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: `Kill rejected: ${bounded(error instanceof Error ? error.message : error)}`,
+        };
+    }
+    try {
+        const status = deps.getRunStatus(stateDir);
+        if (status.ownerId !== ownerId) {
+            return { ok: false, message: "Kill rejected: run ownership changed." };
+        }
+        if (status.status !== "running") {
+            return {
+                ok: false,
+                message: `Kill unavailable: run is ${bounded(status.status || "terminal")}.`,
+            };
+        }
+        if (status.run_instance_id !== expectedRunInstanceId) {
+            return { ok: false, message: "Kill rejected: run generation changed." };
+        }
+        const result = deps.killRun(stateDir, {
+            ownerId,
+            runInstanceId: expectedRunInstanceId,
+        });
+        if (result.killed === true) {
+            return { ok: true, message: `Killed run:${run}.` };
+        }
+        return {
+            ok: false,
+            message: `Kill failed: ${bounded(result.reason || "control rejected")}.`,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: `Kill failed: ${bounded(error instanceof Error ? error.message : error)}.`,
+        };
+    }
+}

package/dist/lib/inspector-command.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Actor Inspector command adapter.
+ * Zones: Pi command registration, overlay construction, owned-run control ports
+ * Owns host-facing Inspector launch wiring without owning Inspector state or actions.
+ */
+import type * as Pi from "./pi.ts";
+export declare function registerActorInspectorCommand(pi: Pi.ExtensionAPI, getRunOwnerId: (ctx: Pi.ExtensionContext) => string): void;

package/dist/lib/inspector-command.js

@@ -0,0 +1,37 @@
+/**
+ * Actor Inspector command adapter.
+ * Zones: Pi command registration, overlay construction, owned-run control ports
+ * Owns host-facing Inspector launch wiring without owning Inspector state or actions.
+ */
+import * as AsyncRuns from "./async-runs.js";
+import * as InspectorActions from "./inspector-actions.js";
+import * as InspectorOverlay from "./inspector-overlay.js";
+import * as Paths from "./paths.js";
+export function registerActorInspectorCommand(pi, getRunOwnerId) {
+    pi.registerCommand("actors-inspector", {
+        description: "Open the keyboard-driven actor inspector overlay",
+        handler: async (_args, ctx) => {
+            ctx.ui.setWidget("zz-pi-actors-comms", undefined);
+            await ctx.ui.custom((tui, theme, _keybindings, done) => new InspectorOverlay.ActorInspectorOverlay({
+                done,
+                killRun: (run, runInstanceId) => InspectorActions.killOwnedInspectorRun(getRunOwnerId(ctx), run, Paths.EXTENSION_RUNTIME_PATHS.runStateRoot, runInstanceId, {
+                    getRunStatus: AsyncRuns.getRunStatus,
+                    killRun: AsyncRuns.killRun,
+                }),
+                ownerId: getRunOwnerId(ctx),
+                stateRoot: Paths.EXTENSION_RUNTIME_PATHS.runStateRoot,
+                theme,
+                tui,
+            }), {
+                overlay: true,
+                overlayOptions: {
+                    anchor: "center",
+                    width: "94%",
+                    minWidth: 72,
+                    maxHeight: "94%",
+                    margin: 1,
+                },
+            });
+        },
+    });
+}

package/dist/lib/inspector-overlay.d.ts

@@ -5,17 +5,26 @@
  */
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { type TUI } from "@earendil-works/pi-tui";
-export type ActorInspectorOverlayTab = "communications" | "turns";
+import * as Inspector from "./inspector.ts";
+export type ActorInspectorOverlayTab = "recipe" | "communications" | "turns";
+export interface ActorInspectorOverlayActionResult {
+    ok: boolean;
+    message: string;
+}
 export interface ActorInspectorOverlayOptions {
     done: () => void;
+    killRun?: (run: string, runInstanceId: string) => ActorInspectorOverlayActionResult;
     ownerId: string;
+    readTurns?: (stateDir: string) => Inspector.ActorInspectorTurnItem[];
     stateRoot: string;
     theme: Theme;
     tui: TUI;
 }
 export declare class ActorInspectorOverlay {
     private readonly done;
+    private readonly killRun?;
     private readonly ownerId;
+    private readonly readTurns;
     private readonly stateRoot;
     private readonly theme;
     private readonly tui;
@@ -29,16 +38,20 @@ export declare class ActorInspectorOverlay {
     private detailOpen;
     private detailScroll;
     private detailTurn?;
-    private detailView;
+    private feedback?;
+    private killConfirmation?;
+    private killDialogChoice;
     private readonly readKeys;
     private focus;
     private filterControlIndex;
     private menuLevel;
     private selectorIndex;
+    private recipeScroll;
     private rowIndex;
     private selectedRun?;
     private subagentIndex;
     private tab;
+    private turnCache?;
     constructor(options: ActorInspectorOverlayOptions);
     handleInput(data: string): void;
     render(width: number): string[];
@@ -49,6 +62,10 @@ export declare class ActorInspectorOverlay {
     private contentViewportRows;
     private selectRun;
     private cycleRun;
+    private requestKill;
+    private cancelKill;
+    private confirmKill;
+    private renderKillDialog;
     private listItemCount;
     private selectorAnchor;
     private renderKeyHints;
@@ -57,17 +74,19 @@ export declare class ActorInspectorOverlay {
     private renderTabs;
     private renderRunSelector;
     private renderTimeline;
+    private renderRecipe;
     private communicationPreviews;
     private communicationActorLabel;
     private communicationFromOptions;
     private communicationRows;
     private renderDetail;
     private wrapDetailLines;
+    private wrapPreferred;
     private detailSection;
     private readableValueLines;
     private turnEvidenceLines;
     private readablePromptText;
-    private turnTranscriptLines;
+    private allTurnItems;
     private turnItems;
     private turnRows;
     private subagents;
@@ -91,5 +110,6 @@ export declare class ActorInspectorOverlay {
     private row;
     private takeVisiblePrefix;
     private dropVisiblePrefix;
+    private center;
     private fit;
 }