pi-subagents 0.80.0 → 0.82.0

package/src/shared/types.d.ts

@@ -2,6 +2,7 @@
  * Type definitions for the subagent extension
  */
 import type { Message } from "@earendil-works/pi-ai";
+import type { SubagentDelegationProviderDiagnostics } from "../api/delegation.ts";
 import type { AgentConfig } from "../agents/agents.ts";
 import type { FSWatcher } from "node:fs";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
@@ -15,6 +16,8 @@ import type { ExtensionBindings } from "../runs/shared/extension-bindings.ts";
 import type { WorkflowChildPermitContext } from "./workflow-child-permit.ts";
 import type { WatchdogWarningDetails } from "../watchdog/types.ts";
 import type { RequiredChildExtensionSnapshot } from "./required-child-extensions.ts";
+import type { RecordedPid } from "../runs/background/stale-run-reconciler.ts";
+import type { WorkflowStopCause } from "../workflows/workflow-stop-cause.ts";
 export interface MaxOutputConfig {
     bytes?: number;
     lines?: number;
@@ -864,6 +867,7 @@ export interface ChildWatchdogProgress {
     warnings?: ChildWatchdogWarningSummary[];
 }
 export interface AgentProgress {
+    providerDiagnostics?: SubagentDelegationProviderDiagnostics;
     index: number;
     agent: string;
     /** Human-readable display name for the child's session, when derived at launch. */
@@ -1159,11 +1163,12 @@ export interface SingleResult {
     toolBudget?: ToolBudgetState;
     toolBudgetBlocked?: boolean;
     messages?: Message[];
+    providerDiagnostics?: SubagentDelegationProviderDiagnostics;
     usage: Usage;
     model?: string;
     /** Authoritative before/after Git evidence captured by a pane-native remote machine. */
     nativeMachine?: {
-        provider: "herdr";
+        provider: PlacementMachineReference["provider"];
         machineId: string;
         initialGit?: HerdrRemoteGitStatus;
         finalGit?: HerdrRemoteGitStatus;
@@ -1428,10 +1433,17 @@ export interface Details {
         argsDigest?: string;
         /** SHA-256 of the workflow script source (async workflows). */
         scriptDigest?: string;
-        /** Structured stop cause; set only when the owning extension runtime was replaced. */
-        stopCause?: "runtime-replaced";
-        /** Runtime-replaced workflow run whose finished children this run reused. */
+        /** Structured stop cause: `runtime-replaced` when the owning extension runtime was replaced; `owner-exited` when stale-run reconciliation found the owning Pi process dead. */
+        stopCause?: WorkflowStopCause;
+        /** Interrupted workflow run whose finished children this run reused. */
         reusedFrom?: string;
+        /** Owner-exited runs: the last time the dead Pi process updated the run (epoch ms), not the repair time. */
+        ownerExitedAt?: number;
+        /** Set on a run that resumes an interrupted one; `attempt` counts resumes that followed Pi exits. */
+        resumeOrigin?: {
+            sourceRunId: string;
+            attempt: number;
+        };
         resource?: WorkflowResourceProvenance;
         preflightWarnings?: string[];
         trace: Array<{
@@ -1447,7 +1459,7 @@ export interface Details {
             generatedLaneKey?: string;
             warning?: string;
             error?: string;
-            /** Came from a previous runtime-replaced run of the same script (and args, unless named by options.reuseFrom); this run launched nothing. */
+            /** Came from a previous runtime-replaced or owner-exited run of the same script (and args, unless named by options.reuseFrom); this run launched nothing. */
             reused?: boolean;
         }>;
         emits: unknown[];
@@ -1670,6 +1682,24 @@ export interface HerdrMachineReference {
     session?: string;
     cwd: string;
 }
+/** `machine: "local"`: a Rex pane in the parent's own Rex session on this machine. `session` is the Rex session id and `server` the Rex server address, both recorded in the parent at resolution time; `cwd` is the local launch directory. */
+export interface RexLocalMachineReference {
+    provider: "rex";
+    id: "local";
+    session: string;
+    server?: string;
+    cwd: string;
+}
+/** A Rex machine reached over SSH, named in user settings (`subagents.machines.<id>.rex.ssh`). The pane opens in that machine's Rex session labeled `subagents`, found or created at launch and recorded with the run; `cwd` is the directory on that machine. */
+export interface RexSshMachineReference {
+    provider: "rex";
+    id: string;
+    target: string;
+    cwd: string;
+}
+export type RexMachineReference = RexLocalMachineReference | RexSshMachineReference;
+/** Where a placed native Pi child runs. */
+export type PlacementMachineReference = HerdrMachineReference | RexMachineReference;
 export interface ExternalCliMachineStatus extends HerdrMachineReference {
     remoteGit?: HerdrRemoteGitStatus;
 }
@@ -1821,6 +1851,8 @@ export interface AsyncStatus {
     runId: string;
     /** Parent Pi process/window that owns local completion delivery. */
     completionOwnerId?: string;
+    /** The Pi process behind `completionOwnerId`; once it is dead, the session that owns the run delivers it. */
+    completionOwnerProcess?: RecordedPid;
     /** Host tool-call id retained when it differs from the internal run id. */
     toolCallId?: string;
     sessionId?: string;
@@ -1857,6 +1889,8 @@ export interface AsyncStatus {
     pid?: number;
     /** Linux PID namespace identity used to scope liveness probes. */
     pidNamespaceScope?: string;
+    /** Boot id of the machine when `pid` was recorded; a different current boot id proves the pid dead. */
+    bootId?: string;
     cwd?: string;
     /** User-configured launcher that wrapped the background runner (argv only, never environment). */
     launcher?: RunnerLauncher;
@@ -2132,6 +2166,10 @@ export interface ForegroundResumeRun {
     sessionId?: string;
     updatedAt: number;
     children: ForegroundResumeChild[];
+    /** Pi process running this run; only on records whose child is `running`. */
+    owner?: RecordedPid;
+    /** Workflow that launched this foreground child. */
+    parentWorkflowRunId?: string;
 }
 export interface ForegroundChildControl {
     index: number;
@@ -2315,6 +2353,8 @@ export interface SubagentState {
     workflowControllers?: Map<string, AbortController>;
     /** Live in-process workflow child stoppers keyed by parent workflow run id. */
     workflowChildStops?: Map<string, (childId: string, message?: string) => boolean>;
+    /** Background children awaited by a blocking workflow call: their parent cannot answer supervisor asks. */
+    blockingWorkflowChildren?: Set<string>;
 }
 export interface HerdrProjectPaneSnapshot {
     projectRoot: string;
@@ -2419,7 +2459,7 @@ export interface RunSyncOptions {
     context?: "fresh" | "fork";
     cwd?: string;
     /** Resolved pane-native saved-machine placement. */
-    machine?: HerdrMachineReference;
+    machine?: PlacementMachineReference;
     /** Explicit read override resolved by the remote ambient agent profile. */
     remoteReads?: string[] | false;
     /** Original cwd input retained for launch diagnostics. */
@@ -2580,6 +2620,8 @@ export interface ActiveAsyncCapacityConfig {
 }
 export interface ExtensionConfig {
     asyncByDefault?: boolean;
+    /** Relaunch this session's interrupted async workflows when the session is reopened or reloaded (default true). */
+    autoResume?: boolean;
     /** Set the context for launches that omit an explicit context. */
     defaultSubagentContext?: "fresh" | "fork";
     /** Configure how every resolved fork session is prepared before child spawn. */

package/src/slash/delegation-adapters.d.ts

@@ -1,4 +1,4 @@
-import { type SubagentDelegationRequest, type SubagentDelegationResponse, type SubagentDelegationThinking, type SubagentDelegationUpdate, type SubagentDelegationUpdateUsage } from "../api/delegation.ts";
+import { type SubagentDelegationProviderDiagnostics, type SubagentDelegationRequest, type SubagentDelegationResponse, type SubagentDelegationThinking, type SubagentDelegationUpdate, type SubagentDelegationUpdateUsage } from "../api/delegation.ts";
 import type { AcceptanceInput, AgentContract, EffectsProjection, ExecutionProjection, IntercomBridgeConfig, JsonSchemaObject, ReviewProjection, ToolBudgetConfig, Usage } from "../shared/types.ts";
 export interface PromptTemplateDelegationRequest {
     requestId: string;
@@ -88,6 +88,7 @@ export interface PromptTemplateBridgeResult {
             review?: ReviewProjection;
             effects?: EffectsProjection;
             usage?: Usage;
+            providerDiagnostics?: SubagentDelegationProviderDiagnostics;
             progressSummary?: {
                 toolCount?: number;
                 durationMs?: number;
@@ -116,6 +117,7 @@ export interface PromptTemplateBridgeResult {
             cacheRead?: number;
             cacheWrite?: number;
             turnCount?: number;
+            providerDiagnostics?: SubagentDelegationProviderDiagnostics;
         }>;
     };
 }

package/src/slash/delegation-adapters.js

@@ -1,4 +1,5 @@
 import { cloneJsonWithinByteLimit } from "./delegation-json.js";
+import { clearProviderRetry, snapshotProviderDiagnostics } from "../shared/provider-diagnostics.js";
 export function parsePromptTemplateRequest(data) {
     if (!data || typeof data !== "object")
         return undefined;
@@ -207,6 +208,9 @@ export function toSubagentDelegationUpdate(request, result) {
         ...(typeof legacy.durationMs === "number" ? { durationMs: legacy.durationMs } : {}),
         ...(typeof legacy.tokens === "number" ? { tokens: legacy.tokens } : {}),
         ...(legacy.usage ? { usage: legacy.usage } : {}),
+        ...(result.details?.progress?.[0]?.providerDiagnostics ? {
+            providerDiagnostics: snapshotProviderDiagnostics(result.details.progress[0].providerDiagnostics),
+        } : {}),
     };
 }
 function resolveSubagentDelegationStatus(result, aborted) {
@@ -282,6 +286,9 @@ export function toSubagentDelegationResponse(request, result, aborted) {
         ...(typeof child?.exitCode === "number" ? { exitCode: child.exitCode } : {}),
         ...(childLaunchContractDigest ? { launchContractDigest: childLaunchContractDigest } : {}),
         ...(projectedResult ? { result: projectedResult } : {}),
+        ...(child?.providerDiagnostics ? {
+            providerDiagnostics: snapshotProviderDiagnostics(clearProviderRetry(child.providerDiagnostics)),
+        } : {}),
         ...(usage ? {
             usage: {
                 input: usage.input,

package/src/slash/prompt-template-bridge.js

@@ -1,5 +1,6 @@
 import { SUBAGENT_DELEGATION_CANCEL_EVENT, SUBAGENT_DELEGATION_REQUEST_EVENT, SUBAGENT_DELEGATION_RESPONSE_EVENT, SUBAGENT_DELEGATION_STARTED_EVENT, SUBAGENT_DELEGATION_UPDATE_EVENT, } from "../api/delegation.js";
 import { parseSubagentDelegationRequest } from "./delegation-request.js";
+import { sameProviderDiagnostics } from "../shared/provider-diagnostics.js";
 import { parsePromptTemplateRequest, toDelegationUpdate, toPromptTemplateResponse, toSubagentDelegationExecutionParams, toSubagentDelegationResponse, toSubagentDelegationUpdate, } from "./delegation-adapters.js";
 export const PROMPT_TEMPLATE_SUBAGENT_REQUEST_EVENT = SUBAGENT_DELEGATION_REQUEST_EVENT;
 export const PROMPT_TEMPLATE_SUBAGENT_STARTED_EVENT = SUBAGENT_DELEGATION_STARTED_EVENT;
@@ -58,7 +59,8 @@ function sameStructuredDelegationUpdateProgress(left, right) {
         && left.model === right.model
         && left.toolCount === right.toolCount
         && left.tokens === right.tokens
-        && sameUpdateUsage(left.usage, right.usage);
+        && sameUpdateUsage(left.usage, right.usage)
+        && sameProviderDiagnostics(left.providerDiagnostics, right.providerDiagnostics);
 }
 export function registerPromptTemplateDelegationBridge(options) {
     const legacyControllers = new Map();

package/src/slash/subagents-admin.d.ts

@@ -1,2 +1,3 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+export declare const ADMIN_MESSAGE_TYPE = "subagents-admin";
 export declare function openSubagentsAdmin(pi: ExtensionAPI, ctx: ExtensionContext, args?: string): Promise<void>;

package/src/slash/subagents-admin.js

@@ -7,7 +7,7 @@ import { editableAgentConfig, preservedAgentFrontmatterFields } from "../agents/
 import { findModelInfo, getSupportedThinkingLevels, toModelInfo } from "../shared/model-info.js";
 import { SelectorComponent } from "./selector.js";
 import { canRenderComponents } from "../shared/extension-context.js";
-const ADMIN_MESSAGE_TYPE = "subagents-admin";
+export const ADMIN_MESSAGE_TYPE = "subagents-admin";
 const INHERIT_MODEL_CHOICE = "Default / inherit session model";
 const INHERIT_THINKING_CHOICE = "Default / inherit session thinking";
 function sourceRank(source) {

package/src/tui/fleet-layout.d.ts

@@ -0,0 +1,20 @@
+export interface FleetRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface FleetLayout {
+    width: number;
+    rows: number;
+    bodyHeight: number;
+    roster: FleetRect;
+    output: FleetRect;
+    rosterStart: number;
+    rosterKeys: string[];
+}
+/** Coordinates are overlay-local, matching Pi's normalized input contract. */
+export declare function fleetLayout(width: number, rows: number, selected: number, items: readonly {
+    key: string;
+}[]): FleetLayout | undefined;
+export declare function fleetContains(rect: FleetRect, x: number, y: number): boolean;

package/src/tui/fleet-layout.js

@@ -0,0 +1,17 @@
+/** Coordinates are overlay-local, matching Pi's normalized input contract. */
+export function fleetLayout(width, rows, selected, items) {
+    if (width < 36)
+        return undefined;
+    const bodyHeight = Math.max(2, Math.floor(rows * 0.85) - 6);
+    const rosterWidth = Math.max(22, Math.min(46, Math.floor((width - 3) * 0.38)));
+    const rosterStart = Math.max(0, Math.min(selected - bodyHeight + 1, Math.max(0, items.length - bodyHeight)));
+    return {
+        width, rows, bodyHeight, rosterStart,
+        roster: { x: 1, y: 3, width: rosterWidth, height: bodyHeight },
+        output: { x: rosterWidth + 2, y: 3, width: Math.max(1, width - rosterWidth - 3), height: bodyHeight },
+        rosterKeys: items.slice(rosterStart, rosterStart + bodyHeight).map((item) => item.key),
+    };
+}
+export function fleetContains(rect, x, y) {
+    return x >= rect.x && x < rect.x + rect.width && y >= rect.y && y < rect.y + rect.height;
+}

package/src/tui/fleet-viewport.d.ts

@@ -0,0 +1,12 @@
+import { ScrollView } from "@earendil-works/pi-tui";
+/** Overlay-local clipping: ordinary overlays do not enter Pi's scroll layout traversal. */
+export declare class FleetViewport {
+    private readonly body;
+    readonly scroll: ScrollView;
+    private readonly requestRender;
+    private resetTopOnLayout;
+    constructor(requestRender: () => void);
+    render(lines: string[], width: number, height: number): string[];
+    resetTop(): void;
+    follow(): void;
+}

package/src/tui/fleet-viewport.js

@@ -0,0 +1,35 @@
+import { ScrollView } from "@earendil-works/pi-tui";
+/** Overlay-local clipping: ordinary overlays do not enter Pi's scroll layout traversal. */
+export class FleetViewport {
+    body = {
+        lines: [],
+        render() { return this.lines; },
+        invalidate() { },
+    };
+    scroll = new ScrollView(this.body, { follow: "end", overscroll: "contain" });
+    requestRender;
+    resetTopOnLayout = false;
+    constructor(requestRender) {
+        this.requestRender = requestRender;
+    }
+    render(lines, width, height) {
+        this.body.lines = lines;
+        const rendered = this.scroll.render(width);
+        this.scroll.updateLayout(rendered.length, height, this.requestRender);
+        if (this.resetTopOnLayout) {
+            this.resetTopOnLayout = false;
+            this.scroll.scrollTo(0, { disableFollow: true });
+        }
+        return rendered.slice(this.scroll.scrollTop, this.scroll.scrollTop + this.scroll.viewportHeight);
+    }
+    resetTop() {
+        // Apply again after the new view's dimensions arrive: disableFollow suppresses following
+        // at the actual content end, which may differ from the previous view's end.
+        this.resetTopOnLayout = true;
+        this.scroll.scrollTo(0, { disableFollow: true });
+    }
+    follow() {
+        this.resetTopOnLayout = false;
+        this.scroll.scrollToEnd();
+    }
+}

package/src/tui/fleet.d.ts

@@ -1,5 +1,5 @@
 import { type ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { type Component, type MarkdownTheme } from "@earendil-works/pi-tui";
+import { type Component, type MarkdownTheme, type TuiMouseEvent, type TuiMouseEventResult } from "@earendil-works/pi-tui";
 import { type ExternalRun } from "../api/external-runs.ts";
 import { type FleetKeybindingAction, type FleetKeybindingsConfig, type ForegroundChildControl, type ForegroundResumeChild, type ForegroundResumeRun, type ForegroundRunControl, type SubagentState } from "../shared/types.ts";
 import { type AsyncRunSummary } from "../runs/background/async-status.ts";
@@ -46,6 +46,7 @@ export type FleetItem = ({
     updatedAt: number;
     run: AsyncRunSummary;
     step?: AsyncStep;
+    task?: string;
 } | {
     key: string;
     kind: "external";
@@ -111,11 +112,8 @@ export declare class SubagentFleetComponent implements Component {
     private snapshot;
     private selected;
     private selectedKey;
-    private detailScroll;
-    private detailAutoFollow;
-    private detailLineCount;
-    private detailViewportHeight;
-    private bodyHeight;
+    private readonly viewport;
+    private renderedLayout;
     private expandedTools;
     private promptAuditOpen;
     private promptAuditView;
@@ -141,6 +139,7 @@ export declare class SubagentFleetComponent implements Component {
     private stopRefresh;
     private refresh;
     private moveSelection;
+    private selectItem;
     private selectedPromptAudit;
     private promptAuditItems;
     private selectedPromptText;
@@ -155,6 +154,7 @@ export declare class SubagentFleetComponent implements Component {
     private setActionNotice;
     private runAction;
     private scrollDetail;
+    handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined;
     handleInput(data: string): void;
     private rosterLines;
     private renderedTranscript;