AICapabilities

• constructor()

  module:ai/aicore/model/aicapabilities~AICapabilities#constructor

• delegate( events ) → EmitterMixinDelegateChain

  inherited

  module:ai/aicore/model/aicapabilities~AICapabilities#delegate

  Delegates selected events to another Emitter. For instance:

  emitterA.delegate( 'eventX' ).to( emitterB );
  emitterA.delegate( 'eventX', 'eventY' ).to( emitterC );
  

  Copy code

  then eventX is delegated (fired by) emitterB and emitterC along with data:

  emitterA.fire( 'eventX', data );
  

  Copy code

  and eventY is delegated (fired by) emitterC along with data:

  emitterA.fire( 'eventY', data );
  

  Copy code

  Parameters

  events : Array<string>

  Event names that will be delegated to another emitter.

  Returns

  EmitterMixinDelegateChain

• fire( eventOrInfo, args ) → GetEventInfo<TEvent>[ 'return' ]

  inherited

  module:ai/aicore/model/aicapabilities~AICapabilities#fire

  Fires an event, executing all callbacks registered for it.

  The first parameter passed to callbacks is an EventInfo object, followed by the optional args provided in the fire() method call.

  Type parameters

  TEvent : extends BaseEvent

  The type describing the event. See BaseEvent.

  Parameters

  eventOrInfo : GetNameOrEventInfo<TEvent>

  The name of the event or EventInfo object if event is delegated.

  args : TEvent[ 'args' ]

  Additional arguments to be passed to the callbacks.

  Returns

  GetEventInfo<TEvent>[ 'return' ]

  By default the method returns undefined. However, the return value can be changed by listeners through modification of the evt.return's property (the event info is the first param of every callback).

• getCapabilitiesConfig() → AICapabilitiesConfig

  module:ai/aicore/model/aicapabilities~AICapabilities#getCapabilitiesConfig

  Returns the current capabilities configuration.

  Returns

  AICapabilitiesConfig

  The current capabilities configuration.

• init() → void

  module:ai/aicore/model/aicapabilities~AICapabilities#init

  Initializes the capabilities.

  Returns

  void

• listenTo( emitter, event, callback, [ options ] ) → void

  inherited

  module:ai/aicore/model/aicapabilities~AICapabilities#listenTo:BASE_EMITTER

  Registers a callback function to be executed when an event is fired in a specific (emitter) object.

  Events can be grouped in namespaces using :. When namespaced event is fired, it additionally fires all callbacks for that namespace.

  // myEmitter.on( ... ) is a shorthand for myEmitter.listenTo( myEmitter, ... ).
  myEmitter.on( 'myGroup', genericCallback );
  myEmitter.on( 'myGroup:myEvent', specificCallback );
  
  // genericCallback is fired.
  myEmitter.fire( 'myGroup' );
  // both genericCallback and specificCallback are fired.
  myEmitter.fire( 'myGroup:myEvent' );
  // genericCallback is fired even though there are no callbacks for "foo".
  myEmitter.fire( 'myGroup:foo' );
  

  Copy code

  An event callback can stop the event and set the return value of the fire method.

  Type parameters

  TEvent : extends BaseEvent

  The type describing the event. See BaseEvent.

  Parameters

  emitter : Emitter

  The object that fires the event.

  event : TEvent[ 'name' ]

  The name of the event.

  callback : GetCallback<TEvent>

  The function to be called on event.

  [ options ] : GetCallbackOptions<TEvent>

  Additional options.

  Returns

  void

• off( event, callback ) → void

  inherited

  module:ai/aicore/model/aicapabilities~AICapabilities#off

  Stops executing the callback on the given event. Shorthand for this.stopListening( this, event, callback ).

  Parameters

  event : string

  The name of the event.

  callback : Function

  The function to stop being called.

  Returns

  void

• on( event, callback, [ options ] ) → void

  inherited

  module:ai/aicore/model/aicapabilities~AICapabilities#on

  Registers a callback function to be executed when an event is fired.

  Shorthand for this.listenTo( this, event, callback, options ) (it makes the emitter listen on itself).

  Type parameters

  TEvent : extends BaseEvent

  The type descibing the event. See BaseEvent.

  Parameters

  event : TEvent[ 'name' ]

  The name of the event.

  callback : GetCallback<TEvent>

  The function to be called on event.

  [ options ] : GetCallbackOptions<TEvent>

  Additional options.

  Returns

  void

• once( event, callback, [ options ] ) → void

  inherited

  module:ai/aicore/model/aicapabilities~AICapabilities#once

  Registers a callback function to be executed on the next time the event is fired only. This is similar to calling on followed by off in the callback.

  Type parameters

  TEvent : extends BaseEvent

  The type descibing the event. See BaseEvent.

  Parameters

  event : TEvent[ 'name' ]

  The name of the event.

  callback : GetCallback<TEvent>

  The function to be called on event.

  [ options ] : GetCallbackOptions<TEvent>

  Additional options.

  Returns

  void

• reset() → void

  module:ai/aicore/model/aicapabilities~AICapabilities#reset

  Resets the capabilities configuration to default state.

  Returns

  void

• setReasoning( isReasoningEnabled ) → void

  module:ai/aicore/model/aicapabilities~AICapabilities#setReasoning

  Sets the reasoning enabled state and fires an event with current state.

  Parameters

  isReasoningEnabled : boolean

  Returns

  void

• setWebSearch( isWebSearchEnabled ) → void

  module:ai/aicore/model/aicapabilities~AICapabilities#setWebSearch

  Sets the web search enabled state and fires an event with current state.

  Parameters

  isWebSearchEnabled : boolean

  Returns

  void

• stopDelegating( [ event ], [ emitter ] ) → void

  inherited

  module:ai/aicore/model/aicapabilities~AICapabilities#stopDelegating

  Stops delegating events. It can be used at different levels:

  • To stop delegating all events.
  • To stop delegating a specific event to all emitters.
  • To stop delegating a specific event to a specific emitter.

  Parameters

  [ event ] : string

  The name of the event to stop delegating. If omitted, stops it all delegations.

  [ emitter ] : Emitter

  (requires event) The object to stop delegating a particular event to. If omitted, stops delegation of event to all emitters.

  Returns

  void

• stopListening( [ emitter ], [ event ], [ callback ] ) → void

  inherited

  module:ai/aicore/model/aicapabilities~AICapabilities#stopListening:BASE_STOP

  Stops listening for events. It can be used at different levels:

  • To stop listening to a specific callback.
  • To stop listening to a specific event.
  • To stop listening to all events fired by a specific object.
  • To stop listening to all events fired by all objects.

  Parameters

  [ emitter ] : Emitter

  The object to stop listening to. If omitted, stops it for all objects.

  [ event ] : string

  (Requires the emitter) The name of the event to stop listening to. If omitted, stops it for all events from emitter.

  [ callback ] : Function

  (Requires the event) The function to be removed from the call list for the given event.

  Returns

  void

• toggleReasoning() → void

  module:ai/aicore/model/aicapabilities~AICapabilities#toggleReasoning

  Toggles the reasoning enabled state.

  Returns

  void

• toggleWebSearch() → void

  module:ai/aicore/model/aicapabilities~AICapabilities#toggleWebSearch

  Toggles the web search enabled state.

  Returns

  void

Static methods

• getCapabilitiesRequestData( config ) → AICapabilitiesRequestData

  static

  module:ai/aicore/model/aicapabilities~AICapabilities.getCapabilitiesRequestData

  Converts a capabilities configuration to the wire-shape consumed by the AI API endpoints.

  Accepts either the simple chat-style config (isWebSearchEnabled / isReasoningEnabled) or the advanced per-call directive (webSearch / reasoning, where reasoning may also be a level string such as 'low' or 'minimal').

  Parameters

  config : AICapabilitiesConfig | AICapabilitiesConfigAdvanced | undefined

  Returns

  AICapabilitiesRequestData