• Emits a string as model output without executing an incoming message, with agent activity validation.

    This function directly emits a provided string as output from the swarm session, bypassing message execution, and is designed exclusively for sessions established via makeConnection. It validates the session, swarm, and specified agent, ensuring the agent is still active before emitting. If the active agent has changed, the operation is skipped. The execution is wrapped in beginContext for a clean environment, logs the operation if enabled, and throws an error if the session mode is not "makeConnection".

    Parameters

    • content: string

      The content to be processed or stored.

    • clientId: string

      The unique identifier of the client session.

    • agentName: string

      The name of the agent to use or reference.

    Returns Promise<void>

    If the session mode is not "makeConnection", or if agent, session, or swarm validation fails.

    await emit("Direct output", "client-123", "AgentX"); // Emits "Direct output" if AgentX is active