Prep release 0.2.4 (#217)

ezodude · web-flow · commit cf1a6b3995a8 · 2025-04-06T08:01:59.000+01:00
diff --git a/README.md b/README.md
@@ -96,11 +96,11 @@ Download the latest CLI binary for your platform from our [releases page](https:
 
 ```shell
 # macOS
-curl -L https://github.com/orra-dev/orra/releases/download/v0.2.3/orra-darwin-arm64 -o /usr/local/bin/orra
+curl -L https://github.com/orra-dev/orra/releases/download/v0.2.4/orra-darwin-arm64 -o /usr/local/bin/orra
 chmod +x /usr/local/bin/orra
 
 # Linux
-curl -L https://github.com/ezodude/orra/releases/download/v0.2.3/orra-linux-amd64 -o /usr/local/bin/orra
+curl -L https://github.com/ezodude/orra/releases/download/v0.2.4/orra-linux-amd64 -o /usr/local/bin/orra
 chmod +x /usr/local/bin/orra
 
 # Verify installation
diff --git a/cli/cmd/version.go b/cli/cmd/version.go
@@ -17,7 +17,7 @@ func newVersionCmd(_ *CliOpts) *cobra.Command {
 		Use:   "version",
 		Short: "Print the client and server version information",
 		RunE: func(cmd *cobra.Command, args []string) error {
-			fmt.Println("Client Version: v0.2.3")
+			fmt.Println("Client Version: v0.2.4")
 			// TODO: Implement server version check
 			return nil
 		},
diff --git a/docs/cli.md b/docs/cli.md
@@ -31,7 +31,7 @@ chmod +x /usr/local/bin/orra
 
 # Verify installation
 orra version
-# Client Version: v0.2.3
+# Client Version: v0.2.4
 ```
 
 ## CLI Commands Reference
diff --git a/planengine/config.go b/planengine/config.go
@@ -65,7 +65,7 @@ const (
 )
 
 var (
-	Version                        = "0.2.3"
+	Version                        = "0.2.4"
 	LogsRetentionPeriod            = 7 * 24 * time.Hour
 	DependencyPattern              = regexp.MustCompile(`^\$([^.]+)\.`)
 	WSWriteTimeOut                 = time.Second * 120
diff --git a/releases/cli/CHANGELOG.md b/releases/cli/CHANGELOG.md
@@ -1,3 +1,11 @@
+## CLI v0.2.4
+
+### Features
+- Increased CLI timeout to support using local LLMs for Plan Engine
+
+# Documentation
+- Added CLI reasoning traces example to documentation for better debugging
+
 ## CLI v0.2.3
 
 ### Features
diff --git a/releases/cli/versions/0.2.4.md b/releases/cli/versions/0.2.4.md
@@ -0,0 +1,7 @@
+## CLI v0.2.4
+
+### Features
+- Increased CLI timeout to support using local LLMs for Plan Engine
+
+# Documentation
+- Added CLI reasoning traces example to documentation for better debugging
diff --git a/releases/planengine/CHANGELOG.md b/releases/planengine/CHANGELOG.md
@@ -1,3 +1,36 @@
+## Plan Engine v0.2.4
+
+### Breaking Changes
+Simplified LLM and embeddings configuration to center around supported models rather than providers
+- Changed environment variable scheme from `REASONING_PROVIDER`/`REASONING_MODEL`/`REASONING_API_KEY` and `PLAN_CACHE_OPENAI_API_KEY` to a more cohesive approach with:
+  - `LLM_MODEL`/`LLM_API_KEY`/`LLM_API_BASE_URL` for reasoning models
+  - `EMBEDDINGS_MODEL`/`EMBEDDINGS_API_KEY`/`EMBEDDINGS_API_BASE_URL` for embedding models
+- Dropped support for `deepseek-r1-distill-llama-70b` model
+- Added support for self-hosted models with new configuration structure in `_env` template
+
+### Features
+- Added support for running the Plan Engine using self-hosted LLMs and embedding models
+  - Added support for `deepseek-r1` and `qwq-32b` as reasoning models
+  - Added support for `jina-embeddings-v2-small-en` as embedding model
+  - All model endpoints must be OpenAI API-compatible
+- Improved plan validation with better action parameters handling
+  - Added validation to ensure all action parameters are properly included in Task Zero
+  - Added validation against composite references in generated plans
+
+### Bug fixes
+- Fixed ordering of generated PDDL domain action parameters to prevent non-deterministic map key iteration
+- Fixed issue where execution plan non-task referenced inputs were not properly added to task zero
+- Increased grounding threshold to make grounding work at an acceptable level
+- Updated prompt to clarify expected task input pattern and required JSON markers in output
+
+### Documentation
+- Added extensive documentation on model configuration and self-hosting options
+- Added comprehensive guide for model configuration and self-hosting
+- Fixed typos and improved wording throughout documentation
+- Project README: Added new guide: "From Fragile to Production-Ready Multi-Agent App (with Cloudflare Agents)"
+- Project README: Updated with improved instructions for self-hosting and on-premises deployment
+- Project README: Removed "alpha" labels and updated coming soon sections
+
 ## Plan Engine v0.2.3
 
 ### Features
diff --git a/releases/planengine/versions/0.2.4.md b/releases/planengine/versions/0.2.4.md
@@ -0,0 +1,32 @@
+## Plan Engine v0.2.4
+
+### Breaking Changes
+Simplified LLM and embeddings configuration to center around supported models rather than providers
+- Changed environment variable scheme from `REASONING_PROVIDER`/`REASONING_MODEL`/`REASONING_API_KEY` and `PLAN_CACHE_OPENAI_API_KEY` to a more cohesive approach with:
+  - `LLM_MODEL`/`LLM_API_KEY`/`LLM_API_BASE_URL` for reasoning models
+  - `EMBEDDINGS_MODEL`/`EMBEDDINGS_API_KEY`/`EMBEDDINGS_API_BASE_URL` for embedding models
+- Dropped support for `deepseek-r1-distill-llama-70b` model
+- Added support for self-hosted models with new configuration structure in `_env` template
+
+### Features
+- Added support for running the Plan Engine using self-hosted LLMs and embedding models
+  - Added support for `deepseek-r1` and `qwq-32b` as reasoning models
+  - Added support for `jina-embeddings-v2-small-en` as embedding model
+  - All model endpoints must be OpenAI API-compatible
+- Improved plan validation with better action parameters handling
+  - Added validation to ensure all action parameters are properly included in Task Zero 
+  - Added validation against composite references in generated plans
+
+### Bug fixes
+- Fixed ordering of generated PDDL domain action parameters to prevent non-deterministic map key iteration
+- Fixed issue where execution plan non-task referenced inputs were not properly added to task zero
+- Increased grounding threshold to make grounding work at an acceptable level
+- Updated prompt to clarify expected task input pattern and required JSON markers in output
+
+### Documentation
+- Added extensive documentation on model configuration and self-hosting options
+- Added comprehensive guide for model configuration and self-hosting
+- Fixed typos and improved wording throughout documentation
+- Project README: Added new guide: "From Fragile to Production-Ready Multi-Agent App (with Cloudflare Agents)"
+- Project README: Updated with improved instructions for self-hosting and on-premises deployment
+- Project README: Removed "alpha" labels and updated coming soon sections
diff --git a/releases/sdks/CHANGELOG.md b/releases/sdks/CHANGELOG.md
@@ -1,3 +1,15 @@
+## SDKs v0.2.4
+
+### Features
+- Configurable WebSocket implementation for JS SDK
+
+### Javascript SDK v0.2.3
+
+#### Features
+- Made WebSocket implementation configurable on JS SDK initialization
+    - Required for running in Cloudflare environments
+    - Better compatibility with different JavaScript environments
+
 ## SDKs v0.2.3
 
 ### Features
diff --git a/releases/sdks/versions/0.2.4.md b/releases/sdks/versions/0.2.4.md
@@ -0,0 +1,12 @@
+## SDKs v0.2.4
+
+### Features
+- Configurable WebSocket implementation for JS SDK
+
+### Javascript SDK v0.2.3
+
+#### Features
+- Made WebSocket implementation configurable on JS SDK initialization
+  - Required for running in Cloudflare environments
+  - Better compatibility with different JavaScript environments
+

Original file line number	Diff line number	Diff line change
`@@ -65,7 +65,7 @@ const (`
`65`	`65`	`)`
`66`	`66`
`67`	`67`	`var (`
`68`		`- Version = "0.2.3"`
	`68`	`+ Version = "0.2.4"`
`69`	`69`	`LogsRetentionPeriod = 7 * 24 * time.Hour`
`70`	`70`	DependencyPattern = regexp.MustCompile(`^\$([^.]+)\.`)
`71`	`71`	`WSWriteTimeOut = time.Second * 120`