Skip to content

[AI-6021] Add Angie tool annotations to public SDK#25

Merged
ozgal05 merged 8 commits intomasterfrom
AI-6021
Mar 8, 2026
Merged

[AI-6021] Add Angie tool annotations to public SDK#25
ozgal05 merged 8 commits intomasterfrom
AI-6021

Conversation

@ozgal05
Copy link
Copy Markdown
Contributor

@ozgal05 ozgal05 commented Mar 8, 2026

Summary

  • Add src/angie-annotations.ts exporting four constants (ANGIE_REQUIRED_RESOURCES, ANGIE_MODEL_PREFERENCES, ANGIE_EXTENDED_TIMEOUT, MCP_READONLY) and three TypeScript interfaces (AngieRequiredResource, AngieModelPreferences, AngieExtendedTimeout)
  • Export annotations from src/index.ts so they are part of the public @elementor/angie-sdk package
  • Replace docs/model-preferences.md with docs/tool-annotations.md covering all four annotations with schemas, examples, and a combined usage example
  • Add src/angie-annotations.test.ts with 4 unit tests verifying each constant value

Test plan

  • npm test — all 117 tests pass across 13 suites
  • npm run build — compiles without errors, dist/angie-annotations.d.ts and updated dist/index.d.ts are emitted

🤖 Generated with Claude Code

✨ PR Description

Purpose: Add Angie-specific tool annotation constants and TypeScript interfaces to the public SDK for configuring MCP tool metadata like resource dependencies and model preferences.

Main changes:

  • Created angie-annotations.ts module exporting four annotation constants (ANGIE_REQUIRED_RESOURCES, ANGIE_MODEL_PREFERENCES, ANGIE_EXTENDED_TIMEOUT, MCP_READONLY) with TypeScript interfaces
  • Added comprehensive tool-annotations.md documentation with usage examples and annotation reference replacing previous model-preferences.md documentation
  • Exported ToolAnnotations type from MCP SDK and re-exported angie-annotations module through main index.ts

Generated by LinearB AI and added by gitStream.
AI-generated content may contain inaccuracies. Please verify before using.
💡 Tip: You can customize your AI Description using Guidelines Learn how

ozgal05 and others added 4 commits March 8, 2026 12:53
Export ANGIE_REQUIRED_RESOURCES, ANGIE_MODEL_PREFERENCES, ANGIE_EXTENDED_TIMEOUT,
MCP_READONLY constants and AngieRequiredResource, AngieModelPreferences,
AngieExtendedTimeout interfaces so third-party MCP server developers can annotate
their tools with Angie-specific metadata.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…tions.md

Covers all four Angie tool annotations (requiredResources, modelPreferences,
extendedTimeout, readOnlyHint) with schemas, examples, and a combined usage example.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ozgal05 ozgal05 marked this pull request as draft March 8, 2026 12:15
@ozgal05 ozgal05 marked this pull request as ready for review March 8, 2026 12:15
- Fix broken link to deleted model-preferences.md → tool-annotations.md
- Add Tool Annotations section to README with import/usage example
- Update angie-sdk-supported-features.md to use SDK constants and correct field names

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
ozgal05 and others added 2 commits March 8, 2026 15:59
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Re-export ToolAnnotations from @elementor/angie-sdk and add
`as ToolAnnotations` casts to all annotation objects in docs
to work around strict MCP SDK typing until tools are refactored.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ozgal05 ozgal05 merged commit ba8417a into master Mar 8, 2026
16 checks passed
@ozgal05 ozgal05 deleted the AI-6021 branch March 8, 2026 15:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants