Skip to content

v0.0.2 — Protocol Power & Developer Experience

Choose a tag to compare

@masterkeysrd masterkeysrd released this 30 May 04:49
· 43 commits to main since this release
6930361

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 .Models or .Skills) without deep nesting.
    • System Globals: Support for runtime-injected variables like $PWD.
  • Agent Triggers: Added the triggers field to AgentSpec. Define whether an agent is human-facing ("human"), internal-only ("agent"), or triggered by the underlying environment ("system").
  • Model Fallbacks: Replaced the singular model field with a models array. Runtimes can now implement high-availability by falling back through a prioritized list of LLM identifiers.
  • Command Enhancements: Commands can now restrict the allowed tools and specify preferred models (e.g., using a cheaper model for specific tasks).
  • Command Hints: Added hints to CommandSpec to provide metadata for UI autocompletion and positional template substitution.

🛠 Tooling & DX

  • Warp CLI: Initial release of the warp command-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.labels to 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.)