How southworks/agents works
This repository is the Microsoft 365 Agents SDK landing point: it links language-specific SDKs, provides samples and coding-assistant plugins, and includes a tool that synchronizes .NET samples from upstream. The tool’s main workflow is plan → prepare migration context → run a constrained Copilot implementation session → validate the patch → publish a pull request. Its shared policy, Git, state, version, and reporting modules support that workflow. The README documents the SDK’s channel support and AI-provider flexibility; the source excerpts chiefly illuminate the sample-sync tool, so other SDK capabilities are represented at their documented directory level.
Main entry points: cli.ts Sync CLI · plan.ts Migration planner · context.ts Migration context · sync-session.ts Migration session
Components 23
Sample synchronization
- Sync CLI
automation/teams-sample-sync/src/cli.ts - Migration planner
automation/teams-sample-sync/src/plan.ts - Migration context
automation/teams-sample-sync/src/context.ts - Migration session
automation/teams-sample-sync/src/sync-session.ts - Copilot runner
automation/teams-sample-sync/src/agent-runner.ts - Agent tools
automation/teams-sample-sync/src/agent-tools.ts - Sample validator
automation/teams-sample-sync/src/validate.ts - Sync reporting
automation/teams-sample-sync/src/report.ts - PR publisher
automation/teams-sample-sync/src/publish-pr.ts
SDK and samples
- Language SDKs
samples - Agent channels
- SDK examples
samples
Agent plugins
- Coding skills
agent-plugins
Sync foundations
- Policy configuration
automation/teams-sample-sync/src/config.ts - Git evidence
automation/teams-sample-sync/src/git.ts - Scope guard
automation/teams-sample-sync/src/guard.ts - Verified state
automation/teams-sample-sync/src/state.ts - SDK version resolver
automation/teams-sample-sync/src/versions.ts - Handoff contracts
automation/teams-sample-sync/src/types.ts
Other components
- Maintainer
- Upstream samples
- GitHub Copilot SDK
- Pull request
Connections 25
- Maintainer → Sync CLI: runs sync
automation/teams-sample-sync/src/cli.ts - Sync CLI → Migration planner: creates plan
automation/teams-sample-sync/src/cli.ts - Migration planner → SDK version resolver: resolves version
automation/teams-sample-sync/src/plan.ts - Migration planner → Git evidence: compares trees
automation/teams-sample-sync/src/plan.ts - Migration planner → Verified state: reads state
automation/teams-sample-sync/src/plan.ts - Sync CLI → Migration context: builds context
automation/teams-sample-sync/src/cli.ts - Migration context → Git evidence: materializes evidence
automation/teams-sample-sync/src/context.ts - Migration context → Verified state: reads prior state
automation/teams-sample-sync/src/context.ts - Sync CLI → Migration session: runs migration
automation/teams-sample-sync/src/cli.ts - Migration session → Copilot runner: uses session
automation/teams-sample-sync/src/sync-session.ts - Copilot runner → GitHub Copilot SDK: opens SDK session
automation/teams-sample-sync/src/agent-runner.ts - Migration session → Agent tools: requests validation
automation/teams-sample-sync/src/cli.ts - Agent tools → Scope guard: checks boundaries
automation/teams-sample-sync/src/agent-tools.ts - Agent tools → Sample validator: validates sample
automation/teams-sample-sync/src/agent-tools.ts - Sample validator → SDK version resolver: checks versions
automation/teams-sample-sync/src/validate.ts - Sync CLI → Sync reporting: writes report
automation/teams-sample-sync/src/cli.ts - Sync CLI → PR publisher: publishes patch
automation/teams-sample-sync/src/cli.ts - PR publisher → Pull request: opens PR
- Sync CLI → Policy configuration: loads policy
automation/teams-sample-sync/src/cli.ts - Sync CLI → SDK version resolver: resolves SDK
automation/teams-sample-sync/src/cli.ts - Sync CLI → Git evidence: checks changes
automation/teams-sample-sync/src/cli.ts - Language SDKs → Agent channels: deploys agents
README.md - SDK examples → Language SDKs: demonstrate usage
README.md - Coding skills → Language SDKs: guide development
README.md - Upstream samples → Sync CLI: supplies changes