release: 0.3.0.dev — dual-mode SDK + legacy compatibility layer

[KylinMountain]

Summary

Promotes the 0.3.0.dev work from `dev` to `main`, covering the dual-mode SDK rewrite and the legacy SDK compatibility layer.

Highlights

• feat: add PageIndex SDK with local/cloud dual-mode support #207 — new Collection-based dual-mode SDK (local + cloud), parsers, agent QA
• feat:compatible with Pageindex SDK #238 — legacy SDK (`pageindex_sdk` 0.2.x) compatibility on `PageIndexClient`: `submit_document` / `get_ocr` / `get_tree` / `chat_completions` / folder & document management — including follow-up fixes to close streaming responses and warn on empty `api_key`, plus `@deprecated` markers pointing new code to the Collection API
• fix: poll status=="completed" in cloud add_document #226 — cloud `add_document` now polls `status == "completed"` instead of an unreliable `retrieval_ready` flag
• Packaging: switch to Poetry, bump version to 0.3.0.dev1, add `dist/` to gitignore

Test plan

• `pytest tests/` green on `dev`
• End-to-end smoke against `api.pageindex.ai`: submit → poll → tree → metadata → chat (sync + stream) → delete, all pass
• Manual verify install from a built wheel
• Verify CHANGELOG / docs reflect 0.3.0 surface before tagging

[KylinMountain]

Code review

Found 1 issue:

1. pyproject.toml declares no direct pydantic dependency, but pageindex/config.py imports from pydantic import BaseModel in production code. Pydantic is currently pulled in transitively via litellm, but a future litellm release (or a constrained resolver) could break installs with ModuleNotFoundError: pydantic. Add pydantic to [tool.poetry.dependencies].

PageIndex/pageindex/config.py

Lines 1 to 7 in 595895c

	# pageindex/config.py
	from __future__ import annotations
	from pydantic import BaseModel
	class IndexConfig(BaseModel):
	"""Configuration for the PageIndex indexing pipeline.

PageIndex/pyproject.toml

Lines 22 to 33 in 595895c

	[tool.poetry.dependencies]
	python = ">=3.10"
	litellm = ">=1.83.0"
	pymupdf = ">=1.26.0"
	PyPDF2 = ">=3.0.0"
	python-dotenv = ">=1.0.0"
	pyyaml = ">=6.0"
	openai = ">=1.70.0"
	openai-agents = ">=0.1.0"
	requests = ">=2.28.0"
	httpx = {extras = ["socks"], version = ">=0.28.1"}
	typing-extensions = ">=4.9.0"

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}