Changelog
0.5.2 - 2026-11-15
Added
- Added the English documentation overview (
/en/),sitemap.xml,robots.txt, OpenGraph and Twitter card metadata (og-card.png), JSON-LDSoftwareSourceCodeandSoftwareApplicationstructured data, and build-generatedllms.txtandllms-full.txtindexes on the VitePress documentation site. - Added npm discovery
keywords, pointedpackage.jsonhomepagetohttps://nb-corp.github.io/nb-search/, and added repositoryglama.jsonmetadata.
Changed
- Reorganized
README.md,README.zh-CN.md, andSKILL.mdfor proportional multi-source coverage, zero-key quickstart commands, MCP/Skill/SDK onboarding, and competitive trade-off comparison, while relocating provider-specific Zhihu configuration and detailedkeyUsage()reference material to the documentation site. - Updated VitePress guides and source catalog pages for
0.5.xbehavior, includingduckduckgo.searchzero-key default search, Defuddledirect.fetchextraction, ordered URL routing, andnpxMCP server configuration.
0.5.1 - 2026-11-15
Added
- Added the opt-in Zhihu provider (
provider_id: zhihu) withzhihu.search,zhihu.globaland typedzhihu.synthesislanes. No Zhihu provider instance, credential slot or lane is added to the defaults. The content-search operations use the official API paths; Zhida synthesis defaults tozhida-fast-1p5and returnsnb-search.synthesis@1. - Added a fail-closed free-quota guard backed by
GET /api/v1/quota, with per-API request counters fromKeyUsage.usage.meters, a preserved legacy credits summary, Asia/Shanghai daily reset, caching only when more than 32 requests remain (up to 60 seconds), runtime-wide per-credential reservations, and retained charges across uncertain interrupted sends until upstreamTotalUsedadvances or midnight reset. Wallet billing requires explicitallow_paid: true.
Changed
- Zhihu
base_urlprefixes are preserved when appending configured endpoint paths; Tavily and Firecrawl usage requests also retain configured prefixes.
0.5.0 - 2026-11-14
Added
- General-web search now defaults to keyless DuckDuckGo HTML without registration or lane selection. Configured defaults, explicit removals and lane choices are preserved; errors never switch providers. Challenges and unrecognized pages fail rather than returning empty results, and 429 retains Retry-After metadata. DuckDuckGo adapter version 2 changes operation fingerprints; finish version-1 jobs before upgrading. GitHub and Context7 remain explicit specialist choices.
- Added default-on ordered URL routing, the versioned
kiki-common-direct@1rule package, route/attempt receipts, and browser-safe public contracts. Explicit pipelines take precedence; direct-only rules do not silently add paid fallback. - Exported captured configuration/runtime composition, credential rebinding, hosted worker launch/run hooks, and approved file identity capture. Hosts can reuse standard defaults and resolution without substitute config files.
- Added the official Tavily typed crawl and research-task lanes, preserving Bearer authentication and bounded POST/GET task polling.
Changed
- Direct URL HTML now uses Defuddle 0.19.3 with linkedom, without extractor networking. Raw text retains source whitespace; JSON and GitHub contents/readme responses produce readable bounded projections. Empty HTML fails rather than passing a page shell; empty plain bodies report
empty. - Direct supports detached async; routing is frozen at admission and retained on get/read and execution-failure artifacts. Existing SSRF/redirect/abort/byte limits and file identity protections remain in place. Zod stays an external production dependency so public schema declaration types are nameable by downstream packages.
- Configuration schema
4and envelope schema3.0remain compatible through optional routing fields. Direct approved-file identity handling and Tavily API parity change adapter fingerprints; finish older Direct/Tavily jobs before upgrading. Persisted jobs are never silently rebuilt. Public DuckDuckGo HTML search may be blocked by CAPTCHA.
0.4.0 - 2026-09-08
Added
- Added trusted local JavaScript and erasable TypeScript script lanes, configured through the standard SDK/CLI provider settings, with synchronous and detached asynchronous execution.
- Exported script module types and included a runnable, no-network example.
- Added
resolveProviderOperationfor offline host inspection of Exa, GMA and script operations, sharing validation, defaults and endpoint resolution with the actual adapters.
Compatibility
- Existing search/fetch/capabilities calls and in-process provider registrations remain supported. Script modules run with host permissions and must cooperate with cancellation; they are not sandboxed or content-pinned.
- Cloud hosts can reuse SDK operation metadata instead of duplicating provider protocols. Unsupported offline endpoint resolution is reported explicitly.
0.3.1 - 2026-09-08
Fixed
- GMA requests now use streaming for both chat and messages protocols, with complete SSE parsing and rejection of interrupted or failed responses.
- GMA research defaults to a 10-minute deadline unless a request or configuration explicitly supplies a timeout; ordinary search keeps its 30-second default.
- HTTP 524 is classified as retryable for callers with an explicit retry policy.
Changed
- Added bilingual product landing pages and themed SVG assets.
- Clarified search and webpage reading in nb-search, with document conversion and resource export available through nb-extract. Existing fetch interfaces remain compatible.
- Published the official CLI, MCP and Skill entry points to npm, including the changes documented under 0.3.0.
0.3.0 - 2026-09-08
Added
- Added the callable remote client SDK (
createNbSearchRemoteClient) and HTTP protocol v1 client contract with strict response validation, bounded streams, non-retry policy, and URL-only fetch boundaries. - Added formal CLI profiles,
--stdinsingle UTF-8 JSON inputs,--waitbudget execution, complete artifact reconstruction viaread --all, default local follow-ups with explicit profile requirement for remote jobs (get,read,cancel), and standardized exit codes (0,2,3,4,5,6,7). - Added official skill launcher support for package root and nested
skills/nb-searchstructures. - Added explicit offline migration tooling (
--import-search-layer --dry-runand--apply) with separate protected credential storage (secrets.jsonandremote-secrets.json). - Added GMA
messagesrelay contract and strict HTTP 3xx redirect rejection to protect credentials from unintended forwarding. - Added concurrent reader snapshot coordination, safe writer transaction markers, and lane purpose catalog guidance (
src/lane-guidance.tsandscripts/lane-guidance.mjs). - Added trusted in-process
http_transportinjection option tocreateNbSearchRuntimewith root exports forHttpRequest,HttpResponse,HttpTransport, andResponseLimitError. - Added VitePress documentation site framework, continuous integration checks, and release readiness verification tooling.
Changed
- Simplified local environment admission by removing redundant ACL/owner/mode checks and initialization barriers while preserving standard file creation modes and symlink/junction support.
- Updated default fetch quality rules to
min_content_chars: 0andblocked_markers: [], and raised default synchronousmax_inline_bytesto 16 MiB. - Updated GMA adapter to version 2; in-flight version-1 jobs must complete before upgrade.
- Configuration schema
4and result schema3.0remain unchanged; HTTP protocol1has its own version. - Local readers no longer require a persistent global command lock; follow-up job commands default to the local connection.
0.2.0 - 2026-09-04
Added
- Added the public
runtime.fetchaction union, default fetch chains, nine built-in fetch pipelines, and sync/async fetch job envelopes. - Added schema-v4 configuration inputs and parsers for in-process hosts:
CanonicalConfigPatch,parseConfigPatch, andparseResolvedConfig. - Added provider registrations, fifteen built-in search lanes, typed query operations, presets, and explicit default-lane selection.
- Added capability descriptors for providers, configured provider instances, search lanes, fetch pipelines, defaults, readiness, redacted credential status, and the extensible
CapabilityIssueCodetype. - Added packaged
SKILL.md,.env.example, and runtime contract documentation, plus the optional Playwright peer dependency for browser rendering.
Changed
- Replaced the 0.1 research-specific runtime methods with the generic
searchandfetchrun | get | read | cancelaction unions. - Updated public envelopes and error codes to schema version
3.0; configuration uses schema version4. - A search call without an explicit selector now uses
defaults.search_laneand returnsDEFAULT_NOT_CONFIGUREDwhen no default is configured. - Credential slots are provider-scoped; a provider instance cannot consume a slot declared for another provider.