Add bootstrapper for implicit agent entry paths

[toubatbrian]

Summary

• Allow cli.runApp() to accept either a ServerOptions instance or a plain options object.
• Keep new ServerOptions(...) backward compatible while simplifying starter usage to cli.runApp({ agentName: 'my-agent' }).
• Add regression tests for plain-object normalization and preserving existing ServerOptions instances.

// Before
import { ServerOptions, cli, defineAgent } from '@livekit/agents';
import { fileURLToPath } from 'node:url';

export default defineAgent({
  // ...
});

cli.runApp(new ServerOptions({ agent: fileURLToPath(import.meta.url) }));

// After
import { cli, defineAgent } from '@livekit/agents';

export default defineAgent({
  // ...
});

cli.runApp();

Test

• pnpm test -- agents/src/cli/bin.test.ts agents/src/cli/context.test.ts agents/src/worker.test.ts
• pnpm --filter @livekit/agents lint
• pnpm --filter @livekit/agents build
• pnpm run:agent ./examples/src/basic_agent.ts dev --help

[changeset-bot]

🦋 Changeset detected

Latest commit: 5017001

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 31 packages

Name	Type
@livekit/agents	Patch
@livekit/agents-plugin-anam	Patch
@livekit/agents-plugin-assemblyai	Patch
@livekit/agents-plugin-baseten	Patch
@livekit/agents-plugin-bey	Patch
@livekit/agents-plugin-cartesia	Patch
@livekit/agents-plugin-cerebras	Patch
@livekit/agents-plugin-deepgram	Patch
@livekit/agents-plugin-elevenlabs	Patch
@livekit/agents-plugin-fishaudio	Patch
@livekit/agents-plugin-google	Patch
@livekit/agents-plugin-hedra	Patch
@livekit/agents-plugin-hume	Patch
@livekit/agents-plugin-inworld	Patch
@livekit/agents-plugin-lemonslice	Patch
@livekit/agents-plugin-liveavatar	Patch
@livekit/agents-plugin-livekit	Patch
@livekit/agents-plugin-minimax	Patch
@livekit/agents-plugin-mistral	Patch
@livekit/agents-plugin-mistralai	Patch
@livekit/agents-plugin-neuphonic	Patch
@livekit/agents-plugin-openai	Patch
@livekit/agents-plugin-phonic	Patch
@livekit/agents-plugin-resemble	Patch
@livekit/agents-plugin-rime	Patch
@livekit/agents-plugin-runway	Patch
@livekit/agents-plugin-sarvam	Patch
@livekit/agents-plugin-silero	Patch
@livekit/agents-plugins-test	Patch
@livekit/agents-plugin-trugen	Patch
@livekit/agents-plugin-xai	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR