Function runStatelessForce

Executes a message statelessly with the active agent in a swarm session, bypassing chat history and forcing execution regardless of agent activity.

This function processes a command or message using the active agent without appending it to the chat history, designed to prevent model history overflow when handling storage output or one-off tasks. Unlike runStateless, it does not check if the agent is currently active, ensuring execution even if the agent has changed or is inactive. It validates the session and swarm, executes the content with performance tracking and event bus notifications, and is wrapped in beginContext for a clean environment and ExecutionContextService for metadata tracking.

Throws

If session or swarm validation fails, or if the execution process encounters an error.

Example

const result = await runStatelessForce("Process this data forcefully", "client-123");
console.log(result); // Outputs the agent's response without affecting history
  • runStatelessForce(content: string, clientId: string): Promise<string>

    Parameters

    • content: string

      The content or command to be executed statelessly by the active agent.

    • clientId: string

      The unique identifier of the client session requesting the execution.

    Returns Promise<string>

    A promise that resolves to the result of the execution.

Settings

Member Visibility