Class AgentOSOrchestrator

Description

The AgentOSOrchestrator is responsible for unifying the request handling pipeline for AgentOS. It bridges the high-level AgentOSInput from the public API to the internal GMI processing logic. It ensures that user requests are routed to the correct GMI, manages the GMI's turn lifecycle, and handles the complex dance of tool calls and streaming responses.

Constructors

Methods

  • Async

    Initializes the AgentOSOrchestrator with its configuration and dependencies. This method must be called successfully before orchestrating any turns.

    Parameters

    Returns Promise<void>

    A Promise that resolves when initialization is complete.

    Throws

    If any critical dependency is missing or config is invalid.

  • Async

    Orchestrates a full logical turn for a user request. This involves managing GMI interaction, tool calls, and streaming responses. Instead of directly yielding, it uses the StreamingManager to push chunks.

    Parameters

    • input: AgentOSInput

      The comprehensive input for the current turn.

    Returns Promise<string>

    The ID of the stream to which responses will be pushed.

    Throws

    If critical initialization or setup fails.

  • Handles the result of an external tool execution, feeding it back into the relevant GMI instance for continued processing. Delegates to ExternalToolResultHandler.

    Parameters

    • agentOSStreamId: string
    • toolCallId: string
    • toolName: string
    • toolOutput: any
    • isSuccess: boolean
    • Optional errorMessage: string

    Returns Promise<void>

  • Async

    Shuts down the AgentOSOrchestrator. Currently, this mainly involves clearing active stream contexts. Dependencies like GMIManager are assumed to be shut down by AgentOS.

    Returns Promise<void>

    A promise that resolves when shutdown is complete.