Fix hooks and permission dispatch for sub-agent sessions

.claude/skills/agentic-merge-reference-impl/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: agentic-merge-reference-impl
+description: Merge reference implementation changes from the official Copilot SDK into this Java SDK.
+license: MIT
+---
+
+Follow instructions in the  [agentic-merge-reference-impl prompt](../../../.github/prompts/agentic-merge-reference-impl.prompt.md) to merge reference implementation changes from the official Copilot SDK into this Java SDK.

.gitattributes

@@ -1 +1,2 @@
-.github/workflows/*.lock.yml linguist-generated=true merge=ours
+.github/workflows/*.lock.yml linguist-generated=true merge=ours
+src/generated/java/** eol=lf linguist-generated=true

.github/aw/actions-lock.json

@@ -5,6 +5,11 @@
       "version": "v8",
       "sha": "ed597411d8f924073f98dfc5c65a23a2325f34cd"
     },
+    "actions/github-script@v9": {
+      "repo": "actions/github-script",
+      "version": "v9",
+      "sha": "373c709c69115d41ff229c7e5df9f8788daa9553"
+    },
     "actions/setup-java@v4": {
       "repo": "actions/setup-java",
       "version": "v4",
@@ -15,10 +20,10 @@
       "version": "v4",
       "sha": "49933ea5288caeca8642d1e84afbd3f7d6820020"
     },
-    "github/gh-aw-actions/setup@v0.63.1": {
+    "github/gh-aw-actions/setup@v0.68.3": {
       "repo": "github/gh-aw-actions/setup",
-      "version": "v0.63.1",
-      "sha": "53e09ec0be6271e81a69f51ef93f37212c8834b0"
+      "version": "v0.68.3",
+      "sha": "ba90f2186d7ad780ec640f364005fa24e797b360"
     },
     "github/gh-aw/actions/setup@v0.51.6": {
       "repo": "github/gh-aw/actions/setup",

.github/copilot-instructions.md

@@ -9,7 +9,7 @@ These instructions guide GitHub Copilot when assisting with this repository. The
 - **Tech Stack**: Java 17+, Maven, Jackson for JSON, JUnit for testing
 - **Purpose**: Provide a Java SDK for programmatic control of GitHub Copilot CLI
 - **Architecture**: JSON-RPC client communicating with Copilot CLI over stdio
-- **Key Goals**: Maintain parity with upstream .NET SDK while following Java idioms
+- **Key Goals**: Maintain parity with reference implementation .NET SDK while following Java idioms
 
 ## Build & Test Commands
 
@@ -77,21 +77,21 @@ mvn test -Dtest=CopilotClientTest
 
 - `com.github.copilot.sdk` - Core classes (CopilotClient, CopilotSession, JsonRpcClient)
 - `com.github.copilot.sdk.json` - DTOs, request/response types, handler interfaces (SessionConfig, MessageOptions, ToolDefinition, etc.)
-- `com.github.copilot.sdk.events` - Event types for session streaming (AssistantMessageEvent, SessionIdleEvent, ToolExecutionStartEvent, etc.)
+- `com.github.copilot.sdk.generated` - Generated event types for session streaming (SessionEvent, AssistantMessageEvent, SessionIdleEvent, ToolExecutionStartEvent, etc.)
 
 ### Test Infrastructure
 
 Tests use the official copilot-sdk test harness from `https://github.com/github/copilot-sdk`. The harness is automatically cloned during `generate-test-resources` phase to `target/copilot-sdk/`.
 
 - **E2ETestContext** - Manages test environment with CapiProxy for deterministic API responses
 - **CapiProxy** - Node.js-based replaying proxy using YAML snapshots from `test/snapshots/`
-- Test snapshots are stored in the upstream repo's `test/snapshots/` directory
+- Test snapshots are stored in the reference implementation repo's `test/snapshots/` directory
 
 ## Key Conventions
 
-### Upstream Merging
+### Reference Implementation Merging
 
-This SDK tracks the official .NET implementation at `github/copilot-sdk`. The `.lastmerge` file contains the last merged upstream commit hash. Use the `agentic-merge-upstream` skill (see `.github/prompts/agentic-merge-upstream.prompt.md`) to port changes.
+This SDK tracks the official .NET implementation at `github/copilot-sdk`. The `.lastmerge` file contains the last merged reference implementation commit hash. Use the `agentic-merge-reference-impl` skill (see `.github/prompts/agentic-merge-reference-impl.prompt.md`) to port changes.
 
 When porting from .NET:
 - Adapt to Java idioms, don't copy C# patterns directly
@@ -213,11 +213,13 @@ Test method names are converted to lowercase snake_case for snapshot filenames t
 
 ### What NOT to Modify
 
+- **DO NOT** edit, create, or delete any file under `src/generated/java/` — these are **auto-generated** by `scripts/codegen/java.ts` and will be overwritten. To update generated code, run `mvn generate-sources -Pcodegen` or trigger the `update-copilot-dependency.yml` workflow.
+   If you need to get a new version of the schemas, run `mvn generate-sources -Pupdate-schemas-from-npm-artifact` before running the code generator.
 - **DO NOT** edit `.github/agents/` directory - these contain instructions for other agents
 - **DO NOT** modify `target/` directory - this contains build artifacts
 - **DO NOT** edit `pom.xml` dependencies without careful consideration - this SDK has minimal dependencies by design
 - **DO NOT** change the Jackson version without testing against all serialization patterns
-- **DO NOT** modify test snapshots in `target/copilot-sdk/test/snapshots/` - these come from upstream
+- **DO NOT** modify test snapshots in `target/copilot-sdk/test/snapshots/` - these come from reference implementation
 - **DO NOT** alter the Eclipse formatter configuration in `pom.xml` without team consensus
 - **DO NOT** remove or skip Checkstyle or Spotless checks
 
@@ -278,7 +280,7 @@ The repository has a pre-commit hook (`.githooks/pre-commit`) that is **automati
 - Include tests for new functionality
 - Update documentation if adding/changing public APIs
 - Reference related issues using `#issue-number`
-- For upstream merges, follow the `agentic-merge-upstream` skill workflow
+- For reference implementation merges, follow the `agentic-merge-reference-impl` skill workflow
 
 ## Development Workflow
 
@@ -299,12 +301,12 @@ The release process is automated via the `publish-maven.yml` GitHub Actions work
    - Converts the `## [Unreleased]` section to `## [version] - date`
    - Creates a new empty `## [Unreleased]` section at the top
    - Updates version comparison links at the bottom of CHANGELOG.md
-   - Injects the upstream SDK commit hash (from `.lastmerge`) as a `> **Upstream sync:**` blockquote in both the new `[Unreleased]` section and the released version section
+   - Injects the reference implementation SDK commit hash (from `.lastmerge`) as a `> **Reference implementation sync:**` blockquote in both the new `[Unreleased]` section and the released version section
 
-2. **Upstream Sync Tracking**: Each release records which commit from the official `github/copilot-sdk` it is synced to:
+2. **Reference Implementation Sync Tracking**: Each release records which commit from the official `github/copilot-sdk` it is synced to:
    - The `.lastmerge` file is read during the release workflow
    - The commit hash is injected into `CHANGELOG.md` under the release heading
-   - Format: `> **Upstream sync:** [\`github/copilot-sdk@SHORT_HASH\`](link-to-commit)`
+   - Format: `> **Reference implementation sync:** [\`github/copilot-sdk@SHORT_HASH\`](link-to-commit)`
 
 3. **Documentation Updates**: README.md and jbang-example.java are updated with the new version.
 
@@ -316,3 +318,4 @@ The release process is automated via the `publish-maven.yml` GitHub Actions work
 5. **Rollback**: If the release fails, the documentation commit is automatically reverted
 
 The workflow is triggered manually via workflow_dispatch with optional version parameters.
+