AWR 0.5.0

AWR 0.5.0 improves daily work navigation, MCP tool discovery, and session continuity. It includes #27, #28, #29, #30, #31, #33, #48, and #53. Personal Workspace file exchange and the existing shared HTTP MCP runtime are included; the new Team implementation is outside this release.

What's changed

• Daily work navigation: the action view separates current, ready, waiting, and blocked work. Small source edits and historical verification have clearer workflows and evidence.
• Focused MCP discovery: grouped mode is now the default, exposing 8 stdio tools or 9 HTTP tools. Flat compatibility mode provides 32 and 33 tools, respectively.
• Precise continuity guidance: instructions include applicability, evidence, the next action, and reassessment triggers. Keep native compaction enabled; actual post-compaction occupancy can inform a user-approved session handoff.
• Personal Workspace exchange: exchange files across machines while retaining an independent local runtime on each machine.
• Host integration: L0/L1/L2 integration documentation and a Cursor L1 guide clarify the generic contract and optional host adapters.
• Optional Inspector: run the local inspection interface from source. It is not included in npm or PyPI packages. Queries may refresh SQLite projections; explicit reindexing is disabled by default.
• Linux ARM64: prebuilt packages now cover macOS arm64/x64, Linux arm64/x64, and Windows x64.

Installation

npm install -g @originoneai/agent-work-runtime@0.5.0
# or, in a Python virtual environment
python -m pip install agent-work-runtime==0.5.0

Upgrading from 0.4.0

1. status and awr_project_status now default to the action view. Request --view full or view: "full" for the previous full response structure.
2. MCP discovery now defaults to grouped. Integrations requiring the flat catalog can set AWR_MCP_TOOL_EXPOSURE_MODE=flat and reconnect the client to refresh tool discovery.
3. client bind, progress, show, hook, and install require an explicit --client.

Database schema remains 4. Before upgrading, retain the matching program, configuration, authoritative sources, and a consistent SQLite/runtime snapshot. Follow the matched upgrade and rollback procedure linked below.

Requirements: macOS 15+; Linux glibc 2.39+; Windows x64. Launchers require Node 22.14+ or Python 3.9+.

Release verification

The release contains six npm archives, five Python wheels, a release manifest, and SHA256 checksums, built from the same source commit. Verification covers native programs, installation, MCP, and matched upgrade/rollback behavior. These checks do not establish every host's complete business acceptance, an infinite-context guarantee, or a reduction in model billing.

Full release notes · Distribution and rollback guide

AWR 0.4.0

AWR 0.4.0

0.4.0 reduces the work needed to maintain a task while preserving source authority,
required context, evidence checks and recovery behavior. It adds explicit
management assessments, combined task preparation, optional concise responses,
and examples for host orchestration and reviewed execution reports.

npm install -g @originoneai/agent-work-runtime@0.4.0
# or, in a Python virtual environment
python -m pip install agent-work-runtime==0.4.0

Changes

• Source diagnostics include a file, a line/column when known or a field pointer,
  the violated rule and a repair direction. Human, JSON and MCP outputs use the
  same underlying outcome. Evidence summaries preserve source and verification
  differences.
• work prepare returns readiness, required context and management requirements
  together. Hosts acknowledge the context actually delivered before recording a
  checkpoint or completing work; missing capabilities retain the older workflow.
• Management is assessed from observed coordination needs. Persistent waits,
  handoffs, separate subtasks, unresolved dependencies and uncertain outcomes
  require continued tracking. Time and rework thresholds trigger reassessment;
  unknown facts remain unknown. An upgrade preserves identity and history and
  does not lower completion requirements or automatically downgrade later.
• CLI and MCP support an explicitly selected summary response for task preparation
  and transitions. Full output remains the default. Summaries retain required
  context, identities, versions and recovery links; failures and unknown outcomes
  retain their full results. Full durable operation receipts remain queryable.
• MCP exposes structured task creation and plan changes with dependency checks
  and request recovery. The host orchestration example handles ready work,
  bounded parallel execution and interruption. Agents plan the work; hosts own
  model execution, scheduling and concurrency limits.
• The host workflow example collects actual AWR-managed command results, source
  snapshots, logs and artifact hashes into reviewed completion reports. Explicit
  review is required; exit code zero alone cannot complete a task. Changed,
  missing or uncertain evidence is rejected. Lost-response recovery reuses the
  original execution and evidence, including reports larger than 64 KiB.
• Managed execution identity recognizes equivalent filesystem directories across
  platforms, including Windows native path prefixes, while still rejecting a
  different project directory or changed command.

See the workflow contract,
host workflow guide and
host example.

Measured behavior

The full-workflow benchmark records 30 synthetic runs:
combined preparation reduces tool calls by 18–27% and returned text by 3.4–4.7%
against the equivalent older workflow.

The summary-response comparison records 45
synthetic runs: summary responses reduce cumulative returned text by 6.8–9.2%
against full prepared responses, with the same number of calls. These are separate
comparisons with recorded source identities, not additive savings or estimates of
actual model tokens or billing. Context caching and incremental context reuse are
not part of this release.

Compatibility and upgrade

Database schema remains 4. Keep the original project directory, authoritative
sources, runtime history and previous executable; retain a matching backup and
stop active writers before switching a pinned binary. Follow the
upgrade and rollback procedure.
Negotiate capabilities when using the new host helpers with an older binary.

The release provides macOS 15+ arm64 and Intel x64, Linux x64 with glibc 2.39+,
and Windows x64 packages. npm launchers require Node 22.14+; Python launchers
require Python 3.9+. Keep npm optional dependencies enabled. Native executables
can run without either launcher runtime. Packages contain Apache-2.0 and applicable
dependency notices; manifests and checksums bind their source and binary identity.

Stdio MCP exposes 29 tools; shared HTTP adds authorized project discovery for 30.
Existing commands retain their full-output defaults. The shared service continues
to isolate projects and clients and preserve sessions, waits and operation
recovery across reconnects. Hosts remain responsible for model execution and user
interaction. Platform, installation and fixture checks are distinct from a host's
own application or business acceptance.

AWR 0.3.3

AWR 0.3.3 adds a shared MCP service and persistent work-session continuity.

• One Streamable HTTP endpoint serves multiple initialized projects and clients with explicit project access grants.
• MCP work sessions support claims, checkpoints, ending and explicit continuation across disconnects and server restarts.
• Durable user waits/replies and identified write requests support outcome inspection and receipt-based recovery.
• Local stdio remains supported: 20 stdio tools and 21 HTTP tools, including project discovery.
• Four native targets remain available: macOS arm64, Intel Mac x64, Linux x64 GNU and Windows x64. Database schema stays at 4.

Install with npm install -g @originoneai/agent-work-runtime@0.3.3 or python -m pip install agent-work-runtime==0.3.3.

Release notes · Shared MCP setup · Distribution and upgrade guidance

The attached five npm archives and four wheels are the verified native builds. release-manifest.json and SHA256SUMS bind their source commit and hashes. Packages include Apache-2.0 and dependency license notices. Native regression and installation verification remain separate from enterprise-client business acceptance.

AWR 0.3.2

AWR 0.3.2

0.3.2 improves project intake, source continuity, daily work management and recovery.
The native CLI and MCP packages retain all four supported platforms, including
Intel Mac, and database schema 4.

npm install -g @originoneai/agent-work-runtime@0.3.2
# or, in a Python virtual environment
python -m pip install agent-work-runtime==0.3.2
awr --version
awr-mcp --version

Changes

• Public configuration and authorization notes can be recorded without being
  mistaken for secret values. Secret-value checks still apply.
• Intake validates source semantics before writing project configuration, sources
  or runtime state. Rejected mappings return diagnostic issues without leaving a
  partially initialized project.
• Explicit source relocation preserves source identity and history when a
  supported single-file source moves without content changes, with recovery for
  interrupted operations.
• CLI and MCP reads coordinate source refreshes and return coherent query
  snapshots. Cached reads identify their historical basis.
• Compact status summaries support work, goal and milestone filters through the
  CLI and awr_project_status MCP tool.
• The public host workflow example provides pinned-binary session, context,
  checkpoint, evidence and completion operations, including explicit handling of
  uncertain write outcomes.
• Organization commands preview and maintain explicitly mapped project phase,
  scope, focus and next-action fields without changing task completion.
• Runtime commands create and check matched program/configuration/source/database
  snapshots and perform previewed offline database restoration with recovery.
  Git source identities include the resolved commit, even when blob bytes match.

See the host contract,
host workflow example and
runtime snapshot contract for supported
operations and exact recovery boundaries.

Compatibility and upgrade

Target	Minimum baseline
macOS Apple Silicon arm64	macOS 15
macOS Intel x64	macOS 15
Linux x64 GNU	glibc 2.39
Windows x64	Native verification on Windows Server 2025

npm launchers require Node 22.14+; Python launchers require Python 3.9+.
Keep npm optional dependencies enabled. Native executables run without either
launcher runtime; the optional host workflow example requires Python 3.11+.

No schema migration is required from 0.3.1. Keep the original project root,
authoritative sources, runtime history and previous executable when upgrading.
Retain a matching backup before switching the pinned program; follow the
upgrade and rollback procedure.
Native snapshot restoration requires offline clients and matching source,
configuration, project and program identities. It restores the database and
retains displaced bytes; it does not overwrite changed source files or restore
host-managed data outside .awr.

Archives carry source identity, binary hashes, Apache-2.0 and dependency notices.
The release manifest and SHA256SUMS bind the package files. Native platform and
installation checks do not replace host-application integration or real-agent
business acceptance.

AWR 0.3.1

AWR 0.3.1

0.3.1 adds native Intel Mac support to the npm and PyPI distributions. On an Intel
Mac, the npm launcher selects @originoneai/agent-work-runtime-darwin-x64; pip
selects the macosx_15_0_x86_64 wheel. Both include native awr and awr-mcp
executables. Supported machines install prebuilt packages without a Rust compiler.

npm install -g @originoneai/agent-work-runtime@0.3.1
# or, in a Python virtual environment
python -m pip install agent-work-runtime==0.3.1
awr --version
awr-mcp --version

Supported targets

Target	Minimum baseline
macOS Apple Silicon arm64	macOS 15
macOS Intel x64	macOS 15
Linux x64 GNU	glibc 2.39
Windows x64	Native verification on Windows Server 2025

npm launchers require Node 22.14+; Python launchers require Python 3.9+.
Keep npm optional dependencies enabled. Intel Mac builds and installation checks
run on macos-15-intel; Apple Silicon checks run separately on macos-15.
The native verification contract now includes both Mac architectures alongside
Linux and Windows. Release assembly requires successful installation receipts
from all four targets before collecting five npm archives and four wheels.

Upgrade

The 0.3.0 host capabilities remain available. This patch retains
database schema 4 and introduces no migration from 0.3.0. Preserve the original
project directory, sources and .awr history when updating the executable.
Hosts should retain a matching program/runtime/source snapshot before switching
their pinned binary; see the upgrade and rollback procedure.

Archives include source identity, binary hashes, Apache-2.0 and dependency license
notices. The release manifest and SHA256SUMS bind the downloadable files.
Package and native-platform checks cover installation and runtime contracts;
application integration and real-agent business acceptance remain separate.

AWR 0.3.0

AWR 0.3.0

AWR 0.3.0 adds a stable host integration contract and source-preserving editing.
Applications can use the native CLI to manage project work while Markdown/YAML
remains authoritative and AWR retains execution history and checkpoints.

Install

npm install -g @originoneai/agent-work-runtime@0.3.0
# or, in a Python virtual environment
python -m pip install agent-work-runtime==0.3.0

Both packages provide awr and awr-mcp. npm uses the latest channel.
Prebuilt targets are macOS 15+ arm64, Linux x64 with glibc 2.39+, and Windows x64.
The npm launcher requires Node 22.14+; the Python launcher requires Python 3.9+.
Embedded native binaries run without either language runtime.

Changes since 0.2.0

• Host capability negotiation, exact project-intake previews, source
  configuration receipts and complete paginated object catalogs.
• External execution references, deduplicated lifecycle checkpoints and explicit
  recovery checks, plus incremental source changes with retirement and failure
  semantics.
• Source-preserving YAML field editing and bounded Markdown table/checklist
  editing, stable draft creation, batch imports and reversible logical archival.
• Registered Markdown document editing and new drafts; explicit decision adoption
  and supersession tied to reviewed content versions.
• Human saves and reviewed AI changes with stable request identities, source
  fingerprint checks and queryable outcomes. Related multi-file edits retain
  recoverable phases and report partial application explicitly.
• Explicit ordinary-work completion policies distinguish user confirmation and
  business checks from engineering verification. Existing strict projects keep
  their completion requirements.
• Immutable native host bundles with source identities, checksums and license
  notices, plus an isolated matched upgrade/rollback rehearsal.

See the host contract and
host example for request shapes and supported
adapter limits. Unsupported or ambiguous source structures remain read-only.

Upgrade from 0.2.0

The database schema advances from 3 to 4 to represent draft work. Preserve the
original project directory, source mapping and project identity. Before opening
an existing project with 0.3.0, stop its writers and retain a consistent snapshot
of the previous executable, original sources, configuration and complete runtime
history. AWR refreshes projections from registered sources; runtime history is
not reconstructible from those sources alone.

Older executables reject schema 4. Rolling back requires the matching program,
runtime, configuration and source snapshot, with review of any later source
changes. Follow the matched upgrade and rollback procedure.

Release scope

This is a software package release. Installation and native CLI/MCP checks cover
the listed platforms. Application UI integration, signing/notarization and
acceptance through a particular native agent client remain host-specific work.
Package checksums and the source commit are recorded in the release manifest;
Apache-2.0 and applicable dependency notices accompany the native payloads.

Assets contain the four npm archives, three platform wheels, SHA256SUMS, and the release manifest. The manifest binds the tested package bytes to the source commit.

AWR 0.2.0

AWR 0.2.0 is a stable release of Agent Work Runtime: persistent project state and focused context for coding agents, available through a native CLI and MCP.

Highlights

• Initialize existing projects from Markdown and YAML, with explicit status and field mappings, including Chinese metadata.
• Diagnose missing goals, work structure and acceptance criteria, and return concrete organization steps for the coding agent.
• Compile task context with a token budget, required facts and source references; record checkpoints and open loops for later sessions.
• Supervise AWR-launched commands and connect supported client lifecycle events.
• Install prebuilt awr and awr-mcp commands through npm or pip. No Rust build is needed on supported platforms.
• Read concise English and Chinese guides with a reproducible public token benchmark.

Install

npm install -g @originoneai/agent-work-runtime@0.2.0

Or, in a Python virtual environment:

python -m pip install agent-work-runtime==0.2.0

Prebuilt targets: macOS 15+ arm64, Linux x64 with glibc 2.39+, and Windows x64. Launchers require Node 22.14+ or Python 3.9+. Both distributions include the same native CLI and MCP functionality; they are not language SDKs.

Verification and scope

The release pipeline builds each native platform separately and installs both package formats to exercise command versions, error handling, project initialization, task context, intake diagnosis and MCP stdio. Published archives are bound to the source commit in release-manifest.json; SHA256SUMS contains their SHA-256 hashes.

AWR restores recorded work context and can supervise processes it launches. Resuming an arbitrary pre-existing process or a client's private session requires that client's support. Package and platform checks do not certify real-client business acceptance or enterprise production readiness.

Licensed under Apache-2.0.