Add workflow statistics to team.start() output

[darielnoel]

Add workflow statistics to team.start() output

This PR addresses issue #62 by incorporating comprehensive workflow statistics directly into the output of the team.start() method, eliminating the need for a separate getWorkflowStats() call.

Changes

• Modified team.start() to return an object that includes:

  • Workflow status ('FINISHED' or 'BLOCKED')
  • Workflow result
  • Detailed statistics about the workflow execution

• Updated the structure of the returned object to:

  {
    status: 'FINISHED' | 'BLOCKED',
    result: workflowResult,
    stats: {
      duration: number,
      taskCount: number,
      agentCount: number,
      iterationCount: number,
      llmUsageStats: {
        inputTokens: number,
        outputTokens: number,
        callsCount: number,
        callsErrorCount: number,
        parsingErrors: number
      },
      costDetails: {
        totalCost: number
      },
      teamName: string
    }
  }

• Updated relevant documentation and examples to reflect the new output structure

Benefits

• Simplifies the process of retrieving workflow statistics
• Ensures consistency between workflow result and associated statistics
• Improves developer experience by providing all necessary information in a single method call
• Facilitates easier implementation of performance monitoring, cost tracking, and debugging features

Testing

• Added unit tests to verify the new output structure of team.start()
• Updated existing tests that relied on the separate getWorkflowStats() method
• Manually tested various workflow scenarios to ensure correct statistics are returned

Documentation

• Updated the API documentation for team.start() to reflect the new return value structure
• Added examples demonstrating how to access and use the new statistics in the output

Please review and let me know if any further changes or clarifications are needed.