Skip to content

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-LD SoftwareSourceCode and SoftwareApplication structured data, and build-generated llms.txt and llms-full.txt indexes on the VitePress documentation site.
  • Added npm discovery keywords, pointed package.json homepage to https://nb-corp.github.io/nb-search/, and added repository glama.json metadata.

Changed ​

  • Reorganized README.md, README.zh-CN.md, and SKILL.md for proportional multi-source coverage, zero-key quickstart commands, MCP/Skill/SDK onboarding, and competitive trade-off comparison, while relocating provider-specific Zhihu configuration and detailed keyUsage() reference material to the documentation site.
  • Updated VitePress guides and source catalog pages for 0.5.x behavior, including duckduckgo.search zero-key default search, Defuddle direct.fetch extraction, ordered URL routing, and npx MCP server configuration.

0.5.1 - 2026-11-15 ​

Added ​

  • Added the opt-in Zhihu provider (provider_id: zhihu) with zhihu.search, zhihu.global and typed zhihu.synthesis lanes. 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 to zhida-fast-1p5 and returns nb-search.synthesis@1.
  • Added a fail-closed free-quota guard backed by GET /api/v1/quota, with per-API request counters from KeyUsage.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 upstream TotalUsed advances or midnight reset. Wallet billing requires explicit allow_paid: true.

Changed ​

  • Zhihu base_url prefixes 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@1 rule 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 4 and envelope schema 3.0 remain 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 resolveProviderOperation for 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, --stdin single UTF-8 JSON inputs, --wait budget execution, complete artifact reconstruction via read --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-search structures.
  • Added explicit offline migration tooling (--import-search-layer --dry-run and --apply) with separate protected credential storage (secrets.json and remote-secrets.json).
  • Added GMA messages relay 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.ts and scripts/lane-guidance.mjs).
  • Added trusted in-process http_transport injection option to createNbSearchRuntime with root exports for HttpRequest, HttpResponse, HttpTransport, and ResponseLimitError.
  • 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: 0 and blocked_markers: [], and raised default synchronous max_inline_bytes to 16 MiB.
  • Updated GMA adapter to version 2; in-flight version-1 jobs must complete before upgrade.
  • Configuration schema 4 and result schema 3.0 remain unchanged; HTTP protocol 1 has 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.fetch action 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, and parseResolvedConfig.
  • 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 CapabilityIssueCode type.
  • 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 search and fetch run | get | read | cancel action unions.
  • Updated public envelopes and error codes to schema version 3.0; configuration uses schema version 4.
  • A search call without an explicit selector now uses defaults.search_lane and returns DEFAULT_NOT_CONFIGURED when no default is configured.
  • Credential slots are provider-scoped; a provider instance cannot consume a slot declared for another provider.

Released under the MIT License · AI Index: /nb-search/llms.txt