@north-light/api 0.3.556 → 0.3.558

package/dist/shared/env.d.ts

@@ -124,6 +124,10 @@ export declare function envTestUnattendedParkMs(): number | undefined;
  *  above the configured knob a deployment sets to tune how long an eligible
  *  resident idles before its parking turn. */
 export declare function envUnattendedParkMs(): number | undefined;
+/** How long a background bash job must show no activity before its owner is first told
+ *  (`CRTR_BASH_SILENCE_MS`, milliseconds; default 15 min). Later messages come at twice, four times,
+ *  then every four times that. */
+export declare function envBashSilenceMs(): number;
 /** Test-only park-summary grace-period override
  *  (`CRTR_TEST_PARK_SUMMARY_GRACE_MS`); no production default. */
 export declare function envTestParkSummaryGraceMs(): number | undefined;

package/dist/shared/env.js

@@ -303,6 +303,12 @@ export function envTestUnattendedParkMs() {
 export function envUnattendedParkMs() {
     return parsePositiveMsNoDefault(process.env['CRTR_UNATTENDED_PARK_MS']);
 }
+/** How long a background bash job must show no activity before its owner is first told
+ *  (`CRTR_BASH_SILENCE_MS`, milliseconds; default 15 min). Later messages come at twice, four times,
+ *  then every four times that. */
+export function envBashSilenceMs() {
+    return parsePositiveMsNoDefault(process.env['CRTR_BASH_SILENCE_MS']) ?? 15 * 60_000;
+}
 /** Test-only park-summary grace-period override
  *  (`CRTR_TEST_PARK_SUMMARY_GRACE_MS`); no production default. */
 export function envTestParkSummaryGraceMs() {

package/dist/shared/inbox-entry-body.js

@@ -84,6 +84,10 @@ function renderPush(entry, push) {
         case 'sent': return `${actor} sent a message as ${obj}.`;
         case 'configured': return `${actor} changed the settings of ${obj}${typeof a['changed'] === 'string' ? `: ${a['changed']}` : ''}.`;
         case 'exited': return `${obj[0].toUpperCase()}${obj.slice(1)} exited with code ${String(a['exit-code'])}. Log: ${String(a['log-path'])}`;
+        case 'silent': {
+            const files = typeof a['files'] === 'string' ? a['files'] : '';
+            return `${obj[0].toUpperCase()}${obj.slice(1)} has been silent for ${String(a['silent-for'])}: its processes used almost no CPU and none of the files they hold open for writing changed. It may be hung. Watched: ${files === '' ? 'the job log only' : files}. Inspect those files; stop it with \`crtr node bash kill ${push.object.id}\`; or, if it is meant to sit idle, stop these messages with \`crtr node bash quiet ${push.object.id}\`.`;
+        }
         case 'killed': {
             const by = push.actor === null ? '' : ` by ${actor}`;
             const why = typeof a['reason'] === 'string' ? ` (${a['reason']})` : '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.556",
+  "version": "0.3.558",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",