agent-nuvira 3.5.0 → 3.5.2

package/dist/tools/run-terminal.d.ts

@@ -31,10 +31,99 @@
  * (maskSenderId — phone numbers never echo back in full).
  */
 import type { ToolContext } from './registry.js';
+/**
+ * The wait budget this command deserves, and the reason (for the message).
+ * Exported so the assessment is testable on its own — it is a decision, not an
+ * implementation detail.
+ */
+export declare function assessCommandTime(command: string): {
+    budgetMs: number;
+    why: string;
+} | null;
+/**
+ * How long this call waits before handing the command to monitoring.
+ *
+ * Priority, and why in that order:
+ *  1. an explicit `timeout_ms` — the model knows something the classifier does not;
+ *  2. the ASSESSED class — a full test suite or a build is minutes by nature, and
+ *     giving it the short default is what produced the kill-mid-run failures;
+ *  3. the room — a person watching waits less (P7), an unattended run waits more.
+ *
+ * Exported because this is a decision, not an implementation detail: it is what
+ * `run_terminal` believes the work needs, and it should be asserted directly
+ * rather than inferred from a message.
+ */
+export declare function resolveWaitMs(command: string, explicitMs: number | undefined, interactive: boolean | undefined): number;
 /** Test/DI seam: forget every recorded failure streak. */
 export declare function resetTerminalFailureStreaks(): void;
-/** The guidance a timed-out command gets instead of a bare "timed out". */
-export declare function timeoutGuidance(command: string, timeoutMs: number, repeated: boolean): string;
+/** How long a CONFIRMED hang is left running before it is stopped (0 = never). */
+export declare function hangReapMs(): number;
+/**
+ * One heartbeat over every monitored run.
+ *
+ * Exported (and takes `now`) so the decision can be driven deterministically in
+ * a test instead of waited for.
+ */
+export declare function sampleMonitoredRuns(now?: number): void;
+/**
+ * The marker a result carries when the command OUTLIVED its wait budget and is
+ * still running under monitoring.
+ *
+ * It is neither success nor failure, and the loop must read it as neither:
+ *
+ *  - NOT success — a live run has verified nothing yet. Counting it as proof is
+ *    how a turn ends up claiming "the tests pass" about a suite that is still on
+ *    its first file.
+ *  - NOT failure — reporting it as one is the bug this whole change removes: the
+ *    work was destroyed (or, now, is still going) and the user is told it broke.
+ *
+ * So it is its own state, and this exported string is the one both the tool and
+ * the loop's success classifier read (see `ranOk` in tool-loop.ts).
+ */
+export declare const RUN_TERMINAL_INCOMPLETE_PREFIX = "\u23F3 run_terminal: still running";
+/**
+ * Re-attach to the runs a PREVIOUS process left behind.
+ *
+ * Without this, every restart orphaned the record of work that is still going:
+ * the command keeps running, nothing can poll it, and the turn that started it
+ * has no way to collect its real verdict. Runs whose process is gone are marked
+ * finished (with an honest "its exit code was not recorded" reason), and live
+ * ones are re-attached to be polled, sampled and — only after their pid is
+ * re-verified — stopped.
+ *
+ * Returns how many runs were recovered.
+ */
+export declare function hydrateMonitoredRuns(): number;
+/** Test/DI seam: forget the monitored runs. Kills nothing (they keep running). */
+export declare function resetDetachedRuns(): void;
+/**
+ * Everything currently being followed.
+ *
+ * Hydrates first, so this answers for the runs a PREVIOUS process left behind as
+ * well as this one's — otherwise a restart would make the whole list vanish while
+ * the commands are still running.
+ */
+export declare function listDetachedRuns(): string;
+/**
+ * Stop one monitored run deliberately (the model's own decision after a
+ * diagnosis). Bounded on purpose: it can only ever touch a command THIS tool
+ * started and is still following — never an arbitrary pid.
+ */
+export declare function stopDetachedRun(id: string): string;
+/**
+ * The state of one monitored command. A finished one keeps its result available
+ * (bounded) so the agent can read the exit code and output after doing other
+ * work — the poll is how a long command's verdict finally reaches the turn.
+ */
+export declare function pollDetachedRun(id: string): string;
+/**
+ * What the model is told when a command outlives this call's wait budget.
+ * Exported so the wording is testable: the two things it MUST say are that the
+ * command was not killed and that re-running it is wrong.
+ */
+export declare function waitBudgetGuidance(command: string, id: string, waitMs: number, assessed: {
+    why: string;
+} | null, bytes: number, quietMs: number, reapAfterMs?: number): string;
 /**
  * Does this command ADD a dependency (rather than install what is declared)?
  *
@@ -55,6 +144,15 @@ export declare function classifyCommand(command: string): CommandClass;
 /** ─── The tool ───────────────────────────────────────────────────────────── */
 export interface RunTerminalArgs {
     command: string;
+    /**
+     * 'run' (default) executes the command. 'poll' reports one monitored long run
+     * (`process_id`), 'list' shows them all — the follow-up half of the
+     * still-running hand-off, so a command that outlives its wait budget is
+     * followed to its REAL exit code instead of being killed or guessed at.
+     */
+    action?: 'run' | 'poll' | 'list' | 'stop';
+    /** The monitored run to stop or report on (from a `still running` result). */
+    process_id?: string;
     confirm?: boolean;
     timeout_ms?: number;
     /**

package/dist/tools/run-terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-terminal.d.ts","sourceRoot":"","sources":["../../src/tools/run-terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAWH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAmDjD,0DAA0D;AAC1D,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AA+BD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAW7F;AAoND;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAuBvD;AAOD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAetE;AAED,KAAK,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAkElD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAe7D;AAED,iFAAiF;AAEjF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAsR9F"}
+{"version":3,"file":"run-terminal.d.ts","sourceRoot":"","sources":["../../src/tools/run-terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAYH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgGjD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM3F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,OAAO,GAAG,SAAS,GAC/B,MAAM,CAIR;AAyBD,0DAA0D;AAC1D,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AA8ID,kFAAkF;AAClF,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AA0CD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,SAAa,GAAG,IAAI,CA8D1D;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,8BAA8B,uCAAkC,CAAC;AA6G9E;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAwD7C;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAiED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAmBzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAoClD;AAYD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CA+DlD;AA2BD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,WAAW,SAAI,GACd,MAAM,CAkBR;AAoND;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAuBvD;AAOD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAetE;AAED,KAAK,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAkElD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAe7D;AAED,iFAAiF;AAEjF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAyU9F"}