Function emit

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".

Throws

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

Example

await emit("Direct output", "client-123", "AgentX"); // Emits "Direct output" if AgentX is active
  • emit(content: string, clientId: string, agentName: string): Promise<void>

    Parameters

    • content: string

      The content to be emitted as the model output.

    • clientId: string

      The unique identifier of the client session emitting the content.

    • agentName: string

      The name of the agent intended to emit the content.

    Returns Promise<void>

    A promise that resolves when the content is emitted, or resolves early if skipped due to an agent change.

Settings

Member Visibility