@namzu/sdk 52.2.0 → 52.4.0

package/dist/runtime/jobs/monitor-stream.js

@@ -0,0 +1,221 @@
+/**
+ * Turns a command's stdout into a few model-sized events.
+ *
+ * A watcher (`tail -f`, a poll loop, `gh run watch`) can print a line every
+ * millisecond, and every line the model is told about costs a context resend.
+ * So a monitor does not forward lines, it forwards BATCHES: lines are split,
+ * trimmed and truncated here, held for a short fixed window, and delivered
+ * together, and the batches themselves are rationed by a token bucket. A
+ * source that outruns the ration is first told so, then stopped, because a
+ * model that is flooded stops reading and one that is silenced does not know
+ * to look.
+ *
+ * Pure: no process, no registry, no model. The clock and the timer are
+ * injectable (and default to the globals read at call time, so fake timers
+ * work without any injection), which is what lets the tests advance a window
+ * by calling a function rather than by waiting for one.
+ *
+ * The constants and the wording come from the reference implementation of this
+ * tool; deviations are named where they are made.
+ */
+/** A longer line keeps its first this-many characters. */
+export const MONITOR_LINE_MAX_CHARS = 500;
+/** A joined batch longer than this keeps its first this-many characters. */
+export const MONITOR_BATCH_MAX_CHARS = 3000;
+/**
+ * The first buffered line arms ONE timer for this long; everything that
+ * arrives before it fires rides in the same batch. A fixed window, not a
+ * debounce: a source that never pauses still gets a batch every window
+ * instead of never.
+ */
+export const MONITOR_BATCH_WINDOW_MS = 200;
+/** A partial line (no newline yet) keeps its tail past this many bytes. */
+export const MONITOR_PARTIAL_LINE_MAX_BYTES = 1024 * 1024;
+/** One token per BATCH, not per line. */
+export const MONITOR_BUCKET_CAPACITY = 10;
+export const MONITOR_BUCKET_REFILL_MS = 2000;
+/** Suppression older than this, with another batch dropped, stops the monitor. */
+export const MONITOR_SUPPRESSION_LIMIT_MS = 30_000;
+/** The effective ceiling on a monitor's life; a host may lower it, never raise it past the schema. */
+export const MONITOR_TIMEOUT_CAP_MS = 1_800_000;
+export const MONITOR_TIMEOUT_DEFAULT_MS = 300_000;
+export const MONITOR_TIMEOUT_MIN_MS = 1000;
+/** The schema ceiling; anything between the cap and this is clamped, not refused. */
+export const MONITOR_TIMEOUT_MAX_MS = 3_600_000;
+/** One notification handed to the model is cut to this many characters, in the middle. */
+export const MONITOR_NOTIFICATION_MAX_CHARS = 100_000;
+/**
+ * One event's content is shrunk to this many characters BEFORE it is framed,
+ * so the notification cap never has to cut inside an envelope. A batch is at
+ * most 3000, so this only matters to a notice or a caller that outgrew that.
+ */
+export const MONITOR_EVENT_CONTENT_MAX_CHARS = 20_000;
+const LINE_TRUNCATED = '...(truncated)';
+const BATCH_TRUNCATED = '\n...(truncated)';
+/** `30m`, `5m`, `90s`: whole minutes as minutes, anything else in seconds. */
+export function formatMonitorDuration(ms) {
+    const seconds = Math.max(1, Math.round(ms / 1000));
+    return seconds % 60 === 0 ? `${seconds / 60}m` : `${seconds}s`;
+}
+export function suppressionNotice(count) {
+    return `[${count} events suppressed — output rate too high. Consider stopping this monitor and starting it with a more selective command.]`;
+}
+export function tooMuchOutputNotice(count, overMs) {
+    return `[Monitor stopped — too much output (${count} events suppressed over ${formatMonitorDuration(overMs)}). Restart it with a more selective command.]`;
+}
+export function expiryNotice(ms, delivered) {
+    return delivered > 0
+        ? `[Monitor expired after ${formatMonitorDuration(ms)} with ${delivered} events delivered. Start it again if you still need the watch.]`
+        : `[Monitor expired after ${formatMonitorDuration(ms)} with no events delivered. Start it again if you still need the watch — and widen the filter if silence was unexpected.]`;
+}
+/** The tail of `text` that fits `maxBytes`, starting on a whole code point. */
+function keepTail(text, maxBytes) {
+    const bytes = Buffer.from(text);
+    if (bytes.length <= maxBytes)
+        return text;
+    let start = bytes.length - maxBytes;
+    while (start < bytes.length && ((bytes[start] ?? 0) & 0xc0) === 0x80)
+        start++;
+    return bytes.subarray(start).toString('utf8');
+}
+export function createMonitorStream(options) {
+    const now = options.now ?? (() => Date.now());
+    const setTimer = options.setTimer ??
+        ((callback, ms) => {
+            const handle = setTimeout(callback, ms);
+            // A pending batch must not keep a process alive; the job's own exit
+            // drains it.
+            handle.unref?.();
+            return handle;
+        });
+    const clearTimer = options.clearTimer ?? ((handle) => clearTimeout(handle));
+    let closed = false;
+    let partial = '';
+    let lines = [];
+    let timer;
+    let timerArmed = false;
+    let tokens = MONITOR_BUCKET_CAPACITY;
+    let refilledAt = now();
+    let eventsDelivered = 0;
+    let suppressedTotal = 0;
+    let stdoutChars = 0;
+    // The suppression tracker. `count` is what the auto-stop reports; `unannounced`
+    // is what the next notice reports. They differ after a notice, because the
+    // tracker outlives it on purpose: a source that is told and keeps going must
+    // still reach the 30 s rule.
+    let suppressionStartedAt;
+    let lastDropAt = 0;
+    let count = 0;
+    let unannounced = 0;
+    let noticeEmitted = false;
+    const refill = (at) => {
+        const elapsed = at - refilledAt;
+        if (elapsed <= 0)
+            return;
+        tokens = Math.min(MONITOR_BUCKET_CAPACITY, tokens + elapsed / MONITOR_BUCKET_REFILL_MS);
+        refilledAt = at;
+    };
+    const deliver = (batch) => {
+        const at = now();
+        // Reset only after a notice went out AND the source has been quiet for
+        // three refills. Resetting on quiet alone would let a source that is
+        // dropped every other window never reach the stop rule.
+        if (noticeEmitted && at - lastDropAt > 3 * MONITOR_BUCKET_REFILL_MS) {
+            suppressionStartedAt = undefined;
+            count = 0;
+            unannounced = 0;
+            noticeEmitted = false;
+        }
+        refill(at);
+        if (tokens >= 1) {
+            tokens -= 1;
+            if (unannounced > 0) {
+                options.onNotice(suppressionNotice(unannounced));
+                unannounced = 0;
+                noticeEmitted = true;
+            }
+            eventsDelivered++;
+            options.onBatch(batch);
+            return;
+        }
+        // Whether the rule fires is decided by when suppression BEGAN, before
+        // this drop is counted, and the count reported includes it.
+        const began = suppressionStartedAt;
+        suppressionStartedAt ??= at;
+        lastDropAt = at;
+        suppressedTotal++;
+        count++;
+        unannounced++;
+        if (began !== undefined && at - began > MONITOR_SUPPRESSION_LIMIT_MS) {
+            stop();
+            options.onOverflow({ suppressed: count, overMs: at - began });
+        }
+    };
+    const emitPending = () => {
+        if (timerArmed) {
+            clearTimer(timer);
+            timerArmed = false;
+        }
+        if (lines.length === 0)
+            return;
+        let batch = lines.join('\n');
+        lines = [];
+        if (batch.length > MONITOR_BATCH_MAX_CHARS) {
+            batch = batch.slice(0, MONITOR_BATCH_MAX_CHARS) + BATCH_TRUNCATED;
+        }
+        deliver(batch);
+    };
+    const addLine = (raw) => {
+        const line = raw.trim();
+        if (line.length === 0)
+            return;
+        lines.push(line.length > MONITOR_LINE_MAX_CHARS
+            ? line.slice(0, MONITOR_LINE_MAX_CHARS) + LINE_TRUNCATED
+            : line);
+        if (!timerArmed) {
+            timerArmed = true;
+            timer = setTimer(() => {
+                timerArmed = false;
+                if (!closed)
+                    emitPending();
+            }, MONITOR_BATCH_WINDOW_MS);
+        }
+    };
+    const stop = () => {
+        closed = true;
+        if (timerArmed) {
+            clearTimer(timer);
+            timerArmed = false;
+        }
+        lines = [];
+        partial = '';
+    };
+    return {
+        push(text) {
+            if (closed || text.length === 0)
+                return;
+            stdoutChars += text.length;
+            const buffered = partial + text;
+            const parts = buffered.split('\n');
+            partial = keepTail(parts.pop() ?? '', MONITOR_PARTIAL_LINE_MAX_BYTES);
+            for (const part of parts)
+                addLine(part);
+        },
+        flush() {
+            if (closed)
+                return;
+            emitPending();
+        },
+        drain() {
+            if (closed)
+                return;
+            const rest = partial;
+            partial = '';
+            addLine(rest);
+            emitPending();
+        },
+        close: stop,
+        stats: () => ({ eventsDelivered, suppressed: suppressedTotal, stdoutChars }),
+    };
+}
+//# sourceMappingURL=monitor-stream.js.map

package/dist/runtime/jobs/monitor-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-stream.js","sourceRoot":"","sources":["../../../src/runtime/jobs/monitor-stream.ts"],"names":[],"mappings":"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"}

package/dist/runtime/jobs/registry.d.ts

@@ -1,5 +1,7 @@
 import type { spawn } from 'node:child_process';
 import type { BackgroundJobOutputWaitOptions, BackgroundJobOutputWaitResult } from '../../types/job/index.js';
+import type { MonitorWebSocketTarget } from '../../types/tool/index.js';
+import { type MonitorStreamStats } from './monitor-stream.js';
 /**
  * Work that outlives a tool call, owned by whoever started it.
  *
@@ -43,6 +45,48 @@ export interface BackgroundJob {
     readonly recoveryRequired?: boolean;
     /** Safe registry diagnostic for an unconfirmed stop; excludes transport secrets. */
     readonly stopError?: string;
+    /**
+     * `monitor` for a job started by the `monitor` tool: its stdout is
+     * delivered line by line as events, and it expires. Absent for every
+     * other job.
+     */
+    readonly kind?: 'monitor';
+    /** What the monitor watches, in the model's words; shown with every event. */
+    readonly description?: string;
+    /** When the monitor will be stopped if the command has not ended first (epoch ms). */
+    readonly expiresAt?: number;
+    /**
+     * Why a monitor was stopped, when the registry stopped it: `expired` at
+     * its deadline, `too_much_output` when the source outran the event
+     * ration, `stopped` for a `kill()` asked for from outside. Absent while it
+     * runs and when the command ended on its own.
+     */
+    readonly stopReason?: 'expired' | 'too_much_output' | 'stopped';
+    /**
+     * What the monitor's source is, when it is not a command: `websocket` for a
+     * monitor of a WebSocket connection, whose `command` is then
+     * `websocket <url>` and which has no exit code of a process.
+     */
+    readonly transport?: 'websocket';
+    /** The close code and reason the server ended a WebSocket connection with, if it did. */
+    readonly closeCode?: number;
+    readonly closeReason?: string;
+}
+/**
+ * One thing a monitor has to say: a batch of its stdout lines, or a notice
+ * from the monitor itself (events suppressed, stopped, expired).
+ */
+export interface MonitorEvent {
+    /** `${jobId}:${seq}`, unique per registry and stable, so a host can acknowledge it. */
+    readonly id: string;
+    readonly jobId: string;
+    readonly owner: string;
+    readonly description: string;
+    readonly kind: 'output' | 'notice';
+    readonly text: string;
+    readonly at: number;
+    /** Set when the source is a WebSocket connection, whose text the server wrote. */
+    readonly transport?: 'websocket';
 }
 export interface BackgroundJobOutput {
     readonly chunk: string;
@@ -62,6 +106,55 @@ export interface BackgroundJobOutput {
     /** Set when the command could not be started; see {@link BackgroundJob.error}. */
     readonly error?: string;
 }
+/**
+ * What a `spawn` that is not a child process hands the registry: the few
+ * members of {@link JobChild} and how to stop it. A {@link JobProcess} is one
+ * too, so a `spawn` may return either.
+ */
+export interface JobSource {
+    readonly child: JobChild;
+    /** How to stop it, when the registry's process-group kill would not reach everything. */
+    kill?(signal: NodeJS.Signals): void;
+    /** Confirm the owned tree stopped; reject instead of claiming an unconfirmed exit. */
+    terminate?(signal?: NodeJS.Signals): Promise<void>;
+}
+/**
+ * What the registry reads of a job's process, and nothing more.
+ *
+ * A `ChildProcess` satisfies it, and so does anything else that writes bytes
+ * on two pipes and ends: a WebSocket connection held as a monitor's source is
+ * such a thing. Named so that the registry's contract is the few members it
+ * uses and not a type from `node:child_process` it would have to be cast to.
+ */
+export interface JobChild {
+    readonly pid?: number | undefined;
+    readonly stdout?: JobPipe | null;
+    readonly stderr?: JobPipe | null;
+    once(event: 'spawn', listener: () => void): unknown;
+    on(event: 'error', listener: (error: Error) => void): unknown;
+    once(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): unknown;
+}
+/** A readable stream, as far as the registry reads one. */
+export interface JobPipe {
+    on(event: 'data', listener: (data: Buffer | string) => void): unknown;
+}
+/**
+ * What a process can say to the registry besides its output, handed to the
+ * `spawn` that asked for it.
+ */
+export interface JobHost {
+    /**
+     * Something the SOURCE has to say, delivered to a monitor's listeners as a
+     * `notice` event and never rationed as output is. `final` ends the stream:
+     * what is pending goes out first, and nothing the process writes after the
+     * notice is delivered. Ignored for a job that is not a monitor.
+     */
+    notice(text: string, options?: {
+        readonly final?: boolean;
+    }): void;
+    /** The server closed a WebSocket connection with this code and reason. */
+    connectionClosed(code: number, reason: string): void;
+}
 /** A job's process, when something other than the registry starts it. */
 export interface JobProcess {
     readonly child: ReturnType<typeof spawn>;
@@ -81,7 +174,7 @@ export interface StartJobParams {
      * host in the `bash` tool's shell (`tools/command-shell.ts`). The process must be the leader of its own group and must not
      * expect stdin.
      */
-    readonly spawn?: () => JobProcess;
+    readonly spawn?: (host: JobHost) => JobProcess | JobSource;
     /**
      * Output the process already wrote before the registry took it over, in
      * the order it was written. Used when a foreground command is moved to the
@@ -97,6 +190,18 @@ export interface StartJobParams {
      * decoded the way a foreground command's are, not as a Linux guest's.
      */
     readonly hostOutput?: boolean;
+    /**
+     * Run the command as a monitor: stdout is split into lines and delivered
+     * to `onMonitorEvent` listeners in batches, and the job is stopped at
+     * `timeoutMs`. Both streams stay in the retained buffer, so `read` still
+     * shows everything, stderr included.
+     */
+    readonly monitor?: {
+        readonly description: string;
+        readonly timeoutMs: number;
+        /** The source is a WebSocket connection and not a command; see {@link BackgroundJob.transport}. */
+        readonly transport?: 'websocket';
+    };
 }
 export interface BackgroundJobRegistryConfig {
     /**
@@ -150,6 +255,7 @@ export declare class BackgroundJobRegistry {
     private readonly config;
     private readonly jobs;
     private readonly exitListeners;
+    private readonly monitorListeners;
     private outputWaiters;
     private readonly outputWaitersByOwner;
     /**
@@ -160,6 +266,20 @@ export declare class BackgroundJobRegistry {
      */
     onExit(listener: (job: BackgroundJob) => void): () => void;
     private announceExit;
+    /**
+     * Be told what a monitor has to say, whoever owns it: a batch of its
+     * stdout lines, or a notice from the monitor itself. Returns the
+     * unsubscribe.
+     *
+     * Every listener hears every monitor's events, whatever their `owner`: a
+     * consumer serving one turn or session MUST filter on `event.owner`, as the
+     * turn does. A listener that throws is its owner's problem, as in
+     * {@link onExit}.
+     */
+    onMonitorEvent(listener: (event: MonitorEvent) => void): () => void;
+    private announceMonitorEvent;
+    /** What a monitor's stream has done so far, for the summary of how it ended. */
+    monitorStats(id: string): MonitorStreamStats;
     /** A failed remote stop never releases ownership or announces a terminal job. */
     private confirmTermination;
     constructor(config?: BackgroundJobRegistryConfig);
@@ -168,6 +288,14 @@ export declare class BackgroundJobRegistry {
     /** Live jobs for one owner, oldest first. */
     list(owner: string): readonly BackgroundJob[];
     start(params: StartJobParams): BackgroundJob;
+    /** The deadline: the last batch, then the notice, then the same kill every stop uses. */
+    private expireMonitor;
+    /**
+     * A notice from the source of a monitor (a WebSocket's upgrade was refused,
+     * its connection closed). Delivered after whatever was already complete, so
+     * the last lines are not overtaken by the news that the stream ended.
+     */
+    private noticeFromSource;
     /**
      * Resolves once the job's process exists, or once it could not be
      * created (`error` then says why). Lets a caller report a start that
@@ -253,6 +381,19 @@ export declare function bindOwner(registry: BackgroundJobRegistry, owner: string
      * than present and silently doing nothing.
      */
     readonly onAwaited?: (id: string) => void;
+    /**
+     * The longest a monitor started through this binding may live. A host
+     * may lower it (a single-shot run has no tomorrow to watch for); the
+     * default is {@link MONITOR_TIMEOUT_CAP_MS}.
+     */
+    readonly monitorTimeoutCapMs?: number;
+    /**
+     * Be told that this binding started a monitor. The turn passes its own
+     * recorder here when the monitor belongs to the turn itself, which is
+     * what makes the turn stay open for it; a session-owned monitor is not
+     * reported, because the host wakes on its events.
+     */
+    readonly onMonitorStarted?: (id: string) => void;
 }): {
     kill: (id: string) => Promise<BackgroundJob>;
     list: () => readonly BackgroundJob[];
@@ -261,6 +402,24 @@ export declare function bindOwner(registry: BackgroundJobRegistry, owner: string
         command: string;
         workingDirectory?: string;
     }) => BackgroundJob;
+    startMonitor: (params: {
+        command: string;
+        description: string;
+        timeoutMs: number;
+        workingDirectory?: string;
+    }) => {
+        job: BackgroundJob;
+        timeoutMs: number;
+    };
+    startWebSocketMonitor: (params: {
+        description: string;
+        timeoutMs: number;
+        workingDirectory?: string;
+        webSocket: MonitorWebSocketTarget;
+    }) => {
+        job: BackgroundJob;
+        timeoutMs: number;
+    };
     adopt: (params: {
         command: string;
         child: ReturnType<typeof spawn>;
@@ -279,4 +438,19 @@ export declare function bindOwner(registry: BackgroundJobRegistry, owner: string
     }) => Promise<BackgroundJob>;
     waitForOutput: (id: string, opts: BackgroundJobOutputWaitOptions) => Promise<BackgroundJobOutputWaitResult>;
 };
+/**
+ * How a monitor ended, in the words the model, the transcript and a
+ * single-shot run all use, so the three cannot disagree about it.
+ *
+ * `completed` is the command ending by itself: with output it is the stream
+ * ending, and without any it is a watch that never saw anything, which a
+ * reader must not mistake for a quiet success. A non-zero exit is `failed`.
+ * `killed` covers every stop the registry or the model asked for; the expiry
+ * and the too-much-output stop already told the model why in a notice of their
+ * own, so the summary does not repeat it.
+ */
+export declare function describeMonitorEnd(job: Pick<BackgroundJob, 'description' | 'status' | 'exitCode' | 'signal' | 'error' | 'transport' | 'closeCode' | 'closeReason'>, stats: Pick<MonitorStreamStats, 'stdoutChars'>): {
+    status: 'completed' | 'failed' | 'killed';
+    summary: string;
+};
 //# sourceMappingURL=registry.d.ts.map

package/dist/runtime/jobs/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/jobs/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/jobs/registry.ts"],"names":[],"mappings":"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"}