pattern-zones-co/koine

AI Summary: This GitHub issue tracks the effort to improve test coverage for the `stream-object` feature, which was merged with coverage below the standard 80%. It identifies specific files in the gateway and SDKs (TypeScript, Python) with low coverage, highlighting areas like JSON extraction fallbacks, buffer handling edge cases, and various error handling paths that require additional tests to meet the coverage standard.

AI Summary: This chore issue aims to remove legacy code associated with a defunct email inbox assistant prototype. It involves deleting the unused `userEmail` field from API request schemas and removing `INBOX_ZERO_*` environment variables and their handling from the codebase. The task is a cleanup effort to streamline the gateway package and its documentation.

AI Summary: The `concurrency.test.ts` suite intermittently fails with a "socket hang up" error when executed in parallel as part of the full test suite, despite passing reliably in isolation. This flakiness is attributed to potential parallelism issues, specifically shared state leakage between tests, a lack of explicit port isolation for Express servers created by `supertest`, and timing-dependent cleanup operations that may not complete before subsequent tests run.

AI Summary: This issue proposes reversing the precedence for Anthropic authentication tokens. Currently, the system prioritizes `CLAUDE_CODE_OAUTH_TOKEN` over `ANTHROPIC_API_KEY` when both are present. The desired change is to prefer the API key, aligning with Anthropic's terms which designate API keys for automation and OAuth tokens for personal use.

AI Summary: This issue proposes refactoring the project structure by relocating SDK examples from the central `docs/examples` directory into their respective SDK package directories. For instance, TypeScript examples would move to `packages/sdks/typescript/examples/` and Python examples to `packages/sdks/python/examples/`. This aims to improve discoverability, simplify paths, and co-locate examples with their SDK code, requiring updates to all related documentation links.

AI Summary: The GitHub Actions PR review workflow currently lacks access to specialized `pr-review-toolkit` agents available in local Claude Code environments, resulting in lower quality reviews. To bridge this capability gap, the proposed solution is to vendor the `pr-review-toolkit` directly into the repository. This will allow it to be loaded via the `--plugin-dir` flag within the GitHub Actions workflow, enabling the use of powerful agents like `code-reviewer` and `silent-failure-hunter`.