[suguanYang]

Problem

The Knowhere shared demo catalog changed its example citation payload. Notebook still required the legacy nested source object, canonical_chunk_id, and chunk_type fields, so the guest homepage failed during server rendering with Expected non-empty string from Knowhere demo API.

Changes

• Normalize both legacy and shared-corpus citation shapes at the Knowhere boundary.
• Preserve shared-corpus row IDs and parser chunk IDs separately.
• Derive source metadata from top-level shared-corpus fields and the enclosing demo source.
• Normalize scalar page_number values and default missing chunk types to text.
• Accept chunk-page envelopes that omit source metadata, using the catalog as a fallback.
• Add regression coverage for the live shared-corpus citation and chunk-page shapes.

Verification

• pnpm vitest run src/integrations/knowhere-demo.test.ts
• pnpm test — 836 passed, 14 skipped
• pnpm lint
• pnpm typecheck
• pnpm build

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
knowhere-notebook-staging	Ready	Preview	Oct 10, 2026 9:53am UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
knowhere-notebook	Ignored	Preview	Oct 10, 2026 9:53am UTC