Skip to main content
defineAgentHarnessPortsContract(label, factory): void
Register the executable v2 ports contract against an adapter factory. Runtime and plain-Node adapters call this same function; adapter-specific tests may add stricter checks, but may not weaken these shared semantics. Parameters Returns void

​
AgentHarnessPortsContractFixture

A fresh adapter fixture consumed by the shared ports contract suite. Properties delivery
delivery: object
Test-host control for exercising current due-task delivery and retry. advanceBy()
advanceBy(milliseconds): void
Parameters Returns void calls()
calls(): readonly string[]
Returns readonly string[] drainDue()
drainDue(): Promise<number>
Returns Promise<number> failNext()
failNext(count?): void
Parameters Returns void selfCancelAndThrow()
selfCancelAndThrow(): Promise<number>
Exercise a task handler that cancels its own recurring id, then throws. Returns Promise<number> selfReplaceAndThrow()
selfReplaceAndThrow(): Promise<number>
Exercise a task handler that re-arms its own id, then throws. Returns Promise<number> ports
ports: AgentHarnessPorts<TestState>
Adapter under test. stateHook
stateHook: object
Test-host control for exercising post-commit state-hook failures. calls()
calls(): readonly Readonly<{ next: TestState; prev: TestState; }>[]
Returns readonly Readonly<{ next: TestState; prev: TestState; }>[] failNext()
failNext(count?): void
Parameters Returns void Methods close()
close(): void | Promise<void>
Release fixture-owned resources. Returns void | Promise<void> reopen()
reopen(): AgentHarnessPorts<TestState> | Promise<AgentHarnessPorts<TestState>>
Reconstruct an adapter over the same persistent backing. Returns AgentHarnessPorts<TestState> | Promise<AgentHarnessPorts<TestState>> rewrapLive()
rewrapLive(): AgentHarnessPorts<TestState>
Construct a distinct wrapper for the current live activation. Returns AgentHarnessPorts<TestState>

​
AgentHarnessPortsContractFactory

AgentHarnessPortsContractFactory = () => Promise<AgentHarnessPortsContractFixture> | AgentHarnessPortsContractFixture
Factory used by defineAgentHarnessPortsContract. Returns Promise<AgentHarnessPortsContractFixture> | AgentHarnessPortsContractFixture