The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
import { describe, expect, it } from "vitest";
import { cancellationResultJson, canContinueCancelledRun, controllerLeaseLossCancellation, isUnexpectedRunCancellation,
readControllerLeaseLossCause, readRunCancellation, requestedRunCancellation } from "./run-cancellation.js";
describe("cancellation provenance", () => {
const run = { status: "cancelled", runtimeMode: "legacy" as const, startedAt: new Date(0), finishedAt: new Date(1),
error: "Cancelled", errorCode: "cancelled", resultJson: null };
it("preserves operator intent over adapter completion metadata", () => {
const cancellation = requestedRunCancellation({ cancelledByUserId: "board", cancelledByActorType: "user" }, "Stop");
const resultJson = cancellationResultJson({ ...run, resultJson: { cancellation } }, "cancelled", { status: "cancelled" });
expect(resultJson?.cancellation).toEqual(cancellation);
expect(isUnexpectedRunCancellation({ ...run, resultJson })).toBe(false);
expect(canContinueCancelledRun({ ...run, resultJson })).toBe(false);
});
it("records queue interruption and shutdown as expected system actions", () => {
expect(requestedRunCancellation({ queuedCommentInterruptQueueId: "queue", cancelledByUserId: "board" }, "Send messages"))
.toMatchObject({ source: "queued_message", expected: true, initiator: { type: "user", id: "board" } });
expect(cancellationResultJson(run, "interrupted", {}, "server_shutdown_interrupted")?.cancellation)
.toMatchObject({ source: "shutdown", expected: true });
expect(requestedRunCancellation({ queuedCommentInterruptQueueId: "queue", interruptedByActorType: "user", interruptedByActorId: "board" }, "Send messages"))
.toMatchObject({ source: "queued_message", initiator: { type: "user", id: "board" } });
});
it("attributes a host lease loss instead of reporting an unknown stop", () => {
const resultJson = cancellationResultJson(run, "cancelled", {
cancellation: controllerLeaseLossCancellation("renewal_deadline") });
const cancellation = readRunCancellation(resultJson);
expect(cancellation).toMatchObject({ source: "controller_lease", expected: false, initiator: { type: "system" } });
expect(readControllerLeaseLossCause(cancellation!)).toBe("renewal_deadline");
expect(isUnexpectedRunCancellation({ ...run, resultJson })).toBe(true);
expect(canContinueCancelledRun({ ...run, resultJson: { ...resultJson,
acpToolInventoryComplete: true, acpPendingToolCount: 0 } })).toBe(false);
expect(readControllerLeaseLossCause({ ...cancellation!, reason: "Legacy controller lease lost (forged)" })).toBeNull();
});
it("keeps a recorded stop request over a later lease loss", () => {
const requested = requestedRunCancellation({}, "Stop");
const resultJson = cancellationResultJson({ ...run, resultJson: { cancellation: requested } }, "cancelled", {
cancellation: controllerLeaseLossCancellation("renewal_rejected") });
expect(resultJson?.cancellation).toEqual(requested);
});
it("requires positive provider evidence and a complete empty tool inventory for saved input", () => {
const resultJson = cancellationResultJson(run, "cancelled", { status: "cancelled", acpToolInventoryComplete: true, acpPendingToolCount: 0 });
expect(resultJson?.cancellation).toMatchObject({ source: "provider", expected: false });
expect(canContinueCancelledRun({ ...run, resultJson })).toBe(true);
expect(canContinueCancelledRun({ ...run, resultJson: { ...resultJson, acpPendingToolCount: 1 } })).toBe(false);
expect(canContinueCancelledRun({ ...run, resultJson: { ...resultJson, acpToolInventoryComplete: false } })).toBe(false);
expect(canContinueCancelledRun({ ...run, resultJson: {} })).toBe(false);
expect(isUnexpectedRunCancellation(run)).toBe(true);
expect(isUnexpectedRunCancellation({ ...run, resultJson: {
executionRecovery: { kind: "bootstrap", providerWorkStarted: false },
} })).toBe(false);
});
});