feat: expose teamsctl as a public Go SDK

[TheSinding]

Moves the Teams client out of internal/ into pkg/ (teamsauth + teamsctl) so other Go projects can import it, and exports the service API (ResolveConversationTarget, FindOneOnOneConversation, Me/Identity, Message/SendOptions, etc.). CLI and MCP wiring stay internal and consume the pkg packages.

Also fixes the blank message author for the signed-in user: Teams leaves imDisplayName empty on your own messages, so Messages now substitutes the account's display name when the sender MRI matches (directly, or derived from objectId) and exposes sender_id.

Verified: go build, go vet clean; go test = 35 passed / 5 packages.

[Copilot]

Pull request overview

Exposes teamsctl as a public Go SDK by moving the Teams auth/client logic into pkg/teamsauth + pkg/teamsctl, while keeping CLI/MCP wiring internal. It also improves message author attribution by backfilling the signed-in user’s display name when Teams omits it and adds sender_id to message records.

Changes:

• Introduces public SDK surface in pkg/teamsctl (conversations resolution, sending, identity, message author backfill).
• Introduces pkg/teamsauth for token storage (keyring + file fallback) and OAuth automation helpers.
• Rewires internal CLI and MCP server to consume the new pkg/* packages.

Reviewed changes

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

Show a summary per file

File	Description
pkg/teamsctl/service.go	Updates auth import path and adds cached best-effort currentUser() helper.
pkg/teamsctl/service_test.go	Adds a test ensuring NewService passes keyring tokens to the Teams API client constructor.
pkg/teamsctl/send.go	Adds public Service.Send plus mention resolution and message formatting utilities.
pkg/teamsctl/send_test.go	Adds tests for formatting and mention substitution helpers.
pkg/teamsctl/resolve.go	Adds public recipient phrase resolution (ResolveConversationTarget, one-on-one/group lookup helpers).
pkg/teamsctl/resolve_test.go	Updates tests to reflect refactor/moves of helper functions.
pkg/teamsctl/models.go	Extends Message model with SenderID.
pkg/teamsctl/messages.go	Backfills self-message author name and exposes SenderID; factors mapping into messageRecords.
pkg/teamsctl/messages_test.go	Adds tests for self-sender detection and author backfill behavior.
pkg/teamsctl/identity.go	Adds public Me() identity accessor that returns a stable SDK Identity type.
pkg/teamsctl/conversations.go	Adds conversation discovery/filtering, caching/enrichment, and shared ID utilities.
pkg/teamsctl/conversations_test.go	Adds test asserting one-on-one chats are preferred in filtering.
pkg/teamsauth/tokens.go	Adds token validation/loading and keyring-first storage with file fallback.
pkg/teamsauth/tokens_test.go	Adds tests for expiry validation, config dir resolution, keyring/file fallback behavior, and CheckTokens.
pkg/teamsauth/oauth.go	Adds OAuth URL building + callback parsing and tenant discovery helper.
pkg/teamsauth/oauth_test.go	Adds tests for auth URL formation and callback parsing behaviors.
pkg/teamsauth/models.go	Adds options and internal auth model types (claims, tenants, token kinds).
pkg/teamsauth/command.go	Adds an auth subcommand runner for internal CLI to call into the auth workflow.
pkg/teamsauth/browser.go	Implements the Chrome/chromedp-based multi-token auth flow and Chrome path resolution.
pkg/teamsauth/browser_test.go	Adds tests for resolving direct executables vs macOS app bundles.
pkg/teamsauth/autofill.go	Adds best-effort login form autofill loop for chromedp-based auth.
internal/teamsctl/mcp.go	Switches MCP server implementation to use the new pkg/teamsctl SDK APIs/types.
internal/teamsctl/cli.go	Switches internal CLI to use pkg/teamsauth and pkg/teamsctl instead of internal client/auth.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.