python-sdk@0.1.9

feat(resources): support TOS auth args for HTTP imports (#4248)

* feat(resources): support source headers for HTTP imports

Allow HTTP(S) resource imports to pass request headers for authenticated object storage sources. Fetch authenticated sources into a request-scoped snapshot and keep credentials out of parser inputs and queued jobs.

Co-authored-by: TRAE CLI <noreply@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>

* fix(resources): reserve source headers from args

Treat source_headers as a top-level add_resource field so it is rejected from args and filtered consistently from queued processor inputs.

Co-authored-by: TRAE CLI <noreply@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>

* feat(resources): accept TOS auth through args

Replace generic source header passthrough with explicit tos_signature and tos_access args for HTTP TOS object imports. Keep credentials request-scoped and out of parser and queue payloads.

Co-authored-by: TRAE CLI <noreply@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>

* refactor(resources): name transient TOS args

Centralize TOS credentials that are accepted from args but excluded from durable resource jobs.

Co-authored-by: TRAE CLI <noreply@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>

---------

Co-authored-by: TRAE CLI <noreply@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>

v0.4.16

OpenViking v0.4.16

OpenViking v0.4.16 重点增强了 Agent、Memory 与资源导入能力，同时补强 URI 处理、文件系统行为和运行可观测性。本次版本新增 VikingBot 远程 Skills、用户级 Memory 提取策略、更加快速且可持久化的异步资源导入、面向当前调用方的 viking://~ URI 简写，以及适用于长时间运行 Agent 的 Context Compilation 工作流。

版本亮点

• VikingBot 支持更丰富、更长程的 Agent 工作流：VikingBot 现在可以发现、缓存并使用远端 OpenViking 中托管的 Skills。Context Compilation 也新增了源素材实体化、读取链路追踪，以及 LLM Wiki、知识图谱、日报和知识蒸馏等可复用工作流。(#4095, #4059)
• 按用户控制 Memory 提取策略：管理员可以为每个用户配置 memory_policy，精确限定可提取的 Memory 类型。对于未显式携带策略的既有 Session，新策略会在后续 commit 时生效。(#4126)
• 资源导入更快、更可观测：add-resource 使用 wait=false 时，源数据准备会转移到可持久化的后台任务中，降低请求延迟，同时保留任务归属和可靠性。上传任务新增 Context 数量和排队阶段统计；VectorDB 返回 4xx 时，错误也会正确返回给调用方。(#4100, #4097, #4118, #4160)
• 用户路径更简洁，URI 处理更可靠：新增 viking://~，可表示当前调用方的用户根目录。服务端入口现在会统一规范化并校验 Viking URI，同时补齐管理员场景下的 current-user URI 展开。(#4167, #4048, #4145)
• 元数据与集成体验持续优化：语义 L0/L1 sidecar 统一以受保护的 OKF 元数据形式管理；CLI 初始化向导新增 VolcEngine/BytePlus 套餐档位与自定义交互配置；DSH 可经由共享 stdio MCP Proxy 暴露工具。(#4092, #4101, #4157)

详细变更

VikingBot、Skills 与 Agent 工作流

• VikingBot 新增远端 OpenViking Skill 的发现、缓存与执行支持。(#4095)
• Context Compilation 支持更适合长时间运行 Agent 的工作流：包括源素材实体化、读取追踪及配套的编译方案文档。(#4059)
• 新增 DSH Memory Plugin，并将 DSH 工具服务迁移至共享 stdio MCP Proxy。(#4157)
• 修复 VikingBot 在 Windows 上的 Session 路径可移植性问题。(#4162)
• 更新 DSH 对当前 Release Candidate peer 的兼容性。(#4169)

Memory、元数据与检索

• 新增用户级 Memory 提取策略，提供管理员读取/更新接口和服务端默认策略。(#4126)
• 提升跨 Session Memory 更新与部分删除的可靠性，并统一 Entity URI 的大小写规范。(#4121, #4070)
• L0/L1 语义 sidecar 调整为受保护的 OKF 内容，优化元数据处理和写入保护。(#4092)
• 在属性标签和检索结果返回前过滤非法 tags。(#4123, #4153)
• SDK 暴露 tree level limit 参数。(#4110)

资源、连接器与存储

• 通过把源数据准备放入可持久化的任务链路，降低 wait=false 资源导入的请求延迟。(#4100)
• 资源任务新增 Context 数量以及排队上传阶段的统计信息。(#4097, #4118)
• 新增 TOS 资源连接器参数；将 TOS NotFound 视为 S3 对象不存在；恢复对旧版飞书文档导入的支持。(#4129, #4165, #4130)
• 修复 add-resource 在 VectorDB 返回 4xx 时吞掉错误的问题。(#4160)
• 修复文件/目录递归删除语义，并确保删除账号时同步删除其持久化文件系统数据。(#4181, #4125)
• 当 RAGFS 缺少 pathlock manager 时返回配置错误，而非触发 panic。(#4083)

URI、MCP、CLI 与 Studio

• 新增当前调用方用户根目录别名 viking://~，并在服务端入口统一规范化请求 URI。(#4167, #4048)
• 管理员请求中，current-user URI 别名可被正确展开。(#4145)
• MCP 读取文件时会保留并返回底层文件系统错误。(#4093)
• CLI 初始化向导新增 VolcEngine/BytePlus 套餐档位与自定义交互配置。(#4101)
• Web Studio 现在会遵守 Task API 限制，并在请求日志中显示错误详情。(#4148, #4172)
• 修复 LiteLLM 异步 Embedding 向量未按预期长度截断的问题。(#4146)

文档

• 新增跨集成能力参考页，并更新 Hermes、Agent 模板、Benchmark 和 GitHub 引流链接相关文档。(#4076, #4098, #4152, #4183, #4155)

升级提示

• Resource Relations 已移除。 实验性的 Resource Relation REST API、CLI 命令及关联文档均不再提供。若当前使用 /api/v1/relations，或使用 ov relations、ov link、ov unlink，请在升级前删除或替换相关集成。(#3956)
• viking://~ 是基于已认证调用方解析的便捷别名；既有规范 URI（如 viking://user/...）仍保持可用。
• 管理用户的提取策略可调用 GET 或 PATCH /api/v1/admin/accounts/{account_id}/users/{user_id}/settings。将 memory_policy 显式设为 null，即可清除持久化的用户覆盖策略并恢复继承默认配置。

新贡献者

• @HaningZS 首次参与贡献：#4110
• @stone16 首次参与贡献：#4070

完整变更：v0.4.15...v0.4.16

What's Changed

• fix(mcp): return read errors from underlying fs by @sponge225 in #4093
• docs(hermes): recommend memory setup openviking by @ZaynJarvis in #4098
• docs: add a cross-integration capability reference page by @t0saki in #4076
• feat(vikingbot): support OpenViking remote skills by @yeshion23333 in #4095
• feat: refine OKF sidecar metadata handling and write protection by @MaojiaSheng in #4092
• perf(resource): speed up wait=false add-resource by @qin-ctx in #4100
• feat(cli): add VolcEngine/BytePlus plan tiers and interactive custom setup to init wizard by @t0saki in #4101
• feat(resources): expose context count in upload tasks by @ehz0ah in #4097
• fix(sdk): expose tree level limit by @HaningZS in #4110
• fix(ragfs): return config error instead of panicking when pathlock manager is missing by @wutongyuonce in #4083
• feat: add user-scoped memory extraction policies by @heaoxiang-ai in #3906
• Revert "feat: add user-scoped memory extraction policies" by @heaoxiang-ai in #4122
• fix(resource): collect stats for queued uploads by @ehz0ah in #4118
• fix: delete account remain data in filesystem by @baojun-zhang in #4125
• refactor: remove resource relation edges by @sponge225 in #3956
• fix(uri): server 入口校验并补全 URI，内部只用规范 URI by @qin-ctx in #4048
• fix(feishu): support legacy doc imports by @qin-ctx in #4130
• fix(memory): canonicalize entity URI casing by @stone16 in #4070
• fix(memory): make cross-session updates and partial deletions reliable by @fujiajie666 in #4121
• Fix/filter invalid attr tags by @zhoujh01 in #4123
• fix(uri): expand current-user URIs for admins by @qin-ptr in #4145
• fix(embedding): truncate LiteLLM async vectors by @AaronZ345 in #4146
• docs: tag GitHub referrals with UTM by @ZaynJarvis in #4155
• docs: use connect agent template tokens by @ManAsWind in #4152
• fix(storage): 修复 ov add-resource在向量库返回4xx时吞异常问题 by @chuanbao666 in #4160
• feat(dsh): serve tools over the shared stdio MCP proxy by @t0saki in #4157
• fix(web-studio): respect task API limits by @ehz0ah in #4148
• feat(compile): improve source materialization and long-running agent loops by @fujiajie666 in #4059
• feat: restore user-scoped memory extraction policies by @heaoxiang-ai in #4126
• fix: treat TOS NotFound as missing S3 object by @MDNDDD in #4165
• feat(uri): add viking://~ home alias for the caller's user root by @t0saki in #4167
• fix(dsh): support current release candidate peers by @ZaynJarvis in #4169
• feat: new tos connector args by @zihengli-bytedance in #4129
• feat(studio): show error details in request logs by @ehz0ah in #4172
• fix(storage): fix recursive flag for file/dir delete by @baojun-zhang in http...

v0.4.15

OpenViking v0.4.14 使用未锁定版本的 xxhash 依赖。全新安装或更新依赖时，如果安装到 xxhash 4.x，本地 VectorDB 和 cuVS 后端可能无法写入新生成的向量。

该异常在写入链路中没有正确返回给用户，可能表现为任务已经完成、原始内容也已保存，但对应向量实际没有落库，导致后续检索或自动召回找不到相关内容。

如果受影响期间已经出现内容无法召回的情况，需要重新触发对应内容的向量构建。

修复详情：PR #3995

OpenViking v0.4.14 declared an unbounded xxhash dependency. A fresh installation or dependency update could therefore install xxhash 4.x, causing newly generated vectors to fail to persist when using the local VectorDB or cuVS backend.

The error was not correctly propagated through the write pipeline. As a result, a task could appear to complete and the source content could remain available, while its vector was never stored. Subsequent vector searches or automatic recall could then miss that content.

v0.4.14

OpenViking v0.4.14 Release Notes / 发布说明

Release date / 发布日期: 2026-08-17

Full Changelog / 完整变更记录: [v0.4.13...v0.4.14](v0.4.13...v0.4.14)

This release contains 82 commits. / 本版本包含 82 个提交。

---

中文

版本概览

v0.4.14 让 viking:// 更接近 Agent 可直接使用的工作区：MCP 新增目录树浏览、文本写入和精确编辑，资源导入扩展到固定 Git commit、私有仓库、飞书云盘目录与文件，Session 则获得事件标签和可更新的自动提交策略。

本版本也收敛了客户端和记忆架构。Python 调用统一迁移到 HTTP SDK，记忆抽取统一使用 V3，Qdrant 和 openGauss 向量后端被移除。升级前请重点阅读“升级与兼容性”。

主要更新

• Agent 可直接读写 viking://：MCP 新增 tree、write 和 edit。write 支持创建、覆盖和追加，edit 执行精确字符串替换并在匹配不明确时保持文件不变；wait=true 可等待语义和向量索引刷新。当前用户还可以使用 viking://user/... 短路径保存普通文本文件。
• 可移植 Agent Plugins 1.0 包：新增 agent-plugins/，包含标准清单、零 npm 运行时依赖的 stdio-to-HTTP MCP 代理和 openviking-memory Skill。它适用于遵循 Agent Plugins 1.0、但没有专属 hooks 集成的客户端；自动会话捕获和 prompt 前自动召回不在该规范范围内。
• DeepSeek Harness 新插件：新增 @openviking/dsh-memory-plugin，提供自动召回、Session 捕获、失败写入重放、viking:// 路径保护和模型可调用的记忆工具。插件使用 DSH 原生 tool/message 构造器，并严格适配 @deepseek-ai/dsh 0.1.0-rc.6。
• DeerFlow 与 TRAE 集成：DeerFlow 新增 MemoryManager 和 MCP 两种接入指南，前者负责自动写入、召回和注入，后者负责 Agent 主动检索与管理，建议同时启用。TRAE/TRAE CN 的 Hook + MCP 集成覆盖自动召回、逐轮捕获和短会话 commit，本版本还会在 commit 日志中保留 trace_id。OpenCode 同时新增仅 Hooks 模式。
• 资源导入与同步增强：OpenViking Assets 支持固定的 40 位 Git commit、显式 to 目标和 HTTPS 私有仓库凭据；普通 add_resource 和 Watch 也支持私有 Git 鉴权。飞书/Lark 导入新增 Drive 文件与递归目录支持。Web Studio 补齐远程资源选项和 Watch 的查看、编辑、暂停、恢复、触发与历史流程。
• Session 与 Memory 能力收敛：记忆抽取统一走 V3。Session 可在创建时设置事件记忆默认标签，之后通过配置接口更新，并在单次 commit 时覆盖或清空；自动提交策略也可动态更新或禁用。配置 experiences 会一起启用 cases 和 trajectories，且只有实际产生 case 时才继续生成 Agent Evolution 派生记忆。
• 检索标签与 Agent Evolution 查询：reindex 可用 replace 或 append 模式更新本次成功重建记录的标签。Experience 的 Trajectory 列表和结果分布接口新增 UTC 日期范围过滤。
• Studio 与管理体验：Web Studio 新增账号删除流程、按作用域分组的 Skill 视图，并改进资源导入和定时同步管理；删除用户时会立即撤销身份，再由持久队列清理用户数据。

新功能用法

DeepSeek Harness（DSH）记忆插件

前置要求：@deepseek-ai/dsh 必须使用精确版本 0.1.0-rc.6，Node.js 使用 ^22.19.0 或 >=24，并准备一个可访问的 OpenViking Server。

export OPENVIKING_URL=http://127.0.0.1:1933
export OPENVIKING_API_KEY=your-api-key

dsh plugin --profile default add @openviking/dsh-memory-plugin
dsh --profile default --dump-config

需要注意：

• 插件在 agent/pre-step 注入带来源的 user message，而不是修改 system prompt，因此在 persona.complete: true 的 preset 下也不会被静默丢弃。
• session/event 捕获消息，turn/end 达到阈值后 commit；可重试失败会进入 pending queue，在下次 Session 启动时重放。
• 设置 OPENVIKING_WORKSPACE_PEER=1 可按工作区派生 actor peer；OPENVIKING_RECALL_PEER_SCOPE=actor 可限制只召回当前工作区记忆。
• 插件暴露 viking_search、viking_read、viking_browse、viking_remember、viking_add_resource 等工具。viking_forget 会永久删除数据，只应在用户明确要求时调用。

DeerFlow：MemoryManager + MCP

DeerFlow 的两个入口职责不同，建议同时配置：

• MemoryManager：自动把对话写入 OpenViking，在模型调用前召回并注入记忆。
• MCP：让 Agent 按需调用 search、read、write、edit 等工具；只配置 MCP 不会自动写入或自动召回。

在 DeerFlow 项目根目录的 .env 中配置 USER API Key：

OPENVIKING_API_KEY=your-api-key

将 config.yaml 的 memory 段切换到 OpenViking：

memory:
  enabled: true
  injection_enabled: true
  shutdown_flush_timeout_seconds: 30
  manager_class: openviking
  mode: middleware
  backend_config:
    base_url: https://openviking.example.com
    owner_user_id: default
    api_key_env: OPENVIKING_API_KEY
    startup_policy: fail_fast
    failure_policy:
      read: fail_open
      write: log_and_drop

复制并编辑 extensions_config.json，启用 OpenViking MCP：

cp extensions_config.example.json extensions_config.json

{
  "mcpServers": {
    "openviking": {
      "enabled": true,
      "type": "http",
      "url": "https://openviking.example.com/mcp",
      "headers": {"X-API-Key": "$OPENVIKING_API_KEY"}
    }
  }
}

保存后运行 make dev 重启 DeerFlow。read: fail_open 表示召回失败时主 Agent 仍会继续回答；write: log_and_drop 表示写入失败只记录日志，不会自动补写。OpenViking 的摘要与记忆抽取是异步任务，消息写入成功后不会立即出现长期记忆。

TRAE / TRAE CN 记忆集成

前置要求：macOS 或 Linux、Node.js 18+，以及支持 SessionStart、UserPromptSubmit、PreToolUse、Stop Hook 的 TRAE/TRAE CN 版本。

# 同时安装 TRAE 和 TRAE CN
bash <(curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/memory-plugin-shared/install.sh) \
  --harness trae,trae-cn

安装器询问连接方式时，火山引擎云服务用户选择“火山引擎 OpenViking 云服务”；只有本机已运行 OpenViking Server 时才选择“自建 / 本地”。安装完成后必须彻底退出并重启 TRAE/TRAE CN，再新建 Agent Session。

集成通过 SessionStart 加载画像和项目记忆，通过 UserPromptSubmit 自动召回，通过 Stop 捕获并立即 commit 当前轮次，因此短会话也能进入记忆抽取。MCP 同时提供主动检索和管理工具。v0.4.14 会在 commit 日志中输出 trace_id，失败时可设置 OPENVIKING_DEBUG=1 并检查：

• TRAE：~/.openviking/logs/trae-hooks.log
• TRAE CN：~/.openviking/logs/trae-cn-hooks.log

如果 GitHub 无法访问，可将安装命令替换为 TOS 镜像，并追加 --dist tos：

bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) \
  --harness trae,trae-cn --dist tos

没有 Hooks 的 Agent Plugins 1.0 客户端

让兼容客户端加载仓库中的 agent-plugins/ 目录即可获得 OpenViking MCP 和 openviking-memory Skill。该包依赖模型主动执行召回与沉淀；如果客户端支持专属 Hooks，应优先使用对应集成，以获得自动捕获和 prompt 前自动召回。

升级与兼容性

• Python 嵌入式客户端已移除：OpenViking、SyncOpenViking、AsyncOpenViking、LocalClient 及对应嵌入式实现不再导出。服务端安装 openviking 并独立运行；只需要连接现有服务的应用可单独安装 openviking-sdk

• MinerU 接口切换到官方协议：mineru_endpoint 现在是 base URL，OpenViking 调用 POST {endpoint}/file_parse；mineru_params 改为 mineru_bodys，mineru_api_key 已移除。strategy="mineru" 会在服务初始化时强制检查 {endpoint}/health；strategy="auto" 检查失败时记录警告，并保留本地解析优先的回退行为。

• Memory V3 成为唯一抽取链路：memory.version 已废弃并被忽略，配置值不会再选择 V2；memory.v2_lock_retry_interval_seconds 和 memory.v2_lock_max_retries 不再受支持。SessionCommit worker 默认并发从 4 调整为 8。

体验与可靠性改进

• 语义向量化任务改为流式调度，并延迟加载完整 embedding 内容；父目录语义刷新保持异步，降低大批量入库时的内存和队列压力。
• PathLock 在高竞争时退避重试，并增强 lease handoff、保活和 adopt capability 轮换，减少长任务误失锁。
• Session 后续归档不再占用 worker 等待前序归档；记忆 patch 移出事件循环，V3 link 更新扩大锁覆盖并报告真实失败的 patch block。
• MCP Streamable HTTP 改为无状态模式，避免多实例、负载均衡部署中出现间歇性 Session not found。
• VikingBot compile 在运行超时或迭代上限时尽量保留工作区中的部分产物，并增加运行时 deadline 与输出限制保护。

修复

• Markdown YAML frontmatter 默认不再从最终正文中静默丢失；强制拆分的 Markdown chunk 保持在 token 预算内，标题锚点与 GitHub 标点处理一致。
• 超大图片在送入 VLM 或多模态 Embedding 前临时缩放，AGFS 中保存的原始图片不变。
• L1 overview 现在能进入 Rerank 输入；首次 Session 检索会被正确记录，空检索不再被健康检查误判为故障。
• OVPack 账号恢复不再删除目标端独有数据；目录移动会完整枚举条目，LocalFS 的 ENOENT 会正确映射为 NotFound，零字节文件不会被误判为缺失索引。
• Session JSONL 只按换行符拆分，不再把 Unicode 行分隔符当作记录边界；assistant-only event range 会保留正确 owner。
• Stats、Debug 和 Session 的错误响应现在返回与错误码一致的 HTTP 状态；VikingDB 日期范围会统一规范化，非法写入标签会被丢弃。

文档、测试与安全

• 新增 Agent Plugins、DSH、DeerFlow、OpenViking Assets、MCP 写入工具、Session 标签和 Agent Evolution 日期过滤文档，并同步中英文 API/配置示例。
• Agent Plugins 包加入规范一致性测试；DSH 插件覆盖注册结构、捕获、离线队列与可选真实服务召回测试。
• 私有 Git token 仅允许用于 HTTPS，并与仓库 URL 绑定保存在 Watch 私有状态中，不进入普通队列或 Watch API 输出。未启用 VikingFS 加密时，该服务端控制文件仍包含明文 token 状态。
• Watch 刷新补齐鉴权校验，服务端 API key 只读副本可通过 store watcher 刷新；过期持久化任务会被清理。

---

English

Overview

v0.4.14 makes viking:// a more complete agent workspace. MCP can now browse trees, write text, and apply exact edits; resource ingestion supports pinned Git commits, private repositories, and Feishu Drive folders and files; Sessions gain event tags and mutable auto-commit policies.

The release also consolidates the client and memory architecture. Python consumers move to the HTTP SDK, memory extraction always uses V3, and the Qdrant and openGauss vector backends have been removed. Review the upgrade notes before deploying.

Highlights

• Agent-writable viking:// workspace: MCP adds tree, write, and edit. Writes support create, replace, and append; exact edits leave the file unchanged when the match is missing or ambiguous. wait=true waits for semantic and vector index refreshes, and viking://user/... addresses the authenticated user's workspace.
• Portable Agent Plugins 1.0 package: the new agent-plugins/ package contains a standard manifest, a zero-runtime-dependency stdio-to-HTTP MCP proxy, and the openviking-memory Skill. It targets conforming clients without a dedicated hooks integration; the specification does not provide automatic session capture or pre-prompt recall.
• New DeepSeek Harness plugin: @openviking/dsh-memory-plugin adds automatic recall, Session capture, retryable-write replay, viking:// path protection, and model-callable memory tools. It uses native DSH tool/message constructors and is pinned to @deepseek-ai/dsh 0.1.0-rc.6.
• DeerFlow and TRAE integrations: DeerFlow gains both MemoryManager and MCP setup guides. MemoryManager provides automatic write, recall, and injection, while MCP provides agent-invoked search and management; using both is recommended. The TRAE/TRAE CN Hooks + MCP integration covers automatic recall, per-turn capture, and short-session commits, with commit trace_id values preserved in v0.4.14 logs. OpenCode also gains a hooks-only mode.
• Resource ingestion and synchronization: OpenViking Assets supports full pinned Git commit SHAs, explicit to targets, and private HTTPS Git credentials. Regular add_resource and Watch flows support private Git authentication as well. Feishu/Lark ingestion now accepts Drive files and recursive folders. Web Studio adds richer remote import options and complete Watch management flows.
• Unified Session and Memory behavior: memory extraction now has one V3 path. Sessions can define default event-memory tags, update them later, and override or clear them for one commit; auto-commit policies can also be updated or disabled. Selecting experiences enables cases and trajectories, and Agent Evolution derivatives run only when extraction actually produces a case.
• Search tags and Agent Evolution queries: reindex can replace or append tags on successfully rebuilt records. Experience trajectory and outc...

python-sdk@0.1.8: feat(plugins): add OpenViking memory integration for TRAE CLI (#4026)

* feat: add OpenViking memory integration for TRAE CLI

Add TRAE CLI lifecycle hooks and MCP proxy support, wire the integration into the shared installer, and cover idempotent install and uninstall behavior.

Co-authored-by: TRAE CLI <noreply@bytedance.com>

* fix(trae-cli): cover archive installs and hook payload aliases

* fix: keep TRAE CLI installation explicit

Leave TRAE Desktop detection unchanged and avoid auto-selecting TRAE CLI. TRAE CLI remains available through an explicit harness selection or --harness trae-cli.

Co-authored-by: TRAE CLI <noreply@bytedance.com>

* fix(trae-cli): auto-select installed CLI commands

Detect traecli and traex only when they are available in PATH, then mark and select the TRAE CLI harness automatically.

---------

Co-authored-by: “bianhaonan” <“bianhaonan@bytedance.com”>
Co-authored-by: TRAE CLI <noreply@bytedance.com>

cli@0.4.14: feat(plugins): add OpenViking memory integration for TRAE CLI (#4026)

* feat: add OpenViking memory integration for TRAE CLI

Add TRAE CLI lifecycle hooks and MCP proxy support, wire the integration into the shared installer, and cover idempotent install and uninstall behavior.

Co-authored-by: TRAE CLI <noreply@bytedance.com>

* fix(trae-cli): cover archive installs and hook payload aliases

* fix: keep TRAE CLI installation explicit

Leave TRAE Desktop detection unchanged and avoid auto-selecting TRAE CLI. TRAE CLI remains available through an explicit harness selection or --harness trae-cli.

Co-authored-by: TRAE CLI <noreply@bytedance.com>

* fix(trae-cli): auto-select installed CLI commands

Detect traecli and traex only when they are available in PATH, then mark and select the TRAE CLI harness automatically.

---------

Co-authored-by: “bianhaonan” <“bianhaonan@bytedance.com”>
Co-authored-by: TRAE CLI <noreply@bytedance.com>

python-sdk@0.1.7

feat(pathlock): adjust pathlock config  (#3854)

v0.4.13

OpenViking v0.4.13

OpenViking v0.4.13 重点增强了企业部署、服务端检索上下文组装、资源处理、Session 自动提交和 Agent Memory 生态。本次版本新增 OIDC/LDAP 认证与 Redis QueueFS，支持在服务端直接生成可注入的 recall context；资源导入可选择保留完整文档或跳过语义理解阶段，音视频也可通过火山方舟完成多模态理解。同时，Session、Memory Plugin、TaskTracker 和后台队列的故障恢复与并发能力得到系统性加强。

版本亮点

• 企业级认证与分布式部署：新增 OIDC、LDAP 认证，QueueFS 支持 Redis 单机、Cluster 和 Sentinel；同时补充只读副本 watch 开关、HTTP keep-alive 配置和 Redis 启动恢复机制。
• 服务端组装 Recall Context：/search 新增 mode="context"，可在服务端完成配额检索、token 预算、层级降级、跨轮去重和可选摘要，客户端不再需要自行拼装上下文。
• 更灵活的资源与内容处理：资源导入新增 args.parse_mode=no_split；资源导入和内容写入新增 processing_mode，可选择完整语义处理或仅生成向量。
• 音视频多模态理解：新增基于火山方舟的音视频理解后端，支持长音视频上传、轮询、结果缓存以及音视频摘要生成。
• Session Auto Commit v2：支持按 token 数、消息数和空闲时间自动提交，并提供 session 级策略；部分 capture、commit 重试和后台失败恢复更加可靠。
• Agent Evolution 持续增强：补充经验来源、轨迹 lineage、结果聚合和 snapshot refinement，并为 OpenClaw 新增 Experience Memory 工具。
• 集成生态升级：LangChain/LangGraph 集成拆分为独立的 langchain-openviking 包；新增 ZCode Memory Plugin，并改进 OpenClaw、Claude Code 等插件的发布与可靠性。

详细变更

检索与上下文组装

• /search 新增 mode="context"：服务端统一执行 recall planning、分类配额、token budget、detail tier 降级、跨轮去重和可选 LLM digest，直接返回可注入模型的上下文块；原有 mode="list" 仍是默认行为。(#3534)
• 修复 context assembly 的 tier ceiling 与冷却逻辑：候选不会超过请求的详情档位，未真正提供给模型的 recall 也不会被错误计入 cooldown。(#3746)
• find / search 结果现在返回显式 tags，并移除空的可选字段，方便调用方直接使用检索标签与 provenance。(#3730)
• 修复 attrs/tag 读取范围，按精确 URI 和 level 获取元数据，避免同路径或不同层级之间串读。(#3707)
• VectorDB 随机召回统一改为客户端生成随机查询向量，减少不同后端实现差异。(#3706)

资源导入、内容写入与多模态

• 资源导入新增 args.parse_mode=no_split。PDF、Word、PowerPoint、HTML 等仍会经过正常解析并转换为 Markdown，但每个源文档可保留为单一正文，不再按标题、段落或长度拆分。该选项只改变存储布局，不改变 embedding 内部分块。(#3645)

• 资源导入与内容写入新增 processing_mode：

  • semantic_and_vectors：默认模式，生成或刷新 .abstract.md、.overview.md 和向量；
  • vectors_only：跳过 VLM 语义理解与摘要，只向量化当前文件，并保留已有语义产物。

  Python SDK、TypeScript SDK、CLI 和 HTTP API 均已支持。(#3615)

• 新增基于火山方舟的音视频多模态理解，支持媒体上传、异步任务轮询、结果缓存、超时控制以及音频/视频摘要模板。(#3563)

• 同步资源导入现在会保留并返回真实处理错误，不再被后续状态处理覆盖，调用方可以准确感知解析或入库失败。(#3698)

• ExternalParse 队列 worker 并发数可通过 queue_workers.external_parse.max_concurrent 配置，默认值为 4，修改后需重启服务。(#3710)

Session、Memory 与 Agent Evolution

• Session Auto Commit v2 支持 session 级 auto_commit_policy，可按 pending token、消息数量、空闲时间、最近保留消息数和最小提交间隔触发自动 commit；服务端可通过 memory.session_auto_commit 控制默认启用和 idle scheduler。(#3736)
• Session capture 中断后可从部分状态恢复，插件 pending queue 也能识别更多可重试错误，降低进程退出或短暂网络故障造成的消息丢失。(#3820)
• 修复 Claude Code Memory Plugin 在 commit 重试时丢失原始 payload 的问题。(#3822)
• Claude Code Memory Plugin 的 recall 统计改为按实际召回的 memory URI 计数。(#3821)
• Agent Evolution 增强 provenance、历史记录和 account 级设置，并改进 experience snapshot 的来源保留。(#3695)
• 新增 experience trajectory lineage，记录经验与原始轨迹之间的关联，并提供对应 API 与向量元数据支持。(#3727)
• Experience outcome 支持聚合，snapshot refinement 会结合 lineage 与历史结果生成更稳定的经验版本。(#3742)
• OpenClaw 插件新增 Experience Memory tools 和配套 skill，可查询、读取和使用 OpenViking 中的经验记忆。(#3827)

企业认证、QueueFS 与服务稳定性

• 新增 OIDC 和 LDAP 认证模式，可对接 Okta、Auth0、Keycloak、Azure AD、Windows AD、OpenLDAP 等身份源，并支持 claim/attribute 到 account、user、role 的映射。CLI 同步支持 LDAP 凭据。(#3708)
• QueueFS 新增 Redis backend，支持 standalone、Cluster 和 Sentinel，适用于多实例共享队列部署。(#3741)
• Redis QueueFS 在启动后立即、30 秒和 60 秒执行有界 stale-recovery sweep，以覆盖容器重启后的 heartbeat 过期窗口，同时避免长期后台扫描。(#3748)
• 新增 enable_watch_scheduler 开关；共享 writer 数据的只读副本可关闭 watch scheduler，避免重复刷新资源。默认值保持 true。(#3704)
• 新增 server.timeout_keep_alive，用于配置 HTTP 空闲 keep-alive 超时，默认 5 秒。(#3743)
• 重构 TaskTracker 并发控制，移除全局异步锁瓶颈，按更细粒度协调任务状态与持久化。(#3829)
• RAGFS 增加结构化 lock tracing 日志，便于排查锁等待、竞争、过期与释放链路。(#3693)
• VectorDB 新增 text field type，用于存储超出普通字符串字段限制的大文本。(#3725)
• 加固内容可见性、请求 body 日志脱敏、后台 semantic/embedding 失败传播和 session phase-2 replay，减少隐私泄露与静默失败。(#3548)

LangChain、VikingBot 与 Memory Plugin

• LangChain/LangGraph 集成已拆分为独立的 langchain-openviking 包。Retriever、Tools、Message History、Context Wrapper、Store 和 Middleware 可通过轻量 openviking-sdk 访问远端服务；原 openviking.integrations.langchain 路径保留兼容 shim。(#3685)
• 主 openviking 服务端包不再强制携带 LangChain 客户端依赖，进一步缩小服务镜像和依赖边界。(#3711)
• 新增 ZCode Memory Plugin，支持会话 capture、自动 recall、MCP proxy 和共享 pending queue。(#3678)
• 加固 ZCode capture 时序、异步写入和 marketplace staging，降低 hook 事件遗漏与发布包不完整的风险。(#3728)
• VikingBot 的 OpenAI 兼容 VLM 和 credential provider 支持流式输出，并正确处理流式 usage 与 tool-call 增量。(#3696)
• 修正 OpenClaw 插件 apiKey 的构建期类型，避免 release build 失败。(#3832)
• OpenClaw 插件合入 main 后可由 CI 自动构建并发布。(#3836)
• 为通过 OpenClaw/ArkClaw 应用市场安全扫描，打包版插件不再支持 {source:"exec"} 的 SecretRef；继续支持纯字符串、环境变量和文件来源。(#3849)

其他修复

• 修复 Web Studio terminal panel 因缺少 history icon 导致的崩溃。(#3735)
• 修复 compile 流程中的 pickle 错误，并合并 skill_name 相关调整。(#3738)
• 修正 overview 生成中的语言处理问题。(#3747)
• 更新项目微信群二维码。(#3819)

升级提示

• 本版本整体保持向后兼容：search 默认仍为 mode="list"，资源与内容处理默认仍为 semantic_and_vectors，资源解析默认仍会按原规则拆分。
• 如需使用 OIDC/LDAP，请安装可选依赖：uv pip install "openviking[auth]"。现有 dev、api_key 和 trusted 模式不需要迁移。
• Session Auto Commit 默认不会自动开启。可在创建 session 时显式传入 auto_commit_policy，或设置 memory.session_auto_commit.default_enabled=true。Session policy 创建后不可修改。
• search(mode="context") 当前不支持 target_uri，传入时返回 HTTP 400；level 由 context 模式下的 detail 档位取代。
• 使用多实例 Redis QueueFS 时，请按 storage.agfs.queuefs 配置 backend 和 Redis 模式；现有 SQLite QueueFS 仍是默认值，无需迁移。
• 通过 OpenClaw 应用市场安装的插件不再执行 SecretRef exec。请改用 {source:"env"}、{source:"file"}，或在启动 OpenClaw 前把 secret manager 的输出注入环境变量。
• LangChain 用户可以安装 langchain-openviking；旧导入路径暂时保持兼容，但新项目建议直接使用独立包。

新贡献者

感谢 @TeFuirnever 首次参与 OpenViking，并贡献 ZCode Memory Plugin：#3678。

完整变更

v0.4.12...v0.4.13

What's Changed

• refactor(langchain): extract standalone integration package by @ehz0ah in #3685
• feat(bot): support streaming for OpenAI and VLM credentials by @yeshion23333 in #3696
• fix(resource): preserve synchronous ingestion errors by @qin-ctx in #3698
• feat(ragfs): add structured lock tracing logs by @baojun-zhang in #3693
• fix(core): harden privacy and background failure handling by @ehz0ah in #3548
• feat: 支持基于火山方舟的音视频多模态理解 by @Hao-Yu-la in #3563
• refactor(vectordb): unify random recall via client-generated vector by @zhoujh01 in #3706
• feat(config): add enable_watch_scheduler toggle for read-only replicas by @fengluodb in #3704
• fix(server): read attrs tags by exact URI and level by @zhoujh01 in #3707
• feat(agent-evolution): improve provenance, history, and account settings by @heaoxiang-ai in #3695
• fix(packaging): decouple LangChain client from server image by @t0saki in #3711
• feat(vectordb): add text field type for large strings by @zhoujh01 in #3725
• feat(integrations): add ZCode memory plugin by @TeFuirnever in #3678
• feat(queue): make ExternalParse worker concurrency configurable by @KCHENPENGFEI in #3710
• fix(zcode): make memory capture reliable by @t0saki in #3728
• feat(search): expose tags in find/search results and drop empty fields by @zhoujh01 in #3730
• feat(agent-evolution): track experience trajectory lineage by @heaoxiang-ai in #3727
• Fix Web Stu...

python-sdk@0.1.6

feat(bot): support OpenAI and credential streaming (#3696)

cli@0.4.12

feat(bot): support OpenAI and credential streaming (#3696)