portable-agent-layer 0.83.0 → 0.84.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.83.0",
+  "version": "0.84.0",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {

package/src/hooks/lib/interaction.ts

@@ -51,6 +51,7 @@ export interface TurnEvent extends MoodTurn {
   reaction: Reaction | null;
   mood?: string;
   hinted?: boolean;
+  runtime?: string;
 }
 
 interface SessionTrack {

package/src/tools/agent/interaction.ts

@@ -15,7 +15,8 @@ const HELP = `
   PAL Interaction report
 
   Reads the measured turns in memory/signals/interaction/ (features only, no
-  text) and prints turns, channels, reactions, the hints sent, and for each
+  text) and prints turns, channels, reactions, the hints sent, per agent the
+  turns, replies filed and hints sent, and for each
   label (short, long, fast, skimming, friction) how the replies written while
   it was active compare with the replies written while none was.
 

package/src/tools/lib/interaction-report.ts

@@ -22,10 +22,17 @@ interface ReplyStats {
   correctedShare: number;
 }
 
+interface AgentCounts {
+  turns: number;
+  replies: number;
+  hints: number;
+}
+
 export interface InteractionSummary {
   turns: number;
   sessions: number;
   channels: Record<string, number>;
+  agents: Record<string, AgentCounts>;
   reactions: Record<string, number>;
   hints: Record<string, number>;
   unlogged: number;
@@ -70,6 +77,20 @@ function repliesUnderMood(events: TurnEvent[]): ReplyUnderMood[] {
   return replies;
 }
 
+/** A turn carries the reply that answered the turn before it, so a filed reply shows up there. */
+function byAgent(events: TurnEvent[]): Record<string, AgentCounts> {
+  const agents: Record<string, AgentCounts> = {};
+  for (const e of events) {
+    const agent = e.runtime ?? "unknown";
+    const counts = agents[agent] ?? { turns: 0, replies: 0, hints: 0 };
+    agents[agent] = counts;
+    counts.turns++;
+    if (e.reply) counts.replies++;
+    if (e.hinted) counts.hints++;
+  }
+  return agents;
+}
+
 export function summarize(events: TurnEvent[]): InteractionSummary {
   const replies = repliesUnderMood(events);
   const hinted = events.filter((e) => e.hinted);
@@ -77,6 +98,7 @@ export function summarize(events: TurnEvent[]): InteractionSummary {
     turns: events.length,
     sessions: new Set(events.map((e) => e.session)).size,
     channels: tally(events.map((e) => e.channel ?? "unknown")),
+    agents: byAgent(events),
     reactions: tally(events.flatMap((e) => (e.reaction ? [e.reaction] : []))),
     hints: tally(hinted.map((e) => e.mood || "back to usual")),
     unlogged: events.filter((e) => e.mood === undefined).length,
@@ -119,8 +141,20 @@ function labelLine(label: string, s: ReplyStats, usual: ReplyStats): string {
   ].join(" · ");
 }
 
-function plural(n: number, noun: string): string {
-  return `${n} ${noun}${n === 1 ? "" : "s"}`;
+function plural(n: number, noun: string, nouns = `${noun}s`): string {
+  return `${n} ${n === 1 ? noun : nouns}`;
+}
+
+function agentLines(agents: Record<string, AgentCounts>): string[] {
+  return Object.entries(agents)
+    .sort(([, a], [, b]) => b.turns - a.turns)
+    .map(([agent, c]) =>
+      [
+        `  ${agent.padEnd(9)} ${plural(c.turns, "turn")}`,
+        `${plural(c.replies, "reply", "replies")} filed`,
+        `${plural(c.hints, "hint")} sent`,
+      ].join(" · ")
+    );
 }
 
 export function reportLines(summary: InteractionSummary, days: number): string[] {
@@ -132,6 +166,9 @@ export function reportLines(summary: InteractionSummary, days: number): string[]
     `Reactions: ${shares(summary.reactions)}`,
     `Hints sent: ${counts(summary.hints)}`,
     "",
+    "By agent:",
+    ...agentLines(summary.agents),
+    "",
     "Replies written while a label was active, against replies while none was:",
     ...LABELS.map((label) => labelLine(label, summary.byLabel[label], summary.usual)),
   ];