npm - github-issue-tower-defence-management - Versions diffs - 1.117.9 → 1.118.0 - Mend

github-issue-tower-defence-management 1.117.9 → 1.118.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/src/adapter/entry-points/console/ui-dist/index.html CHANGED Viewed

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>TDPM Console</title>
-    <script type="module" crossorigin src="/assets/index-DID_sTas.js"></script>
+    <script type="module" crossorigin src="/assets/index-DWiG7btO.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-BMe1bEF4.css">
   </head>
   <body>

package/src/adapter/entry-points/handlers/HandleScheduledEventUseCaseHandler.ts CHANGED Viewed

@@ -121,8 +121,10 @@ export class HandleScheduledEventUseCaseHandler {
       candidateDebounceStateFilePath?: string;
       activeHubTaskStatus?: string;
       silentMainStalledMessage?: string;
-      silentSubAgentMessageHeader?: string;
-      silentSubAgentMessageFooter?: string;
+      silentSubAgentIdleMessageHeader?: string;
+      silentSubAgentIdleMessageFooter?: string;
+      silentSubAgentLongRunningMessageHeader?: string;
+      silentSubAgentLongRunningMessageFooter?: string;
       credentials: {
         manager: {
           github: {
@@ -629,13 +631,21 @@ export class HandleScheduledEventUseCaseHandler {
               mergedInput.silentMainStalledMessage ??
               process.env.TDPM_SILENT_MAIN_STALLED_MESSAGE ??
               null,
-            subAgentMessageHeader:
-              mergedInput.silentSubAgentMessageHeader ??
-              process.env.TDPM_SILENT_SUBAGENT_MESSAGE_HEADER ??
+            subAgentIdleMessageHeader:
+              mergedInput.silentSubAgentIdleMessageHeader ??
+              process.env.TDPM_SILENT_SUBAGENT_IDLE_MESSAGE_HEADER ??
               null,
-            subAgentMessageFooter:
-              mergedInput.silentSubAgentMessageFooter ??
-              process.env.TDPM_SILENT_SUBAGENT_MESSAGE_FOOTER ??
+            subAgentIdleMessageFooter:
+              mergedInput.silentSubAgentIdleMessageFooter ??
+              process.env.TDPM_SILENT_SUBAGENT_IDLE_MESSAGE_FOOTER ??
+              null,
+            subAgentLongRunningMessageHeader:
+              mergedInput.silentSubAgentLongRunningMessageHeader ??
+              process.env.TDPM_SILENT_SUBAGENT_LONG_RUNNING_MESSAGE_HEADER ??
+              null,
+            subAgentLongRunningMessageFooter:
+              mergedInput.silentSubAgentLongRunningMessageFooter ??
+              process.env.TDPM_SILENT_SUBAGENT_LONG_RUNNING_MESSAGE_FOOTER ??
               null,
           },
           now: inTmuxNow,

package/src/adapter/entry-points/handlers/notifySilentTmuxSessions.test.ts CHANGED Viewed

@@ -20,8 +20,10 @@ const CLAUDE_PID = 201;
 const EMPTY_TEMPLATES: SilentSessionMessageTemplates = {
   mainStalledMessage: null,
-  subAgentMessageHeader: null,
-  subAgentMessageFooter: null,
+  subAgentIdleMessageHeader: null,
+  subAgentIdleMessageFooter: null,
+  subAgentLongRunningMessageHeader: null,
+  subAgentLongRunningMessageFooter: null,
 };
 type Mocked<T> = jest.Mocked<T> & jest.MockedObject<T>;
@@ -214,8 +216,10 @@ describe('notifySilentTmuxSessions', () => {
       ...baseParams(runner),
       messageTemplates: {
         mainStalledMessage: 'CUSTOM_MAIN_TEMPLATE',
-        subAgentMessageHeader: null,
-        subAgentMessageFooter: null,
+        subAgentIdleMessageHeader: null,
+        subAgentIdleMessageFooter: null,
+        subAgentLongRunningMessageHeader: null,
+        subAgentLongRunningMessageFooter: null,
       },
     });

package/src/adapter/repositories/ConfigurableSilentSessionMessageComposer.test.ts CHANGED Viewed

@@ -4,20 +4,29 @@ import { SILENT_SESSION_REMINDER_SENTINEL } from '../../domain/usecases/silentSe
 type Mocked<T> = jest.Mocked<T> & jest.MockedObject<T>;
+const THRESHOLDS = {
+  subAgentSilentThresholdSeconds: 300,
+  subAgentRunningThresholdSeconds: 900,
+};
 const createFallback = (): Mocked<SilentSessionMessageComposer> => ({
   composeMainStalledSection: jest.fn().mockReturnValue('FALLBACK_MAIN'),
   composeSubAgentSection: jest.fn().mockReturnValue('FALLBACK_SUB'),
 });
+const noTemplates = {
+  mainStalledMessage: null,
+  subAgentIdleMessageHeader: null,
+  subAgentIdleMessageFooter: null,
+  subAgentLongRunningMessageHeader: null,
+  subAgentLongRunningMessageFooter: null,
+};
 describe('ConfigurableSilentSessionMessageComposer', () => {
   it('uses the fallback main section when no main template is configured', () => {
     const fallback = createFallback();
     const composer = new ConfigurableSilentSessionMessageComposer(
-      {
-        mainStalledMessage: null,
-        subAgentMessageHeader: null,
-        subAgentMessageFooter: null,
-      },
+      noTemplates,
       fallback,
     );
     expect(composer.composeMainStalledSection(600)).toBe('FALLBACK_MAIN');
@@ -28,9 +37,8 @@ describe('ConfigurableSilentSessionMessageComposer', () => {
     const fallback = createFallback();
     const composer = new ConfigurableSilentSessionMessageComposer(
       {
+        ...noTemplates,
         mainStalledMessage: 'CUSTOM_MAIN',
-        subAgentMessageHeader: null,
-        subAgentMessageFooter: null,
       },
       fallback,
     );
@@ -40,52 +48,97 @@ describe('ConfigurableSilentSessionMessageComposer', () => {
     expect(fallback.composeMainStalledSection).not.toHaveBeenCalled();
   });
-  it('uses the fallback sub-agent section when neither header nor footer is configured', () => {
+  it('uses the fallback sub-agent section when no sub-agent template is configured', () => {
     const fallback = createFallback();
     const composer = new ConfigurableSilentSessionMessageComposer(
-      {
-        mainStalledMessage: null,
-        subAgentMessageHeader: null,
-        subAgentMessageFooter: null,
-      },
+      noTemplates,
       fallback,
     );
     expect(
-      composer.composeSubAgentSection([
-        { label: 'task-a', silentSeconds: 360, runningSeconds: 1200 },
-      ]),
+      composer.composeSubAgentSection(
+        [{ label: 'task-a', silentSeconds: 360, runningSeconds: 1200 }],
+        THRESHOLDS,
+      ),
     ).toBe('FALLBACK_SUB');
+    expect(fallback.composeSubAgentSection).toHaveBeenCalledWith(
+      [{ label: 'task-a', silentSeconds: 360, runningSeconds: 1200 }],
+      THRESHOLDS,
+    );
   });
-  it('renders the configured sub-agent header, list, and footer', () => {
+  it('renders the configured idle header, list, and footer for an idle sub-agent', () => {
     const fallback = createFallback();
     const composer = new ConfigurableSilentSessionMessageComposer(
       {
-        mainStalledMessage: null,
-        subAgentMessageHeader: 'HEADER',
-        subAgentMessageFooter: 'FOOTER',
+        ...noTemplates,
+        subAgentIdleMessageHeader: 'IDLE_HEADER',
+        subAgentIdleMessageFooter: 'IDLE_FOOTER',
       },
       fallback,
     );
-    const section = composer.composeSubAgentSection([
-      { label: 'task-a', silentSeconds: 360, runningSeconds: 1200 },
-    ]);
-    expect(section).toContain('HEADER');
+    const section = composer.composeSubAgentSection(
+      [{ label: 'task-a', silentSeconds: 360, runningSeconds: 60 }],
+      THRESHOLDS,
+    );
+    expect(section).toContain('IDLE_HEADER');
     expect(section).toContain('task-a');
-    expect(section).toContain('silent for 6m');
+    expect(section).toContain('no output for 6m');
+    expect(section).toContain('IDLE_FOOTER');
+    expect(section).toContain(SILENT_SESSION_REMINDER_SENTINEL);
+    expect(fallback.composeSubAgentSection).not.toHaveBeenCalled();
+  });
+  it('renders the configured long-running header, list, and footer for a long-running sub-agent', () => {
+    const fallback = createFallback();
+    const composer = new ConfigurableSilentSessionMessageComposer(
+      {
+        ...noTemplates,
+        subAgentLongRunningMessageHeader: 'LONG_HEADER',
+        subAgentLongRunningMessageFooter: 'LONG_FOOTER',
+      },
+      fallback,
+    );
+    const section = composer.composeSubAgentSection(
+      [{ label: 'task-b', silentSeconds: 30, runningSeconds: 1200 }],
+      THRESHOLDS,
+    );
+    expect(section).toContain('LONG_HEADER');
+    expect(section).toContain('task-b');
     expect(section).toContain('running for 20m');
-    expect(section).toContain('FOOTER');
+    expect(section).toContain('LONG_FOOTER');
     expect(section).toContain(SILENT_SESSION_REMINDER_SENTINEL);
     expect(fallback.composeSubAgentSection).not.toHaveBeenCalled();
   });
+  it('emits both distinct configured sections for a sub-agent matching both conditions', () => {
+    const fallback = createFallback();
+    const composer = new ConfigurableSilentSessionMessageComposer(
+      {
+        ...noTemplates,
+        subAgentIdleMessageHeader: 'IDLE_HEADER',
+        subAgentLongRunningMessageHeader: 'LONG_HEADER',
+      },
+      fallback,
+    );
+    const section = composer.composeSubAgentSection(
+      [{ label: 'task-both', silentSeconds: 360, runningSeconds: 1200 }],
+      THRESHOLDS,
+    );
+    const [idleSection, longRunningSection] = section
+      .replace(`${SILENT_SESSION_REMINDER_SENTINEL} `, '')
+      .split('\n\n');
+    expect(idleSection).toContain('IDLE_HEADER');
+    expect(idleSection).toContain('no output for 6m');
+    expect(longRunningSection).toContain('LONG_HEADER');
+    expect(longRunningSection).toContain('running for 20m');
+  });
   it('does not double-prepend the sentinel when the template already carries it', () => {
     const fallback = createFallback();
     const composer = new ConfigurableSilentSessionMessageComposer(
       {
+        ...noTemplates,
         mainStalledMessage: `${SILENT_SESSION_REMINDER_SENTINEL} CUSTOM_MAIN`,
-        subAgentMessageHeader: null,
-        subAgentMessageFooter: null,
       },
       fallback,
     );

package/src/adapter/repositories/ConfigurableSilentSessionMessageComposer.ts CHANGED Viewed

@@ -1,5 +1,8 @@
 import { SubAgentActivity } from '../../domain/entities/LiveSessionActivitySnapshot';
-import { SilentSessionMessageComposer } from '../../domain/usecases/adapter-interfaces/SilentSessionMessageComposer';
+import {
+  SilentSessionMessageComposer,
+  SubAgentStallThresholds,
+} from '../../domain/usecases/adapter-interfaces/SilentSessionMessageComposer';
 import { SILENT_SESSION_REMINDER_SENTINEL } from '../../domain/usecases/silentSessionReminderSentinel';
 const withReminderSentinel = (message: string): string =>
@@ -9,8 +12,10 @@ const withReminderSentinel = (message: string): string =>
 export type SilentSessionMessageTemplates = {
   mainStalledMessage: string | null;
-  subAgentMessageHeader: string | null;
-  subAgentMessageFooter: string | null;
+  subAgentIdleMessageHeader: string | null;
+  subAgentIdleMessageFooter: string | null;
+  subAgentLongRunningMessageHeader: string | null;
+  subAgentLongRunningMessageFooter: string | null;
 };
 const formatMinutes = (seconds: number): string => {
@@ -31,27 +36,94 @@ export class ConfigurableSilentSessionMessageComposer implements SilentSessionMe
     return withReminderSentinel(this.templates.mainStalledMessage);
   };
-  composeSubAgentSection = (subAgents: SubAgentActivity[]): string => {
-    if (
-      this.templates.subAgentMessageHeader === null &&
-      this.templates.subAgentMessageFooter === null
-    ) {
-      return this.fallback.composeSubAgentSection(subAgents);
+  composeSubAgentSection = (
+    subAgents: SubAgentActivity[],
+    thresholds: SubAgentStallThresholds,
+  ): string => {
+    const hasIdleTemplate =
+      this.templates.subAgentIdleMessageHeader !== null ||
+      this.templates.subAgentIdleMessageFooter !== null;
+    const hasLongRunningTemplate =
+      this.templates.subAgentLongRunningMessageHeader !== null ||
+      this.templates.subAgentLongRunningMessageFooter !== null;
+    if (!hasIdleTemplate && !hasLongRunningTemplate) {
+      return this.fallback.composeSubAgentSection(subAgents, thresholds);
     }
-    const lines = subAgents.map(
+    const idleSubAgents = subAgents.filter(
+      (subAgent) =>
+        subAgent.silentSeconds >= thresholds.subAgentSilentThresholdSeconds,
+    );
+    const longRunningSubAgents = subAgents.filter(
       (subAgent) =>
-        `- ${subAgent.label}: silent for ${formatMinutes(
-          subAgent.silentSeconds,
-        )}, running for ${formatMinutes(subAgent.runningSeconds)}`,
+        subAgent.runningSeconds >= thresholds.subAgentRunningThresholdSeconds,
     );
     const sections: string[] = [];
-    if (this.templates.subAgentMessageHeader !== null) {
-      sections.push(this.templates.subAgentMessageHeader);
+    if (idleSubAgents.length > 0 && hasIdleTemplate) {
+      sections.push(
+        this.composeIdleSection(
+          idleSubAgents,
+          this.templates.subAgentIdleMessageHeader,
+          this.templates.subAgentIdleMessageFooter,
+        ),
+      );
+    } else if (idleSubAgents.length > 0) {
+      sections.push(this.composeIdleSection(idleSubAgents, null, null));
+    }
+    if (longRunningSubAgents.length > 0 && hasLongRunningTemplate) {
+      sections.push(
+        this.composeLongRunningSection(
+          longRunningSubAgents,
+          this.templates.subAgentLongRunningMessageHeader,
+          this.templates.subAgentLongRunningMessageFooter,
+        ),
+      );
+    } else if (longRunningSubAgents.length > 0) {
+      sections.push(
+        this.composeLongRunningSection(longRunningSubAgents, null, null),
+      );
+    }
+    return withReminderSentinel(sections.join('\n\n'));
+  };
+  private composeIdleSection = (
+    idleSubAgents: SubAgentActivity[],
+    header: string | null,
+    footer: string | null,
+  ): string => {
+    const lines = idleSubAgents.map(
+      (subAgent) =>
+        `- ${subAgent.label}: no output for ${formatMinutes(subAgent.silentSeconds)}`,
+    );
+    const parts: string[] = [];
+    if (header !== null) {
+      parts.push(header);
+    }
+    parts.push(...lines);
+    if (footer !== null) {
+      parts.push(footer);
+    }
+    return parts.join('\n');
+  };
+  private composeLongRunningSection = (
+    longRunningSubAgents: SubAgentActivity[],
+    header: string | null,
+    footer: string | null,
+  ): string => {
+    const lines = longRunningSubAgents.map(
+      (subAgent) =>
+        `- ${subAgent.label}: running for ${formatMinutes(subAgent.runningSeconds)}`,
+    );
+    const parts: string[] = [];
+    if (header !== null) {
+      parts.push(header);
     }
-    sections.push(...lines);
-    if (this.templates.subAgentMessageFooter !== null) {
-      sections.push(this.templates.subAgentMessageFooter);
+    parts.push(...lines);
+    if (footer !== null) {
+      parts.push(footer);
     }
-    return withReminderSentinel(sections.join('\n'));
+    return parts.join('\n');
   };
 }

package/src/domain/usecases/DefaultSilentSessionMessageComposer.test.ts CHANGED Viewed

@@ -1,6 +1,11 @@
 import { DefaultSilentSessionMessageComposer } from './DefaultSilentSessionMessageComposer';
 import { SILENT_SESSION_REMINDER_SENTINEL } from './silentSessionReminderSentinel';
+const THRESHOLDS = {
+  subAgentSilentThresholdSeconds: 300,
+  subAgentRunningThresholdSeconds: 900,
+};
 describe('DefaultSilentSessionMessageComposer', () => {
   const composer = new DefaultSilentSessionMessageComposer();
@@ -10,9 +15,10 @@ describe('DefaultSilentSessionMessageComposer', () => {
   });
   it('embeds the reminder sentinel in the sub-agent section', () => {
-    const section = composer.composeSubAgentSection([
-      { label: 'sub-process-1', silentSeconds: 360, runningSeconds: 1200 },
-    ]);
+    const section = composer.composeSubAgentSection(
+      [{ label: 'sub-process-1', silentSeconds: 360, runningSeconds: 1200 }],
+      THRESHOLDS,
+    );
     expect(section).toContain(SILENT_SESSION_REMINDER_SENTINEL);
   });
@@ -99,23 +105,93 @@ describe('DefaultSilentSessionMessageComposer', () => {
     expect(section).not.toContain('""');
   });
-  it('lists each sub-agent with its silent and running minutes', () => {
-    const section = composer.composeSubAgentSection([
-      { label: 'sub-process-1', silentSeconds: 360, runningSeconds: 1200 },
-      { label: 'sub-process-2', silentSeconds: 0, runningSeconds: 960 },
-    ]);
-    expect(section).toContain('sub-process-1');
-    expect(section).toContain('silent for 6m');
+  it('emits a distinct idle message for a sub-agent that is only output-idle', () => {
+    const section = composer.composeSubAgentSection(
+      [{ label: 'sub-process-idle', silentSeconds: 360, runningSeconds: 60 }],
+      THRESHOLDS,
+    );
+    expect(section).toContain('sub-process-idle');
+    expect(section).toContain('no output for 6m');
+    expect(section).toContain('may be stalled');
+    expect(section).toContain('restart, hand off, or replace it');
+    expect(section).toContain('waiting on an external dependency');
+    expect(section).not.toContain('infinite loop');
+  });
+  it('emits a distinct long-running message for a sub-agent that has only run too long', () => {
+    const section = composer.composeSubAgentSection(
+      [
+        {
+          label: 'sub-process-long',
+          silentSeconds: 30,
+          runningSeconds: 1200,
+        },
+      ],
+      THRESHOLDS,
+    );
+    expect(section).toContain('sub-process-long');
     expect(section).toContain('running for 20m');
-    expect(section).toContain('sub-process-2');
-    expect(section).toContain('running for 16m');
+    expect(section).toContain('infinite loop');
+    expect(section).toContain('too large');
+    expect(section).toContain('not making forward progress');
+    expect(section).toContain(
+      'do not dismiss it merely because it produced output recently',
+    );
+    expect(section).toContain(
+      'break the task down, restart, hand off, or replace',
+    );
+  });
+  it('does not foreground the short idle time in the long-running message', () => {
+    const section = composer.composeSubAgentSection(
+      [
+        {
+          label: 'sub-process-long',
+          silentSeconds: 30,
+          runningSeconds: 1200,
+        },
+      ],
+      THRESHOLDS,
+    );
+    expect(section).not.toContain('no output for');
+    expect(section).not.toContain('silent for');
+  });
+  it('emits both distinct messages for a sub-agent matching both conditions, kept separate', () => {
+    const section = composer.composeSubAgentSection(
+      [{ label: 'sub-process-both', silentSeconds: 360, runningSeconds: 1200 }],
+      THRESHOLDS,
+    );
+    expect(section).toContain('no output for 6m');
+    expect(section).toContain('may be stalled');
+    expect(section).toContain('running for 20m');
+    expect(section).toContain('infinite loop');
+    const sentinelOccurrences =
+      section.split(SILENT_SESSION_REMINDER_SENTINEL).length - 1;
+    expect(sentinelOccurrences).toBe(2);
+  });
+  it('groups each sub-agent under the condition it matched', () => {
+    const section = composer.composeSubAgentSection(
+      [
+        { label: 'idle-only', silentSeconds: 360, runningSeconds: 60 },
+        { label: 'long-only', silentSeconds: 10, runningSeconds: 960 },
+      ],
+      THRESHOLDS,
+    );
+    const [idleSection, longRunningSection] = section.split('\n\n');
+    expect(idleSection).toContain('idle-only');
+    expect(idleSection).not.toContain('long-only');
+    expect(longRunningSection).toContain('long-only');
+    expect(longRunningSection).not.toContain('idle-only');
   });
   it('does not contain any host-specific or internal identifiers', () => {
     const mainSection = composer.composeMainStalledSection(600);
-    const subSection = composer.composeSubAgentSection([
-      { label: 'sub-process-1', silentSeconds: 360, runningSeconds: 1200 },
-    ]);
+    const subSection = composer.composeSubAgentSection(
+      [{ label: 'sub-process-1', silentSeconds: 360, runningSeconds: 1200 }],
+      THRESHOLDS,
+    );
     const combined = `${mainSection}\n${subSection}`.toLowerCase();
     expect(combined).not.toContain('claude');
     expect(combined).not.toContain('take ownership');

package/src/domain/usecases/DefaultSilentSessionMessageComposer.ts CHANGED Viewed

@@ -1,5 +1,8 @@
 import { SubAgentActivity } from '../entities/LiveSessionActivitySnapshot';
-import { SilentSessionMessageComposer } from './adapter-interfaces/SilentSessionMessageComposer';
+import {
+  SilentSessionMessageComposer,
+  SubAgentStallThresholds,
+} from './adapter-interfaces/SilentSessionMessageComposer';
 import { SILENT_SESSION_REMINDER_SENTINEL } from './silentSessionReminderSentinel';
 const formatMinutes = (seconds: number): string => {
@@ -7,6 +10,38 @@ const formatMinutes = (seconds: number): string => {
   return `${minutes}m`;
 };
+const composeIdleSubAgentSection = (
+  idleSubAgents: SubAgentActivity[],
+): string => {
+  const lines = idleSubAgents.map(
+    (subAgent) =>
+      `- ${subAgent.label}: no output for ${formatMinutes(
+        subAgent.silentSeconds,
+      )}`,
+  );
+  return [
+    `${SILENT_SESSION_REMINDER_SENTINEL} The following sub-process(es) have produced no output for several minutes and may be stalled:`,
+    ...lines,
+    'Check each one. If it is stuck, take action (restart, hand off, or replace it). If it is legitimately waiting on an external dependency (continuous integration, an external API, or another process), let it continue.',
+  ].join('\n');
+};
+const composeLongRunningSubAgentSection = (
+  longRunningSubAgents: SubAgentActivity[],
+): string => {
+  const lines = longRunningSubAgents.map(
+    (subAgent) =>
+      `- ${subAgent.label}: running for ${formatMinutes(
+        subAgent.runningSeconds,
+      )}`,
+  );
+  return [
+    `${SILENT_SESSION_REMINDER_SENTINEL} The following sub-process(es) have been running longer than a task should normally take, which may mean an infinite loop, a task that is too large, or being stuck in an incorrect approach that is not making forward progress:`,
+    ...lines,
+    'Verify each one is genuinely advancing toward completion; do not dismiss it merely because it produced output recently. If it is not progressing, intervene: break the task down, restart, hand off, or replace it.',
+  ].join('\n');
+};
 const composeOwnerCallFormatGuidance = (
   ownerCallMarker: string | null,
 ): string => {
@@ -39,17 +74,25 @@ export class DefaultSilentSessionMessageComposer implements SilentSessionMessage
     return composeMainStalledMessage(mainSilentSeconds, this.ownerCallMarker);
   };
-  composeSubAgentSection = (subAgents: SubAgentActivity[]): string => {
-    const lines = subAgents.map(
+  composeSubAgentSection = (
+    subAgents: SubAgentActivity[],
+    thresholds: SubAgentStallThresholds,
+  ): string => {
+    const idleSubAgents = subAgents.filter(
+      (subAgent) =>
+        subAgent.silentSeconds >= thresholds.subAgentSilentThresholdSeconds,
+    );
+    const longRunningSubAgents = subAgents.filter(
       (subAgent) =>
-        `- ${subAgent.label}: silent for ${formatMinutes(
-          subAgent.silentSeconds,
-        )}, running for ${formatMinutes(subAgent.runningSeconds)}`,
+        subAgent.runningSeconds >= thresholds.subAgentRunningThresholdSeconds,
     );
-    return [
-      `${SILENT_SESSION_REMINDER_SENTINEL} The following sub-processes have been silent or running for a long time:`,
-      ...lines,
-      'If a sub-process is stalled, take action (restart, hand off, or replace it). If it is legitimately waiting on an external dependency (continuous integration, an external API, or another process), let it continue.',
-    ].join('\n');
+    const sections: string[] = [];
+    if (idleSubAgents.length > 0) {
+      sections.push(composeIdleSubAgentSection(idleSubAgents));
+    }
+    if (longRunningSubAgents.length > 0) {
+      sections.push(composeLongRunningSubAgentSection(longRunningSubAgents));
+    }
+    return sections.join('\n\n');
   };
 }

package/src/domain/usecases/NotifySilentLiveSessionsUseCase.test.ts CHANGED Viewed

@@ -446,12 +446,46 @@ describe('NotifySilentLiveSessionsUseCase', () => {
     expect(mockMessageComposer.composeSubAgentSection).toHaveBeenCalledWith(
       subAgents,
+      {
+        subAgentSilentThresholdSeconds:
+          DEFAULT_SUBAGENT_SILENT_THRESHOLD_SECONDS,
+        subAgentRunningThresholdSeconds:
+          DEFAULT_SUBAGENT_RUNNING_THRESHOLD_SECONDS,
+      },
     );
     expect(
       mockNotificationRepository.sendSelfCheckNotification,
     ).toHaveBeenCalledWith(GITHUB_SESSION, SUBAGENT_SECTION);
   });
+  it('passes a configured running threshold through to the sub-agent section composer', async () => {
+    setupLiveInteractiveSession(GITHUB_SESSION);
+    const subAgents: SubAgentActivity[] = [
+      {
+        label: 'sub-process-1',
+        silentSeconds: 10,
+        runningSeconds: 600,
+      },
+    ];
+    mockSubAgentActivityRepository.listSubAgentActivitiesBySessionName.mockResolvedValue(
+      new Map([[GITHUB_SESSION, subAgents]]),
+    );
+    await useCase.run({
+      ...runParams(),
+      subAgentRunningThresholdSeconds: 600,
+    });
+    expect(mockMessageComposer.composeSubAgentSection).toHaveBeenCalledWith(
+      subAgents,
+      {
+        subAgentSilentThresholdSeconds:
+          DEFAULT_SUBAGENT_SILENT_THRESHOLD_SECONDS,
+        subAgentRunningThresholdSeconds: 600,
+      },
+    );
+  });
   it('excludes an owner-handover spawn from selection so no notification is sent', async () => {
     mockSnapshotProvider.getSnapshot.mockResolvedValue({
       sessions: [{ sessionName: 'aw-host', panePids: [100] }],

package/src/domain/usecases/NotifySilentLiveSessionsUseCase.ts CHANGED Viewed

@@ -277,7 +277,12 @@ export class NotifySilentLiveSessionsUseCase {
     );
     if (stalledSubAgents.length > 0) {
       sections.push(
-        this.messageComposer.composeSubAgentSection(stalledSubAgents),
+        this.messageComposer.composeSubAgentSection(stalledSubAgents, {
+          subAgentSilentThresholdSeconds:
+            thresholds.subAgentSilentThresholdSeconds,
+          subAgentRunningThresholdSeconds:
+            thresholds.subAgentRunningThresholdSeconds,
+        }),
       );
     }

package/src/domain/usecases/adapter-interfaces/SilentSessionMessageComposer.ts CHANGED Viewed

@@ -1,6 +1,14 @@
 import { SubAgentActivity } from '../../entities/LiveSessionActivitySnapshot';
+export type SubAgentStallThresholds = {
+  subAgentSilentThresholdSeconds: number;
+  subAgentRunningThresholdSeconds: number;
+};
 export interface SilentSessionMessageComposer {
   composeMainStalledSection: (mainSilentSeconds: number) => string;
-  composeSubAgentSection: (subAgents: SubAgentActivity[]) => string;
+  composeSubAgentSection: (
+    subAgents: SubAgentActivity[],
+    thresholds: SubAgentStallThresholds,
+  ) => string;
 }