feat: smart saveTo with full path support

[mikesoennichsen]

Summary

saveTo now accepts a full file path ending in .json in addition to a directory path.

// Directory mode (existing behavior)
client.extract({ markdown: stream, saveTo: './output' })
// → ./output/doc_extract_output.json

// Full path mode (new)
client.extract({ markdown: result.markdown, saveTo: './output/my_result.json' })
// → ./output/my_result.json

Companion PR: landing-ai/ade-python#85

Test plan

• 17 unit tests passing
• tsc --noEmit clean
• Manual: chain parse() → extract() with both saveTo modes

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds “smart” saveTo handling so callers can either provide an output directory (existing behavior) or an explicit .json filepath (new behavior), improving usability for chained workflows without an input filename.

Changes:

• Update _saveResponse to detect saveTo ending with .json and write to that exact file path (creating parent dirs as needed).
• Preserve directory-mode behavior when saveTo is not a .json path (auto-generated output filename).
• Add tests covering exact-path mode, parent directory creation, and JSON formatting.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
src/client.ts	Implements exact .json path support in _saveResponse while preserving directory mode.
tests/save-to.test.ts	Adds coverage for the new .json full-path saving behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.