OpenViking — The AI Toolchain

OpenViking v0.4.17

Fri, 28 Aug 2026 12:07:05 GMT

OpenViking v0.4.17 adds inline content retrieval, MCP media blocks, private TOS imports, and an `ov-memory-doctor` diagnostic skill across Python/Go/TypeScript SDKs. • Adds `read_content` field to ranked `find` and list-mode `search` responses, returning the full visible text of each hit URI in a `content` field; CLI exposes this as `--read-content`. • Adds `args.tos_signature` and `args.tos_access` to `add_resource` for one-shot private TOS HTTP(S) imports — credentials are used only for the HEAD/GET and are never persisted to resource metadata or the async queue. • Adds `ov-memory-doctor` diagnostic skill to the Claude Code and Codex memory plugins, checking installation, configuration, authentication, service connectivity, and recent activity. • Adds wildcard (`*`, `?`) filtering on the `name` field when listing accounts and users. • MCP `read` now returns standard image and audio content blocks; `mode=download` exports raw bytes (video requires download mode). • Python SDK introduces typed `options` objects while preserving common named arguments; `options` and flattened named arguments for the same setting cannot be combined. • Aligns Python, Go, and TypeScript SDK interfaces across `find`/`search`, context search, `recall`, resources, content, sessions, skills, `reindex`, and admin operations. • Directories created with `mkdir` now automatically generate a minimal L0 summary and queue vectorisation even when no `description` is provided, making them immediately searchable. • Content `write` operations `replace` and `append` now create the target file and any missing parent directories when the path does not exist (`create` still returns 409 if the file already exists). • Adds memory-extraction observability metrics split by type, action, and result, plus controlled error codes and real latency tracking for model calls. Breaking changes: • URI forms without a user ID — `viking://user/resources`, `viking://user/memories`, etc. — are removed from public request entry points and now return HTTP 400 with a corrective hint. Replace them with `viking://~/resources`, `viking://~/memories`, or the explicit `viking://user/{user_id}/...` form. Scripts, agent prompts, and plugins must be upgraded alongside the server; the old server does not recognise `viking://~`, so server and client must be upgraded together.

OpenViking v0.4.16

Fri, 21 Aug 2026 07:04:17 GMT

OpenViking v0.4.16 adds remote VikingBot Skills, per-user memory policies, faster async resource import, and the `viking://~` URI shorthand. • Adds `GET` and `PATCH /api/v1/admin/accounts/{account_id}/users/{user_id}/settings` endpoints to read and update per-user `memory_policy`, controlling which Memory types can be extracted; setting `memory_policy` to `null` clears the override and restores the inherited default. • Adds `viking://~` URI alias that resolves to the authenticated caller's user root directory, usable anywhere a `viking://user/...` URI is accepted. • Adds VolcEngine/BytePlus plan tiers and custom interactive configuration to the CLI `init` wizard. • Adds new TOS resource connector arguments for the `add-resource` command. • Exposes context count and queued-upload-stage statistics in resource upload tasks, improving observability of `add-resource` operations. • Moves `wait=false` `add-resource` source-data preparation into a persistent background task chain, reducing request latency while preserving task ownership and reliability. • VikingBot can now discover, cache, and execute Skills hosted on remote OpenViking instances. • Context Compilation gains source materialization, read-chain tracing, and reusable long-running-agent workflow support (LLM Wiki, knowledge graph, daily digest, knowledge distillation). • DSH tools are now served over the shared stdio MCP Proxy, and a new DSH Memory Plugin is included. • L0/L1 semantic sidecars are now managed as protected OKF metadata, with write-protection enforced. • Web Studio request logs now display error details alongside Task API limit enforcement. Breaking changes: • The experimental Resource Relations REST API (`/api/v1/relations`), CLI commands (`ov relations`, `ov link`, `ov unlink`), and associated documentation have been removed. Any integrations using these must be deleted or replaced before upgrading.

OpenViking v0.4.14

Mon, 17 Aug 2026 06:28:36 GMT

OpenViking v0.4.14 adds MCP write/edit/tree, DSH memory plugin, DeerFlow/TRAE integrations, and private-repo Git ingestion while removing Qdrant and openGauss backends. • MCP gains `tree`, `write`, and `edit` operations against `viking://` workspaces; `write` supports create, replace, and append modes; `edit` performs exact string replacement and leaves the file unchanged when a match is missing or ambiguous; `wait=true` blocks until semantic and vector indexes are refreshed; `viking://user/...` addresses the authenticated user's own workspace. • New `@openviking/dsh-memory-plugin` for DeepSeek Harness adds automatic recall, Session capture, retryable-write replay, `viking://` path protection, and model-callable tools (`viking_search`, `viking_read`, `viking_browse`, `viking_remember`, `viking_add_resource`, `viking_forget`); pinned to `@deepseek-ai/dsh` `0.1.0-rc.6` and Node.js `^22.19.0` or `>=24`. • DSH plugin environment variables `OPENVIKING_WORKSPACE_PEER=1` and `OPENVIKING_RECALL_PEER_SCOPE=actor` control workspace-scoped actor peer derivation and recall restriction. • DeerFlow integration adds MemoryManager (automatic write, recall, and context injection) configurable via `memory` block in `config.yaml` with keys `manager_class`, `mode`, `startup_policy`, `failure_policy.read`, and `failure_policy.write`; MCP access configured in `extensions_config.json` under `mcpServers.openviking`. • New `agent-plugins/` package provides a portable Agent Plugins 1.0 bundle with a zero-runtime-dependency stdio-to-HTTP MCP proxy and `openviking-memory` Skill for clients that conform to Agent Plugins 1.0 but lack dedicated hooks. • OpenCode gains a hooks-only memory mode. • OpenViking Assets resource ingestion now accepts pinned 40-character Git commit SHAs, explicit `to` destination targets, and HTTPS private repository credentials; `add_resource` and Watch flows also support private Git authentication. • Feishu/Lark ingestion now supports Drive files and recursive folder imports. • Web Studio adds complete Watch management: view, edit, pause, resume, trigger, and history flows, plus richer remote resource import options. • `reindex` now accepts `replace` or `append` mode to update tags on successfully rebuilt records. • Experience trajectory list and outcome distribution endpoints accept inclusive UTC date range filters. • Sessions support setting default event-memory tags at creation time, updating them via the configuration interface, and overriding or clearing them per single commit; auto-commit policies can also be updated or disabled dynamically. • Configuring `experiences` now automatically enables `cases` and `trajectories`; Agent Evolution derivative memories are generated only when extraction actually produces a case. • Web Studio adds an account deletion flow with immediate identity revocation and durable-queue data cleanup, and a scope-grouped Skills view. • MCP Streamable HTTP switches to stateless mode, eliminating intermittent `Session not found` errors in multi-instance or load-balanced deployments. Breaking changes: • The embedded Python client classes `OpenViking`, `SyncOpenViking`, `AsyncOpenViking`, and `LocalClient` are no longer exported; callers must run OpenViking as a separate service and connect via `openviking-sdk`. • `mineru_endpoint` is now treated as a base URL and OpenViking calls `POST {endpoint}/file_parse`; `mineru_params` is renamed to `mineru_bodys`; `mineru_api_key` has been removed. • `memory.version` is now ignored and V2 extraction is no longer selectable; `memory.v2_lock_retry_interval_seconds` and `memory.v2_lock_max_retries` are no longer supported. • The Qdrant and openGauss vector backends have been removed. • SessionCommit worker default concurrency changed from 4 to 8.

OpenViking v0.4.13

Thu, 06 Aug 2026 11:44:51 GMT

OpenViking v0.4.13 adds OIDC/LDAP auth, Redis QueueFS, server-side recall context assembly, and audio/video multimodal understanding • Adds `mode="context"` to the `/search` endpoint for server-side recall context assembly — executes recall planning, quota allocation, token budgeting, detail-tier downgrade, cross-turn deduplication, and optional LLM digest, returning context blocks ready to inject into a model; existing `mode="list"` remains the default. • Adds `args.parse_mode=no_split` to resource import so PDF, Word, PowerPoint, and HTML sources are parsed and converted to Markdown but kept as a single body without splitting by heading, paragraph, or length. • Adds `processing_mode` to resource import and content write: `semantic_and_vectors` (default) regenerates `.abstract.md`, `.overview.md`, and vectors; `vectors_only` skips VLM semantic understanding and only vectorizes the current file, preserving existing semantic artifacts. Supported in Python SDK, TypeScript SDK, CLI, and HTTP API. • Adds `queue_workers.external_parse.max_concurrent` config key to set ExternalParse worker concurrency, defaulting to `4`; takes effect after service restart. • Adds `enable_watch_scheduler` config toggle; read-only replicas sharing writer data can set this to `false` to avoid redundant resource refresh sweeps. Defaults to `true`. • Adds `server.timeout_keep_alive` config key to set the HTTP idle keep-alive timeout, defaulting to `5` seconds. • Adds `memory.session_auto_commit` server-side config to control default enablement and idle scheduler for Session Auto Commit v2, which supports per-session `auto_commit_policy` triggered by pending token count, message count, idle time, recent-message retention count, and minimum commit interval. • Adds OIDC and LDAP authentication modes supporting Okta, Auth0, Keycloak, Azure AD, Windows AD, and OpenLDAP, with claim/attribute mapping to account, user, and role; installable via `uv pip install 'openviking[auth]'`; CLI gains LDAP credential support. • Adds Redis backend for QueueFS (`storage.agfs.queuefs`) supporting standalone, Cluster, and Sentinel modes for multi-instance shared-queue deployments; existing SQLite QueueFS remains the default. • Adds audio/video multimodal understanding backend based on Volcano Ark (火山方舟), supporting long media upload, async polling, result caching, timeout control, and audio/video summary templates. • Adds `langchain-openviking` as a standalone package providing Retriever, Tools, Message History, Context Wrapper, Store, and Middleware; the original `openviking.integrations.langchain` import path is retained as a compatibility shim. • Adds ZCode Memory Plugin with session capture, auto recall, MCP proxy, and shared pending queue. • Adds Experience Memory tools and skills to the OpenClaw plugin for querying, reading, and using experience memory stored in OpenViking. • Adds experience trajectory lineage tracking in Agent Evolution, recording associations between experiences and their originating trajectories, with corresponding API and vector metadata support. • Adds experience outcome aggregation and snapshot refinement in Agent Evolution, combining lineage and historical outcomes to produce more stable experience versions. • `find` and `search` results now return explicit `tags` and omit empty optional fields. • VectorDB gains a `text` field type for storing large strings that exceed ordinary string field limits. • RAGFS gains structured lock tracing logs covering wait, contention, expiry, and release lifecycle for lock debugging. • Removes forced LangChain client dependency from the main `openviking` server package, reducing image size and dependency surface. • Packed OpenClaw/ArkClaw marketplace plugins no longer support `{source: 'exec'}` `SecretRef`; `{source: 'env'}` and `{source: 'file'}` remain supported. Breaking changes: • Packed OpenClaw/ArkClaw marketplace plugins no longer execute `SecretRef` with `{source: 'exec'}`; switch to `{source: 'env'}`, `{source: 'file'}`, or inject secrets into the environment before launching OpenClaw. • search(mode="context") returns HTTP 400 when `target_uri` is supplied; the `level` parameter is replaced by the `detail` tier in context mode.

OpenViking v0.4.12

Mon, 03 Aug 2026 03:02:23 GMT

OpenViking v0.4.12 adds `ov compile`, Assets Manifest, turn-aware session retention, task cancellation, and single-file Snapshot Diff. • New `ov compile` command compiles one or more `viking://` source directories into structured artifacts using a Skill-driven isolated AgentLoop, committing results to a target Resource, Memory, or Skill namespace; accepts `--from`, `--to`, `--skill`, `--reason`, `--wait`, and `--timeout` flags. • New `GET /bot/v1/compile/{task_id}` endpoint lets callers poll async `ov compile` task status; completed results distinguish `created`, `updated`, and `unchanged` artifacts and report page count, link count, warnings, and OKF version. • New `ov add-resource --manifest ` command supports the `openviking-assets/1` YAML manifest protocol for declarative, version-controllable asset catalog management with `--args dry_run:true` preflight and `--wait --timeout` flags; state is persisted to `.state.json`. • New `turn_budget` retention mode for Session Commit API (`POST /api/v1/sessions/{id}/commit`) preserves complete user turns rather than fixed message counts, controlled via `retention_mode`, `keep_recent_turn_count`, `retained_message_token_budget`, and `min_raw_tail_steps` fields. • New `ov task cancel ` command and Python SDK await client.cancel_task("uuid-xxx") enable cooperative cancellation of `add_resource`, `session_commit`, `admin_reindex`, and `snapshot_restore_reindex` tasks; status transitions from `cancelling` to `cancelled` with idempotent repeat calls. • New `ov snapshot diff --from --to ` command produces Unified Diff for UTF-8 text files between two commit references, returning `added`, `deleted`, `modified`, or `unchanged`; also available via Python SDK client.snapshot.diff(path, from_ref=..., to_ref=...) and HTTP API; per-side limit is 10 MiB / 100,000 lines, diff limit is 20 MiB. • VikingBot Chat API now accepts OpenAI-style image input. • LangChain/LangGraph integration adds native async calls and request-level Actor Peer support. Breaking changes: • HTTP Server `server.agent_evolution.enabled` now defaults to `false`; deployments relying on automatic Case, Trajectory, and Experience generation after Session Commit must explicitly set `{"server": {"agent_evolution": {"enabled": true}}}` in `ov.conf` to restore the previous behavior. • The `/api/v1/code/outline`, `/api/v1/code/search`, and `/api/v1/code/expand` endpoints and the MCP tools `code_outline`, `code_search`, and `code_expand` have been removed; callers must migrate to the Skeleton-first code summary and the generic `read`, `grep`, `find`, and `search` capabilities.