Ship a release-ready, typed ChulkHarness SDK

[JaviChulvi]

Summary

• package ChulkHarness as a typed, cleanly installable wheel with release metadata and CI coverage
• expose lifecycle-safe Agent and AsyncAgent facades with stable exceptions, versioned events, and immutable typed results
• add explicit application capabilities, reviewable memory modes, host-owned tool context, structured outputs, timeouts, and bounded retries
• provide credential-free SDK onboarding, deterministic testing utilities, verified examples, and task-focused embedding documentation

Why

ChulkHarness had the runtime foundations for agent workflows, but embedding applications still depended on provisional surfaces and repository knowledge. This change establishes an explicit public SDK contract, safer host-controlled defaults, release packaging, and a deterministic first-use path.

Developer impact

Applications can now build against documented public imports, consume stable typed results and events, classify failures consistently, and opt into side effects deliberately. The CLI continues to use the same runtime builder while retaining its own compatibility defaults.

The branch is intentionally organized as seven focused feature commits corresponding to the approved implementation specs.

Review fixes

• guarantee sync and async event streams terminate when application callbacks raise
• preserve every queued event during normal channel completion under backpressure
• approve memory proposals atomically so concurrent reviewers cannot create duplicate memories
• accept valid primitive and array tool-output schemas
• map proposal-store failures through the public MemoryError boundary
• release request-scoped tool dependencies after terminal success, failure, cancellation, plan resolution, and agent close

Validation

• python -m pytest — 440 passed
• python -m ruff check chulk examples scripts
• python -m mypy typing_tests
• python -m compileall chulk examples scripts
• python scripts/check_docs.py
• credential-free quickstart and repository-review examples
• clean archived wheel build, install, public API, typing, resource, and example-import smoke test
• GitHub Actions passed on Python 3.11, 3.12, and 3.13, public SDK typechecking, and clean wheel/examples