v0.2.6

Release v0.2.6

📊 Privacy-preserving usage analytics to help improve the project.

Plan Engine v0.2.6

Features

• Anonymous Telemetry: the Plan Engine now collects minimal, privacy-preserving usage analytics to help improve the project.
  • All telemetry is fully anonymous: no personal data, no IP addresses, and no environment details are collected.
  • Only hashed project and execution plan IDs are used for tracking related events.
  • Telemetry is opt-out at any time by setting ANONYMIZED_TELEMETRY=false in your environment or .env file.
  • See telemetry.md for details.

v0.2.5

Release v0.2.5

🧙 TLDR; New task abort feature, compensation context and orchestration/compensation completion/failures monitoring.

CLI v0.2.5

Features

• Added new comp-fail command to manage and monitor compensation failures
  • comp-fail ls - List failed compensations with filtering options
  • comp-fail inspect - Show detailed information about a compensation failure
  • comp-fail resolve - Mark a compensation failure as resolved
  • comp-fail ignore - Mark a compensation failure as ignored
  • comp-fail webhooks - Manage compensation failure notification webhooks

Improvements

• Enhanced task audit logs with abort feature
• Added compensation context support for better failure tracking
• Improved orchestration and compensation failures monitoring

Plan Engine v0.2.5

Features

• Added new task abort capabilities for orchestration control
  • Tasks can now be explicitly aborted with payload information
  • Improved handling of abort states throughout the workflow
• Enhanced compensation context for better failure and abort management
  • Added context information to compensations for both failures and aborts
  • Improved tracking of compensation states
• Enhanced webhook notification system
  • Added webhook events based on orchestration status
  • Improved webhook notifications targeting project-configured webhooks
  • Support for specialized notification types including compensation failures
• Implemented comprehensive compensation failures monitoring system
  • Added robust failure detection and classification
  • Enhanced error reporting for failed compensations

SDKs v0.2.5

Features

• Added task abort capabilities
• Enhanced compensation context for better failure and abort management

Javascript SDK v0.2.4

Features

• Added task.abort() method to allow explicit task termination with context
• Enhanced compensation functionality with new context injection

Python SDK v0.2.4

Features

• Added task.abort() method to allow explicit task termination with context
• Enhanced compensation functionality with new context injection

v0.2.4

Release v0.2.4

🚨 BREAKING: Plan Engine LLM and embeddings configuration has changed - please update accordingly.

⚡️ MAJOR: Plan Engine now supports self-hosted on-premises or local LLM and embedding models - check supported models.

Plan Engine v0.2.4

Breaking Changes 💥🚨

Simplified LLM and embeddings configuration to centre 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

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

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

v0.2.3

Release v0.2.3

Introduces progress updates for long running tasks.

CLI v0.2.3

Features

• View task progress updates using the inspect command's new --updates and --long-updates flags.
• Updated the CLI docs to highlight the latest inspect flags.
• Bumped version to v0.2.3

Plan Engine v0.2.3

Features

• Can accept task interim results as progress updates from coordinated tasks.
• Store task interim results in an orchestration's log.
• Created a new message payload type task_interim_result dedicated to processing progress updates.
• Bumped version to v0.2.3

Documentation

• Updated the core features documentation with an explanation for task interim results .

SDKs v0.2.3

Features

• Push progress updates using the new push update feature.

Python SDK v0.2.2

Features

• Can now push progress updates for a task that is still processing.
• Updated all relevant docs to explain how to use the push update feature.
• Bumped and published latest Python versions.

Javascript SDK v0.2.2

Features

• Can now push progress updates for a task that is still processing.
• Updated all relevant docs to explain how to use the push update feature.
• Bumped and published latest Python versions.

v0.2.2

This is mostly a dev chore type release.

This release updates the documentation and code to fully migrate to how planning is now explained and reasoned about in Orra.

Primarily, using the Plan Engine as a core concept.

CLI

Features

• Migrated towards a Plan Engine away from a Control Plane.
• Minor bug fixes.

Plan Engine

Features

• Migrated towards a Plan Engine away from a Control Plane.

Documentation

• General README updates across the project.
• General documentation updates and consolidation.

SDKs

Features

• Brought documentation up to date.

Python SDK v0.2.1

Features

• Minor documentation updates.
• Bumped and published latest Python versions.

Javascript SDK v0.2.1

Features

• Minor documentation updates.
• Bumped and published latest Python versions.

v0.2.1

Release v0.2.1 🐠 🌊️ 🎉🎉 (Manta Ray)

This brings Reasoning models, Domain Grounding via PDDL and state persistence to Orra. 🤖

Supported models include: DeepSeek R1 on Groq and OpenAI's o1-mini / o3-mini.

CLI v0.2.1

Features

• Grounding support added using orra grounding command.
• Various bug fixes.

Control Plane v0.2.1

Features

• Execution plan generation using Reasoning models.
• Added domain grounding.
• Execution plan validation based pn grounding capability matching
• Further execution plan validation using PDDL
• BadgerDB for persisting control plane state.

Bug fixes

• Various bug fixes.

Documentation

• General README updates across the project.
• Grounding documentation.
• Grounding template.

v0.2.0-manta-ray

Release v0.2.0-manta-ray 🐠 🌊️ 🎉🎉

Just as manta rays gracefully adapt to their environment with intelligent precision, this release is the beginning of reliable intelligence for recovery and execution planning. Starting with Compensation Guardrails.

• Recorded Live Demo 📹 🍿
• Live Demo Slides 👀

CLI v0.2.0

Features

• New --health-check-grace-period / -g flag to set timeout durations for orchestration tasks.
• Compensations support for the orra ps command.
• Compensations support for the orra inspect command.

Control Plane v0.2.0

Features

• Implemented comprehensive and robust Compensation handling system. 🎉
• Improved and tidied up service health monitoring and pause mechanisms in task workers. 😅
• Added control plane version headers for all responses.
• Enhanced service and agent schemas to accept arrays as properties.
• Enhanced error reporting for unhealthy services.

Bug fixes

• Fixed various compensation worker hidden bugs.
• Fixed various task worker obscure bugs.

Documentation

• General README updates across the project.
• Better explanation for what is considered an Agent in Orra.
• Added documentation for Compensations.

Dev support

• The update_examples.sh now supports crewai-ghost-writers example.

SDKs v0.2.0

Features

• Compensations support.

Python SDK v0.2.0

Features

• Idiomatic developer friendly UX for using compensations.
• Added documentation for using compensations.
• Failed task results are no longer cached.

Javascript SDK v0.2.0

Features

• Idiomatic developer friendly UX for using compensations.
• Added documentation for using compensations.
• Failed task results are no longer cached.

v0.1.3-narwhal

Release v0.1.3-narwhal

CLI v0.1.3

Features

• New --timeout / -t flag to set timeout durations for orchestration tasks.

Control Plane v0.1.3

Features

• Orchestration task timeout can be configured and defaults to 30 seconds.

Bug fixes

• Corrected OpenAI API ENV VAR name in control plane.
• Update examples script now removes service files ending with "-orra-service-key.json".
• Improved echo example poetry package file.
• Ignored the orra-data directory content but keep the directory in the echo python example.
• Updated tool call id schema to latest schema in example Delivery Agent to fix Mistral API failures.

Documentation

• General README fixes across the project.
• Explained that Orra is Agent framework and language agnostic in project README.
• Fixed "setting up control plane" broken link in example's README.
• Use single quotes in CLI verify run command example.
• Showcase how to set up and run agent plus service prototyping in a single file.

v0.1.2-narwhal

Release v0.1.2-narwhal

Control Plane v0.1.2

Bug fixes

• Minor fixes and cleanup.

Control Plane v0.1.2

Features

• New healthcheck endpoint added to the control plane
• Dockerfile updates.
• Docker compose file updates.
• Added schema validations to a Service.

Bug fixes

• Corrected the Project webhooks json tag.
• Ensured the version for registered service or agent is sent back the client.
• Update service and agent names per the new rules.

SDKs v0.1.2

Features

• Async API based SDK contract specification.
• Language agnostic SDK conformance suite and test harness.

Python SDK v0.1.2 (**NEW)

Features

• New Python SDK that implements the SDK contract specification.
• Published Python SDK to PyPI as orra-sdk - v0.1.2
• Added Python SDK conformance test suite.
• Added documentation for integrating Orra using the Python SDK.
• Echo example showcasing the Python SDK.
• By default, orra-service-key files are prefixed by the service or agent name.

Javascript SDK v0.1.2

Features

• Added JavaScript SDK conformance test suite.
• New developer UX for integrating Services and Agents to Orra.
• Documentation updates.
• Example updates.
• By default, orra-service-key files are prefixed by the service or agent name.

Bug fixes

• Ensure service key path directories are created correctly if they don't exist.

What's Changed

Other Changes

• Language agnostic SDK conformance suite with an SDK protocol contract by @ezodude in #111
• Python SDK and related updates by @ezodude in #112
• Update JS examples to use version 0.1.2-narwhal on published to npm by @ezodude in #117
• Readme updates to mirror new 0.1.2-narwhal features by @ezodude in #118
• Prep narwhal 0.1.2 by @ezodude in #119
• CLI changelog entry for v0.1.2-narwhal by @ezodude in #120

Full Changelog: v0.1.1-narwhal...v0.1.2-narwhal

v0.1.1-narwhal

Release v0.1.1-narwhal

CLI v0.1.1

Bug fixes

• Inspect CLI command should explicitly notify users of an unknown orchestration.

Control Plane v0.1.1

Features

• Documentation updates for all examples.
• All examples now run using Docker.

JavaScript SDK v0.1.1

Features

• Published JS SDK to npm as @orra.dev/sdk - v0.1.1-narwhal

Bug fixes

• Ensure service key path directories are created correctly if they don't exist.