Add Agent 365 agentLifecycle event support

[heyitsaamir]

Summary

• Add typed Agent 365 agentLifecycle event activity models and value payloads for the observed lifecycle variants.
• Wire agentLifecycle into EventActivity parsing via nested discriminators (name then valueType).
• Add app routing/handler registration for on_agent_lifecycle and per-variant on_agentic_user_* handlers.
• Add lifecycle logging handlers to examples/agent365 as a runnable validation/reference harness.
• Sync uv.lock so the existing examples/formatted-messaging workspace member is represented in the lockfile.
• Add API parsing tests and app route-selector tests.

Manual validation

Validated against live Agent 365 lifecycle traffic using examples/agent365 on port 4000 with handlers registered for both the general lifecycle event and each variant-specific lifecycle event.

Scenario	Event / valueType	Result
Create agentic user	AgenticUserIdentityCreated	General + variant handlers fired; creation manager shape included userId, email, and displayName.
Identity property update	AgenticUserIdentityUpdated	Observed Mail, Alias, and UserPrincipalName updates with versions.
Enable agentic user	AgenticUserEnabled	Observed after unblocking the agentic user.
Disable agentic user	AgenticUserDisabled	Observed after blocking the agentic user.
Primary manager change	AgenticUserManagerUpdated	Observed after updating the primary Entra manager via Graph; manager payload shape was manager.managerId.
Teams workload onboarding	AgenticUserWorkloadOnboardingUpdated	Observed with workloadName=Teams and workloadOnboardingState=succeeded.
Soft delete	AgenticUserDeleted	Observed after Graph soft delete.
Restore from deleted items	AgenticUserUndeleted	Observed after Graph restore.
Hard delete	AgenticUserDeleted	Observed after permanent delete.

Additional live-test findings:

• Lifecycle activities arrived as type="event", name="agentLifecycle", channelId="agents", and from.id="system".
• Activity-level valueType matched the concrete lifecycle variant and value.eventType matched the lower-camel event name.
• General lifecycle handlers must call await ctx.next() for variant-specific handlers to run afterward.
• Both soft delete and hard delete emitted AgenticUserDeleted; live payloads did not include a populated deletion reason, so the model keeps it optional.
• Additional managers/sponsors did not trigger AgenticUserManagerUpdated; updating the primary Entra manager did.
• Normal message handling still worked while lifecycle handlers were registered; incoming message POST returned 200 OK and Bot API reply returned 201 Created.

Validation

• ruff check
• pyright
• pytest packages

[Copilot]

Pull request overview

Adds first-class Agent 365 agentLifecycle support across the SDK: typed event activities/value payloads, nested discriminator parsing (name → valueType), app routing/handler registration, and runnable example logging—plus corresponding unit tests and lockfile sync for an existing example workspace member.

Changes:

• Introduces agentLifecycle event activity/value models and exports them through the API activity unions.
• Adds Apps routing selectors + generated handler registration methods for on_agent_lifecycle and per-variant on_agentic_user_* handlers, with route-selector tests.
• Updates examples/agent365 to log lifecycle traffic for live validation; updates uv.lock to include examples/formatted-messaging.

Reviewed changes

Copilot reviewed 9 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
uv.lock	Adds formatted-messaging workspace member package metadata to the lockfile.
packages/apps/tests/test_agent_lifecycle_routes.py	New tests asserting general + per-variant route selectors behave correctly.
packages/apps/src/microsoft_teams/apps/routing/generated_handlers.py	Adds handler registration methods and type imports for lifecycle events.
packages/apps/src/microsoft_teams/apps/routing/activity_route_configs.py	Adds lifecycle route configs and selectors (agentLifecycle + per-valueType variants).
packages/api/tests/unit/test_agent_lifecycle_event.py	New parsing/serialization unit tests for lifecycle event variants.
packages/api/src/microsoft_teams/api/activities/event/agent_lifecycle/value.py	Adds typed value payload models for observed lifecycle variants.
packages/api/src/microsoft_teams/api/activities/event/agent_lifecycle/activity.py	Adds typed activity models + valueType-discriminated union.
packages/api/src/microsoft_teams/api/activities/event/agent_lifecycle/init.py	Exports lifecycle activities/values from the new module.
packages/api/src/microsoft_teams/api/activities/event/init.py	Wires lifecycle into EventActivity parsing via name discriminator and exports symbols.
examples/agent365/src/main.py	Adds lifecycle handlers and logging as a runnable validation harness.