@bastani/atomic 0.9.57 → 0.9.58-alpha.1

package/dist/core/tasks/heartbeat.js

@@ -0,0 +1,440 @@
+import { taskOutputText } from "./command-output.js";
+import { DEFAULT_TASK_HEARTBEAT_MS, formatTaskHeartbeat, isValidTaskHeartbeatMs, singleLine, TASK_HEARTBEAT_MESSAGE_TYPE, } from "./heartbeat-notice.js";
+import { taskOwnTranscriptEntries, } from "./supervisor.js";
+export * from "./heartbeat-notice.js";
+/** Tasks described in full by one notice; further due tasks are only listed. */
+export const TASK_HEARTBEAT_DETAIL_LIMIT = 8;
+/** Further due tasks listed by name in one notice; the rest are counted. */
+export const TASK_HEARTBEAT_LIST_LIMIT = 20;
+/** Boundaries due within this window (capped at a quarter cadence) join the notice that is going out. */
+export const TASK_HEARTBEAT_COALESCE_MS = 60_000;
+/** While the owner has not read the previous notice, due tasks wait and are rechecked this often. */
+export const TASK_HEARTBEAT_RECHECK_MS = 30_000;
+/** How often a running shell's output is sampled to date its last output. */
+export const TASK_HEARTBEAT_OUTPUT_SAMPLE_MS = 30_000;
+const OUTPUT_TAIL_BYTES = 2048;
+const OUTPUT_TAIL_LINES = 6;
+const LINE_CHARS = 160;
+const TITLE_CHARS = 120;
+/** Longest delay a host timer accepts before it overflows to an immediate fire. */
+const MAX_TIMER_DELAY_MS = 2_147_483_647;
+/** The owner's default cadence, or the built-in one when its setting cannot be read or is out of range. */
+export function defaultTaskHeartbeatMs(delivery) {
+    try {
+        const configured = delivery.defaultIntervalMs();
+        return isValidTaskHeartbeatMs(configured) ? configured : DEFAULT_TASK_HEARTBEAT_MS;
+    }
+    catch {
+        return DEFAULT_TASK_HEARTBEAT_MS;
+    }
+}
+const systemClock = {
+    now: () => Date.now(),
+    setTimeout: (run, delayMs) => {
+        const handle = setTimeout(run, delayMs);
+        handle.unref();
+        return handle;
+    },
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+function activityKey(task) {
+    return JSON.stringify([task.currentAction, task.metrics, task.attention, task.model]);
+}
+/** Whether the newest message in a child's history is an assistant turn whose tool calls have not returned yet. */
+function endsInToolCall(entries) {
+    for (let index = entries.length - 1; index >= 0; index--) {
+        const entry = entries[index];
+        if (entry?.type !== "message")
+            continue;
+        const message = entry.message;
+        return message.role === "assistant" && message.content.some((block) => block.type === "toolCall");
+    }
+    return false;
+}
+/** First boundary on the `startedAt + n × intervalMs` series strictly after `after`. */
+function nextBoundary(startedAt, intervalMs, after) {
+    const n = Math.max(1, Math.floor((after - startedAt) / intervalMs) + 1);
+    const boundary = startedAt + n * intervalMs;
+    return boundary > after ? boundary : startedAt + (n + 1) * intervalMs;
+}
+function byBoundary(a, b) {
+    const left = a.nextAt ?? Number.POSITIVE_INFINITY;
+    const right = b.nextAt ?? Number.POSITIVE_INFINITY;
+    if (left !== right)
+        return left - right;
+    return a.taskId < b.taskId ? -1 : a.taskId > b.taskId ? 1 : 0;
+}
+/**
+ * Periodic "is this still making progress?" notices for one task owner's running shells and subagents.
+ *
+ * It follows the workflow heartbeat rules: boundaries are anchored at the task's start and never at the previous
+ * delivery, missed boundaries are skipped rather than replayed, and only one notice per owner is outstanding. Unlike
+ * a workflow run, an owner can have many tasks, so tasks due together share one bounded notice, and a task due while
+ * the owner has not read the previous notice waits for it rather than losing its turn.
+ */
+export class TaskHeartbeatMonitor {
+    options;
+    clock;
+    tracked = new Map();
+    subscription;
+    timer;
+    /** The time the current timer wakes for, so an unchanged schedule keeps its timer. */
+    timerAt;
+    busy = false;
+    disposed = false;
+    recheckAt;
+    nextSampleAt;
+    constructor(options) {
+        this.options = options;
+        this.clock = options.clock ?? systemClock;
+    }
+    /** Begin watching the owner. Idempotent. */
+    start() {
+        if (this.subscription || this.disposed)
+            return;
+        const watched = this.options.supervisor.watchOwnerTasks(this.options.owner);
+        if (!watched.ok)
+            return;
+        this.subscription = watched.value;
+        this.subscription.onReconcile = (snapshot, events) => this.reconcile(snapshot, events);
+        this.reconcile(this.subscription.snapshot, []);
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.subscription?.dispose();
+        this.subscription = undefined;
+        this.tracked.clear();
+        this.disarm();
+    }
+    reconcile(snapshot, events) {
+        if (this.disposed)
+            return;
+        if (snapshot.state !== "open") {
+            if (snapshot.state === "closed")
+                this.dispose();
+            else {
+                this.tracked.clear();
+                this.disarm();
+            }
+            return;
+        }
+        const at = this.clock.now();
+        const reported = new Set();
+        for (const event of events)
+            if (event.payload.kind === "task-activity")
+                reported.add(event.payload.ref.taskId);
+        const running = new Set();
+        for (const task of snapshot.tasks) {
+            // Queued, stopping, paused and finished tasks do not heartbeat.
+            if (task.execution.kind !== "running")
+                continue;
+            const id = task.ref.taskId;
+            running.add(id);
+            const key = activityKey(task);
+            const entry = this.tracked.get(id);
+            if (entry) {
+                entry.record = task;
+                if (key !== entry.activityKey || reported.has(id)) {
+                    entry.activityKey = key;
+                    entry.lastActivityAt = at;
+                }
+                continue;
+            }
+            const intervalMs = this.resolveInterval(task);
+            this.tracked.set(id, {
+                taskId: id,
+                record: task,
+                startedAt: at,
+                intervalMs,
+                ...(intervalMs > 0 ? { nextAt: at + intervalMs } : {}),
+                ...(reported.has(id) ? { lastActivityAt: at } : {}),
+                activityKey: key,
+                outputEnd: 0n,
+            });
+        }
+        for (const id of [...this.tracked.keys()])
+            if (!running.has(id))
+                this.tracked.delete(id);
+        if (!this.hasSampledShells())
+            this.nextSampleAt = undefined;
+        else
+            this.nextSampleAt ??= at + TASK_HEARTBEAT_OUTPUT_SAMPLE_MS;
+        this.arm();
+    }
+    resolveInterval(task) {
+        // Owners with a heartbeat binding fix each task's cadence on its record at admission.
+        if (task.heartbeatMs !== undefined)
+            return isValidTaskHeartbeatMs(task.heartbeatMs) ? task.heartbeatMs : 0;
+        const delivery = this.options.delivery();
+        return delivery ? defaultTaskHeartbeatMs(delivery) : DEFAULT_TASK_HEARTBEAT_MS;
+    }
+    hasSampledShells() {
+        for (const entry of this.tracked.values())
+            if (entry.record.kind === "command" && entry.intervalMs > 0)
+                return true;
+        return false;
+    }
+    disarm() {
+        if (this.timer === undefined)
+            return;
+        this.clock.clearTimeout(this.timer);
+        this.timer = undefined;
+        this.timerAt = undefined;
+    }
+    arm() {
+        if (this.disposed || this.busy) {
+            this.disarm();
+            return;
+        }
+        // A blocked owner cannot receive anything before its recheck, however many tasks come due meanwhile.
+        let wakeAt = this.recheckAt ?? Number.POSITIVE_INFINITY;
+        if (this.recheckAt === undefined)
+            for (const entry of this.tracked.values())
+                if (entry.nextAt !== undefined && entry.nextAt < wakeAt)
+                    wakeAt = entry.nextAt;
+        if (this.nextSampleAt !== undefined && this.nextSampleAt < wakeAt)
+            wakeAt = this.nextSampleAt;
+        // Activity reconciles many times a second; it rarely moves the next wake-up.
+        if (this.timer !== undefined && this.timerAt === wakeAt)
+            return;
+        this.disarm();
+        if (!Number.isFinite(wakeAt))
+            return;
+        const delay = Math.min(Math.max(1, Math.ceil(wakeAt - this.clock.now())), MAX_TIMER_DELAY_MS);
+        this.timerAt = wakeAt;
+        this.timer = this.clock.setTimeout(() => {
+            this.timer = undefined;
+            this.timerAt = undefined;
+            void this.wake();
+        }, delay);
+    }
+    async wake() {
+        if (this.disposed || this.busy)
+            return;
+        this.busy = true;
+        try {
+            const at = this.clock.now();
+            if (this.nextSampleAt !== undefined && this.nextSampleAt <= at) {
+                await this.sampleShellOutput(at);
+                this.nextSampleAt = this.hasSampledShells() ? at + TASK_HEARTBEAT_OUTPUT_SAMPLE_MS : undefined;
+            }
+            await this.beat(at);
+        }
+        catch {
+            // A failed check skips this boundary; the next one is already scheduled.
+        }
+        finally {
+            this.busy = false;
+            this.arm();
+        }
+    }
+    async beat(at) {
+        if (this.recheckAt !== undefined && this.recheckAt > at)
+            return;
+        this.recheckAt = undefined;
+        const entries = [...this.tracked.values()];
+        if (!entries.some((entry) => entry.nextAt !== undefined && entry.nextAt <= at))
+            return;
+        const delivery = this.options.delivery();
+        let unread = false;
+        try {
+            unread = delivery?.hasUnreadHeartbeat() === true;
+        }
+        catch {
+            unread = false;
+        }
+        if (unread) {
+            // One outstanding notice per owner: due tasks stay owed and join the next notice instead of stacking.
+            this.recheckAt = at + TASK_HEARTBEAT_RECHECK_MS;
+            return;
+        }
+        const batch = entries
+            .filter((entry) => entry.nextAt !== undefined &&
+            entry.nextAt <= at + Math.min(TASK_HEARTBEAT_COALESCE_MS, entry.intervalMs / 4))
+            .sort(byBoundary);
+        for (const entry of batch)
+            entry.nextAt = nextBoundary(entry.startedAt, entry.intervalMs, Math.max(at, entry.nextAt ?? at));
+        if (!delivery)
+            return;
+        const details = await this.describe(batch, at);
+        // A task that finished while its notice was being prepared is no longer mentioned.
+        const live = (taskId) => this.tracked.has(taskId);
+        details.tasks = details.tasks.filter((task) => live(task.taskId));
+        details.more = details.more.filter((task) => live(task.taskId));
+        details.moreCount = batch.slice(TASK_HEARTBEAT_DETAIL_LIMIT).filter((entry) => live(entry.taskId)).length;
+        if (details.tasks.length === 0 || this.disposed)
+            return;
+        await delivery.deliver({
+            customType: TASK_HEARTBEAT_MESSAGE_TYPE,
+            content: formatTaskHeartbeat(details),
+            display: true,
+            details,
+        });
+    }
+    async describe(batch, at) {
+        const detailed = batch.slice(0, TASK_HEARTBEAT_DETAIL_LIMIT);
+        const rest = batch.slice(TASK_HEARTBEAT_DETAIL_LIMIT);
+        const tasks = [];
+        for (const entry of detailed)
+            tasks.push(await this.describeTask(entry, at));
+        return {
+            scheduledAt: at,
+            tasks,
+            more: rest.slice(0, TASK_HEARTBEAT_LIST_LIMIT).map((entry) => ({
+                taskId: entry.taskId,
+                kind: entry.record.kind,
+                title: singleLine(entry.record.title, TITLE_CHARS),
+            })),
+            moreCount: rest.length,
+        };
+    }
+    async describeTask(entry, at) {
+        const task = entry.record;
+        const lease = this.lease(entry.taskId);
+        const described = {
+            taskId: entry.taskId,
+            kind: task.kind,
+            title: singleLine(task.title, TITLE_CHARS),
+            ...(task.agentName === undefined ? {} : { agentName: singleLine(task.agentName, TITLE_CHARS) }),
+            ...(task.kind === "agent" && task.model !== undefined ? { model: task.model } : {}),
+            elapsedMs: Math.max(0, at - entry.startedAt),
+            intervalMs: entry.intervalMs,
+        };
+        if (task.kind === "command" && lease) {
+            const end = await this.observeOutput(entry, lease, at);
+            if (end !== undefined)
+                described.output = { bytes: Number(end), tail: await this.outputTail(lease, end) };
+        }
+        if (entry.lastActivityAt !== undefined)
+            described.lastActivityAgoMs = Math.max(0, at - entry.lastActivityAt);
+        if (task.kind === "agent") {
+            const entries = lease ? taskOwnTranscriptEntries(lease) : undefined;
+            if (task.currentAction)
+                described.currentAction = {
+                    tool: singleLine(task.currentAction.tool, 60),
+                    text: singleLine(task.currentAction.text, LINE_CHARS),
+                    // The record keeps the last reported action after its tool returns. The child's own history says
+                    // whether a call is still outstanding: its last message is an assistant turn that called tools.
+                    running: entries !== undefined && endsInToolCall(entries),
+                };
+            if (task.metrics?.toolCount !== undefined)
+                described.toolCount = task.metrics.toolCount;
+            if (task.metrics?.tokenCount !== undefined)
+                described.tokenCount = task.metrics.tokenCount;
+            if (entries)
+                described.turnCount = entries.filter((item) => item.type === "message" && item.message.role === "assistant").length;
+        }
+        if (task.attention.kind === "input-needed")
+            described.attention = `waiting for input: ${singleLine(task.attention.prompt, LINE_CHARS)}`;
+        else if (task.attention.kind === "no-recent-activity")
+            described.attention = "no recent activity";
+        return described;
+    }
+    lease(taskId) {
+        const found = this.options.supervisor.lookupTask(this.options.owner, taskId);
+        return found.ok ? found.value : undefined;
+    }
+    async sampleShellOutput(at) {
+        for (const entry of [...this.tracked.values()]) {
+            if (entry.record.kind !== "command" || entry.intervalMs === 0)
+                continue;
+            const lease = this.lease(entry.taskId);
+            if (lease)
+                await this.observeOutput(entry, lease, at);
+        }
+    }
+    /** Current retained output size; growth since the last look dates the shell's last output. */
+    async observeOutput(entry, lease, at) {
+        const end = await findOutputEnd(this.options.supervisor, lease, entry.outputEnd);
+        if (end === undefined)
+            return undefined;
+        if (end > entry.outputEnd) {
+            entry.outputEnd = end;
+            entry.lastActivityAt = at;
+        }
+        return end;
+    }
+    async outputTail(lease, end) {
+        if (end === 0n)
+            return [];
+        const start = end > BigInt(OUTPUT_TAIL_BYTES) ? end - BigInt(OUTPUT_TAIL_BYTES) : 0n;
+        const page = await this.options.supervisor.readTaskOutput(lease, {
+            start: String(start),
+            maximumBytes: OUTPUT_TAIL_BYTES,
+        });
+        if (!page.ok)
+            return [];
+        const lines = taskOutputText(page.value).split("\n");
+        // The window can open mid-line; that fragment is not a line of output.
+        if (start > 0n)
+            lines.shift();
+        return lines
+            .map((line) => {
+            // A CRLF ending is not a redraw; a carriage return inside a line redraws it, so its last state counts.
+            const ended = line.replace(/\r+$/, "");
+            return singleLine(ended.slice(ended.lastIndexOf("\r") + 1), LINE_CHARS).trimEnd();
+        })
+            .filter((line) => line.trim().length > 0)
+            .slice(-OUTPUT_TAIL_LINES);
+    }
+}
+/**
+ * Retained output size of a running shell, found with one-byte reads: a read past the end returns nothing. Gallops
+ * from the last known size, then bisects, so a large burst of output costs a few dozen tiny reads, not a full scan.
+ */
+async function findOutputEnd(supervisor, lease, from) {
+    const probe = async (offset) => {
+        const page = await supervisor.readTaskOutput(lease, { start: String(offset), maximumBytes: 1 });
+        if (!page.ok)
+            return undefined;
+        if (page.value.nextOffset !== undefined)
+            return { before: true, end: BigInt(page.value.nextOffset) };
+        let end = offset;
+        for (const chunk of page.value.chunks)
+            if (BigInt(chunk.offsets.end) > end)
+                end = BigInt(chunk.offsets.end);
+        for (const range of page.value.omittedRanges)
+            if (BigInt(range.end) > end)
+                end = BigInt(range.end);
+        // No byte beyond this page: the output ends at its last byte, or at or before `offset` when it is empty.
+        return { before: end > offset, end };
+    };
+    let low = from;
+    const first = await probe(low);
+    if (!first)
+        return undefined;
+    if (!first.before)
+        return first.end > from ? first.end : from;
+    let step = 65536n;
+    let high = low + step;
+    for (;;) {
+        const result = await probe(high);
+        if (!result)
+            return undefined;
+        if (!result.before) {
+            if (result.end > high)
+                return result.end;
+            break;
+        }
+        low = high;
+        step *= 2n;
+        high = low + step;
+    }
+    // The output ends after `low` and at or before `high`.
+    while (high - low > 1n) {
+        const middle = low + (high - low) / 2n;
+        const result = await probe(middle);
+        if (!result)
+            return undefined;
+        if (result.before)
+            low = middle;
+        else if (result.end > middle)
+            return result.end;
+        else
+            high = middle;
+    }
+    return high;
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/core/tasks/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../../src/core/tasks/heartbeat.ts"],"names":[],"mappings":"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","sourcesContent":["import { taskOutputText } from \"./command-output.js\";\nimport type { NativeEvent, OwnerSnapshot, TaskId, TaskRecord } from \"./contracts.js\";\nimport {\n\tDEFAULT_TASK_HEARTBEAT_MS,\n\tformatTaskHeartbeat,\n\tisValidTaskHeartbeatMs,\n\tsingleLine,\n\tTASK_HEARTBEAT_MESSAGE_TYPE,\n\ttype TaskHeartbeatDetails,\n\ttype TaskHeartbeatMessage,\n\ttype TaskHeartbeatTask,\n} from \"./heartbeat-notice.js\";\nimport {\n\ttype OwnerLease,\n\ttype TaskLease,\n\ttype TaskSubscription,\n\ttype TaskSupervisor,\n\ttaskOwnTranscriptEntries,\n} from \"./supervisor.js\";\n\nexport * from \"./heartbeat-notice.js\";\n\n/** Tasks described in full by one notice; further due tasks are only listed. */\nexport const TASK_HEARTBEAT_DETAIL_LIMIT = 8;\n/** Further due tasks listed by name in one notice; the rest are counted. */\nexport const TASK_HEARTBEAT_LIST_LIMIT = 20;\n/** Boundaries due within this window (capped at a quarter cadence) join the notice that is going out. */\nexport const TASK_HEARTBEAT_COALESCE_MS = 60_000;\n/** While the owner has not read the previous notice, due tasks wait and are rechecked this often. */\nexport const TASK_HEARTBEAT_RECHECK_MS = 30_000;\n/** How often a running shell's output is sampled to date its last output. */\nexport const TASK_HEARTBEAT_OUTPUT_SAMPLE_MS = 30_000;\nconst OUTPUT_TAIL_BYTES = 2048;\nconst OUTPUT_TAIL_LINES = 6;\nconst LINE_CHARS = 160;\nconst TITLE_CHARS = 120;\n/** Longest delay a host timer accepts before it overflows to an immediate fire. */\nconst MAX_TIMER_DELAY_MS = 2_147_483_647;\n\n/** Where an owner's heartbeats go. The host binds its own chat; nothing here is model-provided. */\nexport interface TaskHeartbeatDelivery {\n\t/** Cadence for tasks launched without their own `heartbeatMs`; `0` disables. */\n\tdefaultIntervalMs(): number;\n\t/** Whether a heartbeat this owner already sent is still waiting, unread, in its chat. */\n\thasUnreadHeartbeat(): boolean;\n\tdeliver(message: TaskHeartbeatMessage): Promise<void>;\n}\n\n/** The owner's default cadence, or the built-in one when its setting cannot be read or is out of range. */\nexport function defaultTaskHeartbeatMs(delivery: Pick<TaskHeartbeatDelivery, \"defaultIntervalMs\">): number {\n\ttry {\n\t\tconst configured = delivery.defaultIntervalMs();\n\t\treturn isValidTaskHeartbeatMs(configured) ? configured : DEFAULT_TASK_HEARTBEAT_MS;\n\t} catch {\n\t\treturn DEFAULT_TASK_HEARTBEAT_MS;\n\t}\n}\n\nexport interface TaskHeartbeatClock {\n\tnow(): number;\n\tsetTimeout(run: () => void, delayMs: number): object;\n\tclearTimeout(handle: object): void;\n}\n\nconst systemClock: TaskHeartbeatClock = {\n\tnow: () => Date.now(),\n\tsetTimeout: (run, delayMs) => {\n\t\tconst handle = setTimeout(run, delayMs);\n\t\thandle.unref();\n\t\treturn handle;\n\t},\n\tclearTimeout: (handle) => clearTimeout(handle as ReturnType<typeof setTimeout>),\n};\n\nexport interface TaskHeartbeatMonitorOptions {\n\tsupervisor: TaskSupervisor;\n\towner: OwnerLease;\n\t/** Read on every use, so a replaced session's binding takes over the same owner. */\n\tdelivery: () => TaskHeartbeatDelivery | undefined;\n\tclock?: TaskHeartbeatClock;\n}\n\ntype Tracked = {\n\ttaskId: TaskId;\n\trecord: TaskRecord;\n\t/** First observed running: the anchor of the cadence. */\n\tstartedAt: number;\n\t/** Frozen when the task is first observed; `0` disables. */\n\tintervalMs: number;\n\t/** Next boundary `startedAt + n × intervalMs`; absent when disabled. */\n\tnextAt?: number;\n\tlastActivityAt?: number;\n\tactivityKey: string;\n\t/** Shells: retained output bytes observed so far. */\n\toutputEnd: bigint;\n};\n\nfunction activityKey(task: TaskRecord): string {\n\treturn JSON.stringify([task.currentAction, task.metrics, task.attention, task.model]);\n}\n\n/** Whether the newest message in a child's history is an assistant turn whose tool calls have not returned yet. */\nfunction endsInToolCall(entries: NonNullable<ReturnType<typeof taskOwnTranscriptEntries>>): boolean {\n\tfor (let index = entries.length - 1; index >= 0; index--) {\n\t\tconst entry = entries[index];\n\t\tif (entry?.type !== \"message\") continue;\n\t\tconst message = entry.message;\n\t\treturn message.role === \"assistant\" && message.content.some((block) => block.type === \"toolCall\");\n\t}\n\treturn false;\n}\n\n/** First boundary on the `startedAt + n × intervalMs` series strictly after `after`. */\nfunction nextBoundary(startedAt: number, intervalMs: number, after: number): number {\n\tconst n = Math.max(1, Math.floor((after - startedAt) / intervalMs) + 1);\n\tconst boundary = startedAt + n * intervalMs;\n\treturn boundary > after ? boundary : startedAt + (n + 1) * intervalMs;\n}\n\nfunction byBoundary(a: Tracked, b: Tracked): number {\n\tconst left = a.nextAt ?? Number.POSITIVE_INFINITY;\n\tconst right = b.nextAt ?? Number.POSITIVE_INFINITY;\n\tif (left !== right) return left - right;\n\treturn a.taskId < b.taskId ? -1 : a.taskId > b.taskId ? 1 : 0;\n}\n\n/**\n * Periodic \"is this still making progress?\" notices for one task owner's running shells and subagents.\n *\n * It follows the workflow heartbeat rules: boundaries are anchored at the task's start and never at the previous\n * delivery, missed boundaries are skipped rather than replayed, and only one notice per owner is outstanding. Unlike\n * a workflow run, an owner can have many tasks, so tasks due together share one bounded notice, and a task due while\n * the owner has not read the previous notice waits for it rather than losing its turn.\n */\nexport class TaskHeartbeatMonitor {\n\tprivate readonly options: TaskHeartbeatMonitorOptions;\n\tprivate readonly clock: TaskHeartbeatClock;\n\tprivate readonly tracked = new Map<TaskId, Tracked>();\n\tprivate subscription?: TaskSubscription;\n\tprivate timer?: object;\n\t/** The time the current timer wakes for, so an unchanged schedule keeps its timer. */\n\tprivate timerAt?: number;\n\tprivate busy = false;\n\tprivate disposed = false;\n\tprivate recheckAt?: number;\n\tprivate nextSampleAt?: number;\n\n\tconstructor(options: TaskHeartbeatMonitorOptions) {\n\t\tthis.options = options;\n\t\tthis.clock = options.clock ?? systemClock;\n\t}\n\n\t/** Begin watching the owner. Idempotent. */\n\tstart(): void {\n\t\tif (this.subscription || this.disposed) return;\n\t\tconst watched = this.options.supervisor.watchOwnerTasks(this.options.owner);\n\t\tif (!watched.ok) return;\n\t\tthis.subscription = watched.value;\n\t\tthis.subscription.onReconcile = (snapshot, events) => this.reconcile(snapshot, events);\n\t\tthis.reconcile(this.subscription.snapshot, []);\n\t}\n\n\tdispose(): void {\n\t\tif (this.disposed) return;\n\t\tthis.disposed = true;\n\t\tthis.subscription?.dispose();\n\t\tthis.subscription = undefined;\n\t\tthis.tracked.clear();\n\t\tthis.disarm();\n\t}\n\n\tprivate reconcile(snapshot: OwnerSnapshot, events: readonly NativeEvent[]): void {\n\t\tif (this.disposed) return;\n\t\tif (snapshot.state !== \"open\") {\n\t\t\tif (snapshot.state === \"closed\") this.dispose();\n\t\t\telse {\n\t\t\t\tthis.tracked.clear();\n\t\t\t\tthis.disarm();\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tconst at = this.clock.now();\n\t\tconst reported = new Set<TaskId>();\n\t\tfor (const event of events) if (event.payload.kind === \"task-activity\") reported.add(event.payload.ref.taskId);\n\t\tconst running = new Set<TaskId>();\n\t\tfor (const task of snapshot.tasks) {\n\t\t\t// Queued, stopping, paused and finished tasks do not heartbeat.\n\t\t\tif (task.execution.kind !== \"running\") continue;\n\t\t\tconst id = task.ref.taskId;\n\t\t\trunning.add(id);\n\t\t\tconst key = activityKey(task);\n\t\t\tconst entry = this.tracked.get(id);\n\t\t\tif (entry) {\n\t\t\t\tentry.record = task;\n\t\t\t\tif (key !== entry.activityKey || reported.has(id)) {\n\t\t\t\t\tentry.activityKey = key;\n\t\t\t\t\tentry.lastActivityAt = at;\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst intervalMs = this.resolveInterval(task);\n\t\t\tthis.tracked.set(id, {\n\t\t\t\ttaskId: id,\n\t\t\t\trecord: task,\n\t\t\t\tstartedAt: at,\n\t\t\t\tintervalMs,\n\t\t\t\t...(intervalMs > 0 ? { nextAt: at + intervalMs } : {}),\n\t\t\t\t...(reported.has(id) ? { lastActivityAt: at } : {}),\n\t\t\t\tactivityKey: key,\n\t\t\t\toutputEnd: 0n,\n\t\t\t});\n\t\t}\n\t\tfor (const id of [...this.tracked.keys()]) if (!running.has(id)) this.tracked.delete(id);\n\t\tif (!this.hasSampledShells()) this.nextSampleAt = undefined;\n\t\telse this.nextSampleAt ??= at + TASK_HEARTBEAT_OUTPUT_SAMPLE_MS;\n\t\tthis.arm();\n\t}\n\n\tprivate resolveInterval(task: TaskRecord): number {\n\t\t// Owners with a heartbeat binding fix each task's cadence on its record at admission.\n\t\tif (task.heartbeatMs !== undefined) return isValidTaskHeartbeatMs(task.heartbeatMs) ? task.heartbeatMs : 0;\n\t\tconst delivery = this.options.delivery();\n\t\treturn delivery ? defaultTaskHeartbeatMs(delivery) : DEFAULT_TASK_HEARTBEAT_MS;\n\t}\n\n\tprivate hasSampledShells(): boolean {\n\t\tfor (const entry of this.tracked.values())\n\t\t\tif (entry.record.kind === \"command\" && entry.intervalMs > 0) return true;\n\t\treturn false;\n\t}\n\n\tprivate disarm(): void {\n\t\tif (this.timer === undefined) return;\n\t\tthis.clock.clearTimeout(this.timer);\n\t\tthis.timer = undefined;\n\t\tthis.timerAt = undefined;\n\t}\n\n\tprivate arm(): void {\n\t\tif (this.disposed || this.busy) {\n\t\t\tthis.disarm();\n\t\t\treturn;\n\t\t}\n\t\t// A blocked owner cannot receive anything before its recheck, however many tasks come due meanwhile.\n\t\tlet wakeAt = this.recheckAt ?? Number.POSITIVE_INFINITY;\n\t\tif (this.recheckAt === undefined)\n\t\t\tfor (const entry of this.tracked.values())\n\t\t\t\tif (entry.nextAt !== undefined && entry.nextAt < wakeAt) wakeAt = entry.nextAt;\n\t\tif (this.nextSampleAt !== undefined && this.nextSampleAt < wakeAt) wakeAt = this.nextSampleAt;\n\t\t// Activity reconciles many times a second; it rarely moves the next wake-up.\n\t\tif (this.timer !== undefined && this.timerAt === wakeAt) return;\n\t\tthis.disarm();\n\t\tif (!Number.isFinite(wakeAt)) return;\n\t\tconst delay = Math.min(Math.max(1, Math.ceil(wakeAt - this.clock.now())), MAX_TIMER_DELAY_MS);\n\t\tthis.timerAt = wakeAt;\n\t\tthis.timer = this.clock.setTimeout(() => {\n\t\t\tthis.timer = undefined;\n\t\t\tthis.timerAt = undefined;\n\t\t\tvoid this.wake();\n\t\t}, delay);\n\t}\n\n\tprivate async wake(): Promise<void> {\n\t\tif (this.disposed || this.busy) return;\n\t\tthis.busy = true;\n\t\ttry {\n\t\t\tconst at = this.clock.now();\n\t\t\tif (this.nextSampleAt !== undefined && this.nextSampleAt <= at) {\n\t\t\t\tawait this.sampleShellOutput(at);\n\t\t\t\tthis.nextSampleAt = this.hasSampledShells() ? at + TASK_HEARTBEAT_OUTPUT_SAMPLE_MS : undefined;\n\t\t\t}\n\t\t\tawait this.beat(at);\n\t\t} catch {\n\t\t\t// A failed check skips this boundary; the next one is already scheduled.\n\t\t} finally {\n\t\t\tthis.busy = false;\n\t\t\tthis.arm();\n\t\t}\n\t}\n\n\tprivate async beat(at: number): Promise<void> {\n\t\tif (this.recheckAt !== undefined && this.recheckAt > at) return;\n\t\tthis.recheckAt = undefined;\n\t\tconst entries = [...this.tracked.values()];\n\t\tif (!entries.some((entry) => entry.nextAt !== undefined && entry.nextAt <= at)) return;\n\t\tconst delivery = this.options.delivery();\n\t\tlet unread = false;\n\t\ttry {\n\t\t\tunread = delivery?.hasUnreadHeartbeat() === true;\n\t\t} catch {\n\t\t\tunread = false;\n\t\t}\n\t\tif (unread) {\n\t\t\t// One outstanding notice per owner: due tasks stay owed and join the next notice instead of stacking.\n\t\t\tthis.recheckAt = at + TASK_HEARTBEAT_RECHECK_MS;\n\t\t\treturn;\n\t\t}\n\t\tconst batch = entries\n\t\t\t.filter(\n\t\t\t\t(entry) =>\n\t\t\t\t\tentry.nextAt !== undefined &&\n\t\t\t\t\tentry.nextAt <= at + Math.min(TASK_HEARTBEAT_COALESCE_MS, entry.intervalMs / 4),\n\t\t\t)\n\t\t\t.sort(byBoundary);\n\t\tfor (const entry of batch)\n\t\t\tentry.nextAt = nextBoundary(entry.startedAt, entry.intervalMs, Math.max(at, entry.nextAt ?? at));\n\t\tif (!delivery) return;\n\t\tconst details = await this.describe(batch, at);\n\t\t// A task that finished while its notice was being prepared is no longer mentioned.\n\t\tconst live = (taskId: string) => this.tracked.has(taskId as TaskId);\n\t\tdetails.tasks = details.tasks.filter((task) => live(task.taskId));\n\t\tdetails.more = details.more.filter((task) => live(task.taskId));\n\t\tdetails.moreCount = batch.slice(TASK_HEARTBEAT_DETAIL_LIMIT).filter((entry) => live(entry.taskId)).length;\n\t\tif (details.tasks.length === 0 || this.disposed) return;\n\t\tawait delivery.deliver({\n\t\t\tcustomType: TASK_HEARTBEAT_MESSAGE_TYPE,\n\t\t\tcontent: formatTaskHeartbeat(details),\n\t\t\tdisplay: true,\n\t\t\tdetails,\n\t\t});\n\t}\n\n\tprivate async describe(batch: readonly Tracked[], at: number): Promise<TaskHeartbeatDetails> {\n\t\tconst detailed = batch.slice(0, TASK_HEARTBEAT_DETAIL_LIMIT);\n\t\tconst rest = batch.slice(TASK_HEARTBEAT_DETAIL_LIMIT);\n\t\tconst tasks: TaskHeartbeatTask[] = [];\n\t\tfor (const entry of detailed) tasks.push(await this.describeTask(entry, at));\n\t\treturn {\n\t\t\tscheduledAt: at,\n\t\t\ttasks,\n\t\t\tmore: rest.slice(0, TASK_HEARTBEAT_LIST_LIMIT).map((entry) => ({\n\t\t\t\ttaskId: entry.taskId,\n\t\t\t\tkind: entry.record.kind,\n\t\t\t\ttitle: singleLine(entry.record.title, TITLE_CHARS),\n\t\t\t})),\n\t\t\tmoreCount: rest.length,\n\t\t};\n\t}\n\n\tprivate async describeTask(entry: Tracked, at: number): Promise<TaskHeartbeatTask> {\n\t\tconst task = entry.record;\n\t\tconst lease = this.lease(entry.taskId);\n\t\tconst described: TaskHeartbeatTask = {\n\t\t\ttaskId: entry.taskId,\n\t\t\tkind: task.kind,\n\t\t\ttitle: singleLine(task.title, TITLE_CHARS),\n\t\t\t...(task.agentName === undefined ? {} : { agentName: singleLine(task.agentName, TITLE_CHARS) }),\n\t\t\t...(task.kind === \"agent\" && task.model !== undefined ? { model: task.model } : {}),\n\t\t\telapsedMs: Math.max(0, at - entry.startedAt),\n\t\t\tintervalMs: entry.intervalMs,\n\t\t};\n\t\tif (task.kind === \"command\" && lease) {\n\t\t\tconst end = await this.observeOutput(entry, lease, at);\n\t\t\tif (end !== undefined) described.output = { bytes: Number(end), tail: await this.outputTail(lease, end) };\n\t\t}\n\t\tif (entry.lastActivityAt !== undefined) described.lastActivityAgoMs = Math.max(0, at - entry.lastActivityAt);\n\t\tif (task.kind === \"agent\") {\n\t\t\tconst entries = lease ? taskOwnTranscriptEntries(lease) : undefined;\n\t\t\tif (task.currentAction)\n\t\t\t\tdescribed.currentAction = {\n\t\t\t\t\ttool: singleLine(task.currentAction.tool, 60),\n\t\t\t\t\ttext: singleLine(task.currentAction.text, LINE_CHARS),\n\t\t\t\t\t// The record keeps the last reported action after its tool returns. The child's own history says\n\t\t\t\t\t// whether a call is still outstanding: its last message is an assistant turn that called tools.\n\t\t\t\t\trunning: entries !== undefined && endsInToolCall(entries),\n\t\t\t\t};\n\t\t\tif (task.metrics?.toolCount !== undefined) described.toolCount = task.metrics.toolCount;\n\t\t\tif (task.metrics?.tokenCount !== undefined) described.tokenCount = task.metrics.tokenCount;\n\t\t\tif (entries)\n\t\t\t\tdescribed.turnCount = entries.filter(\n\t\t\t\t\t(item) => item.type === \"message\" && item.message.role === \"assistant\",\n\t\t\t\t).length;\n\t\t}\n\t\tif (task.attention.kind === \"input-needed\")\n\t\t\tdescribed.attention = `waiting for input: ${singleLine(task.attention.prompt, LINE_CHARS)}`;\n\t\telse if (task.attention.kind === \"no-recent-activity\") described.attention = \"no recent activity\";\n\t\treturn described;\n\t}\n\n\tprivate lease(taskId: TaskId): TaskLease | undefined {\n\t\tconst found = this.options.supervisor.lookupTask(this.options.owner, taskId);\n\t\treturn found.ok ? found.value : undefined;\n\t}\n\n\tprivate async sampleShellOutput(at: number): Promise<void> {\n\t\tfor (const entry of [...this.tracked.values()]) {\n\t\t\tif (entry.record.kind !== \"command\" || entry.intervalMs === 0) continue;\n\t\t\tconst lease = this.lease(entry.taskId);\n\t\t\tif (lease) await this.observeOutput(entry, lease, at);\n\t\t}\n\t}\n\n\t/** Current retained output size; growth since the last look dates the shell's last output. */\n\tprivate async observeOutput(entry: Tracked, lease: TaskLease, at: number): Promise<bigint | undefined> {\n\t\tconst end = await findOutputEnd(this.options.supervisor, lease, entry.outputEnd);\n\t\tif (end === undefined) return undefined;\n\t\tif (end > entry.outputEnd) {\n\t\t\tentry.outputEnd = end;\n\t\t\tentry.lastActivityAt = at;\n\t\t}\n\t\treturn end;\n\t}\n\n\tprivate async outputTail(lease: TaskLease, end: bigint): Promise<string[]> {\n\t\tif (end === 0n) return [];\n\t\tconst start = end > BigInt(OUTPUT_TAIL_BYTES) ? end - BigInt(OUTPUT_TAIL_BYTES) : 0n;\n\t\tconst page = await this.options.supervisor.readTaskOutput(lease, {\n\t\t\tstart: String(start),\n\t\t\tmaximumBytes: OUTPUT_TAIL_BYTES,\n\t\t});\n\t\tif (!page.ok) return [];\n\t\tconst lines = taskOutputText(page.value).split(\"\\n\");\n\t\t// The window can open mid-line; that fragment is not a line of output.\n\t\tif (start > 0n) lines.shift();\n\t\treturn lines\n\t\t\t.map((line) => {\n\t\t\t\t// A CRLF ending is not a redraw; a carriage return inside a line redraws it, so its last state counts.\n\t\t\t\tconst ended = line.replace(/\\r+$/, \"\");\n\t\t\t\treturn singleLine(ended.slice(ended.lastIndexOf(\"\\r\") + 1), LINE_CHARS).trimEnd();\n\t\t\t})\n\t\t\t.filter((line) => line.trim().length > 0)\n\t\t\t.slice(-OUTPUT_TAIL_LINES);\n\t}\n}\n\n/**\n * Retained output size of a running shell, found with one-byte reads: a read past the end returns nothing. Gallops\n * from the last known size, then bisects, so a large burst of output costs a few dozen tiny reads, not a full scan.\n */\nasync function findOutputEnd(supervisor: TaskSupervisor, lease: TaskLease, from: bigint): Promise<bigint | undefined> {\n\tconst probe = async (offset: bigint): Promise<{ before: boolean; end: bigint } | undefined> => {\n\t\tconst page = await supervisor.readTaskOutput(lease, { start: String(offset), maximumBytes: 1 });\n\t\tif (!page.ok) return undefined;\n\t\tif (page.value.nextOffset !== undefined) return { before: true, end: BigInt(page.value.nextOffset) };\n\t\tlet end = offset;\n\t\tfor (const chunk of page.value.chunks) if (BigInt(chunk.offsets.end) > end) end = BigInt(chunk.offsets.end);\n\t\tfor (const range of page.value.omittedRanges) if (BigInt(range.end) > end) end = BigInt(range.end);\n\t\t// No byte beyond this page: the output ends at its last byte, or at or before `offset` when it is empty.\n\t\treturn { before: end > offset, end };\n\t};\n\tlet low = from;\n\tconst first = await probe(low);\n\tif (!first) return undefined;\n\tif (!first.before) return first.end > from ? first.end : from;\n\tlet step = 65_536n;\n\tlet high = low + step;\n\tfor (;;) {\n\t\tconst result = await probe(high);\n\t\tif (!result) return undefined;\n\t\tif (!result.before) {\n\t\t\tif (result.end > high) return result.end;\n\t\t\tbreak;\n\t\t}\n\t\tlow = high;\n\t\tstep *= 2n;\n\t\thigh = low + step;\n\t}\n\t// The output ends after `low` and at or before `high`.\n\twhile (high - low > 1n) {\n\t\tconst middle = low + (high - low) / 2n;\n\t\tconst result = await probe(middle);\n\t\tif (!result) return undefined;\n\t\tif (result.before) low = middle;\n\t\telse if (result.end > middle) return result.end;\n\t\telse high = middle;\n\t}\n\treturn high;\n}\n"]}

package/dist/core/tasks/supervisor.d.ts

@@ -67,6 +67,8 @@ export type TrustedTaskHost = {
     authorizeLaunch(intent: C.AgentIntent): void;
     resourceAdmission?: import("../sdk-types.ts").ResourceAdmission;
     onTaskSettled?(ref: C.NativeTaskRef, receipt: C.SettlementReceipt): void;
+    /** Heartbeat cadence for a launch that names none, fixed on its record at admission; omitted, none is recorded. */
+    defaultHeartbeatMs?(): number | undefined;
     createRunner(context: FakeRunnerContext, intent: C.AgentIntent): FakeExecution;
 };
 /** Reads only history bound by the admitted runner, never a caller-selected session. */

package/dist/core/tasks/supervisor.d.ts.map

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

package/dist/core/tasks/supervisor.js

@@ -197,10 +197,26 @@ function observation(value) {
 // Native records own lifecycle and mutable execution metadata. Routing provenance is
 // immutable host metadata, retained for the same environment lifetime as task records.
 const routerSelections = new Map();
+// Launch heartbeat cadences, keyed by owner and launch operation rather than task id: a command's
+// record can be observed before its native start resolves, and it must already carry its cadence.
+const launchHeartbeats = new Map();
+function launchKey(ownerId, operation) {
+    return `${ownerId}\0${operation}`;
+}
+/** Record a launch's cadence before native admission; returns the key to forget if admission fails. */
+function rememberLaunchHeartbeat(ownerId, operation, heartbeatMs) {
+    const key = launchKey(ownerId, operation);
+    // A replayed operation keeps the cadence of the launch that admitted it.
+    if (heartbeatMs === undefined || launchHeartbeats.has(key))
+        return undefined;
+    launchHeartbeats.set(key, heartbeatMs);
+    return key;
+}
 function record(value) {
     if (value.kind !== "agent" && value.kind !== "command")
         throw new Error(`Invalid native task kind: ${value.kind}`);
     const routerSelection = routerSelections.get(value.ref.taskId);
+    const heartbeatMs = launchHeartbeats.get(launchKey(value.ref.ownerId, value.launchOperationId));
     return {
         ref: reference(value.ref),
         launchOperationId: value.launchOperationId,
@@ -213,6 +229,7 @@ function record(value) {
         ...(value.model === undefined ? {} : { model: value.model }),
         ...(value.thinking === undefined ? {} : { thinking: value.thinking }),
         ...(routerSelection ? { routerSelection } : {}),
+        ...(heartbeatMs === undefined ? {} : { heartbeatMs }),
         execution: execution(value.execution),
         observation: observation(value.observation),
         ...(value.wasBackground === undefined ? {} : { wasBackground: value.wasBackground }),
@@ -580,6 +597,7 @@ export class TaskSupervisor {
             const owner = new OwnerCapability();
             Object.freeze(owner);
             const ownerState = {
+                id,
                 native: lease,
                 host: state,
                 tasks: new Map(),
@@ -701,9 +719,11 @@ export class TaskSupervisor {
         let release;
         try {
             release = await (currentResourceAdmission() ?? state.host.binding.resourceAdmission)?.acquire("process", signal ? AbortSignal.any([signal, state.closing.signal]) : state.closing.signal);
+            const { heartbeatMs, ...nativeIntent } = intent;
+            const heartbeatKey = rememberLaunchHeartbeat(state.id, operation, heartbeatMs ?? state.host.binding.defaultHeartbeatMs?.());
             let started;
             try {
-                started = await this.#native.startCommandTask(state.native, intent, operation);
+                started = await this.#native.startCommandTask(state.native, nativeIntent, operation);
             }
             catch (error) {
                 release = undefined;
@@ -716,8 +736,11 @@ export class TaskSupervisor {
                 throw new Error(`Command cleanup unconfirmed; process permit retained: ${started.error.code}: ${started.error.message}`);
             }
             const admitted = mapped(started, (lease) => lease, startErrors);
-            if (!admitted.ok)
+            if (!admitted.ok) {
+                if (heartbeatKey !== undefined)
+                    launchHeartbeats.delete(heartbeatKey);
                 return admitted;
+            }
             const ref = this.#native.taskReference(admitted.value);
             if (!ref.ok)
                 throw new Error(ref.error.message);
@@ -808,9 +831,14 @@ export class TaskSupervisor {
     async startAgentTask(owner, intent, operation, schedule) {
         const state = this.#owner(owner);
         state.host.binding.authorizeLaunch(intent);
-        const admitted = mapped(this.#native.startAgentTask(state.native, intent, operation), (lease) => lease, startErrors);
-        if (!admitted.ok)
+        const { heartbeatMs, ...nativeIntent } = intent;
+        const heartbeatKey = rememberLaunchHeartbeat(state.id, operation, heartbeatMs ?? state.host.binding.defaultHeartbeatMs?.());
+        const admitted = mapped(this.#native.startAgentTask(state.native, nativeIntent, operation), (lease) => lease, startErrors);
+        if (!admitted.ok) {
+            if (heartbeatKey !== undefined)
+                launchHeartbeats.delete(heartbeatKey);
             return admitted;
+        }
         const ref = this.#native.taskReference(admitted.value);
         if (!ref.ok)
             throw new Error(ref.error.message);