UUID based resources

[domdomegg]

Fixes #475

Also see #2570

[domdomegg]

@claude please summarise the changes made in this PR. Read the discussion in #2570 for more context too.

[claude]

Claude finished @domdomegg's task —— View job

---

Summary

This PR replaces the problematic array index-based resource system with UUID-based semantic paths, resolving issue #475 and implementing the solution proposed in issue #2570.

Changes Made

Core Implementation Changes (everything.ts)

Resource Generation (Lines 260-279):

• Generates 50 UUIDs each for text and blob resources using randomUUID()
• Text resources use URI pattern: test://static/resource/text/{uuid}
• Blob resources use URI pattern: test://static/resource/blob/{uuid}
• Maintains same 100 total resources (50 text, 50 blob) but with unique identifiers

Resource Templates (Lines 318-329):

• Updated templates to reflect new URI patterns with UUID placeholders
• Clear separation between text and blob resource types in paths

Resource Lookups:

• All resource lookups now use find() with URI matching instead of array indexing
• Eliminates confusion between 0-based arrays and 1-based display numbers

Documentation Updates (README.md)

Resource Section (Lines 92-115):

• Updated all examples to show UUID-based URI patterns
• Added clear explanation of semantic paths (/text/ vs /blob/)
• Emphasized benefits: "UUID-based identifiers eliminate index/URI confusion"
• Updated tool and prompt argument descriptions to use resourceUri

Benefits of This Approach

1. Eliminates Index Confusion: No more mismatch between 0-based array indices and 1-based resource names
2. Semantic Clarity: Resource paths now clearly indicate type (text vs blob)
3. Real-world Patterns: UUIDs better represent actual resource identification systems
4. Type Safety: Path structure makes resource type explicit before lookup

Context from Issue #2570

The discussion in #2570 shows this was @domdomegg's suggested solution to avoid the "even/odd" indexing weirdness and provide more intuitive resource identification. @cliffhall agreed it was an excellent approach that "removes any assumptions about array index being meaningful" and "delivers the point that URIs can carry meaning."

Tasks:

• Read changed files to understand implementation
• Read issue fix: align everything server resource URI numbering with array indices #2570 discussion for context
• Provide summary of changes

This is a well-thought-out improvement that makes the everything server's resource system much more intuitive and eliminates a common source of confusion for MCP client developers.

[cliffhall]

Looks good, but what we've lost is the interleaving of the resources types.

Previously, we had Text, Blob, Text, Blob, etc. This interleaving was useful for variety in the getResourceLinks tool:

Could you add interleaving?