bluecollar

AgentTurnRequest

Everything the harness refuses to assume about a turn.

fieldcarries
RequesterPersonID, RequesterName, RequesterCallingName, RequesterHandle, RequesterCircleswho is asking
AgentIdentitythe name and handle the agent answers to
Prompt, InputPartsthe message and its attachments
ResponseLanguagethe language of every reply, as a code or an English name from toolcontract.ResponseLanguages; empty lets intake read it from the message
ConversationID, ConversationType, VisibleContextwhere it was said and what surrounds it
MemoryFactswhat the host recalled for this requester
ToolSet, PinnedToolNames, LikelyToolNames, AvailableSkillswhat the agent may call and read
WorkspaceRootPath, WorkspaceDefaultPath, ActivePathswhere files live
ActiveGoal, PriorTask, ScheduledRun, CarriedOutCallswork already in flight or on record
PrecomputedTurnDecisionthe host's routing decision, required
TurnStartedAt, ExecutionStartedAt, EnvironmentNowthe clocks
CheckpointSenderwhere progress updates go

ExecutionStartedAt lets a host start the execution budget after its own routing phase while the caller's deadline still caps the run. AgentTurnResult returns the task run and its status, the finish message or user notice, attachments and recovery actions.