pi-subagents 0.79.2 → 0.81.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";
@@ -864,6 +865,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,6 +1161,7 @@ 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. */
@@ -2612,6 +2615,8 @@ export interface ExtensionConfig {
     toolActivation?: ToolActivationMode;
     /** Keep a resumed session on the pi-subagents tool definitions and prompt text it already declared. Defaults to true. */
     pinToolDeclarations?: boolean;
+    /** Register the pi-subagents slash commands and the foreground-detach shortcut. Defaults to true. */
+    enableSlashCommands?: boolean;
     /** Opt-in feature groups removed from the subagent tool schema and rejected at every execution boundary. */
     disabledFeatures?: SubagentFeature[];
     /** Inline chat rendering for the subagent tool. Defaults to rich. */
@@ -2759,4 +2764,3 @@ export declare function normalizeMaxSubagentSpawnsPerRun(value: unknown): number
 export declare function resolveMaxSubagentSpawnsPerRun(configMaxSpawns?: number): number;
 export declare function truncateOutput(output: string, config: Required<MaxOutputConfig>, artifactPath?: string): TruncationResult;
 export {};
-//# sourceMappingURL=types.d.ts.map

package/src/shared/types.js

@@ -270,4 +270,3 @@ export function truncateOutput(output, config, artifactPath) {
         artifactPath,
     };
 }
-//# sourceMappingURL=types.js.map

package/src/shared/utf8.d.ts

@@ -3,4 +3,3 @@ export declare function utf8Tail(value: string, maxBytes: number): {
     text: string;
     truncated: boolean;
 };
-//# sourceMappingURL=utf8.d.ts.map

package/src/shared/utf8.js

@@ -10,4 +10,3 @@ export function utf8Tail(value, maxBytes) {
         return { text: value, truncated: false };
     return { text: decodeUtf8Tail(bytes.subarray(bytes.length - maxBytes)), truncated: true };
 }
-//# sourceMappingURL=utf8.js.map

package/src/shared/utils.d.ts

@@ -81,4 +81,3 @@ export declare function extractToolArgsPreview(args: Record<string, unknown>): s
  */
 export declare function extractTextFromContent(content: unknown): string;
 export { mapConcurrent } from "../runs/shared/parallel-utils.ts";
-//# sourceMappingURL=utils.d.ts.map

package/src/shared/utils.js

@@ -610,4 +610,3 @@ export function extractTextFromContent(content) {
 // Concurrency Utilities
 // ============================================================================
 export { mapConcurrent } from "../runs/shared/parallel-utils.js";
-//# sourceMappingURL=utils.js.map

package/src/shared/watch-strategy.d.ts

@@ -1,3 +1,2 @@
 export type FileWatchPurpose = "result-delivery" | "supervisor-channel" | "async-job-tracker" | "retained-nested-route-tracker" | "runner-control-inbox" | "child-steering-inbox";
 export declare function shouldUseNativeFsWatch(_purpose: FileWatchPurpose, platform?: NodeJS.Platform): boolean;
-//# sourceMappingURL=watch-strategy.d.ts.map

package/src/shared/watch-strategy.js

@@ -3,4 +3,3 @@ export function shouldUseNativeFsWatch(_purpose, platform = process.platform) {
         return false;
     return platform !== "darwin";
 }
-//# sourceMappingURL=watch-strategy.js.map

package/src/shared/workflow-child-permit.d.ts

@@ -56,4 +56,3 @@ export declare function consumeWorkflowResourcePermit(permit: WorkflowResourcePe
 } | string;
 /** Validate a host call against the authority attached to a consumed resource. */
 export declare function authorizeWorkflowResourceHost(permit: WorkflowResourcePermit, key: string, command: string): string | undefined;
-//# sourceMappingURL=workflow-child-permit.d.ts.map

package/src/shared/workflow-child-permit.js

@@ -157,4 +157,3 @@ export function authorizeWorkflowResourceHost(permit, key, command) {
         return `The command for runs.host('${key}') is not allowed for workflow resource '${record.resourceName}'.`;
     return undefined;
 }
-//# sourceMappingURL=workflow-child-permit.js.map

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;
         }>;
     };
 }
@@ -150,4 +152,3 @@ export declare function toSubagentDelegationUpdate(request: SubagentDelegationRe
 export declare function toSubagentDelegationResponse(request: SubagentDelegationRequest, result: PromptTemplateBridgeResult, aborted: boolean): SubagentDelegationResponse;
 export declare function toPromptTemplateResponse(request: PromptTemplateDelegationRequest, result: PromptTemplateBridgeResult): PromptTemplateDelegationResponse;
 export {};
-//# sourceMappingURL=delegation-adapters.d.ts.map

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,
@@ -307,4 +314,3 @@ export function toPromptTemplateResponse(request, result) {
         errorText: result.isError ? contentText : undefined,
     };
 }
-//# sourceMappingURL=delegation-adapters.js.map

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

@@ -8,4 +8,3 @@ export type BoundedJsonClone = {
 };
 /** Clone plain JSON data without invoking getters or toJSON hooks. */
 export declare function cloneJsonWithinByteLimit(input: unknown, maxBytes: number): BoundedJsonClone;
-//# sourceMappingURL=delegation-json.d.ts.map

package/src/slash/delegation-json.js

@@ -115,4 +115,3 @@ export function cloneJsonWithinByteLimit(input, maxBytes) {
         };
     }
 }
-//# sourceMappingURL=delegation-json.js.map

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

@@ -10,4 +10,3 @@ export type SubagentDelegationParseResult = {
     error: string;
 };
 export declare function parseSubagentDelegationRequest(data: unknown): SubagentDelegationParseResult;
-//# sourceMappingURL=delegation-request.d.ts.map

package/src/slash/delegation-request.js

@@ -172,4 +172,3 @@ export function parseSubagentDelegationRequest(data) {
         },
     };
 }
-//# sourceMappingURL=delegation-request.js.map

package/src/slash/prompt-template-bridge.d.ts

@@ -24,4 +24,3 @@ export declare function registerPromptTemplateDelegationBridge<Ctx extends {
     dispose: () => void;
 };
 export {};
-//# sourceMappingURL=prompt-template-bridge.d.ts.map

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();
@@ -390,4 +392,3 @@ export function registerPromptTemplateDelegationBridge(options) {
         },
     };
 }
-//# sourceMappingURL=prompt-template-bridge.js.map

package/src/slash/prompt-workflows.d.ts

@@ -19,4 +19,3 @@ export declare function registerPromptWorkflowCommands(input: {
     run: PromptWorkflowRunner;
 }): void;
 export {};
-//# sourceMappingURL=prompt-workflows.d.ts.map

package/src/slash/prompt-workflows.js

@@ -272,4 +272,3 @@ export function registerPromptWorkflowCommands(input) {
         },
     });
 }
-//# sourceMappingURL=prompt-workflows.js.map

package/src/slash/selector.d.ts

@@ -45,4 +45,3 @@ export declare class SelectorComponent extends Container {
     private confirmSelection;
     handleInput(keyData: string): void;
 }
-//# sourceMappingURL=selector.d.ts.map

package/src/slash/selector.js

@@ -115,4 +115,3 @@ export class SelectorComponent extends Container {
         }
     }
 }
-//# sourceMappingURL=selector.js.map

package/src/slash/slash-bridge.d.ts

@@ -28,4 +28,3 @@ export declare function registerSlashSubagentBridge(options: SlashBridgeOptions)
     dispose: () => void;
 };
 export {};
-//# sourceMappingURL=slash-bridge.d.ts.map

package/src/slash/slash-bridge.js

@@ -130,4 +130,3 @@ export function registerSlashSubagentBridge(options) {
         },
     };
 }
-//# sourceMappingURL=slash-bridge.js.map

package/src/slash/slash-commands.d.ts

@@ -8,4 +8,3 @@ export declare function registerSlashCommands(pi: ExtensionAPI, state: SubagentS
 }): {
     dispose: () => void;
 };
-//# sourceMappingURL=slash-commands.d.ts.map

package/src/slash/slash-commands.js

@@ -359,7 +359,7 @@ async function requestSlashRun(pi, ctx, requestId, params, signal) {
                 const tool = update.currentTool ? ` ${update.currentTool}` : "";
                 const count = update.toolCount ?? 0;
                 const liveDetailKey = keyText("app.tools.expand");
-                ctx.ui.setStatus("subagent-slash", `${count} tools${tool} | ${liveDetailKey} live detail`);
+                ctx.ui.setStatus("subagent-slash", `${count} tools${tool}${liveDetailKey ? ` | ${liveDetailKey} live detail` : ""}`);
             }
             catch (error) {
                 if (isStaleExtensionContextError(error)) {
@@ -1057,4 +1057,3 @@ export function registerSlashCommands(pi, state, options = {}) {
         },
     };
 }
-//# sourceMappingURL=slash-commands.js.map

package/src/slash/slash-live-state.d.ts

@@ -19,4 +19,3 @@ export declare function getSlashRenderableSnapshot(details: SlashMessageDetails)
 export declare function restoreSlashFinalSnapshots(entries: unknown[]): void;
 export declare function clearSlashSnapshots(): void;
 export {};
-//# sourceMappingURL=slash-live-state.d.ts.map

package/src/slash/slash-live-state.js

@@ -261,4 +261,3 @@ export function clearSlashSnapshots() {
     liveSnapshots.clear();
     finalSnapshots.clear();
 }
-//# sourceMappingURL=slash-live-state.js.map

package/src/slash/subagent-cost.d.ts

@@ -27,4 +27,3 @@ export declare const SUBAGENT_COST_REPORT_VERSION: 1;
 export declare function collectSubagentCost(ctx: ExtensionContext, state: Pick<SubagentState, "baseCwd" | "artifactDirPreference">): SubagentCostReport;
 /** The `/subagent-cost` text rendering of a collected report. */
 export declare function formatSubagentCostReport(report: SubagentCostReport): string;
-//# sourceMappingURL=subagent-cost.d.ts.map

package/src/slash/subagent-cost.js

@@ -308,4 +308,3 @@ export function formatSubagentCostReport(report) {
     lines.push("────────────────────────────", formatCostUsage("Children", report.childTotal), formatCostUsage("Total", report.total));
     return lines.join("\n");
 }
-//# sourceMappingURL=subagent-cost.js.map

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

@@ -1,3 +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>;
-//# sourceMappingURL=subagents-admin.d.ts.map

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) {
@@ -452,4 +452,3 @@ export async function openSubagentsAdmin(pi, ctx, args = "") {
         sendAdminMessage(pi, `Failed to update '${agent.name}': ${message}`);
     }
 }
-//# sourceMappingURL=subagents-admin.js.map

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-status.d.ts

@@ -90,4 +90,3 @@ export declare class SubagentFleetStatus {
     private clearWorkflowCoverage;
 }
 export {};
-//# sourceMappingURL=fleet-status.d.ts.map

package/src/tui/fleet-status.js

@@ -1130,4 +1130,3 @@ export class SubagentFleetStatus {
             this.onWorkflowCoverageChange?.(this.ui, new Map());
     }
 }
-//# sourceMappingURL=fleet-status.js.map

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

@@ -49,4 +49,3 @@ export declare function renderFleetTranscript(transcript: FleetTranscript, width
     expandedTools?: boolean;
 }): string[];
 export {};
-//# sourceMappingURL=fleet-transcript.d.ts.map

package/src/tui/fleet-transcript.js

@@ -499,4 +499,3 @@ export function renderFleetTranscript(transcript, width, theme, markdownTheme, o
         lines.pop();
     return lines;
 }
-//# sourceMappingURL=fleet-transcript.js.map

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";
@@ -111,11 +111,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 +138,7 @@ export declare class SubagentFleetComponent implements Component {
     private stopRefresh;
     private refresh;
     private moveSelection;
+    private selectItem;
     private selectedPromptAudit;
     private promptAuditItems;
     private selectedPromptText;
@@ -155,6 +153,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;
@@ -166,4 +165,3 @@ export declare class SubagentFleetComponent implements Component {
 }
 export declare function openSubagentFleet(ctx: ExtensionContext, state: SubagentState, options?: FleetViewOptions): Promise<void>;
 export {};
-//# sourceMappingURL=fleet.d.ts.map