@ian-pascoe/pi-minimal-subagents 0.11.0 → 0.13.0

package/src/minimal-subagents-types.ts

@@ -41,11 +41,16 @@ export interface SpawnParameters {
   delegation?: DelegationMode;
 }
 
-/** Returns persistent agent and turn identities immediately after launch scheduling. */
-export interface SpawnResult {
+/** Returns persistent agent and turn identities plus the resolved grant immediately after launch scheduling. */
+export interface SpawnResult extends RuntimeProfile {
   agent_id: string;
   turn_id: string;
   status: "running";
+  /** Concrete ordinary tools granted by the Launch Contract. */
+  tools: string[];
+  delegation: DelegationMode;
+  /** Non-fatal tool-resolution warnings, such as skipped configured tools. */
+  warnings?: string[];
 }
 
 /** Retains one keyed terminal turn result for waits and durable delivery recovery. */
@@ -59,13 +64,18 @@ export interface TurnResult {
   elapsed_ms?: number;
 }
 
-/** Reports whether one direct message was handed to a wait, queued, or failed. */
-export type AgentMessageDisposition = "delivered-via-wait" | "queued" | "failed";
+/**
+ * Reports whether one direct message was handed to a wait, queued into an active turn, started a
+ * new turn on an idle recipient, or failed.
+ */
+export type AgentMessageDisposition = "delivered-via-wait" | "queued" | "started-turn" | "failed";
 
 export interface AgentMessageResult {
   agent_id: string;
   message_id: string;
   disposition: AgentMessageDisposition;
+  /** Turn started on an idle recipient; present only for `started-turn`. */
+  turn_id?: string;
   error?: string;
 }
 
@@ -112,7 +122,8 @@ export interface AgentSummary extends RuntimeProfile {
   latest_activity_at?: string;
   task?: string;
   child_count: number;
-  children: AgentSummary[];
+  /** Nested summaries; omitted from caller-scoped status, which reports only `child_count`. */
+  children?: AgentSummary[];
 }
 
 /** Provides bounded recent child conversation text for detailed status. */
@@ -129,6 +140,12 @@ export interface RecentAgentActivity {
   truncated: boolean;
 }
 
+/** Live progress of a Child Agent's running turn, shown while its parent waits. */
+export interface ActiveTurnProgress {
+  turn_id: string;
+  tool_calls: number;
+}
+
 /** Holds the complete selected-branch Child Session Transcript for trusted status UI. */
 export interface ChildAgentTranscriptSnapshot {
   messages: AgentMessage[];

package/src/minimal-subagents-ui.ts

@@ -59,7 +59,7 @@ function flattenAgentHierarchy(agents: readonly AgentSummary[]): FlattenedAgentS
   const flattened: FlattenedAgentSummary[] = [];
   const visit = (agent: AgentSummary, depth: number, parentId?: string) => {
     flattened.push({ agent, depth, parentId, order: flattened.length });
-    for (const child of agent.children) visit(child, depth + 1, agent.agent_id);
+    for (const child of agent.children ?? []) visit(child, depth + 1, agent.agent_id);
   };
   for (const agent of agents) visit(agent, 0);
   return flattened;

package/src/minimal-subagents-usage.ts

@@ -1,17 +1,28 @@
 import type { Usage } from "@earendil-works/pi-ai";
 
+/** Return a clone with optional counters present, so every reported usage has one shape. */
+export function normalizeMinimalSubagentsUsage(usage: Usage): Usage {
+  return {
+    ...structuredClone(usage),
+    cacheWrite1h: usage.cacheWrite1h ?? 0,
+    reasoning: usage.reasoning ?? 0,
+  };
+}
+
 /** Add two optional Pi usage totals without retaining mutable references to either input. */
 export function addMinimalSubagentsUsage(
   left: Usage | undefined,
   right: Usage | undefined,
 ): Usage | undefined {
-  if (!left) return right ? structuredClone(right) : undefined;
-  if (!right) return structuredClone(left);
+  if (!left) return right ? normalizeMinimalSubagentsUsage(right) : undefined;
+  if (!right) return normalizeMinimalSubagentsUsage(left);
   return {
     input: left.input + right.input,
     output: left.output + right.output,
     cacheRead: left.cacheRead + right.cacheRead,
     cacheWrite: left.cacheWrite + right.cacheWrite,
+    cacheWrite1h: (left.cacheWrite1h ?? 0) + (right.cacheWrite1h ?? 0),
+    reasoning: (left.reasoning ?? 0) + (right.reasoning ?? 0),
     totalTokens: left.totalTokens + right.totalTokens,
     cost: {
       input: left.cost.input + right.cost.input,