Skip to content

PowerContext v0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@Teingi Teingi released this 31 Aug 06:24
· 19 commits to master since this release
powercontext-v0.1.0
7b73620
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.1.0

更广、更安全的上下文运行层 · A broader, safer context runtime

中文 · English

中文

概览

PowerContext v0.1.0 将项目上下文从少数 Agent 集成扩展到更完整的 Agent 与框架生态，同时增强了配置、诊断、持久化、可观测性和网络安全边界。

这个版本让团队可以用同一套按 scope 隔离、保留证据链的 Memory 与 Handoff 能力连接更多工作环境；也让 Server 更容易安装、检查和安全部署。

主要更新

支持更多 Coding Agent 接入与框架集成

  • Coding Agent 工具集成现在包含 Codex、Claude Code、DeepSeek Harness、OpenClaw、OpenCode、Pi Coding Agent 和
    Hermes Agent。可以使用 powercontext setup select 批量安装，并通过 powercontext doctor integrations
    查看统一的只读诊断矩阵。
  • 新增 WorkBuddy 集成，支持请求前有界召回、Source 捕获、MCP 工具以及 Memory/Handoff Skill。WorkBuddy 继续使用
    显式的 powercontext setup workbuddy 和 powercontext doctor workbuddy 命令。
  • 新增 LangChain middleware 与 LangGraph adapter，让应用可以在模型调用前注入有界 PreparedContext，并通过
    公共 Client API 使用 Memory。两者保持 fail-open：PowerContext 暂时不可用时，不会阻断原始 Agent 工作流。
  • 新增 Pydantic AI adapter ，提供 Memory 工具、有界召回和可选的完成事件捕获。
  • Hermes 集成补齐 Memory、Handoff、Experience、Skill、Review、统计、Tracing 和 Workstream 操作。

更易配置、诊断和延续工作

  • 新增 powercontext config init、config show 和 config validate，用于生成、检查并验证显式环境文件。凭证输入
    会隐藏，输出中的敏感变量会被脱敏。
  • powercontext setup select 可以一次安装多个 Host；powercontext doctor integrations 可以在不要求所有 Host
    CLI 都已安装的情况下汇总状态。
  • Handoff Report 按 scope_id 生成，避免不同项目的工作记录混在同一份报告中。
  • Runtime 定时处理现在进入 OpenTelemetry trace，便于把后台处理与 Source、Memory 和 Server 活动关联起来。
  • 外部 Skill Registry 暂时不可用时，已经成功写入 Agent 目标的 Skill 发布不再被错误地返回为 HTTP 500。

更完整的本地持久化能力

  • SQLite 向量与混合检索改用随 powercontext[builtin] 一起安装的 sqlite-vec，不再要求用户单独提供 Vec1
    extension 路径。未配置 embedding 时，SQLite 全文检索仍可独立工作。
  • 新增嵌入式 seekdb backend。Linux 和 macOS 用户可以通过 seekdb extra 使用本地 seekdb，并复用与
    OceanBase 相同的全文和向量持久化路径。
  • embedding 请求现在显式携带配置的维度；readiness 会用稳定、经过脱敏的原因报告 provider 拒绝和
    sqlite-vec dimension 不匹配。
  • OceanBase schema 使用区分大小写的身份列规则，避免仅大小写不同的 scope_id 或 source_id 被错误折叠。
  • SQLite、seekdb 和 OceanBase 的 SQLAlchemy 错误日志会隐藏 SQL 参数，避免 Memory 内容进入异常日志。

更安全的网络默认值

  • Server 默认拒绝未认证的非 loopback 监听地址，除非部署者显式选择允许该模式。
  • Client 默认拒绝所有非 loopback 的明文 HTTP 请求，避免 Memory 内容或 bearer token 通过未加密连接传输。
  • 对 TLS 终止代理、进程内 ASGI transport 或受控私有网络，调用方仍可通过文档化的显式信任选项声明传输边界。
  • 安装、Server 部署、配置、HTTP API、Tracing 和故障排查文档已同步补全中英文说明。

安装与升级

安装或升级 PowerContext CLI 与本地 Server：

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

使用同一个 Release tag 安装一个或多个一等 Host 集成：

powercontext setup select --host codex --host dsh \
  --source oceanbase/powercontext --ref powercontext-v0.1.0

WorkBuddy 使用独立命令：

powercontext setup workbuddy \
  --source oceanbase/powercontext --ref powercontext-v0.1.0

升级后重启 Server 和 Agent Host，并验证安装状态：

powercontext doctor
powercontext doctor integrations
powercontext ready
powercontext capabilities

升级注意事项

  • SQLite vector 配置有破坏性变化。 SQLiteConfig.vec1_extension 和
    POWERCONTEXT_SERVER_DATABASE_VEC1_EXTENSION 已移除。请删除旧配置；sqlite-vec 现在由 builtin 依赖自动加载。
  • 如果现有 SQLite 数据库使用 Vec1，升级前请备份数据库，并为 vector projection 安排迁移或重建。权威 Memory
    revision 与派生检索 projection 是不同的数据边界，不要在未备份和未确认迁移方案时直接删除数据库。
  • embedding model、profile ID 和 dimension 必须成套配置。更换 model、dimension 或 normalization 时，需要重建
    Memory projection 后再恢复 vector/hybrid search。
  • 非 loopback 部署应优先使用 HTTPS 和 bearer authentication。只有在 TLS 已由代理终止或网络边界受到控制时，
    才应使用显式的 transport trust/unauthenticated bind 选项。
  • 嵌入式 seekdb 目前支持 Linux 和 macOS，不支持 Windows。
  • Pydantic AI adapter 仍是预览能力；LangChain 与 LangGraph adapter 尚未作为独立 PyPI 包发布，需要按照仓库文档
    从 Git 或本地源码安装。

链接

English

Overview

PowerContext v0.1.0 expands project context from a small set of agent integrations into a broader host and framework
ecosystem, while strengthening configuration, diagnostics, persistence, observability, and network safety.

Teams can now connect more working environments to the same scope-isolated, evidence-preserving Memory and Handoff
contracts. The Server is also easier to install, inspect, and deploy safely.

Highlights

More agent hosts and frameworks

  • The first-class host catalog now includes Codex, Claude Code, DeepSeek Harness, OpenClaw, OpenCode, Pi Coding Agent,
    and Hermes Agent. Use powercontext setup select for multi-host installation and
    powercontext doctor integrations for one read-only diagnostic matrix.
  • The new WorkBuddy integration provides bounded pre-request recall, Source capture, MCP tools, and a Memory/Handoff
    Skill. WorkBuddy remains available through the explicit powercontext setup workbuddy and
    powercontext doctor workbuddy commands.
  • New LangChain middleware and a LangGraph adapter inject bounded PreparedContext before model calls and expose
    Memory through the public Client API. Both integrations fail open, so a temporary PowerContext failure does not stop
    the original agent workflow.
  • A preview Pydantic AI adapter adds Memory tools, bounded recall, and optional completed-event capture.
  • The Hermes integration now covers Memory, Handoff, Experience, Skill, Review, statistics, tracing, and Workstream
    operations.

Easier configuration, diagnostics, and work continuity

  • New powercontext config init, config show, and config validate commands create, inspect, and validate an
    explicit environment file. Credential input is hidden, and sensitive variables are redacted from output.
  • powercontext setup select installs several hosts in one run, while powercontext doctor integrations summarizes
    their status without requiring every optional host CLI to be present.
  • Handoff Reports are generated by scope_id, keeping work from different projects out of the same report.
  • Scheduled Runtime processing now participates in OpenTelemetry traces, connecting background work to Source,
    Memory, and Server activity.
  • A temporary external Skill Registry discovery failure no longer turns an otherwise successful Agent-target Skill
    publication into an HTTP 500 response.

More complete local persistence

  • SQLite vector and hybrid search now use sqlite-vec, bundled with powercontext[builtin]; users no longer need to
    provide a separate Vec1 extension path. SQLite full-text search remains available without an embedding model.
  • A new embedded seekDB backend lets Linux and macOS users run local seekDB through the seekdb extra while reusing
    the OceanBase full-text and vector persistence path.
  • Embedding requests now carry the configured dimension explicitly. Readiness reports provider rejections and
    sqlite-vec dimension mismatches with stable, redacted reasons.
  • OceanBase identity columns use case-sensitive semantics, preventing case-only scope_id or source_id values from
    being collapsed.
  • SQLAlchemy failure logging hides SQL parameters for SQLite, seekDB, and OceanBase so Memory content does not leak
    into exception logs.

Safer network defaults

  • The Server rejects an unauthenticated non-loopback bind unless the operator explicitly opts into that deployment
    mode.
  • The Client rejects every plaintext non-loopback HTTP request by default, protecting both Memory content and bearer
    tokens from unencrypted transport.
  • TLS-terminating proxies, in-process ASGI transports, and controlled private networks can still declare their trust
    boundary through the documented explicit options.
  • The English and Chinese installation, Server deployment, configuration, HTTP API, tracing, and troubleshooting
    guides have been expanded accordingly.

Install or upgrade

Install or replace the PowerContext CLI and local Server:

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

Install one or more first-class host integrations from the same Release tag:

powercontext setup select --host codex --host dsh \
  --source oceanbase/powercontext --ref powercontext-v0.1.0

Use the dedicated command for WorkBuddy:

powercontext setup workbuddy \
  --source oceanbase/powercontext --ref powercontext-v0.1.0

Restart the Server and agent hosts after upgrading, then verify the installation:

powercontext doctor
powercontext doctor integrations
powercontext ready
powercontext capabilities

Upgrade notes

  • SQLite vector configuration has a breaking change. SQLiteConfig.vec1_extension and
    POWERCONTEXT_SERVER_DATABASE_VEC1_EXTENSION have been removed. Delete the old setting; the builtin dependency set
    now loads sqlite-vec automatically.
  • If an existing SQLite database uses Vec1, back it up before upgrading and plan a migration or rebuild of the vector
    projection. Authoritative Memory revisions and derived search projections are separate data boundaries; do not
    delete the database without a verified migration and backup.
  • The embedding model, profile ID, and dimension must be configured together. Changing the model, dimension, or
    normalization requires rebuilding Memory projections before vector or hybrid search resumes.
  • Prefer HTTPS and bearer authentication for non-loopback deployments. Use explicit transport-trust or
    unauthenticated-bind options only when TLS terminates at a proxy or the network boundary is otherwise controlled.
  • Embedded seekDB currently supports Linux and macOS, not Windows.
  • The Pydantic AI adapter remains a preview. The LangChain and LangGraph adapters are not yet published as standalone
    PyPI packages and must be installed from Git or a local checkout as documented in the repository.

Links

What's Changed

  • fix(website): redirect root to English site by @PsiACE in #1288
  • ci(docs): add manual documentation deployment by @PsiACE in #1291
  • feat: enable Dashboard by default without blocking Server startup by @Zxf-xufeng in #1292
  • build: derive package version from vcs by @PsiACE in #1289
  • fix(persistence): report concurrent artifact create as revision conflict by @Ethan-Xingyue in #1296
  • fix: oceanbase identity collation collapses case-variant scope_id and source_id by @thunguo in #1277
  • feat(hermes): add Hermes memory provider setup and diagnostics of powercontext cli by @Alanxtl in #1287
  • feat(pi): add native Pi Coding Agent support by @pi-dal in #1259
  • feat(integrations/OpenClaw): add OpenClaw PowerContext memory plugin by @XnLemon in #1282
  • docs(rfc): define local Server service-installation boundaries by @knqiufan in #1299
  • chore: ignore local agent artifacts by @AlexStocks in #1323
  • docs: announce Pi Coding Agent support by @pi-dal in #1309
  • chore: strengthen Python static analysis by @AlexStocks in #1324
  • fix(test): improve Windows compatibility of the test suite by @beatenevo in #1312
  • Fix/windows hook unicode prompts by @222twotwotwo in #1326
  • feat(handoff): preview report template without projects by @Kairo-J in #1307
  • feat(sqlite)!: replace Vec1 with bundled sqlite-vec by @PsiACE in #1306
  • feat(persistence): add embedded seekDB support by @Evenss in #1293
  • feat(e2e): batch cases across Harbor tasks by @PsiACE in #1279
  • fix(doc): missing link entries in the integrations table in README by @bowenliang123 in #1331
  • feat(langgraph): add PowerContext LangGraph integration adapter by @larry-zy in #1315
  • fix(persistence): hide SQL parameters in failure logs by @Kairo-J in #1336
  • fix(server): display uvicorn lifecycle logs without an error logger name by @AlexStocks in #1335
  • docs: document reviewed Experience and Skill workflows by @chenncy in #1334
  • feat(opencode): add PowerContext integration by @happy-v587 in #1329
  • docs: align handoff reports with scope identity by @Zxf-xufeng in #1348
  • fix(handoff-report): generate reports by scope by @Zxf-xufeng in #1347
  • feat(server): add Experience and Skill review UI by @Teingi in #1304
  • fix(server): use PowerContext branding in web UI by @PsiACE in #1350
  • docs: document the OpenClaw integration by @AlexStocks in #1340
  • fix: caller-controlled scope IDs grow Runtime caches without bound by @thunguo in #1325
  • fix(docs): improve reference and content readability by @PsiACE in #1368
  • fix(opencode): install plugin through global autoload path by @happy-v587 in #1353
  • feat(integrations): support pydantic-ai integrate by @thunguo in #1295
  • feat(langchain): add PowerContext middleware by @Teingi in #1355
  • feat(integrations): add WorkBuddy integration by @AlexStocks in #1337
  • feat(evaluation): add single-arm baseline comparisons by @frf12 in #1328
  • fix(transport): enforce a shared loopback-only plaintext HTTP policy (#1319) by @larry-zy in #1344
  • feat(cli): add doctor integrations for first-class host status by @knqiufan in #1314
  • fix(dsh): declare required plugin services by @knqiufan in #1371
  • feat(hermes): hermes coding agent capabailities completely alignment by @Alanxtl in #1343
  • fix(opencode): keep interrupted plugin installs recoverable by @happy-v587 in #1376
  • docs: refresh core concepts and work continuity by @chenncy in #1349
  • feat(cli): add interactive PowerContext config init by @happy-v587 in #1367
  • test: focus coverage on observable behavior by @PsiACE in #1375
  • fix(server): keep successful Skill publication responses intact by @happy-v587 in #1377
  • docs: show all integrations in READMEs and default installs to master by @happy-v587 in #1382
  • fix: pass embedding dimension to provider and surface sqlite-vec probe failures by @happy-v587 in #1386
  • docs: improve installation, deployment, and API guides by @Teingi in #1374
  • docs: fix installation and API guidance by @Teingi in #1390
  • fix(mcp): give Review write tools ToolAnnotations so hosts can prompt by @russell001209-ai in #1392
  • feat(tracing): trace scheduled Runtime processing (#1243) by @guozhihao-224 in #1245
  • chore(release): prepare v0.1.0 by @Teingi in #1404

New Contributors

Full Changelog: v0.0.2...powercontext-v0.1.0

Contributors

bowenliang123, AlexStocks, and 19 other contributors
Assets 4
Loading