Add schema-to-grammar generator with extension support #1854
+125
−13
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Created a VS Code extension that provides comprehensive syntax highlighting
for Action Grammar files used in TypeAgent.
Features:
- Rule definition highlighting (@ <RuleName> = ...)
- Rule reference highlighting (<RuleName>)
- Capture syntax highlighting ($(name:Type) and $(name))
- Action object highlighting with embedded JavaScript syntax (-> { })
- Operator highlighting (|, ?, *, +)
- Comment support (//)
- String literal highlighting
- Bracket matching and auto-closing pairs
- Language configuration for editor features
File structure:
- package.json: Extension manifest with language contributions
- language-configuration.json: Editor behavior configuration
- syntaxes/agr.tmLanguage.json: TextMate grammar definition
- README.md: Installation and usage documentation
- OVERVIEW.md: Technical implementation details
- sample.agr: Sample file demonstrating all syntax features
- LICENSE: MIT license
The extension uses TextMate grammar for syntax highlighting and follows
VS Code extension best practices.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Added required package.json fields: license, author, homepage, repository, private - Sorted package.json fields according to project conventions - Added Trademarks section to README per Microsoft guidelines Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Reordered package.json fields to match project conventions - Added third-party trademarks clause to README Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Used sort-package-json to ensure fields are in the correct order per project standards. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This adds a generator that creates .agr grammar files from TypeAgent action schemas. The generator: 1. Takes a complete action schema as input 2. Identifies the most common actions and generates example requests 3. Uses Claude to generate an efficient grammar with shared sub-rules 4. Validates the grammar and automatically fixes syntax errors 5. Outputs a complete .agr file ready for use in TypeAgent Key features: - Automatically extracts shared patterns across actions (e.g., <Polite>, <DateExpr>) - Handles union types (e.g., CalendarTime | CalendarTimeRange) - Validates generated grammar using the action-grammar compiler - Provides error feedback loop to fix syntax issues - Exports CLI tool: generate-grammar Files added: - packages/agentSdkWrapper/src/schemaToGrammarGenerator.ts: Main generator class - packages/agentSdkWrapper/src/generate-grammar-cli.ts: CLI interface Files modified: - packages/agentSdkWrapper/src/schemaReader.ts: Added union type handling - packages/agentSdkWrapper/src/index.ts: Export new generator classes - packages/agentSdkWrapper/package.json: Add action-grammar dependency and CLI command Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Enables extending existing .agr grammars with new examples and improvements rather than always generating from scratch. New CLI options: - --input/-i: Load existing .agr file to extend - --improve: Provide improvement instructions to Claude Key features: - Extension mode uses specialized prompt to maintain consistency - Outputs to .extended.agr by default to avoid overwriting original - Successfully tested with calendar grammar Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
steveluc
temporarily deployed
to
development-fork
GitHub Actions
Inactive
steveluc
temporarily deployed
to
development-fork
GitHub Actions
Inactive
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Key Features
Grammar Generation
Grammar Extension (New)
--input/-iflag--improveflag.extended.agrby default to avoid overwriting originalCLI Commands
Technical Implementation
schemaToGrammarGenerator.ts,generate-grammar-cli.tsschemaReader.ts(union type support),index.ts(exports)@anthropic-ai/claude-agent-sdkfor Claude interactionsaction-grammarpackage for validationTesting
🤖 Generated with Claude Code