feat(sdk)!: upgrade to SDK v0.2.0 with breaking API changes

[mowree]

BREAKING CHANGE: Requires github-copilot-sdk>=0.2.0,<0.3.0
BREAKING CHANGE: CopilotClient now uses SubprocessConfig
BREAKING CHANGE: session.send() signature changed to send(prompt, attachments=...)

SDK v0.2.0 Upgrade:

• SubprocessConfig replaces raw dict for client initialization
• send(prompt, attachments=...) replaces send({"prompt": ...})
• Vision support: ImageBlock → BlobAttachment passthrough

New Architecture:

• sdk_adapter/ quarantine isolates SDK imports
• config/ YAML files for policy values (Three-Medium)
• contracts/ behavioral specifications

Test Results:

• Windows: 858 passed, 2 skipped (Unix tests), 90.22% coverage
• WSL/Linux: 859 passed, 1 skipped (Windows test), 90.38% coverage

[Copilot]

Pull request overview

Upgrades the provider to github-copilot-sdk v0.2.0 (breaking API changes) and introduces a “Three‑Medium” architecture with SDK isolation, YAML-driven policy, and contract docs.

Changes:

• Replace direct SDK usage with an sdk_adapter/ membrane (quarantined imports, session lifecycle, event/tool extraction).
• Introduce YAML configuration + markdown contracts to define provider behavior (streaming, errors, deny/destroy, SDK protection, observability).
• Restructure tests/fixtures to match updated SDK response shapes and new session creation semantics.

Reviewed changes

Copilot reviewed 69 out of 165 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
tests/sdk_assumptions/test_deny_hook.py	Removes SDK behavioral assumption tests for deny-hook/tool execution.
tests/sdk_assumptions/conftest.py	Removes custom mocked SDK/session harness used by assumption tests.
tests/sdk_assumptions/init.py	Removes package docs for assumption test suite.
tests/sdk_assumptions/README.md	Removes assumption-suite upgrade workflow documentation.
tests/integration/init.py	Removes integration test package marker docstring.
tests/fixtures/sdk_responses.py	Adds realistic SDK response shape fixtures (Data wrapper, etc.).
tests/fixtures/config_capture.py	Adds strict mock client to capture create_session(**kwargs) config for SDK v0.2.0.
tests/fixtures/init.py	Exports new fixture/mocks surface for tests.
tests/init.py	Updates tests package/module docstring.
pyproject.toml	Bumps package to 2.0.0, upgrades SDK dependency to v0.2.x, adds pyright/ruff config, adjusts pytest config.
docs/ARCHITECTURE.md	Adds architecture overview documenting module structure and design decisions.
contracts/streaming-contract.md	Adds streaming behavior specification + anchors.
contracts/sdk-response.md	Adds SDK response extraction contract + anchors.
contracts/sdk-protection.md	Adds defensive invariants for tool capture + session management.
contracts/provider-protocol.md	Adds provider protocol specification + hooks/quality gates anchors.
contracts/observability.md	Adds observability spec and notes partial implementation.
contracts/event-vocabulary.md	Adds SDK→domain event vocabulary and config schema contract.
contracts/error-hierarchy.md	Adds SDK→kernel error translation contract and config schema.
contracts/deny-destroy.md	Adds deny+destroy non-negotiable pattern contract.
contracts/behaviors.md	Adds config-driven policy contract (retry/streaming/model selection, etc.).
amplifier_module_provider_github_copilot/tool_parsing.py	Adds tool call parsing to kernel ToolCall objects.
amplifier_module_provider_github_copilot/tool_capture.py	Removes legacy tool bridge/deny-hook creation module.
amplifier_module_provider_github_copilot/security_redaction.py	Adds secret redaction helpers for log hygiene.
amplifier_module_provider_github_copilot/sdk_adapter/types.py	Adds SDK boundary types + tool/image passthrough helpers.
amplifier_module_provider_github_copilot/sdk_adapter/tool_capture.py	Adds first-turn-only + deduplicated tool capture handler.
amplifier_module_provider_github_copilot/sdk_adapter/extract.py	Adds unified SDK event field extraction helper.
amplifier_module_provider_github_copilot/sdk_adapter/event_helpers.py	Adds SDK event type helpers + tool_request extraction.
amplifier_module_provider_github_copilot/sdk_adapter/client.py	Adds Copilot client wrapper using SubprocessConfig + v0.2 session config/hook model.
amplifier_module_provider_github_copilot/sdk_adapter/_spec_utils.py	Adds SDK-spec discovery via importlib.util.find_spec without importing SDK.
amplifier_module_provider_github_copilot/sdk_adapter/_imports.py	Adds SDK import quarantine module for SDK v0.2 concepts.
amplifier_module_provider_github_copilot/sdk_adapter/init.py	Exposes adapter “membrane” public surface.
amplifier_module_provider_github_copilot/request_adapter.py	Adds ChatRequest→CompletionRequest prompt/attachment adaptation.
amplifier_module_provider_github_copilot/observability.py	Adds YAML-driven observability event emission helpers + lifecycle context.
amplifier_module_provider_github_copilot/model_naming.py	Removes legacy model naming parsing/validation heuristics.
amplifier_module_provider_github_copilot/fake_tool_detection.py	Adds YAML-driven fake tool-call detection + retry logging helpers.
amplifier_module_provider_github_copilot/exceptions.py	Removes custom exception hierarchy in favor of kernel error types.
amplifier_module_provider_github_copilot/converters.py	Removes legacy message/response conversion utilities.
amplifier_module_provider_github_copilot/config/sdk_protection.yaml	Adds SDK protection policy for tool capture + session behavior.
amplifier_module_provider_github_copilot/config/retry.yaml	Adds retry + streaming timing policy values.
amplifier_module_provider_github_copilot/config/observability.yaml	Adds observability policy (event names, status, flags).
amplifier_module_provider_github_copilot/config/models.yaml	Adds provider identity + model catalog/defaults policy.
amplifier_module_provider_github_copilot/config/model_cache.yaml	Adds model cache policy.
amplifier_module_provider_github_copilot/config/fake-tool-detection.yaml	Adds fake tool-call detection policy.
amplifier_module_provider_github_copilot/config/events.yaml	Adds event classification policy mapping SDK event types to domain events.
amplifier_module_provider_github_copilot/config/errors.yaml	Adds error translation policy mappings.
amplifier_module_provider_github_copilot/config/init.py	Adds config package marker for importlib.resources.
amplifier_module_provider_github_copilot/completion.py	Adds new completion lifecycle implementation using v0.2 send/on + tool capture/abort.
amplifier_module_provider_github_copilot/_platform.py	Refactors binary discovery to use membrane spec discovery, caches platform facts.
amplifier_module_provider_github_copilot/_permissions.py	Updates execute-bit repair logic for SDK-bundled binaries (no world-exec).
README.md	Replaces token examples with placeholders.

---

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