# What changed in langchain-openviking

> 71 changes in langchain-openviking 0.4 to 0.5 from its official release notes, upgrade guides and advisories: 23 breaking, 1 deprecations, 34 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/pypi/langchain-openviking/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## langchain-openviking 0.5

### Fixes and other changes

- The LangChain integration's capture state typing is fixed. (0.5.0) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.5.0)

## langchain-openviking 0.4

### Breaking changes

- Each query now performs one global vector recall followed by one unified rerank; directory recursion and parent score propagation are removed, and thresholds apply after reranking. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- The gemini and gemini-async extras now require google-genai>=1.39.0. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Requests with explicitly invalid or expired API keys now receive an authentication error; requests without credentials still receive 200. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- This legacy setting is ignored; use memory.session_auto_commit.enabled instead. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Replaces default_enabled and idle_enabled; its default is false, so deployments using the old keys must set enabled: true to keep auto-commit on. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- This legacy setting is ignored; use memory.session_auto_commit.enabled instead. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Replaces scan_batch_size and scan_batch_pause_seconds, with a default of 2.0. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- The installer now installs the ov CLI by default using npm install -g @openviking/cli, which requires npm on the machine. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- A non-recursive semantic_and_vectors request for a semantic namespace now returns INVALID_ARGUMENT; target a specific resource, memory, or skill directory. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Hotness weighting and this setting are removed; leftover configuration entries are ignored with a warning. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- This setting is removed; leftover configuration entries are ignored with a warning. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Results now order only by vector or rerank scores; scores and ordering may differ for the same query, so callers using score thresholds or filters should recalibrate. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- With the opensandbox backend, managed now defaults to true; set it false to use an existing external OpenSandbox service. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Native C++ and cuVS map pure cosine scores from [-1,1] to [0,1] without changing ranking; callers using score thresholds or filters should recalibrate. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Root API keys can no longer access /mcp; use a user or admin key. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- The person value now fails with a hint to use sender; existing peer_role: "person" plugin configuration remains treated as sender. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- The pi extension replaces its seven hand-written viking_* tools with server MCP tools registered as openviking_<tool>. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- The directory import file limit now defaults to null (unlimited) instead of 1000; set an explicit limit to retain the cap. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- The person value now fails with a hint to use sender; existing peer_role: "person" plugin configuration remains treated as sender. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Removes the session used-reporting endpoint; calls now return 404. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Writes and filesystem operations targeting reserved metadata and lock names return INVALID_ARGUMENT; WebDAV returns 404 for .exact.ovlock.*. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- The image no longer ships ripgrep, and RAGFS no longer probes or invokes an external rg binary. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Removes the Python Session.used() method; callers should drop the call. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)

### Deprecations

- The existing account settings endpoints remain available but are deprecated; new clients should use the configuration API. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)

### New APIs and options

- add_resource now accepts an acl parameter. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds an event time-decay ranking parameter to find and search. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds the get_acl MCP tool. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- ls and tree responses now include a pagination status flag. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds the list_groups MCP tool. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds the list_users MCP tool. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds include_abstract and include_overview options. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- MCP tools now advertise behavior annotations. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- The --skill memory mode deduplicates, merges, and normalizes a memory directory in place. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds force to reindex; the command also moves to the RFV planner and async tasks become recoverable. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- The configuration file now accepts oidc_token. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Jev reranking adds Choice mode, enabled with rerank.mode set to "choice"; the default remains "noul". (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds search_type="keywords" for BM25 keyword retrieval across REST, MCP, CLI, and the Python, TypeScript, and Go SDKs. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds the set_acl MCP tool. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Adds directory filtering and L0/L1 content display support. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- write now accepts an acl parameter. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Creation and import operations can accept ACL settings; passing acl requires manage permission, and write-only callers receive 403. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds a CLI option for supplying ACL settings when creating or importing resources. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds the add_skill tool to MCP. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds Account-level runtime configuration, including per-account VLM, Query Planner, Embedding, remote VectorDB, and Feishu credentials. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds asyncio executor metrics for observability. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds parsing support for Feishu mindnotes. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds Cluster-level runtime configuration that can be read or patched without editing ov.conf or restarting. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds a Jev rerank provider. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds a memory plugin for Kimi Code CLI. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Supports JSON output through the format=json query parameter. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- The OpenCode plugin now supports OpenCode v2. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds an openGauss DataVec vector backend. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Memory plugins now ship the openviking-skills skill and inject a Skill catalog at session start. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds case-insensitive account search to Studio's Account list through the query parameter. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds QueueFS processing latency observability. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Use root_uri to obtain the Skill package root because skills/find results may have uri values pointing inside the package. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Adds a deployment-level default for user configuration auto-commit policy. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Watch tasks now support externally managed OAuth tokens. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)

### Behavior and default changes

- Choice scores are relative probabilities within the candidate pool; callers must set rerank.threshold to 0 and pass min_score=0 for MCP calls. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- The default install no longer runs git clone; legacy source options and repository variables are accepted but only print a notice. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- The default check interval changes from 60 seconds to 600 seconds. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- The default maximum concurrency for reindex workers is now 4. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Context-mode search returns one best hit per Skill. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Unparseable or empty memory extraction results after retries now mark the task and archive failed, with failure_kind=parse_error or failure_kind=empty_response. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- With acl.enabled, the shared root defaults to inherited user:* = manage; the setting applies only to Accounts with ACL enabled. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Returns one best hit per Skill; uri may point within the package, so use root_uri when the package root is needed. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- Unknown fields in ov.conf and Account setting.json are ignored with a WARNING instead of preventing startup; type errors in known fields still fail. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)

### Fixes and other changes

- Whole-call MCP failures now return isError: true. (0.4.23) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.23)
- Run semantic_and_vectors reindexing to build missing Skill package-level summaries and indexes; vectors_only does not generate missing summaries. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)
- User-created tasks and _system directories below the account root now appear in ls, tree, and glob results. (0.4.22) — [release notes](https://github.com/volcengine/OpenViking/releases/tag/v0.4.22)