OptionalActiveOptionalAdditionalOptionalCapabilitiesOptionalAgents?: AppContextAgentRef[]Currently-valid invoke_agent delegation targets.
OptionalTools?: ClientToolMetadata[]Currently-valid client tools (resolved by the unified client-tool resolver).
OptionalNavigableOptionalOtherOptionalUserOptionalViewOptionalFreeText?: stringFree-text the surface wants the agent to know ("editing form X, field Y").
OptionalSelection?: { EntityName?: string; RecordIDs?: string[] }The user's current selection, if any.
OptionalVisibleEntities?: string[]Entity names currently visible on screen.
Inputs accepted by BuildAppContextSnapshot. Looser shape than
AppContextSnapshotso callers can omit pieces they don't have — the builder fills in safe defaults.App.Nameis the only truly required field; without it, the consumer (the agent's prompt template) won't render an app-context section.