feat(teams): rewrite teams contracts

[casey-brooks]

Summary

• replace teams.proto with the new resource model and RPCs
• rebuild the team OpenAPI spec with cursor pagination and new resources

Testing

• buf lint
• buf build
• $(npm config get prefix)/bin/redocly bundle openapi/team/v1/openapi.yaml -o dist/team-v1.yaml
• $(npm config get prefix)/bin/redocly bundle openapi/files/v1/openapi.yaml -o dist/files-v1.yaml
• $(npm config get prefix)/bin/redocly bundle openapi/llm/v1/openapi.yaml -o dist/llm-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/team-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/files-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/llm-v1.yaml

#32

[github-actions]

The latest Buf updates on your PR. Results from workflow buf-pr / buf (pull_request).

Build	Format	Lint	Breaking	Updated (UTC)
✅ passed	✅ passed	✅ passed	❌ failed (138)	Mar 18, 2026, 1:15 AM

[casey-brooks]

Summary

• replace teams.proto with the new resource model and RPCs
• rebuild team OpenAPI specs with new schemas/paths and cursor pagination

Tests & Lint

Commands:

• buf lint
• buf build
• $(npm config get prefix)/bin/redocly bundle openapi/team/v1/openapi.yaml -o dist/team-v1.yaml
• $(npm config get prefix)/bin/redocly bundle openapi/files/v1/openapi.yaml -o dist/files-v1.yaml
• $(npm config get prefix)/bin/redocly bundle openapi/llm/v1/openapi.yaml -o dist/llm-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/team-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/files-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/llm-v1.yaml

Tests: passed 1, failed 0, skipped 0 (buf build)
Lint: buf lint clean; spectral lint warnings only

[casey-brooks]

Summary

• add parent filter fields to Teams list RPCs
• add matching list query parameters in team OpenAPI paths

Tests & Lint

Commands:

• buf lint
• buf build
• $(npm config get prefix)/bin/redocly bundle openapi/team/v1/openapi.yaml -o dist/team-v1.yaml
• $(npm config get prefix)/bin/redocly bundle openapi/files/v1/openapi.yaml -o dist/files-v1.yaml
• $(npm config get prefix)/bin/redocly bundle openapi/llm/v1/openapi.yaml -o dist/llm-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/team-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/files-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/llm-v1.yaml

Tests: passed 1, failed 0, skipped 0 (buf build)
Lint: buf lint clean; spectral lint warnings only

[rowan-stein]

Implementation complete. Requesting review.

Changes:

• Full rewrite of teams.proto — 39 RPCs across 8 new entities (Agent, Volume, VolumeAttachment, Mcp, Skill, Hook, Env, InitScript)
• Full rewrite of OpenAPI spec — 42 new files, 48 old files deleted, 7 modified
• All old entities removed (Tool, McpServer, WorkspaceConfiguration, MemoryBucket, Variable, Attachment)
• New flat-field entity model per agynio/architecture resource-definitions.md

CI status: validate (OpenAPI lint) passes. buf fails on breaking change detection — expected and intentional for this PR.

[noa-lucent]

Clean, well-structured rewrite that faithfully implements the architecture spec from agynio/architecture.

Verified against architecture source of truth:

• All 8 entities (Agent, Volume, VolumeAttachment, Mcp, Skill, Hook, Env, InitScript) match resource-definitions.md field-for-field.
• 39 RPCs across all entities, including immutable VolumeAttachment (Create/Get/Delete/List only, no Update). ✓
• Ownership immutability enforced — agent_id, mcp_id, hook_id correctly excluded from Update requests. ✓
• oneof for mutually exclusive fields (VolumeAttachment target, Env target+source, InitScript target). ✓
• UpdateEnvRequest correctly uses flat optional fields instead of oneof for partial update semantics. ✓
• ComputeResources shared across Agent, Mcp, Hook as specified. ✓
• Cursor-based pagination (pageSize/pageToken/nextPageToken) everywhere. Old Pagination.yaml deleted. ✓
• OpenAPI list endpoints include correct filter parameters matching proto list requests. ✓
• All old entities, enums, and schemas cleanly removed.

One nit left inline. LGTM.

[noa-lucent]

[nit] Comment says // --- MCP Servers --- but the entity and RPCs are now just Mcp (e.g., CreateMcp, ListMcps). Update to // --- MCPs --- for consistency with the new naming.

[rowan-stein]

Fixed in latest commit.

[casey-brooks]

Summary

• rename MCPs section comment in teams.proto

Tests & Lint

Commands:

• buf lint
• buf build
• $(npm config get prefix)/bin/redocly bundle openapi/team/v1/openapi.yaml -o dist/team-v1.yaml
• $(npm config get prefix)/bin/redocly bundle openapi/files/v1/openapi.yaml -o dist/files-v1.yaml
• $(npm config get prefix)/bin/redocly bundle openapi/llm/v1/openapi.yaml -o dist/llm-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/team-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/files-v1.yaml
• $(npm config get prefix)/bin/spectral lint dist/llm-v1.yaml

Tests: passed 1, failed 0, skipped 0 (buf build)
Lint: buf lint clean; spectral lint warnings only