Upstream sync: post-v1.0.0-beta.4 round 2 (#1299, #1315) + schema 1.0.49

[krukow]

Ports the SessionFs SQLite support from upstream PR #1299, updates examples/permission_bash.clj per upstream PR #1315, and bumps the pinned schema version from 1.0.49-1 to 1.0.49.

Changes

SessionFs SQLite support (upstream PR #1299)

• New optional :sqlite {:query :exists} sub-provider for the provider-style createSessionFsHandler factory. Low-level handlers expose flat :sqlite-query / :sqlite-exists keys; the adapter bridges between them.
• Clients advertise support via :capabilities {:sqlite true} under :session-fs; the value is forwarded on sessionFs.setProvider and validated at session creation (throws when capabilities.sqlite is declared but the provider lacks :sqlite).
• queryType is coerced from the wire string to an idiomatic keyword (#{:exec :query :run}) before reaching the handler.
• SQL bind-parameter map keys (e.g. $userId) bypass kebab-case conversion via an escape hatch in protocol/normalize-incoming.
• Result row column-name keys (e.g. :user_id, :created_at) round-trip verbatim on the outgoing wire path via a new preserve-outgoing-opaque-fields escape hatch in protocol.clj, matching upstream Node.js semantics. (Found via multi-model code review.)
• SQLite handler exceptions propagate as JSON-RPC errors, matching upstream Node behavior.

Schema 1.0.49

• .copilot-schema-version advanced from 1.0.49-1 to 1.0.49
• Additive only: new named enum types, format annotations, and the new sqlite RPC methods
• Regenerated event_specs.clj reflects the new enums (upstream PRs #1305, #1307, #1327, #1333)

Examples

• Updated examples/permission_bash.clj from deprecated :approved to current :approve-once (upstream PR #1315)

Validation

Check	Result
bb test	✅ 269 tests / 1275 assertions, 0 failures
bb validate-docs	✅ 13 files, 0 warnings
./run-all-examples.sh	✅ all examples completed
E2E	⚠️ 2 pre-existing failures unrelated to this PR — local CLI 1.0.51-2 drift from pinned schema 1.0.49

Multi-model code review

Parallel reviews via Claude Opus 4.7 and GPT-5.5 both independently identified a HIGH severity bug:

#	Finding	Source	Severity	Decision
1	Outgoing SQL row column names mangled by recursive kebab→camelCase	Opus + GPT	HIGH	Fixed — preserve-outgoing-opaque-fields escape hatch + regression test
2	capabilities.sqlite validation only checks :sqlite-query	GPT	MEDIUM	Dismissed — session-fs-provider? already validates both arities; mirrors upstream client.ts:466
3	Channel-returned exceptions in await-session-fs-result	GPT	MEDIUM	Out of scope — pre-existing, applies to all FS handlers
4	Unused ::sqlite-rows/::sqlite-columns used wrong seq? predicate	Opus	LOW	Fixed — changed to (s/coll-of …)

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

[Copilot]

Pull request overview

Ports upstream SessionFs SQLite support (PR #1299), updates an example per upstream (PR #1315), and bumps pinned Copilot schema assets to 1.0.49 to keep the Clojure SDK wire layer aligned with upstream.

Changes:

• Add SessionFs SQLite RPC support (sessionFs.sqliteQuery, sessionFs.sqliteExists) including capability advertisement and handler/provider adaptation.
• Add protocol escape hatches to preserve opaque SQL bind-parameter keys on incoming requests and preserve row column keys on outgoing sqlite results.
• Bump pinned schema version to 1.0.49 and regenerate generated event specs; update permission_bash example and changelog/docs accordingly.

Show a summary per file

File	Description
test/github/copilot_sdk/mock_server.clj	Mock server now responds to sessionFs.setProvider for new capability forwarding tests.
test/github/copilot_sdk/integration_test.clj	Adds integration tests covering sqlite adapter behavior, RPC dispatch, capability forwarding, and opaque key preservation.
src/github/copilot_sdk/specs.clj	Extends specs with session-fs capabilities, optional sqlite handler keys, and sqlite query type/result shapes.
src/github/copilot_sdk/session.clj	Implements sqlite adapter wiring, queryType coercion, and capability validation on handler installation.
src/github/copilot_sdk/protocol.clj	Adds incoming/outgoing opaque-field preservation for sqlite bind params and result row keys.
src/github/copilot_sdk/generated/event_specs.clj	Regenerated specs from updated schemas (enum tightening, etc.).
src/github/copilot_sdk/client.clj	Routes new sqlite RPC methods and forwards :session-fs.capabilities on sessionFs.setProvider.
schemas/session-events.schema.json	Upstream schema refresh (formats/enums/refs) as part of 1.0.49 bump.
schemas/api.schema.json	Upstream API schema refresh adding sqlite RPCs and related type refactors as part of 1.0.49 bump.
schemas/README.md	Updates pinned schema version text to 1.0.49.
.copilot-schema-version	Bumps pinned schema version to 1.0.49.
examples/permission_bash.clj	Updates permission decision kind to :approve-once.
doc/reference/API.md	Documents optional sqlite support for SessionFs providers/handlers.
CHANGELOG.md	Adds Unreleased entries for sqlite support + schema bump + example fix.

Copilot's findings

• Files reviewed: 13/14 changed files
• Comments generated: 2