Function complete

Executes a single command in a swarm session and disposes of it, optimized for developer troubleshooting.

This function creates a temporary swarm session, executes a provided command, and disposes of the session upon completion. It is designed for developer needs, such as testing tool execution or troubleshooting, with performance tracking and event bus notifications. The execution is wrapped in beginContext for a clean environment and runs within an ExecutionContextService context for metadata tracking. The operation is TTL-limited and queued to manage resource usage efficiently.

Throws

If swarm or session validation fails, execution encounters an error, or disposal fails.

Example

const result = await complete("Calculate 2 + 2", "client-123", "MathSwarm");
console.log(result); // Outputs "4"
  • complete<Payload extends object = object>(
        content: string,
        clientId: string,
        swarmName: string,
        payload?: Payload,
    ): Promise<string>

    Type Parameters

    • Payload extends object = object

    Parameters

    • content: string

      The content or command to process in the swarm session.

    • clientId: string

      The unique identifier of the client session.

    • swarmName: string

      The name of the swarm in which the command is executed.

    • Optionalpayload: Payload

    Returns Promise<string>

    A promise that resolves to the result of the command execution.

Settings

Member Visibility