runner: allow custom CLI arguments

[aconchillo]

Summary

• main() now accepts an optional argparse.ArgumentParser, allowing bots to define custom CLI arguments that are accessible via runner_args.cli_args
• Added cli_args field to RunnerArguments so all runner argument types carry parsed CLI args
• Refactored internal route setup functions to pass args: Namespace instead of unpacking individual keyword arguments
• Updated 18-gstreamer-filesrc.py example to use the new custom parser pattern

Example

async def bot(runner_args: RunnerArguments):
    input_file = runner_args.cli_args.input
    ...

if __name__ == "__main__":
    from pipecat.runner.run import main

    parser = argparse.ArgumentParser()
    parser.add_argument("-i", "--input", required=True)
    main(parser)

[codecov]

Codecov Report

❌ Patch coverage is 0% with 40 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/pipecat/runner/run.py	0.00%	38 Missing ⚠️
src/pipecat/runner/types.py	0.00%	2 Missing ⚠️

Files with missing lines	Coverage Δ
src/pipecat/runner/types.py	0.00% <0.00%> (ø)
src/pipecat/runner/run.py	0.00% <0.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[markbackman]

LGTM