aws-samples / aws-samples/sample-autonomous-cloud-coding-agents
feat(registry): capability descriptors for dynamic environment config
- Ngôn ngữ chính
- TypeScript
- Star
- 143
- Fork
- 46
- Merge trung bình
- 3 ngày 10 giờ
- Pull request đã merge (30 ngày)
- 24
Mô tả
**Context:** ROADMAP.md → Capability descriptors
---
## Component
Agent (Python runtime)
## Describe the feature
Structured **metadata per registry asset** declaring:
**Provides:** tool surface, permissions required, resource limits, Cedar actions introduced.
**Requires:** runtime dependencies, network egress domains, minimum compute profile.
Agent runtime uses descriptors to configure the execution environment dynamically—MCP servers, context injection, sandbox permissions—rather than static blueprint lists. Registry is evaluated by Change Manifest **L1** (`tool_needed` validation) and **L5** (knowledge resolution).
## Use case
Static blueprint lists do not scale as asset types grow. Runtime needs machine-readable requirements to provision MCP servers, context injection, and sandbox permissions.
## Proposed solution
1. JSON Schema for `CapabilityDescriptor` stored alongside asset artifact.
2. Resolver validates descriptor at task start; fails closed on mismatch with compute profile.
3. Gateway + Cedar auto-generate allowlists from descriptor actions.
4. Validator in registry publish path.
5. Golden fixtures in `contracts/` or `cdk/test/`.
## Other information
- Child of #246; pairs with extended tool capability tiers draft.
- Design context: `docs/design/COMPUTE.md`.
- [ ] This might be a breaking change
Hướng dẫn đóng góp
Hướng nghiên cứu
Bắt đầu với ROADMAP.md và docs/design/COMPUTE.md, sau đó kiểm tra đường dẫn publish của registry và các vị trí contracts/ hoặc cdk/test/ được đề cập cho các golden fixture. Công việc được đề xuất bao gồm descriptor schema, task-start resolver, các allowlist của Gateway và Cedar, validation khi publish và các fixture; công việc được xem là hoàn tất khi các thành phần này hỗ trợ cấu hình môi trường động đã được validation.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- json, python
- Lĩnh vực
- backend, devops, security
- Loại issue
- Tính năng
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức độ hoạt động
- Ít trao đổi
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 35/100