Skip to content

Link an OpenAPI description as a resource in a directory listing - #1335

Merged
jviotti merged 1 commit into
mainfrom
openapi-titles
Nov 20, 2026
Merged

jviotti merged 1 commit into
mainfrom
openapi-titles

Conversation

@jviotti

@jviotti jviotti commented Nov 20, 2026 •

Copy link
Copy Markdown
Member

Signed-off-by: Juan Cruz Viotti jv@jviotti.com

View guided diff

Signed-off-by: Juan Cruz Viotti <jv@jviotti.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 8 files

View guided diff | Re-trigger cubic

@augmentcode

augmentcode Bot commented Nov 20, 2026

Copy link
Copy Markdown
🤖 Augment PR Summary

Summary: Makes OpenAPI descriptions discoverable as resources in MCP directory listings.

  • Includes OpenAPI entries alongside existing JSON Schema resource links.
  • Advertises OpenAPI descriptions as application/openapi+json.
  • Preserves application/schema+json for schema links.
  • Uses entry identifiers as resource URIs.
  • Retains titles, path-based fallback names, and optional descriptions.
  • Continues skipping unsupported entry kinds and entries without identifiers.
  • Expands listing assertions for MCP 2025-11-25 and 2026-07-28.
  • Enriches fixtures to cover summary precedence, description fallback, and absent descriptions.
  • Updates expected resource payloads and metadata byte counts for those fixtures.

🤖 Was this summary useful? React with 👍 or 👎

@augmentcode augmentcode Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. No suggestions at this time.

Comment augment review to trigger a new review at any time.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Benchmark (community)

Details
Benchmark suite Current: 8545533 Previous: f24e0c6 Ratio
Add one schema (0 existing) 327 ms 189 ms 1.73
Add one schema (100 existing) 52 ms 40 ms 1.30
Add one schema (1000 existing) 91 ms 90 ms 1.01
Add one schema (10000 existing) 667 ms 756 ms 0.88
Update one schema (1 existing) 41 ms 29 ms 1.41
Update one schema (101 existing) 45 ms 35 ms 1.29
Update one schema (1001 existing) 91 ms 78 ms 1.17
Update one schema (10001 existing) 661 ms 714 ms 0.93
Cached rebuild (1 existing) 13 ms 11 ms 1.18
Cached rebuild (101 existing) 17 ms 14 ms 1.21
Cached rebuild (1001 existing) 40 ms 41 ms 0.98
Cached rebuild (10001 existing) 291 ms 268 ms 1.09
Index 100 schemas 391 ms 344 ms 1.14
Index 1000 schemas 1308 ms 1042 ms 1.26
Index 10000 schemas 12627 ms 10555 ms 1.20
Index 10000 schemas (custom meta-schema) 16203 ms 12052 ms 1.34
Index 10000 schemas ($ref fan-out) 14604 ms 11235 ms 1.30
test/e2e/html: Schema Fetch (p50) 392 us 235 us 1.67
test/e2e/html: Schema Fetch (p99) 470 us 298 us 1.58

This comment was automatically generated by workflow using github-action-benchmark.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Benchmark (enterprise)

Details
Benchmark suite Current: 8545533 Previous: f24e0c6 Ratio
Add one schema (0 existing) 563 ms 570 ms 0.99
Add one schema (100 existing) 128 ms 138 ms 0.93
Add one schema (1000 existing) 191 ms 191 ms 1
Add one schema (10000 existing) 866 ms 884 ms 0.98
Update one schema (1 existing) 124 ms 121 ms 1.02
Update one schema (101 existing) 136 ms 136 ms 1
Update one schema (1001 existing) 190 ms 197 ms 0.96
Update one schema (10001 existing) 914 ms 924 ms 0.99
Cached rebuild (1 existing) 16 ms 16 ms 1
Cached rebuild (101 existing) 18 ms 23 ms 0.78
Cached rebuild (1001 existing) 48 ms 51 ms 0.94
Cached rebuild (10001 existing) 358 ms 363 ms 0.99
Index 100 schemas 856 ms 757 ms 1.13
Index 1000 schemas 2032 ms 2035 ms 1.00
Index 10000 schemas 16220 ms 16653 ms 0.97
Index 10000 schemas (custom meta-schema) 17156 ms 16279 ms 1.05
Index 10000 schemas ($ref fan-out) 21409 ms 21744 ms 0.98
enterprise/e2e/auth: Schema Anonymous (p50) 376 us 378 us 0.99
enterprise/e2e/auth: Schema Anonymous (p99) 484 us 477 us 1.01
enterprise/e2e/auth: Schema API Key Identity (p50) 380 us 383 us 0.99
enterprise/e2e/auth: Schema API Key Identity (p99) 505 us 487 us 1.04
enterprise/e2e/auth: Schema API Key SHA256 (p50) 389 us 392 us 0.99
enterprise/e2e/auth: Schema API Key SHA256 (p99) 502 us 503 us 1.00
enterprise/e2e/auth: Schema JWT (p50) 532 us 533 us 1.00
enterprise/e2e/auth: Schema JWT (p99) 673 us 668 us 1.01
test/e2e/html: Schema Fetch (p50) 383 us 389 us 0.98
test/e2e/html: Schema Fetch (p99) 476 us 479 us 0.99

This comment was automatically generated by workflow using github-action-benchmark.

@jviotti
jviotti merged commit 4735f13 into main Nov 20, 2026
6 checks passed
@jviotti
jviotti deleted the openapi-titles branch November 20, 2026 15:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant