Skip to content

PowerContext v0.0.2

Choose a tag to compare

View all tags
@Teingi Teingi released this 20 Aug 07:17
· 86 commits to master since this release
v0.0.2
17f0369
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

PowerContext v0.0.2 — Work Continuity Across Agents

PowerContext v0.0.2 expands durable project Memory into a practical work-continuity layer for human-agent and agent-to-agent collaboration.

This release introduces a complete Work Contract → Handoff → Acknowledge → Task Outcome loop, adds official integrations for Claude Code, DeepSeek Harness, and Hermes Agent alongside Codex, and improves Memory reliability, observability, evaluation, and the Handoff Report experience.

Highlights

Carry work across sessions and agents

PowerContext can now represent the full lifecycle of delegated and transferred work:

  • Create a Work Contract that establishes the objective, constraints, and expected outcome.
  • Prepare and commit the current state as an evidence-bearing Handoff.
  • Let the receiving agent acknowledge whether the Handoff was accepted, rejected, or requires clarification.
  • Record a Task Outcome describing what was completed, what remains, and what should happen next.

The workflow is available through the Runtime, HTTP API, Python Client, and MCP tools:

  • create_work_contract
  • handoff_current_work
  • acknowledge_handoff
  • record_task_outcome

Verified claims require exact evidence, and existing Memory, Handoff, Experience, and review-governance behavior remains intact.

More official agent integrations

PowerContext v0.0.2 supports four official agent hosts:

  • Codex: project-scoped recall and explicit Memory and Handoff workflows.
  • Claude Code: automatic recall through UserPromptSubmit, prompt capture as Source evidence, and MCP tools for explicit operations.
  • DeepSeek Harness: bounded recall, prompt capture, and pc_* tools through the native DSH plugin.
  • Hermes Agent: a native MemoryProvider with prefetch, turn synchronization, pre-compression persistence, lifecycle hooks, and explicit Memory tools.

The integrations connect to the same PowerContext Server and scoped data model. Recall and capture failures remain fail-open so a PowerContext outage does not interrupt normal agent work.

A stronger Handoff Report experience

The Handoff Report is now enabled by default and available at /handoff-reports.

It provides:

  • Project and Workstream selection.
  • An inspectable current Handoff snapshot.
  • Objective, current state, disposition, next action, and known omissions.
  • Explicit creation of immutable Handoff revisions.
  • Receiver acknowledgements and Task Outcomes in the activity timeline.
  • Period comparison and Markdown export.

The statistics Dashboard remains separately configurable.

More reliable Memory and persistence

This release includes several reliability improvements:

  • Memory search now detects concurrent head changes, retries against the latest revision, and avoids silently returning stale or incomplete results.
  • Sustained concurrent updates return an explicit 409 revision_conflict when a consistent search revision cannot be obtained.
  • Partial SQLite configuration no longer replaces the default persistent database with an in-memory database.
  • Concurrent Source cursor creation is normalized into PowerContext's GenerationConflictError.
  • DeepSeek Harness sessions without a working directory are treated as unscoped instead of falling back to the Harness process directory.

Deeper operational visibility

OpenTelemetry tracing now exposes bounded stage-level spans for:

  • Scope resolution and lock contention.
  • Memory search and reranking.
  • Experience search.
  • Prepared Context construction.

These spans help distinguish database, embedding, reranking, context-building, and scope-lock latency without recording prompts, Memory content, vectors, scope identifiers, or exception messages.

Evaluation and documentation

The repository now includes:

  • A long-horizon acceptance workload catalog and Bub/Harbor execution pipeline.
  • Pinned LoCoMo-derived recall scenarios.
  • A SWE-bench Pro evaluation runner and web console.
  • Visual benchmark summaries for LoCoMo and SWE-bench Pro.
  • A refreshed documentation website with improved navigation, responsive layout, and multilingual content.
  • Post-release verification for GitHub assets, PyPI packages, installation, and CLI startup.

Install or Upgrade

PowerContext requires Python 3.11 or later on macOS or Linux.

Install or upgrade the CLI and local Server:

uv tool install --force "powercontext[cli,server]==0.0.2"

Install or refresh one or more agent integrations from the matching release tag:

powercontext setup codex --source oceanbase/powercontext --ref v0.0.2
powercontext setup claude-code --source oceanbase/powercontext --ref v0.0.2
powercontext setup dsh --source oceanbase/powercontext --ref v0.0.2
powercontext setup hermes --source oceanbase/powercontext --ref v0.0.2

Start the local Server:

powercontext server run

Verify the installation in another terminal:

powercontext doctor
powercontext doctor codex  # or: claude-code / dsh / hermes

Hermes integration requires Hermes Agent v0.20.4 or later.

Important Notes

  • The new Work Continuity APIs are additive. Existing Memory and Handoff APIs remain available.
  • Memory search may now return 409 revision_conflict during sustained concurrent updates instead of returning an inconsistent successful result.
  • Handoff Report is enabled by default but can be disabled explicitly in Server settings.
  • The Server continues to listen on 127.0.0.1:8000 by default. Keep plain HTTP on a loopback address; enable bearer authentication and TLS before exposing the Server over a network.
  • Explicit Memory operations work without an inference provider. Model-backed extraction, reranking, Experience or Skill generation, and generated Handoffs require the corresponding inference configuration.
  • Rerun powercontext setup after upgrading to refresh installed agent plugins.

Learn More

Thank you for trying PowerContext. We welcome feedback on work continuity, agent integrations, context quality, and the developer experience.

Assets 4
Loading