agentic-engineering-harness 0.8.9 → 0.8.11

package/dist/releases/release-1791006063459-16409-661eedf2/operations/portfolio.js

@@ -0,0 +1,233 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { sha256Canonical } from "../core/digest.js";
+import { activeOperationSupervisor, frozenOperationHardDeadlineAt, loadOperation } from "./state.js";
+const DEFAULT_POLICY = {
+    maxActiveOperations: 5, maxActiveAgents: 16, maxAgentsPerOperation: 8, maxProviderAgents: { codex: 4, opencode: 8 }
+};
+const LOCK_RETRY_MS = 20;
+const LOCK_TIMEOUT_MS = 10_000;
+const STALE_LOCK_MS = 30_000;
+export function operationPortfolioFile(root) { return path.resolve(root, ".harness/operations/portfolio.json"); }
+export async function loadOperationPortfolio(root, project = "unknown", context = {}) {
+    return enrichPortfolio(await hydratePortfolioOperations(root, await readPortfolio(operationPortfolioFile(root), project)), context);
+}
+export async function syncOperationPortfolio(root, project, operation) {
+    return mutatePortfolio(root, project, (current) => {
+        return {
+            ...current,
+            project,
+            leadAgentId: operation.lead?.agentId ?? current.leadAgentId,
+            leadGeneration: Math.max(current.leadGeneration, operation.lead?.generation ?? 0),
+            updatedAt: new Date().toISOString(),
+            operations: {
+                ...current.operations,
+                [operation.id]: portfolioEntryFromOperation(operation)
+            }
+        };
+    });
+}
+export async function bindPortfolioLead(root, project, agentId, generation) {
+    return mutatePortfolio(root, project, (current) => ({
+        ...current, project, leadAgentId: agentId,
+        leadGeneration: generation ?? current.leadGeneration + 1,
+        updatedAt: new Date().toISOString()
+    }));
+}
+export function operationConcurrencyPolicy(config) {
+    const orchestration = config.orchestration;
+    const configured = orchestration?.operations?.concurrency;
+    return {
+        maxActiveOperations: positive(configured?.maxActiveOperations, DEFAULT_POLICY.maxActiveOperations),
+        maxActiveAgents: positive(configured?.maxActiveAgents, DEFAULT_POLICY.maxActiveAgents),
+        maxAgentsPerOperation: positive(configured?.maxAgentsPerOperation, DEFAULT_POLICY.maxAgentsPerOperation),
+        maxProviderAgents: { ...DEFAULT_POLICY.maxProviderAgents, ...(configured?.maxProviderAgents ?? {}) }
+    };
+}
+export async function assertOperationCapacity(root, config, requestedPriority = 50) {
+    const file = operationPortfolioFile(root);
+    const policy = operationConcurrencyPolicy(config);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await withPortfolioLock(file, async () => {
+        const portfolio = await hydratePortfolioOperations(root, await readPortfolio(file, config.project.name));
+        const active = Object.values(portfolio.operations).filter((item) => (item.status === "QUEUED" || item.status === "RUNNING") && item.deadlineDisposition !== "UNFROZEN_UNSUPPORTED");
+        if (active.length < policy.maxActiveOperations)
+            return;
+        const lowest = active.reduce((min, item) => Math.min(min, item.priority), Number.POSITIVE_INFINITY);
+        throw new Error(`AEH_OPERATION_CAPACITY: ${active.length} active operations already consume the configured lead/project limit ${policy.maxActiveOperations}. Requested priority=${requestedPriority}; current lowest priority=${Number.isFinite(lowest) ? lowest : "n/a"}. Wait, cancel, or raise the configured orchestration.operations.concurrency.maxActiveOperations limit.`);
+    });
+}
+function portfolioEntryFromOperation(operation) {
+    const supervisor = activeOperationSupervisor(operation);
+    const active = operation.status === "QUEUED" || operation.status === "RUNNING";
+    const frozenDeadline = frozenOperationHardDeadlineAt(operation);
+    return {
+        operationId: operation.id, kind: operation.kind, status: operation.status, phase: operation.phase,
+        workspaceId: operation.workspaceId, supervisorAgentId: supervisor?.agentId, supervisorGeneration: supervisor?.generation,
+        revision: operation.revision,
+        acknowledgedRevision: operation.lead?.acknowledgedRevision ?? operation.notification.lastLeadWakeRevision,
+        boundLeadAgentId: operation.lead?.agentId,
+        originKind: operation.origin?.kind,
+        parentOperationId: operation.origin?.parentOperationId,
+        userTurnDigest: operation.origin?.userTurnId ? sha256Canonical(operation.origin.userTurnId) : undefined,
+        ownerBoundaryKinds: [
+            ...(operation.ownerEconomicBoundary?.state === "WAITING" ? ["OWNER_ECONOMIC_BOUNDARY"] : []),
+            ...(operation.ownerContinuationBoundary?.state === "WAITING" ? ["OWNER_HARD_DEADLINE"] : [])
+        ],
+        deadlineDisposition: !active ? "NOT_APPLICABLE" : frozenDeadline === undefined ? "UNFROZEN_UNSUPPORTED" : "FROZEN_DEADLINE",
+        ...(active && frozenDeadline === undefined ? { deadlineDiagnosticCode: "OPERATION_UNSUPPORTED_UNFROZEN_DEADLINE" } : {}),
+        priority: operation.intent?.priority ?? 50,
+        updatedAt: operation.updatedAt
+    };
+}
+async function hydratePortfolioOperations(root, portfolio) {
+    const entries = await Promise.all(Object.entries(portfolio.operations).map(async ([operationId, entry]) => {
+        const operation = await loadOperation(root, operationId).catch((error) => isMissing(error) ? undefined : Promise.reject(error));
+        return [operationId, operation ? portfolioEntryFromOperation(operation) : entry];
+    }));
+    return { ...portfolio, operations: Object.fromEntries(entries) };
+}
+async function mutatePortfolio(root, project, mutate) {
+    const file = operationPortfolioFile(root);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    return withPortfolioLock(file, async () => {
+        // Atomic rename alone does not prevent lost updates: multiple operation
+        // controllers must serialize the complete read-modify-write transaction.
+        const current = await readPortfolio(file, project);
+        const next = mutate(current);
+        await persistUnlocked(file, next);
+        return next;
+    });
+}
+async function readPortfolio(file, project) {
+    try {
+        const value = JSON.parse(await fs.readFile(file, "utf8"));
+        if (value.version !== 1 || !value.operations)
+            throw new Error("invalid portfolio record");
+        return value;
+    }
+    catch (error) {
+        if (!isMissing(error))
+            throw error;
+        return { version: 1, project, leadGeneration: 0, updatedAt: new Date().toISOString(), operations: {} };
+    }
+}
+function enrichPortfolio(portfolio, context) {
+    const entries = Object.values(portfolio.operations);
+    const byId = new Map(entries.map((entry) => [entry.operationId, entry]));
+    const children = new Map();
+    for (const entry of entries)
+        if (entry.parentOperationId)
+            children.set(entry.parentOperationId, [...(children.get(entry.parentOperationId) ?? []), entry]);
+    const rootId = (entry) => {
+        let current = entry;
+        const seen = new Set();
+        while (current.parentOperationId && byId.has(current.parentOperationId) && !seen.has(current.operationId)) {
+            seen.add(current.operationId);
+            current = byId.get(current.parentOperationId);
+        }
+        return current.operationId;
+    };
+    const unresolvedFailedRoots = new Set();
+    for (const entry of entries) {
+        if ((entry.status !== "FAILED" && entry.status !== "CANCELLED") || entry.parentOperationId)
+            continue;
+        const chain = [entry];
+        const seen = new Set([entry.operationId]);
+        for (let index = 0; index < chain.length; index += 1) {
+            for (const child of children.get(chain[index].operationId) ?? []) {
+                if (!seen.has(child.operationId)) {
+                    seen.add(child.operationId);
+                    chain.push(child);
+                }
+            }
+        }
+        const leaves = chain.filter((item) => !(children.get(item.operationId)?.length));
+        if (leaves.some((leaf) => leaf.status !== "SUCCEEDED"))
+            unresolvedFailedRoots.add(entry.operationId);
+    }
+    const currentTurnDigest = context.currentUserTurnId ? sha256Canonical(context.currentUserTurnId) : undefined;
+    const relevantRoots = new Set(entries.filter((entry) => currentTurnDigest && entry.userTurnDigest === currentTurnDigest).map(rootId));
+    const globalScope = context.ownerBoundaryScope === "PROJECT_OR_OWNER_GLOBAL_BOUNDARY";
+    const operations = Object.fromEntries(entries.map((entry) => {
+        const leadRelationship = !entry.boundLeadAgentId ? "UNBOUND_HISTORICAL"
+            : entry.boundLeadAgentId === context.currentLeadAgentId ? "BOUND_CURRENT_LEAD" : "BOUND_OTHER_LEAD";
+        const root = rootId(entry);
+        const lineageRelationship = entry.userTurnDigest && currentTurnDigest && entry.userTurnDigest === currentTurnDigest
+            ? entry.parentOperationId ? "CONTINUATION_RELEVANT" : "CURRENT_ROOT"
+            : relevantRoots.has(root) ? "CONTINUATION_RELEVANT" : "HISTORICAL_UNRELATED";
+        const hasGlobalCandidateBoundary = Boolean(entry.ownerBoundaryKinds?.length);
+        const ownerAttention = hasGlobalCandidateBoundary
+            ? globalScope ? "PROJECT_OR_OWNER_GLOBAL_BOUNDARY" : "CHAIN_SCOPED_BOUNDARY"
+            : unresolvedFailedRoots.has(root) ? "CHAIN_SCOPED_BOUNDARY" : "NONE";
+        return [entry.operationId, { ...entry, leadRelationship, lineageRelationship, ownerAttention }];
+    }));
+    return { ...portfolio, operations };
+}
+async function persistUnlocked(file, portfolio) {
+    const temp = `${file}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+    await fs.writeFile(temp, `${JSON.stringify(portfolio, null, 2)}\n`);
+    try {
+        await fs.rename(temp, file);
+    }
+    finally {
+        await fs.rm(temp, { force: true }).catch(() => undefined);
+    }
+}
+async function withPortfolioLock(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) {
+                await handle.close().catch(() => undefined);
+                await fs.rm(lock, { force: true }).catch(() => undefined);
+                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 operation portfolio lock for ${path.basename(file)}.`);
+            await new Promise((resolve) => setTimeout(resolve, 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)
+            return !processAlive(ownerPid);
+        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 positive(value, fallback) { return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback; }
+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"); }
+//# sourceMappingURL=portfolio.js.map

package/dist/releases/release-1791006063459-16409-661eedf2/operations/portfolio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.js","sourceRoot":"","sources":["../../src/operations/portfolio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA6BrG,MAAM,cAAc,GAA+B;IACjD,mBAAmB,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;CACpH,CAAC;AACF,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,MAAM,UAAU,sBAAsB,CAAC,IAAY,IAAY,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,oCAAoC,CAAC,CAAC,CAAC,CAAC;AACjI,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,OAAO,GAAG,SAAS,EAAE,UAAuC,EAAE;IACvH,OAAO,eAAe,CAAC,MAAM,0BAA0B,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACtI,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,OAAe,EAAE,SAA4B;IACtG,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;QAChD,OAAO;YACL,GAAG,OAAO;YACV,OAAO;YACP,WAAW,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,IAAI,OAAO,CAAC,WAAW;YAC3D,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,IAAI,EAAE,UAAU,IAAI,CAAC,CAAC;YACjF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,UAAU,EAAE;gBACV,GAAG,OAAO,CAAC,UAAU;gBACrB,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,2BAA2B,CAAC,SAAS,CAAC;aACvD;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe,EAAE,OAAe,EAAE,UAAmB;IACzG,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClD,GAAG,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO;QACzC,cAAc,EAAE,UAAU,IAAI,OAAO,CAAC,cAAc,GAAG,CAAC;QACxD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAA4B;IACrE,MAAM,aAAa,GAAG,MAAM,CAAC,aAA+F,CAAC;IAC7H,MAAM,UAAU,GAAG,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC;IAC1D,OAAO;QACL,mBAAmB,EAAE,QAAQ,CAAC,UAAU,EAAE,mBAAmB,EAAE,cAAc,CAAC,mBAAmB,CAAC;QAClG,eAAe,EAAE,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,cAAc,CAAC,eAAe,CAAC;QACtF,qBAAqB,EAAE,QAAQ,CAAC,UAAU,EAAE,qBAAqB,EAAE,cAAc,CAAC,qBAAqB,CAAC;QACxG,iBAAiB,EAAE,EAAE,GAAG,cAAc,CAAC,iBAAiB,EAAE,GAAG,CAAC,UAAU,EAAE,iBAAiB,IAAI,EAAE,CAAC,EAAE;KACrG,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAY,EAAE,MAA4B,EAAE,iBAAiB,GAAG,EAAE;IAC9G,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,iBAAiB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACzG,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC,mBAAmB,KAAK,sBAAsB,CAAC,CAAC;QACpL,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,mBAAmB;YAAE,OAAO;QACvD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACpG,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,MAAM,wEAAwE,MAAM,CAAC,mBAAmB,wBAAwB,iBAAiB,6BAA6B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,yGAAyG,CAAC,CAAC;IACrX,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,2BAA2B,CAAC,SAA4B;IAC/D,MAAM,UAAU,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC;IAC/E,MAAM,cAAc,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;IAChE,OAAO;QACL,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK;QACjG,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU;QACxH,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,oBAAoB,EAAE,SAAS,CAAC,IAAI,EAAE,oBAAoB,IAAI,SAAS,CAAC,YAAY,CAAC,oBAAoB;QACzG,gBAAgB,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO;QACzC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI;QAClC,iBAAiB,EAAE,SAAS,CAAC,MAAM,EAAE,iBAAiB;QACtD,cAAc,EAAE,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;QACvG,kBAAkB,EAAE;YAClB,GAAG,CAAC,SAAS,CAAC,qBAAqB,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,yBAAkC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrG,GAAG,CAAC,SAAS,CAAC,yBAAyB,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,qBAA8B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACtG;QACD,mBAAmB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,iBAAiB;QAC3H,GAAG,CAAC,MAAM,IAAI,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,yCAAkD,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjI,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE;QAC1C,SAAS,EAAE,SAAS,CAAC,SAAS;KAC/B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,IAAY,EAAE,SAA6B;IACnF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,EAAE;QACxG,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACzI,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAU,CAAC;IAC5F,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe,EAAE,MAA2D;IACvH,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,OAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QACxC,wEAAwE;QACxE,yEAAyE;QACzE,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AACD,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,OAAe;IACxD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAuB,CAAC;QAChF,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC1F,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACzG,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,SAA6B,EAAE,OAAoC;IAC1F,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC9D,KAAK,MAAM,KAAK,IAAI,OAAO;QAAE,IAAI,KAAK,CAAC,iBAAiB;YAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3J,MAAM,MAAM,GAAG,CAAC,KAA8B,EAAU,EAAE;QACxD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,OAAO,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1G,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC9B,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAE,CAAC;QACjD,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC,CAAC;IACF,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAU,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,IAAI,KAAK,CAAC,iBAAiB;YAAE,SAAS;QACrG,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAClD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACrD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;oBAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;YACvF,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACjF,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC;YAAE,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7G,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,IAAI,KAAK,CAAC,cAAc,KAAK,iBAAiB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACtI,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,KAAK,kCAAkC,CAAC;IACtF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1D,MAAM,gBAAgB,GAA6D,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,oBAAoB;YAC/H,CAAC,CAAC,KAAK,CAAC,gBAAgB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,kBAAkB,CAAC;QACtG,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,mBAAmB,GAAgE,KAAK,CAAC,cAAc,IAAI,iBAAiB,IAAI,KAAK,CAAC,cAAc,KAAK,iBAAiB;YAC9K,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,cAAc;YACpE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,sBAAsB,CAAC;QAC/E,MAAM,0BAA0B,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAC7E,MAAM,cAAc,GAA2D,0BAA0B;YACvG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,uBAAuB;YAC5E,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,CAAC;AACtC,CAAC;AACD,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,SAA6B;IACxE,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACjF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;YAC5B,CAAC;QAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;AACxE,CAAC;AACD,KAAK,UAAU,iBAAiB,CAAI,IAAY,EAAE,MAAwB;IACxE,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC;IAC9C,SAAS,CAAC;QACR,IAAI,MAAuD,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC;gBAAC,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;gBAAC,OAAO,MAAM,MAAM,EAAE,CAAC;YAAC,CAAC;oBAClE,CAAC;gBAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;QACrH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,MAAM,EAAE,CAAC;gBAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM,KAAK,CAAC;YAAC,CAAC;YACpI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACzC,IAAI,MAAM,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YACxG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxH,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AACD,KAAK,UAAU,cAAc,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrG,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;YAAE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC1B,CAAC;AACD,SAAS,YAAY,CAAC,GAAW,IAAa,IAAI,CAAC;IAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAAC,OAAO,IAAI,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,KAAK,CAAC;AAAC,CAAC,CAAC,CAAC;AAClH,SAAS,QAAQ,CAAC,KAAyB,EAAE,QAAgB,IAAY,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClL,SAAS,SAAS,CAAC,KAAc,IAAa,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAK,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AACzK,SAAS,eAAe,CAAC,KAAc,IAAa,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAK,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/releases/release-1791006063459-16409-661eedf2/operations/recoveryIdentity.d.ts

@@ -0,0 +1,3 @@
+import type { OperationRecordV2 } from "./state.js";
+/** Same-session recovery requires the exact active Paseo identity recorded at launch. */
+export declare function assertSameSessionResumeCompatibleV1(root: string, operation: OperationRecordV2, participantId: string): Promise<void>;

package/dist/releases/release-1791006063459-16409-661eedf2/operations/recoveryIdentity.js

@@ -0,0 +1,31 @@
+import { loadPaseoSessionBinding, resolveReusablePaseoSession } from "../paseo/sessionBinding.js";
+/** Same-session recovery requires the exact active Paseo identity recorded at launch. */
+export async function assertSameSessionResumeCompatibleV1(root, operation, participantId) {
+    const participant = operation.participants[participantId];
+    const binding = participant?.executionBinding;
+    if (!participant || !binding || binding.runtime.sessionId.startsWith("launch:"))
+        throw new Error("SAME_SESSION_RESUME_REJECTED: a current actual participant session identity is required.");
+    if (["COMPLETED", "CANCELLED", "BLOCKED"].includes(participant.status))
+        throw new Error("SAME_SESSION_RESUME_REJECTED: completed, cancelled, or blocked participant work cannot be resumed.");
+    if (!participant.transport?.startsWith("paseo"))
+        return;
+    const stored = await loadPaseoSessionBinding(root, operation.id, participantId);
+    const expected = {
+        projectId: operation.candidateRevision?.projectId ?? operation.resolvedOperationPolicy?.projectId ?? "",
+        operationId: operation.id,
+        operationExecutionRevision: binding.operationExecutionRevision,
+        participantId,
+        participantGeneration: binding.participantGeneration,
+        candidateRevision: binding.candidateRevision,
+        candidateDigest: binding.candidateDigest,
+        executionBlueprintDigest: binding.executionBlueprintDigest,
+        operationPolicyDigest: binding.operationPolicyDigest,
+        contextManifestDigest: binding.contextManifestDigest,
+        promptManifestDigest: binding.promptManifestDigest,
+        controllerEpoch: binding.controllerEpoch
+    };
+    const reusable = resolveReusablePaseoSession(stored, expected);
+    if (!reusable || reusable.paseoAgentId !== binding.runtime.sessionId)
+        throw new Error("SAME_SESSION_RESUME_REJECTED: Paseo session binding is missing, archived, lost, or incompatible with the current candidate, policy, epoch, participant generation, context, or prompt.");
+}
+//# sourceMappingURL=recoveryIdentity.js.map

package/dist/releases/release-1791006063459-16409-661eedf2/operations/recoveryIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recoveryIdentity.js","sourceRoot":"","sources":["../../src/operations/recoveryIdentity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAElG,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,mCAAmC,CAAC,IAAY,EAAE,SAA4B,EAAE,aAAqB;IACzH,MAAM,WAAW,GAAG,SAAS,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,WAAW,EAAE,gBAAgB,CAAC;IAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;IAC7L,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oGAAoG,CAAC,CAAC;IAC9L,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IACxD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG;QACf,SAAS,EAAE,SAAS,CAAC,iBAAiB,EAAE,SAAS,IAAI,SAAS,CAAC,uBAAuB,EAAE,SAAS,IAAI,EAAE;QACvG,WAAW,EAAE,SAAS,CAAC,EAAE;QACzB,0BAA0B,EAAE,OAAO,CAAC,0BAA0B;QAC9D,aAAa;QACb,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;QAC1D,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CAAC;IACF,MAAM,QAAQ,GAAG,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wLAAwL,CAAC,CAAC;AAClR,CAAC"}