

| Parameter | Type | Description |
|---|---|---|
goals | object[] | Structured goals for run_goals. Freeform player objectives should be translated by the caller before invoking this tool. |
itemId | string | |
command | string | |
profile | object | Fields: risk, role, spec, social, priority, partyMode |
questId | string | |
stopWhen | string | |
commandId | string | |
operation* | string | |
controller | object | Metadata only. Custom code runs in the caller-owned agent harness, not on the hosted server.Fields: type, policyRef, policyHash |
maxSeconds | number | |
constraints | object | Fields: maxDeaths, noPaidActions, allowedActions, maxSafetyStops, noWalletActions, disallowedActions |
targetCount | number | |
behaviorScheme | string | |
bridgeSessionId* | string |
| Parameter | Type | Description |
|---|---|---|
ok* | boolean | |
goals | object[] | |
usage | object | |
bridge | object | |
budget | object | |
combat | object | |
errors | string[] | |
result | object | |
social | object | |
status* | string | |
command | string | |
fishing | object | |
profile | object | |
sandbox | object | |
summary | string | |
stopWhen | string | |
commandId | string | |
startedAt | string | |
stopDrain | object | Present after a command stop is requested. settled or not_needed means the returned terminal recap has reconciled any in-flight action. settling means the command is still running and must be polled with a fresh nonce. timed_out is incomplete but recoverable: retain the bridge and poll the same command with another fresh nonce. |
controller | object | |
durationMs | number | |
finalState | object | |
finishedAt | string | |
maxSeconds | number | |
constraints | object | |
postCommand | object | |
goalProgress | object[] | |
questChanges | object[] | |
actionReports | object[] | |
behaviorScheme | string | |
stoppedBecause | string | |
bridgeSessionId | string | |
equipmentChanges | object[] | |
inventoryChanges | object[] | |
lastActionReport | object | |
usageFinalization | object | Command-budget reservation settlement. failed_or_unknown is terminal and is not retried automatically because aggregate usage finalization is not safely idempotent. |
prerequisiteRequired | object | |
walletActionRequired | object |