Update documentation for PR #52 upstream sync features

Add coverage for slash commands, elicitation (UI dialogs), session
capabilities, SessionUiApi, and getSessionMetadata across:
- CHANGELOG.md: Unreleased section with Added/Fixed entries
- documentation.md: event types, SessionConfig reference, resume options
- advanced.md: table of contents entries for new sections
- site.xml: navigation menu items

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

Author: brunoborges

CHANGELOG.md

@@ -8,7 +8,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-> **Upstream sync:** [`github/copilot-sdk@4088739`](https://github.com/github/copilot-sdk/commit/40887393a9e687dacc141a645799441b0313ff15)
+> **Upstream sync:** [`github/copilot-sdk@f7fd757`](https://github.com/github/copilot-sdk/commit/f7fd7577109d64e261456b16c49baa56258eae4e)
+
+### Added
+
+- Slash commands — register `/command` handlers invoked from the CLI TUI via `SessionConfig.setCommands()` (upstream: [`f7fd757`](https://github.com/github/copilot-sdk/commit/f7fd757))
+- `CommandDefinition`, `CommandContext`, `CommandHandler`, `CommandWireDefinition` — types for defining and handling slash commands
+- `CommandExecuteEvent` — event dispatched when a registered slash command is executed
+- Elicitation (UI dialogs) — incoming handler via `SessionConfig.setOnElicitationRequest()` and outgoing convenience methods via `session.getUi()` (upstream: [`f7fd757`](https://github.com/github/copilot-sdk/commit/f7fd757))
+- `ElicitationContext`, `ElicitationHandler`, `ElicitationParams`, `ElicitationResult`, `ElicitationResultAction`, `ElicitationSchema`, `InputOptions` — types for elicitation
+- `ElicitationRequestedEvent` — event dispatched when an elicitation request is received
+- `SessionUiApi` — convenience API on `session.getUi()` for `confirm()`, `select()`, `input()`, and `elicitation()` calls
+- `SessionCapabilities` and `SessionUiCapabilities` — session capability reporting populated from create/resume response
+- `CapabilitiesChangedEvent` — event dispatched when session capabilities are updated
+- `CopilotClient.getSessionMetadata(String)` — O(1) session lookup by ID
+- `GetSessionMetadataResponse` — response type for `getSessionMetadata`
+
+### Fixed
+
+- Permission events already resolved by a pre-hook now short-circuit before invoking the client-side handler
+- `SessionUiApi` Javadoc now uses valid Java null-check syntax instead of `?.`
+- README updated to say "GitHub Copilot CLI 1.0.17" instead of "GitHub Copilot 1.0.17"
 
 ## [0.2.1-java.1] - 2026-04-02
 

src/site/markdown/advanced.md

@@ -47,6 +47,13 @@ This guide covers advanced scenarios for extending and customizing your Copilot
   - [Custom Event Error Handler](#Custom_Event_Error_Handler)
   - [Event Error Policy](#Event_Error_Policy)
 - [OpenTelemetry](#OpenTelemetry)
+- [Slash Commands](#Slash_Commands)
+  - [Registering Commands](#Registering_Commands)
+- [Elicitation (UI Dialogs)](#Elicitation_UI_Dialogs)
+  - [Incoming Elicitation Handler](#Incoming_Elicitation_Handler)
+  - [Session Capabilities](#Session_Capabilities)
+  - [Outgoing Elicitation via session.getUi()](#Outgoing_Elicitation_via_session.getUi)
+- [Getting Session Metadata by ID](#Getting_Session_Metadata_by_ID)
 
 ---
 

src/site/markdown/documentation.md

@@ -245,6 +245,19 @@ The SDK supports event types organized by category. All events extend `AbstractS
 |-------|-------------|-------------|
 | `CommandQueuedEvent` | `command.queued` | A command was queued for execution |
 | `CommandCompletedEvent` | `command.completed` | A queued command completed |
+| `CommandExecuteEvent` | `command.execute` | A registered slash command was dispatched for execution |
+
+### Elicitation Events
+
+| Event | Type String | Description |
+|-------|-------------|-------------|
+| `ElicitationRequestedEvent` | `elicitation.requested` | An elicitation (UI dialog) request was received |
+
+### Capability Events
+
+| Event | Type String | Description |
+|-------|-------------|-------------|
+| `CapabilitiesChangedEvent` | `capabilities.changed` | Session capabilities were updated |
 
 ### Plan Mode Events
 
@@ -633,6 +646,8 @@ When resuming a session, you can optionally reconfigure many settings. This is u
 | `skillDirectories` | Directories to load skills from |
 | `disabledSkills` | Skills to disable |
 | `infiniteSessions` | Configure infinite session behavior |
+| `commands` | Slash command definitions for the resumed session |
+| `onElicitationRequest` | Handler for incoming elicitation requests |
 | `disableResume` | When `true`, resumes without emitting a `session.resume` event |
 | `onEvent` | Event handler registered before session resumption |
 
@@ -691,6 +706,8 @@ Complete list of all `SessionConfig` options for `createSession()`:
 | `skillDirectories` | List<String> | Directories to load skills from | [Skills](advanced.html#Skills_Configuration) |
 | `disabledSkills` | List<String> | Skills to disable by name | [Skills](advanced.html#Skills_Configuration) |
 | `configDir` | String | Custom configuration directory | [Config Dir](advanced.html#Custom_Configuration_Directory) |
+| `commands` | List<CommandDefinition> | Slash command definitions | [Slash Commands](advanced.html#Slash_Commands) |
+| `onElicitationRequest` | ElicitationHandler | Handler for incoming elicitation requests | [Elicitation](advanced.html#Elicitation_UI_Dialogs) |
 | `onEvent` | Consumer<AbstractSessionEvent> | Event handler registered before session creation | [Early Event Registration](advanced.html#Early_Event_Registration) |
 
 ### Cloning SessionConfig

src/site/site.xml

@@ -59,6 +59,9 @@
             <item name="BYOK" href="advanced.html#Bring_Your_Own_Key_.28BYOK.29"/>
             <item name="Infinite Sessions" href="advanced.html#Infinite_Sessions"/>
             <item name="MCP Servers" href="advanced.html#MCP_Servers"/>
+            <item name="Slash Commands" href="advanced.html#Slash_Commands"/>
+            <item name="Elicitation" href="advanced.html#Elicitation_UI_Dialogs"/>
+            <item name="Session Metadata" href="advanced.html#Getting_Session_Metadata_by_ID"/>
             <item name="Session Hooks" href="hooks.html"/>
         </menu>