Repository navigation
v0.0.2 — Protocol Power & Developer Experience
This release introduces significant enhancements to the WARP specification and its reference implementation, focusing on architectural control, reliability, and ease of use.
🚀 New Features
- Unified Templating System: Resources now support a powerful templating engine.
- Shorthand Syntax: Use
$Name,$1, or${hintName}directly in Markdown instructions. - Flattened Context: Access resource properties (like
.Modelsor.Skills) without deep nesting. - System Globals: Support for runtime-injected variables like
$PWD.
- Shorthand Syntax: Use
- Agent Triggers: Added the
triggersfield toAgentSpec. Define whether an agent is human-facing ("human"), internal-only ("agent"), or triggered by the underlying environment ("system"). - Model Fallbacks: Replaced the singular
modelfield with amodelsarray. Runtimes can now implement high-availability by falling back through a prioritized list of LLM identifiers. - Command Enhancements: Commands can now restrict the allowed
toolsand specify preferredmodels(e.g., using a cheaper model for specific tasks). - Command Hints: Added
hintstoCommandSpecto provide metadata for UI autocompletion and positional template substitution.
🛠 Tooling & DX
- Warp CLI: Initial release of the
warpcommand-line tool.warp validate [path]: Perform deep semantic validation of workspaces, including broken cross-reference detection.
- JSON Schema: Added a comprehensive schema at
schema/warp.json. Provides real-time autocompletion, type-checking, and documentation-on-hover in IDEs like VS Code. - Labels Support: Added
metadata.labelsto all resources for better categorization and filtering.
📚 Documentation & Examples
examples/simple-assistant: A new, fully-commented example workspace demonstrating the latest features.SECURITY.md: Formalized security guidelines for tool execution and credential management.CONTRIBUTING.md: Onboarding guide for new contributors.
How to Upgrade
If you are using the Go library, update your dependency:
go get github.com/masterkeysrd/warp@v0.0.2(Note: Replacing the model string with the models array in Agent and Command specs is a breaking change from 0.0.1.)