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.

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.

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.

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.

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.

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

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.

Release v0.1.0-narwhal 🐋🦄

CLI v0.1.0 💻 🔡

Features

• Initial release of the CLI tool
• Support for project management (orra projects)
• Support for webhook configuration (orra webhooks)
• Support for API key management (orra api-keys)
• Support for orchestrated actions listing (orra ps)
• Support for detailed inspection of an orchestrated action (orra inspect)

Implementation Notes

• Implements local configuration management
• Supports multiple projects and contexts

Known Limitations

• Config has to be reset when the control plane is restarted (orra config reset)

Control Plane v0.1.0 ✈️ 🎛️

Features

Dynamic Orchestration

• LLM-powered decomposition into parallel execution plans
• Vector cache for efficient plan reuse with parameterization
• Intelligent service discovery and capability matching
• Support for services and agents with schema validation

Reliability

• Exactly-once execution through idempotency store (24-hour retention)
• Smart service health handling:
  • WebSocket heartbeat monitoring
  • Automatic pause on outages (up to 30-minute recovery)
  • Short-term retries with exponential backoff (up to 5 attempts)
• Retryable vs permanent failure classification

State Management

• Append-only log for execution history
• Real-time task status tracking
• Support for parallel execution
• Result aggregation with ordering guarantees

Integration

• HTTP webhook delivery for results
• Multiple API key management
• Structured service schema validation

Implementation Notes

• Lease-based idempotency tracking
• Vector-based semantic caching for LLM plans
• Task dependency resolution
• Resource cleanup for completed orchestrations

Known Limitations

• HTTP-only webhook delivery
• Manual service discovery/registration
• Single WebSocket connection per service
• Non-configurable task timeouts

JavaScript SDK v0.1.0 📦 🔌

Features

Service Management

• Simple registration for services and agents
• Automatic reconnection with exponential backoff (1-30s, max 10 attempts)
• Built-in schema validation for input/output
• Service key persistence with customizable storage
• Automatic versioning and health signaling

Task Handling

• Idempotent execution with deduplication and caching
• In-memory result cache (24 hour TTL)
• Stateful execution tracking
• Task lifecycle hooks
• Graceful failure handling

Connection Management

• WebSocket connection monitoring and health checks
• Configurable reconnection strategies
• Message deduplication
• Message size limits (10KB)

Implementation Notes

Reliability

• Task deduplication via idempotency keys
• Automatic stale task cleanup
• Health check management
• Connection state tracking

Storage

• Configurable service key persistence
• In-memory task caching
• Task execution state management

Known Limitations

• Single WebSocket connection per service
• No request rate limiting
• In-memory only task cache
• Service recovery limited to connection retries