@gotgenes/pi-subagents 6.17.1 → 6.18.0

package/src/tools/foreground-runner.ts

@@ -1,23 +1,23 @@
 import type { AgentToolResult } from "@earendil-works/pi-coding-agent";
-import type { AgentSpawnConfig } from "../agent-manager";
-import type { ParentSnapshot } from "../parent-snapshot";
-import type { AgentRecord } from "../types";
-import { AgentActivityTracker } from "../ui/agent-activity-tracker";
-import {
-  type AgentDetails,
-  describeActivity,
-  formatMs,
-  SPINNER,
-} from "../ui/display";
-import { subscribeUIObserver } from "../ui/ui-observer";
-import type { AgentActivityAccess } from "./agent-tool";
+import type { AgentSpawnConfig } from "#src/lifecycle/agent-manager";
+import type { ParentSnapshot } from "#src/lifecycle/parent-snapshot";
+import type { AgentActivityAccess } from "#src/tools/agent-tool";
 import {
   buildDetails,
   formatLifetimeTokens,
   getStatusNote,
   textResult,
-} from "./helpers";
-import type { ResolvedSpawnConfig } from "./spawn-config";
+} from "#src/tools/helpers";
+import type { ResolvedSpawnConfig } from "#src/tools/spawn-config";
+import type { AgentRecord } from "#src/types";
+import { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
+import {
+  type AgentDetails,
+  describeActivity,
+  formatMs,
+  SPINNER,
+} from "#src/ui/display";
+import { subscribeUIObserver } from "#src/ui/ui-observer";
 
 /** Narrow manager interface for the foreground runner. */
 export interface ForegroundManagerDeps {
@@ -80,6 +80,7 @@ export async function runForeground(
     };
     onUpdate?.({
       content: [{ type: "text", text: `${toolUses} tool uses...` }],
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- Pi SDK ToolCallUpdate details type is not exported
       details: details as any,
     });
   };
@@ -151,7 +152,7 @@ export async function runForeground(
   if (tokenText) statsParts.push(tokenText);
   return textResult(
     `${fallbackNote}Agent completed in ${formatMs(durationMs)} (${statsParts.join(", ")})${getStatusNote(record.status)}.\n\n` +
-      (record.result?.trim() || "No output."),
+      (record.result?.trim() ?? "No output."),
     details,
   );
 }

package/src/tools/get-result-tool.ts

@@ -1,10 +1,10 @@
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
 import { Type } from "@sinclair/typebox";
-import type { AgentConfigLookup } from "../agent-types";
-import type { AgentRecord } from "../types";
-import { formatDuration, getDisplayName } from "../ui/display";
-import { getSessionContextPercent } from "../usage";
-import { formatLifetimeTokens, textResult } from "./helpers";
+import type { AgentConfigLookup } from "#src/config/agent-types";
+import { getSessionContextPercent } from "#src/lifecycle/usage";
+import { formatLifetimeTokens, textResult } from "#src/tools/helpers";
+import type { AgentRecord } from "#src/types";
+import { formatDuration, getDisplayName } from "#src/ui/display";
 
 /** Create the get_subagent_result tool definition (without Pi SDK wrapper). */
 export function createGetResultTool(
@@ -79,7 +79,7 @@ export function createGetResultTool(
       } else if (record.status === "error") {
         output += `Error: ${record.error}`;
       } else {
-        output += record.result?.trim() || "No output.";
+        output += record.result?.trim() ?? "No output.";
       }
 
       // Mark result as consumed — suppresses the completion notification

package/src/tools/helpers.ts

@@ -1,7 +1,7 @@
-import type { AgentConfigLookup } from "../agent-types";
-import { AgentActivityTracker } from "../ui/agent-activity-tracker";
-import { type AgentDetails, formatTokens } from "../ui/display";
-import { getLifetimeTotal, type LifetimeUsage } from "../usage";
+import type { AgentConfigLookup } from "#src/config/agent-types";
+import { getLifetimeTotal, type LifetimeUsage } from "#src/lifecycle/usage";
+import { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
+import { type AgentDetails, formatTokens } from "#src/ui/display";
 
 /** Parenthetical status note for completed agent result text. */
 export function getStatusNote(status: string): string {

package/src/tools/spawn-config.ts

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-argument -- Pi SDK types are not fully exported; see upstream Pi SDK for type improvements */
 /**
  * spawn-config.ts — Pure config resolution for the Agent tool.
  *
@@ -7,17 +8,17 @@
  */
 
 import type { Model } from "@earendil-works/pi-ai";
-import { normalizeMaxTurns } from "../agent-runner";
-import type { AgentTypeRegistry } from "../agent-types";
-import { resolveAgentInvocationConfig } from "../invocation-config";
-import { resolveInvocationModel } from "../model-resolver";
-import type { AgentInvocation, IsolationMode, SubagentType, ThinkingLevel } from "../types";
+import type { AgentTypeRegistry } from "#src/config/agent-types";
+import { resolveAgentInvocationConfig } from "#src/config/invocation-config";
+import { normalizeMaxTurns } from "#src/lifecycle/agent-runner";
+import { resolveInvocationModel } from "#src/session/model-resolver";
+import type { AgentInvocation, IsolationMode, SubagentType, ThinkingLevel } from "#src/types";
 import {
   type AgentDetails,
   buildInvocationTags,
   getDisplayName,
   getPromptModeLabel,
-} from "../ui/display";
+} from "#src/ui/display";
 
 /** Model info extracted from the parent session context. */
 export interface ModelInfo {

package/src/tools/steer-tool.ts

@@ -1,8 +1,8 @@
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
 import { Type } from "@sinclair/typebox";
-import type { AgentRecord } from "../types";
-import { getSessionContextPercent } from "../usage";
-import { formatLifetimeTokens, textResult } from "./helpers";
+import { getSessionContextPercent } from "#src/lifecycle/usage";
+import { formatLifetimeTokens, textResult } from "#src/tools/helpers";
+import type { AgentRecord } from "#src/types";
 
 /** Create the steer_subagent tool definition (without Pi SDK wrapper). */
 export function createSteerTool(

package/src/types.ts

@@ -5,7 +5,7 @@
 import type { ThinkingLevel } from "@earendil-works/pi-ai";
 
 
-export { AgentRecord } from "./agent-record";
+export { AgentRecord } from "#src/lifecycle/agent-record";
 export type { ThinkingLevel };
 
 /** Agent type: any string name (built-in defaults or user-defined). */

package/src/ui/agent-activity-tracker.ts

@@ -5,7 +5,7 @@
  * in `ui-observer.ts`. Callers use named transition methods; readers use read-only accessors.
  */
 
-import type { SessionLike } from "../usage";
+import type { SessionLike } from "#src/lifecycle/usage";
 
 /** Per-agent live activity state with explicit transition methods and read-only accessors. */
 export class AgentActivityTracker {

package/src/ui/agent-config-editor.ts

@@ -7,10 +7,10 @@
 
 import { join } from "node:path";
 
-import type { AgentTypeRegistry } from "../agent-types";
-import type { AgentConfig } from "../types";
-import type { AgentFileOps } from "./agent-file-ops";
-import type { MenuUI } from "./agent-menu";
+import type { AgentTypeRegistry } from "#src/config/agent-types";
+import type { AgentConfig } from "#src/types";
+import type { AgentFileOps } from "#src/ui/agent-file-ops";
+import type { MenuUI } from "#src/ui/agent-menu";
 
 // ---- Factory ----
 
@@ -115,7 +115,7 @@ export function createAgentConfigEditor(
     const fmFields: string[] = [];
     fmFields.push(`description: ${cfg.description}`);
     if (cfg.displayName) fmFields.push(`display_name: ${cfg.displayName}`);
-    fmFields.push(`tools: ${cfg.builtinToolNames?.join(", ") || "all"}`);
+    fmFields.push(`tools: ${cfg.builtinToolNames?.join(", ") ?? "all"}`);
     if (cfg.model) fmFields.push(`model: ${cfg.model}`);
     if (cfg.thinking) fmFields.push(`thinking: ${cfg.thinking}`);
     if (cfg.maxTurns) fmFields.push(`max_turns: ${cfg.maxTurns}`);
@@ -174,6 +174,7 @@ export function createAgentConfigEditor(
     ui.notify(`Disabled ${name} (${targetPath})`, "info");
   }
 
+  // eslint-disable-next-line @typescript-eslint/require-await
   async function enableAgent(ui: MenuUI, name: string) {
     const file = fileOps.findAgentFile(name, agentDirs());
     if (!file) return;

package/src/ui/agent-creation-wizard.ts

@@ -7,11 +7,11 @@
 
 import { join } from "node:path";
 
-import { BUILTIN_TOOL_NAMES } from "../agent-types";
-import type { ParentSnapshot } from "../parent-snapshot";
-import type { AgentRecord } from "../types";
-import type { AgentFileOps } from "./agent-file-ops";
-import type { MenuUI } from "./agent-menu";
+import { BUILTIN_TOOL_NAMES } from "#src/config/agent-types";
+import type { ParentSnapshot } from "#src/lifecycle/parent-snapshot";
+import type { AgentRecord } from "#src/types";
+import type { AgentFileOps } from "#src/ui/agent-file-ops";
+import type { MenuUI } from "#src/ui/agent-menu";
 
 // ---- Deps interface ----
 

package/src/ui/agent-menu.ts

@@ -1,13 +1,14 @@
+/* eslint-disable @typescript-eslint/no-unsafe-assignment -- Pi SDK types are not fully exported; see upstream Pi SDK for type improvements */
 import { wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import { AgentTypeRegistry } from "../agent-types";
-import type { ModelRegistry } from "../model-resolver";
-import type { ParentSnapshot } from "../parent-snapshot";
-import type { AgentConfig, AgentRecord } from "../types";
-import type { AgentActivityTracker } from "./agent-activity-tracker";
-import { createAgentConfigEditor } from "./agent-config-editor";
-import { createAgentCreationWizard } from "./agent-creation-wizard";
-import type { AgentFileOps } from "./agent-file-ops";
-import { formatDuration, getDisplayName } from "./display";
+import { AgentTypeRegistry } from "#src/config/agent-types";
+import type { ParentSnapshot } from "#src/lifecycle/parent-snapshot";
+import type { ModelRegistry } from "#src/session/model-resolver";
+import type { AgentConfig, AgentRecord } from "#src/types";
+import type { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
+import { createAgentConfigEditor } from "#src/ui/agent-config-editor";
+import { createAgentCreationWizard } from "#src/ui/agent-creation-wizard";
+import type { AgentFileOps } from "#src/ui/agent-file-ops";
+import { formatDuration, getDisplayName } from "#src/ui/display";
 
 // ---- Deps interface ----
 

package/src/ui/agent-widget.ts

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-redundant-type-constituents -- Pi SDK types are not fully exported; see upstream Pi SDK for type improvements */
 /**
  * agent-widget.ts — Persistent widget showing running/completed agents above the editor.
  *
@@ -5,11 +6,11 @@
  * Uses the callback form of setWidget for themed rendering.
  */
 
-import type { AgentManager } from "../agent-manager";
-import { AgentTypeRegistry } from "../agent-types";
-import type { AgentActivityTracker } from "./agent-activity-tracker";
-import { ERROR_STATUSES, type Theme } from "./display";
-import { renderWidgetLines } from "./widget-renderer";
+import { AgentTypeRegistry } from "#src/config/agent-types";
+import type { AgentManager } from "#src/lifecycle/agent-manager";
+import type { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
+import { ERROR_STATUSES, type Theme } from "#src/ui/display";
+import { renderWidgetLines } from "#src/ui/widget-renderer";
 
 // ---- Types ----
 
@@ -76,9 +77,7 @@ export class AgentWidget {
   /** Ensure the widget update timer is running. */
   // fallow-ignore-next-line unused-class-member
   ensureTimer() {
-    if (!this.widgetInterval) {
-      this.widgetInterval = setInterval(() => this.update(), 80);
-    }
+    this.widgetInterval ??= setInterval(() => this.update(), 80);
   }
 
   /** Check if a finished agent should still be shown in the widget. */

package/src/ui/conversation-viewer.ts

@@ -7,12 +7,12 @@
 
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
 import { type Component, matchesKey, type TUI, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import type { AgentConfigLookup } from "../agent-types";
-import { extractText } from "../context";
-import type { AgentRecord } from "../types";
-import { getLifetimeTotal, getSessionContextPercent } from "../usage";
-import type { AgentActivityTracker } from "./agent-activity-tracker";
-import { buildInvocationTags, describeActivity, formatDuration, formatSessionTokens, getDisplayName, getPromptModeLabel, type Theme } from "./display";
+import type { AgentConfigLookup } from "#src/config/agent-types";
+import { getLifetimeTotal, getSessionContextPercent } from "#src/lifecycle/usage";
+import { extractText } from "#src/session/context";
+import type { AgentRecord } from "#src/types";
+import type { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
+import { buildInvocationTags, describeActivity, formatDuration, formatSessionTokens, getDisplayName, getPromptModeLabel, type Theme } from "#src/ui/display";
 
 // ── Local message-shape types ───────────────────────────────────────────────
 // The Pi SDK does not export narrow types for all message content variants.
@@ -299,7 +299,7 @@ export class ConversationViewer implements Component {
       } else if (isBashExecution(msg)) {
         if (needsSeparator) lines.push(th.fg("dim", "───"));
         lines.push(truncateToWidth(th.fg("muted", `  $ ${msg.command}`), width));
-        if (msg.output?.trim()) {
+        if (msg.output.trim()) {
           const out = msg.output.length > 500
             ? msg.output.slice(0, 500) + "... (truncated)"
             : msg.output;

package/src/ui/display.ts

@@ -5,8 +5,8 @@
  * Consumed by the widget, the menu, tool modules, and the notification renderer.
  */
 
-import type { AgentConfigLookup } from "../agent-types";
-import type { AgentInvocation, SubagentType } from "../types";
+import type { AgentConfigLookup } from "#src/config/agent-types";
+import type { AgentInvocation, SubagentType } from "#src/types";
 
 // ---- Types ----
 

package/src/ui/ui-observer.ts

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-argument -- Pi SDK types are not fully exported; see upstream Pi SDK for type improvements */
 /**
  * ui-observer.ts — Subscribes to session events and updates AgentActivityTracker state.
  *
@@ -6,7 +7,7 @@
  * turn count, lifetime usage).
  */
 
-import type { AgentActivityTracker } from "./agent-activity-tracker";
+import type { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
 
 /** Narrow session interface — only the subscribe method needed by the observer. */
 interface SubscribableSession {

package/src/ui/widget-renderer.ts

@@ -6,10 +6,10 @@
  */
 
 import { truncateToWidth } from "@earendil-works/pi-tui";
-import type { AgentConfigLookup } from "../agent-types";
-import type { SubagentType } from "../types";
-import type { LifetimeUsage, SessionLike } from "../usage";
-import { getLifetimeTotal, getSessionContextPercent } from "../usage";
+import type { AgentConfigLookup } from "#src/config/agent-types";
+import type { LifetimeUsage, SessionLike } from "#src/lifecycle/usage";
+import { getLifetimeTotal, getSessionContextPercent } from "#src/lifecycle/usage";
+import type { SubagentType } from "#src/types";
 import {
 	describeActivity,
 	formatMs,
@@ -19,7 +19,7 @@ import {
 	getPromptModeLabel,
 	SPINNER,
 	type Theme,
-} from "./display";
+} from "#src/ui/display";
 
 // ── Data interfaces ──────────────────────────────────────────────────────────