Function runStateless

Executes a message statelessly with an agent in a swarm session, bypassing chat history.

This function processes a command or message using the specified agent without appending it to the chat history, designed to prevent model history overflow when handling storage output or one-off tasks. It validates the agent, session, and swarm, checks if the specified agent is still active, and executes the content with performance tracking and event bus notifications. The execution is wrapped in beginContext for a clean environment and ExecutionContextService for metadata tracking. If the active agent has changed, the operation is skipped, returning an empty string.

Throws

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

Example

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

    Parameters

    • content: string

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

    • clientId: string

      The unique identifier of the client session requesting the execution.

    • agentName: string

      The name of the agent intended to execute the command.

    Returns Promise<string>

    A promise that resolves to the result of the execution, or an empty string if skipped due to an agent change.

Settings

Member Visibility