pattern-zones-co/koine

AI Summary: This issue aims to increase the test coverage for the recently merged `stream-object` feature, which is currently below the desired 80% standard. The focus will be on improving tests for the gateway, TypeScript SDK, and Python SDK, specifically addressing uncovered paths related to JSON extraction, error handling, and edge cases in stream processing.

AI Summary: This issue proposes the removal of legacy `userEmail` fields and `INBOX_ZERO_*` environment variables. These are no longer used by the application and their removal will clean up the codebase and environment.

AI Summary: This issue describes a flaky test in the concurrency suite that fails with a 'socket hang up' error when the full test suite is run in parallel. The problem seems to stem from shared state, lack of port isolation for servers created by supertest, and timing-dependent cleanup operations.

AI Summary: This issue proposes reversing the precedence of API keys and OAuth tokens in the gateway. Currently, the OAuth token is preferred when both are set, but the desired behavior is to prioritize the ANTHROPIC_API_KEY for programmatic access, aligning with Anthropic's terms of service and documentation updates.

AI Summary: This issue proposes refactoring the project by moving SDK examples from a central `docs/examples` directory into their respective SDK package directories (e.g., `packages/sdks/typescript/examples/`). This change aims to improve discoverability, simplify example execution, and keep code and its demonstrations closer together. The `docs/examples/README.md` will be updated to a stub pointing to the new locations.

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`.

AI Summary: This issue proposes upgrading the Biome linter/formatter from version 1.9.4 to the latest (2.3.10). The upgrade is motivated by the outdated version and includes schema changes that require configuration migration. The tasks involve updating the package, running a migration command, verifying functionality, and updating CI.

AI Summary: This issue proposes refactoring the test suite to replace flaky `setTimeout` calls with a deterministic polling mechanism. The new approach waits for a `spawn` call to occur before emitting mock events, eliminating race conditions and improving test reliability, especially in CI environments. The tasks involve moving a helper function and updating multiple test files.

AI Summary: This issue proposes automating the generation of an OpenAPI 3.1 specification from existing Zod schemas. The goal is to replace the current manual maintenance of the OpenAPI spec with a script that reads Zod definitions and outputs a `docs/openapi.yaml` file, ensuring consistency and reducing manual effort. This will involve adding a library like `@asteasolutions/zod-to-openapi` and integrating the generation into the build process or CI.