query · world.actor

Actor job choices

Pages one Actor's retained current job alternatives and complete personal scoring evidence.

world.actor.job-choices(filters?, cursor?, page_size?) -> query-page

Stable ID: world.actor.job-choices
Owner: game.actor-runtime
Authority: read_only
Timing: immediate
Availability: active-session
Side effects: none
Determinism: stable owner order at the current committed tick
Introduced: 1.19.0

Usage

Query one actor_id to inspect the Actor-owned alternatives from the latest autonomous job evaluation. Read the selected alternative, hard rejections, and every personal and settlement scoring contribution without changing the choice.

Parameters

filters.actor_id: required stable Actor identity.
cursor: optional continuation cursor.
page_size: bounded alternative-row limit.

Returns

Detached alternative rows with the choice revision, policy version, evaluation tick, outcome, selected job, Work source and demand identities, rejection, twelve scoring inputs, final score, and selected marker.

Cost

One indexed Actor lookup and one bounded visit per retained alternative.

Fields

ID	Type	Units	Required	Description
`actor_id`	`stable-id`	none	yes	Actor identity.
`capability_fit`	`unsigned-integer`	basis-points	yes	Actor capability fit.
`choice_revision`	`revision`	none	yes	Actor-owned choice ledger revision.
`commitment_fit`	`unsigned-integer`	basis-points	yes	Current commitment fit.
`condition_readiness`	`unsigned-integer`	basis-points	yes	Actor condition readiness.
`danger_fit`	`unsigned-integer`	basis-points	yes	Route danger fit to personal tolerance.
`demand_id`	`stable-id`	none	yes	Alternative demand identity.
`evaluated_at_tick`	`unsigned-integer`	ticks	yes	Choice evaluation tick.
`household_obligation`	`unsigned-integer`	basis-points	yes	Household obligation fit.
`job_id`	`stable-id`	none	yes	Alternative job identity.
`learned_preference`	`unsigned-integer`	basis-points	yes	Learned vocation preference.
`outcome`	`enumeration`	none	yes	Overall job-choice outcome.
`player_priority`	`unsigned-integer`	basis-points	yes	Player-authored priority.
`recent_work_fit`	`unsigned-integer`	basis-points	yes	Recent-work variety fit.
`rejection`	`enumeration`	none	yes	Hard rejection reason or none.
`resource_readiness`	`unsigned-integer`	basis-points	yes	Required resource readiness.
`route_cost`	`unsigned-integer`	ticks	yes	World route cost.
`routine_fit`	`unsigned-integer`	basis-points	yes	Current routine fit.
`score`	`unsigned-integer`	basis-points	yes	Final authored-policy score.
`selected`	`boolean`	none	yes	Whether this alternative was selected.
`selected_job_id`	`stable-id-or-null`	none	no	Selected job identity.
`source_id`	`stable-id`	none	yes	Work source identity.
`source_kind`	`enumeration`	none	yes	Work source kind.
`tuning_version`	`unsigned-integer`	none	yes	Authored scoring policy version.
`urgency`	`unsigned-integer`	basis-points	yes	Settlement urgency contribution input.

Errors

Examples

local choices = world.query("world.actor.job-choices", {page_size = 16, filters = {actor_id = selected_id}})
if choices.status == "completed" then
    for _, choice in ipairs(choices.records) do
        if choice.selected then
            ui.text("Chosen work", choice.source_kind)
        end
    end
end

API history

1.19.0: Actor-owned personal job alternatives and complete scoring evidence added for Phase 19Q4B2.