Skip to content

PowerContext v1.5.2

Latest

Choose a tag to compare

@hidb4ai hidb4ai released this 16 Nov 10:49
· 62 commits to master since this release
ad0d020

PowerContext v1.5.2

Not only memory, but a full story.

English

PowerContext v1.5.2 makes Agent long-term memory more efficient, transparent, and easier to use. This release improves single-Server performance, introduces native Dashboard observability, expands Desktop and plugin capabilities, improves Gateway request lifecycle handling, and makes cross-tool handoffs more reliable. It also strengthens privacy, write confirmation, and protocol checks across Agent integrations.

More throughput with less CPU work

  • Improve write efficiency through batched writes and fewer database round trips.
  • Reuse query structures, optimize vector conversion, and reduce repeated computations on the Server.
  • Maintainer-provided release measurements report approximately 190% higher write throughput, 171% higher query throughput, and 64%–67% lower CPU cost than v1.5.1.

See batched writes, Scope-bounded SQLite FTS, and bounded related recall.

See processing progress directly in the Dashboard

  • Add native views for processing progress, failure diagnostics, Token usage, and runtime state.
  • Inspect saved Sources, generated Artifacts, Dream inputs and outputs, and read-only processing status to understand whether material has been processed and where work encountered a problem.
  • Preserve unknown save times for historical Sources without a recorded timestamp instead of inventing a historical value.

See Dashboard observability, processing views, and processing failure diagnostics.

Desktop: install, recover, and manage a local Server

  • Improve local Server installation, recovery, and management from Desktop.
  • Package independent Ops resources for local operations.
  • Add Linux systemd --user service integration.

Protocol checks and local setup support do not replace signed-installer or clean-machine platform acceptance. See local Server management, Ops resources, and Linux service integration.

Plugins: build capabilities around your own Artifacts

  • Load directory plugins that generate, render, search, and change their own Artifacts. Plugins can declare their own Source types and expose plugin APIs and sandboxed Dashboard pages.
  • Support per-plugin databases on OceanBase and seekdb through powercontext_plugin_<name>.
  • Forward a plugin's Artifact API through the Dashboard and limit Scope listing to that plugin's own readable Scopes.
  • Improve user-change evidence and consistency between writes and governance checks.

Hot reload, plugin data upgrades, plugin MCP tools, and standalone Source collection are not included. The new directory-plugin framework replaces the previous managed plugin surface; review the upgrade restrictions below before changing an existing deployment.

See directory plugins and plugin storage, access, and consistency.

Gateway: request deadlines, cancellation, and shutdown

  • Improve request deadlines, cancellation, and bounded shutdown.
  • Prevent Codex retries after deterministic withhold decisions.

Gateway remains alpha and buffers complete responses for inspection. These changes do not provide live token streaming. See request lifecycle handling and Codex retry handling.

More reliable handoffs across tools

  • Persist and recover DSH handoff deliveries, expose connection status and update checks, and embed the Dashboard in the sidebar.
  • Add the Claude Desktop Code handoff adapter. Native launch stays disabled by default until the receiving environment can be verified.
  • Offer optional PowerContext long-term memory for dsh-pet.

See DSH handoffs, handoff delivery service, Claude Desktop Code, and dsh-pet memory.

Safer capture and more reliable Memory processing

  • Strengthen privacy handling in DSH automatic recall and capture, request confirmation for OpenCode writes under default permissions, and detect Memory protocol mismatches across Hosts.
  • Improve Codex setup, preserve OpenClaw project bindings during capture, and checkpoint in-session auto-compaction.
  • Bound Topic Memory related history, preserve the healthy processing prefix before a failing or oversized look-ahead, and prevent concurrent head conflicts from consuming window attempts.
  • Keep Memory merges within the tag limit and allow portable Source exports to retain recorded absolute working directories.

See DSH privacy, OpenCode write confirmation, protocol checks, and Topic Memory retrieval.

Install and upgrade

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

Upgrade Server, SDK, CLI, and integrations together. Use powercontext-v1.5.2 for Agent integration refs and reopen Agent sessions after upgrading.

Compatibility changes:

  • The target database revision is v1_5_0_005. It removes the previous Artifact plugin-framework storage and adds nullable pc_artifacts.metadata. Immutable schema revision names retain their original numbering independently of the package version.
  • Databases retaining old plugin registrations or data have no supported in-place upgrade path. Migration refuses these databases. Unloading plugins, deleting plugin directories, or exporting archives does not clear retained framework records, even when no Artifacts were generated. Keep the database on the previous version until a supported migration is available. A separate fresh database can use v1.5.2, but this does not migrate old plugin data. Do not manually delete framework records to bypass the check.
  • The removed plugin surface includes /v1/admin/artifact-plugins/*, powercontext.artifact_plugins, and POWERCONTEXT_SERVER_ARTIFACT_PLUGINS_DIR. Use POWERCONTEXT_SERVER_PLUGINS_DIR for directory plugins.
  • Portable Artifact revision records use schema version 3; restoring version 2 records remains supported.
  • Update imports from powercontext.server.authz to powercontext.builtin.authz, from powercontext.cli.env_file to powercontext.env_file, and from powercontext.cli.inference_notice to powercontext.server.inference_notice.
  • powercontext.paths.default_scheduler_path has been removed. The scheduler_path argument is deprecated and ignored; passing a non-None value emits DeprecationWarning. Remove it from runtime construction calls.

For supported migration paths, stop writers, back up the complete database and configuration, inspect the migration plan, and restart only after full Server verification succeeds. Database upgrade support is limited to source-version, target-artifact, backend, and configuration combinations that pass full Server acceptance.

See the database migration guide, plugin guide, and package layering changes.


中文

PowerContext v1.5.2 让 Agent 的长期记忆更高效、更透明,也更易用。本次更新提升单 Server 的处理效率,新增 Dashboard 原生可观测性面板,完善 Desktop 与插件能力,完善 Gateway 请求生命周期管理,并增强跨工具交接的可靠性。同时加强 Agent 集成中的隐私保护、写入确认与协议检查。

提升吞吐,减少 CPU 开销

  • 通过批量写入和减少数据库往返,提升写入效率。
  • 复用查询结构,优化向量转换,减少 Server 内的重复计算。
  • 维护者提供的发布测量结果相比 v1.5.1,写入吞吐提升约 190%,查询吞吐提升约 171%,CPU 成本降低 64%–67%。

参见批量写入、按 Scope 限定的 SQLite FTS和有界相关召回。

在 Dashboard 中直接查看处理进度

  • 新增原生视图,集中展示处理进度、异常诊断、Token 用量和运行状态。
  • 查看已保存的 Source、生成的 Artifact、Dream 输入输出,以及只读处理状态,了解资料是否完成处理、任务在哪里遇到问题。
  • 历史 Source 未记录保存时间时保持未知,不推测或回填历史时间。

参见 Dashboard 可观测性、处理视图和 处理失败诊断。

Desktop:安装、恢复与管理本地 Server

  • 完善 Desktop 中的本地 Server 安装、恢复与管理。
  • 打包独立 Ops 资源,支持本地运维操作。
  • 新增 Linux systemd --user 服务集成。

协议检查与本地安装支持不替代签名安装包和各平台干净机器验收。参见本地 Server 管理、Ops 资源和 Linux 服务集成。

插件:围绕自身 Artifact 扩展业务能力

  • 支持从目录加载插件,由插件生成、展示、搜索和修改自身 Artifact。插件可声明自身 Source 类型,并提供插件 API 与沙箱化 Dashboard 页面。
  • 支持通过 powercontext_plugin_<name> 使用 OceanBase 与 seekdb 独立插件数据库。
  • 支持 Dashboard 转发插件自身的 Artifact API,Scope 列表仅包含该插件自身可读的 Scope。
  • 完善用户修改证据,以及写入与治理检查之间的一致性。

本次不包含热重载、插件数据升级、插件 MCP 工具和独立 Source 采集。新的目录插件框架替换旧的托管插件接口;升级既有部署前,请先阅读下方的升级限制。

参见目录插件和插件存储、访问与一致性。

Gateway:请求超时、取消与关闭

  • 完善请求超时、取消与有界关闭。
  • 避免 Codex 在确定性的响应扣留决定后继续重试。

Gateway 仍处于 alpha 阶段,并缓冲完整响应以完成检查。 这些变更不提供实时 Token 流式输出。参见请求生命周期管理和 Codex 重试处理。

更可靠的跨工具交接

  • DSH 支持交接投递的持久化与恢复,提供连接状态和更新检查,并在侧栏嵌入 Dashboard。
  • 新增 Claude Desktop Code 交接适配器。在能够验证接收环境前,原生启动默认保持禁用。
  • 为 dsh-pet 提供可选的 PowerContext 长期记忆能力。

参见 DSH 交接、交接投递服务、Claude Desktop Code和 dsh-pet 长期记忆。

更安全的采集与更可靠的记忆处理

  • 加强 DSH 自动召回与采集中的隐私保护,在 OpenCode 默认权限下要求写入确认,并检测跨 Host 的 Memory 协议不匹配。
  • 完善 Codex 安装,保留 OpenClaw 采集时的项目绑定,并为会话内自动压缩记录检查点。
  • 限制 Topic Memory 相关历史候选规模,在后续内容失败或过大时保留可正常处理的前缀,并避免并发版本冲突消耗窗口尝试次数。
  • 保证 Memory 合并不超过标签上限,支持导出记录了绝对工作目录的 Source。

参见 DSH 隐私保护、OpenCode 写入确认、协议检查和 Topic Memory 检索。

安装与升级

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

Server、SDK、CLI 与集成需协调升级。Agent 集成使用 powercontext-v1.5.2 引用,升级后重新打开 Agent 会话。

兼容性变化:

  • 目标数据库修订为 v1_5_0_005。 该修订移除旧 Artifact 插件框架存储,并新增可空的 pc_artifacts.metadata。不可变 schema revision 名称保留原始编号,与软件包版本号相互独立。
  • 仍保留旧插件登记或数据的数据库,目前没有受支持的原地升级路径。 迁移会拒绝这些数据库。卸载插件、删除插件目录或导出归档不会清除框架保留的记录,即使没有生成 Artifact 也是如此。请保留数据库并继续使用旧版本,等待受支持的迁移方案。可以使用独立的新数据库运行 v1.5.2,但这不会迁移旧插件数据。不要手工删除框架记录来绕过检查。
  • 移除的旧插件接口包括 /v1/admin/artifact-plugins/*、powercontext.artifact_plugins 和 POWERCONTEXT_SERVER_ARTIFACT_PLUGINS_DIR。目录插件改用 POWERCONTEXT_SERVER_PLUGINS_DIR。
  • 可移植 Artifact 修订记录使用 schema version 3,继续支持恢复 version 2 记录。
  • 将导入路径 powercontext.server.authz 改为 powercontext.builtin.authz,powercontext.cli.env_file 改为 powercontext.env_file,powercontext.cli.inference_notice 改为 powercontext.server.inference_notice。
  • powercontext.paths.default_scheduler_path 已移除。scheduler_path 参数已废弃且被忽略;传入非 None 值会发出 DeprecationWarning。请从运行时构造调用中移除该参数。

对于受支持的迁移路径,先停止写入,备份完整数据库与配置,检查迁移计划,并在完整 Server 验证成功后再重启。数据库升级支持仅限于通过完整 Server 验收的源版本、目标产物、后端与配置组合。

参见数据库迁移指南、插件指南和包分层调整。

完整变更


What's Changed

  • fix(release): publish tested tags from GitHub Actions by @hidb4ai in #2565
  • fix(zcode): tolerate slower requests and stabilize acceptance by @hidb4ai in #2571
  • fix(integrations): detect Memory protocol mismatches across hosts by @hidb4ai in #2495
  • feat(desktop): package and provision independent Ops resources by @knqiufan in #2503
  • test(pi): run the Pi extension against a real Server in CI by @Fengzdadi in #2531
  • docs(readme): fix tutorial count and make links resolvable outside GitHub by @AlexStocks in #2564
  • docs(agents): document the Rust gateway for agents and reviewers by @AlexStocks in #2574
  • ci: run native database acceptance nightly with reports by @Zxf-xufeng in #2526
  • fix(ci): restore harness startup and acceptance execution by @knqiufan in #2537
  • ci(docker): build images on ubuntu-24.04 by @hidb4ai in #2587
  • feat(desktop): implement local Server setup, recovery and management by @knqiufan in #2306
  • fix(topic-memory): keep the healthy prefix before a failing or oversized look-ahead by @Fengzdadi in #2530
  • perf(topic-memory): scope SQLite FTS writes and searches to per-Scope rowid ranges by @Fengzdadi in #2532
  • test(opencode): run OpenCode with the plugin against a real Server by @Fengzdadi in #2533
  • fix(opencode): ask before PowerContext writes under default permissions by @Fengzdadi in #2534
  • feat(dsh): add plugin UI and connection status by @knqiufan in #2569
  • fix(portability): export Sources that record absolute working directories by @ctxloop in #2572
  • test(desktop): verify the installed connection and Scope journey by @jackie-cqz in #2581
  • fix(service): read LaunchAgent metadata echoed by launchctl without padding by @AlexStocks in #2591
  • fix(migrations): recognize standalone seekdb in maintenance identity by @LUOSENGWA in #2585
  • feat(processing): add read-only artifact processing status inspection (part of #2130) by @guamiao in #2568
  • fix(gateway): prevent Codex retries on deterministic withholds by @Tech-Circle-48 in #2578
  • docs(blog): add competition judging post and refine E2E wording by @PsiACE in #2582
  • fix(dev): pin the interpreter for make install by @Claran309 in #2594
  • docs(blog): add power-system agent memory article by @beatenevo in #2588
  • feat(processing): classify Dream, Handoff, and Evidence processing failures with safe diagnostics (#2126) by @guamiao in #2539
  • feat(work): record structured task stop reasons by @beatenevo in #2580
  • feat(context-reuse): explain invalidation with bounded internal attribution by @jackie-cqz in #2586
  • feat(dsh): embed existing Dashboard in right sidebar by @knqiufan in #2589
  • fix(memory): keep merges within the tag limit by @Fengzdadi in #2596
  • fix(e2e): stop a Server thread whose startup missed its deadline by @Fengzdadi in #2599
  • test(opencode): assert the plugin's default ask in the service chain by @Fengzdadi in #2600
  • feat(evaluation): stratify LoCoMo-Plus summary scores by @guamiao in #2610
  • perf: batch Source capture and model usage writes by @hireview001 in #2567
  • fix(integrations): drop the Python adapters' trust notices from prompt context by @Fengzdadi in #2527
  • fix(topic-memory): stop head conflicts from spending window attempts by @Fengzdadi in #2597
  • fix(openclaw): capture prompts under the run's project binding by @Fengzdadi in #2601
  • fix(bub): recall with the user's text, not Bub's channel frame by @Fengzdadi in #2488
  • feat(dsh): persist and recover handoff deliveries by @knqiufan in #2603
  • feat(dsh): add opt-in long-term memory for dsh-pet by @knqiufan in #2608
  • feat(core): issue authorized target with before-send admission by @NeverENG in #2516
  • feat(dsh): check for PowerContext updates in the status panel by @knqiufan in #2614
  • fix(openclaw): checkpoint in-session auto-compaction by @Fengzdadi in #2622
  • fix(dsh): apply the shared prompt-privacy rule to automatic recall and capture by @Fengzdadi in #2625
  • docs(codex): explain approval of PowerContext MCP tools that change data by @Fengzdadi in #2627
  • docs(rfc): remove inaccessible internal requirement link from RFC 1614 by @AlexStocks in #2633
  • feat(desktop): add Linux systemd --user service integration by @CX33071 in #2471
  • evaluation(memory): attribute prepared-context budget outcomes and compare allocation offline by @zzstar101 in #2529
  • docs(rfc): propose plugin interfaces by @jasper-yl in #2549
  • feat(processing): diagnose Handoff and Prompt operation failures (#2126) by @guamiao in #2619
  • docs: add public-content rules for RFCs and all public text by @AlexStocks in #2634
  • feat(dashboard): add processing, runtime, and monitoring views by @happy-v587 in #2557
  • docs(rfc): propose plugin hot reload and plugin-defined APIs by @jasper-yl in #2579
  • perf(atomic-memory): bound related recall candidates in SQL to reduce peak memory and recall cost by @lizining1231 in #2449
  • refactor(integrations): generate the TypeScript transport copies from one source by @Fengzdadi in #2623
  • test(e2e): run real Codex with the PowerContext plugin against a Server in CI by @Fengzdadi in #2624
  • fix(codex): build the plugin environment during setup by @Fengzdadi in #2626
  • fix(desktop): remove a needless return that fails clippy on Linux by @Fengzdadi in #2640
  • fix(integrations): rebuild the Cindy and DSH pet bundles from current sources by @Fengzdadi in #2637
  • refactor!: restore package layering in src by @jackie-cqz in #2244
  • feat(gateway): enforce request deadlines, cancellation, and bounded shutdown by @MaoMengww in #2538
  • fix(topic-memory): bound related history candidates by @happy-v587 in #2632
  • feat(plugins): load directory plugins that generate, present, search, and change their own Artifacts by @jasper-yl in #2616
  • perf: reduce vector encoding and runtime verification overhead by @hireview001 in #2621
  • docs(rfc): align the plugin RFCs with the merged implementation and amend edit evidence and page access to Artifact APIs by @jasper-yl in #2659
  • fix(plugins): host Pipes, Scope API, user-change evidence and checks, page access to Artifacts, and storage on OceanBase and seekdb by @jasper-yl in #2660
  • test(e2e): rely on setup to build the Codex plugin environment by @Fengzdadi in #2646
  • fix(ci): cache and retry OpenAPI Generator downloads by @frf12 in #2671
  • docs(blog): refresh power-system and Harbor covers by @zhanghuidinah in #2663
  • chore(release): prepare PowerContext v1.5.2 by @hidb4ai in #2670

New Contributors

Full Changelog: powercontext-v1.5.1...powercontext-v1.5.2