agentic-engineering-harness 0.6.14 → 0.6.16

package/dist/operations/wakeBudget.d.ts

@@ -0,0 +1,15 @@
+export type DurableWakeTarget = "lead" | "supervisor";
+export type DurableWakeReason = "progress" | "blocked" | "stalled" | "terminal";
+export interface OperationWakeBudget {
+    version: 1;
+    operationId: string;
+    revision: number;
+    supervisorAccepted: number;
+    leadAccepted: number;
+    terminalLeadAccepted: number;
+    updatedAt: string;
+    lastAcceptedAt?: string;
+}
+export declare function operationWakeBudgetFile(root: string, operationId: string): string;
+export declare function loadOperationWakeBudget(root: string, operationId: string, revision: number): Promise<OperationWakeBudget>;
+export declare function recordOperationWakeAccepted(root: string, operationId: string, revision: number, target: DurableWakeTarget, reason: DurableWakeReason): Promise<OperationWakeBudget>;

package/dist/operations/wakeBudget.js

@@ -0,0 +1,142 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { resolveOperationStateRoot } from "./state.js";
+const LOCK_RETRY_MS = 20;
+const LOCK_TIMEOUT_MS = 5_000;
+const STALE_LOCK_MS = 30_000;
+export function operationWakeBudgetFile(root, operationId) {
+    return path.resolve(resolveOperationStateRoot(root), ".harness/operations", `${safeId(operationId)}.wake.json`);
+}
+export async function loadOperationWakeBudget(root, operationId, revision) {
+    try {
+        const parsed = JSON.parse(await fs.readFile(operationWakeBudgetFile(root, operationId), "utf8"));
+        if (parsed.version !== 1 || parsed.operationId !== operationId || parsed.revision !== revision)
+            return empty(operationId, revision);
+        return {
+            ...parsed,
+            supervisorAccepted: count(parsed.supervisorAccepted),
+            leadAccepted: count(parsed.leadAccepted),
+            terminalLeadAccepted: count(parsed.terminalLeadAccepted)
+        };
+    }
+    catch (error) {
+        if (isMissing(error))
+            return empty(operationId, revision);
+        throw error;
+    }
+}
+export async function recordOperationWakeAccepted(root, operationId, revision, target, reason) {
+    const file = operationWakeBudgetFile(root, operationId);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    return withLock(file, async () => {
+        const previous = await loadUnlocked(file, operationId, revision);
+        const now = new Date().toISOString();
+        const next = {
+            ...previous,
+            supervisorAccepted: previous.supervisorAccepted + (target === "supervisor" ? 1 : 0),
+            leadAccepted: previous.leadAccepted + (target === "lead" ? 1 : 0),
+            terminalLeadAccepted: previous.terminalLeadAccepted + (target === "lead" && reason === "terminal" ? 1 : 0),
+            updatedAt: now,
+            lastAcceptedAt: now
+        };
+        await writeAtomic(file, next);
+        return next;
+    });
+}
+async function loadUnlocked(file, operationId, revision) {
+    try {
+        const parsed = JSON.parse(await fs.readFile(file, "utf8"));
+        if (parsed.version !== 1 || parsed.operationId !== operationId || parsed.revision !== revision)
+            return empty(operationId, revision);
+        return {
+            ...parsed,
+            supervisorAccepted: count(parsed.supervisorAccepted),
+            leadAccepted: count(parsed.leadAccepted),
+            terminalLeadAccepted: count(parsed.terminalLeadAccepted)
+        };
+    }
+    catch (error) {
+        if (isMissing(error))
+            return empty(operationId, revision);
+        throw error;
+    }
+}
+function empty(operationId, revision) {
+    return {
+        version: 1,
+        operationId,
+        revision,
+        supervisorAccepted: 0,
+        leadAccepted: 0,
+        terminalLeadAccepted: 0,
+        updatedAt: new Date().toISOString()
+    };
+}
+async function writeAtomic(file, budget) {
+    const temp = `${file}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    await fs.writeFile(temp, `${JSON.stringify(budget, null, 2)}\n`);
+    try {
+        await fs.rename(temp, file);
+    }
+    finally {
+        await fs.rm(temp, { force: true }).catch(() => undefined);
+    }
+}
+async function withLock(file, action) {
+    const lock = `${file}.lock`;
+    const deadline = Date.now() + LOCK_TIMEOUT_MS;
+    for (;;) {
+        let handle;
+        try {
+            handle = await fs.open(lock, "wx");
+            try {
+                await handle.writeFile(`${process.pid}\n`);
+                return await action();
+            }
+            finally {
+                await handle.close().catch(() => undefined);
+                await fs.rm(lock, { force: true }).catch(() => undefined);
+            }
+        }
+        catch (error) {
+            if (handle)
+                throw error;
+            if (!isAlreadyExists(error))
+                throw error;
+            if (await canRecoverLock(lock)) {
+                await fs.rm(lock, { force: true }).catch(() => undefined);
+                continue;
+            }
+            if (Date.now() >= deadline)
+                throw new Error(`Timed out acquiring wake budget lock for ${path.basename(file)}.`);
+            await delay(LOCK_RETRY_MS);
+        }
+    }
+}
+async function canRecoverLock(lock) {
+    try {
+        const [rawPid, stat] = await Promise.all([fs.readFile(lock, "utf8").catch(() => ""), fs.stat(lock)]);
+        const ownerPid = Number.parseInt(rawPid.trim(), 10);
+        if (Number.isInteger(ownerPid) && ownerPid > 0 && !processAlive(ownerPid))
+            return true;
+        return Date.now() - stat.mtimeMs > STALE_LOCK_MS;
+    }
+    catch {
+        return true;
+    }
+}
+function processAlive(pid) { try {
+    process.kill(pid, 0);
+    return true;
+}
+catch {
+    return false;
+} }
+function count(value) { return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : 0; }
+function safeId(value) { if (!/^[A-Za-z0-9._-]+$/.test(value))
+    throw new Error(`Invalid operation id '${value}'.`); return value; }
+function isMissing(error) { return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT"); }
+function isAlreadyExists(error) { return Boolean(error && typeof error === "object" && "code" in error && error.code === "EEXIST"); }
+function delay(ms) { return new Promise((resolve) => setTimeout(resolve, ms)); }
+//# sourceMappingURL=wakeBudget.js.map

package/dist/operations/wakeBudget.js.map

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

package/dist/paseo/runtime.d.ts

@@ -17,7 +17,7 @@ export interface ManagedPaseoAgentResult {
     status?: string;
     workspaceId?: string;
     transport: "sdk" | "cli";
-    observation?: "subscription" | "sdk-wait" | "cli-wait";
+    observation?: "subscription" | "sdk-run" | "sdk-wait" | "cli-wait";
 }
 interface PaseoRuntimeDeps {
     run: typeof runProcess;