diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 0c213e61c0..c6959d3089 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -1 +1 @@ -* @github/copilot-sdk-java +* @github/copilot-sdk diff --git a/.github/actions/setup-copilot/action.yml b/.github/actions/setup-copilot/action.yml index dcc99b8a70..1288a1d89b 100644 --- a/.github/actions/setup-copilot/action.yml +++ b/.github/actions/setup-copilot/action.yml @@ -4,15 +4,36 @@ outputs: cli-path: description: "Path to the Copilot CLI executable" value: ${{ steps.cli-path.outputs.path }} + cli-version: + description: "Pinned @github/copilot version installed (read from pom.xml)" + value: ${{ steps.cli-version.outputs.version }} runs: using: "composite" steps: - - uses: actions/setup-node@v6 + - uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v6 with: node-version: 22 - - name: Install Copilot CLI - run: npm install -g @github/copilot + - name: Read pinned @github/copilot version from pom.xml + id: cli-version shell: bash + # The version is the SINGLE SOURCE OF TRUTH for the Copilot CLI version + # used across all CI paths. It is kept in sync with the reference + # implementation pinned in .lastmerge by + # .github/scripts/reference-impl-sync/sync-cli-version-from-reference-impl.sh. + run: | + PROP="readonly-copilot-sdk-ref-impl-version-from-lastmerge-file-updated-by-reference-impl-sync" + VERSION=$(sed -n "s|.*<${PROP}>\(.*\).*|\1|p" pom.xml | head -n 1 | tr -d '[:space:]') + if [[ -z "$VERSION" || "$VERSION" == "PRIMER_TO_REPLACE" ]]; then + echo "::error::Could not read pinned @github/copilot version from pom.xml property <${PROP}>" >&2 + exit 1 + fi + echo "Pinned @github/copilot version: $VERSION" + echo "version=$VERSION" >> "$GITHUB_OUTPUT" + - name: Install Copilot CLI (pinned to pom.xml version) + shell: bash + env: + CLI_VERSION: ${{ steps.cli-version.outputs.version }} + run: npm install -g "@github/copilot@${CLI_VERSION}" - name: Set CLI path id: cli-path run: echo "path=$(which copilot)" >> $GITHUB_OUTPUT diff --git a/.github/actions/test-report/action.yml b/.github/actions/test-report/action.yml index 43d45f287a..6ac1fcbc76 100644 --- a/.github/actions/test-report/action.yml +++ b/.github/actions/test-report/action.yml @@ -4,28 +4,33 @@ inputs: report-path: description: "Path to the test report XML files (glob pattern)" required: false - default: "target/surefire-reports/TEST-*.xml" + default: "target/{surefire-reports*,failsafe-reports}/TEST-*.xml" jacoco-path: description: "Path to the JaCoCo XML report" required: false default: "target/site/jacoco-coverage/jacoco.xml" + jacoco-csv-path: + description: "Path to the JaCoCo CSV report" + required: false + default: "target/site/jacoco-coverage/jacoco.csv" check-name: description: "Name for the check run" required: false default: "Java SDK Test Results" + title: + description: "Title for the test report summary" + required: false + default: "Copilot Java SDK :: Test Results" runs: using: "composite" steps: - name: Generate Test Summary shell: bash run: | - echo "## πŸ§ͺ Copilot Java SDK :: Test Results" >> $GITHUB_STEP_SUMMARY + echo "## πŸ§ͺ ${{ inputs.title }}" >> $GITHUB_STEP_SUMMARY echo "" >> $GITHUB_STEP_SUMMARY - REPORT_DIR=$(dirname "${{ inputs.report-path }}") - REPORT_PATTERN=$(basename "${{ inputs.report-path }}") - - if [ -d "$REPORT_DIR" ]; then + if ls ${{ inputs.report-path }} 1>/dev/null 2>&1; then TESTS_RUN=$(grep -h "tests=" ${{ inputs.report-path }} 2>/dev/null | sed 's/.*tests="\([0-9]*\)".*/\1/' | awk '{s+=$1} END {print s}') FAILURES=$(grep -h "failures=" ${{ inputs.report-path }} 2>/dev/null | sed 's/.*failures="\([0-9]*\)".*/\1/' | awk '{s+=$1} END {print s}') ERRORS=$(grep -h "errors=" ${{ inputs.report-path }} 2>/dev/null | sed 's/.*errors="\([0-9]*\)".*/\1/' | awk '{s+=$1} END {print s}') @@ -83,6 +88,7 @@ runs: shell: bash run: | JACOCO_XML="${{ inputs.jacoco-path }}" + JACOCO_CSV="${{ inputs.jacoco-csv-path }}" if [ -f "$JACOCO_XML" ]; then echo "" >> $GITHUB_STEP_SUMMARY @@ -142,6 +148,36 @@ runs: echo "| πŸ“ Lines | ${LINE_COVERED:-0} | ${LINE_MISSED:-0} | ${LINE_PCT}% |" >> $GITHUB_STEP_SUMMARY echo "| πŸ”§ Methods | ${METHOD_COVERED:-0} | ${METHOD_MISSED:-0} | ${METHOD_PCT}% |" >> $GITHUB_STEP_SUMMARY echo "| πŸ“¦ Classes | ${CLASS_COVERED:-0} | ${CLASS_MISSED:-0} | ${CLASS_PCT}% |" >> $GITHUB_STEP_SUMMARY + + if [ -f "$JACOCO_CSV" ]; then + extract_instruction_scope() { + local scope=$1 + awk -F',' -v scope="$scope" -v generated_prefix="com.github.copilot.generated" ' + NR > 1 { + is_generated = index($2, generated_prefix) == 1 + if ((scope == "generated" && is_generated) || + (scope == "handwritten" && !is_generated)) { + missed += $4 + covered += $5 + } + } + END { print covered + 0 "," missed + 0 } + ' "$JACOCO_CSV" + } + + IFS=, read -r HANDWRITTEN_COVERED HANDWRITTEN_MISSED <<< "$(extract_instruction_scope handwritten)" + IFS=, read -r GENERATED_COVERED GENERATED_MISSED <<< "$(extract_instruction_scope generated)" + HANDWRITTEN_PCT=$(calc_pct "${HANDWRITTEN_COVERED:-0}" "${HANDWRITTEN_MISSED:-0}") + GENERATED_PCT=$(calc_pct "${GENERATED_COVERED:-0}" "${GENERATED_MISSED:-0}") + + echo "" >> $GITHUB_STEP_SUMMARY + echo "### Coverage by Code Origin (Instructions)" >> $GITHUB_STEP_SUMMARY + echo "" >> $GITHUB_STEP_SUMMARY + echo "| Origin | Covered | Missed | Coverage |" >> $GITHUB_STEP_SUMMARY + echo "|--------|---------|--------|----------|" >> $GITHUB_STEP_SUMMARY + echo "| ✍️ Handwritten | ${HANDWRITTEN_COVERED:-0} | ${HANDWRITTEN_MISSED:-0} | ${HANDWRITTEN_PCT}% |" >> $GITHUB_STEP_SUMMARY + echo "| πŸ€– Generated | ${GENERATED_COVERED:-0} | ${GENERATED_MISSED:-0} | ${GENERATED_PCT}% |" >> $GITHUB_STEP_SUMMARY + fi else echo "" >> $GITHUB_STEP_SUMMARY echo "## πŸ“Š Code Coverage" >> $GITHUB_STEP_SUMMARY diff --git a/.github/aw/actions-lock.json b/.github/aw/actions-lock.json index 11e06d9b9e..71291dd03b 100644 --- a/.github/aw/actions-lock.json +++ b/.github/aw/actions-lock.json @@ -1,5 +1,15 @@ { "entries": { + "actions/checkout@v6.0.2": { + "repo": "actions/checkout", + "version": "v6.0.2", + "sha": "de0fac2e4500dabe0009e67214ff5f5447ce83dd" + }, + "actions/download-artifact@v8.0.1": { + "repo": "actions/download-artifact", + "version": "v8.0.1", + "sha": "3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c" + }, "actions/github-script@v8": { "repo": "actions/github-script", "version": "v8", @@ -10,6 +20,11 @@ "version": "v9", "sha": "373c709c69115d41ff229c7e5df9f8788daa9553" }, + "actions/github-script@v9.0.0": { + "repo": "actions/github-script", + "version": "v9.0.0", + "sha": "3a2844b7e9c422d3c10d287c895573f7108da1b3" + }, "actions/setup-java@v4": { "repo": "actions/setup-java", "version": "v4", @@ -20,15 +35,15 @@ "version": "v4", "sha": "49933ea5288caeca8642d1e84afbd3f7d6820020" }, - "github/gh-aw-actions/setup-cli@v0.68.3": { - "repo": "github/gh-aw-actions/setup-cli", - "version": "v0.68.3", - "sha": "ba90f2186d7ad780ec640f364005fa24e797b360" + "actions/upload-artifact@v7.0.1": { + "repo": "actions/upload-artifact", + "version": "v7.0.1", + "sha": "043fb46d1a93c77aae656e7c1c64a875d1fc6a0a" }, - "github/gh-aw-actions/setup@v0.68.3": { + "github/gh-aw-actions/setup@v0.74.4": { "repo": "github/gh-aw-actions/setup", - "version": "v0.68.3", - "sha": "ba90f2186d7ad780ec640f364005fa24e797b360" + "version": "v0.74.4", + "sha": "d3abfe96a194bce3a523ed2093ddedd5704cdf62" }, "github/gh-aw/actions/setup@v0.51.6": { "repo": "github/gh-aw/actions/setup", diff --git a/.github/badges/jacoco-generated.svg b/.github/badges/jacoco-generated.svg new file mode 100644 index 0000000000..9422a5629e --- /dev/null +++ b/.github/badges/jacoco-generated.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + coverage generated + coverage generated + 72.8% + 72.8% + + diff --git a/.github/badges/jacoco-handwritten.svg b/.github/badges/jacoco-handwritten.svg new file mode 100644 index 0000000000..c7f675e6e9 --- /dev/null +++ b/.github/badges/jacoco-handwritten.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + coverage handwritten + coverage handwritten + 82.5% + 82.5% + + diff --git a/.github/badges/jacoco.svg b/.github/badges/jacoco.svg index 620c8d52a2..bcfcc44d75 100644 --- a/.github/badges/jacoco.svg +++ b/.github/badges/jacoco.svg @@ -1,18 +1,18 @@ - + - + - - - + + + - coverage - coverage - 82.7% - 82.7% + coverage + coverage + 78.3% + 78.3% diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index d029784219..5c5c0ff8ec 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -75,9 +75,9 @@ mvn test -Dtest=CopilotClientTest ### Package Structure -- `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.generated` - Generated event types for session streaming (SessionEvent, AssistantMessageEvent, SessionIdleEvent, ToolExecutionStartEvent, etc.) +- `com.github.copilot` - Core classes (CopilotClient, CopilotSession, JsonRpcClient) +- `com.github.copilot.rpc` - DTOs, request/response types, handler interfaces (SessionConfig, MessageOptions, ToolDefinition, etc.) +- `com.github.copilot.generated` - Generated event types for session streaming (SessionEvent, AssistantMessageEvent, SessionIdleEvent, ToolExecutionStartEvent, etc.) ### Test Infrastructure @@ -222,6 +222,8 @@ Test method names are converted to lowercase snake_case for snapshot filenames t - **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 +- **YOU MUST ALWAYS** run `gh aw compile ` after editing any `.github/workflows/*.md` agentic workflow source file to regenerate the corresponding `.lock.yml`. The lock file contains a content hash of the frontmatter β€” any edit to the `.md` without recompiling will cause the workflow to fail at runtime with a "lock file out of sync" error. +- **DO NOT** edit `.github/workflows/*.lock.yml` directly β€” these are auto-generated by `gh aw compile` from the `.md` source files. ### Security Guidelines diff --git a/.github/dependabot.yml b/.github/dependabot.yml index 03f0f715ae..04d5ab5f47 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -1,13 +1,5 @@ version: 2 updates: - - package-ecosystem: "npm" - directory: "/scripts/codegen" - schedule: - interval: "daily" - open-pull-requests-limit: 1 - allow: - - dependency-name: "@github/copilot" - - package-ecosystem: "github-actions" directory: "/" schedule: diff --git a/.github/prompts/agentic-merge-reference-impl.prompt.md b/.github/prompts/agentic-merge-reference-impl.prompt.md index 88cc2bdfe0..d5c3528b3f 100644 --- a/.github/prompts/agentic-merge-reference-impl.prompt.md +++ b/.github/prompts/agentic-merge-reference-impl.prompt.md @@ -135,11 +135,11 @@ For each change in the reference implementation diff, determine: | reference implementation (.NET) | Java SDK Equivalent | |------------------------------------|--------------------------------------------------------| -| `dotnet/src/Client.cs` | `src/main/java/com/github/copilot/sdk/CopilotClient.java` | -| `dotnet/src/Session.cs` | `src/main/java/com/github/copilot/sdk/CopilotSession.java` | -| `dotnet/src/Types.cs` | `src/main/java/com/github/copilot/sdk/types/*.java` | +| `dotnet/src/Client.cs` | `src/main/java/com/github/copilot/CopilotClient.java` | +| `dotnet/src/Session.cs` | `src/main/java/com/github/copilot/CopilotSession.java` | +| `dotnet/src/Types.cs` | `src/main/java/com/github/copilot/types/*.java` | | `dotnet/src/Generated/*.cs` | ❌ **DO NOT TOUCH** `src/generated/java/**` β€” see top of this file | -| `dotnet/test/*.cs` | `src/test/java/com/github/copilot/sdk/*Test.java` | +| `dotnet/test/*.cs` | `src/test/java/com/github/copilot/*Test.java` | | `docs/getting-started.md` | `README.md` and `src/site/markdown/*.md` | | `docs/*.md` (new files) | `src/site/markdown/*.md` + update `src/site/site.xml` | | `sdk-protocol-version.json` | (embedded in Java code or resource file) | @@ -209,7 +209,7 @@ This creates a clear history of changes that can be reviewed in the Pull Request Follow the existing Java SDK patterns: - Use Jackson for JSON serialization (`ObjectMapper`) - Use Java records for DTOs where appropriate -- Follow the existing package structure under `com.github.copilot.sdk` +- Follow the existing package structure under `com.github.copilot` - Maintain backward compatibility when possible - **Match the style of surrounding code** - Consistency with existing code is more important than reference implementation patterns - **Prefer existing abstractions** - If the Java SDK already solves a problem differently than .NET, keep the Java approach @@ -230,7 +230,7 @@ git diff "$LAST_REFERENCE_IMPL_COMMIT"..origin/main --stat -- test/snapshots/ For each new or modified test file in `dotnet/test/`: -1. **Create corresponding Java test class** in `src/test/java/com/github/copilot/sdk/` +1. **Create corresponding Java test class** in `src/test/java/com/github/copilot/` 2. **Follow existing test patterns** - Look at existing tests like `PermissionsTest.java` for structure 3. **Use the E2ETestContext** infrastructure for tests that need the test harness 4. **Match snapshot directory names** - Test snapshots in `test/snapshots/` must match the directory name used in `ctx.configureForTest()` @@ -239,10 +239,10 @@ For each new or modified test file in `dotnet/test/`: | reference implementation Test (.NET) | Java SDK Test | |-----------------------------|--------------------------------------------------------| -| `dotnet/test/AskUserTests.cs` | `src/test/java/com/github/copilot/sdk/AskUserTest.java` | -| `dotnet/test/HooksTests.cs` | `src/test/java/com/github/copilot/sdk/HooksTest.java` | -| `dotnet/test/ClientTests.cs` | `src/test/java/com/github/copilot/sdk/CopilotClientTest.java` | -| `dotnet/test/*Tests.cs` | `src/test/java/com/github/copilot/sdk/*Test.java` | +| `dotnet/test/AskUserTests.cs` | `src/test/java/com/github/copilot/AskUserTest.java` | +| `dotnet/test/HooksTests.cs` | `src/test/java/com/github/copilot/HooksTest.java` | +| `dotnet/test/ClientTests.cs` | `src/test/java/com/github/copilot/CopilotClientTest.java` | +| `dotnet/test/*Tests.cs` | `src/test/java/com/github/copilot/*Test.java` | ### Test Snapshot Compatibility @@ -353,7 +353,7 @@ var session = client.createSession( Explain the request/response objects and their properties. -See [FeatureHandler](apidocs/com/github/copilot/sdk/json/FeatureHandler.html) Javadoc for more details. +See [FeatureHandler](apidocs/com/github/copilot/rpc/FeatureHandler.html) Javadoc for more details. ``` ### Verify Documentation Consistency diff --git a/.github/prompts/coding-agent-merge-reference-impl-instructions.md b/.github/prompts/coding-agent-merge-reference-impl-instructions.md index c93af9a1a5..5ae1621db6 100644 --- a/.github/prompts/coding-agent-merge-reference-impl-instructions.md +++ b/.github/prompts/coding-agent-merge-reference-impl-instructions.md @@ -1,5 +1,5 @@ - - + + Follow the agentic-merge-reference-impl prompt at .github/prompts/agentic-merge-reference-impl.prompt.md to port reference implementation changes to the Java SDK. diff --git a/.github/prompts/documentation-coverage.prompt.md b/.github/prompts/documentation-coverage.prompt.md index 80284c6a9c..cc627e1f35 100644 --- a/.github/prompts/documentation-coverage.prompt.md +++ b/.github/prompts/documentation-coverage.prompt.md @@ -17,13 +17,13 @@ Extract all public classes, methods, and features from the SDK: ```bash # List all public classes in core package -grep -l "public class\|public interface\|public enum" src/main/java/com/github/copilot/sdk/*.java +grep -l "public class\|public interface\|public enum" src/main/java/com/github/copilot/*.java # List all public classes in json package (DTOs) -grep -l "public class" src/main/java/com/github/copilot/sdk/json/*.java +grep -l "public class" src/main/java/com/github/copilot/rpc/*.java # List all event types -ls src/main/java/com/github/copilot/sdk/events/ +ls src/main/java/com/github/copilot/events/ ``` ### Step 2: Inventory Documentation @@ -45,7 +45,7 @@ For each major feature area, determine if it's documented: Examine `CopilotClient.java` for public methods: ```bash -grep "public.*(" src/main/java/com/github/copilot/sdk/CopilotClient.java | grep -v "@" +grep "public.*(" src/main/java/com/github/copilot/CopilotClient.java | grep -v "@" ``` | Method | Purpose | Documented In | Status | @@ -66,7 +66,7 @@ grep "public.*(" src/main/java/com/github/copilot/sdk/CopilotClient.java | grep Examine `CopilotSession.java` for public methods: ```bash -grep "public.*(" src/main/java/com/github/copilot/sdk/CopilotSession.java | grep -v "@" +grep "public.*(" src/main/java/com/github/copilot/CopilotSession.java | grep -v "@" ``` | Method | Purpose | Documented In | Status | @@ -83,7 +83,7 @@ grep "public.*(" src/main/java/com/github/copilot/sdk/CopilotSession.java | grep Examine `SessionConfig.java` for configurable options: ```bash -grep "public.*set\|private.*;" src/main/java/com/github/copilot/sdk/json/SessionConfig.java +grep "public.*set\|private.*;" src/main/java/com/github/copilot/rpc/SessionConfig.java ``` | Option | Purpose | Documented | Example Provided | @@ -103,7 +103,7 @@ grep "public.*set\|private.*;" src/main/java/com/github/copilot/sdk/json/Session Check which events are documented: ```bash -grep "TYPE_MAP.put" src/main/java/com/github/copilot/sdk/events/SessionEventParser.java +grep "TYPE_MAP.put" src/main/java/com/github/copilot/events/SessionEventParser.java ``` | Event Type | Event Class | Documented | Example | @@ -118,7 +118,7 @@ grep "TYPE_MAP.put" src/main/java/com/github/copilot/sdk/events/SessionEventPars Check `SessionHooks.java` for hook types: ```bash -grep "private.*Handler" src/main/java/com/github/copilot/sdk/json/SessionHooks.java +grep "private.*Handler" src/main/java/com/github/copilot/rpc/SessionHooks.java ``` | Hook | Handler Interface | Documented | Example | @@ -193,11 +193,11 @@ Topics that warrant dedicated documentation: ## Key Files ### Source Code -- `src/main/java/com/github/copilot/sdk/CopilotClient.java` -- `src/main/java/com/github/copilot/sdk/CopilotSession.java` -- `src/main/java/com/github/copilot/sdk/json/SessionConfig.java` -- `src/main/java/com/github/copilot/sdk/json/SessionHooks.java` -- `src/main/java/com/github/copilot/sdk/events/SessionEventParser.java` +- `src/main/java/com/github/copilot/CopilotClient.java` +- `src/main/java/com/github/copilot/CopilotSession.java` +- `src/main/java/com/github/copilot/rpc/SessionConfig.java` +- `src/main/java/com/github/copilot/rpc/SessionHooks.java` +- `src/main/java/com/github/copilot/events/SessionEventParser.java` ### Documentation - `src/site/markdown/index.md` - Landing page diff --git a/.github/prompts/test-coverage-assessment.prompt.md b/.github/prompts/test-coverage-assessment.prompt.md index c2dc3b0c4d..6233ad099e 100644 --- a/.github/prompts/test-coverage-assessment.prompt.md +++ b/.github/prompts/test-coverage-assessment.prompt.md @@ -17,10 +17,10 @@ First, examine the source code to identify all components that should be tested: ```bash # List all event classes -ls src/main/java/com/github/copilot/sdk/events/ +ls src/main/java/com/github/copilot/events/ # Check the event type mapping in SessionEventParser -grep -n "TYPE_MAP.put" src/main/java/com/github/copilot/sdk/events/SessionEventParser.java +grep -n "TYPE_MAP.put" src/main/java/com/github/copilot/events/SessionEventParser.java ``` Extract the list of all registered event types from `SessionEventParser.java`. @@ -30,7 +30,7 @@ Extract the list of all registered event types from `SessionEventParser.java`. Check `SessionHooks.java` for all available hook handlers: ```bash -grep -E "private.*Handler" src/main/java/com/github/copilot/sdk/json/SessionHooks.java +grep -E "private.*Handler" src/main/java/com/github/copilot/rpc/SessionHooks.java ``` ### Step 3: Analyze Existing Tests @@ -39,13 +39,13 @@ Examine the test files to understand current coverage: ```bash # List all test files -ls src/test/java/com/github/copilot/sdk/ +ls src/test/java/com/github/copilot/ # Check for event-related tests -grep -r "import.*events\." src/test/java/com/github/copilot/sdk/ | grep -v "\.class" +grep -r "import.*events\." src/test/java/com/github/copilot/ | grep -v "\.class" # Check for hook tests -grep -l "SessionHooks\|Hook" src/test/java/com/github/copilot/sdk/*.java +grep -l "SessionHooks\|Hook" src/test/java/com/github/copilot/*.java ``` ### Step 4: Categorize Test Coverage @@ -95,13 +95,13 @@ Prioritized list of tests to add: ## Key Files to Examine -- `src/main/java/com/github/copilot/sdk/events/SessionEventParser.java` - Event type registry -- `src/main/java/com/github/copilot/sdk/json/SessionHooks.java` - Hook definitions -- `src/main/java/com/github/copilot/sdk/CopilotSession.java` - Hook handling logic -- `src/test/java/com/github/copilot/sdk/SessionEventParserTest.java` - Event parsing tests -- `src/test/java/com/github/copilot/sdk/SessionEventsE2ETest.java` - Event E2E tests -- `src/test/java/com/github/copilot/sdk/HooksTest.java` - Hook tests -- `src/test/java/com/github/copilot/sdk/SessionEventHandlingTest.java` - Event handling tests +- `src/main/java/com/github/copilot/events/SessionEventParser.java` - Event type registry +- `src/main/java/com/github/copilot/rpc/SessionHooks.java` - Hook definitions +- `src/main/java/com/github/copilot/CopilotSession.java` - Hook handling logic +- `src/test/java/com/github/copilot/SessionEventParserTest.java` - Event parsing tests +- `src/test/java/com/github/copilot/SessionEventsE2ETest.java` - Event E2E tests +- `src/test/java/com/github/copilot/HooksTest.java` - Hook tests +- `src/test/java/com/github/copilot/SessionEventHandlingTest.java` - Event handling tests ## Verification diff --git a/.github/scripts/generate-coverage-badge.sh b/.github/scripts/generate-coverage-badge.sh index 1d124d9474..324b3194fb 100755 --- a/.github/scripts/generate-coverage-badge.sh +++ b/.github/scripts/generate-coverage-badge.sh @@ -1,5 +1,5 @@ #!/usr/bin/env bash -# Generates an SVG coverage badge from a JaCoCo CSV report. +# Generates SVG coverage badges from a JaCoCo CSV report. # # Usage: generate-coverage-badge.sh [jacoco.csv] [output-dir] # jacoco.csv - Path to JaCoCo CSV report (default: target/site/jacoco-coverage/jacoco.csv) @@ -8,39 +8,64 @@ set -euo pipefail CSV="${1:-target/site/jacoco-coverage/jacoco.csv}" BADGES_DIR="${2:-.github/badges}" +GENERATED_PREFIX="com.github.copilot.sdk.generated" if [ ! -f "$CSV" ]; then echo "⚠️ No JaCoCo CSV report found at $CSV" exit 0 fi -# Sum INSTRUCTION_MISSED and INSTRUCTION_COVERED across all rows (skip header) -read -r missed covered <<< "$(awk -F',' 'NR>1 { m+=$4; c+=$5 } END { print m, c }' "$CSV")" -total=$((missed + covered)) -if [ "$total" -eq 0 ]; then - pct="0" -else - pct=$(awk "BEGIN { printf \"%.1f\", ($covered / $total) * 100 }") - # Drop trailing .0 - pct=$(echo "$pct" | sed 's/\.0$//') -fi -echo "Coverage: ${pct}%" +calc_totals() { + local scope=$1 + awk -F',' -v scope="$scope" -v generated_prefix="$GENERATED_PREFIX" ' + NR > 1 { + is_generated = index($2, generated_prefix) == 1 + if (scope == "overall" || + (scope == "generated" && is_generated) || + (scope == "handwritten" && !is_generated)) { + missed += $4 + covered += $5 + } + } + END { print missed + 0, covered + 0 } + ' "$CSV" +} -# Choose badge color based on coverage -color="#e05d44" # red <60 -if awk "BEGIN{exit!($pct>=100)}"; then color="#4c1" # bright green -elif awk "BEGIN{exit!($pct>=90)}"; then color="#97ca00" # green -elif awk "BEGIN{exit!($pct>=80)}"; then color="#a4a61d" # yellow-green -elif awk "BEGIN{exit!($pct>=70)}"; then color="#dfb317" # yellow -elif awk "BEGIN{exit!($pct>=60)}"; then color="#fe7d37" # orange -fi +format_pct() { + local missed=$1 + local covered=$2 + local total=$((missed + covered)) + if [ "$total" -eq 0 ]; then + echo "0" + else + awk "BEGIN { printf \"%.1f\", ($covered / $total) * 100 }" | sed 's/\.0$//' + fi +} -# Generate SVG badge -mkdir -p "$BADGES_DIR" -label="coverage" -value="${pct}%" -lw=62; vw=46; tw=$((lw + vw)) -cat > "${BADGES_DIR}/jacoco.svg" <=100)}"; then color="#4c1" # bright green + elif awk "BEGIN{exit!($pct>=90)}"; then color="#97ca00" # green + elif awk "BEGIN{exit!($pct>=80)}"; then color="#a4a61d" # yellow-green + elif awk "BEGIN{exit!($pct>=70)}"; then color="#dfb317" # yellow + elif awk "BEGIN{exit!($pct>=60)}"; then color="#fe7d37" # orange + fi + echo "$color" +} + +generate_badge() { + local label=$1 + local value=$2 + local output=$3 + local pct=${value%\%} + local color + color=$(pick_color "$pct") + local lw=$(( ${#label} * 7 + 12 )) + local vw=$(( ${#value} * 7 + 16 )) + local tw=$((lw + vw)) + + cat > "$output" < @@ -60,5 +85,24 @@ cat > "${BADGES_DIR}/jacoco.svg" < EOF +} + +mkdir -p "$BADGES_DIR" + +read -r overall_missed overall_covered <<< "$(calc_totals overall)" +read -r handwritten_missed handwritten_covered <<< "$(calc_totals handwritten)" +read -r generated_missed generated_covered <<< "$(calc_totals generated)" + +overall_pct=$(format_pct "$overall_missed" "$overall_covered") +handwritten_pct=$(format_pct "$handwritten_missed" "$handwritten_covered") +generated_pct=$(format_pct "$generated_missed" "$generated_covered") + +echo "Overall coverage: ${overall_pct}%" +echo "Handwritten coverage: ${handwritten_pct}%" +echo "Generated coverage: ${generated_pct}%" + +generate_badge "coverage" "${overall_pct}%" "${BADGES_DIR}/jacoco.svg" +generate_badge "coverage handwritten" "${handwritten_pct}%" "${BADGES_DIR}/jacoco-handwritten.svg" +generate_badge "coverage generated" "${generated_pct}%" "${BADGES_DIR}/jacoco-generated.svg" -echo "Badge generated at ${BADGES_DIR}/jacoco.svg" +echo "Badges generated in ${BADGES_DIR}" diff --git a/.github/scripts/reference-impl-sync/merge-reference-impl-finish.sh b/.github/scripts/reference-impl-sync/merge-reference-impl-finish.sh index 480d43bc0a..2dda8da07f 100755 --- a/.github/scripts/reference-impl-sync/merge-reference-impl-finish.sh +++ b/.github/scripts/reference-impl-sync/merge-reference-impl-finish.sh @@ -5,8 +5,12 @@ # Finalises a reference implementation merge: # 1. Runs format + test + build (via format-and-test.sh) # 2. Updates .lastmerge to reference implementation HEAD -# 3. Commits the .lastmerge update -# 4. Pushes the branch to origin +# 3. Syncs the @github/copilot version property in pom.xml from the +# cloned reference implementation's nodejs/package.json +# 4. Syncs scripts/codegen/package.json to the same @github/copilot +# version so the code generator uses matching schemas +# 5. Commits the .lastmerge + pom.xml + codegen package updates +# 6. Pushes the branch to origin # # Usage: ./.github/scripts/reference-impl-sync/merge-reference-impl-finish.sh # ./.github/scripts/reference-impl-sync/merge-reference-impl-finish.sh --skip-tests @@ -48,8 +52,22 @@ echo "β–Έ Updating .lastmerge…" NEW_COMMIT=$(cd "$REFERENCE_IMPL_DIR" && git rev-parse origin/main) echo "$NEW_COMMIT" > "$ROOT_DIR/.lastmerge" -git add .lastmerge -git commit -m "Update .lastmerge to $NEW_COMMIT" +# ── 2b. Sync pom.xml @github/copilot version ───────────────── +# Keeps the canonical CLI version in pom.xml aligned with what the +# reference implementation pinned in .lastmerge depends on. +echo "β–Έ Syncing @github/copilot version in pom.xml from reference implementation…" +"$ROOT_DIR/.github/scripts/reference-impl-sync/sync-cli-version-from-reference-impl.sh" "$REFERENCE_IMPL_DIR" + +# ── 2c. Sync scripts/codegen @github/copilot version ───────── +# Keeps scripts/codegen/package.json in lockstep so the code generator +# uses schemas from the same CLI version that the tests run against. +# This eliminates the gap where Dependabot could race ahead of the +# reference implementation sync. +echo "β–Έ Syncing @github/copilot version in scripts/codegen/package.json…" +"$ROOT_DIR/.github/scripts/reference-impl-sync/sync-codegen-version.sh" "$REFERENCE_IMPL_DIR" + +git add .lastmerge pom.xml scripts/codegen/package.json scripts/codegen/package-lock.json +git commit -m "Update .lastmerge to $NEW_COMMIT, sync pom.xml CLI version, and update scripts/codegen @github/copilot version" # ── 3. Push branch ─────────────────────────────────────────── echo "β–Έ Pushing branch $BRANCH_NAME to origin…" diff --git a/.github/scripts/reference-impl-sync/sync-cli-version-from-reference-impl.sh b/.github/scripts/reference-impl-sync/sync-cli-version-from-reference-impl.sh new file mode 100755 index 0000000000..1d15d8aee9 --- /dev/null +++ b/.github/scripts/reference-impl-sync/sync-cli-version-from-reference-impl.sh @@ -0,0 +1,80 @@ +#!/usr/bin/env bash +# ────────────────────────────────────────────────────────────── +# sync-cli-version-from-reference-impl.sh +# +# Reads the @github/copilot version specifier from the cloned +# reference implementation's nodejs/package.json, and updates the +# corresponding property in pom.xml: +# +# +# +# This keeps the canonical Copilot CLI version (declared in pom.xml) +# in sync with whatever the reference implementation pinned in +# .lastmerge depends on. All workflows that install the Copilot CLI +# (build-test.yml β€” implicitly via cloned SDK, run-smoke-test.yml and +# update-copilot-dependency.yml β€” via the setup-copilot action) read +# this single property so every CI path uses the same CLI version. +# +# Usage: +# ./sync-cli-version-from-reference-impl.sh +# +# Or, when invoked from merge-reference-impl-finish.sh, sources +# REFERENCE_IMPL_DIR from the .merge-env file. +# ────────────────────────────────────────────────────────────── +set -euo pipefail + +# Locate the repo root by walking up from this script until we find a pom.xml. +# This is resilient to the script being moved to a different depth under +# .github/scripts/ in the future. +find_repo_root() { + local dir + dir="$(cd "$(dirname "$0")" && pwd)" + while [[ "$dir" != "/" ]]; do + if [[ -f "$dir/pom.xml" ]]; then + echo "$dir" + return 0 + fi + dir="$(dirname "$dir")" + done + echo "❌ Could not locate repo root (no pom.xml found above $(dirname "$0"))" >&2 + return 1 +} +ROOT_DIR="$(find_repo_root)" + +REFERENCE_IMPL_DIR="${1:-${REFERENCE_IMPL_DIR:-}}" +if [[ -z "$REFERENCE_IMPL_DIR" ]]; then + echo "❌ Usage: $0 " >&2 + echo " or set REFERENCE_IMPL_DIR in the environment." >&2 + exit 1 +fi + +PKG_JSON="$REFERENCE_IMPL_DIR/nodejs/package.json" +if [[ ! -f "$PKG_JSON" ]]; then + echo "❌ Cannot find $PKG_JSON" >&2 + exit 1 +fi + +# node is always available since the reference implementation uses npm. +CLI_VERSION=$(node -e \ + "const fs=require('fs');const p=JSON.parse(fs.readFileSync(process.argv[1],'utf8'));const v=(p.dependencies&&p.dependencies['@github/copilot'])||(p.devDependencies&&p.devDependencies['@github/copilot']);process.stdout.write(v||'');" \ + "$PKG_JSON") + +if [[ -z "$CLI_VERSION" ]]; then + echo "❌ Could not extract @github/copilot version from $PKG_JSON" >&2 + exit 1 +fi + +POM="$ROOT_DIR/pom.xml" +PROP="readonly-copilot-sdk-ref-impl-version-from-lastmerge-file-updated-by-reference-impl-sync" + +if ! grep -q "<${PROP}>" "$POM"; then + echo "❌ Property <${PROP}> not found in $POM" >&2 + exit 1 +fi + +# Use a portable sed invocation (works on both BSD/macOS and GNU/Linux). +TMP="$(mktemp)" +sed -E "s|<${PROP}>[^<]*|<${PROP}>${CLI_VERSION}|" "$POM" > "$TMP" +mv "$TMP" "$POM" + +echo "β–Έ Updated pom.xml: <${PROP}> = ${CLI_VERSION}" diff --git a/.github/scripts/reference-impl-sync/sync-codegen-version.sh b/.github/scripts/reference-impl-sync/sync-codegen-version.sh new file mode 100755 index 0000000000..f3baa0ab5e --- /dev/null +++ b/.github/scripts/reference-impl-sync/sync-codegen-version.sh @@ -0,0 +1,79 @@ +#!/usr/bin/env bash +# ────────────────────────────────────────────────────────────── +# sync-codegen-version.sh +# +# Updates the @github/copilot dependency in scripts/codegen/package.json +# to match the version used by the reference implementation. This keeps +# the code generator schemas in lockstep with the CLI version used for +# testing, eliminating the gap where Dependabot could race ahead. +# +# Usage: +# ./sync-codegen-version.sh +# +# Or, when invoked from merge-reference-impl-finish.sh, the directory +# is passed as $1. +# ────────────────────────────────────────────────────────────── +set -euo pipefail + +# Locate the repo root by walking up from this script until we find a pom.xml. +find_repo_root() { + local dir + dir="$(cd "$(dirname "$0")" && pwd)" + while [[ "$dir" != "/" ]]; do + if [[ -f "$dir/pom.xml" ]]; then + echo "$dir" + return 0 + fi + dir="$(dirname "$dir")" + done + echo "❌ Could not locate repo root (no pom.xml found above $(dirname "$0"))" >&2 + return 1 +} +ROOT_DIR="$(find_repo_root)" + +REFERENCE_IMPL_DIR="${1:-${REFERENCE_IMPL_DIR:-}}" +if [[ -z "$REFERENCE_IMPL_DIR" ]]; then + echo "❌ Usage: $0 " >&2 + echo " or set REFERENCE_IMPL_DIR in the environment." >&2 + exit 1 +fi + +PKG_JSON="$REFERENCE_IMPL_DIR/nodejs/package.json" +if [[ ! -f "$PKG_JSON" ]]; then + echo "❌ Cannot find $PKG_JSON" >&2 + exit 1 +fi + +# Extract the @github/copilot version from the reference implementation. +CLI_VERSION=$(node -e \ + "const fs=require('fs');const p=JSON.parse(fs.readFileSync(process.argv[1],'utf8'));const v=(p.dependencies&&p.dependencies['@github/copilot'])||(p.devDependencies&&p.devDependencies['@github/copilot']);process.stdout.write(v||'');" \ + "$PKG_JSON") + +if [[ -z "$CLI_VERSION" ]]; then + echo "❌ Could not extract @github/copilot version from $PKG_JSON" >&2 + exit 1 +fi + +CODEGEN_DIR="$ROOT_DIR/scripts/codegen" +CODEGEN_PKG="$CODEGEN_DIR/package.json" + +if [[ ! -f "$CODEGEN_PKG" ]]; then + echo "❌ Cannot find $CODEGEN_PKG" >&2 + exit 1 +fi + +# Update scripts/codegen/package.json with the new version and regenerate the lock file. +# Write the version string directly into package.json to preserve the exact specifier +# used by the reference implementation (e.g. '^1.0.43-0'). npm install normalises +# caret ranges and would silently strip the prerelease suffix, causing a mismatch +# with pom.xml. +echo "β–Έ Updating scripts/codegen/package.json: @github/copilot β†’ ${CLI_VERSION}" +cd "$CODEGEN_DIR" +node -e " +const fs = require('fs'); +const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8')); +pkg.dependencies['@github/copilot'] = process.argv[1]; +fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n'); +" "$CLI_VERSION" +npm install +echo "β–Έ Updated scripts/codegen to @github/copilot@${CLI_VERSION}" diff --git a/.github/scripts/release/test-update-changelog.sh b/.github/scripts/release/test-update-changelog.sh index ade87d6a94..b5fc8486b7 100755 --- a/.github/scripts/release/test-update-changelog.sh +++ b/.github/scripts/release/test-update-changelog.sh @@ -33,10 +33,10 @@ run_test() { if $test_func; then echo -e "${GREEN}PASSED${NC}" - ((passed++)) + passed=$((passed + 1)) else echo -e "${RED}FAILED${NC}" - ((failed++)) + failed=$((failed + 1)) fi } @@ -180,6 +180,71 @@ EOF fi } +# Test 6: Beta-java version format (e.g., 1.0.0-beta-java.N) +test_beta_java_version() { + local test_file="${TEST_DIR}/test6.md" + cat > "$test_file" << 'EOF' +# Changelog + +## [Unreleased] + +### Added +- New feature + +## [1.0.0-beta-java.1] - 2026-05-01 + +[Unreleased]: https://github.com/test/repo/compare/v1.0.0-beta-java.1...HEAD +[1.0.0-beta-java.1]: https://github.com/test/repo/compare/v0.3.0-java.2...v1.0.0-beta-java.1 +[0.3.0-java.2]: https://github.com/test/repo/releases/tag/0.3.0-java.2 +EOF + + CHANGELOG_FILE="$test_file" bash "$UPDATE_SCRIPT" 1.0.0-beta-java.2 > /dev/null 2>&1 + + # The [Unreleased] link should now point to v1.0.0-beta-java.2 + # [1.0.0-beta-java.2] should compare from v1.0.0-beta-java.1 + if grep -q "\[Unreleased\]: https://github.com/test/repo/compare/v1.0.0-beta-java.2...HEAD" "$test_file" && \ + grep -q "\[1.0.0-beta-java.2\]: https://github.com/test/repo/compare/v1.0.0-beta-java.1...v1.0.0-beta-java.2" "$test_file"; then + return 0 + else + return 1 + fi +} + +# Test 7: No duplicate [Unreleased] links when existing [Unreleased] link is present +test_no_duplicate_unreleased_links() { + local test_file="${TEST_DIR}/test7.md" + cat > "$test_file" << 'EOF' +# Changelog + +## [Unreleased] + +### Added +- New feature + +## [1.0.0-beta-java.2] - 2026-05-08 + +## [1.0.0-beta-java.1] - 2026-05-05 + +[Unreleased]: https://github.com/test/repo/compare/v1.0.0-beta-java.2...HEAD +[1.0.0-beta-java.2]: https://github.com/test/repo/compare/v1.0.0-beta-java.1...v1.0.0-beta-java.2 +[1.0.0-beta-java.1]: https://github.com/test/repo/compare/v0.3.0-java.2...v1.0.0-beta-java.1 +[0.3.0-java.2]: https://github.com/test/repo/releases/tag/0.3.0-java.2 +EOF + + CHANGELOG_FILE="$test_file" bash "$UPDATE_SCRIPT" 1.0.0-beta-java.3 > /dev/null 2>&1 + + # Count [Unreleased] link definitions - there should be exactly one + local unreleased_count + unreleased_count=$(grep -c "^\[Unreleased\]:" "$test_file") + if [ "$unreleased_count" -eq 1 ] && \ + grep -q "\[Unreleased\]: https://github.com/test/repo/compare/v1.0.0-beta-java.3...HEAD" "$test_file" && \ + grep -q "\[1.0.0-beta-java.3\]: https://github.com/test/repo/compare/v1.0.0-beta-java.2...v1.0.0-beta-java.3" "$test_file"; then + return 0 + else + return 1 + fi +} + # Run all tests echo "Running CHANGELOG update script tests..." echo "" @@ -189,6 +254,8 @@ run_test "Handle CHANGELOG without Unreleased link" test_no_unreleased_link run_test "Preserve content structure" test_preserve_content run_test "Error handling - no Unreleased section" test_no_unreleased_section run_test "Multiple version handling" test_multiple_versions +run_test "Beta-java version format (e.g., 1.0.0-beta-java.N)" test_beta_java_version +run_test "No duplicate [Unreleased] links when existing link is present" test_no_duplicate_unreleased_links echo "" echo "==========================================" diff --git a/.github/scripts/release/update-changelog.sh b/.github/scripts/release/update-changelog.sh index ff35dec722..e21d03774e 100755 --- a/.github/scripts/release/update-changelog.sh +++ b/.github/scripts/release/update-changelog.sh @@ -45,6 +45,7 @@ BEGIN { links_section = 0 first_version_link = "" repo_url = "" + unreleased_link_handled = 0 } # Track if we are in the links section at the bottom @@ -53,7 +54,7 @@ BEGIN { } # Capture the repository URL from the first version link -links_section && repo_url == "" && /^\[[0-9]+\.[0-9]+\.[0-9]+(-java\.[0-9]+)?\]:/ { +links_section && repo_url == "" && /^\[[0-9]+\.[0-9]+\.[0-9]+(-(beta-)?java(-preview)?\.[0-9]+)?\]:/ { match($0, /(https:\/\/github\.com\/[^\/]+\/[^\/]+)\//, arr) if (arr[1] != "") { repo_url = arr[1] @@ -86,28 +87,30 @@ skip_old_reference_impl && /^[[:space:]]*$/ { next } skip_old_reference_impl && /^> \*\*Reference implementation sync:\*\*/ { next } skip_old_reference_impl && !/^[[:space:]]*$/ && !/^> \*\*Reference implementation sync:\*\*/ { skip_old_reference_impl = 0 } -# Capture the first version link to get the previous version -links_section && first_version_link == "" && /^\[[0-9]+\.[0-9]+\.[0-9]+(-java\.[0-9]+)?\]:/ { - match($0, /\[([0-9]+\.[0-9]+\.[0-9]+(-java\.[0-9]+)?)\]:/, arr) - if (arr[1] != "" && repo_url != "") { - first_version_link = arr[1] - # Insert Unreleased and new version links before first version link - print "[Unreleased]: " repo_url "/compare/v" version "...HEAD" - print "[" version "]: " repo_url "/compare/v" arr[1] "...v" version - } -} - -# Update existing [Unreleased] link if present +# Update existing [Unreleased] link if present (must be checked before the first-version-link block) links_section && /^\[Unreleased\]:/ { # Get the previous version and repo URL from the existing link - match($0, /(https:\/\/github\.com\/[^\/]+\/[^\/]+)\/compare\/v([0-9]+\.[0-9]+\.[0-9]+(-java\.[0-9]+)?)\.\.\.HEAD/, arr) + match($0, /(https:\/\/github\.com\/[^\/]+\/[^\/]+)\/compare\/v([0-9]+\.[0-9]+\.[0-9]+(-(beta-)?java(-preview)?\.[0-9]+)?)\.\.\.HEAD/, arr) if (arr[1] != "" && arr[2] != "") { print "[Unreleased]: " arr[1] "/compare/v" version "...HEAD" print "[" version "]: " arr[1] "/compare/v" arr[2] "...v" version + unreleased_link_handled = 1 next } } +# Capture the first version link to get the previous version +# Only fires if the [Unreleased] link was not already handled above +links_section && first_version_link == "" && !unreleased_link_handled && /^\[[0-9]+\.[0-9]+\.[0-9]+(-(beta-)?java(-preview)?\.[0-9]+)?\]:/ { + match($0, /\[([0-9]+\.[0-9]+\.[0-9]+(-(beta-)?java(-preview)?\.[0-9]+)?)\]:/, arr) + if (arr[1] != "" && repo_url != "") { + first_version_link = arr[1] + # Insert Unreleased and new version links before first version link + print "[Unreleased]: " repo_url "/compare/v" version "...HEAD" + print "[" version "]: " repo_url "/compare/v" arr[1] "...v" version + } +} + # Print all other lines unchanged { print } ' "$CHANGELOG_FILE" > "$TEMP_FILE" diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml index 1143634f69..455e5a8201 100644 --- a/.github/workflows/build-test.yml +++ b/.github/workflows/build-test.yml @@ -30,7 +30,7 @@ jobs: COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} java-sdk: - name: "Java SDK Tests" + name: "Java SDK Tests (JDK ${{ matrix.test-jdk }})" needs: smoke-test if: ${{ always() && needs.smoke-test.result != 'failure' }} permissions: @@ -39,6 +39,10 @@ jobs: pull-requests: write runs-on: ubuntu-latest + strategy: + fail-fast: false + matrix: + test-jdk: ["25", "17"] defaults: run: shell: bash @@ -46,16 +50,29 @@ jobs: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 with: persist-credentials: false - - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6 - with: - node-version: 22 + - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5 with: - java-version: "17" + java-version: "25" distribution: "microsoft" cache: "maven" + - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6 + with: + node-version: 22 + + - name: Build SDK and set up test harness + run: mvn test-compile jar:jar + + - name: Verify Javadoc generation + if: matrix.test-jdk == '25' + run: mvn javadoc:javadoc -q + + - name: Verify CLI works + run: node target/copilot-sdk/nodejs/node_modules/@github/copilot/index.js --version + - name: Run spotless check + if: matrix.test-jdk == '25' run: | mvn spotless:check if [ $? -ne 0 ]; then @@ -64,47 +81,78 @@ jobs: fi echo "βœ… spotless:check passed" - - name: Build SDK and clone test harness - run: mvn test-compile - - - name: Verify Javadoc generation - run: mvn javadoc:javadoc -q - - - name: Install Copilot CLI from cloned SDK - id: setup-copilot - run: | - # Install dependencies in the cloned SDK's nodejs directory - # This ensures we use the same CLI version as the test harness expects - cd target/copilot-sdk/nodejs - npm ci --ignore-scripts - echo "path=$(pwd)/node_modules/@github/copilot/index.js" >> $GITHUB_OUTPUT + - name: Run Java SDK tests (JDK 25) + if: matrix.test-jdk == '25' + env: + CI: "true" + run: mvn verify -Dskip.test.harness=true - - name: Verify CLI works - run: node ${{ steps.setup-copilot.outputs.path }} --version + - name: Switch to JDK 17 + if: matrix.test-jdk == '17' + uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5 + with: + java-version: "17" + distribution: "microsoft" - - name: Run Java SDK tests + - name: Run Java SDK tests (JDK 17, no recompilation) + if: matrix.test-jdk == '17' env: CI: "true" - COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} - COPILOT_CLI_PATH: ${{ steps.setup-copilot.outputs.path }} - run: mvn verify + run: | + echo "Running tests against JDK 25-built classes using JDK 17 runtime..." + java -version + mvn jacoco:prepare-agent@wire-up-coverage-instrumentation antrun:run@print-test-jdk-banner surefire:test failsafe:integration-test failsafe:verify jacoco:report@build-coverage-report-from-tests -Denforcer.skip=true + + - name: Validate reference-impl-sync completeness + if: >- + github.event_name == 'pull_request' && + contains(github.event.pull_request.labels.*.name, 'reference-impl-sync') + run: | + git fetch origin main --depth=1 + CHANGED=$(git diff --name-only origin/main...HEAD) + + # 1. .lastmerge must be updated (proves finish script ran) + if echo "$CHANGED" | grep -q '^\\.lastmerge$'; then + echo "βœ… .lastmerge was updated (finish script ran)" + else + echo "❌ .lastmerge was not updated. The merge-reference-impl-finish.sh script" + echo " must be run before this PR can merge. This script updates .lastmerge," + echo " syncs the CLI version in pom.xml, and syncs scripts/codegen/package.json." + exit 1 + fi + + # 2. If codegen inputs changed, generated output must also have changed + if echo "$CHANGED" | grep -q '^scripts/codegen/'; then + if echo "$CHANGED" | grep -q '^src/generated/java/'; then + echo "βœ… Codegen inputs changed and generated files were regenerated" + else + echo "❌ scripts/codegen/ was updated but src/generated/java/ has no changes." + echo " The Codegen Check workflow should regenerate these files automatically." + echo " If it hasn't run yet, wait for it to complete and push regenerated files." + echo " Or run manually: cd scripts/codegen && npm ci && npm run generate" + exit 1 + fi + else + echo "βœ… No codegen input changes β€” regeneration not needed" + fi - name: Upload test results for site generation - if: success() && github.ref == 'refs/heads/main' + if: success() && github.ref == 'refs/heads/main' && matrix.test-jdk == '25' uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7 with: name: test-results-for-site path: | target/jacoco-test-results/sdk-tests.exec target/surefire-reports/ + target/surefire-reports-isolated/ retention-days: 1 - name: Generate JaCoCo badge - if: success() && github.ref == 'refs/heads/main' + if: success() && github.ref == 'refs/heads/main' && matrix.test-jdk == '25' run: .github/scripts/generate-coverage-badge.sh - name: Create PR for JaCoCo badge update - if: success() && github.ref == 'refs/heads/main' + if: success() && github.ref == 'refs/heads/main' && matrix.test-jdk == '25' uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v7 with: commit-message: "Update JaCoCo coverage badge" @@ -117,3 +165,16 @@ jobs: - name: Generate Test Report Summary if: always() uses: ./.github/actions/test-report + with: + title: "Copilot Java SDK :: Test Results JDK ${{ matrix.test-jdk }}" + + - name: Upload test results on failure + if: failure() + uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7 + with: + name: test-results-jdk-${{ matrix.test-jdk }} + path: | + target/surefire-reports/ + target/surefire-reports-isolated/ + target/failsafe-reports/ + retention-days: 7 diff --git a/.github/workflows/codegen-agentic-fix.lock.yml b/.github/workflows/codegen-agentic-fix.lock.yml index b44681eb74..f5ab2030d5 100644 --- a/.github/workflows/codegen-agentic-fix.lock.yml +++ b/.github/workflows/codegen-agentic-fix.lock.yml @@ -1,5 +1,5 @@ -# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"e9707f96f0d1dc7a2c4bbd2c193b917ff5793901b14d055a1fef0da62dd2b928","compiler_version":"v0.68.3","strict":true,"agent_id":"copilot"} -# gh-aw-manifest: {"version":1,"secrets":["COPILOT_GITHUB_TOKEN","GH_AW_CI_TRIGGER_TOKEN","GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"373c709c69115d41ff229c7e5df9f8788daa9553","version":"v9"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"ba90f2186d7ad780ec640f364005fa24e797b360","version":"v0.68.3"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.20"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.2.19"},{"image":"ghcr.io/github/github-mcp-server:v0.32.0"},{"image":"node:lts-alpine"}]} +# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"70880e5fb9ec78342cf56974b2414d8cf0a516533e201e437835164543ef58c0","compiler_version":"v0.71.5","strict":true,"agent_id":"copilot"} +# gh-aw-manifest: {"version":1,"secrets":["COPILOT_GITHUB_TOKEN","GH_AW_CI_TRIGGER_TOKEN","GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"373c709c69115d41ff229c7e5df9f8788daa9553","version":"v9"},{"repo":"actions/github-script","sha":"3a2844b7e9c422d3c10d287c895573f7108da1b3","version":"v9.0.0"},{"repo":"actions/setup-node","sha":"48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e","version":"v6.4.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"b8068426813005612b960b5ab0b8bd2c27142323","version":"v0.71.5"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.40","digest":"sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504","pinned_image":"ghcr.io/github/gh-aw-firewall/agent:0.25.40@sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40","digest":"sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280","pinned_image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40@sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.40","digest":"sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51","pinned_image":"ghcr.io/github/gh-aw-firewall/squid:0.25.40@sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.3.6","digest":"sha256:2bb8eef86006a4c5963c55616a9c51c32f27bfdecb023b8aa6f91f6718d9171c","pinned_image":"ghcr.io/github/gh-aw-mcpg:v0.3.6@sha256:2bb8eef86006a4c5963c55616a9c51c32f27bfdecb023b8aa6f91f6718d9171c"},{"image":"ghcr.io/github/github-mcp-server:v1.0.3","digest":"sha256:2ac27ef03461ef2b877031b838a7d1fd7f12b12d4ace7796d8cad91446d55959","pinned_image":"ghcr.io/github/github-mcp-server:v1.0.3@sha256:2ac27ef03461ef2b877031b838a7d1fd7f12b12d4ace7796d8cad91446d55959"},{"image":"node:lts-alpine","digest":"sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f","pinned_image":"node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f"}]} # ___ _ _ # / _ \ | | (_) # | |_| | __ _ ___ _ __ | |_ _ ___ @@ -14,7 +14,7 @@ # \ /\ / (_) | | | | ( | | | | (_) \ V V /\__ \ # \/ \/ \___/|_| |_|\_\|_| |_|\___/ \_/\_/ |___/ # -# This file was automatically generated by gh-aw (v0.68.3). DO NOT EDIT. +# This file was automatically generated by gh-aw (v0.71.5). DO NOT EDIT. # # To update this file, edit the corresponding .md file and run: # gh aw compile @@ -36,16 +36,18 @@ # - actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 # - actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 # - actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 +# - actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 +# - actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0 # - actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 -# - github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 +# - github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 # # Container images used: -# - ghcr.io/github/gh-aw-firewall/agent:0.25.20 -# - ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20 -# - ghcr.io/github/gh-aw-firewall/squid:0.25.20 -# - ghcr.io/github/gh-aw-mcpg:v0.2.19 -# - ghcr.io/github/github-mcp-server:v0.32.0 -# - node:lts-alpine +# - ghcr.io/github/gh-aw-firewall/agent:0.25.40@sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504 +# - ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40@sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280 +# - ghcr.io/github/gh-aw-firewall/squid:0.25.40@sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51 +# - ghcr.io/github/gh-aw-mcpg:v0.3.6@sha256:2bb8eef86006a4c5963c55616a9c51c32f27bfdecb023b8aa6f91f6718d9171c +# - ghcr.io/github/github-mcp-server:v1.0.3@sha256:2ac27ef03461ef2b877031b838a7d1fd7f12b12d4ace7796d8cad91446d55959 +# - node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f name: "Codegen Agentic Fix" "on": @@ -85,6 +87,7 @@ jobs: outputs: comment_id: "" comment_repo: "" + engine_id: ${{ steps.generate_aw_info.outputs.engine_id }} lockdown_check_failed: ${{ steps.generate_aw_info.outputs.lockdown_check_failed == 'true' }} model: ${{ steps.generate_aw_info.outputs.model }} secret_verification_result: ${{ steps.validate-secret.outputs.verification_result }} @@ -93,30 +96,34 @@ jobs: steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Codegen Agentic Fix" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/codegen-agentic-fix.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" - name: Generate agentic run info id: generate_aw_info env: GH_AW_INFO_ENGINE_ID: "copilot" GH_AW_INFO_ENGINE_NAME: "GitHub Copilot CLI" - GH_AW_INFO_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || 'auto' }} - GH_AW_INFO_VERSION: "1.0.21" - GH_AW_INFO_AGENT_VERSION: "1.0.21" - GH_AW_INFO_CLI_VERSION: "v0.68.3" + GH_AW_INFO_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || 'claude-sonnet-4.6' }} + GH_AW_INFO_VERSION: "1.0.40" + GH_AW_INFO_AGENT_VERSION: "1.0.40" + GH_AW_INFO_CLI_VERSION: "v0.71.5" GH_AW_INFO_WORKFLOW_NAME: "Codegen Agentic Fix" GH_AW_INFO_EXPERIMENTAL: "false" GH_AW_INFO_SUPPORTS_TOOLS_ALLOWLIST: "true" GH_AW_INFO_STAGED: "false" GH_AW_INFO_ALLOWED_DOMAINS: '["defaults","github"]' GH_AW_INFO_FIREWALL_ENABLED: "true" - GH_AW_INFO_AWF_VERSION: "v0.25.20" + GH_AW_INFO_AWF_VERSION: "v0.25.40" GH_AW_INFO_AWMG_VERSION: "" GH_AW_INFO_FIREWALL_TYPE: "squid" GH_AW_COMPILED_STRICT: "true" - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -135,11 +142,23 @@ jobs: sparse-checkout: | .github .agents + .claude + .codex + .crush + .gemini + .opencode + .pi sparse-checkout-cone-mode: true fetch-depth: 1 + - name: Save agent config folders for base branch restoration + env: + GH_AW_AGENT_FOLDERS: ".agents .claude .codex .crush .gemini .github .opencode .pi" + GH_AW_AGENT_FILES: ".crush.json AGENTS.md CLAUDE.md GEMINI.md PI.md opencode.jsonc" + # poutine:ignore untrusted_checkout_exec + run: bash "${RUNNER_TEMP}/gh-aw/actions/save_base_github_folders.sh" - name: Check workflow lock file id: check-lock-file - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_WORKFLOW_FILE: "codegen-agentic-fix.lock.yml" GH_AW_CONTEXT_WORKFLOW_REF: "${{ github.workflow_ref }}" @@ -150,9 +169,9 @@ jobs: const { main } = require('${{ runner.temp }}/gh-aw/actions/check_workflow_timestamp_api.cjs'); await main(); - name: Check compile-agentic version - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: - GH_AW_COMPILED_VERSION: "v0.68.3" + GH_AW_COMPILED_VERSION: "v0.71.5" with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -178,20 +197,23 @@ jobs: run: | bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh" { - cat << 'GH_AW_PROMPT_89262d074598e425_EOF' + cat << 'GH_AW_PROMPT_d94a435f1fbdc38f_EOF' - GH_AW_PROMPT_89262d074598e425_EOF + GH_AW_PROMPT_d94a435f1fbdc38f_EOF cat "${RUNNER_TEMP}/gh-aw/prompts/xpia.md" cat "${RUNNER_TEMP}/gh-aw/prompts/temp_folder_prompt.md" cat "${RUNNER_TEMP}/gh-aw/prompts/markdown.md" cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_prompt.md" - cat << 'GH_AW_PROMPT_89262d074598e425_EOF' + cat << 'GH_AW_PROMPT_d94a435f1fbdc38f_EOF' - Tools: add_comment(max:5), push_to_pull_request_branch(max:3), missing_tool, missing_data, noop - GH_AW_PROMPT_89262d074598e425_EOF + Tools: add_comment(max:5), push_to_pull_request_branch, missing_tool, missing_data, noop + GH_AW_PROMPT_d94a435f1fbdc38f_EOF cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_push_to_pr_branch.md" - cat << 'GH_AW_PROMPT_89262d074598e425_EOF' + cat << 'GH_AW_PROMPT_d94a435f1fbdc38f_EOF' + GH_AW_PROMPT_d94a435f1fbdc38f_EOF + cat "${RUNNER_TEMP}/gh-aw/prompts/mcp_cli_tools_prompt.md" + cat << 'GH_AW_PROMPT_d94a435f1fbdc38f_EOF' The following GitHub context information is available for this workflow: {{#if __GH_AW_GITHUB_ACTOR__ }} @@ -220,17 +242,18 @@ jobs: {{/if}} - GH_AW_PROMPT_89262d074598e425_EOF + GH_AW_PROMPT_d94a435f1fbdc38f_EOF cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md" - cat << 'GH_AW_PROMPT_89262d074598e425_EOF' + cat << 'GH_AW_PROMPT_d94a435f1fbdc38f_EOF' {{#runtime-import .github/workflows/codegen-agentic-fix.md}} - GH_AW_PROMPT_89262d074598e425_EOF + GH_AW_PROMPT_d94a435f1fbdc38f_EOF } > "$GH_AW_PROMPT" - name: Interpolate variables and render templates - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + GH_AW_ENGINE_ID: "copilot" GH_AW_INPUTS_BRANCH: ${{ inputs.branch }} GH_AW_INPUTS_ERROR_SUMMARY: ${{ inputs.error_summary }} GH_AW_INPUTS_PR_NUMBER: ${{ inputs.pr_number }} @@ -241,7 +264,7 @@ jobs: const { main } = require('${{ runner.temp }}/gh-aw/actions/interpolate_prompt.cjs'); await main(); - name: Substitute placeholders - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt GH_AW_GITHUB_ACTOR: ${{ github.actor }} @@ -255,6 +278,7 @@ jobs: GH_AW_INPUTS_BRANCH: ${{ inputs.branch }} GH_AW_INPUTS_ERROR_SUMMARY: ${{ inputs.error_summary }} GH_AW_INPUTS_PR_NUMBER: ${{ inputs.pr_number }} + GH_AW_MCP_CLI_SERVERS_LIST: '- `safeoutputs` β€” run `safeoutputs --help` to see available tools' with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -276,7 +300,8 @@ jobs: GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE, GH_AW_INPUTS_BRANCH: process.env.GH_AW_INPUTS_BRANCH, GH_AW_INPUTS_ERROR_SUMMARY: process.env.GH_AW_INPUTS_ERROR_SUMMARY, - GH_AW_INPUTS_PR_NUMBER: process.env.GH_AW_INPUTS_PR_NUMBER + GH_AW_INPUTS_PR_NUMBER: process.env.GH_AW_INPUTS_PR_NUMBER, + GH_AW_MCP_CLI_SERVERS_LIST: process.env.GH_AW_MCP_CLI_SERVERS_LIST } }); - name: Validate prompt placeholders @@ -294,10 +319,12 @@ jobs: uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 with: name: activation + include-hidden-files: true path: | /tmp/gh-aw/aw_info.json /tmp/gh-aw/aw-prompts/prompt.txt /tmp/gh-aw/github_rate_limits.jsonl + /tmp/gh-aw/base if-no-files-found: ignore retention-days: 1 @@ -329,11 +356,15 @@ jobs: steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} trace-id: ${{ needs.activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Codegen Agentic Fix" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/codegen-agentic-fix.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" - name: Set runtime paths id: set-runtime-paths run: | @@ -369,7 +400,7 @@ jobs: id: checkout-pr if: | github.event.pull_request || github.event.issue.pull_request - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} with: @@ -380,11 +411,11 @@ jobs: const { main } = require('${{ runner.temp }}/gh-aw/actions/checkout_pr_branch.cjs'); await main(); - name: Install GitHub Copilot CLI - run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.21 + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.40 env: GH_HOST: github.com - name: Install AWF binary - run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.20 + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.40 - name: Determine automatic lockdown mode for GitHub MCP Server id: determine-automatic-lockdown uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 @@ -395,23 +426,33 @@ jobs: script: | const determineAutomaticLockdown = require('${{ runner.temp }}/gh-aw/actions/determine_automatic_lockdown.cjs'); await determineAutomaticLockdown(github, context, core); + - name: Download activation artifact + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: activation + path: /tmp/gh-aw + - name: Restore agent config folders from base branch + if: steps.checkout-pr.outcome == 'success' + env: + GH_AW_AGENT_FOLDERS: ".agents .claude .codex .crush .gemini .github .opencode .pi" + GH_AW_AGENT_FILES: ".crush.json AGENTS.md CLAUDE.md GEMINI.md PI.md opencode.jsonc" + run: bash "${RUNNER_TEMP}/gh-aw/actions/restore_base_github_folders.sh" - name: Download container images - run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.20 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20 ghcr.io/github/gh-aw-firewall/squid:0.25.20 ghcr.io/github/gh-aw-mcpg:v0.2.19 ghcr.io/github/github-mcp-server:v0.32.0 node:lts-alpine - - name: Write Safe Outputs Config + run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.40@sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40@sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280 ghcr.io/github/gh-aw-firewall/squid:0.25.40@sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51 ghcr.io/github/gh-aw-mcpg:v0.3.6@sha256:2bb8eef86006a4c5963c55616a9c51c32f27bfdecb023b8aa6f91f6718d9171c ghcr.io/github/github-mcp-server:v1.0.3@sha256:2ac27ef03461ef2b877031b838a7d1fd7f12b12d4ace7796d8cad91446d55959 node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f + - name: Generate Safe Outputs Config run: | mkdir -p "${RUNNER_TEMP}/gh-aw/safeoutputs" mkdir -p /tmp/gh-aw/safeoutputs mkdir -p /tmp/gh-aw/mcp-logs/safeoutputs - cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_e118843832e795e2_EOF' - {"add_comment":{"max":5,"target":"*"},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"false"},"push_to_pull_request_branch":{"if_no_changes":"warn","max":3,"max_patch_size":1024,"protected_files":["package.json","bun.lockb","bunfig.toml","deno.json","deno.jsonc","deno.lock","global.json","NuGet.Config","Directory.Packages.props","mix.exs","mix.lock","go.mod","go.sum","stack.yaml","stack.yaml.lock","pom.xml","build.gradle","build.gradle.kts","settings.gradle","settings.gradle.kts","gradle.properties","package-lock.json","yarn.lock","pnpm-lock.yaml","npm-shrinkwrap.json","requirements.txt","Pipfile","Pipfile.lock","pyproject.toml","setup.py","setup.cfg","Gemfile","Gemfile.lock","uv.lock","CODEOWNERS"],"protected_path_prefixes":[".github/",".agents/"]},"report_incomplete":{}} - GH_AW_SAFE_OUTPUTS_CONFIG_e118843832e795e2_EOF - - name: Write Safe Outputs Tools + cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_b6e7bb90508de076_EOF' + {"add_comment":{"max":5,"target":"*"},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"false"},"push_to_pull_request_branch":{"if_no_changes":"warn","labels":["dependencies"],"max_patch_size":1024,"protect_top_level_dot_folders":true,"protected_files":["package.json","bun.lockb","bunfig.toml","deno.json","deno.jsonc","deno.lock","global.json","NuGet.Config","Directory.Packages.props","mix.exs","mix.lock","go.mod","go.sum","stack.yaml","stack.yaml.lock","pom.xml","build.gradle","build.gradle.kts","settings.gradle","settings.gradle.kts","gradle.properties","package-lock.json","yarn.lock","pnpm-lock.yaml","npm-shrinkwrap.json","requirements.txt","Pipfile","Pipfile.lock","pyproject.toml","setup.py","setup.cfg","Gemfile","Gemfile.lock","uv.lock","CODEOWNERS","DESIGN.md","README.md","CONTRIBUTING.md","CHANGELOG.md","SECURITY.md","CODE_OF_CONDUCT.md","AGENTS.md","CLAUDE.md","GEMINI.md"],"target":"*"},"report_incomplete":{}} + GH_AW_SAFE_OUTPUTS_CONFIG_b6e7bb90508de076_EOF + - name: Generate Safe Outputs Tools env: GH_AW_TOOLS_META_JSON: | { "description_suffixes": { - "add_comment": " CONSTRAINTS: Maximum 5 comment(s) can be added. Target: *. Supports reply_to_id for discussion threading.", - "push_to_pull_request_branch": " CONSTRAINTS: Maximum 3 push(es) can be made." + "add_comment": " CONSTRAINTS: Maximum 5 comment(s) can be added. Target: *. Supports reply_to_id for discussion threading." }, "repo_params": {}, "dynamic_tools": [] @@ -534,7 +575,7 @@ jobs: } } } - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -592,11 +633,12 @@ jobs: GITHUB_MCP_SERVER_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} run: | set -eo pipefail - mkdir -p /tmp/gh-aw/mcp-config + mkdir -p "${RUNNER_TEMP}/gh-aw/mcp-config" # Export gateway environment variables for MCP config and gateway script - export MCP_GATEWAY_PORT="80" + export MCP_GATEWAY_PORT="8080" export MCP_GATEWAY_DOMAIN="host.docker.internal" + export MCP_GATEWAY_HOST_DOMAIN="localhost" MCP_GATEWAY_API_KEY=$(openssl rand -base64 45 | tr -d '/+=') echo "::add-mask::${MCP_GATEWAY_API_KEY}" export MCP_GATEWAY_API_KEY @@ -606,15 +648,19 @@ jobs: export DEBUG="*" export GH_AW_ENGINE="copilot" - export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host -v /var/run/docker.sock:/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.2.19' + MCP_GATEWAY_UID=$(id -u 2>/dev/null || echo '0') + MCP_GATEWAY_GID=$(id -g 2>/dev/null || echo '0') + DOCKER_SOCK_GID=$(stat -c '%g' /var/run/docker.sock 2>/dev/null || echo '0') + export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host --add-host host.docker.internal:127.0.0.1 --user '"${MCP_GATEWAY_UID}"':'"${MCP_GATEWAY_GID}"' --group-add '"${DOCKER_SOCK_GID}"' -v /var/run/docker.sock:/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.3.6' mkdir -p /home/runner/.copilot - cat << GH_AW_MCP_CONFIG_1f06674d94d6899b_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh" + GH_AW_NODE=$(which node 2>/dev/null || command -v node 2>/dev/null || echo node) + cat << GH_AW_MCP_CONFIG_f8f308e27510535f_EOF | "$GH_AW_NODE" "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.cjs" { "mcpServers": { "github": { "type": "stdio", - "container": "ghcr.io/github/github-mcp-server:v0.32.0", + "container": "ghcr.io/github/github-mcp-server:v1.0.3", "env": { "GITHUB_HOST": "\${GITHUB_SERVER_URL}", "GITHUB_PERSONAL_ACCESS_TOKEN": "\${GITHUB_MCP_SERVER_TOKEN}", @@ -650,37 +696,55 @@ jobs: "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}" } } - GH_AW_MCP_CONFIG_1f06674d94d6899b_EOF - - name: Download activation artifact - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + GH_AW_MCP_CONFIG_f8f308e27510535f_EOF + - name: Mount MCP servers as CLIs + id: mount-mcp-clis + continue-on-error: true + env: + MCP_GATEWAY_API_KEY: ${{ steps.start-mcp-gateway.outputs.gateway-api-key }} + MCP_GATEWAY_DOMAIN: ${{ steps.start-mcp-gateway.outputs.gateway-domain }} + MCP_GATEWAY_PORT: ${{ steps.start-mcp-gateway.outputs.gateway-port }} + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: - name: activation - path: /tmp/gh-aw - - name: Clean git credentials + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io); + const { main } = require('${{ runner.temp }}/gh-aw/actions/mount_mcp_as_cli.cjs'); + await main(); + - name: Clean credentials continue-on-error: true run: bash "${RUNNER_TEMP}/gh-aw/actions/clean_git_credentials.sh" + - name: Audit pre-agent workspace + id: pre_agent_audit + continue-on-error: true + run: bash "${RUNNER_TEMP}/gh-aw/actions/audit_pre_agent_workspace.sh" - name: Execute GitHub Copilot CLI id: agentic_execution # Copilot CLI tool arguments (sorted): - timeout-minutes: 20 + timeout-minutes: 60 run: | set -o pipefail touch /tmp/gh-aw/agent-step-summary.md + GH_AW_NODE_BIN=$(command -v node 2>/dev/null || true) + export GH_AW_NODE_BIN (umask 177 && touch /tmp/gh-aw/agent-stdio.log) + printf '%s\n' '{"$schema":"https://github.com/github/gh-aw-firewall/releases/download/v0.25.40/awf-config.schema.json","network":{"allowDomains":["*.githubusercontent.com","api.business.githubcopilot.com","api.enterprise.githubcopilot.com","api.github.com","api.githubcopilot.com","api.individual.githubcopilot.com","api.snapcraft.io","archive.ubuntu.com","azure.archive.ubuntu.com","codeload.github.com","crl.geotrust.com","crl.globalsign.com","crl.identrust.com","crl.sectigo.com","crl.thawte.com","crl.usertrust.com","crl.verisign.com","crl3.digicert.com","crl4.digicert.com","crls.ssl.com","docs.github.com","github-cloud.githubusercontent.com","github-cloud.s3.amazonaws.com","github.blog","github.com","github.githubassets.com","host.docker.internal","json-schema.org","json.schemastore.org","keyserver.ubuntu.com","lfs.github.com","objects.githubusercontent.com","ocsp.digicert.com","ocsp.geotrust.com","ocsp.globalsign.com","ocsp.identrust.com","ocsp.sectigo.com","ocsp.ssl.com","ocsp.thawte.com","ocsp.usertrust.com","ocsp.verisign.com","packagecloud.io","packages.cloud.google.com","packages.microsoft.com","ppa.launchpad.net","raw.githubusercontent.com","registry.npmjs.org","s.symcb.com","s.symcd.com","security.ubuntu.com","telemetry.enterprise.githubcopilot.com","ts-crl.ws.symantec.com","ts-ocsp.ws.symantec.com","www.googleapis.com"]},"apiProxy":{"enabled":true,"models":{"auto":["large"],"deep-research":["copilot/deep-research*","google/deep-research*"],"gemini-flash":["copilot/gemini-*flash*","google/gemini-*flash*"],"gemini-pro":["copilot/gemini-*pro*","google/gemini-*pro*"],"gpt-4.1":["copilot/gpt-4.1*","openai/gpt-4.1*"],"gpt-5":["copilot/gpt-5*","openai/gpt-5*"],"gpt-5-codex":["copilot/gpt-5*codex*","openai/gpt-5*codex*"],"gpt-5-mini":["copilot/gpt-5*mini*","openai/gpt-5*mini*"],"gpt-5-nano":["copilot/gpt-5*nano*","openai/gpt-5*nano*"],"gpt-5-pro":["copilot/gpt-5*pro*","openai/gpt-5*pro*"],"haiku":["copilot/*haiku*","anthropic/*haiku*"],"large":["sonnet","gpt-5-pro","gpt-5","gemini-pro"],"mini":["haiku","gpt-5-mini","gpt-5-nano","gemini-flash"],"opus":["copilot/*opus*","anthropic/*opus*"],"reasoning":["copilot/o1*","copilot/o3*","copilot/o4*","openai/o1*","openai/o3*","openai/o4*"],"small":["mini"],"sonnet":["copilot/*sonnet*","anthropic/*sonnet*"]}},"container":{"imageTag":"0.25.40,squid=sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51,agent=sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504,api-proxy=sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280,cli-proxy=sha256:3e7152911d4b4b7b97beef9d3d7d924ff7902227e86001ef3838fb728d5d514c"}}' > "${RUNNER_TEMP}/gh-aw/awf-config.json" && cp "${RUNNER_TEMP}/gh-aw/awf-config.json" /tmp/gh-aw/awf-config.json # shellcheck disable=SC1003 - sudo -E awf --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" --env-all --exclude-env COPILOT_GITHUB_TOKEN --exclude-env GITHUB_MCP_SERVER_TOKEN --exclude-env MCP_GATEWAY_API_KEY --allow-domains '*.githubusercontent.com,api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,api.snapcraft.io,archive.ubuntu.com,azure.archive.ubuntu.com,codeload.github.com,crl.geotrust.com,crl.globalsign.com,crl.identrust.com,crl.sectigo.com,crl.thawte.com,crl.usertrust.com,crl.verisign.com,crl3.digicert.com,crl4.digicert.com,crls.ssl.com,docs.github.com,github-cloud.githubusercontent.com,github-cloud.s3.amazonaws.com,github.blog,github.com,github.githubassets.com,host.docker.internal,json-schema.org,json.schemastore.org,keyserver.ubuntu.com,lfs.github.com,objects.githubusercontent.com,ocsp.digicert.com,ocsp.geotrust.com,ocsp.globalsign.com,ocsp.identrust.com,ocsp.sectigo.com,ocsp.ssl.com,ocsp.thawte.com,ocsp.usertrust.com,ocsp.verisign.com,packagecloud.io,packages.cloud.google.com,packages.microsoft.com,ppa.launchpad.net,raw.githubusercontent.com,registry.npmjs.org,s.symcb.com,s.symcd.com,security.ubuntu.com,telemetry.enterprise.githubcopilot.com,ts-crl.ws.symantec.com,ts-ocsp.ws.symantec.com,www.googleapis.com' --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --image-tag 0.25.20 --skip-pull --enable-api-proxy \ - -- /bin/bash -c 'node ${RUNNER_TEMP}/gh-aw/actions/copilot_driver.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --allow-all-paths --add-dir "${GITHUB_WORKSPACE}" --prompt "$(cat /tmp/gh-aw/aw-prompts/prompt.txt)"' 2>&1 | tee -a /tmp/gh-aw/agent-stdio.log + sudo -E awf --config "${RUNNER_TEMP}/gh-aw/awf-config.json" --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" --env-all --exclude-env COPILOT_GITHUB_TOKEN --exclude-env GITHUB_MCP_SERVER_TOKEN --exclude-env MCP_GATEWAY_API_KEY --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --allow-host-ports 80,443,8080 --skip-pull \ + -- /bin/bash -c 'export PATH="${RUNNER_TEMP}/gh-aw/mcp-cli/bin:$PATH" && export PATH="$(find /opt/hostedtoolcache /home/runner/work/_tool -maxdepth 4 -type d -name bin 2>/dev/null | tr '\''\n'\'' '\'':'\'')$PATH"; [ -n "$GOROOT" ] && export PATH="$GOROOT/bin:$PATH" || true && GH_AW_NODE_EXEC="${GH_AW_NODE_BIN:-}"; if [ -z "$GH_AW_NODE_EXEC" ] || [ ! -x "$GH_AW_NODE_EXEC" ]; then GH_AW_NODE_EXEC="$(command -v node 2>/dev/null || echo node)"; fi; "$GH_AW_NODE_EXEC" ${RUNNER_TEMP}/gh-aw/actions/copilot_harness.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --allow-all-paths --add-dir "${GITHUB_WORKSPACE}" --prompt-file /tmp/gh-aw/aw-prompts/prompt.txt' 2>&1 | tee -a /tmp/gh-aw/agent-stdio.log env: COPILOT_AGENT_RUNNER_TYPE: STANDALONE + COPILOT_API_KEY: dummy-byok-key-for-offline-mode COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} - COPILOT_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || '' }} + COPILOT_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || 'claude-sonnet-4.6' }} GH_AW_MCP_CONFIG: /home/runner/.copilot/mcp-config.json GH_AW_PHASE: agent GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} - GH_AW_VERSION: v0.68.3 + GH_AW_VERSION: v0.71.5 GITHUB_API_URL: ${{ github.api_url }} GITHUB_AW: true + GITHUB_COPILOT_INTEGRATION_ID: agentic-workflows GITHUB_HEAD_REF: ${{ github.head_ref }} GITHUB_MCP_SERVER_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} GITHUB_REF_NAME: ${{ github.ref_name }} @@ -725,7 +789,7 @@ jobs: bash "${RUNNER_TEMP}/gh-aw/actions/stop_mcp_gateway.sh" "$GATEWAY_PID" - name: Redact secrets in logs if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -751,7 +815,7 @@ jobs: - name: Ingest agent output id: collect_output if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} GH_AW_ALLOWED_DOMAINS: "*.githubusercontent.com,api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,api.snapcraft.io,archive.ubuntu.com,azure.archive.ubuntu.com,codeload.github.com,crl.geotrust.com,crl.globalsign.com,crl.identrust.com,crl.sectigo.com,crl.thawte.com,crl.usertrust.com,crl.verisign.com,crl3.digicert.com,crl4.digicert.com,crls.ssl.com,docs.github.com,github-cloud.githubusercontent.com,github-cloud.s3.amazonaws.com,github.blog,github.com,github.githubassets.com,host.docker.internal,json-schema.org,json.schemastore.org,keyserver.ubuntu.com,lfs.github.com,objects.githubusercontent.com,ocsp.digicert.com,ocsp.geotrust.com,ocsp.globalsign.com,ocsp.identrust.com,ocsp.sectigo.com,ocsp.ssl.com,ocsp.thawte.com,ocsp.usertrust.com,ocsp.verisign.com,packagecloud.io,packages.cloud.google.com,packages.microsoft.com,ppa.launchpad.net,raw.githubusercontent.com,registry.npmjs.org,s.symcb.com,s.symcd.com,security.ubuntu.com,telemetry.enterprise.githubcopilot.com,ts-crl.ws.symantec.com,ts-ocsp.ws.symantec.com,www.googleapis.com" @@ -765,7 +829,7 @@ jobs: await main(); - name: Parse agent logs for step summary if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: /tmp/gh-aw/sandbox/agent/logs/ with: @@ -777,7 +841,7 @@ jobs: - name: Parse MCP Gateway logs for step summary if: always() id: parse-mcp-gateway - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -790,9 +854,9 @@ jobs: env: AWF_LOGS_DIR: /tmp/gh-aw/sandbox/firewall/logs run: | - # Fix permissions on firewall logs so they can be uploaded as artifacts + # Fix permissions on firewall logs/audit dirs so they can be uploaded as artifacts # AWF runs with sudo, creating files owned by root - sudo chmod -R a+r /tmp/gh-aw/sandbox/firewall/logs 2>/dev/null || true + sudo chmod -R a+r /tmp/gh-aw/sandbox/firewall 2>/dev/null || true # Only run awf logs summary if awf command exists (it may not be installed if workflow failed before install step) if command -v awf &> /dev/null; then awf logs summary | tee -a "$GITHUB_STEP_SUMMARY" @@ -802,13 +866,23 @@ jobs: - name: Parse token usage for step summary if: always() continue-on-error: true - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); setupGlobals(core, github, context, exec, io, getOctokit); const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_token_usage.cjs'); await main(); + - name: Print AWF reflect summary + if: always() + continue-on-error: true + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/awf_reflect_summary.cjs'); + await main(); - name: Write agent output placeholder if missing if: always() run: | @@ -828,14 +902,17 @@ jobs: /tmp/gh-aw/mcp-logs/ /tmp/gh-aw/agent_usage.json /tmp/gh-aw/agent-stdio.log + /tmp/gh-aw/pre-agent-audit.txt /tmp/gh-aw/agent/ /tmp/gh-aw/github_rate_limits.jsonl /tmp/gh-aw/safeoutputs.jsonl /tmp/gh-aw/agent_output.json /tmp/gh-aw/aw-*.patch /tmp/gh-aw/aw-*.bundle + /tmp/gh-aw/awf-config.json /tmp/gh-aw/sandbox/firewall/logs/ /tmp/gh-aw/sandbox/firewall/audit/ + /tmp/gh-aw/sandbox/firewall/awf-reflect.json if-no-files-found: ignore conclusion: @@ -864,11 +941,15 @@ jobs: steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} trace-id: ${{ needs.activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Codegen Agentic Fix" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/codegen-agentic-fix.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" - name: Download agent output artifact id: download-agent-output continue-on-error: true @@ -885,7 +966,7 @@ jobs: echo "GH_AW_AGENT_OUTPUT=/tmp/gh-aw/agent_output.json" >> "$GITHUB_OUTPUT" - name: Process no-op messages id: noop - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_NOOP_MAX: "1" @@ -902,7 +983,7 @@ jobs: await main(); - name: Log detection run id: detection_runs - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_WORKFLOW_NAME: "Codegen Agentic Fix" @@ -918,7 +999,7 @@ jobs: await main(); - name: Record missing tool id: missing_tool - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_MISSING_TOOL_CREATE_ISSUE: "true" @@ -932,7 +1013,7 @@ jobs: await main(); - name: Record incomplete id: report_incomplete - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_REPORT_INCOMPLETE_CREATE_ISSUE: "true" @@ -947,13 +1028,14 @@ jobs: - name: Handle agent failure id: handle_agent_failure if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_WORKFLOW_NAME: "Codegen Agentic Fix" GH_AW_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} GH_AW_AGENT_CONCLUSION: ${{ needs.agent.result }} GH_AW_WORKFLOW_ID: "codegen-agentic-fix" + GH_AW_ACTION_FAILURE_ISSUE_EXPIRES_HOURS: "168" GH_AW_ENGINE_ID: "copilot" GH_AW_SECRET_VERIFICATION_RESULT: ${{ needs.activation.outputs.secret_verification_result }} GH_AW_CHECKOUT_PR_SUCCESS: ${{ needs.agent.outputs.checkout_pr_success }} @@ -961,13 +1043,16 @@ jobs: GH_AW_MCP_POLICY_ERROR: ${{ needs.agent.outputs.mcp_policy_error }} GH_AW_AGENTIC_ENGINE_TIMEOUT: ${{ needs.agent.outputs.agentic_engine_timeout }} GH_AW_MODEL_NOT_SUPPORTED_ERROR: ${{ needs.agent.outputs.model_not_supported_error }} + GH_AW_ENGINE_API_HOSTS: "api.enterprise.githubcopilot.com,api.githubcopilot.com,api.business.githubcopilot.com,api.individual.githubcopilot.com" GH_AW_CODE_PUSH_FAILURE_ERRORS: ${{ needs.safe_outputs.outputs.code_push_failure_errors }} GH_AW_CODE_PUSH_FAILURE_COUNT: ${{ needs.safe_outputs.outputs.code_push_failure_count }} GH_AW_LOCKDOWN_CHECK_FAILED: ${{ needs.activation.outputs.lockdown_check_failed }} GH_AW_STALE_LOCK_FILE_FAILED: ${{ needs.activation.outputs.stale_lock_file_failed }} GH_AW_GROUP_REPORTS: "false" GH_AW_FAILURE_REPORT_AS_ISSUE: "true" - GH_AW_TIMEOUT_MINUTES: "20" + GH_AW_MISSING_TOOL_REPORT_AS_FAILURE: "true" + GH_AW_MISSING_DATA_REPORT_AS_FAILURE: "true" + GH_AW_TIMEOUT_MINUTES: "60" with: github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} script: | @@ -992,11 +1077,15 @@ jobs: steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} trace-id: ${{ needs.activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Codegen Agentic Fix" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/codegen-agentic-fix.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" - name: Download agent output artifact id: download-agent-output continue-on-error: true @@ -1022,7 +1111,7 @@ jobs: rm -rf /tmp/gh-aw/sandbox/firewall/logs rm -rf /tmp/gh-aw/sandbox/firewall/audit - name: Download container images - run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.20 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20 ghcr.io/github/gh-aw-firewall/squid:0.25.20 + run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.40@sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40@sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280 ghcr.io/github/gh-aw-firewall/squid:0.25.40@sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51 - name: Check if detection needed id: detection_guard if: always() @@ -1037,10 +1126,10 @@ jobs: echo "run_detection=false" >> "$GITHUB_OUTPUT" echo "Detection skipped: no agent outputs or patches to analyze" fi - - name: Clear MCP configuration for detection + - name: Clear MCP Config for detection if: always() && steps.detection_guard.outputs.run_detection == 'true' run: | - rm -f /tmp/gh-aw/mcp-config/mcp-servers.json + rm -f "${RUNNER_TEMP}/gh-aw/mcp-config/mcp-servers.json" rm -f /home/runner/.copilot/mcp-config.json rm -f "$GITHUB_WORKSPACE/.gemini/settings.json" - name: Prepare threat detection files @@ -1059,7 +1148,7 @@ jobs: ls -la /tmp/gh-aw/threat-detection/ 2>/dev/null || true - name: Setup threat detection if: always() && steps.detection_guard.outputs.run_detection == 'true' - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: WORKFLOW_NAME: "Codegen Agentic Fix" WORKFLOW_DESCRIPTION: "Agentic fix for codegen-related build/test failures. Invoked when\nmvn verify fails after code generation changes." @@ -1075,33 +1164,44 @@ jobs: run: | mkdir -p /tmp/gh-aw/threat-detection touch /tmp/gh-aw/threat-detection/detection.log + - name: Setup Node.js + uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0 + with: + node-version: '24' + package-manager-cache: false - name: Install GitHub Copilot CLI - run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.21 + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.40 env: GH_HOST: github.com - name: Install AWF binary - run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.20 + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.40 - name: Execute GitHub Copilot CLI if: always() && steps.detection_guard.outputs.run_detection == 'true' + continue-on-error: true id: detection_agentic_execution # Copilot CLI tool arguments (sorted): timeout-minutes: 20 run: | set -o pipefail touch /tmp/gh-aw/agent-step-summary.md + GH_AW_NODE_BIN=$(command -v node 2>/dev/null || true) + export GH_AW_NODE_BIN (umask 177 && touch /tmp/gh-aw/threat-detection/detection.log) + printf '%s\n' '{"$schema":"https://github.com/github/gh-aw-firewall/releases/download/v0.25.40/awf-config.schema.json","network":{"allowDomains":["api.business.githubcopilot.com","api.enterprise.githubcopilot.com","api.github.com","api.githubcopilot.com","api.individual.githubcopilot.com","github.com","host.docker.internal","telemetry.enterprise.githubcopilot.com"]},"apiProxy":{"enabled":true},"container":{"imageTag":"0.25.40,squid=sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51,agent=sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504,api-proxy=sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280,cli-proxy=sha256:3e7152911d4b4b7b97beef9d3d7d924ff7902227e86001ef3838fb728d5d514c"}}' > "${RUNNER_TEMP}/gh-aw/awf-config.json" && cp "${RUNNER_TEMP}/gh-aw/awf-config.json" /tmp/gh-aw/awf-config.json # shellcheck disable=SC1003 - sudo -E awf --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" --env-all --exclude-env COPILOT_GITHUB_TOKEN --allow-domains api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,github.com,host.docker.internal,telemetry.enterprise.githubcopilot.com --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --image-tag 0.25.20 --skip-pull --enable-api-proxy \ - -- /bin/bash -c 'node ${RUNNER_TEMP}/gh-aw/actions/copilot_driver.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --add-dir "${GITHUB_WORKSPACE}" --prompt "$(cat /tmp/gh-aw/aw-prompts/prompt.txt)"' 2>&1 | tee -a /tmp/gh-aw/threat-detection/detection.log + sudo -E awf --config "${RUNNER_TEMP}/gh-aw/awf-config.json" --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" --env-all --exclude-env COPILOT_GITHUB_TOKEN --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --allow-host-ports 80,443,8080 --skip-pull \ + -- /bin/bash -c 'export PATH="$(find /opt/hostedtoolcache /home/runner/work/_tool -maxdepth 4 -type d -name bin 2>/dev/null | tr '\''\n'\'' '\'':'\'')$PATH"; [ -n "$GOROOT" ] && export PATH="$GOROOT/bin:$PATH" || true && GH_AW_NODE_EXEC="${GH_AW_NODE_BIN:-}"; if [ -z "$GH_AW_NODE_EXEC" ] || [ ! -x "$GH_AW_NODE_EXEC" ]; then GH_AW_NODE_EXEC="$(command -v node 2>/dev/null || echo node)"; fi; "$GH_AW_NODE_EXEC" ${RUNNER_TEMP}/gh-aw/actions/copilot_harness.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --add-dir "${GITHUB_WORKSPACE}" --prompt-file /tmp/gh-aw/aw-prompts/prompt.txt' 2>&1 | tee -a /tmp/gh-aw/threat-detection/detection.log env: COPILOT_AGENT_RUNNER_TYPE: STANDALONE + COPILOT_API_KEY: dummy-byok-key-for-offline-mode COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} - COPILOT_MODEL: ${{ vars.GH_AW_MODEL_DETECTION_COPILOT || '' }} + COPILOT_MODEL: ${{ vars.GH_AW_MODEL_DETECTION_COPILOT || 'claude-sonnet-4.6' }} GH_AW_PHASE: detection GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt - GH_AW_VERSION: v0.68.3 + GH_AW_VERSION: v0.71.5 GITHUB_API_URL: ${{ github.api_url }} GITHUB_AW: true + GITHUB_COPILOT_INTEGRATION_ID: agentic-workflows GITHUB_HEAD_REF: ${{ github.head_ref }} GITHUB_REF_NAME: ${{ github.ref_name }} GITHUB_SERVER_URL: ${{ github.server_url }} @@ -1122,16 +1222,33 @@ jobs: - name: Parse and conclude threat detection id: detection_conclusion if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + continue-on-error: true + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: RUN_DETECTION: ${{ steps.detection_guard.outputs.run_detection }} GH_AW_DETECTION_CONTINUE_ON_ERROR: "true" with: script: | - const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); - setupGlobals(core, github, context, exec, io, getOctokit); - const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs'); - await main(); + try { + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs'); + await main(); + } catch (loadErr) { + const continueOnError = process.env.GH_AW_DETECTION_CONTINUE_ON_ERROR !== 'false'; + const msg = 'ERR_SYSTEM: \u274C Unexpected error loading threat detection module: ' + (loadErr && loadErr.message ? loadErr.message : String(loadErr)); + core.error(msg); + core.setOutput('reason', 'parse_error'); + if (continueOnError) { + core.warning('\u26A0\uFE0F ' + msg); + core.setOutput('conclusion', 'warning'); + core.setOutput('success', 'false'); + } else { + core.setOutput('conclusion', 'failure'); + core.setOutput('success', 'false'); + core.setFailed(msg); + } + } safe_outputs: needs: @@ -1153,6 +1270,7 @@ jobs: GH_AW_EFFECTIVE_TOKENS: ${{ needs.agent.outputs.effective_tokens }} GH_AW_ENGINE_ID: "copilot" GH_AW_ENGINE_MODEL: ${{ needs.agent.outputs.model }} + GH_AW_ENGINE_VERSION: "1.0.40" GH_AW_WORKFLOW_ID: "codegen-agentic-fix" GH_AW_WORKFLOW_NAME: "Codegen Agentic Fix" outputs: @@ -1169,11 +1287,15 @@ jobs: steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} trace-id: ${{ needs.activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Codegen Agentic Fix" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/codegen-agentic-fix.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" - name: Download agent output artifact id: download-agent-output continue-on-error: true @@ -1227,13 +1349,13 @@ jobs: echo "GH_HOST=${GH_HOST}" >> "$GITHUB_ENV" - name: Process Safe Outputs id: process_safe_outputs - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_ALLOWED_DOMAINS: "*.githubusercontent.com,api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,api.snapcraft.io,archive.ubuntu.com,azure.archive.ubuntu.com,codeload.github.com,crl.geotrust.com,crl.globalsign.com,crl.identrust.com,crl.sectigo.com,crl.thawte.com,crl.usertrust.com,crl.verisign.com,crl3.digicert.com,crl4.digicert.com,crls.ssl.com,docs.github.com,github-cloud.githubusercontent.com,github-cloud.s3.amazonaws.com,github.blog,github.com,github.githubassets.com,host.docker.internal,json-schema.org,json.schemastore.org,keyserver.ubuntu.com,lfs.github.com,objects.githubusercontent.com,ocsp.digicert.com,ocsp.geotrust.com,ocsp.globalsign.com,ocsp.identrust.com,ocsp.sectigo.com,ocsp.ssl.com,ocsp.thawte.com,ocsp.usertrust.com,ocsp.verisign.com,packagecloud.io,packages.cloud.google.com,packages.microsoft.com,ppa.launchpad.net,raw.githubusercontent.com,registry.npmjs.org,s.symcb.com,s.symcd.com,security.ubuntu.com,telemetry.enterprise.githubcopilot.com,ts-crl.ws.symantec.com,ts-ocsp.ws.symantec.com,www.googleapis.com" GITHUB_SERVER_URL: ${{ github.server_url }} GITHUB_API_URL: ${{ github.api_url }} - GH_AW_SAFE_OUTPUTS_HANDLER_CONFIG: "{\"add_comment\":{\"max\":5,\"target\":\"*\"},\"create_report_incomplete_issue\":{},\"missing_data\":{},\"missing_tool\":{},\"noop\":{\"max\":1,\"report-as-issue\":\"false\"},\"push_to_pull_request_branch\":{\"if_no_changes\":\"warn\",\"max\":3,\"max_patch_size\":1024,\"protected_files\":[\"package.json\",\"bun.lockb\",\"bunfig.toml\",\"deno.json\",\"deno.jsonc\",\"deno.lock\",\"global.json\",\"NuGet.Config\",\"Directory.Packages.props\",\"mix.exs\",\"mix.lock\",\"go.mod\",\"go.sum\",\"stack.yaml\",\"stack.yaml.lock\",\"pom.xml\",\"build.gradle\",\"build.gradle.kts\",\"settings.gradle\",\"settings.gradle.kts\",\"gradle.properties\",\"package-lock.json\",\"yarn.lock\",\"pnpm-lock.yaml\",\"npm-shrinkwrap.json\",\"requirements.txt\",\"Pipfile\",\"Pipfile.lock\",\"pyproject.toml\",\"setup.py\",\"setup.cfg\",\"Gemfile\",\"Gemfile.lock\",\"uv.lock\",\"CODEOWNERS\",\"AGENTS.md\"],\"protected_path_prefixes\":[\".github/\",\".agents/\"]},\"report_incomplete\":{}}" + GH_AW_SAFE_OUTPUTS_HANDLER_CONFIG: "{\"add_comment\":{\"max\":5,\"target\":\"*\"},\"create_report_incomplete_issue\":{},\"missing_data\":{},\"missing_tool\":{},\"noop\":{\"max\":1,\"report-as-issue\":\"false\"},\"push_to_pull_request_branch\":{\"if_no_changes\":\"warn\",\"labels\":[\"dependencies\"],\"max_patch_size\":1024,\"protect_top_level_dot_folders\":true,\"protected_files\":[\"package.json\",\"bun.lockb\",\"bunfig.toml\",\"deno.json\",\"deno.jsonc\",\"deno.lock\",\"global.json\",\"NuGet.Config\",\"Directory.Packages.props\",\"mix.exs\",\"mix.lock\",\"go.mod\",\"go.sum\",\"stack.yaml\",\"stack.yaml.lock\",\"pom.xml\",\"build.gradle\",\"build.gradle.kts\",\"settings.gradle\",\"settings.gradle.kts\",\"gradle.properties\",\"package-lock.json\",\"yarn.lock\",\"pnpm-lock.yaml\",\"npm-shrinkwrap.json\",\"requirements.txt\",\"Pipfile\",\"Pipfile.lock\",\"pyproject.toml\",\"setup.py\",\"setup.cfg\",\"Gemfile\",\"Gemfile.lock\",\"uv.lock\",\"CODEOWNERS\",\"DESIGN.md\",\"README.md\",\"CONTRIBUTING.md\",\"CHANGELOG.md\",\"SECURITY.md\",\"CODE_OF_CONDUCT.md\",\"AGENTS.md\",\"CLAUDE.md\",\"GEMINI.md\"],\"target\":\"*\"},\"report_incomplete\":{}}" GH_AW_CI_TRIGGER_TOKEN: ${{ secrets.GH_AW_CI_TRIGGER_TOKEN }} with: github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} diff --git a/.github/workflows/codegen-agentic-fix.md b/.github/workflows/codegen-agentic-fix.md index eb93e1095d..948524999e 100644 --- a/.github/workflows/codegen-agentic-fix.md +++ b/.github/workflows/codegen-agentic-fix.md @@ -23,6 +23,8 @@ permissions: contents: read actions: read +timeout-minutes: 60 + network: allowed: - defaults @@ -33,9 +35,10 @@ tools: toolsets: [context, repos] safe-outputs: - push_to_pull_request_branch: - max: 3 - add_comment: + push-to-pull-request-branch: + target: "*" + labels: [dependencies] + add-comment: target: "*" max: 5 noop: @@ -174,7 +177,7 @@ For each attempt: 2. **Read the generated types** to understand what changed. Check the generated files that the handwritten code references: ```bash # Example: check what a generated type looks like now - cat src/generated/java/com/github/copilot/sdk/generated/rpc/.java + cat src/generated/java/com/github/copilot/generated/rpc/.java ``` 3. **Fix the affected source files.** You may modify files under: @@ -204,7 +207,7 @@ For each attempt: ### Step 5: Push fixes -After `mvn verify` passes, commit all changes and use the `push_to_pull_request_branch` safe-output tool to push to PR #${{ inputs.pr_number }}: +After `mvn verify` passes, commit all changes and use the `push-to-pull-request-branch` safe-output tool to push to PR #${{ inputs.pr_number }}: ```bash git add -A @@ -213,13 +216,13 @@ git commit -m "Fix codegen and build failures after @github/copilot update Automated fix applied by codegen-agentic-fix workflow." ``` -Then call the `push_to_pull_request_branch` tool to push your commits to the PR branch. +Then call the `push-to-pull-request-branch` tool to push your commits to the PR branch. ### Step 6: Failure handling If all 3 attempts fail: -1. Call the `add_comment` tool on PR #${{ inputs.pr_number }} explaining: +1. Call the `add-comment` tool on PR #${{ inputs.pr_number }} explaining: - What errors remain - What fixes were attempted - Whether the issue is in the code generator or handwritten code diff --git a/.github/workflows/codegen-check.yml b/.github/workflows/codegen-check.yml index b6f161d852..95e9365782 100644 --- a/.github/workflows/codegen-check.yml +++ b/.github/workflows/codegen-check.yml @@ -128,6 +128,9 @@ jobs: run: | ERROR_SUMMARY=$(cat /tmp/error-summary.txt) + # Ensure PR has dependencies label (required by codegen-agentic-fix safe-output) + gh pr edit "$PR_NUMBER" --add-label dependencies + gh workflow run codegen-agentic-fix.lock.yml \ -f branch="$BRANCH" \ -f pr_number="$PR_NUMBER" \ diff --git a/.github/workflows/copilot-setup-steps.yml b/.github/workflows/copilot-setup-steps.yml index 5bc3f56182..b53c9e8699 100644 --- a/.github/workflows/copilot-setup-steps.yml +++ b/.github/workflows/copilot-setup-steps.yml @@ -24,9 +24,9 @@ jobs: # Install GitHub CLI and gh-aw extension for Copilot Agent interaction - name: Install gh-aw extension - uses: github/gh-aw/actions/setup-cli@ce1794953e0ec42adc41b6fca05e02ab49ee21c3 # v0.68.3 + uses: github/gh-aw/actions/setup-cli@0feed75a980b06f247abbbf80127f8eb2c19e2c5 # v0.74.8 with: - version: v0.42.17 + version: v0.68.3 # Setup Node.js - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6 diff --git a/.github/workflows/publish-maven.yml b/.github/workflows/publish-maven.yml index 99e61ac18f..cc612389b7 100644 --- a/.github/workflows/publish-maven.yml +++ b/.github/workflows/publish-maven.yml @@ -87,8 +87,8 @@ jobs: else # Split version: supports "0.1.32", "0.1.32-java.0", and "0.1.32-java-preview.0" formats # Validate RELEASE_VERSION format explicitly to provide clear errors - if ! echo "$RELEASE_VERSION" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+(-java(-preview)?\.[0-9]+)?$'; then - echo "Error: RELEASE_VERSION '$RELEASE_VERSION' is invalid. Expected format: M.M.P, M.M.P-java.N, or M.M.P-java-preview.N (e.g., 1.2.3, 1.2.3-java.0, or 1.2.3-java-preview.0)." >&2 + if ! echo "$RELEASE_VERSION" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+(-(beta-)?java(-preview)?\.[0-9]+)?$'; then + echo "Error: RELEASE_VERSION '$RELEASE_VERSION' is invalid. Expected format: M.M.P, M.M.P-java.N, M.M.P-java-preview.N, M.M.P-beta-java.N, or M.M.P-beta-java-preview.N (e.g., 1.2.3, 1.2.3-java.0, 1.2.3-java-preview.0, 1.2.3-beta-java.0, or 1.2.3-beta-java-preview.0)." >&2 exit 1 fi # Extract the base M.M.P portion (before any qualifier) @@ -121,21 +121,21 @@ jobs: # Update CHANGELOG.md with release version and Reference implementation sync hash ./.github/scripts/release/update-changelog.sh "${VERSION}" "${REFERENCE_IMPL_HASH}" - # Update version in README.md (supports versions like 1.0.0, 0.1.32-java.0, and 0.3.0-java-preview.0) - sed -i "s|[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-java\(-preview\)\{0,1\}\.[0-9][0-9]*\)\{0,1\}|${VERSION}|g" README.md - sed -i "s|copilot-sdk-java:[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-java\(-preview\)\{0,1\}\.[0-9][0-9]*\)\{0,1\}|copilot-sdk-java:${VERSION}|g" README.md + # Update version in README.md (supports any version qualifier like -java.N, -java-preview.N, -beta-java.N) + sed -i "s|[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-[a-z][a-z0-9-]*\.[0-9][0-9]*\)*|${VERSION}|g" README.md + sed -i "s|copilot-sdk-java:[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-[a-z][a-z0-9-]*\.[0-9][0-9]*\)*|copilot-sdk-java:${VERSION}|g" README.md # Update snapshot version in README.md DEV_VERSION="${{ steps.versions.outputs.dev_version }}" - sed -i "s|[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-java\(-preview\)\{0,1\}\.[0-9][0-9]*\)\{0,1\}-SNAPSHOT|${DEV_VERSION}|g" README.md + sed -i "s|[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-[a-z][a-z0-9-]*\.[0-9][0-9]*\)*-SNAPSHOT|${DEV_VERSION}|g" README.md # Update version in jbang-example.java - sed -i "s|copilot-sdk-java:[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-java\(-preview\)\{0,1\}\.[0-9][0-9]*\)\{0,1\}|copilot-sdk-java:${VERSION}|g" jbang-example.java + sed -i "s|copilot-sdk-java:[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-[a-z][a-z0-9-]*\.[0-9][0-9]*\)*|copilot-sdk-java:${VERSION}|g" jbang-example.java sed -i 's|copilot-sdk-java:${project\.version}|copilot-sdk-java:'"${VERSION}"'|g' jbang-example.java # Update version in cookbook files (hardcoded for direct GitHub browsing and JBang usage) find src/site/markdown/cookbook -name "*.md" -type f -exec \ - sed -i "s|copilot-sdk-java:[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-java\(-preview\)\{0,1\}\.[0-9][0-9]*\)\{0,1\}|copilot-sdk-java:${VERSION}|g" {} \; + sed -i "s|copilot-sdk-java:[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\(-[a-z][a-z0-9-]*\.[0-9][0-9]*\)*|copilot-sdk-java:${VERSION}|g" {} \; # Commit the documentation changes before release:prepare (requires clean working directory) git add CHANGELOG.md README.md jbang-example.java src/site/markdown/cookbook/ diff --git a/.github/workflows/weekly-reference-impl-sync.lock.yml b/.github/workflows/reference-impl-sync.lock.yml similarity index 64% rename from .github/workflows/weekly-reference-impl-sync.lock.yml rename to .github/workflows/reference-impl-sync.lock.yml index 49bfd3ac0f..98fd0d0d0b 100644 --- a/.github/workflows/weekly-reference-impl-sync.lock.yml +++ b/.github/workflows/reference-impl-sync.lock.yml @@ -1,5 +1,5 @@ -# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"54f733578d3011b148c7aff09a0e72085d787a777a996488f08aeffdf52ec93b","compiler_version":"v0.68.3","strict":true,"agent_id":"copilot"} -# gh-aw-manifest: {"version":1,"secrets":["COPILOT_GITHUB_TOKEN","GH_AW_AGENT_TOKEN","GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"373c709c69115d41ff229c7e5df9f8788daa9553","version":"v9"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"ba90f2186d7ad780ec640f364005fa24e797b360","version":"v0.68.3"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.20"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.2.19"},{"image":"ghcr.io/github/github-mcp-server:v0.32.0"},{"image":"node:lts-alpine"}]} +# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"d3b88eb52d0d4007c7a64118dfa3866bcbba7589a38004bb5c47695bee9e7ac7","compiler_version":"v0.74.4","strict":true,"agent_id":"copilot"} +# gh-aw-manifest: {"version":1,"secrets":["COPILOT_GITHUB_TOKEN","GH_AW_AGENT_TOKEN","GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"373c709c69115d41ff229c7e5df9f8788daa9553","version":"v9"},{"repo":"actions/github-script","sha":"3a2844b7e9c422d3c10d287c895573f7108da1b3","version":"v9.0.0"},{"repo":"actions/setup-node","sha":"48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e","version":"v6.4.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"d3abfe96a194bce3a523ed2093ddedd5704cdf62","version":"v0.74.4"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.46"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.46"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.46"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.3.9","digest":"sha256:64828b42a4482f58fab16509d7f8f495a6d97c972a98a68aff20543531ac0388","pinned_image":"ghcr.io/github/gh-aw-mcpg:v0.3.9@sha256:64828b42a4482f58fab16509d7f8f495a6d97c972a98a68aff20543531ac0388"},{"image":"ghcr.io/github/github-mcp-server:v1.0.4"},{"image":"node:lts-alpine","digest":"sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f","pinned_image":"node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f"}]} # ___ _ _ # / _ \ | | (_) # | |_| | __ _ ___ _ __ | |_ _ ___ @@ -14,7 +14,7 @@ # \ /\ / (_) | | | | ( | | | | (_) \ V V /\__ \ # \/ \/ \___/|_| |_|\_\|_| |_|\___/ \_/\_/ |___/ # -# This file was automatically generated by gh-aw (v0.68.3). DO NOT EDIT. +# This file was automatically generated by gh-aw (v0.74.4). DO NOT EDIT. # # To update this file, edit the corresponding .md file and run: # gh aw compile @@ -22,7 +22,7 @@ # # For more information: https://github.github.com/gh-aw/introduction/overview/ # -# Weekly reference implementation sync workflow. Checks for new commits in the official +# Reference implementation sync workflow. Checks for new commits in the official # Copilot SDK (github/copilot-sdk) and assigns to Copilot to port changes. # # Secrets used: @@ -36,22 +36,24 @@ # - actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 # - actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 # - actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 +# - actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 +# - actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0 # - actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 -# - github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 +# - github/gh-aw-actions/setup@d3abfe96a194bce3a523ed2093ddedd5704cdf62 # v0.74.4 # # Container images used: -# - ghcr.io/github/gh-aw-firewall/agent:0.25.20 -# - ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20 -# - ghcr.io/github/gh-aw-firewall/squid:0.25.20 -# - ghcr.io/github/gh-aw-mcpg:v0.2.19 -# - ghcr.io/github/github-mcp-server:v0.32.0 -# - node:lts-alpine +# - ghcr.io/github/gh-aw-firewall/agent:0.25.46 +# - ghcr.io/github/gh-aw-firewall/api-proxy:0.25.46 +# - ghcr.io/github/gh-aw-firewall/squid:0.25.46 +# - ghcr.io/github/gh-aw-mcpg:v0.3.9@sha256:64828b42a4482f58fab16509d7f8f495a6d97c972a98a68aff20543531ac0388 +# - ghcr.io/github/github-mcp-server:v1.0.4 +# - node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f -name: "Weekly Reference Implementation Sync" -"on": +name: "Reference Implementation Sync" +on: schedule: - - cron: "40 11 * * 0" - # Friendly format: weekly (scattered) + - cron: "25 2 * * 5" + # Friendly format: weekly on friday (scattered) workflow_dispatch: inputs: aw_context: @@ -65,7 +67,7 @@ permissions: {} concurrency: group: "gh-aw-${{ github.workflow }}" -run-name: "Weekly Reference Implementation Sync" +run-name: "Reference Implementation Sync" jobs: activation: @@ -76,38 +78,46 @@ jobs: outputs: comment_id: "" comment_repo: "" + engine_id: ${{ steps.generate_aw_info.outputs.engine_id }} lockdown_check_failed: ${{ steps.generate_aw_info.outputs.lockdown_check_failed == 'true' }} model: ${{ steps.generate_aw_info.outputs.model }} secret_verification_result: ${{ steps.validate-secret.outputs.verification_result }} + setup-parent-span-id: ${{ steps.setup.outputs.parent-span-id || steps.setup.outputs.span-id }} + setup-span-id: ${{ steps.setup.outputs.span-id }} setup-trace-id: ${{ steps.setup.outputs.trace-id }} stale_lock_file_failed: ${{ steps.check-lock-file.outputs.stale_lock_file_failed == 'true' }} steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@d3abfe96a194bce3a523ed2093ddedd5704cdf62 # v0.74.4 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Reference Implementation Sync" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/reference-impl-sync.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.48" + GH_AW_INFO_ENGINE_ID: "copilot" - name: Generate agentic run info id: generate_aw_info env: GH_AW_INFO_ENGINE_ID: "copilot" GH_AW_INFO_ENGINE_NAME: "GitHub Copilot CLI" - GH_AW_INFO_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || 'auto' }} - GH_AW_INFO_VERSION: "1.0.21" - GH_AW_INFO_AGENT_VERSION: "1.0.21" - GH_AW_INFO_CLI_VERSION: "v0.68.3" - GH_AW_INFO_WORKFLOW_NAME: "Weekly Reference Implementation Sync" + GH_AW_INFO_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || 'claude-sonnet-4.6' }} + GH_AW_INFO_VERSION: "1.0.48" + GH_AW_INFO_AGENT_VERSION: "1.0.48" + GH_AW_INFO_CLI_VERSION: "v0.74.4" + GH_AW_INFO_WORKFLOW_NAME: "Reference Implementation Sync" GH_AW_INFO_EXPERIMENTAL: "false" GH_AW_INFO_SUPPORTS_TOOLS_ALLOWLIST: "true" GH_AW_INFO_STAGED: "false" GH_AW_INFO_ALLOWED_DOMAINS: '["defaults","github"]' GH_AW_INFO_FIREWALL_ENABLED: "true" - GH_AW_INFO_AWF_VERSION: "v0.25.20" + GH_AW_INFO_AWF_VERSION: "v0.25.46" GH_AW_INFO_AWMG_VERSION: "" GH_AW_INFO_FIREWALL_TYPE: "squid" GH_AW_COMPILED_STRICT: "true" - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -126,13 +136,25 @@ jobs: sparse-checkout: | .github .agents + .claude + .codex + .crush + .gemini + .opencode + .pi sparse-checkout-cone-mode: true fetch-depth: 1 + - name: Save agent config folders for base branch restoration + env: + GH_AW_AGENT_FOLDERS: ".agents .claude .codex .crush .gemini .github .opencode .pi" + GH_AW_AGENT_FILES: ".crush.json AGENTS.md CLAUDE.md GEMINI.md PI.md opencode.jsonc" + # poutine:ignore untrusted_checkout_exec + run: bash "${RUNNER_TEMP}/gh-aw/actions/save_base_github_folders.sh" - name: Check workflow lock file id: check-lock-file - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: - GH_AW_WORKFLOW_FILE: "weekly-reference-impl-sync.lock.yml" + GH_AW_WORKFLOW_FILE: "reference-impl-sync.lock.yml" GH_AW_CONTEXT_WORKFLOW_REF: "${{ github.workflow_ref }}" with: script: | @@ -141,9 +163,9 @@ jobs: const { main } = require('${{ runner.temp }}/gh-aw/actions/check_workflow_timestamp_api.cjs'); await main(); - name: Check compile-agentic version - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: - GH_AW_COMPILED_VERSION: "v0.68.3" + GH_AW_COMPILED_VERSION: "v0.74.4" with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -154,11 +176,11 @@ jobs: env: GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt GH_AW_SAFE_OUTPUTS: ${{ runner.temp }}/gh-aw/safeoutputs/outputs.jsonl + GH_AW_EXPR_1A3A194A: ${{ github.event.discussion.number || (fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_type == 'discussion' && fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_number) }} + GH_AW_EXPR_463A214A: ${{ github.event.pull_request.number || (fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_type == 'pull_request' && fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_number) }} + GH_AW_EXPR_802A9F6A: ${{ github.event.issue.number || (fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_type == 'issue' && fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_number) }} + GH_AW_EXPR_FF1D34CE: ${{ github.event.comment.id || fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').comment_id }} GH_AW_GITHUB_ACTOR: ${{ github.actor }} - GH_AW_GITHUB_EVENT_COMMENT_ID: ${{ github.event.comment.id }} - GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER: ${{ github.event.discussion.number }} - GH_AW_GITHUB_EVENT_ISSUE_NUMBER: ${{ github.event.issue.number }} - GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER: ${{ github.event.pull_request.number }} GH_AW_GITHUB_REPOSITORY: ${{ github.repository }} GH_AW_GITHUB_RUN_ID: ${{ github.run_id }} GH_AW_GITHUB_WORKSPACE: ${{ github.workspace }} @@ -166,56 +188,60 @@ jobs: run: | bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh" { - cat << 'GH_AW_PROMPT_9a049ffd9b204d97_EOF' + cat << 'GH_AW_PROMPT_5937f7f329fed3c9_EOF' - GH_AW_PROMPT_9a049ffd9b204d97_EOF + GH_AW_PROMPT_5937f7f329fed3c9_EOF cat "${RUNNER_TEMP}/gh-aw/prompts/xpia.md" cat "${RUNNER_TEMP}/gh-aw/prompts/temp_folder_prompt.md" cat "${RUNNER_TEMP}/gh-aw/prompts/markdown.md" cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_prompt.md" - cat << 'GH_AW_PROMPT_9a049ffd9b204d97_EOF' + cat << 'GH_AW_PROMPT_5937f7f329fed3c9_EOF' - Tools: add_comment(max:10), create_issue, close_issue(max:10), assign_to_agent, missing_tool, missing_data, noop + Tools: add_comment(max:10), create_issue, close_issue(max:10), close_pull_request(max:10), assign_to_agent, missing_tool, missing_data, noop + GH_AW_PROMPT_5937f7f329fed3c9_EOF + cat "${RUNNER_TEMP}/gh-aw/prompts/mcp_cli_tools_prompt.md" + cat << 'GH_AW_PROMPT_5937f7f329fed3c9_EOF' The following GitHub context information is available for this workflow: - {{#if __GH_AW_GITHUB_ACTOR__ }} + {{#if github.actor}} - **actor**: __GH_AW_GITHUB_ACTOR__ {{/if}} - {{#if __GH_AW_GITHUB_REPOSITORY__ }} + {{#if github.repository}} - **repository**: __GH_AW_GITHUB_REPOSITORY__ {{/if}} - {{#if __GH_AW_GITHUB_WORKSPACE__ }} + {{#if github.workspace}} - **workspace**: __GH_AW_GITHUB_WORKSPACE__ {{/if}} - {{#if __GH_AW_GITHUB_EVENT_ISSUE_NUMBER__ }} - - **issue-number**: #__GH_AW_GITHUB_EVENT_ISSUE_NUMBER__ + {{#if github.event.issue.number || (github.aw.context.item_type == 'issue' && github.aw.context.item_number)}} + - **issue-number**: #__GH_AW_EXPR_802A9F6A__ {{/if}} - {{#if __GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER__ }} - - **discussion-number**: #__GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER__ + {{#if github.event.discussion.number || (github.aw.context.item_type == 'discussion' && github.aw.context.item_number)}} + - **discussion-number**: #__GH_AW_EXPR_1A3A194A__ {{/if}} - {{#if __GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER__ }} - - **pull-request-number**: #__GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER__ + {{#if github.event.pull_request.number || (github.aw.context.item_type == 'pull_request' && github.aw.context.item_number)}} + - **pull-request-number**: #__GH_AW_EXPR_463A214A__ {{/if}} - {{#if __GH_AW_GITHUB_EVENT_COMMENT_ID__ }} - - **comment-id**: __GH_AW_GITHUB_EVENT_COMMENT_ID__ + {{#if github.event.comment.id || github.aw.context.comment_id}} + - **comment-id**: __GH_AW_EXPR_FF1D34CE__ {{/if}} - {{#if __GH_AW_GITHUB_RUN_ID__ }} + {{#if github.run_id}} - **workflow-run-id**: __GH_AW_GITHUB_RUN_ID__ {{/if}} - GH_AW_PROMPT_9a049ffd9b204d97_EOF + GH_AW_PROMPT_5937f7f329fed3c9_EOF cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md" - cat << 'GH_AW_PROMPT_9a049ffd9b204d97_EOF' + cat << 'GH_AW_PROMPT_5937f7f329fed3c9_EOF' - {{#runtime-import .github/workflows/weekly-reference-impl-sync.md}} - GH_AW_PROMPT_9a049ffd9b204d97_EOF + {{#runtime-import .github/workflows/reference-impl-sync.md}} + GH_AW_PROMPT_5937f7f329fed3c9_EOF } > "$GH_AW_PROMPT" - name: Interpolate variables and render templates - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + GH_AW_ENGINE_ID: "copilot" with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -223,17 +249,18 @@ jobs: const { main } = require('${{ runner.temp }}/gh-aw/actions/interpolate_prompt.cjs'); await main(); - name: Substitute placeholders - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + GH_AW_EXPR_1A3A194A: ${{ github.event.discussion.number || (fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_type == 'discussion' && fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_number) }} + GH_AW_EXPR_463A214A: ${{ github.event.pull_request.number || (fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_type == 'pull_request' && fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_number) }} + GH_AW_EXPR_802A9F6A: ${{ github.event.issue.number || (fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_type == 'issue' && fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').item_number) }} + GH_AW_EXPR_FF1D34CE: ${{ github.event.comment.id || fromJSON(github.event.inputs.aw_context || github.event.client_payload.aw_context || '{}').comment_id }} GH_AW_GITHUB_ACTOR: ${{ github.actor }} - GH_AW_GITHUB_EVENT_COMMENT_ID: ${{ github.event.comment.id }} - GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER: ${{ github.event.discussion.number }} - GH_AW_GITHUB_EVENT_ISSUE_NUMBER: ${{ github.event.issue.number }} - GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER: ${{ github.event.pull_request.number }} GH_AW_GITHUB_REPOSITORY: ${{ github.repository }} GH_AW_GITHUB_RUN_ID: ${{ github.run_id }} GH_AW_GITHUB_WORKSPACE: ${{ github.workspace }} + GH_AW_MCP_CLI_SERVERS_LIST: '- `safeoutputs` β€” run `safeoutputs --help` to see available tools' with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -245,14 +272,15 @@ jobs: return await substitutePlaceholders({ file: process.env.GH_AW_PROMPT, substitutions: { + GH_AW_EXPR_1A3A194A: process.env.GH_AW_EXPR_1A3A194A, + GH_AW_EXPR_463A214A: process.env.GH_AW_EXPR_463A214A, + GH_AW_EXPR_802A9F6A: process.env.GH_AW_EXPR_802A9F6A, + GH_AW_EXPR_FF1D34CE: process.env.GH_AW_EXPR_FF1D34CE, GH_AW_GITHUB_ACTOR: process.env.GH_AW_GITHUB_ACTOR, - GH_AW_GITHUB_EVENT_COMMENT_ID: process.env.GH_AW_GITHUB_EVENT_COMMENT_ID, - GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER: process.env.GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER, - GH_AW_GITHUB_EVENT_ISSUE_NUMBER: process.env.GH_AW_GITHUB_EVENT_ISSUE_NUMBER, - GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER: process.env.GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER, GH_AW_GITHUB_REPOSITORY: process.env.GH_AW_GITHUB_REPOSITORY, GH_AW_GITHUB_RUN_ID: process.env.GH_AW_GITHUB_RUN_ID, - GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE + GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE, + GH_AW_MCP_CLI_SERVERS_LIST: process.env.GH_AW_MCP_CLI_SERVERS_LIST } }); - name: Validate prompt placeholders @@ -270,10 +298,15 @@ jobs: uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 with: name: activation + include-hidden-files: true path: | /tmp/gh-aw/aw_info.json /tmp/gh-aw/aw-prompts/prompt.txt + /tmp/gh-aw/aw-prompts/prompt-template.txt + /tmp/gh-aw/aw-prompts/prompt-import-tree.json /tmp/gh-aw/github_rate_limits.jsonl + /tmp/gh-aw/base + /tmp/gh-aw/.github/agents if-no-files-found: ignore retention-days: 1 @@ -284,6 +317,7 @@ jobs: actions: read contents: read issues: read + pull-requests: read concurrency: group: "gh-aw-copilot-${{ github.workflow }}" env: @@ -292,11 +326,12 @@ jobs: GH_AW_ASSETS_BRANCH: "" GH_AW_ASSETS_MAX_SIZE_KB: 0 GH_AW_MCP_LOG_DIR: /tmp/gh-aw/mcp-logs/safeoutputs - GH_AW_WORKFLOW_ID_SANITIZED: weeklyreferenceimplsync + GH_AW_WORKFLOW_ID_SANITIZED: referenceimplsync outputs: agentic_engine_timeout: ${{ steps.detect-copilot-errors.outputs.agentic_engine_timeout || 'false' }} checkout_pr_success: ${{ steps.checkout-pr.outputs.checkout_pr_success || 'true' }} effective_tokens: ${{ steps.parse-mcp-gateway.outputs.effective_tokens }} + effective_tokens_rate_limit_error: ${{ steps.parse-mcp-gateway.outputs.effective_tokens_rate_limit_error || 'false' }} has_patch: ${{ steps.collect_output.outputs.has_patch }} inference_access_error: ${{ steps.detect-copilot-errors.outputs.inference_access_error || 'false' }} mcp_policy_error: ${{ steps.detect-copilot-errors.outputs.mcp_policy_error || 'false' }} @@ -304,15 +339,23 @@ jobs: model_not_supported_error: ${{ steps.detect-copilot-errors.outputs.model_not_supported_error || 'false' }} output: ${{ steps.collect_output.outputs.output }} output_types: ${{ steps.collect_output.outputs.output_types }} + setup-parent-span-id: ${{ steps.setup.outputs.parent-span-id || steps.setup.outputs.span-id }} + setup-span-id: ${{ steps.setup.outputs.span-id }} setup-trace-id: ${{ steps.setup.outputs.trace-id }} steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@d3abfe96a194bce3a523ed2093ddedd5704cdf62 # v0.74.4 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} trace-id: ${{ needs.activation.outputs.setup-trace-id }} + parent-span-id: ${{ needs.activation.outputs.setup-parent-span-id || needs.activation.outputs.setup-span-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Reference Implementation Sync" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/reference-impl-sync.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.48" + GH_AW_INFO_ENGINE_ID: "copilot" - name: Set runtime paths id: set-runtime-paths run: | @@ -348,7 +391,7 @@ jobs: id: checkout-pr if: | github.event.pull_request || github.event.issue.pull_request - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} with: @@ -359,11 +402,11 @@ jobs: const { main } = require('${{ runner.temp }}/gh-aw/actions/checkout_pr_branch.cjs'); await main(); - name: Install GitHub Copilot CLI - run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.21 + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.48 env: GH_HOST: github.com - name: Install AWF binary - run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.20 + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.46 - name: Determine automatic lockdown mode for GitHub MCP Server id: determine-automatic-lockdown uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 @@ -374,17 +417,33 @@ jobs: script: | const determineAutomaticLockdown = require('${{ runner.temp }}/gh-aw/actions/determine_automatic_lockdown.cjs'); await determineAutomaticLockdown(github, context, core); + - name: Download activation artifact + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: activation + path: /tmp/gh-aw + - name: Restore agent config folders from base branch + if: steps.checkout-pr.outcome == 'success' + env: + GH_AW_AGENT_FOLDERS: ".agents .claude .codex .crush .gemini .github .opencode .pi" + GH_AW_AGENT_FILES: ".crush.json AGENTS.md CLAUDE.md GEMINI.md PI.md opencode.jsonc" + run: bash "${RUNNER_TEMP}/gh-aw/actions/restore_base_github_folders.sh" + - name: Restore inline sub-agents from activation artifact + env: + GH_AW_SUB_AGENT_DIR: ".github/agents" + GH_AW_SUB_AGENT_EXT: ".agent.md" + run: bash "${RUNNER_TEMP}/gh-aw/actions/restore_inline_sub_agents.sh" - name: Download container images - run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.20 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20 ghcr.io/github/gh-aw-firewall/squid:0.25.20 ghcr.io/github/gh-aw-mcpg:v0.2.19 ghcr.io/github/github-mcp-server:v0.32.0 node:lts-alpine - - name: Write Safe Outputs Config + run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.46 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.46 ghcr.io/github/gh-aw-firewall/squid:0.25.46 ghcr.io/github/gh-aw-mcpg:v0.3.9@sha256:64828b42a4482f58fab16509d7f8f495a6d97c972a98a68aff20543531ac0388 ghcr.io/github/github-mcp-server:v1.0.4 node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f + - name: Generate Safe Outputs Config run: | mkdir -p "${RUNNER_TEMP}/gh-aw/safeoutputs" mkdir -p /tmp/gh-aw/safeoutputs mkdir -p /tmp/gh-aw/mcp-logs/safeoutputs - cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_2a317c5680ea1925_EOF' - {"add_comment":{"max":10,"target":"*"},"assign_to_agent":{"max":1,"model":"claude-opus-4.6","name":"copilot","target":"*"},"close_issue":{"max":10,"required_labels":["reference-impl-sync"],"target":"*"},"create_issue":{"assignees":["copilot-swe-agent"],"expires":144,"labels":["reference-impl-sync"],"max":1,"title_prefix":"[reference-impl-sync] "},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"false"},"report_incomplete":{}} - GH_AW_SAFE_OUTPUTS_CONFIG_2a317c5680ea1925_EOF - - name: Write Safe Outputs Tools + cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_8434d42e1eaff150_EOF' + {"add_comment":{"max":10,"target":"*"},"assign_to_agent":{"max":1,"model":"claude-opus-4.6","name":"copilot","target":"*"},"close_issue":{"max":10,"required_labels":["reference-impl-sync"],"target":"*"},"close_pull_request":{"max":10,"target":"*"},"create_issue":{"expires":144,"labels":["reference-impl-sync"],"max":1,"title_prefix":"[reference-impl-sync] "},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"false"},"report_incomplete":{}} + GH_AW_SAFE_OUTPUTS_CONFIG_8434d42e1eaff150_EOF + - name: Generate Safe Outputs Tools env: GH_AW_TOOLS_META_JSON: | { @@ -392,7 +451,8 @@ jobs: "add_comment": " CONSTRAINTS: Maximum 10 comment(s) can be added. Target: *. Supports reply_to_id for discussion threading.", "assign_to_agent": " CONSTRAINTS: Maximum 1 issue(s) can be assigned to agent.", "close_issue": " CONSTRAINTS: Maximum 10 issue(s) can be closed. Target: *.", - "create_issue": " CONSTRAINTS: Maximum 1 issue(s) can be created. Title will be prefixed with \"[reference-impl-sync] \". Labels [\"reference-impl-sync\"] will be automatically added. Assignees [\"copilot-swe-agent\"] will be automatically assigned." + "close_pull_request": " CONSTRAINTS: Maximum 10 pull request(s) can be closed. Target: *.", + "create_issue": " CONSTRAINTS: Maximum 1 issue(s) can be created. Title will be prefixed with \"[reference-impl-sync] \". Labels [\"reference-impl-sync\"] will be automatically added." }, "repo_params": {}, "dynamic_tools": [] @@ -464,6 +524,24 @@ jobs: } } }, + "close_pull_request": { + "defaultMax": 1, + "fields": { + "body": { + "required": true, + "type": "string", + "sanitize": true, + "maxLength": 65000 + }, + "pull_request_number": { + "optionalPositiveInteger": true + }, + "repo": { + "type": "string", + "maxLength": 256 + } + } + }, "create_issue": { "defaultMax": 1, "fields": { @@ -473,6 +551,9 @@ jobs: "sanitize": true, "maxLength": 65000 }, + "fields": { + "type": "array" + }, "labels": { "type": "array", "itemType": "string", @@ -571,7 +652,7 @@ jobs: } } } - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -629,11 +710,12 @@ jobs: GITHUB_MCP_SERVER_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} run: | set -eo pipefail - mkdir -p /tmp/gh-aw/mcp-config + mkdir -p "${RUNNER_TEMP}/gh-aw/mcp-config" # Export gateway environment variables for MCP config and gateway script - export MCP_GATEWAY_PORT="80" + export MCP_GATEWAY_PORT="8080" export MCP_GATEWAY_DOMAIN="host.docker.internal" + export MCP_GATEWAY_HOST_DOMAIN="localhost" MCP_GATEWAY_API_KEY=$(openssl rand -base64 45 | tr -d '/+=') echo "::add-mask::${MCP_GATEWAY_API_KEY}" export MCP_GATEWAY_API_KEY @@ -643,20 +725,29 @@ jobs: export DEBUG="*" export GH_AW_ENGINE="copilot" - export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host -v /var/run/docker.sock:/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.2.19' + MCP_GATEWAY_UID=$(id -u 2>/dev/null || echo '0') + MCP_GATEWAY_GID=$(id -g 2>/dev/null || echo '0') + case "${DOCKER_HOST:-}" in + unix://* ) DOCKER_SOCK_PATH="${DOCKER_HOST#unix://}" ;; + /* ) DOCKER_SOCK_PATH="$DOCKER_HOST" ;; + * ) DOCKER_SOCK_PATH=/var/run/docker.sock ;; + esac + DOCKER_SOCK_GID=$(stat -c '%g' "$DOCKER_SOCK_PATH" 2>/dev/null || echo '0') + export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host --add-host host.docker.internal:127.0.0.1 --user '"${MCP_GATEWAY_UID}"':'"${MCP_GATEWAY_GID}"' --group-add '"${DOCKER_SOCK_GID}"' -v '"${DOCKER_SOCK_PATH}"':/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DOCKER_HOST=unix:///var/run/docker.sock -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.3.9' mkdir -p /home/runner/.copilot - cat << GH_AW_MCP_CONFIG_ee30822602a32ffa_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh" + GH_AW_NODE=$(which node 2>/dev/null || command -v node 2>/dev/null || echo node) + cat << GH_AW_MCP_CONFIG_91f5ce417df04baa_EOF | "$GH_AW_NODE" "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.cjs" { "mcpServers": { "github": { "type": "stdio", - "container": "ghcr.io/github/github-mcp-server:v0.32.0", + "container": "ghcr.io/github/github-mcp-server:v1.0.4", "env": { "GITHUB_HOST": "\${GITHUB_SERVER_URL}", "GITHUB_PERSONAL_ACCESS_TOKEN": "\${GITHUB_MCP_SERVER_TOKEN}", "GITHUB_READ_ONLY": "1", - "GITHUB_TOOLSETS": "context,repos,issues" + "GITHUB_TOOLSETS": "context,repos,issues,pull_requests" }, "guard-policies": { "allow-only": { @@ -687,37 +778,61 @@ jobs: "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}" } } - GH_AW_MCP_CONFIG_ee30822602a32ffa_EOF - - name: Download activation artifact - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + GH_AW_MCP_CONFIG_91f5ce417df04baa_EOF + - name: Mount MCP servers as CLIs + id: mount-mcp-clis + continue-on-error: true + env: + MCP_GATEWAY_API_KEY: ${{ steps.start-mcp-gateway.outputs.gateway-api-key }} + MCP_GATEWAY_DOMAIN: ${{ steps.start-mcp-gateway.outputs.gateway-domain }} + MCP_GATEWAY_PORT: ${{ steps.start-mcp-gateway.outputs.gateway-port }} + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: - name: activation - path: /tmp/gh-aw - - name: Clean git credentials + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io); + const { main } = require('${{ runner.temp }}/gh-aw/actions/mount_mcp_as_cli.cjs'); + await main(); + - name: Clean credentials continue-on-error: true run: bash "${RUNNER_TEMP}/gh-aw/actions/clean_git_credentials.sh" + - name: Audit pre-agent workspace + id: pre_agent_audit + continue-on-error: true + run: bash "${RUNNER_TEMP}/gh-aw/actions/audit_pre_agent_workspace.sh" - name: Execute GitHub Copilot CLI id: agentic_execution # Copilot CLI tool arguments (sorted): timeout-minutes: 20 run: | set -o pipefail + printf '%s' "$(date +%s%3N)" > /tmp/gh-aw/agent_cli_start_ms.txt touch /tmp/gh-aw/agent-step-summary.md + GH_AW_NODE_BIN=$(command -v node 2>/dev/null || true) + export GH_AW_NODE_BIN (umask 177 && touch /tmp/gh-aw/agent-stdio.log) + printf '%s\n' '{"$schema":"https://github.com/github/gh-aw-firewall/releases/download/v0.25.46/awf-config.schema.json","network":{"allowDomains":["*.githubusercontent.com","api.business.githubcopilot.com","api.enterprise.githubcopilot.com","api.github.com","api.githubcopilot.com","api.individual.githubcopilot.com","api.snapcraft.io","archive.ubuntu.com","azure.archive.ubuntu.com","codeload.github.com","crl.geotrust.com","crl.globalsign.com","crl.identrust.com","crl.sectigo.com","crl.thawte.com","crl.usertrust.com","crl.verisign.com","crl3.digicert.com","crl4.digicert.com","crls.ssl.com","docs.github.com","github-cloud.githubusercontent.com","github-cloud.s3.amazonaws.com","github.blog","github.com","github.githubassets.com","host.docker.internal","json-schema.org","json.schemastore.org","keyserver.ubuntu.com","lfs.github.com","objects.githubusercontent.com","ocsp.digicert.com","ocsp.geotrust.com","ocsp.globalsign.com","ocsp.identrust.com","ocsp.sectigo.com","ocsp.ssl.com","ocsp.thawte.com","ocsp.usertrust.com","ocsp.verisign.com","packagecloud.io","packages.cloud.google.com","packages.microsoft.com","ppa.launchpad.net","raw.githubusercontent.com","registry.npmjs.org","s.symcb.com","s.symcd.com","security.ubuntu.com","telemetry.enterprise.githubcopilot.com","ts-crl.ws.symantec.com","ts-ocsp.ws.symantec.com","www.googleapis.com"]},"apiProxy":{"enabled":true,"enableTokenSteering":true,"maxRuns":500,"maxEffectiveTokens":25000000,"models":{"auto":["large"],"coding":["copilot/gpt-5*codex*","openai/gpt-5*codex*","gpt-5-codex"],"deep-research":["copilot/deep-research*","copilot/o3-deep-research*","copilot/o4-mini-deep-research*","google/deep-research*","gemini/deep-research*","openai/o3-deep-research*","openai/o4-mini-deep-research*"],"gemini-flash":["copilot/gemini-*flash*","google/gemini-*flash*","gemini/gemini-*flash*"],"gemini-flash-lite":["copilot/gemini-*flash*lite*","google/gemini-*flash*lite*","gemini/gemini-*flash*lite*"],"gemini-pro":["copilot/gemini-*pro*","google/gemini-*pro*","gemini/gemini-*pro*"],"gemma":["copilot/gemma*","google/gemma*","gemini/gemma*"],"gpt-4.1":["copilot/gpt-4.1*","openai/gpt-4.1*"],"gpt-5":["copilot/gpt-5*","openai/gpt-5*"],"gpt-5-codex":["copilot/gpt-5*codex*","openai/gpt-5*codex*"],"gpt-5-mini":["copilot/gpt-5*mini*","openai/gpt-5*mini*"],"gpt-5-nano":["copilot/gpt-5*nano*","openai/gpt-5*nano*"],"gpt-5-pro":["copilot/gpt-5*pro*","openai/gpt-5*pro*"],"haiku":["copilot/*haiku*","anthropic/*haiku*"],"large":["sonnet","gpt-5-pro","gpt-5","gemini-pro"],"mini":["haiku","gpt-5-mini","gpt-5-nano","gemini-flash-lite"],"opus":["copilot/*opus*","anthropic/*opus*"],"reasoning":["copilot/o1*","copilot/o3*","copilot/o4*","openai/o1*","openai/o3*","openai/o4*"],"small":["mini"],"sonnet":["copilot/*sonnet*","anthropic/*sonnet*"],"vision":["copilot/gemini-*image*","gemini/gemini-*image*","copilot/gemini-*flash*","gemini/gemini-*flash*"]}},"container":{"imageTag":"0.25.46"}}' > "${RUNNER_TEMP}/gh-aw/awf-config.json" && cp "${RUNNER_TEMP}/gh-aw/awf-config.json" /tmp/gh-aw/awf-config.json + GH_AW_DOCKER_HOST_PATH_PREFIX_ARGS="" + if [[ "${DOCKER_HOST:-}" =~ ^tcp:// ]]; then + GH_AW_DOCKER_HOST_PATH_PREFIX_ARGS="--docker-host-path-prefix /tmp/gh-aw" + fi # shellcheck disable=SC1003 - sudo -E awf --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" --env-all --exclude-env COPILOT_GITHUB_TOKEN --exclude-env GITHUB_MCP_SERVER_TOKEN --exclude-env MCP_GATEWAY_API_KEY --allow-domains '*.githubusercontent.com,api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,api.snapcraft.io,archive.ubuntu.com,azure.archive.ubuntu.com,codeload.github.com,crl.geotrust.com,crl.globalsign.com,crl.identrust.com,crl.sectigo.com,crl.thawte.com,crl.usertrust.com,crl.verisign.com,crl3.digicert.com,crl4.digicert.com,crls.ssl.com,docs.github.com,github-cloud.githubusercontent.com,github-cloud.s3.amazonaws.com,github.blog,github.com,github.githubassets.com,host.docker.internal,json-schema.org,json.schemastore.org,keyserver.ubuntu.com,lfs.github.com,objects.githubusercontent.com,ocsp.digicert.com,ocsp.geotrust.com,ocsp.globalsign.com,ocsp.identrust.com,ocsp.sectigo.com,ocsp.ssl.com,ocsp.thawte.com,ocsp.usertrust.com,ocsp.verisign.com,packagecloud.io,packages.cloud.google.com,packages.microsoft.com,ppa.launchpad.net,raw.githubusercontent.com,registry.npmjs.org,s.symcb.com,s.symcd.com,security.ubuntu.com,telemetry.enterprise.githubcopilot.com,ts-crl.ws.symantec.com,ts-ocsp.ws.symantec.com,www.googleapis.com' --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --image-tag 0.25.20 --skip-pull --enable-api-proxy \ - -- /bin/bash -c 'node ${RUNNER_TEMP}/gh-aw/actions/copilot_driver.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --allow-all-paths --add-dir "${GITHUB_WORKSPACE}" --prompt "$(cat /tmp/gh-aw/aw-prompts/prompt.txt)"' 2>&1 | tee -a /tmp/gh-aw/agent-stdio.log + sudo -E awf --config "${RUNNER_TEMP}/gh-aw/awf-config.json" --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" ${GH_AW_DOCKER_HOST_PATH_PREFIX_ARGS} --env-all --exclude-env COPILOT_GITHUB_TOKEN --exclude-env GITHUB_MCP_SERVER_TOKEN --exclude-env MCP_GATEWAY_API_KEY --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --allow-host-ports 80,443,8080 --skip-pull \ + -- /bin/bash -c 'export PATH="${RUNNER_TEMP}/gh-aw/mcp-cli/bin:$PATH" && export PATH="$(find /opt/hostedtoolcache /home/runner/work/_tool -maxdepth 5 -type d -name bin 2>/dev/null | tr '\''\n'\'' '\'':'\'')$PATH"; [ -n "$GOROOT" ] && export PATH="$GOROOT/bin:$PATH" || true && GH_AW_NODE_EXEC="${GH_AW_NODE_BIN:-}"; if [ -z "$GH_AW_NODE_EXEC" ] || [ ! -x "$GH_AW_NODE_EXEC" ]; then GH_AW_NODE_EXEC="$(command -v node 2>/dev/null || true)"; fi; if [ -z "$GH_AW_NODE_EXEC" ]; then echo "node runtime missing on this runner β€” check runtimes.node in workflow YAML" >&2; exit 127; fi; "$GH_AW_NODE_EXEC" ${RUNNER_TEMP}/gh-aw/actions/copilot_harness.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --allow-all-paths --add-dir "${GITHUB_WORKSPACE}" --prompt-file /tmp/gh-aw/aw-prompts/prompt.txt' 2>&1 | tee -a /tmp/gh-aw/agent-stdio.log env: + AWF_REFLECT_ENABLED: 1 COPILOT_AGENT_RUNNER_TYPE: STANDALONE + COPILOT_API_KEY: dummy-byok-key-for-offline-mode COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} - COPILOT_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || '' }} + COPILOT_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || 'claude-sonnet-4.6' }} GH_AW_MCP_CONFIG: /home/runner/.copilot/mcp-config.json GH_AW_PHASE: agent GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} - GH_AW_VERSION: v0.68.3 + GH_AW_VERSION: v0.74.4 GITHUB_API_URL: ${{ github.api_url }} GITHUB_AW: true + GITHUB_COPILOT_INTEGRATION_ID: agentic-workflows GITHUB_HEAD_REF: ${{ github.head_ref }} GITHUB_MCP_SERVER_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} GITHUB_REF_NAME: ${{ github.ref_name }} @@ -762,7 +877,7 @@ jobs: bash "${RUNNER_TEMP}/gh-aw/actions/stop_mcp_gateway.sh" "$GATEWAY_PID" - name: Redact secrets in logs if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -788,7 +903,7 @@ jobs: - name: Ingest agent output id: collect_output if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} GH_AW_ALLOWED_DOMAINS: "*.githubusercontent.com,api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,api.snapcraft.io,archive.ubuntu.com,azure.archive.ubuntu.com,codeload.github.com,crl.geotrust.com,crl.globalsign.com,crl.identrust.com,crl.sectigo.com,crl.thawte.com,crl.usertrust.com,crl.verisign.com,crl3.digicert.com,crl4.digicert.com,crls.ssl.com,docs.github.com,github-cloud.githubusercontent.com,github-cloud.s3.amazonaws.com,github.blog,github.com,github.githubassets.com,host.docker.internal,json-schema.org,json.schemastore.org,keyserver.ubuntu.com,lfs.github.com,objects.githubusercontent.com,ocsp.digicert.com,ocsp.geotrust.com,ocsp.globalsign.com,ocsp.identrust.com,ocsp.sectigo.com,ocsp.ssl.com,ocsp.thawte.com,ocsp.usertrust.com,ocsp.verisign.com,packagecloud.io,packages.cloud.google.com,packages.microsoft.com,ppa.launchpad.net,raw.githubusercontent.com,registry.npmjs.org,s.symcb.com,s.symcd.com,security.ubuntu.com,telemetry.enterprise.githubcopilot.com,ts-crl.ws.symantec.com,ts-ocsp.ws.symantec.com,www.googleapis.com" @@ -802,7 +917,7 @@ jobs: await main(); - name: Parse agent logs for step summary if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: /tmp/gh-aw/sandbox/agent/logs/ with: @@ -814,7 +929,7 @@ jobs: - name: Parse MCP Gateway logs for step summary if: always() id: parse-mcp-gateway - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); @@ -827,9 +942,9 @@ jobs: env: AWF_LOGS_DIR: /tmp/gh-aw/sandbox/firewall/logs run: | - # Fix permissions on firewall logs so they can be uploaded as artifacts + # Fix permissions on firewall logs/audit dirs so they can be uploaded as artifacts # AWF runs with sudo, creating files owned by root - sudo chmod -R a+r /tmp/gh-aw/sandbox/firewall/logs 2>/dev/null || true + sudo chmod -R a+rX /tmp/gh-aw/sandbox/firewall 2>/dev/null || true # Only run awf logs summary if awf command exists (it may not be installed if workflow failed before install step) if command -v awf &> /dev/null; then awf logs summary | tee -a "$GITHUB_STEP_SUMMARY" @@ -839,13 +954,23 @@ jobs: - name: Parse token usage for step summary if: always() continue-on-error: true - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 with: script: | const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); setupGlobals(core, github, context, exec, io, getOctokit); const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_token_usage.cjs'); await main(); + - name: Print AWF reflect summary + if: always() + continue-on-error: true + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/awf_reflect_summary.cjs'); + await main(); - name: Write agent output placeholder if missing if: always() run: | @@ -865,14 +990,17 @@ jobs: /tmp/gh-aw/mcp-logs/ /tmp/gh-aw/agent_usage.json /tmp/gh-aw/agent-stdio.log + /tmp/gh-aw/pre-agent-audit.txt /tmp/gh-aw/agent/ /tmp/gh-aw/github_rate_limits.jsonl /tmp/gh-aw/safeoutputs.jsonl /tmp/gh-aw/agent_output.json /tmp/gh-aw/aw-*.patch /tmp/gh-aw/aw-*.bundle + /tmp/gh-aw/awf-config.json /tmp/gh-aw/sandbox/firewall/logs/ /tmp/gh-aw/sandbox/firewall/audit/ + /tmp/gh-aw/sandbox/firewall/awf-reflect.json if-no-files-found: ignore conclusion: @@ -891,8 +1019,9 @@ jobs: issues: write pull-requests: write concurrency: - group: "gh-aw-conclusion-weekly-reference-impl-sync" + group: "gh-aw-conclusion-reference-impl-sync" cancel-in-progress: false + queue: max outputs: incomplete_count: ${{ steps.report_incomplete.outputs.incomplete_count }} noop_message: ${{ steps.noop.outputs.noop_message }} @@ -901,11 +1030,17 @@ jobs: steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@d3abfe96a194bce3a523ed2093ddedd5704cdf62 # v0.74.4 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} trace-id: ${{ needs.activation.outputs.setup-trace-id }} + parent-span-id: ${{ needs.activation.outputs.setup-parent-span-id || needs.activation.outputs.setup-span-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Reference Implementation Sync" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/reference-impl-sync.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.48" + GH_AW_INFO_ENGINE_ID: "copilot" - name: Download agent output artifact id: download-agent-output continue-on-error: true @@ -922,11 +1057,11 @@ jobs: echo "GH_AW_AGENT_OUTPUT=/tmp/gh-aw/agent_output.json" >> "$GITHUB_OUTPUT" - name: Process no-op messages id: noop - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_NOOP_MAX: "1" - GH_AW_WORKFLOW_NAME: "Weekly Reference Implementation Sync" + GH_AW_WORKFLOW_NAME: "Reference Implementation Sync" GH_AW_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} GH_AW_AGENT_CONCLUSION: ${{ needs.agent.result }} GH_AW_NOOP_REPORT_AS_ISSUE: "false" @@ -939,10 +1074,10 @@ jobs: await main(); - name: Log detection run id: detection_runs - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} - GH_AW_WORKFLOW_NAME: "Weekly Reference Implementation Sync" + GH_AW_WORKFLOW_NAME: "Reference Implementation Sync" GH_AW_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} GH_AW_DETECTION_CONCLUSION: ${{ needs.detection.outputs.detection_conclusion }} GH_AW_DETECTION_REASON: ${{ needs.detection.outputs.detection_reason }} @@ -955,11 +1090,11 @@ jobs: await main(); - name: Record missing tool id: missing_tool - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_MISSING_TOOL_CREATE_ISSUE: "true" - GH_AW_WORKFLOW_NAME: "Weekly Reference Implementation Sync" + GH_AW_WORKFLOW_NAME: "Reference Implementation Sync" with: github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} script: | @@ -969,11 +1104,11 @@ jobs: await main(); - name: Record incomplete id: report_incomplete - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_REPORT_INCOMPLETE_CREATE_ISSUE: "true" - GH_AW_WORKFLOW_NAME: "Weekly Reference Implementation Sync" + GH_AW_WORKFLOW_NAME: "Reference Implementation Sync" with: github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} script: | @@ -984,27 +1119,34 @@ jobs: - name: Handle agent failure id: handle_agent_failure if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} - GH_AW_WORKFLOW_NAME: "Weekly Reference Implementation Sync" + GH_AW_WORKFLOW_NAME: "Reference Implementation Sync" GH_AW_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} GH_AW_AGENT_CONCLUSION: ${{ needs.agent.result }} - GH_AW_WORKFLOW_ID: "weekly-reference-impl-sync" + GH_AW_WORKFLOW_ID: "reference-impl-sync" + GH_AW_ACTION_FAILURE_ISSUE_EXPIRES_HOURS: "168" GH_AW_ENGINE_ID: "copilot" GH_AW_SECRET_VERIFICATION_RESULT: ${{ needs.activation.outputs.secret_verification_result }} GH_AW_CHECKOUT_PR_SUCCESS: ${{ needs.agent.outputs.checkout_pr_success }} + GH_AW_EFFECTIVE_TOKENS: ${{ needs.agent.outputs.effective_tokens || '' }} + GH_AW_EFFECTIVE_TOKENS_RATE_LIMIT_ERROR: ${{ needs.agent.outputs.effective_tokens_rate_limit_error || 'false' }} GH_AW_INFERENCE_ACCESS_ERROR: ${{ needs.agent.outputs.inference_access_error }} GH_AW_MCP_POLICY_ERROR: ${{ needs.agent.outputs.mcp_policy_error }} GH_AW_AGENTIC_ENGINE_TIMEOUT: ${{ needs.agent.outputs.agentic_engine_timeout }} GH_AW_MODEL_NOT_SUPPORTED_ERROR: ${{ needs.agent.outputs.model_not_supported_error }} + GH_AW_ENGINE_API_HOSTS: "api.enterprise.githubcopilot.com,api.githubcopilot.com,api.business.githubcopilot.com,api.individual.githubcopilot.com" GH_AW_ASSIGNMENT_ERRORS: ${{ needs.safe_outputs.outputs.assign_to_agent_assignment_errors }} GH_AW_ASSIGNMENT_ERROR_COUNT: ${{ needs.safe_outputs.outputs.assign_to_agent_assignment_error_count }} GH_AW_LOCKDOWN_CHECK_FAILED: ${{ needs.activation.outputs.lockdown_check_failed }} GH_AW_STALE_LOCK_FILE_FAILED: ${{ needs.activation.outputs.stale_lock_file_failed }} GH_AW_GROUP_REPORTS: "false" GH_AW_FAILURE_REPORT_AS_ISSUE: "true" + GH_AW_MISSING_TOOL_REPORT_AS_FAILURE: "true" + GH_AW_MISSING_DATA_REPORT_AS_FAILURE: "true" GH_AW_TIMEOUT_MINUTES: "20" + GH_AW_MAX_EFFECTIVE_TOKENS: "25000000" with: github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} script: | @@ -1029,11 +1171,17 @@ jobs: steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@d3abfe96a194bce3a523ed2093ddedd5704cdf62 # v0.74.4 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} trace-id: ${{ needs.activation.outputs.setup-trace-id }} + parent-span-id: ${{ needs.activation.outputs.setup-parent-span-id || needs.activation.outputs.setup-span-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Reference Implementation Sync" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/reference-impl-sync.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.48" + GH_AW_INFO_ENGINE_ID: "copilot" - name: Download agent output artifact id: download-agent-output continue-on-error: true @@ -1059,7 +1207,7 @@ jobs: rm -rf /tmp/gh-aw/sandbox/firewall/logs rm -rf /tmp/gh-aw/sandbox/firewall/audit - name: Download container images - run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.20 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20 ghcr.io/github/gh-aw-firewall/squid:0.25.20 + run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.46 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.46 ghcr.io/github/gh-aw-firewall/squid:0.25.46 - name: Check if detection needed id: detection_guard if: always() @@ -1074,10 +1222,10 @@ jobs: echo "run_detection=false" >> "$GITHUB_OUTPUT" echo "Detection skipped: no agent outputs or patches to analyze" fi - - name: Clear MCP configuration for detection + - name: Clear MCP Config for detection if: always() && steps.detection_guard.outputs.run_detection == 'true' run: | - rm -f /tmp/gh-aw/mcp-config/mcp-servers.json + rm -f "${RUNNER_TEMP}/gh-aw/mcp-config/mcp-servers.json" rm -f /home/runner/.copilot/mcp-config.json rm -f "$GITHUB_WORKSPACE/.gemini/settings.json" - name: Prepare threat detection files @@ -1096,10 +1244,10 @@ jobs: ls -la /tmp/gh-aw/threat-detection/ 2>/dev/null || true - name: Setup threat detection if: always() && steps.detection_guard.outputs.run_detection == 'true' - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: - WORKFLOW_NAME: "Weekly Reference Implementation Sync" - WORKFLOW_DESCRIPTION: "Weekly reference implementation sync workflow. Checks for new commits in the official\nCopilot SDK (github/copilot-sdk) and assigns to Copilot to port changes." + WORKFLOW_NAME: "Reference Implementation Sync" + WORKFLOW_DESCRIPTION: "Reference implementation sync workflow. Checks for new commits in the official\nCopilot SDK (github/copilot-sdk) and assigns to Copilot to port changes." HAS_PATCH: ${{ needs.agent.outputs.has_patch }} with: script: | @@ -1112,33 +1260,50 @@ jobs: run: | mkdir -p /tmp/gh-aw/threat-detection touch /tmp/gh-aw/threat-detection/detection.log + - name: Setup Node.js + uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0 + with: + node-version: '24' + package-manager-cache: false - name: Install GitHub Copilot CLI - run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.21 + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.48 env: GH_HOST: github.com - name: Install AWF binary - run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.20 + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.46 - name: Execute GitHub Copilot CLI if: always() && steps.detection_guard.outputs.run_detection == 'true' + continue-on-error: true id: detection_agentic_execution # Copilot CLI tool arguments (sorted): timeout-minutes: 20 run: | set -o pipefail + printf '%s' "$(date +%s%3N)" > /tmp/gh-aw/agent_cli_start_ms.txt touch /tmp/gh-aw/agent-step-summary.md + GH_AW_NODE_BIN=$(command -v node 2>/dev/null || true) + export GH_AW_NODE_BIN (umask 177 && touch /tmp/gh-aw/threat-detection/detection.log) + printf '%s\n' '{"$schema":"https://github.com/github/gh-aw-firewall/releases/download/v0.25.46/awf-config.schema.json","network":{"allowDomains":["api.business.githubcopilot.com","api.enterprise.githubcopilot.com","api.github.com","api.githubcopilot.com","api.individual.githubcopilot.com","github.com","host.docker.internal","telemetry.enterprise.githubcopilot.com"]},"apiProxy":{"enabled":true,"enableTokenSteering":true,"maxRuns":500,"maxEffectiveTokens":25000000},"container":{"imageTag":"0.25.46"}}' > "${RUNNER_TEMP}/gh-aw/awf-config.json" && cp "${RUNNER_TEMP}/gh-aw/awf-config.json" /tmp/gh-aw/awf-config.json + GH_AW_DOCKER_HOST_PATH_PREFIX_ARGS="" + if [[ "${DOCKER_HOST:-}" =~ ^tcp:// ]]; then + GH_AW_DOCKER_HOST_PATH_PREFIX_ARGS="--docker-host-path-prefix /tmp/gh-aw" + fi # shellcheck disable=SC1003 - sudo -E awf --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" --env-all --exclude-env COPILOT_GITHUB_TOKEN --allow-domains api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,github.com,host.docker.internal,telemetry.enterprise.githubcopilot.com --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --image-tag 0.25.20 --skip-pull --enable-api-proxy \ - -- /bin/bash -c 'node ${RUNNER_TEMP}/gh-aw/actions/copilot_driver.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --add-dir "${GITHUB_WORKSPACE}" --prompt "$(cat /tmp/gh-aw/aw-prompts/prompt.txt)"' 2>&1 | tee -a /tmp/gh-aw/threat-detection/detection.log + sudo -E awf --config "${RUNNER_TEMP}/gh-aw/awf-config.json" --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" ${GH_AW_DOCKER_HOST_PATH_PREFIX_ARGS} --env-all --exclude-env COPILOT_GITHUB_TOKEN --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --allow-host-ports 80,443,8080 --skip-pull \ + -- /bin/bash -c 'export PATH="$(find /opt/hostedtoolcache /home/runner/work/_tool -maxdepth 5 -type d -name bin 2>/dev/null | tr '\''\n'\'' '\'':'\'')$PATH"; [ -n "$GOROOT" ] && export PATH="$GOROOT/bin:$PATH" || true && GH_AW_NODE_EXEC="${GH_AW_NODE_BIN:-}"; if [ -z "$GH_AW_NODE_EXEC" ] || [ ! -x "$GH_AW_NODE_EXEC" ]; then GH_AW_NODE_EXEC="$(command -v node 2>/dev/null || true)"; fi; if [ -z "$GH_AW_NODE_EXEC" ]; then echo "node runtime missing on this runner β€” check runtimes.node in workflow YAML" >&2; exit 127; fi; "$GH_AW_NODE_EXEC" ${RUNNER_TEMP}/gh-aw/actions/copilot_harness.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --add-dir "${GITHUB_WORKSPACE}" --prompt-file /tmp/gh-aw/aw-prompts/prompt.txt' 2>&1 | tee -a /tmp/gh-aw/threat-detection/detection.log env: + AWF_REFLECT_ENABLED: 1 COPILOT_AGENT_RUNNER_TYPE: STANDALONE + COPILOT_API_KEY: dummy-byok-key-for-offline-mode COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} - COPILOT_MODEL: ${{ vars.GH_AW_MODEL_DETECTION_COPILOT || '' }} + COPILOT_MODEL: ${{ vars.GH_AW_MODEL_DETECTION_COPILOT || 'claude-sonnet-4.6' }} GH_AW_PHASE: detection GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt - GH_AW_VERSION: v0.68.3 + GH_AW_VERSION: v0.74.4 GITHUB_API_URL: ${{ github.api_url }} GITHUB_AW: true + GITHUB_COPILOT_INTEGRATION_ID: agentic-workflows GITHUB_HEAD_REF: ${{ github.head_ref }} GITHUB_REF_NAME: ${{ github.ref_name }} GITHUB_SERVER_URL: ${{ github.server_url }} @@ -1159,16 +1324,35 @@ jobs: - name: Parse and conclude threat detection id: detection_conclusion if: always() - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + continue-on-error: true + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: RUN_DETECTION: ${{ steps.detection_guard.outputs.run_detection }} + DETECTION_AGENTIC_EXECUTION_OUTCOME: ${{ steps.detection_agentic_execution.outcome }} GH_AW_DETECTION_CONTINUE_ON_ERROR: "true" with: script: | - const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); - setupGlobals(core, github, context, exec, io, getOctokit); - const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs'); - await main(); + try { + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs'); + await main(); + } catch (loadErr) { + const continueOnError = process.env.GH_AW_DETECTION_CONTINUE_ON_ERROR !== 'false'; + const detectionExecutionFailed = process.env.DETECTION_AGENTIC_EXECUTION_OUTCOME === 'failure'; + const msg = 'ERR_SYSTEM: \u274C Unexpected error loading threat detection module: ' + (loadErr && loadErr.message ? loadErr.message : String(loadErr)); + core.error(msg); + core.setOutput('reason', 'parse_error'); + if (continueOnError && !detectionExecutionFailed) { + core.warning('\u26A0\uFE0F ' + msg); + core.setOutput('conclusion', 'warning'); + core.setOutput('success', 'false'); + } else { + core.setOutput('conclusion', 'failure'); + core.setOutput('success', 'false'); + core.setFailed(msg); + } + } safe_outputs: needs: @@ -1184,14 +1368,15 @@ jobs: pull-requests: write timeout-minutes: 15 env: - GH_AW_CALLER_WORKFLOW_ID: "${{ github.repository }}/weekly-reference-impl-sync" + GH_AW_CALLER_WORKFLOW_ID: "${{ github.repository }}/reference-impl-sync" GH_AW_DETECTION_CONCLUSION: ${{ needs.detection.outputs.detection_conclusion }} GH_AW_DETECTION_REASON: ${{ needs.detection.outputs.detection_reason }} GH_AW_EFFECTIVE_TOKENS: ${{ needs.agent.outputs.effective_tokens }} GH_AW_ENGINE_ID: "copilot" GH_AW_ENGINE_MODEL: ${{ needs.agent.outputs.model }} - GH_AW_WORKFLOW_ID: "weekly-reference-impl-sync" - GH_AW_WORKFLOW_NAME: "Weekly Reference Implementation Sync" + GH_AW_ENGINE_VERSION: "1.0.48" + GH_AW_WORKFLOW_ID: "reference-impl-sync" + GH_AW_WORKFLOW_NAME: "Reference Implementation Sync" outputs: assign_to_agent_assigned: ${{ steps.process_safe_outputs.outputs.assign_to_agent_assigned }} assign_to_agent_assignment_error_count: ${{ steps.process_safe_outputs.outputs.assign_to_agent_assignment_error_count }} @@ -1209,11 +1394,17 @@ jobs: steps: - name: Setup Scripts id: setup - uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3 + uses: github/gh-aw-actions/setup@d3abfe96a194bce3a523ed2093ddedd5704cdf62 # v0.74.4 with: destination: ${{ runner.temp }}/gh-aw/actions job-name: ${{ github.job }} trace-id: ${{ needs.activation.outputs.setup-trace-id }} + parent-span-id: ${{ needs.activation.outputs.setup-parent-span-id || needs.activation.outputs.setup-span-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Reference Implementation Sync" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/reference-impl-sync.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.48" + GH_AW_INFO_ENGINE_ID: "copilot" - name: Download agent output artifact id: download-agent-output continue-on-error: true @@ -1239,13 +1430,13 @@ jobs: echo "GH_HOST=${GH_HOST}" >> "$GITHUB_ENV" - name: Process Safe Outputs id: process_safe_outputs - uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9 + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} GH_AW_ALLOWED_DOMAINS: "*.githubusercontent.com,api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,api.snapcraft.io,archive.ubuntu.com,azure.archive.ubuntu.com,codeload.github.com,crl.geotrust.com,crl.globalsign.com,crl.identrust.com,crl.sectigo.com,crl.thawte.com,crl.usertrust.com,crl.verisign.com,crl3.digicert.com,crl4.digicert.com,crls.ssl.com,docs.github.com,github-cloud.githubusercontent.com,github-cloud.s3.amazonaws.com,github.blog,github.com,github.githubassets.com,host.docker.internal,json-schema.org,json.schemastore.org,keyserver.ubuntu.com,lfs.github.com,objects.githubusercontent.com,ocsp.digicert.com,ocsp.geotrust.com,ocsp.globalsign.com,ocsp.identrust.com,ocsp.sectigo.com,ocsp.ssl.com,ocsp.thawte.com,ocsp.usertrust.com,ocsp.verisign.com,packagecloud.io,packages.cloud.google.com,packages.microsoft.com,ppa.launchpad.net,raw.githubusercontent.com,registry.npmjs.org,s.symcb.com,s.symcd.com,security.ubuntu.com,telemetry.enterprise.githubcopilot.com,ts-crl.ws.symantec.com,ts-ocsp.ws.symantec.com,www.googleapis.com" GITHUB_SERVER_URL: ${{ github.server_url }} GITHUB_API_URL: ${{ github.api_url }} - GH_AW_SAFE_OUTPUTS_HANDLER_CONFIG: "{\"add_comment\":{\"max\":10,\"target\":\"*\"},\"assign_to_agent\":{\"max\":1,\"model\":\"claude-opus-4.6\",\"name\":\"copilot\",\"target\":\"*\"},\"close_issue\":{\"max\":10,\"required_labels\":[\"reference-impl-sync\"],\"target\":\"*\"},\"create_issue\":{\"assignees\":[\"copilot-swe-agent\"],\"expires\":144,\"labels\":[\"reference-impl-sync\"],\"max\":1,\"title_prefix\":\"[reference-impl-sync] \"},\"create_report_incomplete_issue\":{},\"missing_data\":{},\"missing_tool\":{},\"noop\":{\"max\":1,\"report-as-issue\":\"false\"},\"report_incomplete\":{}}" + GH_AW_SAFE_OUTPUTS_HANDLER_CONFIG: "{\"add_comment\":{\"max\":10,\"target\":\"*\"},\"assign_to_agent\":{\"max\":1,\"model\":\"claude-opus-4.6\",\"name\":\"copilot\",\"target\":\"*\"},\"close_issue\":{\"max\":10,\"required_labels\":[\"reference-impl-sync\"],\"target\":\"*\"},\"close_pull_request\":{\"max\":10,\"target\":\"*\"},\"create_issue\":{\"expires\":144,\"labels\":[\"reference-impl-sync\"],\"max\":1,\"title_prefix\":\"[reference-impl-sync] \"},\"create_report_incomplete_issue\":{},\"missing_data\":{},\"missing_tool\":{},\"noop\":{\"max\":1,\"report-as-issue\":\"false\"},\"report_incomplete\":{}}" GH_AW_ASSIGN_TO_AGENT_TOKEN: ${{ secrets.GH_AW_AGENT_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} with: github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} diff --git a/.github/workflows/weekly-reference-impl-sync.md b/.github/workflows/reference-impl-sync.md similarity index 70% rename from .github/workflows/weekly-reference-impl-sync.md rename to .github/workflows/reference-impl-sync.md index 1d1f9a4fd5..297ef6dbdf 100644 --- a/.github/workflows/weekly-reference-impl-sync.md +++ b/.github/workflows/reference-impl-sync.md @@ -1,16 +1,17 @@ --- description: | - Weekly reference implementation sync workflow. Checks for new commits in the official + Reference implementation sync workflow. Checks for new commits in the official Copilot SDK (github/copilot-sdk) and assigns to Copilot to port changes. on: - schedule: weekly + schedule: weekly on friday workflow_dispatch: permissions: contents: read actions: read issues: read + pull-requests: read network: allowed: @@ -19,12 +20,11 @@ network: tools: github: - toolsets: [context, repos, issues] + toolsets: [context, repos, issues, pull_requests] safe-outputs: create-issue: title-prefix: "[reference-impl-sync] " - assignees: [copilot-swe-agent] labels: [reference-impl-sync] expires: 6 close-issue: @@ -38,10 +38,13 @@ safe-outputs: name: "copilot" model: "claude-opus-4.6" target: "*" + close-pull-request: + target: "*" + max: 10 noop: report-as-issue: false --- -# Weekly Reference Implementation Sync +# Reference Implementation Sync You are an automation agent that detects new reference implementation changes and creates GitHub issues. You do **NOT** perform any code merges, edits, or pushes. Do **NOT** invoke any skills (especially `agentic-merge-reference-impl`). Your only job is to check for changes and use safe-output tools to create or close issues. @@ -79,14 +82,16 @@ Go to Step 3b. 1. Search for any open issues with the `reference-impl-sync` label using the GitHub MCP tools. 2. If there are open `reference-impl-sync` labeled issues, close each one using the `close_issue` safe-output tool with a comment: "No new reference implementation changes detected. The Java SDK is up to date. Closing." -3. Call the `noop` safe-output tool with message: "No new reference implementation changes since last merge ()." -4. **Stop here.** Do not proceed further. +3. Search for any open pull requests whose head branch starts with `copilot/reference-impl`. Close each one using the `close_pull_request` safe-output tool with a comment: "Superseded β€” the Java SDK is up to date with the reference implementation. Closing stale sync PR." +4. Call the `noop` safe-output tool with message: "No new reference implementation changes since last merge ()." +5. **Stop here.** Do not proceed further. ### Step 3b: Changes detected 1. Search for any open issues with the `reference-impl-sync` label using the GitHub MCP tools. 2. Close each existing open `reference-impl-sync` issue using the `close_issue` safe-output tool with a comment: "Superseded by a newer reference implementation sync check." -3. Create a new issue using the `create_issue` safe-output tool with: +3. Search for any open pull requests whose head branch starts with `copilot/reference-impl`. Close each one using the `close_pull_request` safe-output tool with a comment: "Superseded by a newer reference implementation sync issue. Closing stale sync PR." +4. Create a new issue using the `create_issue` safe-output tool with: - **Title:** `Reference Implementation sync: new commits ()` - **Body:** Include the following information: ``` @@ -105,9 +110,15 @@ Go to Step 3b. ### Instructions - Follow the [agentic-merge-reference-impl](.github/prompts/agentic-merge-reference-impl.prompt.md) prompt to port these changes to the Java SDK. + **You MUST follow these steps in order. Do NOT improvise or skip scripts.** + + 1. βœ…βœ…Read [.github/prompts/agentic-merge-reference-impl.prompt.md](.github/prompts/agentic-merge-reference-impl.prompt.md) in full before startingβœ…βœ… + + ❌❌Do NOT clone the reference implementation manually β€” the start script does this.❌❌ + ❌❌Do NOT update .lastmerge manually β€” the finish script does this.❌❌ + ❌❌Do NOT skip the finish script β€” it syncs codegen versions and updates .lastmerge.❌❌ ``` -4. After creating the issue, use the `assign_to_agent` safe-output tool to assign Copilot to the newly created issue. +5. After creating the issue, use the `assign_to_agent` safe-output tool to assign Copilot to the newly created issue. ## Important constraints diff --git a/.github/workflows/update-copilot-dependency.yml b/.github/workflows/update-copilot-dependency.yml index f7faee073a..e6d76c2125 100644 --- a/.github/workflows/update-copilot-dependency.yml +++ b/.github/workflows/update-copilot-dependency.yml @@ -61,7 +61,7 @@ jobs: cat > /tmp/verify-codegen-prompt.txt << 'PROMPT_EOF' You are running inside the copilot-sdk-java repository. The code generator has just run and produced Java source files under - src/generated/java/com/github/copilot/sdk/generated/rpc/. + src/generated/java/com/github/copilot/generated/rpc/. Your task is to spot-check the generated API classes against the source JSON schema to verify the generator produced correct output. @@ -74,9 +74,9 @@ jobs: scripts/codegen/node_modules/@github/copilot/schemas/api.schema.json 2. Pick these 3 generated API classes to verify: - - src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsApi.java - - src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiApi.java - - src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsApi.java + - src/generated/java/com/github/copilot/generated/rpc/SessionToolsApi.java + - src/generated/java/com/github/copilot/generated/rpc/SessionUiApi.java + - src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsApi.java 3. For each class, verify: - Every RPC method in the schema's corresponding namespace has a @@ -147,6 +147,7 @@ jobs: if gh pr view "$BRANCH" >/dev/null 2>&1; then echo "Pull request for branch '$BRANCH' already exists; updated branch only." PR_NUMBER=$(gh pr view "$BRANCH" --json number --jq .number) + gh pr edit "$PR_NUMBER" --add-label dependencies else PR_NUMBER=$(gh pr create \ --title "Update @github/copilot to $VERSION" \ @@ -157,6 +158,7 @@ jobs: - Re-ran Java code generator (\`scripts/codegen\`) > Created by the **Update @github/copilot Dependency** workflow." \ + --label dependencies \ --base main \ --head "$BRANCH" \ | grep -oE '[0-9]+$' || gh pr view "$BRANCH" --json number --jq .number) diff --git a/.github/workflows/weekly-reference-impl-sync.yml b/.github/workflows/weekly-reference-impl-sync.yml deleted file mode 100644 index aa3fc971ac..0000000000 --- a/.github/workflows/weekly-reference-impl-sync.yml +++ /dev/null @@ -1,181 +0,0 @@ -name: "Weekly Reference Implementation Sync" - -on: - schedule: - # Every Monday at 10:00 UTC (5:00 AM EST / 6:00 AM EDT) - - cron: '0 10 * * 1' - workflow_dispatch: - -permissions: - contents: write - issues: write - pull-requests: write - -env: - # Used for `gh` CLI operations to create/close/comment issues. Must be a PAT with repo permissions because the default - GH_AW_AGENT_TOKEN: ${{ secrets.GH_AW_AGENT_TOKEN }} - GH_TOKEN: ${{ secrets.GH_AW_AGENT_TOKEN }} - -jobs: - - check-and-sync: - name: "Check reference implementation & trigger Copilot merge" - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 - - - name: Check for reference implementation changes - id: check - run: | - LAST_MERGE=$(cat .lastmerge) - echo "Last merged commit: $LAST_MERGE" - - git clone --quiet https://github.com/github/copilot-sdk.git /tmp/reference-impl - cd /tmp/reference-impl - - REFERENCE_IMPL_HEAD=$(git rev-parse HEAD) - echo "Reference implementation HEAD: $REFERENCE_IMPL_HEAD" - - echo "last_merge=$LAST_MERGE" >> "$GITHUB_OUTPUT" - - if [ "$LAST_MERGE" = "$REFERENCE_IMPL_HEAD" ]; then - echo "No new reference implementation changes since last merge." - echo "has_changes=false" >> "$GITHUB_OUTPUT" - else - COMMIT_COUNT=$(git rev-list --count "$LAST_MERGE".."$REFERENCE_IMPL_HEAD") - echo "Found $COMMIT_COUNT new reference implementation commits." - echo "has_changes=true" >> "$GITHUB_OUTPUT" - echo "commit_count=$COMMIT_COUNT" >> "$GITHUB_OUTPUT" - echo "reference_impl_head=$REFERENCE_IMPL_HEAD" >> "$GITHUB_OUTPUT" - - # Generate a short summary of changes - SUMMARY=$(git log --oneline "$LAST_MERGE".."$REFERENCE_IMPL_HEAD" | head -20) - { - echo "summary<> "$GITHUB_OUTPUT" - fi - - - name: Close previous reference-impl-sync issues - if: steps.check.outputs.has_changes == 'true' - run: | - # Find all open issues with the reference-impl-sync label - OPEN_ISSUES=$(gh issue list \ - --repo "${{ github.repository }}" \ - --label "reference-impl-sync" \ - --state open \ - --json number \ - --jq '.[].number') - - for ISSUE_NUM in $OPEN_ISSUES; do - echo "Closing superseded issue #${ISSUE_NUM}" - gh issue comment "$ISSUE_NUM" \ - --repo "${{ github.repository }}" \ - --body "Superseded by a newer reference implementation sync issue. Closing this one." - gh issue close "$ISSUE_NUM" \ - --repo "${{ github.repository }}" \ - --reason "not planned" - done - - - name: Close stale reference-impl-sync issues (no changes) - if: steps.check.outputs.has_changes == 'false' - run: | - OPEN_ISSUES=$(gh issue list \ - --repo "${{ github.repository }}" \ - --label "reference-impl-sync" \ - --state open \ - --json number \ - --jq '.[].number') - - for ISSUE_NUM in $OPEN_ISSUES; do - echo "Closing stale issue #${ISSUE_NUM} β€” reference implementation is up to date" - gh issue comment "$ISSUE_NUM" \ - --repo "${{ github.repository }}" \ - --body "No new reference implementation changes detected. The Java SDK is up to date. Closing." - gh issue close "$ISSUE_NUM" \ - --repo "${{ github.repository }}" \ - --reason "completed" - done - - - name: Create issue and assign to Copilot - id: create-issue - if: steps.check.outputs.has_changes == 'true' - env: - SUMMARY: ${{ steps.check.outputs.summary }} - run: | - COMMIT_COUNT="${{ steps.check.outputs.commit_count }}" - LAST_MERGE="${{ steps.check.outputs.last_merge }}" - REFERENCE_IMPL_HEAD="${{ steps.check.outputs.reference_impl_head }}" - DATE=$(date -u +"%Y-%m-%d") - REPO="${{ github.repository }}" - - BODY="## Automated Reference Implementation Sync - - There are **${COMMIT_COUNT}** new commits in the [official Copilot SDK](https://github.com/github/copilot-sdk) since the last merge. - - - **Last merged commit:** [\`${LAST_MERGE}\`](https://github.com/github/copilot-sdk/commit/${LAST_MERGE}) - - **Reference implementation HEAD:** [\`${REFERENCE_IMPL_HEAD}\`](https://github.com/github/copilot-sdk/commit/${REFERENCE_IMPL_HEAD}) - - ### Recent reference implementation commits - - \`\`\` - ${SUMMARY} - \`\`\` - - ### Instructions - - Follow the [agentic-merge-reference-impl](.github/prompts/agentic-merge-reference-impl.prompt.md) prompt to port these changes to the Java SDK." - - # Create the issue and assign to Copilot coding agent - ISSUE_URL=$(gh issue create \ - --repo "$REPO" \ - --title "Reference implementation sync: ${COMMIT_COUNT} new commits (${DATE})" \ - --body "$BODY" \ - --label "reference-impl-sync" \ - --assignee "copilot-swe-agent") - - echo "issue_url=$ISSUE_URL" >> "$GITHUB_OUTPUT" - echo "βœ… Issue created and assigned to Copilot coding agent: $ISSUE_URL" - - - name: Summary - if: always() - env: - SUMMARY: ${{ steps.check.outputs.summary }} - run: | - HAS_CHANGES="${{ steps.check.outputs.has_changes }}" - COMMIT_COUNT="${{ steps.check.outputs.commit_count }}" - LAST_MERGE="${{ steps.check.outputs.last_merge }}" - REFERENCE_IMPL_HEAD="${{ steps.check.outputs.reference_impl_head }}" - ISSUE_URL="${{ steps.create-issue.outputs.issue_url }}" - - { - echo "## Weekly Reference Implementation Sync" - echo "" - if [ "$HAS_CHANGES" = "true" ]; then - echo "### βœ… New reference implementation changes detected" - echo "" - echo "| | |" - echo "|---|---|" - echo "| **New commits** | ${COMMIT_COUNT} |" - echo "| **Last merged** | \`${LAST_MERGE:0:12}\` |" - echo "| **Reference implementation HEAD** | \`${REFERENCE_IMPL_HEAD:0:12}\` |" - echo "" - echo "An issue has been created and assigned to the Copilot coding agent: " - echo " -> ${ISSUE_URL}" - echo "" - echo "### Recent reference implementation commits" - echo "" - echo '```' - echo "$SUMMARY" - echo '```' - else - echo "### ⏭️ No changes" - echo "" - echo "The Java SDK is already up to date with the reference implementation Copilot SDK." - echo "" - echo "**Last merged commit:** \`${LAST_MERGE:0:12}\`" - fi - } >> "$GITHUB_STEP_SUMMARY" diff --git a/.gitignore b/.gitignore index 35ea546f09..654d3278f8 100644 --- a/.gitignore +++ b/.gitignore @@ -13,3 +13,4 @@ changebundle.txt* .settings scripts/codegen/node_modules/ *~ +*.sln diff --git a/.lastmerge b/.lastmerge index caffac28be..97be84d7ea 100644 --- a/.lastmerge +++ b/.lastmerge @@ -1 +1 @@ -dd2dcbc439256acfb9feb2cff07c0b9c820091b8 +60104052cd914949ddf8c7a31e1856cd6db0a57c diff --git a/CHANGELOG.md b/CHANGELOG.md index 0d198ee218..20d8d21470 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,8 +8,26 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). ## [Unreleased] -> **Reference implementation sync:** [`github/copilot-sdk@dd2dcbc`](https://github.com/github/copilot-sdk/commit/dd2dcbc439256acfb9feb2cff07c0b9c820091b8) +> **Reference implementation sync:** [`github/copilot-sdk@6010405`](https://github.com/github/copilot-sdk/commit/60104052cd914949ddf8c7a31e1856cd6db0a57c) + +## [1.0.0-beta-10-java.0] - 2026-05-28 + +> **Reference implementation sync:** [`github/copilot-sdk@6010405`](https://github.com/github/copilot-sdk/commit/60104052cd914949ddf8c7a31e1856cd6db0a57c) +## [1.0.0-beta-8-java.0] - 2026-05-28 + +> **Reference implementation sync:** [`github/copilot-sdk@6010405`](https://github.com/github/copilot-sdk/commit/60104052cd914949ddf8c7a31e1856cd6db0a57c) +## [1.0.0-beta-java.4] - 2026-05-16 + +> **Reference implementation sync:** [`github/copilot-sdk@e20f5be`](https://github.com/github/copilot-sdk/commit/e20f5bef125860accb30c60d1b35109371a77f16) +## [1.0.0-beta-java.3] - 2026-05-11 + +> **Reference implementation sync:** [`github/copilot-sdk@4a0437b`](https://github.com/github/copilot-sdk/commit/4a0437bb03a0b60a1867f14ae8e3faf053afa5aa) +## [1.0.0-beta-java.2] - 2026-05-08 + +> **Reference implementation sync:** [`github/copilot-sdk@066a69c`](https://github.com/github/copilot-sdk/commit/066a69c1e849adf1bd98564ab1b52316ec471182) +## [1.0.0-beta-java.1] - 2026-05-05 +> **Reference implementation sync:** [`github/copilot-sdk@c063458`](https://github.com/github/copilot-sdk/commit/c063458ecc3d606766f04cf203b11b08de672cc8) ## [0.3.0-java.2] - 2026-04-26 > **Reference implementation sync:** [`github/copilot-sdk@dd2dcbc`](https://github.com/github/copilot-sdk/commit/dd2dcbc439256acfb9feb2cff07c0b9c820091b8) @@ -393,7 +411,7 @@ New types: `GetForegroundSessionResponse`, `SetForegroundSessionResponse` - Advanced usage documentation with comprehensive examples - Getting started guide with Maven and JBang instructions -- Package-info.java files for `com.github.copilot.sdk`, `events`, and `json` packages +- Package-info.java files for `com.github.copilot`, `events`, and `json` packages - `@since` annotations on all public classes - Versioned documentation with version selector on GitHub Pages - Maven resources plugin for site markdown filtering @@ -497,31 +515,16 @@ New types: `GetForegroundSessionResponse`, `SetForegroundSessionResponse` - Pre-commit hook for Spotless code formatting - Comprehensive API documentation -[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java-preview.0...HEAD -[0.3.0-java-preview.0]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java-preview.0 -[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java-preview.0...HEAD -[0.3.0-java-preview.0]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java-preview.0 -[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java-preview.1...HEAD -[0.3.0-java-preview.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java-preview.1 -[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java.2...HEAD +[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v1.0.0-beta-8-java.0...HEAD +[1.0.0-beta-8-java.0]: https://github.com/github/copilot-sdk-java/compare/v1.0.0-beta-java.4...v1.0.0-beta-8-java.0 +[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v1.0.0-beta-10-java.0...HEAD +[1.0.0-beta-10-java.0]: https://github.com/github/copilot-sdk-java/compare/v1.0.0-beta-java.4...v1.0.0-beta-10-java.0 +[1.0.0-beta-java.4]: https://github.com/github/copilot-sdk-java/compare/v1.0.0-beta-java.3...v1.0.0-beta-java.4 +[1.0.0-beta-java.3]: https://github.com/github/copilot-sdk-java/compare/v1.0.0-beta-java.2...v1.0.0-beta-java.3 +[1.0.0-beta-java.2]: https://github.com/github/copilot-sdk-java/compare/v1.0.0-beta-java.1...v1.0.0-beta-java.2 +[1.0.0-beta-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java.2...v1.0.0-beta-java.1 [0.3.0-java.2]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java.2 -[0.2.2-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.1...v0.2.2-java.1 -[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java-preview.0...HEAD -[0.3.0-java-preview.0]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java-preview.0 -[0.2.2-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.1...v0.2.2-java.1 -[0.2.1-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.0...v0.2.1-java.1 -[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java-preview.0...HEAD -[0.3.0-java-preview.0]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java-preview.0 -[0.2.2-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.1...v0.2.2-java.1 -[0.2.1-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.0...v0.2.1-java.1 -[0.2.1-java.0]: https://github.com/github/copilot-sdk-java/compare/v0.1.32-java.0...v0.2.1-java.0 -[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java-preview.0...HEAD -[0.3.0-java-preview.0]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java-preview.0 -[0.2.2-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.1...v0.2.2-java.1 -[0.2.1-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.0...v0.2.1-java.1 -[0.2.1-java.0]: https://github.com/github/copilot-sdk-java/compare/v0.1.32-java.0...v0.2.1-java.0 -[0.1.32-java.0]: https://github.com/github/copilot-sdk-java/compare/v1.0.11...v0.1.32-java.0 -[Unreleased]: https://github.com/github/copilot-sdk-java/compare/v0.3.0-java-preview.0...HEAD +[0.3.0-java-preview.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java-preview.1 [0.3.0-java-preview.0]: https://github.com/github/copilot-sdk-java/compare/v0.2.2-java.1...v0.3.0-java-preview.0 [0.2.2-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.1...v0.2.2-java.1 [0.2.1-java.1]: https://github.com/github/copilot-sdk-java/compare/v0.2.1-java.0...v0.2.1-java.1 @@ -539,4 +542,3 @@ New types: `GetForegroundSessionResponse`, `SetForegroundSessionResponse` [1.0.2]: https://github.com/github/copilot-sdk-java/compare/v1.0.1...v1.0.2 [1.0.1]: https://github.com/github/copilot-sdk-java/compare/1.0.0...v1.0.1 [1.0.0]: https://github.com/github/copilot-sdk-java/releases/tag/1.0.0 - diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f86976c01f..38f2def77c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -38,7 +38,9 @@ If you have ideas for entirely new features, please post an issue or start a dis 1. Push to your fork and [submit a pull request][pr] 1. Pat yourself on the back and wait for your pull request to be reviewed and merged. -### Running tests and linters +### Running locally, including tests and linters + +The POM has logic to ensure a known correct installation of Copilot CLI is used when executing the tests. If you want to test against a different installation of Copilot CLI, set the value of the `copilot.cli.path` maven property to the fully qualified path to the Copilot CLI. ```bash # Build and run all tests @@ -54,6 +56,22 @@ mvn spotless:apply mvn spotless:check ``` +## Running the known correct Copilot CLI installation + +### POSIX + +```bash +export COPILOT_CLI_PATH="$(find "$PWD/target" -type f -path '*/nodejs/node_modules/@github/copilot/index.js' | head -n 1)" +node ${COPILOT_CLI_PATH} +``` + +### PowerShell + +```PowerShell +$env:COPILOT_CLI_PATH = (Get-ChildItem -Path "$PWD\target" -Recurse -Filter 'index.js' -File | Where-Object { $_.FullName -match '[\\/]nodejs[\\/]node_modules[\\/]@github[\\/]copilot[\\/]index\.js$' } | Select-Object -First 1 -ExpandProperty FullName) +node $env:COPILOT_CLI_PATH +``` + Here are a few things you can do that will increase the likelihood of your pull request being accepted: - Write tests. diff --git a/README.md b/README.md index f5658f3d6f..c665244911 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,14 @@ # GitHub Copilot SDK for Java -[![Build](https://github.com/github/copilot-sdk-java/actions/workflows/build-test.yml/badge.svg)](https://github.com/github/copilot-sdk-java/actions/workflows/build-test.yml) -[![Site](https://github.com/github/copilot-sdk-java/actions/workflows/deploy-site.yml/badge.svg)](https://github.com/github/copilot-sdk-java/actions/workflows/deploy-site.yml) -[![Coverage](.github/badges/jacoco.svg)](https://github.github.io/copilot-sdk-java/snapshot/jacoco/index.html) -[![Documentation](https://img.shields.io/badge/docs-online-brightgreen)](https://github.github.io/copilot-sdk-java/) +[![Build](https://github.com/github/copilot-sdk/actions/workflows/java-sdk-tests.yml/badge.svg)](https://github.com/github/copilot-sdk/actions/workflows/java-sdk-tests.yml) [![Java 17+](https://img.shields.io/badge/Java-17%2B-blue?logo=openjdk&logoColor=white)](https://openjdk.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) #### Latest release -[![GitHub Release Date](https://img.shields.io/github/release-date/github/copilot-sdk-java)](https://github.com/github/copilot-sdk-java/releases) -[![GitHub Release](https://img.shields.io/github/v/release/github/copilot-sdk-java)](https://github.com/github/copilot-sdk-java/releases) + +[![GitHub Release Date](https://img.shields.io/github/release-date/github/copilot-sdk)](https://github.com/github/copilot-sdk/releases) +[![GitHub Release](https://img.shields.io/github/v/release/github/copilot-sdk)](https://github.com/github/copilot-sdk/releases) [![Maven Central](https://img.shields.io/maven-central/v/com.github/copilot-sdk-java)](https://central.sonatype.com/artifact/com.github/copilot-sdk-java) -[![Documentation](https://img.shields.io/badge/docs-latest-brightgreen)](https://github.github.io/copilot-sdk-java/latest/) [![Javadoc](https://javadoc.io/badge2/com.github/copilot-sdk-java/javadoc.svg?q=1)](https://javadoc.io/doc/com.github/copilot-sdk-java/latest/index.html) ## Background @@ -22,10 +19,10 @@ Java SDK for programmatic control of GitHub Copilot CLI, enabling you to build A ## Installation -### Requirements +### Runtime requirements -- Java 17 or later. **JDK 25 recommended**. Selecting JDK 25 enables the use of virtual threads, as shown in the [Quick Start](#quick-start). -- GitHub Copilot CLI 1.0.17 or later installed and in `PATH` (or provide custom `cliPath`) +- Java 17 or later. **JDK 25 recommended**. The distributed jar is a multi-release jar (MR-JAR) and is compiled on JDK 25 with `maven.compiler.release` set to 17. This means, when run on JDK 25 and later, the SDK automatically uses virtual threads for its default internal executor. +- GitHub Copilot CLI 1.0.55-5. or later installed and in `PATH` (or provide custom `cliPath`) ### Maven @@ -33,10 +30,16 @@ Java SDK for programmatic control of GitHub Copilot CLI, enabling you to build A com.github copilot-sdk-java - 0.3.0-java.2 + 1.0.0-beta-10-java.0 ``` +### Gradle + +```groovy +implementation 'com.github:copilot-sdk-java:1.0.0-beta-10-java.0' + + #### Snapshot Builds Snapshot builds of the next development version are published to Maven Central Snapshots. To use them, add the repository and update the dependency version in your `pom.xml`: @@ -53,39 +56,32 @@ Snapshot builds of the next development version are published to Maven Central S com.github copilot-sdk-java - 0.3.1-java.1-SNAPSHOT + 1.0.0-beta-10-java.1-SNAPSHOT ``` ### Gradle ```groovy -implementation 'com.github:copilot-sdk-java:0.3.0-java.2' +implementation 'com.github:copilot-sdk-java:1.0.0-beta-10-java.0-SNAPSHOT' ``` ## Quick Start ```java -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionUsageInfoEvent; -import com.github.copilot.sdk.json.CopilotClientOptions; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; - -import java.util.concurrent.Executors; +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionUsageInfoEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; public class CopilotSDK { public static void main(String[] args) throws Exception { var lastMessage = new String[]{null}; // Create and start client - try (var client = new CopilotClient()) { // JDK 25+: comment out this line - // JDK 25+: uncomment the following 3 lines for virtual thread support - // var options = new CopilotClientOptions() - // .setExecutor(Executors.newVirtualThreadPerTaskExecutor()); - // try (var client = new CopilotClient(options)) { + try (var client = new CopilotClient()) { client.start().get(); // Create a session @@ -129,31 +125,20 @@ See the full source of [`jbang-example.java`](jbang-example.java) for a complete Or run it directly from the repository: ```bash -jbang https://github.com/github/copilot-sdk-java/blob/latest/jbang-example.java +jbang https://github.com/github/copilot-sdk/blob/main/java/jbang-example.java ``` -## Documentation - -πŸ“š **[Full Documentation](https://github.github.io/copilot-sdk-java/)** β€” Complete API reference, advanced usage examples, and guides. - -### Quick Links - -- [Getting Started](https://github.github.io/copilot-sdk-java/latest/documentation.html) -- [Javadoc API Reference](https://github.github.io/copilot-sdk-java/latest/apidocs/) -- [MCP Servers Integration](https://github.github.io/copilot-sdk-java/latest/mcp.html) -- [Cookbook](src/site/markdown/cookbook/) β€” Practical recipes for common use cases - ## Projects Using This SDK -| Project | Description | -|---------|-------------| +| Project | Description | +| ----------------------------------------------------------------------------- | ------------------------------------------ | | [JMeter Copilot Plugin](https://github.com/brunoborges/jmeter-copilot-plugin) | JMeter plugin for AI-assisted load testing | > Want to add your project? Open a PR! ## CI/CD Workflows -This project uses several GitHub Actions workflows for building, testing, releasing, and syncing with the reference implementation SDK. +This project uses several GitHub Actions workflows for building, testing, releasing, and syncing with the reference implementation SDK. See [WORKFLOWS.md](docs/WORKFLOWS.md) for a full overview and details on each workflow. @@ -165,24 +150,31 @@ Contributions are welcome! Please see the [Contributing Guide](CONTRIBUTING.md) This SDK tracks the official [Copilot SDK](https://github.com/github/copilot-sdk) (.NET reference implementation) and ports changes to Java. The reference implementation merge process is automated with AI assistance: -**Weekly automated sync** β€” A [scheduled GitHub Actions workflow](.github/workflows/weekly-reference-impl-sync.yml) runs every Monday at 5 AM ET. It checks for new reference implementation commits since the last merge (tracked in [`.lastmerge`](.lastmerge)), and if changes are found, creates an issue labeled `reference-impl-sync` and assigns it to the GitHub Copilot coding agent. Any previously open `reference-impl-sync` issues are automatically closed. +**Automated sync** β€” A [scheduled GitHub Actions workflow](.github/workflows/reference-impl-sync.yml) runs on the schedule specified in that file. It checks for new reference implementation commits since the last merge (tracked in [`.lastmerge`](.lastmerge)), and if changes are found, creates an issue labeled `reference-impl-sync` and assigns it to the GitHub Copilot coding agent. Any previously open `reference-impl-sync` issues are automatically closed. The sync also updates the `@github/copilot` version in both `pom.xml` and `scripts/codegen/package.json` to keep schemas and test CLI in lockstep. **Reusable prompt** β€” The merge workflow is defined in [`agentic-merge-reference-impl.prompt.md`](.github/prompts/agentic-merge-reference-impl.prompt.md). It can be triggered manually from: + - **VS Code Copilot Chat** β€” type `/agentic-merge-reference-impl` - **GitHub Copilot CLI** β€” use `copilot` CLI with the same skill reference ### Development Setup +Requires JDK 25 or later for development. + ```bash # Clone the repository -git clone https://github.com/github/copilot-sdk-java.git -cd copilot-sdk-java +git clone https://github.com/github/copilot-sdk.git +cd copilot-sdk/java # Enable git hooks for code formatting git config core.hooksPath .githooks -# Build and test +# Build and test with JDK 25 mvn clean verify + +# Set your paths for JDK 17 +# Run the JDK 25 built jar with JDK 17 JVM for tests. Do not re-compile the jar. +mvn jacoco:prepare-agent@wire-up-coverage-instrumentation antrun:run@print-test-jdk-banner surefire:test failsafe:integration-test failsafe:verify jacoco:report@build-coverage-report-from-tests -Denforcer.skip=true ``` The tests require the official [copilot-sdk](https://github.com/github/copilot-sdk) test harness, which is automatically cloned during build. @@ -203,13 +195,3 @@ See [SECURITY.md](SECURITY.md) for reporting security vulnerabilities. MIT β€” see [LICENSE](LICENSE) for details. -## Acknowledgement - -- Initially developed with Copilot and [Bruno Borges](https://www.linkedin.com/in/brunocborges/). - -## Star History - -[![Star History Chart](https://api.star-history.com/svg?repos=github/copilot-sdk-java&type=Date)](https://www.star-history.com/#github/copilot-sdk-java&Date) - -⭐ Drop a star if you find this useful! - diff --git a/config/checkstyle/checkstyle.xml b/config/checkstyle/checkstyle.xml index 9a6f3761b5..fcde1f6c97 100644 --- a/config/checkstyle/checkstyle.xml +++ b/config/checkstyle/checkstyle.xml @@ -11,9 +11,9 @@ - + - + diff --git a/config/spotbugs/spotbugs-exclude.xml b/config/spotbugs/spotbugs-exclude.xml index 1c7d415f65..b0b3628827 100644 --- a/config/spotbugs/spotbugs-exclude.xml +++ b/config/spotbugs/spotbugs-exclude.xml @@ -10,11 +10,11 @@ --> - + - + diff --git a/docs/WORKFLOWS.md b/docs/WORKFLOWS.md index 3df254890c..9dd3833d1b 100644 --- a/docs/WORKFLOWS.md +++ b/docs/WORKFLOWS.md @@ -6,11 +6,11 @@ |----------|-------------|----------|----------| | [Build & Test](workflows/build-test.yml) | Builds, lints, and tests the Java SDK | `push` (main), `pull_request`, `merge_group`, `workflow_dispatch` | Sundays at 00:00 UTC | | [Codegen Check](workflows/codegen-check.yml) | Verifies that generated Java files are up-to-date with the JSON schemas | `push` (main), `pull_request`, `workflow_dispatch` | β€” | -| [Update @github/copilot Dependency](workflows/update-copilot-dependency.yml) | Updates the `@github/copilot` npm package, re-runs code generation, and opens a PR | `workflow_dispatch` | β€” | +| [Update @github/copilot Dependency](workflows/update-copilot-dependency.yml) | _(Codegen-only)_ Updates the `@github/copilot` npm package in `scripts/codegen`, re-runs code generation, and opens a PR. Does **not** update `pom.xml`; use the Reference Implementation Sync for full version alignment. | `workflow_dispatch` | β€” | | [Deploy Documentation](workflows/deploy-site.yml) | Generates and deploys versioned docs to GitHub Pages | `workflow_run` (after Build & Test), `release`, `workflow_dispatch` | β€” | | [Publish to Maven Central](workflows/publish-maven.yml) | Releases the SDK to Maven Central and creates a GitHub Release | `workflow_dispatch` | β€” | -| [Weekly Reference Implementation Sync](workflows/weekly-reference-impl-sync.yml) | Checks for new reference implementation commits and creates an issue for Copilot to merge | `workflow_dispatch` | Mondays at 10:00 UTC | -| [Weekly Reference Implementation Sync (Agentic)](workflows/weekly-reference-impl-sync.lock.yml) | Compiled agentic workflow that executes the reference implementation sync via `gh-aw` | `workflow_dispatch` | Tuesdays at 08:39 UTC (scattered) | +| [Reference Implementation Sync](workflows/reference-impl-sync.yml) | Checks for new reference implementation commits and creates an issue for Copilot to merge | `workflow_dispatch` | [See workflow](workflows/reference-impl-sync.yml) | +| [Reference Implementation Sync (Agentic)](workflows/reference-impl-sync.lock.yml) | Compiled agentic workflow that executes the reference implementation sync via `gh-aw` | `workflow_dispatch` | [See workflow](workflows/reference-impl-sync.lock.yml) | | [Copilot Setup Steps](workflows/copilot-setup-steps.yml) | Configures the environment for the GitHub Copilot coding agent | `push` (on self-change), `workflow_dispatch` | β€” | --- @@ -64,11 +64,11 @@ Manual-only workflow that performs a full release: --- -## Weekly Reference Implementation Sync +## Reference Implementation Sync -**File:** [`weekly-reference-impl-sync.yml`](workflows/weekly-reference-impl-sync.yml) +**File:** [`reference-impl-sync.yml`](workflows/reference-impl-sync.yml) -Runs every Monday at 10:00 UTC. Clones the official `github/copilot-sdk` repository and compares `HEAD` against the commit hash stored in `.lastmerge`. +Runs on the schedule specified in [`.github/workflows/reference-impl-sync.yml`](workflows/reference-impl-sync.yml). Clones the official `github/copilot-sdk` repository and compares `HEAD` against the commit hash stored in `.lastmerge`. If new commits are found: 1. Closes any previously open `reference-impl-sync` issues @@ -79,9 +79,9 @@ If no changes are found, any stale open `reference-impl-sync` issues are closed. --- -## Weekly Reference Implementation Sync (Agentic Workflow: Experimental) +## Reference Implementation Sync (Agentic Workflow: Experimental) -**File:** [`weekly-reference-impl-sync.lock.yml`](workflows/weekly-reference-impl-sync.lock.yml) +**File:** [`reference-impl-sync.lock.yml`](workflows/reference-impl-sync.lock.yml) Auto-generated compiled workflow produced by `gh aw compile` from the corresponding `.md` source. This is the agentic counterpart that actually executes the reference implementation merge using the `gh-aw` MCP server and Copilot coding agent. @@ -113,6 +113,8 @@ If changes appear, commit the updated generated files. **File:** [`update-copilot-dependency.yml`](workflows/update-copilot-dependency.yml) +> **Note:** This workflow is for codegen-only updates to `scripts/codegen`. It does **not** update `pom.xml`. For full version alignment (both CLI and codegen in lockstep), use the **Reference Implementation Sync** workflow instead. + Manual workflow triggered when a new version of the `@github/copilot` npm package is published. Accepts a `version` input (e.g. `1.0.25`). Steps: diff --git a/docs/adr/adr-002-maven-version-and-reference-implementation-tracking.md b/docs/adr/adr-002-maven-version-and-reference-implementation-tracking.md index 6a0b54f225..248a024c23 100644 --- a/docs/adr/adr-002-maven-version-and-reference-implementation-tracking.md +++ b/docs/adr/adr-002-maven-version-and-reference-implementation-tracking.md @@ -8,7 +8,7 @@ Releases of this implementation track releases of the reference implementation. - Simple number qualifier (0.1.32-0, 0.1.32-1, ...) fails on a subtle but important point: 0.1.32-0 is treated identically to 0.1.32 by Maven (trailing zeros are normalized away), and bare numeric qualifiers are pre-release semantics. Your "first release" would sort before the reference implementation bare version. -- Java and number in the qualifier (0.1.32-java.N +- Java and number in the qualifier (0.1.32-java.N) - java is an unknown qualifier that sorts correctly and accurately describes what it is β€” the Java-ecosystem release of this version. diff --git a/jbang-example.java b/jbang-example.java index 4b711ba735..cd5f306007 100644 --- a/jbang-example.java +++ b/jbang-example.java @@ -1,11 +1,11 @@ -! -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionUsageInfoEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +///usr/bin/env jbang "$0" "$@" ; exit $? +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionUsageInfoEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; import static java.lang.System.out; diff --git a/pom.xml b/pom.xml index 5abdefcbff..d8d7ffd54f 100644 --- a/pom.xml +++ b/pom.xml @@ -7,7 +7,7 @@ com.github copilot-sdk-java - 0.3.0-java.2 + 1.0.0-beta-10-java.0 jar GitHub Copilot SDK :: Java @@ -33,7 +33,7 @@ scm:git:https://github.com/github/copilot-sdk-java.git scm:git:https://github.com/github/copilot-sdk-java.git https://github.com/github/copilot-sdk-java - v0.3.0-java.2 + v1.0.0-beta-10-java.0 @@ -49,10 +49,53 @@ ${project.build.directory}/copilot-sdk ${copilot.sdk.clone.dir}/test + + ${copilot.sdk.clone.dir}/nodejs/node_modules/@github/copilot/index.js false + + ${skip.test.harness} + + ^1.0.55-5 + @@ -60,7 +103,7 @@ com.fasterxml.jackson.core jackson-databind - 2.21.2 + 2.21.3 com.fasterxml.jackson.core @@ -70,7 +113,7 @@ com.fasterxml.jackson.datatype jackson-datatype-jsr310 - 2.21.2 + 2.21.3 @@ -85,7 +128,7 @@ org.junit.jupiter junit-jupiter - 5.14.3 + 5.14.4 test @@ -129,13 +172,6 @@ org.apache.maven.plugins maven-jar-plugin 3.5.0 - - - - com.github.copilot.sdk.java - - - @@ -209,6 +245,18 @@ + + print-test-jdk-banner + process-test-classes + + run + + + + + + + @@ -240,20 +288,124 @@ + + + install-nodejs-cli-dependencies + generate-test-resources + + exec + + + ${skip.cli.install} + npm + ${copilot.sdk.clone.dir}/nodejs + + ci + --ignore-scripts + + + + + + org.apache.maven.plugins + maven-failsafe-plugin + 3.5.5 + + + + integration-test + verify + + + + + + ${project.build.directory} + ${project.build.finalName} + ${project.build.testOutputDirectory} + + + org.apache.maven.plugins maven-surefire-plugin 3.5.5 + alphabetical ${testExecutionAgentArgs} ${surefire.jvm.args} + + 2 ${copilot.tests.dir} ${copilot.sdk.clone.dir} + + + ${copilot.cli.path} + + + + + isolated-resume-tests + test + + test + + + isolated-resume + + ${project.build.directory}/surefire-reports-isolated + + + + + default-test + + isolated-resume + + + @@ -316,11 +468,11 @@ testExecutionAgentArgs - com/github/copilot/sdk/** + com/github/copilot/** - com/github/copilot/sdk/E2ETestContext* - com/github/copilot/sdk/CapiProxy* + com/github/copilot/E2ETestContext* + com/github/copilot/CapiProxy* @@ -334,6 +486,10 @@ ${project.build.directory}/jacoco-test-results/sdk-tests.exec ${project.reporting.outputDirectory}/jacoco-coverage + + + META-INF/versions/**/*.class + @@ -580,6 +736,87 @@ -XX:+EnableDynamicAgentLoading + + java25-multi-release + + [25,) + + + + + org.apache.maven.plugins + maven-compiler-plugin + + + compile-java25 + compile + + compile + + + 25 + false + + ${project.basedir}/src/main/java25 + + true + + + + + + org.apache.maven.plugins + maven-jar-plugin + + + + true + + + + + + + org.apache.maven.plugins + maven-antrun-plugin + + + verify-java25-overlay + package + + run + + + + + + + + + +JDK 25 multi-release overlay class is missing from the packaged JAR. +Expected entry: META-INF/versions/25/com/github/copilot/InternalExecutorProvider.class +JAR: ${project.build.directory}/${project.build.finalName}.jar + +This usually means the 'java25-multi-release' Maven profile did not activate +(e.g. the build is running on a JDK older than 25) or maven-compiler-plugin +did not produce the multi-release output. Re-build on JDK 25+ and verify the +'compile-java25' execution ran during the 'compile' phase. + + + + + + + + + skip-test-harness @@ -587,6 +824,39 @@ true + + + skip-cli-install-when-tests-skipped + + + skipTests + true + + + + true + + + + + skip-cli-install-when-maven-test-skip + + + maven.test.skip + true + + + + true + + debug @@ -681,7 +951,7 @@ org.apache.maven.plugins maven-enforcer-plugin - 3.6.2 + 3.6.3 require-schema-version diff --git a/scripts/codegen/java.ts b/scripts/codegen/java.ts index 909fe296c6..64fc463a0c 100644 --- a/scripts/codegen/java.ts +++ b/scripts/codegen/java.ts @@ -37,13 +37,29 @@ function toJavaClassName(typeName: string): string { return typeName.split(/[._]/).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(""); } +/** Java reserved keywords and Object method names that cannot be used as record component names. */ +const JAVA_RESERVED_IDENTIFIERS = new Set([ + "abstract", "assert", "boolean", "break", "byte", "case", "catch", "char", "class", "const", + "continue", "default", "do", "double", "else", "enum", "extends", "final", "finally", "float", + "for", "goto", "if", "implements", "import", "instanceof", "int", "interface", "long", "native", + "new", "package", "private", "protected", "public", "return", "short", "static", "strictfp", + "super", "switch", "synchronized", "this", "throw", "throws", "transient", "try", "void", + "volatile", "while", + // Object methods that conflict with record component accessor names + "wait", "notify", "notifyAll", "getClass", "clone", "finalize", "toString", "hashCode", "equals", +]); + function toCamelCase(name: string): string { const pascal = toPascalCase(name); - return pascal.charAt(0).toLowerCase() + pascal.slice(1); + let result = pascal.charAt(0).toLowerCase() + pascal.slice(1); + if (JAVA_RESERVED_IDENTIFIERS.has(result)) { + result = result + "_"; + } + return result; } function toEnumConstant(value: string): string { - return value.toUpperCase().replace(/[-. ]/g, "_"); + return value.toUpperCase().replace(/[-. /:]/g, "_").replace(/^_+/, "").replace(/_+/g, "_"); } // ── Schema path resolution ─────────────────────────────────────────────────── @@ -102,6 +118,11 @@ interface JavaTypeResult { let currentDefinitions: Record = {}; const pendingStandaloneTypes = new Map(); +// Cross-schema definitions: keyed by schema filename (e.g. "session-events.schema.json"), +// value is the definitions map from that schema. Populated by generateRpcTypes so that +// cross-schema $ref values like "session-events.schema.json#/definitions/Foo" can be resolved. +const crossSchemaDefinitions = new Map>(); + /** * Resolve a $ref in a JSON Schema against the current definitions. * Returns the resolved schema, or the original if no $ref is present. @@ -131,6 +152,28 @@ function schemaTypeToJava( // Resolve $ref first β€” register standalone types for generation if (schema.$ref) { + // Handle cross-schema $ref (e.g. "session-events.schema.json#/definitions/Foo") + const crossSchemaMatch = schema.$ref.match(/^([^#]+)#\/definitions\/(.+)$/); + if (crossSchemaMatch) { + const [, schemaFile, typeName] = crossSchemaMatch; + const externalDefs = crossSchemaDefinitions.get(schemaFile); + if (externalDefs) { + const resolved = externalDefs[typeName]; + if (resolved) { + // Save and swap currentDefinitions so recursive calls resolve against + // the external schema's definitions. + const savedDefs = currentDefinitions; + currentDefinitions = externalDefs; + const result = schemaTypeToJava(resolved, required, context, propName, nestedTypes); + currentDefinitions = savedDefs; + return result; + } + } + // Fallback: extract just the type name and warn + console.warn(`[codegen] Unresolved cross-schema $ref: ${schema.$ref}`); + return { javaType: typeName, imports }; + } + const name = schema.$ref.replace(/^#\/definitions\//, ""); const resolved = currentDefinitions[name]; if (resolved) { @@ -315,8 +358,8 @@ async function generateSessionEvents(schemaPath: string): Promise { pendingStandaloneTypes.clear(); const variants = extractEventVariants(schema); - const packageName = "com.github.copilot.sdk.generated"; - const packageDir = `src/generated/java/com/github/copilot/sdk/generated`; + const packageName = "com.github.copilot.generated"; + const packageDir = `src/generated/java/com/github/copilot/generated`; // Generate base SessionEvent class await generateSessionEventBaseClass(variants, packageName, packageDir); @@ -883,9 +926,22 @@ async function generateRpcTypes(schemaPath: string): Promise { // Set module-level definitions for $ref resolution currentDefinitions = (schema.definitions ?? {}) as Record; pendingStandaloneTypes.clear(); + crossSchemaDefinitions.clear(); + + // Load cross-schema definitions (session-events) so that cross-schema $ref values + // like "session-events.schema.json#/definitions/Foo" can be resolved. + try { + const sessionEventsSchemaPath = await getSessionEventsSchemaPath(); + const sessionEventsContent = await fs.readFile(sessionEventsSchemaPath, "utf-8"); + const sessionEventsSchema = JSON.parse(sessionEventsContent) as JSONSchema7; + crossSchemaDefinitions.set("session-events.schema.json", + (sessionEventsSchema.definitions ?? {}) as Record); + } catch (e) { + console.warn(`[codegen] Could not load session-events schema for cross-ref resolution: ${e}`); + } - const packageName = "com.github.copilot.sdk.generated.rpc"; - const packageDir = `src/generated/java/com/github/copilot/sdk/generated/rpc`; + const packageName = "com.github.copilot.generated.rpc"; + const packageDir = `src/generated/java/com/github/copilot/generated/rpc`; // Collect all RPC methods from all sections const sections: [string, Record][] = []; @@ -1506,8 +1562,8 @@ async function generateRpcWrappers(schemaPath: string): Promise { // Set module-level definitions for $ref resolution in wrapper helpers currentDefinitions = (schema.definitions ?? {}) as Record; - const packageName = "com.github.copilot.sdk.generated.rpc"; - const packageDir = `src/generated/java/com/github/copilot/sdk/generated/rpc`; + const packageName = "com.github.copilot.generated.rpc"; + const packageDir = `src/generated/java/com/github/copilot/generated/rpc`; // RpcCaller interface and shared ObjectMapper holder await generateRpcCallerInterface(packageName, packageDir); diff --git a/scripts/codegen/package-lock.json b/scripts/codegen/package-lock.json index 682b30bc66..a0c6c648f0 100644 --- a/scripts/codegen/package-lock.json +++ b/scripts/codegen/package-lock.json @@ -6,7 +6,7 @@ "": { "name": "copilot-sdk-java-codegen", "dependencies": { - "@github/copilot": "^1.0.36", + "@github/copilot": "^1.0.55-5", "json-schema": "^0.4.0", "tsx": "^4.20.6" } @@ -428,26 +428,31 @@ } }, "node_modules/@github/copilot": { - "version": "1.0.36", - "resolved": "https://registry.npmjs.org/@github/copilot/-/copilot-1.0.36.tgz", - "integrity": "sha512-x0N5wLzw+tANzb+vCFYLHn3BV3qii2oyn14wC20RO7SsS8/YeBH8olvwlDLJ4PB0mL17QOiytNCdkvjvprm28w==", + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot/-/copilot-1.0.55-5.tgz", + "integrity": "sha512-n6Vr876Iz41PW8pSpOa7SbrNCqaV+6HDLNf/n8V4gIwwlOlIz7Jb00r/fboXZFIT+0dyAGGLoGgd7xUujVL/Xw==", "license": "SEE LICENSE IN LICENSE.md", + "dependencies": { + "detect-libc": "^2.1.2" + }, "bin": { "copilot": "npm-loader.js" }, "optionalDependencies": { - "@github/copilot-darwin-arm64": "1.0.36", - "@github/copilot-darwin-x64": "1.0.36", - "@github/copilot-linux-arm64": "1.0.36", - "@github/copilot-linux-x64": "1.0.36", - "@github/copilot-win32-arm64": "1.0.36", - "@github/copilot-win32-x64": "1.0.36" + "@github/copilot-darwin-arm64": "1.0.55-5", + "@github/copilot-darwin-x64": "1.0.55-5", + "@github/copilot-linux-arm64": "1.0.55-5", + "@github/copilot-linux-x64": "1.0.55-5", + "@github/copilot-linuxmusl-arm64": "1.0.55-5", + "@github/copilot-linuxmusl-x64": "1.0.55-5", + "@github/copilot-win32-arm64": "1.0.55-5", + "@github/copilot-win32-x64": "1.0.55-5" } }, "node_modules/@github/copilot-darwin-arm64": { - "version": "1.0.36", - "resolved": "https://registry.npmjs.org/@github/copilot-darwin-arm64/-/copilot-darwin-arm64-1.0.36.tgz", - "integrity": "sha512-5qkb7frTS4K/LdTDLrzKo78VR4aw/EZ6JzLz4KfmaW4UYyPiNirExDFXa/By22X0o8YMfOp4MCA2KSCAxKdgTg==", + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot-darwin-arm64/-/copilot-darwin-arm64-1.0.55-5.tgz", + "integrity": "sha512-Mult62GJVnxR3MOP2QNiVU5RRGXPJ+7BpjEMIvkoaMuWX6J7F4bz7N+HUXVHJUiGUp3hnL3M16kjkewWfNdoNg==", "cpu": [ "arm64" ], @@ -461,9 +466,9 @@ } }, "node_modules/@github/copilot-darwin-x64": { - "version": "1.0.36", - "resolved": "https://registry.npmjs.org/@github/copilot-darwin-x64/-/copilot-darwin-x64-1.0.36.tgz", - "integrity": "sha512-AdsM8QtM5QSzMLpavLREh8HALO5G+VWzGNQqIHu4f0YQC/s1cGoiwo3wsgkpxRcLGBykFc+bDX3yK3MDQ8XvSw==", + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot-darwin-x64/-/copilot-darwin-x64-1.0.55-5.tgz", + "integrity": "sha512-IfY3WhNvHwXHldI2ARsiAYuPlKWlI07Fo1ALq+SViHhn0Zfp2yIr9laJRofyj0G1EbyUxkbNlqQm7UrXhkEVeg==", "cpu": [ "x64" ], @@ -477,9 +482,9 @@ } }, "node_modules/@github/copilot-linux-arm64": { - "version": "1.0.36", - "resolved": "https://registry.npmjs.org/@github/copilot-linux-arm64/-/copilot-linux-arm64-1.0.36.tgz", - "integrity": "sha512-n7K1I6r0ggOJ4A9uAMS11USTvn6BKtAwvrOkzEaeRK89VNUJzpTe6p0mE13ItzRe5eot9WLBQOxvXLtL9f6E+g==", + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot-linux-arm64/-/copilot-linux-arm64-1.0.55-5.tgz", + "integrity": "sha512-UPZ5Y5QotcZvo3f4yFwJVOtAgUT3mq+q2fim82kWa/MA0+EkkADZ3kb+R4OnV1Nqv5EaoZiCFh0Ukk++IMSYwQ==", "cpu": [ "arm64" ], @@ -493,9 +498,9 @@ } }, "node_modules/@github/copilot-linux-x64": { - "version": "1.0.36", - "resolved": "https://registry.npmjs.org/@github/copilot-linux-x64/-/copilot-linux-x64-1.0.36.tgz", - "integrity": "sha512-wBtCdR3ITZcq07BJbkwHfwI6ayiwbH5pF1ex+Ycl4UI+Lf1vP9eQD6wJppPgsrjwFcdeWRThaYTPCRTkSGHv5g==", + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot-linux-x64/-/copilot-linux-x64-1.0.55-5.tgz", + "integrity": "sha512-Fdwiir53Ogg8C9xv6sTc7/C4vFfQHt6VWFB74kojbDgIbYEpm57wNygQVwJvrwtVW3w/b1MLtGGTp7pEvUBACQ==", "cpu": [ "x64" ], @@ -508,10 +513,42 @@ "copilot-linux-x64": "copilot" } }, + "node_modules/@github/copilot-linuxmusl-arm64": { + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot-linuxmusl-arm64/-/copilot-linuxmusl-arm64-1.0.55-5.tgz", + "integrity": "sha512-NqPmeAA1+iI8Xd4wJUHNNCmVTmHCl+R3nqdXhEVQDLIau9ouGqGGay/91d2ZIgFXJn7J0UTAEdHbdBcfhbnhvg==", + "cpu": [ + "arm64" + ], + "license": "SEE LICENSE IN LICENSE.md", + "optional": true, + "os": [ + "linux" + ], + "bin": { + "copilot-linuxmusl-arm64": "copilot" + } + }, + "node_modules/@github/copilot-linuxmusl-x64": { + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot-linuxmusl-x64/-/copilot-linuxmusl-x64-1.0.55-5.tgz", + "integrity": "sha512-bOB4vKw1R7Mekn8z34xpNViYUQ4LQAEFzpkyxhc0uOliFmfku/YcIgo42aMWFzf/Bi3iBazBNfCN+L2lz/Jc9A==", + "cpu": [ + "x64" + ], + "license": "SEE LICENSE IN LICENSE.md", + "optional": true, + "os": [ + "linux" + ], + "bin": { + "copilot-linuxmusl-x64": "copilot" + } + }, "node_modules/@github/copilot-win32-arm64": { - "version": "1.0.36", - "resolved": "https://registry.npmjs.org/@github/copilot-win32-arm64/-/copilot-win32-arm64-1.0.36.tgz", - "integrity": "sha512-0GzZUZQn07alI8BgbzK0NlR5+ta/Rd0sWmd8kbRCns7oybAIkSALy6BKVwJmVHtXUi6h4iUE8oiFhkn0spymvw==", + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot-win32-arm64/-/copilot-win32-arm64-1.0.55-5.tgz", + "integrity": "sha512-pR2KaiXUanjxolaWgRPlFdeTEpb7jcN1Rk8xVnBCD2ORwERXdYrqXaLCyDbgdplI9mI6IjM+kkUbyXzXoWz/HQ==", "cpu": [ "arm64" ], @@ -525,9 +562,9 @@ } }, "node_modules/@github/copilot-win32-x64": { - "version": "1.0.36", - "resolved": "https://registry.npmjs.org/@github/copilot-win32-x64/-/copilot-win32-x64-1.0.36.tgz", - "integrity": "sha512-UBX9qj0McCK/SLq93XIr1i80fj3b3XmE3befVFrzxQuTeOoxLURN35vi7W+4x+4ZfsDHQpRTlJNjZw9w0fPr+Q==", + "version": "1.0.55-5", + "resolved": "https://registry.npmjs.org/@github/copilot-win32-x64/-/copilot-win32-x64-1.0.55-5.tgz", + "integrity": "sha512-EuQBgqSnRFjavgeFifbnSYUJ4elTQBLC/kf+WHolrHR2oUGyiqCQZz/cV2DYVSLP1TGxDKAV4AQCM1AdUT1xEA==", "cpu": [ "x64" ], @@ -540,6 +577,15 @@ "copilot-win32-x64": "copilot.exe" } }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, "node_modules/esbuild": { "version": "0.27.7", "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.7.tgz", diff --git a/scripts/codegen/package.json b/scripts/codegen/package.json index 1b540376e1..6664dd8f27 100644 --- a/scripts/codegen/package.json +++ b/scripts/codegen/package.json @@ -7,7 +7,7 @@ "generate:java": "tsx java.ts" }, "dependencies": { - "@github/copilot": "^1.0.36", + "@github/copilot": "^1.0.55-5", "json-schema": "^0.4.0", "tsx": "^4.20.6" } diff --git a/scripts/compare-standalone-to-monorepo.sh b/scripts/compare-standalone-to-monorepo.sh new file mode 100755 index 0000000000..34ac23ec65 --- /dev/null +++ b/scripts/compare-standalone-to-monorepo.sh @@ -0,0 +1,360 @@ +#!/bin/sh +# compare-standalone-to-monorepo.sh +# +# Compare POM, Java source, Java properties files, and .lastmerge between the +# standalone copilot-sdk-java repo and the monorepo's java/ directory. +# +# Usage: +# ./scripts/compare-standalone-to-monorepo.sh /path/to/standalone /path/to/monorepo [--diff] +# +# The standalone path should point to the root of copilot-sdk-java. +# The monorepo path should point to the root of copilot-sdk (the java/ subdir +# is appended automatically). +# +# Compatible with macOS zsh and POSIX sh/bash. + +set -e + +# ── Parse arguments ────────────────────────────────────────────────── +SHOW_DIFF=false +STANDALONE="" +MONOREPO="" + +for arg in "$@"; do + case "$arg" in + --diff) + SHOW_DIFF=true + ;; + *) + if [ -z "$STANDALONE" ]; then + STANDALONE="$arg" + elif [ -z "$MONOREPO" ]; then + MONOREPO="$arg" + else + echo "Error: unexpected argument: $arg" >&2 + echo "Usage: $0 [--diff]" >&2 + exit 1 + fi + ;; + esac +done + +if [ -z "$STANDALONE" ] || [ -z "$MONOREPO" ]; then + echo "Usage: $0 [--diff]" >&2 + exit 1 +fi + +MONO_JAVA="${MONOREPO}/java" + +if [ ! -d "$STANDALONE" ]; then + echo "Error: standalone directory does not exist: $STANDALONE" >&2 + exit 1 +fi + +if [ ! -d "$MONO_JAVA" ]; then + echo "Error: monorepo java directory does not exist: $MONO_JAVA" >&2 + exit 1 +fi + +# ── Collect comparable files from the standalone repo ──────────────── +# Excludes: target/, node_modules/, temporary-prompts/, scripts/codegen/ +# (these are build artifacts or standalone-only content) +TMPFILE_STANDALONE=$(mktemp) +TMPFILE_MONO=$(mktemp) +trap 'rm -f "$TMPFILE_STANDALONE" "$TMPFILE_MONO"' EXIT + +(cd "$STANDALONE" && find . -type f \( -name "pom.xml" -o -name "*.java" -o -name "*.properties" \) \ + | grep -v '/target/' \ + | grep -v '/node_modules/' \ + | grep -v '^\./temporary-prompts/' \ + | grep -v '^\./scripts/codegen/' \ + | sed 's|^\./||' \ + | sort) > "$TMPFILE_STANDALONE" + +# ── Collect comparable files from the monorepo ─────────────────────── +# Excludes: target/, node_modules/, scripts/codegen/ +(cd "$MONO_JAVA" && find . -type f \( -name "pom.xml" -o -name "*.java" -o -name "*.properties" \) \ + | grep -v '/target/' \ + | grep -v '/node_modules/' \ + | grep -v '^\./scripts/codegen/' \ + | sed 's|^\./||' \ + | sort) > "$TMPFILE_MONO" + +# ── Compare ────────────────────────────────────────────────────────── +DIFFER_COUNT=0 +MISSING_FROM_MONO_COUNT=0 +MISSING_FROM_STANDALONE_COUNT=0 +SAME_COUNT=0 +DIFFER_LIST="" +MISSING_FROM_MONO_LIST="" +MISSING_FROM_STANDALONE_LIST="" + +# Check standalone files against monorepo +while IFS= read -r relpath; do + standalone_file="${STANDALONE}/${relpath}" + mono_file="${MONO_JAVA}/${relpath}" + + if [ ! -f "$mono_file" ]; then + MISSING_FROM_MONO_COUNT=$((MISSING_FROM_MONO_COUNT + 1)) + MISSING_FROM_MONO_LIST="${MISSING_FROM_MONO_LIST}${relpath} +" + elif ! diff -q "$standalone_file" "$mono_file" >/dev/null 2>&1; then + DIFFER_COUNT=$((DIFFER_COUNT + 1)) + DIFFER_LIST="${DIFFER_LIST}${relpath} +" + else + SAME_COUNT=$((SAME_COUNT + 1)) + fi +done < "$TMPFILE_STANDALONE" + +# Check monorepo files that don't exist in standalone +while IFS= read -r relpath; do + standalone_file="${STANDALONE}/${relpath}" + + if [ ! -f "$standalone_file" ]; then + MISSING_FROM_STANDALONE_COUNT=$((MISSING_FROM_STANDALONE_COUNT + 1)) + MISSING_FROM_STANDALONE_LIST="${MISSING_FROM_STANDALONE_LIST}${relpath} +" + fi +done < "$TMPFILE_MONO" + +# ── Compare scripts/codegen/java.ts ─────────────────────────────────── +JAVATS_STATUS="" +STANDALONE_JAVATS="${STANDALONE}/scripts/codegen/java.ts" +MONO_JAVATS="${MONO_JAVA}/scripts/codegen/java.ts" + +if [ -f "$STANDALONE_JAVATS" ] && [ -f "$MONO_JAVATS" ]; then + if diff -q "$STANDALONE_JAVATS" "$MONO_JAVATS" >/dev/null 2>&1; then + JAVATS_STATUS="identical" + SAME_COUNT=$((SAME_COUNT + 1)) + else + JAVATS_STATUS="differ" + DIFFER_COUNT=$((DIFFER_COUNT + 1)) + DIFFER_LIST="${DIFFER_LIST}scripts/codegen/java.ts +" + fi +elif [ -f "$STANDALONE_JAVATS" ] && [ ! -f "$MONO_JAVATS" ]; then + JAVATS_STATUS="only-standalone" + MISSING_FROM_MONO_COUNT=$((MISSING_FROM_MONO_COUNT + 1)) + MISSING_FROM_MONO_LIST="${MISSING_FROM_MONO_LIST}scripts/codegen/java.ts +" +elif [ ! -f "$STANDALONE_JAVATS" ] && [ -f "$MONO_JAVATS" ]; then + JAVATS_STATUS="only-monorepo" + MISSING_FROM_STANDALONE_COUNT=$((MISSING_FROM_STANDALONE_COUNT + 1)) + MISSING_FROM_STANDALONE_LIST="${MISSING_FROM_STANDALONE_LIST}scripts/codegen/java.ts +" +else + JAVATS_STATUS="missing-both" +fi + +# ── Compare .lastmerge ──────────────────────────────────────────────── +LASTMERGE_STATUS="" +STANDALONE_LASTMERGE="${STANDALONE}/.lastmerge" +MONO_LASTMERGE="${MONO_JAVA}/.lastmerge" + +if [ -f "$STANDALONE_LASTMERGE" ] && [ -f "$MONO_LASTMERGE" ]; then + if diff -q "$STANDALONE_LASTMERGE" "$MONO_LASTMERGE" >/dev/null 2>&1; then + LASTMERGE_STATUS="identical" + SAME_COUNT=$((SAME_COUNT + 1)) + else + LASTMERGE_STATUS="differ" + DIFFER_COUNT=$((DIFFER_COUNT + 1)) + DIFFER_LIST="${DIFFER_LIST}.lastmerge +" + fi +elif [ -f "$STANDALONE_LASTMERGE" ] && [ ! -f "$MONO_LASTMERGE" ]; then + LASTMERGE_STATUS="only-standalone" + MISSING_FROM_MONO_COUNT=$((MISSING_FROM_MONO_COUNT + 1)) + MISSING_FROM_MONO_LIST="${MISSING_FROM_MONO_LIST}.lastmerge +" +elif [ ! -f "$STANDALONE_LASTMERGE" ] && [ -f "$MONO_LASTMERGE" ]; then + LASTMERGE_STATUS="only-monorepo" + MISSING_FROM_STANDALONE_COUNT=$((MISSING_FROM_STANDALONE_COUNT + 1)) + MISSING_FROM_STANDALONE_LIST="${MISSING_FROM_STANDALONE_LIST}.lastmerge +" +else + LASTMERGE_STATUS="missing-both" +fi + +# ── Compare README.md (standalone README.md ↔ monorepo java/README.md) ──────── +README_STATUS="" +STANDALONE_README="${STANDALONE}/README.md" +MONO_README="${MONO_JAVA}/README.md" + +if [ -f "$STANDALONE_README" ] && [ -f "$MONO_README" ]; then + if diff -q "$STANDALONE_README" "$MONO_README" >/dev/null 2>&1; then + README_STATUS="identical" + SAME_COUNT=$((SAME_COUNT + 1)) + else + README_STATUS="differ" + DIFFER_COUNT=$((DIFFER_COUNT + 1)) + DIFFER_LIST="${DIFFER_LIST}README.md +" + fi +elif [ -f "$STANDALONE_README" ] && [ ! -f "$MONO_README" ]; then + README_STATUS="only-standalone" + MISSING_FROM_MONO_COUNT=$((MISSING_FROM_MONO_COUNT + 1)) + MISSING_FROM_MONO_LIST="${MISSING_FROM_MONO_LIST}README.md +" +elif [ ! -f "$STANDALONE_README" ] && [ -f "$MONO_README" ]; then + README_STATUS="only-monorepo" + MISSING_FROM_STANDALONE_COUNT=$((MISSING_FROM_STANDALONE_COUNT + 1)) + MISSING_FROM_STANDALONE_LIST="${MISSING_FROM_STANDALONE_LIST}README.md +" +else + README_STATUS="missing-both" +fi + +STANDALONE_TOTAL=$(wc -l < "$TMPFILE_STANDALONE" | tr -d ' ') +MONO_TOTAL=$(wc -l < "$TMPFILE_MONO" | tr -d ' ') + +# ── Output ─────────────────────────────────────────────────────────── +echo "Standalone files: ${STANDALONE_TOTAL} Monorepo files: ${MONO_TOTAL}" +echo " Identical: ${SAME_COUNT}" +echo " Differ: ${DIFFER_COUNT}" +echo " Only in standalone (missing from monorepo): ${MISSING_FROM_MONO_COUNT}" +echo " Only in monorepo (missing from standalone): ${MISSING_FROM_STANDALONE_COUNT}" +echo "" + +# .lastmerge status +if [ "$LASTMERGE_STATUS" = "identical" ]; then + echo ".lastmerge: identical" +elif [ "$LASTMERGE_STATUS" = "differ" ]; then + echo ".lastmerge: DIFFERS" + echo " standalone: $(cat "$STANDALONE_LASTMERGE")" + echo " monorepo: $(cat "$MONO_LASTMERGE")" +elif [ "$LASTMERGE_STATUS" = "only-standalone" ]; then + echo ".lastmerge: only in standalone" +elif [ "$LASTMERGE_STATUS" = "only-monorepo" ]; then + echo ".lastmerge: only in monorepo" +else + echo ".lastmerge: not found in either location" +fi + +# README.md status +if [ "$README_STATUS" = "identical" ]; then + echo "README.md: identical" +elif [ "$README_STATUS" = "differ" ]; then + echo "README.md: DIFFERS" +elif [ "$README_STATUS" = "only-standalone" ]; then + echo "README.md: only in standalone" +elif [ "$README_STATUS" = "only-monorepo" ]; then + echo "README.md: only in monorepo" +else + echo "README.md: not found in either location" +fi + +# scripts/codegen/java.ts status +if [ "$JAVATS_STATUS" = "identical" ]; then + echo "scripts/codegen/java.ts: identical" +elif [ "$JAVATS_STATUS" = "differ" ]; then + echo "scripts/codegen/java.ts: DIFFERS" +elif [ "$JAVATS_STATUS" = "only-standalone" ]; then + echo "scripts/codegen/java.ts: only in standalone" +elif [ "$JAVATS_STATUS" = "only-monorepo" ]; then + echo "scripts/codegen/java.ts: only in monorepo" +else + echo "scripts/codegen/java.ts: not found in either location" +fi +echo "" + +if [ "$DIFFER_COUNT" -gt 0 ]; then + echo "The following files differ between the standalone and monorepo:" + echo "" + printf '%s' "$DIFFER_LIST" | while IFS= read -r f; do + [ -n "$f" ] && echo " $f" + done + echo "" +fi + +if [ "$MISSING_FROM_MONO_COUNT" -gt 0 ]; then + echo "The following files exist in standalone but NOT in monorepo:" + echo "" + printf '%s' "$MISSING_FROM_MONO_LIST" | while IFS= read -r f; do + [ -n "$f" ] && echo " $f" + done + echo "" +fi + +if [ "$MISSING_FROM_STANDALONE_COUNT" -gt 0 ]; then + echo "The following files exist in monorepo but NOT in standalone:" + echo "" + printf '%s' "$MISSING_FROM_STANDALONE_LIST" | while IFS= read -r f; do + [ -n "$f" ] && echo " $f" + done + echo "" +fi + +if [ "$DIFFER_COUNT" -eq 0 ] && [ "$MISSING_FROM_MONO_COUNT" -eq 0 ] && [ "$MISSING_FROM_STANDALONE_COUNT" -eq 0 ]; then + echo "All files are identical." +fi + +# ── Optional unified diffs ─────────────────────────────────────────── +if [ "$SHOW_DIFF" = true ] && [ "$DIFFER_COUNT" -gt 0 ]; then + echo "================================================================================" + echo "Unified diffs for differing files:" + echo "================================================================================" + printf '%s' "$DIFFER_LIST" | while IFS= read -r f; do + if [ -n "$f" ] && [ "$f" != ".lastmerge" ] && [ "$f" != "README.md" ]; then + echo "" + echo "--- standalone/$f" + echo "+++ monorepo/java/$f" + diff -u "${STANDALONE}/${f}" "${MONO_JAVA}/${f}" || true + fi + done +fi + +# ── Optional README.md diff (paths differ between repos) ───────────── +if [ "$SHOW_DIFF" = true ] && [ "$README_STATUS" = "differ" ]; then + echo "" + echo "--- standalone/README.md" + echo "+++ monorepo/java/README.md" + diff -u "${STANDALONE}/README.md" "${MONO_JAVA}/README.md" || true +fi + +# ── Optional .lastmerge commit log comparison ──────────────────────── +if [ "$SHOW_DIFF" = true ] && [ "$LASTMERGE_STATUS" = "differ" ]; then + STANDALONE_HASH=$(cat "$STANDALONE_LASTMERGE" | tr -d '[:space:]') + MONO_HASH=$(cat "$MONO_LASTMERGE" | tr -d '[:space:]') + echo "" + echo "================================================================================" + echo ".lastmerge differs β€” commit log comparison in monorepo:" + echo "================================================================================" + echo "" + echo "--- standalone .lastmerge: ${STANDALONE_HASH}" + (cd "$MONOREPO" && git log --oneline -1 "$STANDALONE_HASH" 2>/dev/null) || echo " (commit not found in monorepo)" + echo "" + echo "+++ monorepo .lastmerge: ${MONO_HASH}" + (cd "$MONOREPO" && git log --oneline -1 "$MONO_HASH" 2>/dev/null) || echo " (commit not found in monorepo)" + echo "" + echo "Commits between standalone and monorepo .lastmerge:" + (cd "$MONOREPO" && git log --oneline "${STANDALONE_HASH}..${MONO_HASH}" 2>/dev/null) || echo " (unable to compute log range)" +fi + +if [ "$SHOW_DIFF" = true ] && [ "$MISSING_FROM_STANDALONE_COUNT" -gt 0 ]; then + echo "" + echo "================================================================================" + echo "Files only in monorepo (new files to port to standalone):" + echo "================================================================================" + printf '%s' "$MISSING_FROM_STANDALONE_LIST" | while IFS= read -r f; do + if [ -n "$f" ]; then + echo "" + echo "+++ monorepo/java/$f" + diff -u /dev/null "${MONO_JAVA}/${f}" || true + fi + done +fi + +if [ "$SHOW_DIFF" = true ] && [ "$MISSING_FROM_MONO_COUNT" -gt 0 ]; then + echo "" + echo "================================================================================" + echo "Files only in standalone (not present in monorepo):" + echo "================================================================================" + printf '%s' "$MISSING_FROM_MONO_LIST" | while IFS= read -r f; do + if [ -n "$f" ]; then + echo "" + echo "--- standalone/$f" + diff -u "${STANDALONE}/${f}" /dev/null || true + fi + done +fi diff --git a/src/generated/java/com/github/copilot/sdk/generated/AbortEvent.java b/src/generated/java/com/github/copilot/generated/AbortEvent.java similarity index 82% rename from src/generated/java/com/github/copilot/sdk/generated/AbortEvent.java rename to src/generated/java/com/github/copilot/generated/AbortEvent.java index d236f04f0b..e58922aa0d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AbortEvent.java +++ b/src/generated/java/com/github/copilot/generated/AbortEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code abort} session event. + * Session event "abort". Turn abort information including the reason for termination * * @since 1.0.0 */ @@ -35,8 +35,8 @@ public final class AbortEvent extends SessionEvent { @JsonIgnoreProperties(ignoreUnknown = true) @JsonInclude(JsonInclude.Include.NON_NULL) public record AbortEventData( - /** Reason the current turn was aborted (e.g., "user initiated") */ - @JsonProperty("reason") String reason + /** Finite reason code describing why the current turn was aborted */ + @JsonProperty("reason") AbortReason reason ) { } } diff --git a/src/generated/java/com/github/copilot/generated/AbortReason.java b/src/generated/java/com/github/copilot/generated/AbortReason.java new file mode 100644 index 0000000000..2ffbdb8d8c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/AbortReason.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Finite reason code describing why the current turn was aborted + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum AbortReason { + /** The {@code user_initiated} variant. */ + USER_INITIATED("user_initiated"), + /** The {@code remote_command} variant. */ + REMOTE_COMMAND("remote_command"), + /** The {@code user_abort} variant. */ + USER_ABORT("user_abort"); + + private final String value; + AbortReason(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static AbortReason fromValue(String value) { + for (AbortReason v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown AbortReason value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantIntentEvent.java b/src/generated/java/com/github/copilot/generated/AssistantIntentEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantIntentEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantIntentEvent.java index a1c22edfb1..49de4cda21 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantIntentEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantIntentEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.intent} session event. + * Session event "assistant.intent". Agent intent description for current activity or plan * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantMessageDeltaEvent.java b/src/generated/java/com/github/copilot/generated/AssistantMessageDeltaEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantMessageDeltaEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantMessageDeltaEvent.java index 128608a1e1..cdc0e3e26a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantMessageDeltaEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantMessageDeltaEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.message_delta} session event. + * Session event "assistant.message_delta". Streaming assistant message delta for incremental response updates * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantMessageEvent.java b/src/generated/java/com/github/copilot/generated/AssistantMessageEvent.java similarity index 73% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantMessageEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantMessageEvent.java index a6d75a8f65..de966758c3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantMessageEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantMessageEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.message} session event. + * Session event "assistant.message". Assistant response containing text content, optional tool requests, and interaction metadata * * @since 1.0.0 */ @@ -38,6 +38,8 @@ public final class AssistantMessageEvent extends SessionEvent { public record AssistantMessageEventData( /** Unique identifier for this assistant message */ @JsonProperty("messageId") String messageId, + /** Model that produced this assistant message, if known */ + @JsonProperty("model") String model, /** The assistant's text response content */ @JsonProperty("content") String content, /** Tool invocations requested by the assistant in this message */ @@ -51,11 +53,19 @@ public record AssistantMessageEventData( /** Generation phase for phased-output models (e.g., thinking vs. response phases) */ @JsonProperty("phase") String phase, /** Actual output token count from the API response (completion_tokens), used for accurate token accounting */ - @JsonProperty("outputTokens") Double outputTokens, + @JsonProperty("outputTokens") Long outputTokens, /** CAPI interaction ID for correlating this message with upstream telemetry */ @JsonProperty("interactionId") String interactionId, /** GitHub request tracing ID (x-github-request-id header) for correlating with server-side logs */ @JsonProperty("requestId") String requestId, + /** Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation */ + @JsonProperty("serviceRequestId") String serviceRequestId, + /** Raw Anthropic content array with advisor blocks (server_tool_use, advisor_tool_result) for verbatim round-tripping */ + @JsonProperty("anthropicAdvisorBlocks") List anthropicAdvisorBlocks, + /** Anthropic advisor model ID used for this response, for timeline display on replay */ + @JsonProperty("anthropicAdvisorModel") String anthropicAdvisorModel, + /** Identifier for the agent loop turn that produced this message, matching the corresponding assistant.turn_start event */ + @JsonProperty("turnId") String turnId, /** Tool call ID of the parent tool invocation when this event originates from a sub-agent */ @JsonProperty("parentToolCallId") String parentToolCallId ) { diff --git a/src/generated/java/com/github/copilot/generated/AssistantMessageStartEvent.java b/src/generated/java/com/github/copilot/generated/AssistantMessageStartEvent.java new file mode 100644 index 0000000000..f85e33b888 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/AssistantMessageStartEvent.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "assistant.message_start". Streaming assistant message start metadata + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class AssistantMessageStartEvent extends SessionEvent { + + @Override + public String getType() { return "assistant.message_start"; } + + @JsonProperty("data") + private AssistantMessageStartEventData data; + + public AssistantMessageStartEventData getData() { return data; } + public void setData(AssistantMessageStartEventData data) { this.data = data; } + + /** Data payload for {@link AssistantMessageStartEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record AssistantMessageStartEventData( + /** Message ID this start event belongs to, matching subsequent deltas and assistant.message */ + @JsonProperty("messageId") String messageId, + /** Generation phase this message belongs to for phased-output models */ + @JsonProperty("phase") String phase + ) { + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantMessageToolRequest.java b/src/generated/java/com/github/copilot/generated/AssistantMessageToolRequest.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantMessageToolRequest.java rename to src/generated/java/com/github/copilot/generated/AssistantMessageToolRequest.java index d45803b66a..2013734012 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantMessageToolRequest.java +++ b/src/generated/java/com/github/copilot/generated/AssistantMessageToolRequest.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -33,6 +33,8 @@ public record AssistantMessageToolRequest( @JsonProperty("toolTitle") String toolTitle, /** Name of the MCP server hosting this tool, when the tool is an MCP tool */ @JsonProperty("mcpServerName") String mcpServerName, + /** Original tool name on the MCP server, when the tool is an MCP tool */ + @JsonProperty("mcpToolName") String mcpToolName, /** Resolved intention summary describing what this specific call does */ @JsonProperty("intentionSummary") String intentionSummary ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantMessageToolRequestType.java b/src/generated/java/com/github/copilot/generated/AssistantMessageToolRequestType.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantMessageToolRequestType.java rename to src/generated/java/com/github/copilot/generated/AssistantMessageToolRequestType.java index 024b845d62..acf6df7b4f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantMessageToolRequestType.java +++ b/src/generated/java/com/github/copilot/generated/AssistantMessageToolRequestType.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantReasoningDeltaEvent.java b/src/generated/java/com/github/copilot/generated/AssistantReasoningDeltaEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantReasoningDeltaEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantReasoningDeltaEvent.java index 7c11ad59e7..f9d8b25b44 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantReasoningDeltaEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantReasoningDeltaEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.reasoning_delta} session event. + * Session event "assistant.reasoning_delta". Streaming reasoning delta for incremental extended thinking updates * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantReasoningEvent.java b/src/generated/java/com/github/copilot/generated/AssistantReasoningEvent.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantReasoningEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantReasoningEvent.java index 292b191b14..d84b400582 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantReasoningEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantReasoningEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.reasoning} session event. + * Session event "assistant.reasoning". Assistant reasoning content for timeline display with complete thinking text * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantStreamingDeltaEvent.java b/src/generated/java/com/github/copilot/generated/AssistantStreamingDeltaEvent.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantStreamingDeltaEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantStreamingDeltaEvent.java index 71ec8f4884..e5eae1897f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantStreamingDeltaEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantStreamingDeltaEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.streaming_delta} session event. + * Session event "assistant.streaming_delta". Streaming response progress with cumulative byte count * * @since 1.0.0 */ @@ -36,7 +36,7 @@ public final class AssistantStreamingDeltaEvent extends SessionEvent { @JsonInclude(JsonInclude.Include.NON_NULL) public record AssistantStreamingDeltaEventData( /** Cumulative total bytes received from the streaming response so far */ - @JsonProperty("totalResponseSizeBytes") Double totalResponseSizeBytes + @JsonProperty("totalResponseSizeBytes") Long totalResponseSizeBytes ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantTurnEndEvent.java b/src/generated/java/com/github/copilot/generated/AssistantTurnEndEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantTurnEndEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantTurnEndEvent.java index a8e0b16525..fa245915b6 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantTurnEndEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantTurnEndEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.turn_end} session event. + * Session event "assistant.turn_end". Turn completion metadata including the turn identifier * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantTurnStartEvent.java b/src/generated/java/com/github/copilot/generated/AssistantTurnStartEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantTurnStartEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantTurnStartEvent.java index 921623801d..f090117bf7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantTurnStartEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantTurnStartEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.turn_start} session event. + * Session event "assistant.turn_start". Turn initialization metadata including identifier and interaction tracking * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/AssistantUsageApiEndpoint.java b/src/generated/java/com/github/copilot/generated/AssistantUsageApiEndpoint.java new file mode 100644 index 0000000000..9f94c4a6e9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/AssistantUsageApiEndpoint.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * API endpoint used for this model call, matching CAPI supported_endpoints vocabulary + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum AssistantUsageApiEndpoint { + /** The {@code /chat/completions} variant. */ + CHAT_COMPLETIONS("/chat/completions"), + /** The {@code /v1/messages} variant. */ + V1_MESSAGES("/v1/messages"), + /** The {@code /responses} variant. */ + RESPONSES("/responses"), + /** The {@code ws:/responses} variant. */ + WS_RESPONSES("ws:/responses"); + + private final String value; + AssistantUsageApiEndpoint(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static AssistantUsageApiEndpoint fromValue(String value) { + for (AssistantUsageApiEndpoint v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown AssistantUsageApiEndpoint value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantUsageCopilotUsage.java b/src/generated/java/com/github/copilot/generated/AssistantUsageCopilotUsage.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantUsageCopilotUsage.java rename to src/generated/java/com/github/copilot/generated/AssistantUsageCopilotUsage.java index 4bb8aa92c6..e9db8a530d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantUsageCopilotUsage.java +++ b/src/generated/java/com/github/copilot/generated/AssistantUsageCopilotUsage.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -24,7 +24,7 @@ public record AssistantUsageCopilotUsage( /** Itemized token usage breakdown */ @JsonProperty("tokenDetails") List tokenDetails, - /** Total cost in nano-AIU (AI Units) for this request */ + /** Total cost in nano-AI units for this request */ @JsonProperty("totalNanoAiu") Double totalNanoAiu ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantUsageCopilotUsageTokenDetail.java b/src/generated/java/com/github/copilot/generated/AssistantUsageCopilotUsageTokenDetail.java similarity index 84% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantUsageCopilotUsageTokenDetail.java rename to src/generated/java/com/github/copilot/generated/AssistantUsageCopilotUsageTokenDetail.java index 895f19030f..9354568c7c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantUsageCopilotUsageTokenDetail.java +++ b/src/generated/java/com/github/copilot/generated/AssistantUsageCopilotUsageTokenDetail.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -22,11 +22,11 @@ @JsonIgnoreProperties(ignoreUnknown = true) public record AssistantUsageCopilotUsageTokenDetail( /** Number of tokens in this billing batch */ - @JsonProperty("batchSize") Double batchSize, + @JsonProperty("batchSize") Long batchSize, /** Cost per batch of tokens */ - @JsonProperty("costPerBatch") Double costPerBatch, + @JsonProperty("costPerBatch") Long costPerBatch, /** Total token count for this entry */ - @JsonProperty("tokenCount") Double tokenCount, + @JsonProperty("tokenCount") Long tokenCount, /** Token category (e.g., "input", "output") */ @JsonProperty("tokenType") String tokenType ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantUsageEvent.java b/src/generated/java/com/github/copilot/generated/AssistantUsageEvent.java similarity index 76% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantUsageEvent.java rename to src/generated/java/com/github/copilot/generated/AssistantUsageEvent.java index 4613d520e7..2c19c150b2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantUsageEvent.java +++ b/src/generated/java/com/github/copilot/generated/AssistantUsageEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code assistant.usage} session event. + * Session event "assistant.usage". LLM API call usage metrics including tokens, costs, quotas, and billing information * * @since 1.0.0 */ @@ -39,21 +39,21 @@ public record AssistantUsageEventData( /** Model identifier used for this API call */ @JsonProperty("model") String model, /** Number of input tokens consumed */ - @JsonProperty("inputTokens") Double inputTokens, + @JsonProperty("inputTokens") Long inputTokens, /** Number of output tokens produced */ - @JsonProperty("outputTokens") Double outputTokens, + @JsonProperty("outputTokens") Long outputTokens, /** Number of tokens read from prompt cache */ - @JsonProperty("cacheReadTokens") Double cacheReadTokens, + @JsonProperty("cacheReadTokens") Long cacheReadTokens, /** Number of tokens written to prompt cache */ - @JsonProperty("cacheWriteTokens") Double cacheWriteTokens, + @JsonProperty("cacheWriteTokens") Long cacheWriteTokens, /** Number of output tokens used for reasoning (e.g., chain-of-thought) */ - @JsonProperty("reasoningTokens") Double reasoningTokens, + @JsonProperty("reasoningTokens") Long reasoningTokens, /** Model multiplier cost for billing purposes */ @JsonProperty("cost") Double cost, /** Duration of the API call in milliseconds */ - @JsonProperty("duration") Double duration, + @JsonProperty("duration") Long duration, /** Time to first token in milliseconds. Only available for streaming requests */ - @JsonProperty("ttftMs") Double ttftMs, + @JsonProperty("timeToFirstTokenMs") Long timeToFirstTokenMs, /** Average inter-token latency in milliseconds. Only available for streaming requests */ @JsonProperty("interTokenLatencyMs") Double interTokenLatencyMs, /** What initiated this API call (e.g., "sub-agent", "mcp-sampling"); absent for user-initiated calls */ @@ -62,13 +62,17 @@ public record AssistantUsageEventData( @JsonProperty("apiCallId") String apiCallId, /** GitHub request tracing ID (x-github-request-id header) for server-side log correlation */ @JsonProperty("providerCallId") String providerCallId, + /** Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation */ + @JsonProperty("serviceRequestId") String serviceRequestId, + /** API endpoint used for this model call, matching CAPI supported_endpoints vocabulary */ + @JsonProperty("apiEndpoint") AssistantUsageApiEndpoint apiEndpoint, /** Parent tool call ID when this usage originates from a sub-agent */ @JsonProperty("parentToolCallId") String parentToolCallId, /** Per-quota resource usage snapshots, keyed by quota identifier */ @JsonProperty("quotaSnapshots") Map quotaSnapshots, /** Per-request cost and usage data from the CAPI copilot_usage response field */ @JsonProperty("copilotUsage") AssistantUsageCopilotUsage copilotUsage, - /** Reasoning effort level used for model calls, if applicable (e.g. "low", "medium", "high", "xhigh") */ + /** Reasoning effort level used for model calls, if applicable (e.g. "none", "low", "medium", "high", "xhigh", "max") */ @JsonProperty("reasoningEffort") String reasoningEffort ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/AssistantUsageQuotaSnapshot.java b/src/generated/java/com/github/copilot/generated/AssistantUsageQuotaSnapshot.java similarity index 77% rename from src/generated/java/com/github/copilot/sdk/generated/AssistantUsageQuotaSnapshot.java rename to src/generated/java/com/github/copilot/generated/AssistantUsageQuotaSnapshot.java index 0986f67d71..167f420408 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AssistantUsageQuotaSnapshot.java +++ b/src/generated/java/com/github/copilot/generated/AssistantUsageQuotaSnapshot.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,6 +13,11 @@ import java.time.OffsetDateTime; import javax.annotation.processing.Generated; +/** + * Schema for the `AssistantUsageQuotaSnapshot` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) @@ -20,16 +25,16 @@ public record AssistantUsageQuotaSnapshot( /** Whether the user has an unlimited usage entitlement */ @JsonProperty("isUnlimitedEntitlement") Boolean isUnlimitedEntitlement, /** Total requests allowed by the entitlement */ - @JsonProperty("entitlementRequests") Double entitlementRequests, + @JsonProperty("entitlementRequests") Long entitlementRequests, /** Number of requests already consumed */ - @JsonProperty("usedRequests") Double usedRequests, + @JsonProperty("usedRequests") Long usedRequests, /** Whether usage is still permitted after quota exhaustion */ @JsonProperty("usageAllowedWithExhaustedQuota") Boolean usageAllowedWithExhaustedQuota, - /** Number of requests over the entitlement limit */ + /** Number of additional usage requests made this period */ @JsonProperty("overage") Double overage, - /** Whether overage is allowed when quota is exhausted */ + /** Whether additional usage is allowed when quota is exhausted */ @JsonProperty("overageAllowedWithExhaustedQuota") Boolean overageAllowedWithExhaustedQuota, - /** Percentage of quota remaining (0.0 to 1.0) */ + /** Percentage of quota remaining (0 to 100) */ @JsonProperty("remainingPercentage") Double remainingPercentage, /** Date when the quota resets */ @JsonProperty("resetDate") OffsetDateTime resetDate diff --git a/src/generated/java/com/github/copilot/sdk/generated/AutoModeSwitchCompletedEvent.java b/src/generated/java/com/github/copilot/generated/AutoModeSwitchCompletedEvent.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/AutoModeSwitchCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/AutoModeSwitchCompletedEvent.java index a6d994d6b8..76a35dbb7d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AutoModeSwitchCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/AutoModeSwitchCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code auto_mode_switch.completed} session event. + * Session event "auto_mode_switch.completed". Auto mode switch completion notification * * @since 1.0.0 */ @@ -37,8 +37,8 @@ public final class AutoModeSwitchCompletedEvent extends SessionEvent { public record AutoModeSwitchCompletedEventData( /** Request ID of the resolved request; clients should dismiss any UI for this request */ @JsonProperty("requestId") String requestId, - /** The user's choice: 'yes', 'yes_always', or 'no' */ - @JsonProperty("response") String response + /** The user's auto-mode-switch choice */ + @JsonProperty("response") AutoModeSwitchResponse response ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/AutoModeSwitchRequestedEvent.java b/src/generated/java/com/github/copilot/generated/AutoModeSwitchRequestedEvent.java similarity index 80% rename from src/generated/java/com/github/copilot/sdk/generated/AutoModeSwitchRequestedEvent.java rename to src/generated/java/com/github/copilot/generated/AutoModeSwitchRequestedEvent.java index 8ad1a2da82..79fc5c3169 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/AutoModeSwitchRequestedEvent.java +++ b/src/generated/java/com/github/copilot/generated/AutoModeSwitchRequestedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code auto_mode_switch.requested} session event. + * Session event "auto_mode_switch.requested". Auto mode switch request notification requiring user approval * * @since 1.0.0 */ @@ -38,7 +38,9 @@ public record AutoModeSwitchRequestedEventData( /** Unique identifier for this request; used to respond via session.respondToAutoModeSwitch() */ @JsonProperty("requestId") String requestId, /** The rate limit error code that triggered this request */ - @JsonProperty("errorCode") String errorCode + @JsonProperty("errorCode") String errorCode, + /** Seconds until the rate limit resets, when known. Lets clients render a humanized reset time alongside the prompt. */ + @JsonProperty("retryAfterSeconds") Long retryAfterSeconds ) { } } diff --git a/src/generated/java/com/github/copilot/generated/AutoModeSwitchResponse.java b/src/generated/java/com/github/copilot/generated/AutoModeSwitchResponse.java new file mode 100644 index 0000000000..46745b66e8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/AutoModeSwitchResponse.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * The user's auto-mode-switch choice + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum AutoModeSwitchResponse { + /** The {@code yes} variant. */ + YES("yes"), + /** The {@code yes_always} variant. */ + YES_ALWAYS("yes_always"), + /** The {@code no} variant. */ + NO("no"); + + private final String value; + AutoModeSwitchResponse(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static AutoModeSwitchResponse fromValue(String value) { + for (AutoModeSwitchResponse v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown AutoModeSwitchResponse value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/AutopilotObjectiveChangedOperation.java b/src/generated/java/com/github/copilot/generated/AutopilotObjectiveChangedOperation.java new file mode 100644 index 0000000000..9a6211d491 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/AutopilotObjectiveChangedOperation.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * The type of operation performed on the autopilot objective state file + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum AutopilotObjectiveChangedOperation { + /** The {@code create} variant. */ + CREATE("create"), + /** The {@code update} variant. */ + UPDATE("update"), + /** The {@code delete} variant. */ + DELETE("delete"); + + private final String value; + AutopilotObjectiveChangedOperation(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static AutopilotObjectiveChangedOperation fromValue(String value) { + for (AutopilotObjectiveChangedOperation v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown AutopilotObjectiveChangedOperation value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/AutopilotObjectiveChangedStatus.java b/src/generated/java/com/github/copilot/generated/AutopilotObjectiveChangedStatus.java new file mode 100644 index 0000000000..c8b4187f7c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/AutopilotObjectiveChangedStatus.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Current autopilot objective status, if one exists + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum AutopilotObjectiveChangedStatus { + /** The {@code active} variant. */ + ACTIVE("active"), + /** The {@code paused} variant. */ + PAUSED("paused"), + /** The {@code cap_reached} variant. */ + CAP_REACHED("cap_reached"), + /** The {@code completed} variant. */ + COMPLETED("completed"); + + private final String value; + AutopilotObjectiveChangedStatus(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static AutopilotObjectiveChangedStatus fromValue(String value) { + for (AutopilotObjectiveChangedStatus v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown AutopilotObjectiveChangedStatus value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/CanvasOpenedAvailability.java b/src/generated/java/com/github/copilot/generated/CanvasOpenedAvailability.java new file mode 100644 index 0000000000..1e65c1a2de --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/CanvasOpenedAvailability.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Runtime-controlled routing state for the instance. "ready" when the provider connection is live; "stale" when the provider has gone away and the instance is awaiting rebinding. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum CanvasOpenedAvailability { + /** The {@code ready} variant. */ + READY("ready"), + /** The {@code stale} variant. */ + STALE("stale"); + + private final String value; + CanvasOpenedAvailability(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static CanvasOpenedAvailability fromValue(String value) { + for (CanvasOpenedAvailability v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown CanvasOpenedAvailability value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/CanvasRegistryChangedCanvas.java b/src/generated/java/com/github/copilot/generated/CanvasRegistryChangedCanvas.java new file mode 100644 index 0000000000..17d1477c11 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/CanvasRegistryChangedCanvas.java @@ -0,0 +1,41 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Schema for the `CanvasRegistryChangedCanvas` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasRegistryChangedCanvas( + /** Owning provider identifier */ + @JsonProperty("extensionId") String extensionId, + /** Owning extension display name, when available */ + @JsonProperty("extensionName") String extensionName, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId, + /** Human-readable canvas name */ + @JsonProperty("displayName") String displayName, + /** Short, single-sentence description shown to the agent in canvas catalogs. */ + @JsonProperty("description") String description, + /** JSON Schema for canvas open input */ + @JsonProperty("inputSchema") Map inputSchema, + /** Actions the agent or host may invoke */ + @JsonProperty("actions") List actions +) { +} diff --git a/src/generated/java/com/github/copilot/generated/CanvasRegistryChangedCanvasAction.java b/src/generated/java/com/github/copilot/generated/CanvasRegistryChangedCanvasAction.java new file mode 100644 index 0000000000..34e30d3f24 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/CanvasRegistryChangedCanvasAction.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Schema for the `CanvasRegistryChangedCanvasAction` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasRegistryChangedCanvasAction( + /** Action name */ + @JsonProperty("name") String name, + /** Action description */ + @JsonProperty("description") String description, + /** JSON Schema for action input */ + @JsonProperty("inputSchema") Map inputSchema +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/CapabilitiesChangedEvent.java b/src/generated/java/com/github/copilot/generated/CapabilitiesChangedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/CapabilitiesChangedEvent.java rename to src/generated/java/com/github/copilot/generated/CapabilitiesChangedEvent.java index 6ee7768fbb..8f0d0809f0 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CapabilitiesChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/CapabilitiesChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code capabilities.changed} session event. + * Session event "capabilities.changed". Session capability change notification * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/CapabilitiesChangedUI.java b/src/generated/java/com/github/copilot/generated/CapabilitiesChangedUI.java new file mode 100644 index 0000000000..83be6ad092 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/CapabilitiesChangedUI.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * UI capability changes + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CapabilitiesChangedUI( + /** Whether elicitation is now supported */ + @JsonProperty("elicitation") Boolean elicitation, + /** Whether MCP Apps (SEP-1865) UI passthrough is now supported */ + @JsonProperty("mcpApps") Boolean mcpApps, + /** Whether canvas rendering is now supported */ + @JsonProperty("canvases") Boolean canvases +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/CommandCompletedEvent.java b/src/generated/java/com/github/copilot/generated/CommandCompletedEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/CommandCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/CommandCompletedEvent.java index d2075f09d3..a334edbb19 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CommandCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/CommandCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code command.completed} session event. + * Session event "command.completed". Queued command completion notification signaling UI dismissal * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/CommandExecuteEvent.java b/src/generated/java/com/github/copilot/generated/CommandExecuteEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/CommandExecuteEvent.java rename to src/generated/java/com/github/copilot/generated/CommandExecuteEvent.java index a9b0608dba..efd840bbd3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CommandExecuteEvent.java +++ b/src/generated/java/com/github/copilot/generated/CommandExecuteEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code command.execute} session event. + * Session event "command.execute". Registered command dispatch request routed to the owning client * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/CommandQueuedEvent.java b/src/generated/java/com/github/copilot/generated/CommandQueuedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/CommandQueuedEvent.java rename to src/generated/java/com/github/copilot/generated/CommandQueuedEvent.java index 6599f4da64..518248aa93 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CommandQueuedEvent.java +++ b/src/generated/java/com/github/copilot/generated/CommandQueuedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code command.queued} session event. + * Session event "command.queued". Queued slash command dispatch request for client execution * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/CommandsChangedCommand.java b/src/generated/java/com/github/copilot/generated/CommandsChangedCommand.java similarity index 78% rename from src/generated/java/com/github/copilot/sdk/generated/CommandsChangedCommand.java rename to src/generated/java/com/github/copilot/generated/CommandsChangedCommand.java index 30c8e99627..383f141fcb 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CommandsChangedCommand.java +++ b/src/generated/java/com/github/copilot/generated/CommandsChangedCommand.java @@ -5,18 +5,25 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `CommandsChangedCommand` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record CommandsChangedCommand( + /** Slash command name without the leading slash. */ @JsonProperty("name") String name, + /** Optional human-readable command description. */ @JsonProperty("description") String description ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/CommandsChangedEvent.java b/src/generated/java/com/github/copilot/generated/CommandsChangedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/CommandsChangedEvent.java rename to src/generated/java/com/github/copilot/generated/CommandsChangedEvent.java index 48576c314a..a3f8fba190 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CommandsChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/CommandsChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code commands.changed} session event. + * Session event "commands.changed". SDK command registration change notification * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsed.java b/src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsed.java similarity index 82% rename from src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsed.java rename to src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsed.java index 4409793920..ed454deafd 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsed.java +++ b/src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsed.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -22,17 +22,17 @@ @JsonIgnoreProperties(ignoreUnknown = true) public record CompactionCompleteCompactionTokensUsed( /** Input tokens consumed by the compaction LLM call */ - @JsonProperty("inputTokens") Double inputTokens, + @JsonProperty("inputTokens") Long inputTokens, /** Output tokens produced by the compaction LLM call */ - @JsonProperty("outputTokens") Double outputTokens, + @JsonProperty("outputTokens") Long outputTokens, /** Cached input tokens reused in the compaction LLM call */ - @JsonProperty("cacheReadTokens") Double cacheReadTokens, + @JsonProperty("cacheReadTokens") Long cacheReadTokens, /** Tokens written to prompt cache in the compaction LLM call */ - @JsonProperty("cacheWriteTokens") Double cacheWriteTokens, + @JsonProperty("cacheWriteTokens") Long cacheWriteTokens, /** Per-request cost and usage data from the CAPI copilot_usage response field */ @JsonProperty("copilotUsage") CompactionCompleteCompactionTokensUsedCopilotUsage copilotUsage, /** Duration of the compaction LLM call in milliseconds */ - @JsonProperty("duration") Double duration, + @JsonProperty("duration") Long duration, /** Model identifier used for the compaction LLM call */ @JsonProperty("model") String model ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsedCopilotUsage.java b/src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsedCopilotUsage.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsedCopilotUsage.java rename to src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsedCopilotUsage.java index 7e02e4f778..886229cc69 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsedCopilotUsage.java +++ b/src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsedCopilotUsage.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -24,7 +24,7 @@ public record CompactionCompleteCompactionTokensUsedCopilotUsage( /** Itemized token usage breakdown */ @JsonProperty("tokenDetails") List tokenDetails, - /** Total cost in nano-AIU (AI Units) for this request */ + /** Total cost in nano-AI units for this request */ @JsonProperty("totalNanoAiu") Double totalNanoAiu ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail.java b/src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail.java similarity index 84% rename from src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail.java rename to src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail.java index 3c7fde8ad8..83209f94c8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail.java +++ b/src/generated/java/com/github/copilot/generated/CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -22,11 +22,11 @@ @JsonIgnoreProperties(ignoreUnknown = true) public record CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail( /** Number of tokens in this billing batch */ - @JsonProperty("batchSize") Double batchSize, + @JsonProperty("batchSize") Long batchSize, /** Cost per batch of tokens */ - @JsonProperty("costPerBatch") Double costPerBatch, + @JsonProperty("costPerBatch") Long costPerBatch, /** Total token count for this entry */ - @JsonProperty("tokenCount") Double tokenCount, + @JsonProperty("tokenCount") Long tokenCount, /** Token category (e.g., "input", "output") */ @JsonProperty("tokenType") String tokenType ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/CustomAgentsUpdatedAgent.java b/src/generated/java/com/github/copilot/generated/CustomAgentsUpdatedAgent.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/CustomAgentsUpdatedAgent.java rename to src/generated/java/com/github/copilot/generated/CustomAgentsUpdatedAgent.java index 74637aaa82..642be86944 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CustomAgentsUpdatedAgent.java +++ b/src/generated/java/com/github/copilot/generated/CustomAgentsUpdatedAgent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,6 +13,11 @@ import java.util.List; import javax.annotation.processing.Generated; +/** + * Schema for the `CustomAgentsUpdatedAgent` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) @@ -27,7 +32,7 @@ public record CustomAgentsUpdatedAgent( @JsonProperty("description") String description, /** Source location: user, project, inherited, remote, or plugin */ @JsonProperty("source") String source, - /** List of tool names available to this agent */ + /** List of tool names available to this agent, or null when all tools are available */ @JsonProperty("tools") List tools, /** Whether the agent can be selected by the user */ @JsonProperty("userInvocable") Boolean userInvocable, diff --git a/src/generated/java/com/github/copilot/sdk/generated/ElicitationCompletedAction.java b/src/generated/java/com/github/copilot/generated/ElicitationCompletedAction.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/ElicitationCompletedAction.java rename to src/generated/java/com/github/copilot/generated/ElicitationCompletedAction.java index 32e4723e58..cc6026f259 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ElicitationCompletedAction.java +++ b/src/generated/java/com/github/copilot/generated/ElicitationCompletedAction.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/ElicitationCompletedEvent.java b/src/generated/java/com/github/copilot/generated/ElicitationCompletedEvent.java similarity index 93% rename from src/generated/java/com/github/copilot/sdk/generated/ElicitationCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/ElicitationCompletedEvent.java index ae94b6bf31..454cc43a0c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ElicitationCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/ElicitationCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code elicitation.completed} session event. + * Session event "elicitation.completed". Elicitation request completion with the user's response * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedEvent.java b/src/generated/java/com/github/copilot/generated/ElicitationRequestedEvent.java similarity index 93% rename from src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedEvent.java rename to src/generated/java/com/github/copilot/generated/ElicitationRequestedEvent.java index fd5773df6f..6c8aa2547d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedEvent.java +++ b/src/generated/java/com/github/copilot/generated/ElicitationRequestedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code elicitation.requested} session event. + * Session event "elicitation.requested". Elicitation request; may be form-based (structured input) or URL-based (browser redirect) * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedMode.java b/src/generated/java/com/github/copilot/generated/ElicitationRequestedMode.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedMode.java rename to src/generated/java/com/github/copilot/generated/ElicitationRequestedMode.java index ffe24b56fa..49538450d4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedMode.java +++ b/src/generated/java/com/github/copilot/generated/ElicitationRequestedMode.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedSchema.java b/src/generated/java/com/github/copilot/generated/ElicitationRequestedSchema.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedSchema.java rename to src/generated/java/com/github/copilot/generated/ElicitationRequestedSchema.java index 4234867adc..d6ad62b4b0 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ElicitationRequestedSchema.java +++ b/src/generated/java/com/github/copilot/generated/ElicitationRequestedSchema.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/ExitPlanModeAction.java b/src/generated/java/com/github/copilot/generated/ExitPlanModeAction.java new file mode 100644 index 0000000000..6d86641414 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ExitPlanModeAction.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Exit plan mode action + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ExitPlanModeAction { + /** The {@code exit_only} variant. */ + EXIT_ONLY("exit_only"), + /** The {@code interactive} variant. */ + INTERACTIVE("interactive"), + /** The {@code autopilot} variant. */ + AUTOPILOT("autopilot"), + /** The {@code autopilot_fleet} variant. */ + AUTOPILOT_FLEET("autopilot_fleet"); + + private final String value; + ExitPlanModeAction(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ExitPlanModeAction fromValue(String value) { + for (ExitPlanModeAction v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ExitPlanModeAction value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/ExitPlanModeCompletedEvent.java b/src/generated/java/com/github/copilot/generated/ExitPlanModeCompletedEvent.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/ExitPlanModeCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/ExitPlanModeCompletedEvent.java index 56c2c66813..6056a570e4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ExitPlanModeCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/ExitPlanModeCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code exit_plan_mode.completed} session event. + * Session event "exit_plan_mode.completed". Plan mode exit completion with the user's approval decision and optional feedback * * @since 1.0.0 */ @@ -39,8 +39,8 @@ public record ExitPlanModeCompletedEventData( @JsonProperty("requestId") String requestId, /** Whether the plan was approved by the user */ @JsonProperty("approved") Boolean approved, - /** Which action the user selected (e.g. 'autopilot', 'interactive', 'exit_only') */ - @JsonProperty("selectedAction") String selectedAction, + /** Action selected by the user */ + @JsonProperty("selectedAction") ExitPlanModeAction selectedAction, /** Whether edits should be auto-approved without confirmation */ @JsonProperty("autoApproveEdits") Boolean autoApproveEdits, /** Free-form feedback from the user if they requested changes to the plan */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/ExitPlanModeRequestedEvent.java b/src/generated/java/com/github/copilot/generated/ExitPlanModeRequestedEvent.java similarity index 80% rename from src/generated/java/com/github/copilot/sdk/generated/ExitPlanModeRequestedEvent.java rename to src/generated/java/com/github/copilot/generated/ExitPlanModeRequestedEvent.java index de2bf45a84..134e01cbb9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ExitPlanModeRequestedEvent.java +++ b/src/generated/java/com/github/copilot/generated/ExitPlanModeRequestedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code exit_plan_mode.requested} session event. + * Session event "exit_plan_mode.requested". Plan approval request with plan content and available user actions * * @since 1.0.0 */ @@ -42,10 +42,10 @@ public record ExitPlanModeRequestedEventData( @JsonProperty("summary") String summary, /** Full content of the plan file */ @JsonProperty("planContent") String planContent, - /** Available actions the user can take (e.g., approve, edit, reject) */ - @JsonProperty("actions") List actions, - /** The recommended action for the user to take */ - @JsonProperty("recommendedAction") String recommendedAction + /** Available actions the user can take */ + @JsonProperty("actions") List actions, + /** Recommended action to preselect for the user */ + @JsonProperty("recommendedAction") ExitPlanModeAction recommendedAction ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtension.java b/src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtension.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtension.java rename to src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtension.java index 366ea550cd..b47f308c8e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtension.java +++ b/src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtension.java @@ -5,13 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `ExtensionsLoadedExtension` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) diff --git a/src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtensionSource.java b/src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtensionSource.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtensionSource.java rename to src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtensionSource.java index d6409caf45..abf991a01a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtensionSource.java +++ b/src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtensionSource.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtensionStatus.java b/src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtensionStatus.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtensionStatus.java rename to src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtensionStatus.java index a4ef8de991..8f8ca0b65c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ExtensionsLoadedExtensionStatus.java +++ b/src/generated/java/com/github/copilot/generated/ExtensionsLoadedExtensionStatus.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/ExternalToolCompletedEvent.java b/src/generated/java/com/github/copilot/generated/ExternalToolCompletedEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/ExternalToolCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/ExternalToolCompletedEvent.java index e9526c6faf..cfd9828e70 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ExternalToolCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/ExternalToolCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code external_tool.completed} session event. + * Session event "external_tool.completed". External tool completion notification signaling UI dismissal * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/ExternalToolRequestedEvent.java b/src/generated/java/com/github/copilot/generated/ExternalToolRequestedEvent.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/ExternalToolRequestedEvent.java rename to src/generated/java/com/github/copilot/generated/ExternalToolRequestedEvent.java index 8e646c1a5c..39eacd44f2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ExternalToolRequestedEvent.java +++ b/src/generated/java/com/github/copilot/generated/ExternalToolRequestedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code external_tool.requested} session event. + * Session event "external_tool.requested". External tool invocation request for client-side tool execution * * @since 1.0.0 */ @@ -45,6 +45,8 @@ public record ExternalToolRequestedEventData( @JsonProperty("toolName") String toolName, /** Arguments to pass to the external tool */ @JsonProperty("arguments") Object arguments, + /** Active session working directory, when known. */ + @JsonProperty("workingDirectory") String workingDirectory, /** W3C Trace Context traceparent header for the execute_tool span */ @JsonProperty("traceparent") String traceparent, /** W3C Trace Context tracestate header for the execute_tool span */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/HandoffRepository.java b/src/generated/java/com/github/copilot/generated/HandoffRepository.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/HandoffRepository.java rename to src/generated/java/com/github/copilot/generated/HandoffRepository.java index a87002c9e3..e54226a8b3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/HandoffRepository.java +++ b/src/generated/java/com/github/copilot/generated/HandoffRepository.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/HandoffSourceType.java b/src/generated/java/com/github/copilot/generated/HandoffSourceType.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/HandoffSourceType.java rename to src/generated/java/com/github/copilot/generated/HandoffSourceType.java index 06f39c214e..83d6677825 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/HandoffSourceType.java +++ b/src/generated/java/com/github/copilot/generated/HandoffSourceType.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/HookEndError.java b/src/generated/java/com/github/copilot/generated/HookEndError.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/HookEndError.java rename to src/generated/java/com/github/copilot/generated/HookEndError.java index bbf992536a..59646b3cc1 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/HookEndError.java +++ b/src/generated/java/com/github/copilot/generated/HookEndError.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/HookEndEvent.java b/src/generated/java/com/github/copilot/generated/HookEndEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/HookEndEvent.java rename to src/generated/java/com/github/copilot/generated/HookEndEvent.java index c2a80b0f3d..1b90f5fa9e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/HookEndEvent.java +++ b/src/generated/java/com/github/copilot/generated/HookEndEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code hook.end} session event. + * Session event "hook.end". Hook invocation completion details including output, success status, and error information * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/HookProgressEvent.java b/src/generated/java/com/github/copilot/generated/HookProgressEvent.java new file mode 100644 index 0000000000..4ea3bd2eaf --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/HookProgressEvent.java @@ -0,0 +1,42 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "hook.progress". Ephemeral progress update from a running hook process + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class HookProgressEvent extends SessionEvent { + + @Override + public String getType() { return "hook.progress"; } + + @JsonProperty("data") + private HookProgressEventData data; + + public HookProgressEventData getData() { return data; } + public void setData(HookProgressEventData data) { this.data = data; } + + /** Data payload for {@link HookProgressEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record HookProgressEventData( + /** Human-readable progress message from the hook process */ + @JsonProperty("message") String message + ) { + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/HookStartEvent.java b/src/generated/java/com/github/copilot/generated/HookStartEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/HookStartEvent.java rename to src/generated/java/com/github/copilot/generated/HookStartEvent.java index ffca1dfe0b..f4605ce257 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/HookStartEvent.java +++ b/src/generated/java/com/github/copilot/generated/HookStartEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code hook.start} session event. + * Session event "hook.start". Hook invocation start details including type and input data * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteError.java b/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteError.java new file mode 100644 index 0000000000..d718d3377e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteError.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Set when the underlying tools/call threw an error before returning a CallToolResult + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpAppToolCallCompleteError( + /** Human-readable error message */ + @JsonProperty("message") String message +) { +} diff --git a/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteEvent.java b/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteEvent.java new file mode 100644 index 0000000000..ea4f517c46 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteEvent.java @@ -0,0 +1,57 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Session event "mcp_app.tool_call_complete". MCP App view called a tool on a connected MCP server (SEP-1865) + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpAppToolCallCompleteEvent extends SessionEvent { + + @Override + public String getType() { return "mcp_app.tool_call_complete"; } + + @JsonProperty("data") + private McpAppToolCallCompleteEventData data; + + public McpAppToolCallCompleteEventData getData() { return data; } + public void setData(McpAppToolCallCompleteEventData data) { this.data = data; } + + /** Data payload for {@link McpAppToolCallCompleteEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record McpAppToolCallCompleteEventData( + /** Name of the MCP server hosting the tool */ + @JsonProperty("serverName") String serverName, + /** MCP tool name that was invoked */ + @JsonProperty("toolName") String toolName, + /** Arguments passed to the tool by the app view, if any */ + @JsonProperty("arguments") Map arguments, + /** True when the call completed without throwing AND the MCP CallToolResult did not set isError */ + @JsonProperty("success") Boolean success, + /** Wall-clock duration of the underlying tools/call in milliseconds */ + @JsonProperty("durationMs") Double durationMs, + /** Standard MCP CallToolResult returned by the server. Present whether or not the call set isError. */ + @JsonProperty("result") Map result, + /** Set when the underlying tools/call threw an error before returning a CallToolResult */ + @JsonProperty("error") McpAppToolCallCompleteError error, + /** The tool's `_meta.ui` block at the time of the call, so consumers can decide whether to forward the result to the model without re-listing tools. */ + @JsonProperty("toolMeta") McpAppToolCallCompleteToolMeta toolMeta + ) { + } +} diff --git a/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteToolMeta.java b/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteToolMeta.java new file mode 100644 index 0000000000..33b9a3725b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteToolMeta.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The tool's `_meta.ui` block at the time of the call, so consumers can decide whether to forward the result to the model without re-listing tools. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpAppToolCallCompleteToolMeta( + /** Schema for the `McpAppToolCallCompleteToolMetaUI` type. */ + @JsonProperty("ui") McpAppToolCallCompleteToolMetaUI ui +) { +} diff --git a/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteToolMetaUI.java b/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteToolMetaUI.java new file mode 100644 index 0000000000..eb960434ad --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/McpAppToolCallCompleteToolMetaUI.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Schema for the `McpAppToolCallCompleteToolMetaUI` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpAppToolCallCompleteToolMetaUI( + /** `ui://` URI declared by the tool's `_meta.ui.resourceUri` */ + @JsonProperty("resourceUri") String resourceUri, + /** Tool visibility per SEP-1865 (typically a subset of `["model","app"]`) */ + @JsonProperty("visibility") List visibility +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/McpOauthCompletedEvent.java b/src/generated/java/com/github/copilot/generated/McpOauthCompletedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/McpOauthCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/McpOauthCompletedEvent.java index 3d410bf2d2..f02c7d42a2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/McpOauthCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/McpOauthCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code mcp.oauth_completed} session event. + * Session event "mcp.oauth_completed". MCP OAuth request completion notification * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/McpOauthRequiredEvent.java b/src/generated/java/com/github/copilot/generated/McpOauthRequiredEvent.java similarity index 93% rename from src/generated/java/com/github/copilot/sdk/generated/McpOauthRequiredEvent.java rename to src/generated/java/com/github/copilot/generated/McpOauthRequiredEvent.java index c7ef7a12af..c384afcf01 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/McpOauthRequiredEvent.java +++ b/src/generated/java/com/github/copilot/generated/McpOauthRequiredEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code mcp.oauth_required} session event. + * Session event "mcp.oauth_required". OAuth authentication request for an MCP server * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/McpOauthRequiredStaticClientConfig.java b/src/generated/java/com/github/copilot/generated/McpOauthRequiredStaticClientConfig.java similarity index 74% rename from src/generated/java/com/github/copilot/sdk/generated/McpOauthRequiredStaticClientConfig.java rename to src/generated/java/com/github/copilot/generated/McpOauthRequiredStaticClientConfig.java index b8c0dd93d5..764f8b7fc8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/McpOauthRequiredStaticClientConfig.java +++ b/src/generated/java/com/github/copilot/generated/McpOauthRequiredStaticClientConfig.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -24,6 +24,8 @@ public record McpOauthRequiredStaticClientConfig( /** OAuth client ID for the server */ @JsonProperty("clientId") String clientId, /** Whether this is a public OAuth client */ - @JsonProperty("publicClient") Boolean publicClient + @JsonProperty("publicClient") Boolean publicClient, + /** Optional non-default OAuth grant type. When set to 'client_credentials', the OAuth flow runs headlessly using the client_id + keychain-stored secret (no browser, no callback server). */ + @JsonProperty("grantType") String grantType ) { } diff --git a/src/generated/java/com/github/copilot/generated/McpServerSource.java b/src/generated/java/com/github/copilot/generated/McpServerSource.java new file mode 100644 index 0000000000..63514743ab --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/McpServerSource.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Configuration source: user, workspace, plugin, or builtin + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpServerSource { + /** The {@code user} variant. */ + USER("user"), + /** The {@code workspace} variant. */ + WORKSPACE("workspace"), + /** The {@code plugin} variant. */ + PLUGIN("plugin"), + /** The {@code builtin} variant. */ + BUILTIN("builtin"); + + private final String value; + McpServerSource(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpServerSource fromValue(String value) { + for (McpServerSource v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpServerSource value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/McpServerStatus.java b/src/generated/java/com/github/copilot/generated/McpServerStatus.java new file mode 100644 index 0000000000..b5bb080935 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/McpServerStatus.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Connection status: connected, failed, needs-auth, pending, disabled, or not_configured + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpServerStatus { + /** The {@code connected} variant. */ + CONNECTED("connected"), + /** The {@code failed} variant. */ + FAILED("failed"), + /** The {@code needs-auth} variant. */ + NEEDS_AUTH("needs-auth"), + /** The {@code pending} variant. */ + PENDING("pending"), + /** The {@code disabled} variant. */ + DISABLED("disabled"), + /** The {@code not_configured} variant. */ + NOT_CONFIGURED("not_configured"); + + private final String value; + McpServerStatus(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpServerStatus fromValue(String value) { + for (McpServerStatus v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpServerStatus value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/McpServerStatusChangedStatus.java b/src/generated/java/com/github/copilot/generated/McpServerStatusChangedStatus.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/McpServerStatusChangedStatus.java rename to src/generated/java/com/github/copilot/generated/McpServerStatusChangedStatus.java index c0a6d989d2..cc11c8cabf 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/McpServerStatusChangedStatus.java +++ b/src/generated/java/com/github/copilot/generated/McpServerStatusChangedStatus.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/generated/McpServerTransport.java b/src/generated/java/com/github/copilot/generated/McpServerTransport.java new file mode 100644 index 0000000000..21211c4e20 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/McpServerTransport.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Transport mechanism: stdio, http, sse (deprecated), or memory (in-process MCP server) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpServerTransport { + /** The {@code stdio} variant. */ + STDIO("stdio"), + /** The {@code http} variant. */ + HTTP("http"), + /** The {@code sse} variant. */ + SSE("sse"), + /** The {@code memory} variant. */ + MEMORY("memory"); + + private final String value; + McpServerTransport(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpServerTransport fromValue(String value) { + for (McpServerTransport v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpServerTransport value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/McpServersLoadedServer.java b/src/generated/java/com/github/copilot/generated/McpServersLoadedServer.java new file mode 100644 index 0000000000..9c5d520813 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/McpServersLoadedServer.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `McpServersLoadedServer` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpServersLoadedServer( + /** Server name (config key) */ + @JsonProperty("name") String name, + /** Connection status: connected, failed, needs-auth, pending, disabled, or not_configured */ + @JsonProperty("status") McpServerStatus status, + /** Configuration source: user, workspace, plugin, or builtin */ + @JsonProperty("source") McpServerSource source, + /** Error message if the server failed to connect */ + @JsonProperty("error") String error, + /** Transport mechanism: stdio, http, sse (deprecated), or memory (in-process MCP server) */ + @JsonProperty("transport") McpServerTransport transport, + /** Name of the plugin that supplied the effective MCP server config, only when source is plugin */ + @JsonProperty("pluginName") String pluginName, + /** Version of the plugin that supplied the effective MCP server config, only when source is plugin */ + @JsonProperty("pluginVersion") String pluginVersion +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/McpServersLoadedServerStatus.java b/src/generated/java/com/github/copilot/generated/McpServersLoadedServerStatus.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/McpServersLoadedServerStatus.java rename to src/generated/java/com/github/copilot/generated/McpServersLoadedServerStatus.java index 4d09fe2a38..af3c97840f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/McpServersLoadedServerStatus.java +++ b/src/generated/java/com/github/copilot/generated/McpServersLoadedServerStatus.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/generated/ModelCallFailureEvent.java b/src/generated/java/com/github/copilot/generated/ModelCallFailureEvent.java new file mode 100644 index 0000000000..8a516065b6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ModelCallFailureEvent.java @@ -0,0 +1,58 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "model.call_failure". Failed LLM API call metadata for telemetry + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class ModelCallFailureEvent extends SessionEvent { + + @Override + public String getType() { return "model.call_failure"; } + + @JsonProperty("data") + private ModelCallFailureEventData data; + + public ModelCallFailureEventData getData() { return data; } + public void setData(ModelCallFailureEventData data) { this.data = data; } + + /** Data payload for {@link ModelCallFailureEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ModelCallFailureEventData( + /** Model identifier used for the failed API call */ + @JsonProperty("model") String model, + /** What initiated this API call (e.g., "sub-agent", "mcp-sampling"); absent for user-initiated calls */ + @JsonProperty("initiator") String initiator, + /** Completion ID from the model provider (e.g., chatcmpl-abc123) */ + @JsonProperty("apiCallId") String apiCallId, + /** GitHub request tracing ID (x-github-request-id header) for server-side log correlation */ + @JsonProperty("providerCallId") String providerCallId, + /** Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation */ + @JsonProperty("serviceRequestId") String serviceRequestId, + /** HTTP status code from the failed request */ + @JsonProperty("statusCode") Long statusCode, + /** Duration of the failed API call in milliseconds */ + @JsonProperty("durationMs") Long durationMs, + /** Where the failed model call originated */ + @JsonProperty("source") ModelCallFailureSource source, + /** Raw provider/runtime error message for restricted telemetry */ + @JsonProperty("errorMessage") String errorMessage + ) { + } +} diff --git a/src/generated/java/com/github/copilot/generated/ModelCallFailureSource.java b/src/generated/java/com/github/copilot/generated/ModelCallFailureSource.java new file mode 100644 index 0000000000..747112c3db --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ModelCallFailureSource.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Where the failed model call originated + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ModelCallFailureSource { + /** The {@code top_level} variant. */ + TOP_LEVEL("top_level"), + /** The {@code subagent} variant. */ + SUBAGENT("subagent"), + /** The {@code mcp_sampling} variant. */ + MCP_SAMPLING("mcp_sampling"); + + private final String value; + ModelCallFailureSource(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ModelCallFailureSource fromValue(String value) { + for (ModelCallFailureSource v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ModelCallFailureSource value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/PendingMessagesModifiedEvent.java b/src/generated/java/com/github/copilot/generated/PendingMessagesModifiedEvent.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/PendingMessagesModifiedEvent.java rename to src/generated/java/com/github/copilot/generated/PendingMessagesModifiedEvent.java index 56f8ed520e..2b7fecee0f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/PendingMessagesModifiedEvent.java +++ b/src/generated/java/com/github/copilot/generated/PendingMessagesModifiedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code pending_messages.modified} session event. + * Session event "pending_messages.modified". Empty payload; the event signals that the pending message queue has changed * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedEvent.java b/src/generated/java/com/github/copilot/generated/PermissionCompletedEvent.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/PermissionCompletedEvent.java index 0045393c1a..e389863d3d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/PermissionCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code permission.completed} session event. + * Session event "permission.completed". Permission request completion notification signaling UI dismissal * * @since 1.0.0 */ @@ -40,7 +40,7 @@ public record PermissionCompletedEventData( /** Optional tool call ID associated with this permission prompt; clients may use it to correlate UI created from tool-scoped prompts */ @JsonProperty("toolCallId") String toolCallId, /** The result of the permission request */ - @JsonProperty("result") PermissionCompletedResult result + @JsonProperty("result") Object result ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedKind.java b/src/generated/java/com/github/copilot/generated/PermissionCompletedKind.java similarity index 98% rename from src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedKind.java rename to src/generated/java/com/github/copilot/generated/PermissionCompletedKind.java index c02f221fd5..61c770b65f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedKind.java +++ b/src/generated/java/com/github/copilot/generated/PermissionCompletedKind.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedResult.java b/src/generated/java/com/github/copilot/generated/PermissionCompletedResult.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedResult.java rename to src/generated/java/com/github/copilot/generated/PermissionCompletedResult.java index 4a180001ca..1beb805239 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/PermissionCompletedResult.java +++ b/src/generated/java/com/github/copilot/generated/PermissionCompletedResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/PermissionRequestedEvent.java b/src/generated/java/com/github/copilot/generated/PermissionRequestedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/PermissionRequestedEvent.java rename to src/generated/java/com/github/copilot/generated/PermissionRequestedEvent.java index 7892d3afe5..2d79880622 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/PermissionRequestedEvent.java +++ b/src/generated/java/com/github/copilot/generated/PermissionRequestedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code permission.requested} session event. + * Session event "permission.requested". Permission request notification requiring client approval with request details * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/PlanChangedOperation.java b/src/generated/java/com/github/copilot/generated/PlanChangedOperation.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/PlanChangedOperation.java rename to src/generated/java/com/github/copilot/generated/PlanChangedOperation.java index cd52d7ec1a..35d4fece4f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/PlanChangedOperation.java +++ b/src/generated/java/com/github/copilot/generated/PlanChangedOperation.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/generated/ReasoningSummary.java b/src/generated/java/com/github/copilot/generated/ReasoningSummary.java new file mode 100644 index 0000000000..a2b6d3e02d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ReasoningSummary.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Reasoning summary mode used for model calls, if applicable (e.g. "none", "concise", "detailed") + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ReasoningSummary { + /** The {@code none} variant. */ + NONE("none"), + /** The {@code concise} variant. */ + CONCISE("concise"), + /** The {@code detailed} variant. */ + DETAILED("detailed"); + + private final String value; + ReasoningSummary(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ReasoningSummary fromValue(String value) { + for (ReasoningSummary v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ReasoningSummary value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SamplingCompletedEvent.java b/src/generated/java/com/github/copilot/generated/SamplingCompletedEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/SamplingCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/SamplingCompletedEvent.java index ae21575094..0cf0e9daa2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SamplingCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SamplingCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code sampling.completed} session event. + * Session event "sampling.completed". Sampling request completion notification signaling UI dismissal * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SamplingRequestedEvent.java b/src/generated/java/com/github/copilot/generated/SamplingRequestedEvent.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/SamplingRequestedEvent.java rename to src/generated/java/com/github/copilot/generated/SamplingRequestedEvent.java index 7b92f5fafe..1982f552cc 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SamplingRequestedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SamplingRequestedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code sampling.requested} session event. + * Session event "sampling.requested". Sampling request from an MCP server; contains the server name and a requestId for correlation * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/SessionAutopilotObjectiveChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionAutopilotObjectiveChangedEvent.java new file mode 100644 index 0000000000..62f49184c5 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionAutopilotObjectiveChangedEvent.java @@ -0,0 +1,46 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "session.autopilot_objective_changed". Autopilot objective state file operation details indicating what changed + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionAutopilotObjectiveChangedEvent extends SessionEvent { + + @Override + public String getType() { return "session.autopilot_objective_changed"; } + + @JsonProperty("data") + private SessionAutopilotObjectiveChangedEventData data; + + public SessionAutopilotObjectiveChangedEventData getData() { return data; } + public void setData(SessionAutopilotObjectiveChangedEventData data) { this.data = data; } + + /** Data payload for {@link SessionAutopilotObjectiveChangedEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionAutopilotObjectiveChangedEventData( + /** The type of operation performed on the autopilot objective state file */ + @JsonProperty("operation") AutopilotObjectiveChangedOperation operation, + /** Current autopilot objective id, if one exists */ + @JsonProperty("id") Long id, + /** Current autopilot objective status, if one exists */ + @JsonProperty("status") AutopilotObjectiveChangedStatus status + ) { + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionBackgroundTasksChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionBackgroundTasksChangedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/SessionBackgroundTasksChangedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionBackgroundTasksChangedEvent.java index fa996cf0e3..2a712ae49a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionBackgroundTasksChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionBackgroundTasksChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.background_tasks_changed} session event. + * Session event "session.background_tasks_changed". * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/SessionCanvasOpenedEvent.java b/src/generated/java/com/github/copilot/generated/SessionCanvasOpenedEvent.java new file mode 100644 index 0000000000..ea32bd4799 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionCanvasOpenedEvent.java @@ -0,0 +1,60 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "session.canvas.opened". + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionCanvasOpenedEvent extends SessionEvent { + + @Override + public String getType() { return "session.canvas.opened"; } + + @JsonProperty("data") + private SessionCanvasOpenedEventData data; + + public SessionCanvasOpenedEventData getData() { return data; } + public void setData(SessionCanvasOpenedEventData data) { this.data = data; } + + /** Data payload for {@link SessionCanvasOpenedEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionCanvasOpenedEventData( + /** Stable caller-supplied canvas instance identifier */ + @JsonProperty("instanceId") String instanceId, + /** Owning provider identifier */ + @JsonProperty("extensionId") String extensionId, + /** Owning extension display name, when available */ + @JsonProperty("extensionName") String extensionName, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId, + /** Rendered title */ + @JsonProperty("title") String title, + /** Provider-supplied status text */ + @JsonProperty("status") String status, + /** URL for web-rendered canvases */ + @JsonProperty("url") String url, + /** Input supplied when the instance was opened */ + @JsonProperty("input") Object input, + /** Whether this notification represents an idempotent reopen */ + @JsonProperty("reopen") Boolean reopen, + /** Runtime-controlled routing state for the instance. "ready" when the provider connection is live; "stale" when the provider has gone away and the instance is awaiting rebinding. */ + @JsonProperty("availability") CanvasOpenedAvailability availability + ) { + } +} diff --git a/src/generated/java/com/github/copilot/generated/SessionCanvasRegistryChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionCanvasRegistryChangedEvent.java new file mode 100644 index 0000000000..4fb2a034b5 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionCanvasRegistryChangedEvent.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Session event "session.canvas.registry_changed". + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionCanvasRegistryChangedEvent extends SessionEvent { + + @Override + public String getType() { return "session.canvas.registry_changed"; } + + @JsonProperty("data") + private SessionCanvasRegistryChangedEventData data; + + public SessionCanvasRegistryChangedEventData getData() { return data; } + public void setData(SessionCanvasRegistryChangedEventData data) { this.data = data; } + + /** Data payload for {@link SessionCanvasRegistryChangedEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionCanvasRegistryChangedEventData( + /** Canvas declarations currently available */ + @JsonProperty("canvases") List canvases + ) { + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionCompactionCompleteEvent.java b/src/generated/java/com/github/copilot/generated/SessionCompactionCompleteEvent.java similarity index 69% rename from src/generated/java/com/github/copilot/sdk/generated/SessionCompactionCompleteEvent.java rename to src/generated/java/com/github/copilot/generated/SessionCompactionCompleteEvent.java index 5f37980987..d64979195d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionCompactionCompleteEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionCompactionCompleteEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.compaction_complete} session event. + * Session event "session.compaction_complete". Conversation compaction results including success status, metrics, and optional error details * * @since 1.0.0 */ @@ -40,31 +40,35 @@ public record SessionCompactionCompleteEventData( /** Error message if compaction failed */ @JsonProperty("error") String error, /** Total tokens in conversation before compaction */ - @JsonProperty("preCompactionTokens") Double preCompactionTokens, + @JsonProperty("preCompactionTokens") Long preCompactionTokens, /** Total tokens in conversation after compaction */ - @JsonProperty("postCompactionTokens") Double postCompactionTokens, + @JsonProperty("postCompactionTokens") Long postCompactionTokens, /** Number of messages before compaction */ - @JsonProperty("preCompactionMessagesLength") Double preCompactionMessagesLength, + @JsonProperty("preCompactionMessagesLength") Long preCompactionMessagesLength, /** Number of messages removed during compaction */ - @JsonProperty("messagesRemoved") Double messagesRemoved, + @JsonProperty("messagesRemoved") Long messagesRemoved, /** Number of tokens removed during compaction */ - @JsonProperty("tokensRemoved") Double tokensRemoved, + @JsonProperty("tokensRemoved") Long tokensRemoved, + /** User-supplied focus instructions provided to a manual `/compact` invocation. Omitted for automatic compaction and for manual compaction with no focus text. */ + @JsonProperty("customInstructions") String customInstructions, /** LLM-generated summary of the compacted conversation history */ @JsonProperty("summaryContent") String summaryContent, /** Checkpoint snapshot number created for recovery */ - @JsonProperty("checkpointNumber") Double checkpointNumber, + @JsonProperty("checkpointNumber") Long checkpointNumber, /** File path where the checkpoint was stored */ @JsonProperty("checkpointPath") String checkpointPath, /** Token usage breakdown for the compaction LLM call (aligned with assistant.usage format) */ @JsonProperty("compactionTokensUsed") CompactionCompleteCompactionTokensUsed compactionTokensUsed, /** GitHub request tracing ID (x-github-request-id header) for the compaction LLM call */ @JsonProperty("requestId") String requestId, + /** Copilot service request ID (x-copilot-service-request-id header) for the compaction LLM call */ + @JsonProperty("serviceRequestId") String serviceRequestId, /** Token count from system message(s) after compaction */ - @JsonProperty("systemTokens") Double systemTokens, + @JsonProperty("systemTokens") Long systemTokens, /** Token count from non-system messages (user, assistant, tool) after compaction */ - @JsonProperty("conversationTokens") Double conversationTokens, + @JsonProperty("conversationTokens") Long conversationTokens, /** Token count from tool definitions after compaction */ - @JsonProperty("toolDefinitionsTokens") Double toolDefinitionsTokens + @JsonProperty("toolDefinitionsTokens") Long toolDefinitionsTokens ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionCompactionStartEvent.java b/src/generated/java/com/github/copilot/generated/SessionCompactionStartEvent.java similarity index 81% rename from src/generated/java/com/github/copilot/sdk/generated/SessionCompactionStartEvent.java rename to src/generated/java/com/github/copilot/generated/SessionCompactionStartEvent.java index 2e0fb6d6f4..90fcd76b62 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionCompactionStartEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionCompactionStartEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.compaction_start} session event. + * Session event "session.compaction_start". Context window breakdown at the start of LLM-powered conversation compaction * * @since 1.0.0 */ @@ -36,11 +36,11 @@ public final class SessionCompactionStartEvent extends SessionEvent { @JsonInclude(JsonInclude.Include.NON_NULL) public record SessionCompactionStartEventData( /** Token count from system message(s) at compaction start */ - @JsonProperty("systemTokens") Double systemTokens, + @JsonProperty("systemTokens") Long systemTokens, /** Token count from non-system messages (user, assistant, tool) at compaction start */ - @JsonProperty("conversationTokens") Double conversationTokens, + @JsonProperty("conversationTokens") Long conversationTokens, /** Token count from tool definitions at compaction start */ - @JsonProperty("toolDefinitionsTokens") Double toolDefinitionsTokens + @JsonProperty("toolDefinitionsTokens") Long toolDefinitionsTokens ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionContextChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionContextChangedEvent.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/SessionContextChangedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionContextChangedEvent.java index 0eb9e7e34b..1fc5ef0eaf 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionContextChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionContextChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.context_changed} session event. + * Session event "session.context_changed". Updated working directory and git context after the change * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionCustomAgentsUpdatedEvent.java b/src/generated/java/com/github/copilot/generated/SessionCustomAgentsUpdatedEvent.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/SessionCustomAgentsUpdatedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionCustomAgentsUpdatedEvent.java index be5e15e91a..9ceed8c658 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionCustomAgentsUpdatedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionCustomAgentsUpdatedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.custom_agents_updated} session event. + * Session event "session.custom_agents_updated". * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/SessionCustomNotificationEvent.java b/src/generated/java/com/github/copilot/generated/SessionCustomNotificationEvent.java new file mode 100644 index 0000000000..499d143d4c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionCustomNotificationEvent.java @@ -0,0 +1,51 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Session event "session.custom_notification". Opaque custom notification data. Consumers may branch on source and name, but payload semantics are source-defined. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionCustomNotificationEvent extends SessionEvent { + + @Override + public String getType() { return "session.custom_notification"; } + + @JsonProperty("data") + private SessionCustomNotificationEventData data; + + public SessionCustomNotificationEventData getData() { return data; } + public void setData(SessionCustomNotificationEventData data) { this.data = data; } + + /** Data payload for {@link SessionCustomNotificationEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionCustomNotificationEventData( + /** Namespace for the custom notification producer */ + @JsonProperty("source") String source, + /** Source-defined custom notification name */ + @JsonProperty("name") String name, + /** Optional source-defined payload schema version */ + @JsonProperty("version") Long version, + /** Optional source-defined string identifiers describing the payload subject */ + @JsonProperty("subject") Map subject, + /** Source-defined JSON payload for the custom notification */ + @JsonProperty("payload") Object payload + ) { + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionErrorEvent.java b/src/generated/java/com/github/copilot/generated/SessionErrorEvent.java similarity index 62% rename from src/generated/java/com/github/copilot/sdk/generated/SessionErrorEvent.java rename to src/generated/java/com/github/copilot/generated/SessionErrorEvent.java index 33dc688348..12fa20ac19 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionErrorEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionErrorEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.error} session event. + * Session event "session.error". Error details for timeline display including message and optional diagnostic information * * @since 1.0.0 */ @@ -37,6 +37,10 @@ public final class SessionErrorEvent extends SessionEvent { public record SessionErrorEventData( /** Category of error (e.g., "authentication", "authorization", "quota", "rate_limit", "context_limit", "query") */ @JsonProperty("errorType") String errorType, + /** Fine-grained error code from the upstream provider, when available. For `errorType: "rate_limit"`, this is one of the `RateLimitErrorCode` values (e.g., `"user_weekly_rate_limited"`, `"user_global_rate_limited"`, `"rate_limited"`, `"user_model_rate_limited"`, `"integration_rate_limited"`). For `errorType: "quota"`, this is the CAPI quota error code (e.g., `"quota_exceeded"`, `"session_quota_exceeded"`, `"billing_not_configured"`). */ + @JsonProperty("errorCode") String errorCode, + /** Only set on `errorType: "rate_limit"`. When `true`, the runtime will follow this error with an `auto_mode_switch.requested` event (or silently switch if `continueOnAutoMode` is enabled). UI clients can use this flag to suppress duplicate rendering of the rate-limit error when they show their own auto-mode-switch prompt. */ + @JsonProperty("eligibleForAutoSwitch") Boolean eligibleForAutoSwitch, /** Human-readable error message */ @JsonProperty("message") String message, /** Error stack trace, when available */ @@ -45,6 +49,8 @@ public record SessionErrorEventData( @JsonProperty("statusCode") Long statusCode, /** GitHub request tracing ID (x-github-request-id header) for correlating with server-side logs */ @JsonProperty("providerCallId") String providerCallId, + /** Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation */ + @JsonProperty("serviceRequestId") String serviceRequestId, /** Optional URL associated with this error that the user can open in a browser */ @JsonProperty("url") String url ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionEvent.java b/src/generated/java/com/github/copilot/generated/SessionEvent.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/SessionEvent.java rename to src/generated/java/com/github/copilot/generated/SessionEvent.java index 85c62a2418..570fe3a9ee 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -31,10 +31,14 @@ @JsonSubTypes.Type(value = SessionErrorEvent.class, name = "session.error"), @JsonSubTypes.Type(value = SessionIdleEvent.class, name = "session.idle"), @JsonSubTypes.Type(value = SessionTitleChangedEvent.class, name = "session.title_changed"), + @JsonSubTypes.Type(value = SessionScheduleCreatedEvent.class, name = "session.schedule_created"), + @JsonSubTypes.Type(value = SessionScheduleCancelledEvent.class, name = "session.schedule_cancelled"), + @JsonSubTypes.Type(value = SessionAutopilotObjectiveChangedEvent.class, name = "session.autopilot_objective_changed"), @JsonSubTypes.Type(value = SessionInfoEvent.class, name = "session.info"), @JsonSubTypes.Type(value = SessionWarningEvent.class, name = "session.warning"), @JsonSubTypes.Type(value = SessionModelChangeEvent.class, name = "session.model_change"), @JsonSubTypes.Type(value = SessionModeChangedEvent.class, name = "session.mode_changed"), + @JsonSubTypes.Type(value = SessionPermissionsChangedEvent.class, name = "session.permissions_changed"), @JsonSubTypes.Type(value = SessionPlanChangedEvent.class, name = "session.plan_changed"), @JsonSubTypes.Type(value = SessionWorkspaceFileChangedEvent.class, name = "session.workspace_file_changed"), @JsonSubTypes.Type(value = SessionHandoffEvent.class, name = "session.handoff"), @@ -54,9 +58,11 @@ @JsonSubTypes.Type(value = AssistantReasoningDeltaEvent.class, name = "assistant.reasoning_delta"), @JsonSubTypes.Type(value = AssistantStreamingDeltaEvent.class, name = "assistant.streaming_delta"), @JsonSubTypes.Type(value = AssistantMessageEvent.class, name = "assistant.message"), + @JsonSubTypes.Type(value = AssistantMessageStartEvent.class, name = "assistant.message_start"), @JsonSubTypes.Type(value = AssistantMessageDeltaEvent.class, name = "assistant.message_delta"), @JsonSubTypes.Type(value = AssistantTurnEndEvent.class, name = "assistant.turn_end"), @JsonSubTypes.Type(value = AssistantUsageEvent.class, name = "assistant.usage"), + @JsonSubTypes.Type(value = ModelCallFailureEvent.class, name = "model.call_failure"), @JsonSubTypes.Type(value = AbortEvent.class, name = "abort"), @JsonSubTypes.Type(value = ToolUserRequestedEvent.class, name = "tool.user_requested"), @JsonSubTypes.Type(value = ToolExecutionStartEvent.class, name = "tool.execution_start"), @@ -71,6 +77,7 @@ @JsonSubTypes.Type(value = SubagentDeselectedEvent.class, name = "subagent.deselected"), @JsonSubTypes.Type(value = HookStartEvent.class, name = "hook.start"), @JsonSubTypes.Type(value = HookEndEvent.class, name = "hook.end"), + @JsonSubTypes.Type(value = HookProgressEvent.class, name = "hook.progress"), @JsonSubTypes.Type(value = SystemMessageEvent.class, name = "system.message"), @JsonSubTypes.Type(value = SystemNotificationEvent.class, name = "system.notification"), @JsonSubTypes.Type(value = PermissionRequestedEvent.class, name = "permission.requested"), @@ -83,6 +90,7 @@ @JsonSubTypes.Type(value = SamplingCompletedEvent.class, name = "sampling.completed"), @JsonSubTypes.Type(value = McpOauthRequiredEvent.class, name = "mcp.oauth_required"), @JsonSubTypes.Type(value = McpOauthCompletedEvent.class, name = "mcp.oauth_completed"), + @JsonSubTypes.Type(value = SessionCustomNotificationEvent.class, name = "session.custom_notification"), @JsonSubTypes.Type(value = ExternalToolRequestedEvent.class, name = "external_tool.requested"), @JsonSubTypes.Type(value = ExternalToolCompletedEvent.class, name = "external_tool.completed"), @JsonSubTypes.Type(value = CommandQueuedEvent.class, name = "command.queued"), @@ -100,7 +108,10 @@ @JsonSubTypes.Type(value = SessionCustomAgentsUpdatedEvent.class, name = "session.custom_agents_updated"), @JsonSubTypes.Type(value = SessionMcpServersLoadedEvent.class, name = "session.mcp_servers_loaded"), @JsonSubTypes.Type(value = SessionMcpServerStatusChangedEvent.class, name = "session.mcp_server_status_changed"), - @JsonSubTypes.Type(value = SessionExtensionsLoadedEvent.class, name = "session.extensions_loaded") + @JsonSubTypes.Type(value = SessionExtensionsLoadedEvent.class, name = "session.extensions_loaded"), + @JsonSubTypes.Type(value = SessionCanvasOpenedEvent.class, name = "session.canvas.opened"), + @JsonSubTypes.Type(value = SessionCanvasRegistryChangedEvent.class, name = "session.canvas.registry_changed"), + @JsonSubTypes.Type(value = McpAppToolCallCompleteEvent.class, name = "mcp_app.tool_call_complete") }) @javax.annotation.processing.Generated("copilot-sdk-codegen") public abstract sealed class SessionEvent permits @@ -110,10 +121,14 @@ public abstract sealed class SessionEvent permits SessionErrorEvent, SessionIdleEvent, SessionTitleChangedEvent, + SessionScheduleCreatedEvent, + SessionScheduleCancelledEvent, + SessionAutopilotObjectiveChangedEvent, SessionInfoEvent, SessionWarningEvent, SessionModelChangeEvent, SessionModeChangedEvent, + SessionPermissionsChangedEvent, SessionPlanChangedEvent, SessionWorkspaceFileChangedEvent, SessionHandoffEvent, @@ -133,9 +148,11 @@ public abstract sealed class SessionEvent permits AssistantReasoningDeltaEvent, AssistantStreamingDeltaEvent, AssistantMessageEvent, + AssistantMessageStartEvent, AssistantMessageDeltaEvent, AssistantTurnEndEvent, AssistantUsageEvent, + ModelCallFailureEvent, AbortEvent, ToolUserRequestedEvent, ToolExecutionStartEvent, @@ -150,6 +167,7 @@ public abstract sealed class SessionEvent permits SubagentDeselectedEvent, HookStartEvent, HookEndEvent, + HookProgressEvent, SystemMessageEvent, SystemNotificationEvent, PermissionRequestedEvent, @@ -162,6 +180,7 @@ public abstract sealed class SessionEvent permits SamplingCompletedEvent, McpOauthRequiredEvent, McpOauthCompletedEvent, + SessionCustomNotificationEvent, ExternalToolRequestedEvent, ExternalToolCompletedEvent, CommandQueuedEvent, @@ -180,6 +199,9 @@ public abstract sealed class SessionEvent permits SessionMcpServersLoadedEvent, SessionMcpServerStatusChangedEvent, SessionExtensionsLoadedEvent, + SessionCanvasOpenedEvent, + SessionCanvasRegistryChangedEvent, + McpAppToolCallCompleteEvent, UnknownSessionEvent { /** Unique event identifier (UUID v4), generated when the event is emitted. */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionExtensionsLoadedEvent.java b/src/generated/java/com/github/copilot/generated/SessionExtensionsLoadedEvent.java similarity index 93% rename from src/generated/java/com/github/copilot/sdk/generated/SessionExtensionsLoadedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionExtensionsLoadedEvent.java index 4d3420174e..0165be5d29 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionExtensionsLoadedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionExtensionsLoadedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.extensions_loaded} session event. + * Session event "session.extensions_loaded". * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionHandoffEvent.java b/src/generated/java/com/github/copilot/generated/SessionHandoffEvent.java similarity index 93% rename from src/generated/java/com/github/copilot/sdk/generated/SessionHandoffEvent.java rename to src/generated/java/com/github/copilot/generated/SessionHandoffEvent.java index 86706272f5..7edba44c09 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionHandoffEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionHandoffEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.handoff} session event. + * Session event "session.handoff". Session handoff metadata including source, context, and repository information * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionIdleEvent.java b/src/generated/java/com/github/copilot/generated/SessionIdleEvent.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/SessionIdleEvent.java rename to src/generated/java/com/github/copilot/generated/SessionIdleEvent.java index 86376ae7c1..dc7136c20b 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionIdleEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionIdleEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.idle} session event. + * Session event "session.idle". Payload indicating the session is idle with no background agents in flight * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionInfoEvent.java b/src/generated/java/com/github/copilot/generated/SessionInfoEvent.java similarity index 85% rename from src/generated/java/com/github/copilot/sdk/generated/SessionInfoEvent.java rename to src/generated/java/com/github/copilot/generated/SessionInfoEvent.java index 4dee36ba5c..2d9ac36905 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionInfoEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionInfoEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.info} session event. + * Session event "session.info". Informational message for timeline display with categorization * * @since 1.0.0 */ @@ -40,7 +40,9 @@ public record SessionInfoEventData( /** Human-readable informational message for display in the timeline */ @JsonProperty("message") String message, /** Optional URL associated with this message that the user can open in a browser */ - @JsonProperty("url") String url + @JsonProperty("url") String url, + /** Optional actionable tip displayed with this message */ + @JsonProperty("tip") String tip ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionMcpServerStatusChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionMcpServerStatusChangedEvent.java similarity index 80% rename from src/generated/java/com/github/copilot/sdk/generated/SessionMcpServerStatusChangedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionMcpServerStatusChangedEvent.java index c422bf29a9..1567a2f35e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionMcpServerStatusChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionMcpServerStatusChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.mcp_server_status_changed} session event. + * Session event "session.mcp_server_status_changed". * * @since 1.0.0 */ @@ -37,8 +37,10 @@ public final class SessionMcpServerStatusChangedEvent extends SessionEvent { public record SessionMcpServerStatusChangedEventData( /** Name of the MCP server whose status changed */ @JsonProperty("serverName") String serverName, - /** New connection status: connected, failed, needs-auth, pending, disabled, or not_configured */ - @JsonProperty("status") McpServerStatusChangedStatus status + /** Connection status: connected, failed, needs-auth, pending, disabled, or not_configured */ + @JsonProperty("status") McpServerStatus status, + /** Error message if the server entered a failed state */ + @JsonProperty("error") String error ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionMcpServersLoadedEvent.java b/src/generated/java/com/github/copilot/generated/SessionMcpServersLoadedEvent.java similarity index 93% rename from src/generated/java/com/github/copilot/sdk/generated/SessionMcpServersLoadedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionMcpServersLoadedEvent.java index be2d4cf744..d978755131 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionMcpServersLoadedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionMcpServersLoadedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.mcp_servers_loaded} session event. + * Session event "session.mcp_servers_loaded". * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/SessionMode.java b/src/generated/java/com/github/copilot/generated/SessionMode.java new file mode 100644 index 0000000000..ba579b306a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionMode.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * The session mode the agent is operating in + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SessionMode { + /** The {@code interactive} variant. */ + INTERACTIVE("interactive"), + /** The {@code plan} variant. */ + PLAN("plan"), + /** The {@code autopilot} variant. */ + AUTOPILOT("autopilot"); + + private final String value; + SessionMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SessionMode fromValue(String value) { + for (SessionMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SessionMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionModeChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionModeChangedEvent.java similarity index 77% rename from src/generated/java/com/github/copilot/sdk/generated/SessionModeChangedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionModeChangedEvent.java index 82ae9ff39c..28fb3e9e47 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionModeChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionModeChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.mode_changed} session event. + * Session event "session.mode_changed". Agent mode change details including previous and new modes * * @since 1.0.0 */ @@ -35,10 +35,10 @@ public final class SessionModeChangedEvent extends SessionEvent { @JsonIgnoreProperties(ignoreUnknown = true) @JsonInclude(JsonInclude.Include.NON_NULL) public record SessionModeChangedEventData( - /** Agent mode before the change (e.g., "interactive", "plan", "autopilot") */ - @JsonProperty("previousMode") String previousMode, - /** Agent mode after the change (e.g., "interactive", "plan", "autopilot") */ - @JsonProperty("newMode") String newMode + /** The session mode the agent is operating in */ + @JsonProperty("previousMode") SessionMode previousMode, + /** The session mode the agent is operating in */ + @JsonProperty("newMode") SessionMode newMode ) { } } diff --git a/src/generated/java/com/github/copilot/generated/SessionModelChangeEvent.java b/src/generated/java/com/github/copilot/generated/SessionModelChangeEvent.java new file mode 100644 index 0000000000..e0d8785b96 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionModelChangeEvent.java @@ -0,0 +1,75 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "session.model_change". Model change details including previous and new model identifiers + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionModelChangeEvent extends SessionEvent { + + @Override + public String getType() { return "session.model_change"; } + + @JsonProperty("data") + private SessionModelChangeEventData data; + + public SessionModelChangeEventData getData() { return data; } + public void setData(SessionModelChangeEventData data) { this.data = data; } + + /** Data payload for {@link SessionModelChangeEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionModelChangeEventData( + /** Model that was previously selected, if any */ + @JsonProperty("previousModel") String previousModel, + /** Newly selected model identifier */ + @JsonProperty("newModel") String newModel, + /** Reasoning effort level before the model change, if applicable */ + @JsonProperty("previousReasoningEffort") String previousReasoningEffort, + /** Reasoning effort level after the model change, if applicable */ + @JsonProperty("reasoningEffort") String reasoningEffort, + /** Reasoning summary mode before the model change, if applicable */ + @JsonProperty("previousReasoningSummary") ReasoningSummary previousReasoningSummary, + /** Reasoning summary mode after the model change, if applicable */ + @JsonProperty("reasoningSummary") ReasoningSummary reasoningSummary, + /** Context tier after the model change; null explicitly clears a previously selected tier */ + @JsonProperty("contextTier") SessionModelChangeEventDataContextTier contextTier, + /** Reason the change happened, when not user-initiated. Currently `"rate_limit_auto_switch"` for changes triggered by the auto-mode-switch rate-limit recovery path. UI clients can use this to render contextual copy. */ + @JsonProperty("cause") String cause + ) { + + public enum SessionModelChangeEventDataContextTier { + /** The {@code default} variant. */ + DEFAULT("default"), + /** The {@code long_context} variant. */ + LONG_CONTEXT("long_context"); + + private final String value; + SessionModelChangeEventDataContextTier(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SessionModelChangeEventDataContextTier fromValue(String value) { + for (SessionModelChangeEventDataContextTier v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SessionModelChangeEventDataContextTier value: " + value); + } + } + } +} diff --git a/src/generated/java/com/github/copilot/generated/SessionPermissionsChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionPermissionsChangedEvent.java new file mode 100644 index 0000000000..91ac1d3c8d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionPermissionsChangedEvent.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "session.permissions_changed". Permissions change details carrying the aggregate allow-all boolean transition. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionPermissionsChangedEvent extends SessionEvent { + + @Override + public String getType() { return "session.permissions_changed"; } + + @JsonProperty("data") + private SessionPermissionsChangedEventData data; + + public SessionPermissionsChangedEventData getData() { return data; } + public void setData(SessionPermissionsChangedEventData data) { this.data = data; } + + /** Data payload for {@link SessionPermissionsChangedEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionPermissionsChangedEventData( + /** Aggregate allow-all flag before the change */ + @JsonProperty("previousAllowAllPermissions") Boolean previousAllowAllPermissions, + /** Aggregate allow-all flag after the change */ + @JsonProperty("allowAllPermissions") Boolean allowAllPermissions + ) { + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionPlanChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionPlanChangedEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/SessionPlanChangedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionPlanChangedEvent.java index 4677d1cdb3..cf9f4706d0 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionPlanChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionPlanChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.plan_changed} session event. + * Session event "session.plan_changed". Plan file operation details indicating what changed * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionRemoteSteerableChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionRemoteSteerableChangedEvent.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/SessionRemoteSteerableChangedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionRemoteSteerableChangedEvent.java index ba752f4c62..adcc3aeb7b 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionRemoteSteerableChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionRemoteSteerableChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.remote_steerable_changed} session event. + * Session event "session.remote_steerable_changed". Notifies that the session's remote steering capability has changed * * @since 1.0.0 */ @@ -35,7 +35,7 @@ public final class SessionRemoteSteerableChangedEvent extends SessionEvent { @JsonIgnoreProperties(ignoreUnknown = true) @JsonInclude(JsonInclude.Include.NON_NULL) public record SessionRemoteSteerableChangedEventData( - /** Whether this session now supports remote steering via Mission Control */ + /** Whether this session now supports remote steering via GitHub */ @JsonProperty("remoteSteerable") Boolean remoteSteerable ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionResumeEvent.java b/src/generated/java/com/github/copilot/generated/SessionResumeEvent.java similarity index 61% rename from src/generated/java/com/github/copilot/sdk/generated/SessionResumeEvent.java rename to src/generated/java/com/github/copilot/generated/SessionResumeEvent.java index 7973e7d17c..e27cc2045a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionResumeEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionResumeEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.resume} session event. + * Session event "session.resume". Session resume metadata including current context and event count * * @since 1.0.0 */ @@ -39,17 +39,23 @@ public record SessionResumeEventData( /** ISO 8601 timestamp when the session was resumed */ @JsonProperty("resumeTime") OffsetDateTime resumeTime, /** Total number of persisted events in the session at the time of resume */ - @JsonProperty("eventCount") Double eventCount, + @JsonProperty("eventCount") Long eventCount, /** Model currently selected at resume time */ @JsonProperty("selectedModel") String selectedModel, - /** Reasoning effort level used for model calls, if applicable (e.g. "low", "medium", "high", "xhigh") */ + /** Reasoning effort level used for model calls, if applicable (e.g. "none", "low", "medium", "high", "xhigh", "max") */ @JsonProperty("reasoningEffort") String reasoningEffort, + /** Reasoning summary mode used for model calls, if applicable (e.g. "none", "concise", "detailed") */ + @JsonProperty("reasoningSummary") ReasoningSummary reasoningSummary, /** Updated working directory and git context at resume time */ @JsonProperty("context") WorkingDirectoryContext context, /** Whether the session was already in use by another client at resume time */ @JsonProperty("alreadyInUse") Boolean alreadyInUse, - /** Whether this session supports remote steering via Mission Control */ - @JsonProperty("remoteSteerable") Boolean remoteSteerable + /** True when this resume attached to a session that the runtime already had running in-memory (for example, an extension joining a session another client was actively driving). False (or omitted) for cold resumes β€” the runtime had to reconstitute the session from its persisted event log. */ + @JsonProperty("sessionWasActive") Boolean sessionWasActive, + /** Whether this session supports remote steering via GitHub */ + @JsonProperty("remoteSteerable") Boolean remoteSteerable, + /** When true, tool calls and permission requests left in flight by the previous session lifetime remain pending after resume and the agentic loop awaits their results. User sends are queued behind the pending work until all such requests reach a terminal state. When false (the default), any such tool calls and permission requests are immediately marked as interrupted on resume. */ + @JsonProperty("continuePendingWork") Boolean continuePendingWork ) { } } diff --git a/src/generated/java/com/github/copilot/generated/SessionScheduleCancelledEvent.java b/src/generated/java/com/github/copilot/generated/SessionScheduleCancelledEvent.java new file mode 100644 index 0000000000..51aba5d4c9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionScheduleCancelledEvent.java @@ -0,0 +1,42 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "session.schedule_cancelled". Scheduled prompt cancelled from the schedule manager dialog + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionScheduleCancelledEvent extends SessionEvent { + + @Override + public String getType() { return "session.schedule_cancelled"; } + + @JsonProperty("data") + private SessionScheduleCancelledEventData data; + + public SessionScheduleCancelledEventData getData() { return data; } + public void setData(SessionScheduleCancelledEventData data) { this.data = data; } + + /** Data payload for {@link SessionScheduleCancelledEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionScheduleCancelledEventData( + /** Id of the scheduled prompt that was cancelled */ + @JsonProperty("id") Long id + ) { + } +} diff --git a/src/generated/java/com/github/copilot/generated/SessionScheduleCreatedEvent.java b/src/generated/java/com/github/copilot/generated/SessionScheduleCreatedEvent.java new file mode 100644 index 0000000000..2a9cbdeb45 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SessionScheduleCreatedEvent.java @@ -0,0 +1,50 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session event "session.schedule_created". Scheduled prompt registered via /every or /after + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionScheduleCreatedEvent extends SessionEvent { + + @Override + public String getType() { return "session.schedule_created"; } + + @JsonProperty("data") + private SessionScheduleCreatedEventData data; + + public SessionScheduleCreatedEventData getData() { return data; } + public void setData(SessionScheduleCreatedEventData data) { this.data = data; } + + /** Data payload for {@link SessionScheduleCreatedEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionScheduleCreatedEventData( + /** Sequential id assigned to the scheduled prompt within the session */ + @JsonProperty("id") Long id, + /** Interval between ticks in milliseconds */ + @JsonProperty("intervalMs") Long intervalMs, + /** Prompt text that gets enqueued on every tick */ + @JsonProperty("prompt") String prompt, + /** Whether the schedule re-arms after each tick (`/every`) or fires once (`/after`) */ + @JsonProperty("recurring") Boolean recurring, + /** Optional user-facing label shown in the timeline instead of the actual prompt (e.g. `/skill-name args` when the prompt is a skill invocation expansion) */ + @JsonProperty("displayPrompt") String displayPrompt + ) { + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionShutdownEvent.java b/src/generated/java/com/github/copilot/generated/SessionShutdownEvent.java similarity index 75% rename from src/generated/java/com/github/copilot/sdk/generated/SessionShutdownEvent.java rename to src/generated/java/com/github/copilot/generated/SessionShutdownEvent.java index 39b6cfcfab..03ad8e0275 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionShutdownEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionShutdownEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.shutdown} session event. + * Session event "session.shutdown". Session termination metrics including usage statistics, code changes, and shutdown reason * * @since 1.0.0 */ @@ -42,10 +42,14 @@ public record SessionShutdownEventData( @JsonProperty("errorReason") String errorReason, /** Total number of premium API requests used during the session */ @JsonProperty("totalPremiumRequests") Double totalPremiumRequests, + /** Session-wide accumulated nano-AI units cost */ + @JsonProperty("totalNanoAiu") Double totalNanoAiu, + /** Session-wide per-token-type accumulated token counts */ + @JsonProperty("tokenDetails") Map tokenDetails, /** Cumulative time spent in API calls during the session, in milliseconds */ - @JsonProperty("totalApiDurationMs") Double totalApiDurationMs, + @JsonProperty("totalApiDurationMs") Long totalApiDurationMs, /** Unix timestamp (milliseconds) when the session started */ - @JsonProperty("sessionStartTime") Double sessionStartTime, + @JsonProperty("sessionStartTime") Long sessionStartTime, /** Aggregate code change metrics for the session */ @JsonProperty("codeChanges") ShutdownCodeChanges codeChanges, /** Per-model usage breakdown, keyed by model identifier */ @@ -53,13 +57,13 @@ public record SessionShutdownEventData( /** Model that was selected at the time of shutdown */ @JsonProperty("currentModel") String currentModel, /** Total tokens in context window at shutdown */ - @JsonProperty("currentTokens") Double currentTokens, + @JsonProperty("currentTokens") Long currentTokens, /** System message token count at shutdown */ - @JsonProperty("systemTokens") Double systemTokens, + @JsonProperty("systemTokens") Long systemTokens, /** Non-system message token count at shutdown */ - @JsonProperty("conversationTokens") Double conversationTokens, + @JsonProperty("conversationTokens") Long conversationTokens, /** Tool definitions token count at shutdown */ - @JsonProperty("toolDefinitionsTokens") Double toolDefinitionsTokens + @JsonProperty("toolDefinitionsTokens") Long toolDefinitionsTokens ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionSkillsLoadedEvent.java b/src/generated/java/com/github/copilot/generated/SessionSkillsLoadedEvent.java similarity index 93% rename from src/generated/java/com/github/copilot/sdk/generated/SessionSkillsLoadedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionSkillsLoadedEvent.java index b5e64465df..f041184355 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionSkillsLoadedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionSkillsLoadedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.skills_loaded} session event. + * Session event "session.skills_loaded". * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionSnapshotRewindEvent.java b/src/generated/java/com/github/copilot/generated/SessionSnapshotRewindEvent.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/SessionSnapshotRewindEvent.java rename to src/generated/java/com/github/copilot/generated/SessionSnapshotRewindEvent.java index 8842827fbc..9c7e8765bb 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionSnapshotRewindEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionSnapshotRewindEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.snapshot_rewind} session event. + * Session event "session.snapshot_rewind". Session rewind details including target event and count of removed events * * @since 1.0.0 */ @@ -38,7 +38,7 @@ public record SessionSnapshotRewindEventData( /** Event ID that was rewound to; this event and all after it were removed */ @JsonProperty("upToEventId") String upToEventId, /** Number of events that were removed by the rewind */ - @JsonProperty("eventsRemoved") Double eventsRemoved + @JsonProperty("eventsRemoved") Long eventsRemoved ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionStartEvent.java b/src/generated/java/com/github/copilot/generated/SessionStartEvent.java similarity index 73% rename from src/generated/java/com/github/copilot/sdk/generated/SessionStartEvent.java rename to src/generated/java/com/github/copilot/generated/SessionStartEvent.java index 6d83575e85..0bb4b800fc 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionStartEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionStartEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.start} session event. + * Session event "session.start". Session initialization metadata including context and configuration * * @since 1.0.0 */ @@ -39,7 +39,7 @@ public record SessionStartEventData( /** Unique identifier for the session */ @JsonProperty("sessionId") String sessionId, /** Schema version number for the session event format */ - @JsonProperty("version") Double version, + @JsonProperty("version") Long version, /** Identifier of the software producing the events (e.g., "copilot-agent") */ @JsonProperty("producer") String producer, /** Version string of the Copilot application */ @@ -48,14 +48,18 @@ public record SessionStartEventData( @JsonProperty("startTime") OffsetDateTime startTime, /** Model selected at session creation time, if any */ @JsonProperty("selectedModel") String selectedModel, - /** Reasoning effort level used for model calls, if applicable (e.g. "low", "medium", "high", "xhigh") */ + /** Reasoning effort level used for model calls, if applicable (e.g. "none", "low", "medium", "high", "xhigh", "max") */ @JsonProperty("reasoningEffort") String reasoningEffort, + /** Reasoning summary mode used for model calls, if applicable (e.g. "none", "concise", "detailed") */ + @JsonProperty("reasoningSummary") ReasoningSummary reasoningSummary, /** Working directory and git context at session start */ @JsonProperty("context") WorkingDirectoryContext context, /** Whether the session was already in use by another client at start time */ @JsonProperty("alreadyInUse") Boolean alreadyInUse, - /** Whether this session supports remote steering via Mission Control */ - @JsonProperty("remoteSteerable") Boolean remoteSteerable + /** Whether this session supports remote steering via GitHub */ + @JsonProperty("remoteSteerable") Boolean remoteSteerable, + /** When set, identifies a parent session whose context this session continues β€” e.g., a detached headless rem-agent run launched on the parent's interactive shutdown. Telemetry from this session is reported under the parent's session_id. */ + @JsonProperty("detachedFromSpawningParentSessionId") String detachedFromSpawningParentSessionId ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionTaskCompleteEvent.java b/src/generated/java/com/github/copilot/generated/SessionTaskCompleteEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/SessionTaskCompleteEvent.java rename to src/generated/java/com/github/copilot/generated/SessionTaskCompleteEvent.java index 1af7e699bf..097f59c97c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionTaskCompleteEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionTaskCompleteEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.task_complete} session event. + * Session event "session.task_complete". Task completion notification with summary from the agent * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionTitleChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionTitleChangedEvent.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/SessionTitleChangedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionTitleChangedEvent.java index 3093301883..e835e8ae52 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionTitleChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionTitleChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.title_changed} session event. + * Session event "session.title_changed". Session title change payload containing the new display title * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionToolsUpdatedEvent.java b/src/generated/java/com/github/copilot/generated/SessionToolsUpdatedEvent.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/SessionToolsUpdatedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionToolsUpdatedEvent.java index a3b5313cf7..1d80e5b608 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionToolsUpdatedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionToolsUpdatedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.tools_updated} session event. + * Session event "session.tools_updated". * * @since 1.0.0 */ @@ -35,6 +35,7 @@ public final class SessionToolsUpdatedEvent extends SessionEvent { @JsonIgnoreProperties(ignoreUnknown = true) @JsonInclude(JsonInclude.Include.NON_NULL) public record SessionToolsUpdatedEventData( + /** Identifier of the model the resolved tools apply to. */ @JsonProperty("model") String model ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionTruncationEvent.java b/src/generated/java/com/github/copilot/generated/SessionTruncationEvent.java similarity index 72% rename from src/generated/java/com/github/copilot/sdk/generated/SessionTruncationEvent.java rename to src/generated/java/com/github/copilot/generated/SessionTruncationEvent.java index 103d1d0173..0a96601b6f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionTruncationEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionTruncationEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.truncation} session event. + * Session event "session.truncation". Conversation truncation statistics including token counts and removed content metrics * * @since 1.0.0 */ @@ -36,19 +36,19 @@ public final class SessionTruncationEvent extends SessionEvent { @JsonInclude(JsonInclude.Include.NON_NULL) public record SessionTruncationEventData( /** Maximum token count for the model's context window */ - @JsonProperty("tokenLimit") Double tokenLimit, + @JsonProperty("tokenLimit") Long tokenLimit, /** Total tokens in conversation messages before truncation */ - @JsonProperty("preTruncationTokensInMessages") Double preTruncationTokensInMessages, + @JsonProperty("preTruncationTokensInMessages") Long preTruncationTokensInMessages, /** Number of conversation messages before truncation */ - @JsonProperty("preTruncationMessagesLength") Double preTruncationMessagesLength, + @JsonProperty("preTruncationMessagesLength") Long preTruncationMessagesLength, /** Total tokens in conversation messages after truncation */ - @JsonProperty("postTruncationTokensInMessages") Double postTruncationTokensInMessages, + @JsonProperty("postTruncationTokensInMessages") Long postTruncationTokensInMessages, /** Number of conversation messages after truncation */ - @JsonProperty("postTruncationMessagesLength") Double postTruncationMessagesLength, + @JsonProperty("postTruncationMessagesLength") Long postTruncationMessagesLength, /** Number of tokens removed by truncation */ - @JsonProperty("tokensRemovedDuringTruncation") Double tokensRemovedDuringTruncation, + @JsonProperty("tokensRemovedDuringTruncation") Long tokensRemovedDuringTruncation, /** Number of messages removed by truncation */ - @JsonProperty("messagesRemovedDuringTruncation") Double messagesRemovedDuringTruncation, + @JsonProperty("messagesRemovedDuringTruncation") Long messagesRemovedDuringTruncation, /** Identifier of the component that performed truncation (e.g., "BasicTruncator") */ @JsonProperty("performedBy") String performedBy ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionUsageInfoEvent.java b/src/generated/java/com/github/copilot/generated/SessionUsageInfoEvent.java similarity index 77% rename from src/generated/java/com/github/copilot/sdk/generated/SessionUsageInfoEvent.java rename to src/generated/java/com/github/copilot/generated/SessionUsageInfoEvent.java index f83c360246..70ecfe01a5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionUsageInfoEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionUsageInfoEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.usage_info} session event. + * Session event "session.usage_info". Current context window usage statistics including token and message counts * * @since 1.0.0 */ @@ -36,17 +36,17 @@ public final class SessionUsageInfoEvent extends SessionEvent { @JsonInclude(JsonInclude.Include.NON_NULL) public record SessionUsageInfoEventData( /** Maximum token count for the model's context window */ - @JsonProperty("tokenLimit") Double tokenLimit, + @JsonProperty("tokenLimit") Long tokenLimit, /** Current number of tokens in the context window */ - @JsonProperty("currentTokens") Double currentTokens, + @JsonProperty("currentTokens") Long currentTokens, /** Current number of messages in the conversation */ - @JsonProperty("messagesLength") Double messagesLength, + @JsonProperty("messagesLength") Long messagesLength, /** Token count from system message(s) */ - @JsonProperty("systemTokens") Double systemTokens, + @JsonProperty("systemTokens") Long systemTokens, /** Token count from non-system messages (user, assistant, tool) */ - @JsonProperty("conversationTokens") Double conversationTokens, + @JsonProperty("conversationTokens") Long conversationTokens, /** Token count from tool definitions */ - @JsonProperty("toolDefinitionsTokens") Double toolDefinitionsTokens, + @JsonProperty("toolDefinitionsTokens") Long toolDefinitionsTokens, /** Whether this is the first usage_info event emitted in this session */ @JsonProperty("isInitial") Boolean isInitial ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionWarningEvent.java b/src/generated/java/com/github/copilot/generated/SessionWarningEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/SessionWarningEvent.java rename to src/generated/java/com/github/copilot/generated/SessionWarningEvent.java index 1870a26e8a..42b2eb8df9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionWarningEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionWarningEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.warning} session event. + * Session event "session.warning". Warning message for timeline display with categorization * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionWorkspaceFileChangedEvent.java b/src/generated/java/com/github/copilot/generated/SessionWorkspaceFileChangedEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/SessionWorkspaceFileChangedEvent.java rename to src/generated/java/com/github/copilot/generated/SessionWorkspaceFileChangedEvent.java index 9dedc7a5e3..85447d567f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionWorkspaceFileChangedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SessionWorkspaceFileChangedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code session.workspace_file_changed} session event. + * Session event "session.workspace_file_changed". Workspace file change details including path and operation type * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/ShutdownCodeChanges.java b/src/generated/java/com/github/copilot/generated/ShutdownCodeChanges.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/ShutdownCodeChanges.java rename to src/generated/java/com/github/copilot/generated/ShutdownCodeChanges.java index 1afb58b69b..1ca80ad715 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ShutdownCodeChanges.java +++ b/src/generated/java/com/github/copilot/generated/ShutdownCodeChanges.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -23,9 +23,9 @@ @JsonIgnoreProperties(ignoreUnknown = true) public record ShutdownCodeChanges( /** Total number of lines added during the session */ - @JsonProperty("linesAdded") Double linesAdded, + @JsonProperty("linesAdded") Long linesAdded, /** Total number of lines removed during the session */ - @JsonProperty("linesRemoved") Double linesRemoved, + @JsonProperty("linesRemoved") Long linesRemoved, /** List of file paths that were modified during the session */ @JsonProperty("filesModified") List filesModified ) { diff --git a/src/generated/java/com/github/copilot/generated/ShutdownModelMetric.java b/src/generated/java/com/github/copilot/generated/ShutdownModelMetric.java new file mode 100644 index 0000000000..b7eb37fd90 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ShutdownModelMetric.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ShutdownModelMetric` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ShutdownModelMetric( + /** Request count and cost metrics */ + @JsonProperty("requests") ShutdownModelMetricRequests requests, + /** Token usage breakdown */ + @JsonProperty("usage") ShutdownModelMetricUsage usage, + /** Accumulated nano-AI units cost for this model */ + @JsonProperty("totalNanoAiu") Double totalNanoAiu, + /** Token count details per type */ + @JsonProperty("tokenDetails") Map tokenDetails +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetricRequests.java b/src/generated/java/com/github/copilot/generated/ShutdownModelMetricRequests.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetricRequests.java rename to src/generated/java/com/github/copilot/generated/ShutdownModelMetricRequests.java index 1872a66038..ebc58271ee 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetricRequests.java +++ b/src/generated/java/com/github/copilot/generated/ShutdownModelMetricRequests.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -22,7 +22,7 @@ @JsonIgnoreProperties(ignoreUnknown = true) public record ShutdownModelMetricRequests( /** Total number of API requests made to this model */ - @JsonProperty("count") Double count, + @JsonProperty("count") Long count, /** Cumulative cost multiplier for requests to this model */ @JsonProperty("cost") Double cost ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetric.java b/src/generated/java/com/github/copilot/generated/ShutdownModelMetricTokenDetail.java similarity index 71% rename from src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetric.java rename to src/generated/java/com/github/copilot/generated/ShutdownModelMetricTokenDetail.java index e5cae14764..fe18de6c69 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetric.java +++ b/src/generated/java/com/github/copilot/generated/ShutdownModelMetricTokenDetail.java @@ -5,20 +5,23 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `ShutdownModelMetricTokenDetail` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) -public record ShutdownModelMetric( - /** Request count and cost metrics */ - @JsonProperty("requests") ShutdownModelMetricRequests requests, - /** Token usage breakdown */ - @JsonProperty("usage") ShutdownModelMetricUsage usage +public record ShutdownModelMetricTokenDetail( + /** Accumulated token count for this token type */ + @JsonProperty("tokenCount") Long tokenCount ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetricUsage.java b/src/generated/java/com/github/copilot/generated/ShutdownModelMetricUsage.java similarity index 77% rename from src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetricUsage.java rename to src/generated/java/com/github/copilot/generated/ShutdownModelMetricUsage.java index bd47eaeb53..09a61920db 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ShutdownModelMetricUsage.java +++ b/src/generated/java/com/github/copilot/generated/ShutdownModelMetricUsage.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -22,14 +22,14 @@ @JsonIgnoreProperties(ignoreUnknown = true) public record ShutdownModelMetricUsage( /** Total input tokens consumed across all requests to this model */ - @JsonProperty("inputTokens") Double inputTokens, + @JsonProperty("inputTokens") Long inputTokens, /** Total output tokens produced across all requests to this model */ - @JsonProperty("outputTokens") Double outputTokens, + @JsonProperty("outputTokens") Long outputTokens, /** Total tokens read from prompt cache across all requests */ - @JsonProperty("cacheReadTokens") Double cacheReadTokens, + @JsonProperty("cacheReadTokens") Long cacheReadTokens, /** Total tokens written to prompt cache across all requests */ - @JsonProperty("cacheWriteTokens") Double cacheWriteTokens, + @JsonProperty("cacheWriteTokens") Long cacheWriteTokens, /** Total reasoning tokens produced across all requests to this model */ - @JsonProperty("reasoningTokens") Double reasoningTokens + @JsonProperty("reasoningTokens") Long reasoningTokens ) { } diff --git a/src/generated/java/com/github/copilot/generated/ShutdownTokenDetail.java b/src/generated/java/com/github/copilot/generated/ShutdownTokenDetail.java new file mode 100644 index 0000000000..75db095c5f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ShutdownTokenDetail.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ShutdownTokenDetail` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ShutdownTokenDetail( + /** Accumulated token count for this token type */ + @JsonProperty("tokenCount") Long tokenCount +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/ShutdownType.java b/src/generated/java/com/github/copilot/generated/ShutdownType.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/ShutdownType.java rename to src/generated/java/com/github/copilot/generated/ShutdownType.java index fbc627df8f..288d0835f5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ShutdownType.java +++ b/src/generated/java/com/github/copilot/generated/ShutdownType.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/SkillInvokedEvent.java b/src/generated/java/com/github/copilot/generated/SkillInvokedEvent.java similarity index 67% rename from src/generated/java/com/github/copilot/sdk/generated/SkillInvokedEvent.java rename to src/generated/java/com/github/copilot/generated/SkillInvokedEvent.java index e6c696eb0b..681ad3f0ac 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SkillInvokedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SkillInvokedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code skill.invoked} session event. + * Session event "skill.invoked". Skill invocation details including content, allowed tools, and plugin metadata * * @since 1.0.0 */ @@ -44,12 +44,16 @@ public record SkillInvokedEventData( @JsonProperty("content") String content, /** Tool names that should be auto-approved when this skill is active */ @JsonProperty("allowedTools") List allowedTools, + /** Source identifier for where the skill was discovered. Known values include: project (workspace skill), inherited (parent-directory skill), personal-copilot (~/.copilot/skills), personal-agents (~/.agents/skills), personal-claude (~/.claude/skills), custom (configured directory), plugin (installed plugin), builtin (bundled runtime skill), and remote (org/enterprise skill) */ + @JsonProperty("source") String source, /** Name of the plugin this skill originated from, when applicable */ @JsonProperty("pluginName") String pluginName, /** Version of the plugin this skill originated from, when applicable */ @JsonProperty("pluginVersion") String pluginVersion, /** Description of the skill from its SKILL.md frontmatter */ - @JsonProperty("description") String description + @JsonProperty("description") String description, + /** What triggered the skill invocation: `user-invoked` (explicit user action, such as via a slash command or UI affordance), `agent-invoked` (agent requested the skill), or `context-load` (loaded as part of another context, such as preloading skills configured on a custom agent or subagent) */ + @JsonProperty("trigger") SkillInvokedTrigger trigger ) { } } diff --git a/src/generated/java/com/github/copilot/generated/SkillInvokedTrigger.java b/src/generated/java/com/github/copilot/generated/SkillInvokedTrigger.java new file mode 100644 index 0000000000..50ce54f7c3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SkillInvokedTrigger.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * What triggered the skill invocation: `user-invoked` (explicit user action, such as via a slash command or UI affordance), `agent-invoked` (agent requested the skill), or `context-load` (loaded as part of another context, such as preloading skills configured on a custom agent or subagent) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SkillInvokedTrigger { + /** The {@code user-invoked} variant. */ + USER_INVOKED("user-invoked"), + /** The {@code agent-invoked} variant. */ + AGENT_INVOKED("agent-invoked"), + /** The {@code context-load} variant. */ + CONTEXT_LOAD("context-load"); + + private final String value; + SkillInvokedTrigger(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SkillInvokedTrigger fromValue(String value) { + for (SkillInvokedTrigger v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SkillInvokedTrigger value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/SkillSource.java b/src/generated/java/com/github/copilot/generated/SkillSource.java new file mode 100644 index 0000000000..b681faaae8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/SkillSource.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Source location type (e.g., project, personal-copilot, plugin, builtin) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SkillSource { + /** The {@code project} variant. */ + PROJECT("project"), + /** The {@code inherited} variant. */ + INHERITED("inherited"), + /** The {@code personal-copilot} variant. */ + PERSONAL_COPILOT("personal-copilot"), + /** The {@code personal-agents} variant. */ + PERSONAL_AGENTS("personal-agents"), + /** The {@code plugin} variant. */ + PLUGIN("plugin"), + /** The {@code custom} variant. */ + CUSTOM("custom"), + /** The {@code builtin} variant. */ + BUILTIN("builtin"); + + private final String value; + SkillSource(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SkillSource fromValue(String value) { + for (SkillSource v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SkillSource value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SkillsLoadedSkill.java b/src/generated/java/com/github/copilot/generated/SkillsLoadedSkill.java similarity index 83% rename from src/generated/java/com/github/copilot/sdk/generated/SkillsLoadedSkill.java rename to src/generated/java/com/github/copilot/generated/SkillsLoadedSkill.java index 2183dad5c4..07ce97825e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SkillsLoadedSkill.java +++ b/src/generated/java/com/github/copilot/generated/SkillsLoadedSkill.java @@ -5,13 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `SkillsLoadedSkill` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) @@ -20,8 +25,8 @@ public record SkillsLoadedSkill( @JsonProperty("name") String name, /** Description of what the skill does */ @JsonProperty("description") String description, - /** Source location type of the skill (e.g., project, personal, plugin) */ - @JsonProperty("source") String source, + /** Source location type (e.g., project, personal-copilot, plugin, builtin) */ + @JsonProperty("source") SkillSource source, /** Whether the skill can be invoked by the user as a slash command */ @JsonProperty("userInvocable") Boolean userInvocable, /** Whether the skill is currently enabled */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SubagentCompletedEvent.java b/src/generated/java/com/github/copilot/generated/SubagentCompletedEvent.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/SubagentCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/SubagentCompletedEvent.java index b2cce20c31..98924809fa 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SubagentCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SubagentCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code subagent.completed} session event. + * Session event "subagent.completed". Sub-agent completion details for successful execution * * @since 1.0.0 */ @@ -44,11 +44,11 @@ public record SubagentCompletedEventData( /** Model used by the sub-agent */ @JsonProperty("model") String model, /** Total number of tool calls made by the sub-agent */ - @JsonProperty("totalToolCalls") Double totalToolCalls, + @JsonProperty("totalToolCalls") Long totalToolCalls, /** Total tokens (input + output) consumed by the sub-agent */ - @JsonProperty("totalTokens") Double totalTokens, + @JsonProperty("totalTokens") Long totalTokens, /** Wall-clock duration of the sub-agent execution in milliseconds */ - @JsonProperty("durationMs") Double durationMs + @JsonProperty("durationMs") Long durationMs ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SubagentDeselectedEvent.java b/src/generated/java/com/github/copilot/generated/SubagentDeselectedEvent.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/SubagentDeselectedEvent.java rename to src/generated/java/com/github/copilot/generated/SubagentDeselectedEvent.java index 3db9429dbf..2274ba66e0 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SubagentDeselectedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SubagentDeselectedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code subagent.deselected} session event. + * Session event "subagent.deselected". Empty payload; the event signals that the custom agent was deselected, returning to the default agent * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SubagentFailedEvent.java b/src/generated/java/com/github/copilot/generated/SubagentFailedEvent.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/SubagentFailedEvent.java rename to src/generated/java/com/github/copilot/generated/SubagentFailedEvent.java index 490532fc38..9264b5b0ee 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SubagentFailedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SubagentFailedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code subagent.failed} session event. + * Session event "subagent.failed". Sub-agent failure details including error message and agent information * * @since 1.0.0 */ @@ -46,11 +46,11 @@ public record SubagentFailedEventData( /** Model used by the sub-agent (if any model calls succeeded before failure) */ @JsonProperty("model") String model, /** Total number of tool calls made before the sub-agent failed */ - @JsonProperty("totalToolCalls") Double totalToolCalls, + @JsonProperty("totalToolCalls") Long totalToolCalls, /** Total tokens (input + output) consumed before the sub-agent failed */ - @JsonProperty("totalTokens") Double totalTokens, + @JsonProperty("totalTokens") Long totalTokens, /** Wall-clock duration of the sub-agent execution in milliseconds */ - @JsonProperty("durationMs") Double durationMs + @JsonProperty("durationMs") Long durationMs ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SubagentSelectedEvent.java b/src/generated/java/com/github/copilot/generated/SubagentSelectedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/SubagentSelectedEvent.java rename to src/generated/java/com/github/copilot/generated/SubagentSelectedEvent.java index e910bc9c27..7eb82019b1 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SubagentSelectedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SubagentSelectedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code subagent.selected} session event. + * Session event "subagent.selected". Custom agent selection details including name and available tools * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SubagentStartedEvent.java b/src/generated/java/com/github/copilot/generated/SubagentStartedEvent.java similarity index 83% rename from src/generated/java/com/github/copilot/sdk/generated/SubagentStartedEvent.java rename to src/generated/java/com/github/copilot/generated/SubagentStartedEvent.java index 6e9926bd4e..647bc824d0 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SubagentStartedEvent.java +++ b/src/generated/java/com/github/copilot/generated/SubagentStartedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code subagent.started} session event. + * Session event "subagent.started". Sub-agent startup details including parent tool call and agent information * * @since 1.0.0 */ @@ -42,7 +42,9 @@ public record SubagentStartedEventData( /** Human-readable display name of the sub-agent */ @JsonProperty("agentDisplayName") String agentDisplayName, /** Description of what the sub-agent does */ - @JsonProperty("agentDescription") String agentDescription + @JsonProperty("agentDescription") String agentDescription, + /** Model the sub-agent will run with, when known at start. Surfaced in the timeline for auto-selected sub-agents (e.g. rubber-duck). */ + @JsonProperty("model") String model ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/SystemMessageEvent.java b/src/generated/java/com/github/copilot/generated/SystemMessageEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/SystemMessageEvent.java rename to src/generated/java/com/github/copilot/generated/SystemMessageEvent.java index 07ae27000b..09d39a1992 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SystemMessageEvent.java +++ b/src/generated/java/com/github/copilot/generated/SystemMessageEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code system.message} session event. + * Session event "system.message". System/developer instruction content with role and optional template metadata * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/SystemMessageMetadata.java b/src/generated/java/com/github/copilot/generated/SystemMessageMetadata.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/SystemMessageMetadata.java rename to src/generated/java/com/github/copilot/generated/SystemMessageMetadata.java index 2b054dc943..f7f5fcbf24 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SystemMessageMetadata.java +++ b/src/generated/java/com/github/copilot/generated/SystemMessageMetadata.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/SystemMessageRole.java b/src/generated/java/com/github/copilot/generated/SystemMessageRole.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/SystemMessageRole.java rename to src/generated/java/com/github/copilot/generated/SystemMessageRole.java index 921b69ec06..3ccd8c31d6 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SystemMessageRole.java +++ b/src/generated/java/com/github/copilot/generated/SystemMessageRole.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/SystemNotificationEvent.java b/src/generated/java/com/github/copilot/generated/SystemNotificationEvent.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/SystemNotificationEvent.java rename to src/generated/java/com/github/copilot/generated/SystemNotificationEvent.java index 877b3db984..5a8a0fdfbc 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/SystemNotificationEvent.java +++ b/src/generated/java/com/github/copilot/generated/SystemNotificationEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code system.notification} session event. + * Session event "system.notification". System-generated notification for runtime events like background task completion * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteError.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteError.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteError.java rename to src/generated/java/com/github/copilot/generated/ToolExecutionCompleteError.java index dbdc99ba7e..ac4c7d843d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteError.java +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteError.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteEvent.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteEvent.java similarity index 79% rename from src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteEvent.java rename to src/generated/java/com/github/copilot/generated/ToolExecutionCompleteEvent.java index 6481374d1b..3cfa451895 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteEvent.java +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code tool.execution_complete} session event. + * Session event "tool.execution_complete". Tool execution completion results including success status, detailed output, and error information * * @since 1.0.0 */ @@ -52,6 +52,12 @@ public record ToolExecutionCompleteEventData( @JsonProperty("error") ToolExecutionCompleteError error, /** Tool-specific telemetry data (e.g., CodeQL check counts, grep match counts) */ @JsonProperty("toolTelemetry") Map toolTelemetry, + /** Identifier for the agent loop turn this tool was invoked in, matching the corresponding assistant.turn_start event */ + @JsonProperty("turnId") String turnId, + /** Tool definition metadata, present for MCP tools with MCP Apps support */ + @JsonProperty("toolDescription") ToolExecutionCompleteToolDescription toolDescription, + /** Whether this tool execution ran inside a sandbox container */ + @JsonProperty("sandboxed") Boolean sandboxed, /** Tool call ID of the parent tool invocation when this event originates from a sub-agent */ @JsonProperty("parentToolCallId") String parentToolCallId ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteResult.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteResult.java similarity index 84% rename from src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteResult.java rename to src/generated/java/com/github/copilot/generated/ToolExecutionCompleteResult.java index 8f2830541f..4ff3d2de00 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionCompleteResult.java +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -27,6 +27,8 @@ public record ToolExecutionCompleteResult( /** Full detailed tool result for UI/timeline display, preserving complete content such as diffs. Falls back to content when absent. */ @JsonProperty("detailedContent") String detailedContent, /** Structured content blocks (text, images, audio, resources) returned by the tool in their native format */ - @JsonProperty("contents") List contents + @JsonProperty("contents") List contents, + /** MCP Apps UI resource content for rendering in a sandboxed iframe */ + @JsonProperty("uiResource") ToolExecutionCompleteUIResource uiResource ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/McpServersLoadedServer.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescription.java similarity index 60% rename from src/generated/java/com/github/copilot/sdk/generated/McpServersLoadedServer.java rename to src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescription.java index 9e17180ded..53e614454b 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/McpServersLoadedServer.java +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescription.java @@ -5,24 +5,27 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Tool definition metadata, present for MCP tools with MCP Apps support + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) -public record McpServersLoadedServer( - /** Server name (config key) */ +public record ToolExecutionCompleteToolDescription( + /** Tool name */ @JsonProperty("name") String name, - /** Connection status: connected, failed, needs-auth, pending, disabled, or not_configured */ - @JsonProperty("status") McpServersLoadedServerStatus status, - /** Configuration source: user, workspace, plugin, or builtin */ - @JsonProperty("source") String source, - /** Error message if the server failed to connect */ - @JsonProperty("error") String error + /** Tool description */ + @JsonProperty("description") String description, + /** MCP Apps metadata for UI resource association */ + @JsonProperty("_meta") ToolExecutionCompleteToolDescriptionMeta meta ) { } diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMeta.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMeta.java new file mode 100644 index 0000000000..563358cfa3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMeta.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * MCP Apps metadata for UI resource association + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteToolDescriptionMeta( + /** Schema for the `ToolExecutionCompleteToolDescriptionMetaUI` type. */ + @JsonProperty("ui") ToolExecutionCompleteToolDescriptionMetaUI ui +) { +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMetaUI.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMetaUI.java new file mode 100644 index 0000000000..9acf435bc7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMetaUI.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ToolExecutionCompleteToolDescriptionMetaUI` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteToolDescriptionMetaUI( + /** URI of the UI resource */ + @JsonProperty("resourceUri") String resourceUri, + /** Who can access this tool */ + @JsonProperty("visibility") List visibility +) { +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMetaUIVisibility.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMetaUIVisibility.java new file mode 100644 index 0000000000..2510ddc0b1 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteToolDescriptionMetaUIVisibility.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Allowed values for the `ToolExecutionCompleteToolDescriptionMetaUIVisibility` enumeration. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ToolExecutionCompleteToolDescriptionMetaUIVisibility { + /** The {@code model} variant. */ + MODEL("model"), + /** The {@code app} variant. */ + APP("app"); + + private final String value; + ToolExecutionCompleteToolDescriptionMetaUIVisibility(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ToolExecutionCompleteToolDescriptionMetaUIVisibility fromValue(String value) { + for (ToolExecutionCompleteToolDescriptionMetaUIVisibility v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ToolExecutionCompleteToolDescriptionMetaUIVisibility value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResource.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResource.java new file mode 100644 index 0000000000..0d29bd4004 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResource.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * MCP Apps UI resource content for rendering in a sandboxed iframe + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteUIResource( + /** The ui:// URI of the resource */ + @JsonProperty("uri") String uri, + /** MIME type of the content */ + @JsonProperty("mimeType") String mimeType, + /** HTML content as a string */ + @JsonProperty("text") String text, + /** Base64-encoded HTML content */ + @JsonProperty("blob") String blob, + /** Resource-level UI metadata (CSP, permissions, visual preferences) */ + @JsonProperty("_meta") ToolExecutionCompleteUIResourceMeta meta +) { +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMeta.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMeta.java new file mode 100644 index 0000000000..6375222cc3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMeta.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Resource-level UI metadata (CSP, permissions, visual preferences) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteUIResourceMeta( + /** Schema for the `ToolExecutionCompleteUIResourceMetaUI` type. */ + @JsonProperty("ui") ToolExecutionCompleteUIResourceMetaUI ui +) { +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUI.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUI.java new file mode 100644 index 0000000000..3b9548a8ce --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUI.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ToolExecutionCompleteUIResourceMetaUI` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteUIResourceMetaUI( + /** Schema for the `ToolExecutionCompleteUIResourceMetaUICsp` type. */ + @JsonProperty("csp") ToolExecutionCompleteUIResourceMetaUICsp csp, + /** Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissions` type. */ + @JsonProperty("permissions") ToolExecutionCompleteUIResourceMetaUIPermissions permissions, + @JsonProperty("domain") String domain, + @JsonProperty("prefersBorder") Boolean prefersBorder +) { +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUICsp.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUICsp.java new file mode 100644 index 0000000000..0ccb8a3dbc --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUICsp.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ToolExecutionCompleteUIResourceMetaUICsp` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteUIResourceMetaUICsp( + @JsonProperty("connectDomains") List connectDomains, + @JsonProperty("resourceDomains") List resourceDomains, + @JsonProperty("frameDomains") List frameDomains, + @JsonProperty("baseUriDomains") List baseUriDomains +) { +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissions.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissions.java new file mode 100644 index 0000000000..8b1fc5dc9a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissions.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissions` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteUIResourceMetaUIPermissions( + /** Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsCamera` type. */ + @JsonProperty("camera") ToolExecutionCompleteUIResourceMetaUIPermissionsCamera camera, + /** Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone` type. */ + @JsonProperty("microphone") ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone microphone, + /** Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation` type. */ + @JsonProperty("geolocation") ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation geolocation, + /** Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite` type. */ + @JsonProperty("clipboardWrite") ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite clipboardWrite +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/CapabilitiesChangedUI.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsCamera.java similarity index 77% rename from src/generated/java/com/github/copilot/sdk/generated/CapabilitiesChangedUI.java rename to src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsCamera.java index 828733b046..300967e8ce 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/CapabilitiesChangedUI.java +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsCamera.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,15 +13,12 @@ import javax.annotation.processing.Generated; /** - * UI capability changes + * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsCamera` type. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) -public record CapabilitiesChangedUI( - /** Whether elicitation is now supported */ - @JsonProperty("elicitation") Boolean elicitation -) { +public record ToolExecutionCompleteUIResourceMetaUIPermissionsCamera() { } diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite.java new file mode 100644 index 0000000000..485a6946ce --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite() { +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation.java new file mode 100644 index 0000000000..30ed9bb545 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation() { +} diff --git a/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone.java b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone.java new file mode 100644 index 0000000000..1748ccb487 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone() { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionPartialResultEvent.java b/src/generated/java/com/github/copilot/generated/ToolExecutionPartialResultEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/ToolExecutionPartialResultEvent.java rename to src/generated/java/com/github/copilot/generated/ToolExecutionPartialResultEvent.java index 5fbddc5cca..9c43aa2ecc 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionPartialResultEvent.java +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionPartialResultEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code tool.execution_partial_result} session event. + * Session event "tool.execution_partial_result". Streaming tool execution output for incremental result display * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionProgressEvent.java b/src/generated/java/com/github/copilot/generated/ToolExecutionProgressEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/ToolExecutionProgressEvent.java rename to src/generated/java/com/github/copilot/generated/ToolExecutionProgressEvent.java index 2a77c05ffe..f3a7c1158a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionProgressEvent.java +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionProgressEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code tool.execution_progress} session event. + * Session event "tool.execution_progress". Tool execution progress notification with status message * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionStartEvent.java b/src/generated/java/com/github/copilot/generated/ToolExecutionStartEvent.java similarity index 80% rename from src/generated/java/com/github/copilot/sdk/generated/ToolExecutionStartEvent.java rename to src/generated/java/com/github/copilot/generated/ToolExecutionStartEvent.java index 7da7572864..7a46ea88cb 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ToolExecutionStartEvent.java +++ b/src/generated/java/com/github/copilot/generated/ToolExecutionStartEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code tool.execution_start} session event. + * Session event "tool.execution_start". Tool execution startup details including MCP server information when applicable * * @since 1.0.0 */ @@ -45,6 +45,10 @@ public record ToolExecutionStartEventData( @JsonProperty("mcpServerName") String mcpServerName, /** Original tool name on the MCP server, when the tool is an MCP tool */ @JsonProperty("mcpToolName") String mcpToolName, + /** Identifier for the agent loop turn this tool was invoked in, matching the corresponding assistant.turn_start event */ + @JsonProperty("turnId") String turnId, + /** When true, the tool output should be displayed expanded (verbatim) in the CLI timeline */ + @JsonProperty("displayVerbatim") Boolean displayVerbatim, /** Tool call ID of the parent tool invocation when this event originates from a sub-agent */ @JsonProperty("parentToolCallId") String parentToolCallId ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/ToolUserRequestedEvent.java b/src/generated/java/com/github/copilot/generated/ToolUserRequestedEvent.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/ToolUserRequestedEvent.java rename to src/generated/java/com/github/copilot/generated/ToolUserRequestedEvent.java index ac798fd3f3..1b4d519a99 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/ToolUserRequestedEvent.java +++ b/src/generated/java/com/github/copilot/generated/ToolUserRequestedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code tool.user_requested} session event. + * Session event "tool.user_requested". User-initiated tool invocation request with tool name and arguments * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/UnknownSessionEvent.java b/src/generated/java/com/github/copilot/generated/UnknownSessionEvent.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/UnknownSessionEvent.java rename to src/generated/java/com/github/copilot/generated/UnknownSessionEvent.java index cf56b4b4f6..8f1257cf9c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/UnknownSessionEvent.java +++ b/src/generated/java/com/github/copilot/generated/UnknownSessionEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/generated/java/com/github/copilot/sdk/generated/UserInputCompletedEvent.java b/src/generated/java/com/github/copilot/generated/UserInputCompletedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/UserInputCompletedEvent.java rename to src/generated/java/com/github/copilot/generated/UserInputCompletedEvent.java index 7b69bfd926..7750c9e702 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/UserInputCompletedEvent.java +++ b/src/generated/java/com/github/copilot/generated/UserInputCompletedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The {@code user_input.completed} session event. + * Session event "user_input.completed". User input request completion with the user's response * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/UserInputRequestedEvent.java b/src/generated/java/com/github/copilot/generated/UserInputRequestedEvent.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/UserInputRequestedEvent.java rename to src/generated/java/com/github/copilot/generated/UserInputRequestedEvent.java index 69581e20a2..e7ddb28592 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/UserInputRequestedEvent.java +++ b/src/generated/java/com/github/copilot/generated/UserInputRequestedEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code user_input.requested} session event. + * Session event "user_input.requested". User input request notification with question and optional predefined choices * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/UserMessageAgentMode.java b/src/generated/java/com/github/copilot/generated/UserMessageAgentMode.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/UserMessageAgentMode.java rename to src/generated/java/com/github/copilot/generated/UserMessageAgentMode.java index 6c1710602d..f6e7c60d7f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/UserMessageAgentMode.java +++ b/src/generated/java/com/github/copilot/generated/UserMessageAgentMode.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/UserMessageEvent.java b/src/generated/java/com/github/copilot/generated/UserMessageEvent.java similarity index 79% rename from src/generated/java/com/github/copilot/sdk/generated/UserMessageEvent.java rename to src/generated/java/com/github/copilot/generated/UserMessageEvent.java index 5d156082db..3e8e7520fb 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/UserMessageEvent.java +++ b/src/generated/java/com/github/copilot/generated/UserMessageEvent.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * The {@code user.message} session event. + * Session event "user.message". * * @since 1.0.0 */ @@ -44,14 +44,18 @@ public record UserMessageEventData( @JsonProperty("attachments") List attachments, /** Normalized document MIME types that were sent natively instead of through tagged_files XML */ @JsonProperty("supportedNativeDocumentMimeTypes") List supportedNativeDocumentMimeTypes, - /** Path-backed native document attachments that stayed on the tagged_files path flow because native upload would exceed the request size limit */ + /** Path-backed native document attachments that stayed on the tagged_files path flow because native upload could not read them or would exceed the request size limit */ @JsonProperty("nativeDocumentPathFallbackPaths") List nativeDocumentPathFallbackPaths, /** Origin of this message, used for timeline filtering (e.g., "skill-pdf" for skill-injected messages that should be hidden from the user) */ @JsonProperty("source") String source, /** The agent mode that was active when this message was sent */ @JsonProperty("agentMode") UserMessageAgentMode agentMode, + /** True when this user message was auto-injected by autopilot's continuation loop rather than typed by the user; used to distinguish autopilot-driven turns in telemetry. */ + @JsonProperty("isAutopilotContinuation") Boolean isAutopilotContinuation, /** CAPI interaction ID for correlating this user message with its turn */ - @JsonProperty("interactionId") String interactionId + @JsonProperty("interactionId") String interactionId, + /** Parent agent task ID for background telemetry correlated to this user turn */ + @JsonProperty("parentAgentTaskId") String parentAgentTaskId ) { } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/WorkingDirectoryContext.java b/src/generated/java/com/github/copilot/generated/WorkingDirectoryContext.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/WorkingDirectoryContext.java rename to src/generated/java/com/github/copilot/generated/WorkingDirectoryContext.java index b023859e2f..813cd5e02f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/WorkingDirectoryContext.java +++ b/src/generated/java/com/github/copilot/generated/WorkingDirectoryContext.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/WorkingDirectoryContextHostType.java b/src/generated/java/com/github/copilot/generated/WorkingDirectoryContextHostType.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/WorkingDirectoryContextHostType.java rename to src/generated/java/com/github/copilot/generated/WorkingDirectoryContextHostType.java index 4786b8bc0c..c87237a8de 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/WorkingDirectoryContextHostType.java +++ b/src/generated/java/com/github/copilot/generated/WorkingDirectoryContextHostType.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/WorkspaceFileChangedOperation.java b/src/generated/java/com/github/copilot/generated/WorkspaceFileChangedOperation.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/WorkspaceFileChangedOperation.java rename to src/generated/java/com/github/copilot/generated/WorkspaceFileChangedOperation.java index 7e21ec5484..a6347ed77c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/WorkspaceFileChangedOperation.java +++ b/src/generated/java/com/github/copilot/generated/WorkspaceFileChangedOperation.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: session-events.schema.json -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/generated/rpc/AbortReason.java b/src/generated/java/com/github/copilot/generated/rpc/AbortReason.java new file mode 100644 index 0000000000..a486400778 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/AbortReason.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Finite reason code describing why the current turn was aborted + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum AbortReason { + /** The {@code user_initiated} variant. */ + USER_INITIATED("user_initiated"), + /** The {@code remote_command} variant. */ + REMOTE_COMMAND("remote_command"), + /** The {@code user_abort} variant. */ + USER_ABORT("user_abort"); + + private final String value; + AbortReason(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static AbortReason fromValue(String value) { + for (AbortReason v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown AbortReason value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/AccountGetQuotaResult.java b/src/generated/java/com/github/copilot/generated/rpc/AccountGetQuotaResult.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/AccountGetQuotaResult.java rename to src/generated/java/com/github/copilot/generated/rpc/AccountGetQuotaResult.java index 47e3b55ee6..257a087565 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/AccountGetQuotaResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/AccountGetQuotaResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code account.getQuota} RPC method. + * Quota usage snapshots for the resolved user, keyed by quota type. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/AccountQuotaSnapshot.java b/src/generated/java/com/github/copilot/generated/rpc/AccountQuotaSnapshot.java similarity index 77% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/AccountQuotaSnapshot.java rename to src/generated/java/com/github/copilot/generated/rpc/AccountQuotaSnapshot.java index c6d8149300..88e7ba9c64 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/AccountQuotaSnapshot.java +++ b/src/generated/java/com/github/copilot/generated/rpc/AccountQuotaSnapshot.java @@ -5,20 +5,26 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import java.time.OffsetDateTime; import javax.annotation.processing.Generated; +/** + * Schema for the `AccountQuotaSnapshot` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record AccountQuotaSnapshot( /** Whether the user has an unlimited usage entitlement */ @JsonProperty("isUnlimitedEntitlement") Boolean isUnlimitedEntitlement, - /** Number of requests included in the entitlement */ + /** Number of requests included in the entitlement, or -1 for unlimited entitlements */ @JsonProperty("entitlementRequests") Long entitlementRequests, /** Number of requests used so far this period */ @JsonProperty("usedRequests") Long usedRequests, @@ -26,11 +32,11 @@ public record AccountQuotaSnapshot( @JsonProperty("usageAllowedWithExhaustedQuota") Boolean usageAllowedWithExhaustedQuota, /** Percentage of entitlement remaining */ @JsonProperty("remainingPercentage") Double remainingPercentage, - /** Number of overage requests made this period */ + /** Number of additional usage requests made this period */ @JsonProperty("overage") Double overage, - /** Whether overage is allowed when quota is exhausted */ + /** Whether additional usage is allowed when quota is exhausted */ @JsonProperty("overageAllowedWithExhaustedQuota") Boolean overageAllowedWithExhaustedQuota, /** Date when the quota resets (ISO 8601 string) */ - @JsonProperty("resetDate") String resetDate + @JsonProperty("resetDate") OffsetDateTime resetDate ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/AgentInfo.java b/src/generated/java/com/github/copilot/generated/rpc/AgentInfo.java new file mode 100644 index 0000000000..ce80893730 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/AgentInfo.java @@ -0,0 +1,49 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Schema for the `AgentInfo` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record AgentInfo( + /** Unique identifier of the custom agent */ + @JsonProperty("name") String name, + /** Human-readable display name */ + @JsonProperty("displayName") String displayName, + /** Description of the agent's purpose */ + @JsonProperty("description") String description, + /** Absolute local file path of the agent definition. Only set for file-based agents loaded from disk; remote agents do not have a path. */ + @JsonProperty("path") String path, + /** Stable identifier for selection. For most agents this is the same as `name`; for plugin/builtin agents it may differ. Always populated; defaults to `name` when no distinct id was assigned. */ + @JsonProperty("id") String id, + /** Where the agent definition was loaded from */ + @JsonProperty("source") AgentInfoSource source, + /** Whether the agent can be selected directly by the user. Agents marked `false` are subagent-only. */ + @JsonProperty("userInvocable") Boolean userInvocable, + /** Allowed tool names for this agent. Empty array means none; omitted means inherit defaults. */ + @JsonProperty("tools") List tools, + /** Preferred model id for this agent. When omitted, inherits the outer agent's model. */ + @JsonProperty("model") String model, + /** MCP server configurations attached to this agent, keyed by server name. Server config shape mirrors the MCP `mcpServers` schema. */ + @JsonProperty("mcpServers") Map mcpServers, + /** Skill names preloaded into this agent's context. Omitted means none. */ + @JsonProperty("skills") List skills +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/AgentInfoSource.java b/src/generated/java/com/github/copilot/generated/rpc/AgentInfoSource.java new file mode 100644 index 0000000000..6f8afe71e8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/AgentInfoSource.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Where the agent definition was loaded from + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum AgentInfoSource { + /** The {@code user} variant. */ + USER("user"), + /** The {@code project} variant. */ + PROJECT("project"), + /** The {@code inherited} variant. */ + INHERITED("inherited"), + /** The {@code remote} variant. */ + REMOTE("remote"), + /** The {@code plugin} variant. */ + PLUGIN("plugin"), + /** The {@code builtin} variant. */ + BUILTIN("builtin"); + + private final String value; + AgentInfoSource(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static AgentInfoSource fromValue(String value) { + for (AgentInfoSource v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown AgentInfoSource value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/AgentRegistrySpawnParams.java b/src/generated/java/com/github/copilot/generated/rpc/AgentRegistrySpawnParams.java new file mode 100644 index 0000000000..964aaede60 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/AgentRegistrySpawnParams.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Inputs to spawn a managed-server child via the controller's spawn delegate. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record AgentRegistrySpawnParams( + /** Working directory for the spawned child (must be an existing directory) */ + @JsonProperty("cwd") String cwd, + /** Custom or built-in agent name (e.g. 'explore'). When omitted, the child uses its own default. */ + @JsonProperty("agentName") String agentName, + /** Model identifier to apply to the new session */ + @JsonProperty("model") String model, + /** Friendly session name. Must satisfy validateSessionName: non-empty, no leading/trailing whitespace, <=100 chars, no control chars, no double quotes. */ + @JsonProperty("name") String name, + /** Permission posture for the new session. 'yolo' requires the controller-local session to currently be in allow-all mode. */ + @JsonProperty("permissionMode") AgentRegistrySpawnPermissionMode permissionMode, + /** Optional first user message. Forwarded to the caller (the CLI's spawn wrapper sends it post-attach via the standard LocalRpcSession.send path). */ + @JsonProperty("initialPrompt") String initialPrompt +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/AgentRegistrySpawnPermissionMode.java b/src/generated/java/com/github/copilot/generated/rpc/AgentRegistrySpawnPermissionMode.java new file mode 100644 index 0000000000..1d5b21fe0a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/AgentRegistrySpawnPermissionMode.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Permission posture for the new session. 'yolo' requires the controller-local session to currently be in allow-all mode. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum AgentRegistrySpawnPermissionMode { + /** The {@code default} variant. */ + DEFAULT("default"), + /** The {@code yolo} variant. */ + YOLO("yolo"); + + private final String value; + AgentRegistrySpawnPermissionMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static AgentRegistrySpawnPermissionMode fromValue(String value) { + for (AgentRegistrySpawnPermissionMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown AgentRegistrySpawnPermissionMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/AuthInfoType.java b/src/generated/java/com/github/copilot/generated/rpc/AuthInfoType.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/AuthInfoType.java rename to src/generated/java/com/github/copilot/generated/rpc/AuthInfoType.java index 89c5db85ce..1fb4b43ba4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/AuthInfoType.java +++ b/src/generated/java/com/github/copilot/generated/rpc/AuthInfoType.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/generated/rpc/CanvasAction.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasAction.java new file mode 100644 index 0000000000..36554ed767 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasAction.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas action that the agent or host can invoke. To discover the input schema for a particular action, call the list_canvas_capabilities tool. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasAction( + /** Action name exposed by the canvas provider */ + @JsonProperty("name") String name, + /** Description of the action */ + @JsonProperty("description") String description, + /** JSON Schema for the action input */ + @JsonProperty("inputSchema") Object inputSchema +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/CanvasCloseParams.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasCloseParams.java new file mode 100644 index 0000000000..d692c07e76 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasCloseParams.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas close parameters sent to the provider. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasCloseParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Owning provider identifier */ + @JsonProperty("extensionId") String extensionId, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId, + /** Canvas instance identifier */ + @JsonProperty("instanceId") String instanceId, + /** Host context supplied by the runtime. */ + @JsonProperty("host") CanvasHostContext host, + /** Session context supplied by the runtime. */ + @JsonProperty("session") CanvasSessionContext session +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelGetCurrentResult.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasHostContext.java similarity index 75% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelGetCurrentResult.java rename to src/generated/java/com/github/copilot/generated/rpc/CanvasHostContext.java index 7467fd4e8a..8dba8156e4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelGetCurrentResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasHostContext.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,15 +13,15 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.model.getCurrent} RPC method. + * Host context supplied by the runtime. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) -public record SessionModelGetCurrentResult( - /** Currently active model identifier */ - @JsonProperty("modelId") String modelId +public record CanvasHostContext( + /** Host capabilities */ + @JsonProperty("capabilities") CanvasHostContextCapabilities capabilities ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/CanvasHostContextCapabilities.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasHostContextCapabilities.java new file mode 100644 index 0000000000..a8118eeebf --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasHostContextCapabilities.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Host capabilities + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasHostContextCapabilities( + /** Whether canvas rendering is supported */ + @JsonProperty("canvases") Boolean canvases +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/CanvasInstanceAvailability.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasInstanceAvailability.java new file mode 100644 index 0000000000..aef2d81265 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasInstanceAvailability.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Runtime-controlled routing state for an open canvas instance. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum CanvasInstanceAvailability { + /** The {@code ready} variant. */ + READY("ready"), + /** The {@code stale} variant. */ + STALE("stale"); + + private final String value; + CanvasInstanceAvailability(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static CanvasInstanceAvailability fromValue(String value) { + for (CanvasInstanceAvailability v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown CanvasInstanceAvailability value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/CanvasInvokeActionParams.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasInvokeActionParams.java new file mode 100644 index 0000000000..8843a3bf04 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasInvokeActionParams.java @@ -0,0 +1,41 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas action invocation parameters sent to the provider. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasInvokeActionParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Owning provider identifier */ + @JsonProperty("extensionId") String extensionId, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId, + /** Canvas instance identifier */ + @JsonProperty("instanceId") String instanceId, + /** Action name to invoke */ + @JsonProperty("actionName") String actionName, + /** Action input */ + @JsonProperty("input") Object input, + /** Host context supplied by the runtime. */ + @JsonProperty("host") CanvasHostContext host, + /** Session context supplied by the runtime. */ + @JsonProperty("session") CanvasSessionContext session +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/CanvasOpenParams.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasOpenParams.java new file mode 100644 index 0000000000..95b0d8e643 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasOpenParams.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas open parameters sent to the provider. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasOpenParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Owning provider identifier */ + @JsonProperty("extensionId") String extensionId, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId, + /** Stable caller-supplied canvas instance identifier */ + @JsonProperty("instanceId") String instanceId, + /** Canvas open input */ + @JsonProperty("input") Object input, + /** Host context supplied by the runtime. */ + @JsonProperty("host") CanvasHostContext host, + /** Session context supplied by the runtime. */ + @JsonProperty("session") CanvasSessionContext session +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/CanvasOpenResult.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasOpenResult.java new file mode 100644 index 0000000000..9ce3aeede9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasOpenResult.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas open result returned by the provider. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasOpenResult( + /** URL for web-rendered canvases */ + @JsonProperty("url") String url, + /** Provider-supplied title */ + @JsonProperty("title") String title, + /** Provider-supplied status text */ + @JsonProperty("status") String status +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/CanvasSessionContext.java b/src/generated/java/com/github/copilot/generated/rpc/CanvasSessionContext.java new file mode 100644 index 0000000000..422d32e542 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/CanvasSessionContext.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session context supplied by the runtime. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CanvasSessionContext( + /** Active session working directory, when known. */ + @JsonProperty("workingDirectory") String workingDirectory +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/ConnectParams.java b/src/generated/java/com/github/copilot/generated/rpc/ConnectParams.java new file mode 100644 index 0000000000..590dd01479 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ConnectParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Optional connection token presented by the SDK client during the handshake. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ConnectParams( + /** Connection token; required when the server was started with COPILOT_CONNECTION_TOKEN */ + @JsonProperty("token") String token +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/ConnectResult.java b/src/generated/java/com/github/copilot/generated/rpc/ConnectResult.java new file mode 100644 index 0000000000..d24d120e12 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ConnectResult.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Handshake result reporting the server's protocol version and package version on success. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ConnectResult( + /** Always true on success */ + @JsonProperty("ok") Boolean ok, + /** Server protocol version number */ + @JsonProperty("protocolVersion") Long protocolVersion, + /** Server package version */ + @JsonProperty("version") String version +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadata.java b/src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadata.java new file mode 100644 index 0000000000..9e3a4a57f2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadata.java @@ -0,0 +1,48 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.time.OffsetDateTime; +import javax.annotation.processing.Generated; + +/** + * Metadata for a connected remote session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ConnectedRemoteSessionMetadata( + /** SDK session ID for the connected remote session. */ + @JsonProperty("sessionId") String sessionId, + /** Optional friendly session name. */ + @JsonProperty("name") String name, + /** Optional session summary. */ + @JsonProperty("summary") String summary, + /** Session start time as an ISO 8601 string. */ + @JsonProperty("startTime") OffsetDateTime startTime, + /** Last session update time as an ISO 8601 string. */ + @JsonProperty("modifiedTime") OffsetDateTime modifiedTime, + /** Repository associated with the connected remote session. */ + @JsonProperty("repository") ConnectedRemoteSessionMetadataRepository repository, + /** Pull request number associated with the session. */ + @JsonProperty("pullRequestNumber") Long pullRequestNumber, + /** Original remote resource identifier. */ + @JsonProperty("resourceId") String resourceId, + /** Neutral SDK discriminator for the connected remote session kind. */ + @JsonProperty("kind") ConnectedRemoteSessionMetadataKind kind, + /** Remote session staleness deadline as an ISO 8601 string. */ + @JsonProperty("staleAt") OffsetDateTime staleAt, + /** Remote session state returned by the backing service. */ + @JsonProperty("state") String state +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadataKind.java b/src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadataKind.java new file mode 100644 index 0000000000..8d22c1dd4d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadataKind.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Neutral SDK discriminator for the connected remote session kind. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ConnectedRemoteSessionMetadataKind { + /** The {@code remote-session} variant. */ + REMOTE_SESSION("remote-session"), + /** The {@code coding-agent} variant. */ + CODING_AGENT("coding-agent"); + + private final String value; + ConnectedRemoteSessionMetadataKind(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ConnectedRemoteSessionMetadataKind fromValue(String value) { + for (ConnectedRemoteSessionMetadataKind v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ConnectedRemoteSessionMetadataKind value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/AgentInfo.java b/src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadataRepository.java similarity index 64% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/AgentInfo.java rename to src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadataRepository.java index edd34eb947..7daa17bd16 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/AgentInfo.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ConnectedRemoteSessionMetadataRepository.java @@ -5,22 +5,27 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Repository associated with the connected remote session. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) -public record AgentInfo( - /** Unique identifier of the custom agent */ +public record ConnectedRemoteSessionMetadataRepository( + /** Repository owner or organization login. */ + @JsonProperty("owner") String owner, + /** Repository name. */ @JsonProperty("name") String name, - /** Human-readable display name */ - @JsonProperty("displayName") String displayName, - /** Description of the agent's purpose */ - @JsonProperty("description") String description + /** Branch associated with the remote session. */ + @JsonProperty("branch") String branch ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/DiscoveredCanvas.java b/src/generated/java/com/github/copilot/generated/rpc/DiscoveredCanvas.java new file mode 100644 index 0000000000..e6e02745c8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/DiscoveredCanvas.java @@ -0,0 +1,40 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Canvas available in the current session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record DiscoveredCanvas( + /** Human-readable canvas name */ + @JsonProperty("displayName") String displayName, + /** Short, single-sentence description shown to the agent in canvas catalogs. */ + @JsonProperty("description") String description, + /** JSON Schema for canvas open input */ + @JsonProperty("inputSchema") Object inputSchema, + /** Actions the agent or host may invoke on an open instance */ + @JsonProperty("actions") List actions, + /** Owning provider identifier */ + @JsonProperty("extensionId") String extensionId, + /** Owning extension display name, when available */ + @JsonProperty("extensionName") String extensionName, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServer.java b/src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServer.java similarity index 75% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServer.java rename to src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServer.java index 0429b26e13..4f8fb22ac4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServer.java +++ b/src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServer.java @@ -5,23 +5,28 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `DiscoveredMcpServer` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record DiscoveredMcpServer( /** Server name (config key) */ @JsonProperty("name") String name, - /** Server transport type: stdio, http, sse, or memory (local configs are normalized to stdio) */ + /** Server transport type: stdio, http, sse (deprecated), or memory */ @JsonProperty("type") DiscoveredMcpServerType type, - /** Configuration source */ - @JsonProperty("source") DiscoveredMcpServerSource source, + /** Configuration source: user, workspace, plugin, or builtin */ + @JsonProperty("source") McpServerSource source, /** Whether the server is enabled (not in the disabled list) */ @JsonProperty("enabled") Boolean enabled ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServerSource.java b/src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServerSource.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServerSource.java rename to src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServerSource.java index 6bc451b349..89d7322fb7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServerSource.java +++ b/src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServerSource.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServerType.java b/src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServerType.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServerType.java rename to src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServerType.java index 1ed5520217..bc9b9cefd9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/DiscoveredMcpServerType.java +++ b/src/generated/java/com/github/copilot/generated/rpc/DiscoveredMcpServerType.java @@ -5,12 +5,12 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; /** - * Server transport type: stdio, http, sse, or memory (local configs are normalized to stdio) + * Server transport type: stdio, http, sse (deprecated), or memory * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/EventsAgentScope.java b/src/generated/java/com/github/copilot/generated/rpc/EventsAgentScope.java new file mode 100644 index 0000000000..5e85b19269 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/EventsAgentScope.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Agent-scope filter: 'primary' returns only main-agent events plus events whose type starts with 'subagent.' (matching the typed-subscription default behavior); 'all' returns events from all agents (matching wildcard-subscription behavior). Default is 'all' to preserve wildcard semantics for catch-up callers. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum EventsAgentScope { + /** The {@code primary} variant. */ + PRIMARY("primary"), + /** The {@code all} variant. */ + ALL("all"); + + private final String value; + EventsAgentScope(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static EventsAgentScope fromValue(String value) { + for (EventsAgentScope v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown EventsAgentScope value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/EventsCursorStatus.java b/src/generated/java/com/github/copilot/generated/rpc/EventsCursorStatus.java new file mode 100644 index 0000000000..31c1fcab01 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/EventsCursorStatus.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Cursor status: 'ok' means the cursor was applied successfully; 'expired' means the cursor referred to an event that no longer exists in history (e.g. truncated or compacted away) and the read started from the beginning of the remaining history. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum EventsCursorStatus { + /** The {@code ok} variant. */ + OK("ok"), + /** The {@code expired} variant. */ + EXPIRED("expired"); + + private final String value; + EventsCursorStatus(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static EventsCursorStatus fromValue(String value) { + for (EventsCursorStatus v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown EventsCursorStatus value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/Extension.java b/src/generated/java/com/github/copilot/generated/rpc/Extension.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/Extension.java rename to src/generated/java/com/github/copilot/generated/rpc/Extension.java index 14af4c77d8..13bb851b49 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/Extension.java +++ b/src/generated/java/com/github/copilot/generated/rpc/Extension.java @@ -5,13 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `Extension` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ExtensionSource.java b/src/generated/java/com/github/copilot/generated/rpc/ExtensionSource.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ExtensionSource.java rename to src/generated/java/com/github/copilot/generated/rpc/ExtensionSource.java index 2ec3da3973..aeb7a144f6 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ExtensionSource.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ExtensionSource.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ExtensionStatus.java b/src/generated/java/com/github/copilot/generated/rpc/ExtensionStatus.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ExtensionStatus.java rename to src/generated/java/com/github/copilot/generated/rpc/ExtensionStatus.java index 241a5cd60c..34592663f1 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ExtensionStatus.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ExtensionStatus.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/HistoryCompactContextWindow.java b/src/generated/java/com/github/copilot/generated/rpc/HistoryCompactContextWindow.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/HistoryCompactContextWindow.java rename to src/generated/java/com/github/copilot/generated/rpc/HistoryCompactContextWindow.java index 4ac1a8fa9e..6c223f029d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/HistoryCompactContextWindow.java +++ b/src/generated/java/com/github/copilot/generated/rpc/HistoryCompactContextWindow.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/InstalledPlugin.java b/src/generated/java/com/github/copilot/generated/rpc/InstalledPlugin.java new file mode 100644 index 0000000000..c274dfb1a2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/InstalledPlugin.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `InstalledPlugin` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record InstalledPlugin( + /** Plugin name */ + @JsonProperty("name") String name, + /** Marketplace the plugin came from (empty string for direct repo installs) */ + @JsonProperty("marketplace") String marketplace, + /** Version installed (if available) */ + @JsonProperty("version") String version, + /** Installation timestamp */ + @JsonProperty("installed_at") String installedAt, + /** Whether the plugin is currently enabled */ + @JsonProperty("enabled") Boolean enabled, + /** Path where the plugin is cached locally */ + @JsonProperty("cache_path") String cachePath, + /** Source for direct repo installs (when marketplace is empty) */ + @JsonProperty("source") Object source +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSources.java b/src/generated/java/com/github/copilot/generated/rpc/InstructionsSources.java similarity index 74% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSources.java rename to src/generated/java/com/github/copilot/generated/rpc/InstructionsSources.java index 7ca267a1b8..9e6a458d40 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSources.java +++ b/src/generated/java/com/github/copilot/generated/rpc/InstructionsSources.java @@ -5,13 +5,19 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; import javax.annotation.processing.Generated; +/** + * Schema for the `InstructionsSources` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) @@ -28,9 +34,11 @@ public record InstructionsSources( @JsonProperty("type") InstructionsSourcesType type, /** Where this source lives β€” used for UI grouping */ @JsonProperty("location") InstructionsSourcesLocation location, - /** Glob pattern from frontmatter β€” when set, this instruction applies only to matching files */ - @JsonProperty("applyTo") String applyTo, + /** Glob pattern(s) from frontmatter β€” when set, this instruction applies only to matching files */ + @JsonProperty("applyTo") List applyTo, /** Short description (body after frontmatter) for use in instruction tables */ - @JsonProperty("description") String description + @JsonProperty("description") String description, + /** When true, this source starts disabled and must be toggled on by the user */ + @JsonProperty("defaultDisabled") Boolean defaultDisabled ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSourcesLocation.java b/src/generated/java/com/github/copilot/generated/rpc/InstructionsSourcesLocation.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSourcesLocation.java rename to src/generated/java/com/github/copilot/generated/rpc/InstructionsSourcesLocation.java index 01b702cfe8..23db5a3671 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSourcesLocation.java +++ b/src/generated/java/com/github/copilot/generated/rpc/InstructionsSourcesLocation.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; @@ -21,7 +21,9 @@ public enum InstructionsSourcesLocation { /** The {@code repository} variant. */ REPOSITORY("repository"), /** The {@code working-directory} variant. */ - WORKING_DIRECTORY("working-directory"); + WORKING_DIRECTORY("working-directory"), + /** The {@code plugin} variant. */ + PLUGIN("plugin"); private final String value; InstructionsSourcesLocation(String value) { this.value = value; } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSourcesType.java b/src/generated/java/com/github/copilot/generated/rpc/InstructionsSourcesType.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSourcesType.java rename to src/generated/java/com/github/copilot/generated/rpc/InstructionsSourcesType.java index 8de1319422..6fed6c4bf8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/InstructionsSourcesType.java +++ b/src/generated/java/com/github/copilot/generated/rpc/InstructionsSourcesType.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; @@ -27,7 +27,9 @@ public enum InstructionsSourcesType { /** The {@code nested-agents} variant. */ NESTED_AGENTS("nested-agents"), /** The {@code child-instructions} variant. */ - CHILD_INSTRUCTIONS("child-instructions"); + CHILD_INSTRUCTIONS("child-instructions"), + /** The {@code plugin} variant. */ + PLUGIN("plugin"); private final String value; InstructionsSourcesType(String value) { this.value = value; } diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsDiagnoseCapability.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsDiagnoseCapability.java new file mode 100644 index 0000000000..c4da1ff72e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsDiagnoseCapability.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Capability negotiation snapshot + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpAppsDiagnoseCapability( + /** Whether the session has the `mcp-apps` capability */ + @JsonProperty("sessionHasMcpApps") Boolean sessionHasMcpApps, + /** Whether the MCP_APPS feature flag (or COPILOT_MCP_APPS env override) is on */ + @JsonProperty("featureFlagEnabled") Boolean featureFlagEnabled, + /** Whether the runtime advertises `extensions.io.modelcontextprotocol/ui` to MCP servers */ + @JsonProperty("advertised") Boolean advertised +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsDiagnoseServer.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsDiagnoseServer.java new file mode 100644 index 0000000000..c63ef75bb4 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsDiagnoseServer.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * What the server returned for this session + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpAppsDiagnoseServer( + /** Whether the named server is currently connected */ + @JsonProperty("connected") Boolean connected, + /** Total tools returned by the server's tools/list */ + @JsonProperty("toolCount") Double toolCount, + /** Tools whose `_meta.ui` is populated (resourceUri and/or visibility set) */ + @JsonProperty("toolsWithUiMeta") Double toolsWithUiMeta, + /** Up to 5 tool names with `_meta.ui` for quick inspection */ + @JsonProperty("sampleToolNames") List sampleToolNames +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetails.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetails.java new file mode 100644 index 0000000000..dd98b2c354 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetails.java @@ -0,0 +1,40 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Current host context + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpAppsHostContextDetails( + /** UI theme preference per SEP-1865 */ + @JsonProperty("theme") McpAppsHostContextDetailsTheme theme, + /** BCP-47 locale, e.g. 'en-US' */ + @JsonProperty("locale") String locale, + /** IANA timezone, e.g. 'America/New_York' */ + @JsonProperty("timeZone") String timeZone, + /** Current display mode (SEP-1865) */ + @JsonProperty("displayMode") McpAppsHostContextDetailsDisplayMode displayMode, + /** Display modes the host supports */ + @JsonProperty("availableDisplayModes") List availableDisplayModes, + /** Platform type for responsive design */ + @JsonProperty("platform") McpAppsHostContextDetailsPlatform platform, + /** Host application identifier */ + @JsonProperty("userAgent") String userAgent +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsAvailableDisplayMode.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsAvailableDisplayMode.java new file mode 100644 index 0000000000..b5588d611d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsAvailableDisplayMode.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Allowed values for the `McpAppsHostContextDetailsAvailableDisplayMode` enumeration. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpAppsHostContextDetailsAvailableDisplayMode { + /** The {@code inline} variant. */ + INLINE("inline"), + /** The {@code fullscreen} variant. */ + FULLSCREEN("fullscreen"), + /** The {@code pip} variant. */ + PIP("pip"); + + private final String value; + McpAppsHostContextDetailsAvailableDisplayMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpAppsHostContextDetailsAvailableDisplayMode fromValue(String value) { + for (McpAppsHostContextDetailsAvailableDisplayMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpAppsHostContextDetailsAvailableDisplayMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsDisplayMode.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsDisplayMode.java new file mode 100644 index 0000000000..56a03b007d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsDisplayMode.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Current display mode (SEP-1865) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpAppsHostContextDetailsDisplayMode { + /** The {@code inline} variant. */ + INLINE("inline"), + /** The {@code fullscreen} variant. */ + FULLSCREEN("fullscreen"), + /** The {@code pip} variant. */ + PIP("pip"); + + private final String value; + McpAppsHostContextDetailsDisplayMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpAppsHostContextDetailsDisplayMode fromValue(String value) { + for (McpAppsHostContextDetailsDisplayMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpAppsHostContextDetailsDisplayMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsPlatform.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsPlatform.java new file mode 100644 index 0000000000..4c03c3aec4 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsPlatform.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Platform type for responsive design + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpAppsHostContextDetailsPlatform { + /** The {@code web} variant. */ + WEB("web"), + /** The {@code desktop} variant. */ + DESKTOP("desktop"), + /** The {@code mobile} variant. */ + MOBILE("mobile"); + + private final String value; + McpAppsHostContextDetailsPlatform(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpAppsHostContextDetailsPlatform fromValue(String value) { + for (McpAppsHostContextDetailsPlatform v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpAppsHostContextDetailsPlatform value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsTheme.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsTheme.java new file mode 100644 index 0000000000..e80e3b5543 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsHostContextDetailsTheme.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * UI theme preference per SEP-1865 + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpAppsHostContextDetailsTheme { + /** The {@code light} variant. */ + LIGHT("light"), + /** The {@code dark} variant. */ + DARK("dark"); + + private final String value; + McpAppsHostContextDetailsTheme(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpAppsHostContextDetailsTheme fromValue(String value) { + for (McpAppsHostContextDetailsTheme v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpAppsHostContextDetailsTheme value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsResourceContent.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsResourceContent.java new file mode 100644 index 0000000000..25850f372a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsResourceContent.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Schema for the `McpAppsResourceContent` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpAppsResourceContent( + /** The resource URI (typically ui://...) */ + @JsonProperty("uri") String uri, + /** MIME type of the content */ + @JsonProperty("mimeType") String mimeType, + /** Text content (e.g. HTML) */ + @JsonProperty("text") String text, + /** Base64-encoded binary content */ + @JsonProperty("blob") String blob, + /** Resource-level metadata (CSP, permissions, etc.) */ + @JsonProperty("_meta") Map meta +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetails.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetails.java new file mode 100644 index 0000000000..bb37e8d942 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetails.java @@ -0,0 +1,40 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Host context advertised to MCP App guests + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpAppsSetHostContextDetails( + /** UI theme preference per SEP-1865 */ + @JsonProperty("theme") McpAppsSetHostContextDetailsTheme theme, + /** BCP-47 locale, e.g. 'en-US' */ + @JsonProperty("locale") String locale, + /** IANA timezone, e.g. 'America/New_York' */ + @JsonProperty("timeZone") String timeZone, + /** Current display mode (SEP-1865) */ + @JsonProperty("displayMode") McpAppsSetHostContextDetailsDisplayMode displayMode, + /** Display modes the host supports */ + @JsonProperty("availableDisplayModes") List availableDisplayModes, + /** Platform type for responsive design */ + @JsonProperty("platform") McpAppsSetHostContextDetailsPlatform platform, + /** Host application identifier */ + @JsonProperty("userAgent") String userAgent +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsAvailableDisplayMode.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsAvailableDisplayMode.java new file mode 100644 index 0000000000..e207f5416d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsAvailableDisplayMode.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Allowed values for the `McpAppsSetHostContextDetailsAvailableDisplayMode` enumeration. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpAppsSetHostContextDetailsAvailableDisplayMode { + /** The {@code inline} variant. */ + INLINE("inline"), + /** The {@code fullscreen} variant. */ + FULLSCREEN("fullscreen"), + /** The {@code pip} variant. */ + PIP("pip"); + + private final String value; + McpAppsSetHostContextDetailsAvailableDisplayMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpAppsSetHostContextDetailsAvailableDisplayMode fromValue(String value) { + for (McpAppsSetHostContextDetailsAvailableDisplayMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpAppsSetHostContextDetailsAvailableDisplayMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsDisplayMode.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsDisplayMode.java new file mode 100644 index 0000000000..a42a88a4a1 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsDisplayMode.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Current display mode (SEP-1865) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpAppsSetHostContextDetailsDisplayMode { + /** The {@code inline} variant. */ + INLINE("inline"), + /** The {@code fullscreen} variant. */ + FULLSCREEN("fullscreen"), + /** The {@code pip} variant. */ + PIP("pip"); + + private final String value; + McpAppsSetHostContextDetailsDisplayMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpAppsSetHostContextDetailsDisplayMode fromValue(String value) { + for (McpAppsSetHostContextDetailsDisplayMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpAppsSetHostContextDetailsDisplayMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsPlatform.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsPlatform.java new file mode 100644 index 0000000000..306b717d60 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsPlatform.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Platform type for responsive design + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpAppsSetHostContextDetailsPlatform { + /** The {@code web} variant. */ + WEB("web"), + /** The {@code desktop} variant. */ + DESKTOP("desktop"), + /** The {@code mobile} variant. */ + MOBILE("mobile"); + + private final String value; + McpAppsSetHostContextDetailsPlatform(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpAppsSetHostContextDetailsPlatform fromValue(String value) { + for (McpAppsSetHostContextDetailsPlatform v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpAppsSetHostContextDetailsPlatform value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsTheme.java b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsTheme.java new file mode 100644 index 0000000000..09e15319e8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpAppsSetHostContextDetailsTheme.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * UI theme preference per SEP-1865 + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpAppsSetHostContextDetailsTheme { + /** The {@code light} variant. */ + LIGHT("light"), + /** The {@code dark} variant. */ + DARK("dark"); + + private final String value; + McpAppsSetHostContextDetailsTheme(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpAppsSetHostContextDetailsTheme fromValue(String value) { + for (McpAppsSetHostContextDetailsTheme v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpAppsSetHostContextDetailsTheme value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigAddParams.java b/src/generated/java/com/github/copilot/generated/rpc/McpConfigAddParams.java similarity index 83% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigAddParams.java rename to src/generated/java/com/github/copilot/generated/rpc/McpConfigAddParams.java index 0f33fdcdad..64ffd39517 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigAddParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpConfigAddParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code mcp.config.add} RPC method. + * MCP server name and configuration to add to user configuration. * * @since 1.0.0 */ @@ -23,7 +23,7 @@ public record McpConfigAddParams( /** Unique name for the MCP server */ @JsonProperty("name") String name, - /** MCP server configuration (local/stdio or remote/http) */ + /** MCP server configuration (stdio process or remote HTTP/SSE) */ @JsonProperty("config") Object config ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigDisableParams.java b/src/generated/java/com/github/copilot/generated/rpc/McpConfigDisableParams.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigDisableParams.java rename to src/generated/java/com/github/copilot/generated/rpc/McpConfigDisableParams.java index cef02e1ae8..e71c12f93c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigDisableParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpConfigDisableParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code mcp.config.disable} RPC method. + * MCP server names to disable for new sessions. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigEnableParams.java b/src/generated/java/com/github/copilot/generated/rpc/McpConfigEnableParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigEnableParams.java rename to src/generated/java/com/github/copilot/generated/rpc/McpConfigEnableParams.java index 78ba76b7b8..952d6fb685 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigEnableParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpConfigEnableParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code mcp.config.enable} RPC method. + * MCP server names to enable for new sessions. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigListResult.java b/src/generated/java/com/github/copilot/generated/rpc/McpConfigListResult.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigListResult.java rename to src/generated/java/com/github/copilot/generated/rpc/McpConfigListResult.java index 1391b451cb..4d66442281 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigListResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpConfigListResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code mcp.config.list} RPC method. + * User-configured MCP servers, keyed by server name. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigRemoveParams.java b/src/generated/java/com/github/copilot/generated/rpc/McpConfigRemoveParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigRemoveParams.java rename to src/generated/java/com/github/copilot/generated/rpc/McpConfigRemoveParams.java index 6c24be4311..840b72abf7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigRemoveParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpConfigRemoveParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code mcp.config.remove} RPC method. + * MCP server name to remove from user configuration. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigUpdateParams.java b/src/generated/java/com/github/copilot/generated/rpc/McpConfigUpdateParams.java similarity index 82% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigUpdateParams.java rename to src/generated/java/com/github/copilot/generated/rpc/McpConfigUpdateParams.java index 327234515f..f2c2b0faaf 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpConfigUpdateParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpConfigUpdateParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code mcp.config.update} RPC method. + * MCP server name and replacement configuration to write to user configuration. * * @since 1.0.0 */ @@ -23,7 +23,7 @@ public record McpConfigUpdateParams( /** Name of the MCP server to update */ @JsonProperty("name") String name, - /** MCP server configuration (local/stdio or remote/http) */ + /** MCP server configuration (stdio process or remote HTTP/SSE) */ @JsonProperty("config") Object config ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpDiscoverParams.java b/src/generated/java/com/github/copilot/generated/rpc/McpDiscoverParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpDiscoverParams.java rename to src/generated/java/com/github/copilot/generated/rpc/McpDiscoverParams.java index 24d52cffcd..ed7b32bb7d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpDiscoverParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpDiscoverParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code mcp.discover} RPC method. + * Optional working directory used as context for MCP server discovery. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpDiscoverResult.java b/src/generated/java/com/github/copilot/generated/rpc/McpDiscoverResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpDiscoverResult.java rename to src/generated/java/com/github/copilot/generated/rpc/McpDiscoverResult.java index 3f107275bf..b000b16ffc 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpDiscoverResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpDiscoverResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code mcp.discover} RPC method. + * MCP servers discovered from user, workspace, plugin, and built-in sources. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpExecuteSamplingRequest.java b/src/generated/java/com/github/copilot/generated/rpc/McpExecuteSamplingRequest.java new file mode 100644 index 0000000000..4fd862ebd0 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpExecuteSamplingRequest.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Raw MCP CreateMessageRequest params, as received in the `sampling.requested` event. Treated as opaque at the schema layer; the runtime converts the embedded MCP messages into the OpenAI chat-completion shape internally. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpExecuteSamplingRequest() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpExecuteSamplingResult.java b/src/generated/java/com/github/copilot/generated/rpc/McpExecuteSamplingResult.java new file mode 100644 index 0000000000..18a838d30c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpExecuteSamplingResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * MCP CreateMessageResult payload (with optional 'tools' extension), present when action='success'. Treated as opaque at the schema layer; consumers should construct/consume it per the MCP CreateMessageResult shape. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record McpExecuteSamplingResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpSamplingExecutionAction.java b/src/generated/java/com/github/copilot/generated/rpc/McpSamplingExecutionAction.java new file mode 100644 index 0000000000..d0a3802f7a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpSamplingExecutionAction.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Outcome of the sampling inference. 'success' produced a response; 'failure' encountered an error (including agent-side rejection by content filter or criteria); 'cancelled' the caller cancelled this execution via cancelSamplingExecution. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpSamplingExecutionAction { + /** The {@code success} variant. */ + SUCCESS("success"), + /** The {@code failure} variant. */ + FAILURE("failure"), + /** The {@code cancelled} variant. */ + CANCELLED("cancelled"); + + private final String value; + McpSamplingExecutionAction(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpSamplingExecutionAction fromValue(String value) { + for (McpSamplingExecutionAction v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpSamplingExecutionAction value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpServer.java b/src/generated/java/com/github/copilot/generated/rpc/McpServer.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpServer.java rename to src/generated/java/com/github/copilot/generated/rpc/McpServer.java index 2f4b2b36ef..7da05f6591 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpServer.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpServer.java @@ -5,13 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `McpServer` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpServerSource.java b/src/generated/java/com/github/copilot/generated/rpc/McpServerSource.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpServerSource.java rename to src/generated/java/com/github/copilot/generated/rpc/McpServerSource.java index 3ffe4b7978..f709df96dd 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpServerSource.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpServerSource.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpServerStatus.java b/src/generated/java/com/github/copilot/generated/rpc/McpServerStatus.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/McpServerStatus.java rename to src/generated/java/com/github/copilot/generated/rpc/McpServerStatus.java index 06bec4f307..db463a7377 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/McpServerStatus.java +++ b/src/generated/java/com/github/copilot/generated/rpc/McpServerStatus.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/generated/rpc/McpSetEnvValueModeDetails.java b/src/generated/java/com/github/copilot/generated/rpc/McpSetEnvValueModeDetails.java new file mode 100644 index 0000000000..dda0c02ca3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/McpSetEnvValueModeDetails.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * How environment-variable values supplied to MCP servers are resolved. "direct" passes literal string values; "indirect" treats values as references (e.g. names of environment variables on the host) that the runtime resolves before launch. Defaults to the runtime's startup mode; clients that intentionally launch MCP servers with literal values (e.g. CLI prompt mode and ACP) set this to "direct". + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum McpSetEnvValueModeDetails { + /** The {@code direct} variant. */ + DIRECT("direct"), + /** The {@code indirect} variant. */ + INDIRECT("indirect"); + + private final String value; + McpSetEnvValueModeDetails(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static McpSetEnvValueModeDetails fromValue(String value) { + for (McpSetEnvValueModeDetails v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown McpSetEnvValueModeDetails value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotCurrentMode.java b/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotCurrentMode.java new file mode 100644 index 0000000000..2d6c7eb574 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotCurrentMode.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * The current agent mode for this session (e.g., 'interactive', 'plan', 'autopilot') + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum MetadataSnapshotCurrentMode { + /** The {@code interactive} variant. */ + INTERACTIVE("interactive"), + /** The {@code plan} variant. */ + PLAN("plan"), + /** The {@code autopilot} variant. */ + AUTOPILOT("autopilot"); + + private final String value; + MetadataSnapshotCurrentMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static MetadataSnapshotCurrentMode fromValue(String value) { + for (MetadataSnapshotCurrentMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown MetadataSnapshotCurrentMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadata.java b/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadata.java new file mode 100644 index 0000000000..88b6dede32 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadata.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Remote-session-specific metadata. Populated only when `isRemote` is true. Fields are immutable for the lifetime of the session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record MetadataSnapshotRemoteMetadata( + /** The original resource identifier (task ID or PR node ID), preserved across event-replay reconstructions. Falls back to `sessionId` when absent. */ + @JsonProperty("resourceId") String resourceId, + /** The repository the remote session targets. */ + @JsonProperty("repository") MetadataSnapshotRemoteMetadataRepository repository, + /** The pull request number the remote session is associated with, if any. */ + @JsonProperty("pullRequestNumber") Long pullRequestNumber, + /** Whether the remote task originated from Copilot Coding Agent (cca) or a CLI `--remote` invocation. */ + @JsonProperty("taskType") MetadataSnapshotRemoteMetadataTaskType taskType +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadataRepository.java b/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadataRepository.java new file mode 100644 index 0000000000..cc0bb65329 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadataRepository.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The repository the remote session targets. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record MetadataSnapshotRemoteMetadataRepository( + /** The GitHub owner (user or organization) of the target repository. */ + @JsonProperty("owner") String owner, + /** The GitHub repository name (without owner). */ + @JsonProperty("name") String name, + /** The branch the remote session is operating on. */ + @JsonProperty("branch") String branch +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadataTaskType.java b/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadataTaskType.java new file mode 100644 index 0000000000..da019b5f7c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/MetadataSnapshotRemoteMetadataTaskType.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Whether the remote task originated from Copilot Coding Agent (cca) or a CLI `--remote` invocation. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum MetadataSnapshotRemoteMetadataTaskType { + /** The {@code cca} variant. */ + CCA("cca"), + /** The {@code cli} variant. */ + CLI("cli"); + + private final String value; + MetadataSnapshotRemoteMetadataTaskType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static MetadataSnapshotRemoteMetadataTaskType fromValue(String value) { + for (MetadataSnapshotRemoteMetadataTaskType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown MetadataSnapshotRemoteMetadataTaskType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/Model.java b/src/generated/java/com/github/copilot/generated/rpc/Model.java similarity index 78% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/Model.java rename to src/generated/java/com/github/copilot/generated/rpc/Model.java index 9ba457cecb..0904519165 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/Model.java +++ b/src/generated/java/com/github/copilot/generated/rpc/Model.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,6 +13,11 @@ import java.util.List; import javax.annotation.processing.Generated; +/** + * Schema for the `Model` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) @@ -30,6 +35,10 @@ public record Model( /** Supported reasoning effort levels (only present if model supports reasoning effort) */ @JsonProperty("supportedReasoningEfforts") List supportedReasoningEfforts, /** Default reasoning effort level (only present if model supports reasoning effort) */ - @JsonProperty("defaultReasoningEffort") String defaultReasoningEffort + @JsonProperty("defaultReasoningEffort") String defaultReasoningEffort, + /** Model capability category for grouping in the model picker */ + @JsonProperty("modelPickerCategory") ModelPickerCategory modelPickerCategory, + /** Relative cost tier for token-based billing users */ + @JsonProperty("modelPickerPriceCategory") ModelPickerPriceCategory modelPickerPriceCategory ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelBilling.java b/src/generated/java/com/github/copilot/generated/rpc/ModelBilling.java similarity index 79% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelBilling.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelBilling.java index 656f5383d5..94a8188f16 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelBilling.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelBilling.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -22,6 +22,8 @@ @JsonIgnoreProperties(ignoreUnknown = true) public record ModelBilling( /** Billing cost multiplier relative to the base rate */ - @JsonProperty("multiplier") Double multiplier + @JsonProperty("multiplier") Double multiplier, + /** Token-level pricing information for this model */ + @JsonProperty("tokenPrices") ModelBillingTokenPrices tokenPrices ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/ModelBillingTokenPrices.java b/src/generated/java/com/github/copilot/generated/rpc/ModelBillingTokenPrices.java new file mode 100644 index 0000000000..756ccaa025 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelBillingTokenPrices.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Token-level pricing information for this model + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ModelBillingTokenPrices( + /** AI Credits cost per billing batch of input tokens */ + @JsonProperty("inputPrice") Double inputPrice, + /** AI Credits cost per billing batch of output tokens */ + @JsonProperty("outputPrice") Double outputPrice, + /** AI Credits cost per billing batch of cached tokens */ + @JsonProperty("cachePrice") Double cachePrice, + /** Number of tokens per standard billing batch */ + @JsonProperty("batchSize") Long batchSize, + /** Maximum context window tokens for the default tier */ + @JsonProperty("contextMax") Long contextMax, + /** Long context tier pricing (available for models with extended context windows) */ + @JsonProperty("longContext") ModelBillingTokenPricesLongContext longContext +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/ModelBillingTokenPricesLongContext.java b/src/generated/java/com/github/copilot/generated/rpc/ModelBillingTokenPricesLongContext.java new file mode 100644 index 0000000000..983742c19f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelBillingTokenPricesLongContext.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Long context tier pricing (available for models with extended context windows) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ModelBillingTokenPricesLongContext( + /** AI Credits cost per billing batch of input tokens */ + @JsonProperty("inputPrice") Double inputPrice, + /** AI Credits cost per billing batch of output tokens */ + @JsonProperty("outputPrice") Double outputPrice, + /** AI Credits cost per billing batch of cached tokens */ + @JsonProperty("cachePrice") Double cachePrice, + /** Maximum context window tokens for the long context tier */ + @JsonProperty("contextMax") Long contextMax +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilities.java b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilities.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilities.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelCapabilities.java index 4c6b5e3af5..168a72099b 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilities.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilities.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesLimits.java b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesLimits.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesLimits.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesLimits.java index 8adf6812b2..694e2a2ea5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesLimits.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesLimits.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesLimitsVision.java b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesLimitsVision.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesLimitsVision.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesLimitsVision.java index cbfc7c3b89..d7f8e71544 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesLimitsVision.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesLimitsVision.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverride.java b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverride.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverride.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverride.java index 1ec67824ec..1433a7b5e6 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverride.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverride.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideLimits.java b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideLimits.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideLimits.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideLimits.java index 8794ae2589..c0de367f33 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideLimits.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideLimits.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -21,10 +21,13 @@ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record ModelCapabilitiesOverrideLimits( + /** Maximum number of prompt/input tokens */ @JsonProperty("max_prompt_tokens") Long maxPromptTokens, + /** Maximum number of output/completion tokens */ @JsonProperty("max_output_tokens") Long maxOutputTokens, /** Maximum total context window size in tokens */ @JsonProperty("max_context_window_tokens") Long maxContextWindowTokens, + /** Vision-specific limits */ @JsonProperty("vision") ModelCapabilitiesOverrideLimitsVision vision ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideLimitsVision.java b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideLimitsVision.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideLimitsVision.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideLimitsVision.java index 5d53ca6b82..86339787d3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideLimitsVision.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideLimitsVision.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,6 +13,11 @@ import java.util.List; import javax.annotation.processing.Generated; +/** + * Vision-specific limits + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideSupports.java b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideSupports.java similarity index 84% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideSupports.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideSupports.java index bc8e3f4952..ec1da750d8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesOverrideSupports.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesOverrideSupports.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -21,7 +21,9 @@ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record ModelCapabilitiesOverrideSupports( + /** Whether this model supports vision/image input */ @JsonProperty("vision") Boolean vision, + /** Whether this model supports reasoning effort configuration */ @JsonProperty("reasoningEffort") Boolean reasoningEffort ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesSupports.java b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesSupports.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesSupports.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesSupports.java index f898f130f5..91a98b423d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelCapabilitiesSupports.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelCapabilitiesSupports.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/ModelPickerCategory.java b/src/generated/java/com/github/copilot/generated/rpc/ModelPickerCategory.java new file mode 100644 index 0000000000..ab36abfd9f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelPickerCategory.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Model capability category for grouping in the model picker + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ModelPickerCategory { + /** The {@code lightweight} variant. */ + LIGHTWEIGHT("lightweight"), + /** The {@code versatile} variant. */ + VERSATILE("versatile"), + /** The {@code powerful} variant. */ + POWERFUL("powerful"); + + private final String value; + ModelPickerCategory(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ModelPickerCategory fromValue(String value) { + for (ModelPickerCategory v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ModelPickerCategory value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/ModelPickerPriceCategory.java b/src/generated/java/com/github/copilot/generated/rpc/ModelPickerPriceCategory.java new file mode 100644 index 0000000000..8f70503957 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelPickerPriceCategory.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Relative cost tier for token-based billing users + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ModelPickerPriceCategory { + /** The {@code low} variant. */ + LOW("low"), + /** The {@code medium} variant. */ + MEDIUM("medium"), + /** The {@code high} variant. */ + HIGH("high"), + /** The {@code very_high} variant. */ + VERY_HIGH("very_high"); + + private final String value; + ModelPickerPriceCategory(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ModelPickerPriceCategory fromValue(String value) { + for (ModelPickerPriceCategory v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ModelPickerPriceCategory value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelPolicy.java b/src/generated/java/com/github/copilot/generated/rpc/ModelPolicy.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelPolicy.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelPolicy.java index d3d218bec2..f37fb85d07 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelPolicy.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelPolicy.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -22,7 +22,7 @@ @JsonIgnoreProperties(ignoreUnknown = true) public record ModelPolicy( /** Current policy state for this model */ - @JsonProperty("state") String state, + @JsonProperty("state") ModelPolicyState state, /** Usage terms or conditions for this model */ @JsonProperty("terms") String terms ) { diff --git a/src/generated/java/com/github/copilot/generated/rpc/ModelPolicyState.java b/src/generated/java/com/github/copilot/generated/rpc/ModelPolicyState.java new file mode 100644 index 0000000000..525d57ca6e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelPolicyState.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Current policy state for this model + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ModelPolicyState { + /** The {@code enabled} variant. */ + ENABLED("enabled"), + /** The {@code disabled} variant. */ + DISABLED("disabled"), + /** The {@code unconfigured} variant. */ + UNCONFIGURED("unconfigured"); + + private final String value; + ModelPolicyState(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ModelPolicyState fromValue(String value) { + for (ModelPolicyState v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ModelPolicyState value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelsListResult.java b/src/generated/java/com/github/copilot/generated/rpc/ModelsListResult.java similarity index 85% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ModelsListResult.java rename to src/generated/java/com/github/copilot/generated/rpc/ModelsListResult.java index a56eeb9d6e..0ae1acfcec 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ModelsListResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ModelsListResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code models.list} RPC method. + * List of Copilot models available to the resolved user, including capabilities and billing metadata. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/OpenCanvasInstance.java b/src/generated/java/com/github/copilot/generated/rpc/OpenCanvasInstance.java new file mode 100644 index 0000000000..5b373ee23e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/OpenCanvasInstance.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Open canvas instance snapshot. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record OpenCanvasInstance( + /** Stable caller-supplied canvas instance identifier */ + @JsonProperty("instanceId") String instanceId, + /** Owning provider identifier */ + @JsonProperty("extensionId") String extensionId, + /** Owning extension display name, when available */ + @JsonProperty("extensionName") String extensionName, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId, + /** Rendered title */ + @JsonProperty("title") String title, + /** Provider-supplied status text */ + @JsonProperty("status") String status, + /** URL for web-rendered canvases */ + @JsonProperty("url") String url, + /** Input supplied when the instance was opened */ + @JsonProperty("input") Object input, + /** Whether this snapshot came from an idempotent reopen */ + @JsonProperty("reopen") Boolean reopen, + /** Runtime-controlled routing state for an open canvas instance. */ + @JsonProperty("availability") CanvasInstanceAvailability availability +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/OptionsUpdateEnvValueMode.java b/src/generated/java/com/github/copilot/generated/rpc/OptionsUpdateEnvValueMode.java new file mode 100644 index 0000000000..7be82f9d5b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/OptionsUpdateEnvValueMode.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * How env values are passed to MCP servers (`direct` inlines literal values; `indirect` resolves at launch). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum OptionsUpdateEnvValueMode { + /** The {@code direct} variant. */ + DIRECT("direct"), + /** The {@code indirect} variant. */ + INDIRECT("indirect"); + + private final String value; + OptionsUpdateEnvValueMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static OptionsUpdateEnvValueMode fromValue(String value) { + for (OptionsUpdateEnvValueMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown OptionsUpdateEnvValueMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/OptionsUpdateToolFilterPrecedence.java b/src/generated/java/com/github/copilot/generated/rpc/OptionsUpdateToolFilterPrecedence.java new file mode 100644 index 0000000000..57fdc6daea --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/OptionsUpdateToolFilterPrecedence.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Controls how availableTools (allowlist) and excludedTools (denylist) combine when both are set. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum OptionsUpdateToolFilterPrecedence { + /** The {@code available} variant. */ + AVAILABLE("available"), + /** The {@code excluded} variant. */ + EXCLUDED("excluded"); + + private final String value; + OptionsUpdateToolFilterPrecedence(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static OptionsUpdateToolFilterPrecedence fromValue(String value) { + for (OptionsUpdateToolFilterPrecedence v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown OptionsUpdateToolFilterPrecedence value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PendingPermissionRequest.java b/src/generated/java/com/github/copilot/generated/rpc/PendingPermissionRequest.java new file mode 100644 index 0000000000..de370ca5d6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PendingPermissionRequest.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `PendingPermissionRequest` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PendingPermissionRequest( + /** Unique identifier for the pending permission request */ + @JsonProperty("requestId") String requestId, + /** The user-facing permission prompt details (commands, write, read, mcp, url, memory, custom-tool, path, hook) */ + @JsonProperty("request") Object request +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionLocationType.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionLocationType.java new file mode 100644 index 0000000000..1b00c5bf55 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionLocationType.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Whether the location is a git repo or directory + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionLocationType { + /** The {@code repo} variant. */ + REPO("repo"), + /** The {@code dir} variant. */ + DIR("dir"); + + private final String value; + PermissionLocationType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionLocationType fromValue(String value) { + for (PermissionLocationType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionLocationType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionPathsConfig.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionPathsConfig.java new file mode 100644 index 0000000000..29aef6c66f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionPathsConfig.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * If specified, replaces the session's path-permission policy. The runtime constructs the appropriate PathManager based on these inputs (rooted at the session's working directory). Omit to leave the current path policy unchanged. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionPathsConfig( + /** If true, the runtime allows access to all paths without prompting. Equivalent to constructing an UnrestrictedPathManager. */ + @JsonProperty("unrestricted") Boolean unrestricted, + /** Additional directories to allow tool access to (in addition to the session's working directory). When `unrestricted` is true, these are still pre-populated on the UnrestrictedPathManager so they remain visible via getDirectories() (e.g. for @-mention completion). */ + @JsonProperty("additionalDirectories") List additionalDirectories, + /** Whether to include the system temp directory in the allowed list (defaults to true). Ignored when `unrestricted` is true. */ + @JsonProperty("includeTempDirectory") Boolean includeTempDirectory, + /** Workspace root path (special-cased to be allowed even before the directory exists). Ignored when `unrestricted` is true. */ + @JsonProperty("workspacePath") String workspacePath +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionRule.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionRule.java new file mode 100644 index 0000000000..7980e0e832 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionRule.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `PermissionRule` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionRule( + /** The rule kind, such as Shell or GitHubMCP */ + @JsonProperty("kind") String kind, + /** Argument value matched against the request, or null when the rule kind has no argument (e.g. 'read', 'write', 'memory'). */ + @JsonProperty("argument") String argument +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionRulesSet.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionRulesSet.java new file mode 100644 index 0000000000..7cc00563f5 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionRulesSet.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * If specified, replaces the session's approved/denied permission rules. Omit to leave the current rules unchanged. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionRulesSet( + /** Rules that auto-approve matching requests */ + @JsonProperty("approved") List approved, + /** Rules that auto-deny matching requests */ + @JsonProperty("denied") List denied +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionUrlsConfig.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionUrlsConfig.java new file mode 100644 index 0000000000..728e7b40dd --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionUrlsConfig.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * If specified, replaces the session's URL-permission policy. The runtime constructs a fresh DefaultUrlManager based on these inputs. Omit to leave the current URL policy unchanged. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionUrlsConfig( + /** If true, the runtime allows access to all URLs without prompting. Initial allow-list is ignored when this is true. */ + @JsonProperty("unrestricted") Boolean unrestricted, + /** Initial list of allowed URL/domain patterns. Patterns may include path components. Ignored when `unrestricted` is true. */ + @JsonProperty("initialAllowed") List initialAllowed +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicy.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicy.java new file mode 100644 index 0000000000..61108c16bb --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicy.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Schema for the `PermissionsConfigureAdditionalContentExclusionPolicy` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionsConfigureAdditionalContentExclusionPolicy( + @JsonProperty("rules") List rules, + @JsonProperty("last_updated_at") Object lastUpdatedAt, + /** Allowed values for the `PermissionsConfigureAdditionalContentExclusionPolicyScope` enumeration. */ + @JsonProperty("scope") PermissionsConfigureAdditionalContentExclusionPolicyScope scope +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyRule.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyRule.java new file mode 100644 index 0000000000..c6c7f649a9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyRule.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Schema for the `PermissionsConfigureAdditionalContentExclusionPolicyRule` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionsConfigureAdditionalContentExclusionPolicyRule( + @JsonProperty("paths") List paths, + @JsonProperty("ifAnyMatch") List ifAnyMatch, + @JsonProperty("ifNoneMatch") List ifNoneMatch, + /** Schema for the `PermissionsConfigureAdditionalContentExclusionPolicyRuleSource` type. */ + @JsonProperty("source") PermissionsConfigureAdditionalContentExclusionPolicyRuleSource source +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyRuleSource.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyRuleSource.java new file mode 100644 index 0000000000..a5d4a45f32 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyRuleSource.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `PermissionsConfigureAdditionalContentExclusionPolicyRuleSource` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionsConfigureAdditionalContentExclusionPolicyRuleSource( + @JsonProperty("name") String name, + @JsonProperty("type") String type +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyScope.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyScope.java new file mode 100644 index 0000000000..f006888b79 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionsConfigureAdditionalContentExclusionPolicyScope.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Allowed values for the `PermissionsConfigureAdditionalContentExclusionPolicyScope` enumeration. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionsConfigureAdditionalContentExclusionPolicyScope { + /** The {@code repo} variant. */ + REPO("repo"), + /** The {@code all} variant. */ + ALL("all"); + + private final String value; + PermissionsConfigureAdditionalContentExclusionPolicyScope(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionsConfigureAdditionalContentExclusionPolicyScope fromValue(String value) { + for (PermissionsConfigureAdditionalContentExclusionPolicyScope v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionsConfigureAdditionalContentExclusionPolicyScope value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionsModifyRulesScope.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionsModifyRulesScope.java new file mode 100644 index 0000000000..f574befcfd --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionsModifyRulesScope.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Whether the change applies to ephemeral session-scoped rules (cleared at session end) or to location-scoped rules persisted via the location-permissions config file. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionsModifyRulesScope { + /** The {@code session} variant. */ + SESSION("session"), + /** The {@code location} variant. */ + LOCATION("location"); + + private final String value; + PermissionsModifyRulesScope(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionsModifyRulesScope fromValue(String value) { + for (PermissionsModifyRulesScope v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionsModifyRulesScope value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/PermissionsSetApproveAllSource.java b/src/generated/java/com/github/copilot/generated/rpc/PermissionsSetApproveAllSource.java new file mode 100644 index 0000000000..b86b09dfa3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/PermissionsSetApproveAllSource.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Optional source for allow-all telemetry. Defaults to `rpc` when omitted for SDK callers. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionsSetApproveAllSource { + /** The {@code cli_flag} variant. */ + CLI_FLAG("cli_flag"), + /** The {@code slash_command} variant. */ + SLASH_COMMAND("slash_command"), + /** The {@code autopilot_confirmation} variant. */ + AUTOPILOT_CONFIRMATION("autopilot_confirmation"), + /** The {@code rpc} variant. */ + RPC("rpc"); + + private final String value; + PermissionsSetApproveAllSource(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionsSetApproveAllSource fromValue(String value) { + for (PermissionsSetApproveAllSource v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionsSetApproveAllSource value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/PingParams.java b/src/generated/java/com/github/copilot/generated/rpc/PingParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/PingParams.java rename to src/generated/java/com/github/copilot/generated/rpc/PingParams.java index 892d5cbb2d..2e00e6cac2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/PingParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/PingParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code ping} RPC method. + * Optional message to echo back to the caller. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/PingResult.java b/src/generated/java/com/github/copilot/generated/rpc/PingResult.java similarity index 75% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/PingResult.java rename to src/generated/java/com/github/copilot/generated/rpc/PingResult.java index b91b2fb02b..ded50ecbdd 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/PingResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/PingResult.java @@ -5,15 +5,16 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import java.time.OffsetDateTime; import javax.annotation.processing.Generated; /** - * Result for the {@code ping} RPC method. + * Server liveness response, including the echoed message, current server timestamp, and protocol version. * * @since 1.0.0 */ @@ -23,8 +24,8 @@ public record PingResult( /** Echoed message (or default greeting) */ @JsonProperty("message") String message, - /** Server timestamp in milliseconds */ - @JsonProperty("timestamp") Long timestamp, + /** ISO 8601 timestamp when the server handled the ping */ + @JsonProperty("timestamp") OffsetDateTime timestamp, /** Server protocol version number */ @JsonProperty("protocolVersion") Long protocolVersion ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/Plugin.java b/src/generated/java/com/github/copilot/generated/rpc/Plugin.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/Plugin.java rename to src/generated/java/com/github/copilot/generated/rpc/Plugin.java index 64edf086ec..b10cd31cf7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/Plugin.java +++ b/src/generated/java/com/github/copilot/generated/rpc/Plugin.java @@ -5,13 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `Plugin` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) diff --git a/src/generated/java/com/github/copilot/generated/rpc/QueuePendingItems.java b/src/generated/java/com/github/copilot/generated/rpc/QueuePendingItems.java new file mode 100644 index 0000000000..bfbc87f463 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/QueuePendingItems.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `QueuePendingItems` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record QueuePendingItems( + /** Whether this item is a queued user message or a queued slash command / model change */ + @JsonProperty("kind") QueuePendingItemsKind kind, + /** Human-readable text to display for this queue entry in the UI */ + @JsonProperty("displayText") String displayText +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/QueuePendingItemsKind.java b/src/generated/java/com/github/copilot/generated/rpc/QueuePendingItemsKind.java new file mode 100644 index 0000000000..7cf13a2570 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/QueuePendingItemsKind.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Whether this item is a queued user message or a queued slash command / model change + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum QueuePendingItemsKind { + /** The {@code message} variant. */ + MESSAGE("message"), + /** The {@code command} variant. */ + COMMAND("command"); + + private final String value; + QueuePendingItemsKind(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static QueuePendingItemsKind fromValue(String value) { + for (QueuePendingItemsKind v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown QueuePendingItemsKind value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/ReasoningSummary.java b/src/generated/java/com/github/copilot/generated/rpc/ReasoningSummary.java new file mode 100644 index 0000000000..3b95a9e2b2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ReasoningSummary.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Reasoning summary mode to request for supported model clients + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ReasoningSummary { + /** The {@code none} variant. */ + NONE("none"), + /** The {@code concise} variant. */ + CONCISE("concise"), + /** The {@code detailed} variant. */ + DETAILED("detailed"); + + private final String value; + ReasoningSummary(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ReasoningSummary fromValue(String value) { + for (ReasoningSummary v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ReasoningSummary value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/RemoteSessionMode.java b/src/generated/java/com/github/copilot/generated/rpc/RemoteSessionMode.java new file mode 100644 index 0000000000..68c3e66170 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/RemoteSessionMode.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Per-session remote mode. "off" disables remote, "export" exports session events to GitHub without enabling remote steering, "on" enables both export and remote steering. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum RemoteSessionMode { + /** The {@code off} variant. */ + OFF("off"), + /** The {@code export} variant. */ + EXPORT("export"), + /** The {@code on} variant. */ + ON("on"); + + private final String value; + RemoteSessionMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static RemoteSessionMode fromValue(String value) { + for (RemoteSessionMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown RemoteSessionMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/RpcCaller.java b/src/generated/java/com/github/copilot/generated/rpc/RpcCaller.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/RpcCaller.java rename to src/generated/java/com/github/copilot/generated/rpc/RpcCaller.java index d15513ce0b..67e7571a16 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/RpcCaller.java +++ b/src/generated/java/com/github/copilot/generated/rpc/RpcCaller.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/RpcMapper.java b/src/generated/java/com/github/copilot/generated/rpc/RpcMapper.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/RpcMapper.java rename to src/generated/java/com/github/copilot/generated/rpc/RpcMapper.java index 87d4328209..0d2a4e8b73 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/RpcMapper.java +++ b/src/generated/java/com/github/copilot/generated/rpc/RpcMapper.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/generated/rpc/ScheduleEntry.java b/src/generated/java/com/github/copilot/generated/rpc/ScheduleEntry.java new file mode 100644 index 0000000000..fb41975bd1 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ScheduleEntry.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.time.OffsetDateTime; +import javax.annotation.processing.Generated; + +/** + * Schema for the `ScheduleEntry` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ScheduleEntry( + /** Sequential id assigned by the runtime within the session. Stable across resumes (rebuilt from the event log). */ + @JsonProperty("id") Long id, + /** Interval between scheduled ticks, in milliseconds. */ + @JsonProperty("intervalMs") Long intervalMs, + /** Prompt text that gets enqueued on every tick. */ + @JsonProperty("prompt") String prompt, + /** Whether the schedule re-arms after each tick (`/every`) or fires once (`/after`). */ + @JsonProperty("recurring") Boolean recurring, + /** Display-only label for the prompt as shown in the UI (e.g. `/skill-name` for a skill-invocation schedule). The actual enqueued prompt is `prompt`. */ + @JsonProperty("displayPrompt") String displayPrompt, + /** ISO 8601 timestamp when the next tick is scheduled to fire. */ + @JsonProperty("nextRunAt") OffsetDateTime nextRunAt +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SecretsAddFilterValuesParams.java b/src/generated/java/com/github/copilot/generated/rpc/SecretsAddFilterValuesParams.java new file mode 100644 index 0000000000..3643773114 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SecretsAddFilterValuesParams.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Secret values to add to the redaction filter. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SecretsAddFilterValuesParams( + /** Raw secret values to register for redaction */ + @JsonProperty("values") List values +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SecretsAddFilterValuesResult.java b/src/generated/java/com/github/copilot/generated/rpc/SecretsAddFilterValuesResult.java new file mode 100644 index 0000000000..f6261b638c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SecretsAddFilterValuesResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Confirmation that the secret values were registered. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SecretsAddFilterValuesResult( + /** Whether the values were successfully registered */ + @JsonProperty("ok") Boolean ok +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SendAgentMode.java b/src/generated/java/com/github/copilot/generated/rpc/SendAgentMode.java new file mode 100644 index 0000000000..641a1ac474 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SendAgentMode.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * The UI mode the agent was in when this message was sent. Defaults to the session's current mode. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SendAgentMode { + /** The {@code interactive} variant. */ + INTERACTIVE("interactive"), + /** The {@code plan} variant. */ + PLAN("plan"), + /** The {@code autopilot} variant. */ + AUTOPILOT("autopilot"), + /** The {@code shell} variant. */ + SHELL("shell"); + + private final String value; + SendAgentMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SendAgentMode fromValue(String value) { + for (SendAgentMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SendAgentMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SendMode.java b/src/generated/java/com/github/copilot/generated/rpc/SendMode.java new file mode 100644 index 0000000000..013f595971 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SendMode.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * How to deliver the message. `enqueue` (default) appends to the message queue. `immediate` interjects during an in-progress turn. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SendMode { + /** The {@code enqueue} variant. */ + ENQUEUE("enqueue"), + /** The {@code immediate} variant. */ + IMMEDIATE("immediate"); + + private final String value; + SendMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SendMode fromValue(String value) { + for (SendMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SendMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerAccountApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerAccountApi.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerAccountApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerAccountApi.java index ecbe8a1057..d3bd444608 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerAccountApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerAccountApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -26,7 +26,7 @@ public final class ServerAccountApi { } /** - * Invokes {@code account.getQuota}. + * Optional GitHub token used to look up quota for a specific user instead of the global auth context. * @since 1.0.0 */ public CompletableFuture getQuota() { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSessionsApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerAgentRegistryApi.java similarity index 64% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSessionsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerAgentRegistryApi.java index 6d1aa06519..f1a0d4bb5e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSessionsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerAgentRegistryApi.java @@ -5,34 +5,34 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; /** - * API methods for the {@code sessions} namespace. + * API methods for the {@code agentRegistry} namespace. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class ServerSessionsApi { +public final class ServerAgentRegistryApi { private final RpcCaller caller; /** @param caller the RPC transport function */ - ServerSessionsApi(RpcCaller caller) { + ServerAgentRegistryApi(RpcCaller caller) { this.caller = caller; } /** - * Invokes {@code sessions.fork}. + * Inputs to spawn a managed-server child via the controller's spawn delegate. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture fork(SessionsForkParams params) { - return caller.invoke("sessions.fork", params, SessionsForkResult.class); + public CompletableFuture spawn(AgentRegistrySpawnParams params) { + return caller.invoke("agentRegistry.spawn", params, Void.class); } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerMcpApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerMcpApi.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerMcpApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerMcpApi.java index 6c376d0fe9..6ff26e80dd 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerMcpApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerMcpApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,7 @@ public final class ServerMcpApi { } /** - * Invokes {@code mcp.discover}. + * Optional working directory used as context for MCP server discovery. * @since 1.0.0 */ public CompletableFuture discover(McpDiscoverParams params) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerMcpConfigApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerMcpConfigApi.java similarity index 82% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerMcpConfigApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerMcpConfigApi.java index 9e9677e42a..6f0a2105d9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerMcpConfigApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerMcpConfigApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -26,7 +26,7 @@ public final class ServerMcpConfigApi { } /** - * Invokes {@code mcp.config.list}. + * User-configured MCP servers, keyed by server name. * @since 1.0.0 */ public CompletableFuture list() { @@ -34,7 +34,7 @@ public CompletableFuture list() { } /** - * Invokes {@code mcp.config.add}. + * MCP server name and configuration to add to user configuration. * @since 1.0.0 */ public CompletableFuture add(McpConfigAddParams params) { @@ -42,7 +42,7 @@ public CompletableFuture add(McpConfigAddParams params) { } /** - * Invokes {@code mcp.config.update}. + * MCP server name and replacement configuration to write to user configuration. * @since 1.0.0 */ public CompletableFuture update(McpConfigUpdateParams params) { @@ -50,7 +50,7 @@ public CompletableFuture update(McpConfigUpdateParams params) { } /** - * Invokes {@code mcp.config.remove}. + * MCP server name to remove from user configuration. * @since 1.0.0 */ public CompletableFuture remove(McpConfigRemoveParams params) { @@ -58,7 +58,7 @@ public CompletableFuture remove(McpConfigRemoveParams params) { } /** - * Invokes {@code mcp.config.enable}. + * MCP server names to enable for new sessions. * @since 1.0.0 */ public CompletableFuture enable(McpConfigEnableParams params) { @@ -66,7 +66,7 @@ public CompletableFuture enable(McpConfigEnableParams params) { } /** - * Invokes {@code mcp.config.disable}. + * MCP server names to disable for new sessions. * @since 1.0.0 */ public CompletableFuture disable(McpConfigDisableParams params) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerModelsApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerModelsApi.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerModelsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerModelsApi.java index c3f83b45cc..c0515a06f4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerModelsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerModelsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -26,7 +26,7 @@ public final class ServerModelsApi { } /** - * Invokes {@code models.list}. + * Optional GitHub token used to list models for a specific user instead of the global auth context. * @since 1.0.0 */ public CompletableFuture list() { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerRpc.java b/src/generated/java/com/github/copilot/generated/rpc/ServerRpc.java similarity index 76% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerRpc.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerRpc.java index d2e3161000..8d97676580 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerRpc.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerRpc.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,6 +30,8 @@ public final class ServerRpc { public final ServerToolsApi tools; /** API methods for the {@code account} namespace. */ public final ServerAccountApi account; + /** API methods for the {@code secrets} namespace. */ + public final ServerSecretsApi secrets; /** API methods for the {@code mcp} namespace. */ public final ServerMcpApi mcp; /** API methods for the {@code skills} namespace. */ @@ -38,6 +40,8 @@ public final class ServerRpc { public final ServerSessionFsApi sessionFs; /** API methods for the {@code sessions} namespace. */ public final ServerSessionsApi sessions; + /** API methods for the {@code agentRegistry} namespace. */ + public final ServerAgentRegistryApi agentRegistry; /** * Creates a new server RPC client. @@ -49,18 +53,28 @@ public ServerRpc(RpcCaller caller) { this.models = new ServerModelsApi(caller); this.tools = new ServerToolsApi(caller); this.account = new ServerAccountApi(caller); + this.secrets = new ServerSecretsApi(caller); this.mcp = new ServerMcpApi(caller); this.skills = new ServerSkillsApi(caller); this.sessionFs = new ServerSessionFsApi(caller); this.sessions = new ServerSessionsApi(caller); + this.agentRegistry = new ServerAgentRegistryApi(caller); } /** - * Invokes {@code ping}. + * Optional message to echo back to the caller. * @since 1.0.0 */ public CompletableFuture ping(PingParams params) { return caller.invoke("ping", params, PingResult.class); } + /** + * Optional connection token presented by the SDK client during the handshake. + * @since 1.0.0 + */ + public CompletableFuture connect(ConnectParams params) { + return caller.invoke("connect", params, ConnectResult.class); + } + } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerSecretsApi.java similarity index 57% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerSecretsApi.java index 93624213e8..800722c858 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerSecretsApi.java @@ -5,34 +5,32 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; /** - * API methods for the {@code auth} namespace. + * API methods for the {@code secrets} namespace. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionAuthApi { +public final class ServerSecretsApi { private final RpcCaller caller; - private final String sessionId; /** @param caller the RPC transport function */ - SessionAuthApi(RpcCaller caller, String sessionId) { + ServerSecretsApi(RpcCaller caller) { this.caller = caller; - this.sessionId = sessionId; } /** - * Invokes {@code session.auth.getStatus}. + * Secret values to add to the redaction filter. * @since 1.0.0 */ - public CompletableFuture getStatus() { - return caller.invoke("session.auth.getStatus", java.util.Map.of("sessionId", this.sessionId), SessionAuthGetStatusResult.class); + public CompletableFuture addFilterValues(SecretsAddFilterValuesParams params) { + return caller.invoke("secrets.addFilterValues", params, SecretsAddFilterValuesResult.class); } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSessionFsApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerSessionFsApi.java similarity index 83% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSessionFsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerSessionFsApi.java index 068ff939f7..93022becf2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSessionFsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerSessionFsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -26,7 +26,7 @@ public final class ServerSessionFsApi { } /** - * Invokes {@code sessionFs.setProvider}. + * Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. * @since 1.0.0 */ public CompletableFuture setProvider(SessionFsSetProviderParams params) { diff --git a/src/generated/java/com/github/copilot/generated/rpc/ServerSessionsApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerSessionsApi.java new file mode 100644 index 0000000000..ece70c84aa --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerSessionsApi.java @@ -0,0 +1,218 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code sessions} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class ServerSessionsApi { + + private final RpcCaller caller; + + /** @param caller the RPC transport function */ + ServerSessionsApi(RpcCaller caller) { + this.caller = caller; + } + + /** + * Source session identifier to fork from, optional event-ID boundary, and optional friendly name for the new session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture fork(SessionsForkParams params) { + return caller.invoke("sessions.fork", params, SessionsForkResult.class); + } + + /** + * Remote session connection parameters. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture connect() { + return caller.invoke("sessions.connect", java.util.Map.of(), SessionsConnectResult.class); + } + + /** + * Optional metadata-load limit and filters applied to the returned sessions. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture list() { + return caller.invoke("sessions.list", java.util.Map.of(), SessionsListResult.class); + } + + /** + * GitHub task ID to look up. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture findByTaskId(SessionsFindByTaskIdParams params) { + return caller.invoke("sessions.findByTaskId", params, SessionsFindByTaskIdResult.class); + } + + /** + * UUID prefix to resolve to a unique session ID. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture findByPrefix(SessionsFindByPrefixParams params) { + return caller.invoke("sessions.findByPrefix", params, SessionsFindByPrefixResult.class); + } + + /** + * Optional working-directory context used to score session relevance. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getLastForContext(SessionsGetLastForContextParams params) { + return caller.invoke("sessions.getLastForContext", params, SessionsGetLastForContextResult.class); + } + + /** + * Session ID whose event-log file path to compute. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getEventFilePath() { + return caller.invoke("sessions.getEventFilePath", java.util.Map.of(), SessionsGetEventFilePathResult.class); + } + + /** + * Map of sessionId -> on-disk size in bytes for each session's workspace directory. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getSizes() { + return caller.invoke("sessions.getSizes", java.util.Map.of(), SessionsGetSizesResult.class); + } + + /** + * Session IDs to test for live in-use locks. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture checkInUse(SessionsCheckInUseParams params) { + return caller.invoke("sessions.checkInUse", params, SessionsCheckInUseResult.class); + } + + /** + * Session ID to look up the persisted remote-steerable flag for. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getPersistedRemoteSteerable() { + return caller.invoke("sessions.getPersistedRemoteSteerable", java.util.Map.of(), SessionsGetPersistedRemoteSteerableResult.class); + } + + /** + * Session ID to close. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture close() { + return caller.invoke("sessions.close", java.util.Map.of(), Void.class); + } + + /** + * Session IDs to close, deactivate, and delete from disk. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture bulkDelete(SessionsBulkDeleteParams params) { + return caller.invoke("sessions.bulkDelete", params, SessionsBulkDeleteResult.class); + } + + /** + * Age threshold and optional flags controlling which old sessions are pruned (or simulated when dryRun is true). + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture pruneOld(SessionsPruneOldParams params) { + return caller.invoke("sessions.pruneOld", params, SessionsPruneOldResult.class); + } + + /** + * Session ID whose pending events should be flushed to disk. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture save() { + return caller.invoke("sessions.save", java.util.Map.of(), Void.class); + } + + /** + * Session ID whose in-use lock should be released. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture releaseLock() { + return caller.invoke("sessions.releaseLock", java.util.Map.of(), Void.class); + } + + /** + * Session metadata records to enrich with summary and context information. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture enrichMetadata(SessionsEnrichMetadataParams params) { + return caller.invoke("sessions.enrichMetadata", params, SessionsEnrichMetadataResult.class); + } + + /** + * Active session ID and an optional flag for deferring repo-level hooks until folder trust. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture reloadPluginHooks(SessionsReloadPluginHooksParams params) { + return caller.invoke("sessions.reloadPluginHooks", params, Void.class); + } + + /** + * Active session ID whose deferred repo-level hooks should be loaded. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture loadDeferredRepoHooks() { + return caller.invoke("sessions.loadDeferredRepoHooks", java.util.Map.of(), SessionsLoadDeferredRepoHooksResult.class); + } + + /** + * Manager-wide additional plugins to register; replaces any previously-configured set. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setAdditionalPlugins(SessionsSetAdditionalPluginsParams params) { + return caller.invoke("sessions.setAdditionalPlugins", params, Void.class); + } + +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkill.java b/src/generated/java/com/github/copilot/generated/rpc/ServerSkill.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkill.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerSkill.java index 6cb4327176..ba02ea28d7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkill.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerSkill.java @@ -5,13 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `ServerSkill` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) @@ -21,7 +26,7 @@ public record ServerSkill( /** Description of what the skill does */ @JsonProperty("description") String description, /** Source location type (e.g., project, personal-copilot, plugin, builtin) */ - @JsonProperty("source") String source, + @JsonProperty("source") SkillSource source, /** Whether the skill can be invoked by the user as a slash command */ @JsonProperty("userInvocable") Boolean userInvocable, /** Whether the skill is currently enabled (based on global config) */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkillsApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerSkillsApi.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkillsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerSkillsApi.java index 943f682584..6404ab6fda 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkillsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerSkillsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,7 @@ public final class ServerSkillsApi { } /** - * Invokes {@code skills.discover}. + * Optional project paths and additional skill directories to include in discovery. * @since 1.0.0 */ public CompletableFuture discover(SkillsDiscoverParams params) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkillsConfigApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerSkillsConfigApi.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkillsConfigApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerSkillsConfigApi.java index 41eaeab01e..e552227ccb 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerSkillsConfigApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerSkillsConfigApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -26,7 +26,7 @@ public final class ServerSkillsConfigApi { } /** - * Invokes {@code skills.config.setDisabledSkills}. + * Skill names to mark as disabled in global configuration, replacing any previous list. * @since 1.0.0 */ public CompletableFuture setDisabledSkills(SkillsConfigSetDisabledSkillsParams params) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerToolsApi.java b/src/generated/java/com/github/copilot/generated/rpc/ServerToolsApi.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ServerToolsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/ServerToolsApi.java index 2eb2a90f54..10e64747ef 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ServerToolsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ServerToolsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -26,7 +26,7 @@ public final class ServerToolsApi { } /** - * Invokes {@code tools.list}. + * Optional model identifier whose tool overrides should be applied to the listing. * @since 1.0.0 */ public CompletableFuture list(ToolsListParams params) { diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionAbortParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAbortParams.java new file mode 100644 index 0000000000..4738643b86 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAbortParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Parameters for aborting the current turn + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionAbortParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Finite reason code describing why the current turn was aborted */ + @JsonProperty("reason") AbortReason reason +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionAbortResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAbortResult.java new file mode 100644 index 0000000000..9d75b5db5c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAbortResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Result of aborting the current turn + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionAbortResult( + /** Whether the abort completed successfully */ + @JsonProperty("success") Boolean success, + /** Error message if the abort failed */ + @JsonProperty("error") String error +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentApi.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentApi.java index 47192e6310..c992d36e33 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,7 @@ public final class SessionAgentApi { } /** - * Invokes {@code session.agent.list}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 @@ -40,7 +40,7 @@ public CompletableFuture list() { } /** - * Invokes {@code session.agent.getCurrent}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 @@ -50,7 +50,7 @@ public CompletableFuture getCurrent() { } /** - * Invokes {@code session.agent.select}. + * Name of the custom agent to select for subsequent turns. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. @@ -65,7 +65,7 @@ public CompletableFuture select(SessionAgentSelectPara } /** - * Invokes {@code session.agent.deselect}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 @@ -75,7 +75,7 @@ public CompletableFuture deselect() { } /** - * Invokes {@code session.agent.reload}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentDeselectParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentDeselectParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentDeselectParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentDeselectParams.java index cd101194c7..1b10947133 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentDeselectParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentDeselectParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.agent.deselect} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentDeselectResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentDeselectResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentDeselectResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentDeselectResult.java index 81e2e3ebb9..679a3fb83d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentDeselectResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentDeselectResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentGetCurrentParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentGetCurrentParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentGetCurrentParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentGetCurrentParams.java index c05e5fa362..59774974f5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentGetCurrentParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentGetCurrentParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.agent.getCurrent} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentGetCurrentResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentGetCurrentResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentGetCurrentResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentGetCurrentResult.java index fea4e47b63..d4dfe25b49 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentGetCurrentResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentGetCurrentResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.agent.getCurrent} RPC method. + * The currently selected custom agent, or null when using the default agent. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentListParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentListParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentListParams.java index e14ae40c0c..9763eb5c3e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentListParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentListParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.agent.list} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentListResult.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentListResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentListResult.java index f572bf9aed..d7cdd11271 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentListResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentListResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.agent.list} RPC method. + * Custom agents available to the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentReloadParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentReloadParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentReloadParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentReloadParams.java index ea1b4050b0..c3467c5e9e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentReloadParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentReloadParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.agent.reload} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentReloadResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentReloadResult.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentReloadResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentReloadResult.java index 32928e53a1..47eec9eae5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentReloadResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentReloadResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.agent.reload} RPC method. + * Custom agents available to the session after reloading definitions from disk. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentSelectParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentSelectParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentSelectParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentSelectParams.java index 61777dde33..372d1d1f69 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentSelectParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentSelectParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.agent.select} RPC method. + * Name of the custom agent to select for subsequent turns. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentSelectResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentSelectResult.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentSelectResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAgentSelectResult.java index ab9637568d..927352e2d8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAgentSelectResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAgentSelectResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.agent.select} RPC method. + * The newly selected custom agent. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionAuthApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthApi.java new file mode 100644 index 0000000000..0f5729fe56 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthApi.java @@ -0,0 +1,57 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code auth} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionAuthApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionAuthApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getStatus() { + return caller.invoke("session.auth.getStatus", java.util.Map.of("sessionId", this.sessionId), SessionAuthGetStatusResult.class); + } + + /** + * New auth credentials to install on the session. Omit to leave credentials unchanged. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setCredentials(SessionAuthSetCredentialsParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.auth.setCredentials", _p, SessionAuthSetCredentialsResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthGetStatusParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthGetStatusParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthGetStatusParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAuthGetStatusParams.java index 059833d374..d57a3ccccc 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthGetStatusParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthGetStatusParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.auth.getStatus} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthGetStatusResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthGetStatusResult.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthGetStatusResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionAuthGetStatusResult.java index 737c2ae9ea..3480257cc9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionAuthGetStatusResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthGetStatusResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.auth.getStatus} RPC method. + * Authentication status and account metadata for the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionAuthSetCredentialsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthSetCredentialsParams.java new file mode 100644 index 0000000000..0b3b7aa9d3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthSetCredentialsParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * New auth credentials to install on the session. Omit to leave credentials unchanged. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionAuthSetCredentialsParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The new auth credentials to install on the session. When omitted or `undefined`, the call is a no-op and the session's existing credentials are preserved. The runtime stores the value verbatim and uses it for outbound model/API requests; it does NOT re-validate or re-fetch the associated Copilot user response. Several variants carry secret material; treat this method's params as containing secrets at rest and in transit. */ + @JsonProperty("credentials") Object credentials +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionAuthSetCredentialsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthSetCredentialsResult.java new file mode 100644 index 0000000000..ad53ee9192 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionAuthSetCredentialsResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the credential update succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionAuthSetCredentialsResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasApi.java new file mode 100644 index 0000000000..8388c82a28 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasApi.java @@ -0,0 +1,97 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code canvas} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionCanvasApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionCanvasApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture list() { + return caller.invoke("session.canvas.list", java.util.Map.of("sessionId", this.sessionId), SessionCanvasListResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture listOpen() { + return caller.invoke("session.canvas.listOpen", java.util.Map.of("sessionId", this.sessionId), SessionCanvasListOpenResult.class); + } + + /** + * Canvas open parameters. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture open(SessionCanvasOpenParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.canvas.open", _p, SessionCanvasOpenResult.class); + } + + /** + * Canvas close parameters. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture close(SessionCanvasCloseParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.canvas.close", _p, Void.class); + } + + /** + * Canvas action invocation parameters. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture invokeAction(SessionCanvasInvokeActionParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.canvas.invokeAction", _p, SessionCanvasInvokeActionResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasCloseParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasCloseParams.java new file mode 100644 index 0000000000..d87e837708 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasCloseParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas close parameters. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasCloseParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Open canvas instance identifier */ + @JsonProperty("instanceId") String instanceId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasInvokeActionParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasInvokeActionParams.java new file mode 100644 index 0000000000..3696e3e3ed --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasInvokeActionParams.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas action invocation parameters. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasInvokeActionParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Open canvas instance identifier */ + @JsonProperty("instanceId") String instanceId, + /** Action name to invoke */ + @JsonProperty("actionName") String actionName, + /** Action input */ + @JsonProperty("input") Object input +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasInvokeActionResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasInvokeActionResult.java new file mode 100644 index 0000000000..117b618aea --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasInvokeActionResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas action invocation result. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasInvokeActionResult( + /** Provider-supplied action result */ + @JsonProperty("result") Object result +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListOpenParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListOpenParams.java new file mode 100644 index 0000000000..6015d9bd6f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListOpenParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasListOpenParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListOpenResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListOpenResult.java new file mode 100644 index 0000000000..f9af151e29 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListOpenResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Live open-canvas snapshot. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasListOpenResult( + /** Currently open canvas instances */ + @JsonProperty("openCanvases") List openCanvases +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListParams.java new file mode 100644 index 0000000000..d49d90e6c7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasListParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListResult.java new file mode 100644 index 0000000000..a4d33998a9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasListResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Declared canvases available in this session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasListResult( + /** Declared canvases available in this session */ + @JsonProperty("canvases") List canvases +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasOpenParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasOpenParams.java new file mode 100644 index 0000000000..8b56ad50a8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasOpenParams.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Canvas open parameters. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasOpenParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Owning provider identifier. Optional when the canvasId is unique across providers; required to disambiguate when multiple providers register the same canvasId. */ + @JsonProperty("extensionId") String extensionId, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId, + /** Caller-supplied stable instance identifier */ + @JsonProperty("instanceId") String instanceId, + /** Canvas open input */ + @JsonProperty("input") Object input +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasOpenResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasOpenResult.java new file mode 100644 index 0000000000..38f3a5f555 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCanvasOpenResult.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Open canvas instance snapshot. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCanvasOpenResult( + /** Stable caller-supplied canvas instance identifier */ + @JsonProperty("instanceId") String instanceId, + /** Owning provider identifier */ + @JsonProperty("extensionId") String extensionId, + /** Owning extension display name, when available */ + @JsonProperty("extensionName") String extensionName, + /** Provider-local canvas identifier */ + @JsonProperty("canvasId") String canvasId, + /** Rendered title */ + @JsonProperty("title") String title, + /** Provider-supplied status text */ + @JsonProperty("status") String status, + /** URL for web-rendered canvases */ + @JsonProperty("url") String url, + /** Input supplied when the instance was opened */ + @JsonProperty("input") Object input, + /** Whether this snapshot came from an idempotent reopen */ + @JsonProperty("reopen") Boolean reopen, + /** Runtime-controlled routing state for an open canvas instance. */ + @JsonProperty("availability") CanvasInstanceAvailability availability +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsApi.java new file mode 100644 index 0000000000..b0bc291e69 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsApi.java @@ -0,0 +1,117 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code commands} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionCommandsApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionCommandsApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Optional filters controlling which command sources to include in the listing. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture list() { + return caller.invoke("session.commands.list", java.util.Map.of("sessionId", this.sessionId), SessionCommandsListResult.class); + } + + /** + * Slash command name and optional raw input string to invoke. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture invoke(SessionCommandsInvokeParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.commands.invoke", _p, Void.class); + } + + /** + * Pending command request ID and an optional error if the client handler failed. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture handlePendingCommand(SessionCommandsHandlePendingCommandParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.commands.handlePendingCommand", _p, SessionCommandsHandlePendingCommandResult.class); + } + + /** + * Slash command name and argument string to execute synchronously. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture execute(SessionCommandsExecuteParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.commands.execute", _p, SessionCommandsExecuteResult.class); + } + + /** + * Slash-prefixed command string to enqueue for FIFO processing. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture enqueue(SessionCommandsEnqueueParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.commands.enqueue", _p, SessionCommandsEnqueueResult.class); + } + + /** + * Queued-command request ID and the result indicating whether the host executed it (and whether to stop processing further queued commands). + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture respondToQueuedCommand(SessionCommandsRespondToQueuedCommandParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.commands.respondToQueuedCommand", _p, SessionCommandsRespondToQueuedCommandResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsEnqueueParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsEnqueueParams.java new file mode 100644 index 0000000000..f4ca14dfa5 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsEnqueueParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Slash-prefixed command string to enqueue for FIFO processing. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsEnqueueParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Slash-prefixed command string to enqueue, e.g. '/compact' or '/model gpt-4'. Queued FIFO with any in-flight items; if the session is idle, processing kicks off immediately. */ + @JsonProperty("command") String command +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsEnqueueResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsEnqueueResult.java new file mode 100644 index 0000000000..649f01ca49 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsEnqueueResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the command was accepted into the local execution queue. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsEnqueueResult( + /** True when the command was accepted into the local execution queue. False when the call targets a session that does not support local command queueing (e.g. remote sessions). */ + @JsonProperty("queued") Boolean queued +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsExecuteParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsExecuteParams.java new file mode 100644 index 0000000000..f88ac4c038 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsExecuteParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Slash command name and argument string to execute synchronously. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsExecuteParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Name of the slash command to invoke (without the leading '/'). */ + @JsonProperty("commandName") String commandName, + /** Argument string to pass to the command (empty string if none). */ + @JsonProperty("args") String args +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsExecuteResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsExecuteResult.java new file mode 100644 index 0000000000..1b1c442990 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsExecuteResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Error message produced while executing the command, if any. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsExecuteResult( + /** Error message produced while executing the command, if any. Omitted when the handler succeeded. */ + @JsonProperty("error") String error +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsHandlePendingCommandParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsHandlePendingCommandParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsHandlePendingCommandParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionCommandsHandlePendingCommandParams.java index e14d29486c..9b9c12514c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsHandlePendingCommandParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsHandlePendingCommandParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.commands.handlePendingCommand} RPC method. + * Pending command request ID and an optional error if the client handler failed. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsHandlePendingCommandResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsHandlePendingCommandResult.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsHandlePendingCommandResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionCommandsHandlePendingCommandResult.java index 8c79beaaee..9e3698702d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsHandlePendingCommandResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsHandlePendingCommandResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.commands.handlePendingCommand} RPC method. + * Indicates whether the pending client-handled command was completed successfully. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsInvokeParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsInvokeParams.java new file mode 100644 index 0000000000..21d92ebab2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsInvokeParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Slash command name and optional raw input string to invoke. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsInvokeParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Command name. Leading slashes are stripped and the name is matched case-insensitively. */ + @JsonProperty("name") String name, + /** Raw input after the command name */ + @JsonProperty("input") String input +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsListParams.java new file mode 100644 index 0000000000..d60a147d85 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsListParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Optional filters controlling which command sources to include in the listing. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsListParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsListResult.java new file mode 100644 index 0000000000..8d532352a6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsListResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Slash commands available in the session, after applying any include/exclude filters. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsListResult( + /** Commands available in this session */ + @JsonProperty("commands") List commands +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsRespondToQueuedCommandParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsRespondToQueuedCommandParams.java new file mode 100644 index 0000000000..22b89f3645 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsRespondToQueuedCommandParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Queued-command request ID and the result indicating whether the host executed it (and whether to stop processing further queued commands). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsRespondToQueuedCommandParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Request ID from the `command.queued` event the host is responding to. */ + @JsonProperty("requestId") String requestId, + /** Result of the queued command execution. */ + @JsonProperty("result") Object result +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsRespondToQueuedCommandResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsRespondToQueuedCommandResult.java new file mode 100644 index 0000000000..1cc3961391 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionCommandsRespondToQueuedCommandResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the queued-command response was matched to a pending request. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionCommandsRespondToQueuedCommandResult( + /** Whether a pending queued command with the given request ID was found and resolved. False when the request was already resolved, cancelled, or unknown. */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionContext.java b/src/generated/java/com/github/copilot/generated/rpc/SessionContext.java new file mode 100644 index 0000000000..50376a0f0a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionContext.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `SessionContext` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionContext( + /** Most recent working directory for this session */ + @JsonProperty("cwd") String cwd, + /** Git repository root, if the cwd was inside a git repo */ + @JsonProperty("gitRoot") String gitRoot, + /** Repository slug in `owner/name` form, when known */ + @JsonProperty("repository") String repository, + /** Repository host type */ + @JsonProperty("hostType") SessionContextHostType hostType, + /** Active git branch */ + @JsonProperty("branch") String branch +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionContextHostType.java b/src/generated/java/com/github/copilot/generated/rpc/SessionContextHostType.java new file mode 100644 index 0000000000..8eea0e7190 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionContextHostType.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Repository host type + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SessionContextHostType { + /** The {@code github} variant. */ + GITHUB("github"), + /** The {@code ado} variant. */ + ADO("ado"); + + private final String value; + SessionContextHostType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SessionContextHostType fromValue(String value) { + for (SessionContextHostType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SessionContextHostType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogApi.java new file mode 100644 index 0000000000..eac102aef1 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogApi.java @@ -0,0 +1,87 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code eventLog} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionEventLogApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionEventLogApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Cursor, batch size, and optional long-poll/filter parameters for reading session events. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture read(SessionEventLogReadParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.eventLog.read", _p, SessionEventLogReadResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture tail() { + return caller.invoke("session.eventLog.tail", java.util.Map.of("sessionId", this.sessionId), SessionEventLogTailResult.class); + } + + /** + * Event type to register consumer interest for, used by runtime gating logic. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture registerInterest(SessionEventLogRegisterInterestParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.eventLog.registerInterest", _p, SessionEventLogRegisterInterestResult.class); + } + + /** + * Opaque handle previously returned by `registerInterest` to release. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture releaseInterest(SessionEventLogReleaseInterestParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.eventLog.releaseInterest", _p, SessionEventLogReleaseInterestResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReadParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReadParams.java new file mode 100644 index 0000000000..a77e8a8711 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReadParams.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Cursor, batch size, and optional long-poll/filter parameters for reading session events. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionEventLogReadParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Opaque cursor returned by a previous read. Omit on the first call to start from the beginning of the session's persisted history. */ + @JsonProperty("cursor") String cursor, + /** Maximum number of events to return in this batch (1–1000, default 200). */ + @JsonProperty("max") Long max, + /** Milliseconds to wait for new events when the cursor is at the tail of history. 0 (default) returns immediately even if no events are available. Capped at 30000ms. Ephemeral events that arrive during the wait are delivered in this batch but are NOT replayable on a subsequent read (use a non-zero waitMs in your next call to capture future ephemerals as they happen). */ + @JsonProperty("waitMs") Long waitMs, + /** Either '*' to receive all event types, or a non-empty list of event types to receive */ + @JsonProperty("types") Object types, + /** Agent-scope filter: 'primary' returns only main-agent events plus events whose type starts with 'subagent.' (matching the typed-subscription default behavior); 'all' returns events from all agents (matching wildcard-subscription behavior). Default is 'all' to preserve wildcard semantics for catch-up callers. */ + @JsonProperty("agentScope") EventsAgentScope agentScope +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReadResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReadResult.java new file mode 100644 index 0000000000..dcd138e7ba --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReadResult.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Batch of session events returned by a read, with cursor and continuation metadata. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionEventLogReadResult( + /** Events are delivered in two batches per read: persisted events first (in append order), then ephemeral events (in seq order). When `waitMs > 0` and the catch-up batches were empty, post-wait events follow the same two-batch ordering. Persisted and ephemeral events do not interleave within a single read. */ + @JsonProperty("events") List events, + /** Opaque cursor for the next read. Pass back unchanged in the next read.cursor to continue from where this read left off. Always present, even when no events were returned. */ + @JsonProperty("cursor") String cursor, + /** True when the read returned `max` events and more events are available immediately. When false, the next read with a non-zero `waitMs` will block until a new event arrives or the wait expires. */ + @JsonProperty("hasMore") Boolean hasMore, + /** Cursor status: 'ok' means the cursor was applied successfully; 'expired' means the cursor referred to an event that no longer exists in history (e.g. truncated or compacted away) and the read started from the beginning of the remaining history. */ + @JsonProperty("cursorStatus") EventsCursorStatus cursorStatus +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogRegisterInterestParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogRegisterInterestParams.java new file mode 100644 index 0000000000..94f68bdf76 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogRegisterInterestParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Event type to register consumer interest for, used by runtime gating logic. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionEventLogRegisterInterestParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The event type the consumer wants the runtime to treat as 'observed' for behavior-switching gating. Some runtime code paths inspect whether any consumer is interested in a specific event type and choose a different implementation accordingly (e.g. `mcp.oauth_required`: when interest is registered the runtime delegates the full interactive OAuth flow to the consumer; when no interest is registered the runtime installs a browserless fallback that silently reuses cached tokens). SDK clients that long-poll events do NOT automatically appear as listeners to these gating checks β€” they must explicitly call `registerInterest` for each event type they want the runtime to count as having a consumer. Multiple registrations for the same event type from the same or different consumers are tracked independently and must each be released. See: `mcp.oauth_required`, `sampling.requested`, `auto_mode_switch.requested`, `user_input.requested`, `elicitation.requested`, `command.queued`, `exit_plan_mode.requested`. */ + @JsonProperty("eventType") String eventType +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogRegisterInterestResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogRegisterInterestResult.java new file mode 100644 index 0000000000..ac4da49d00 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogRegisterInterestResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Opaque handle representing an event-type interest registration. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionEventLogRegisterInterestResult( + /** Opaque handle for this registration. Pass to releaseInterest to release. Each call to registerInterest produces a fresh handle, even when the same eventType is registered multiple times. */ + @JsonProperty("handle") String handle +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReleaseInterestParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReleaseInterestParams.java new file mode 100644 index 0000000000..1eea25f44f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReleaseInterestParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Opaque handle previously returned by `registerInterest` to release. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionEventLogReleaseInterestParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Handle returned by a previous `registerInterest` call. Idempotent: releasing an unknown or already-released handle is a no-op (returns success). When the last outstanding handle for an event type is released, the runtime reverts to its 'no consumer' code path for that event type. */ + @JsonProperty("handle") String handle +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReleaseInterestResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReleaseInterestResult.java new file mode 100644 index 0000000000..39cf07afa1 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogReleaseInterestResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionEventLogReleaseInterestResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogTailParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogTailParams.java new file mode 100644 index 0000000000..3906d7e6e7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogTailParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionEventLogTailParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogTailResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogTailResult.java new file mode 100644 index 0000000000..1b29827d38 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionEventLogTailResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Snapshot of the current tail cursor without returning any events. Use this when a consumer wants to subscribe to live events going forward without first paginating through the entire persisted history (which would happen if `read` were called without a cursor on a long-lived session). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionEventLogTailResult( + /** Opaque cursor pointing at the current tail of the session's persisted-events history. Pass back to `read` to receive only events that arrive AFTER this snapshot. When the session has no events, this returns the same sentinel as an unset cursor (i.e. equivalent to omitting the cursor on a first read). */ + @JsonProperty("cursor") String cursor +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsApi.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsApi.java index 38f8dedf2a..337ba15cc8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,7 @@ public final class SessionExtensionsApi { } /** - * Invokes {@code session.extensions.list}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 @@ -40,7 +40,7 @@ public CompletableFuture list() { } /** - * Invokes {@code session.extensions.enable}. + * Source-qualified extension identifier to enable for the session. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. @@ -55,7 +55,7 @@ public CompletableFuture enable(SessionExtensionsEnableParams params) { } /** - * Invokes {@code session.extensions.disable}. + * Source-qualified extension identifier to disable for the session. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. @@ -70,7 +70,7 @@ public CompletableFuture disable(SessionExtensionsDisableParams params) { } /** - * Invokes {@code session.extensions.reload}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsDisableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsDisableParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsDisableParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsDisableParams.java index 35d68997be..f4bf4d5b36 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsDisableParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsDisableParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.extensions.disable} RPC method. + * Source-qualified extension identifier to disable for the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsDisableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsDisableResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsDisableResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsDisableResult.java index 136e858fb9..ac057e5a27 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsDisableResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsDisableResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsEnableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsEnableParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsEnableParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsEnableParams.java index 1161a7a739..5e00268af3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsEnableParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsEnableParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.extensions.enable} RPC method. + * Source-qualified extension identifier to enable for the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsEnableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsEnableResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsEnableResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsEnableResult.java index 1b7d328e05..82d9b9c6b8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsEnableResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsEnableResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsListParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsListParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsListParams.java index 340153ca11..52f9c08f92 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsListParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsListParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.extensions.list} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsListResult.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsListResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsListResult.java index 9ace814e0b..ba5ea94f11 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsListResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsListResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.extensions.list} RPC method. + * Extensions discovered for the session, with their current status. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsReloadParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsReloadParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsReloadParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsReloadParams.java index 36d1578416..ceaa990f15 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsReloadParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsReloadParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.extensions.reload} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsReloadResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsReloadResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsReloadResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsReloadResult.java index e4a1a22640..9d118b783d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionExtensionsReloadResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionExtensionsReloadResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFleetApi.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFleetApi.java index d7aa719a71..27023dc89b 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFleetApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,7 @@ public final class SessionFleetApi { } /** - * Invokes {@code session.fleet.start}. + * Optional user prompt to combine with the fleet orchestration instructions. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetStartParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFleetStartParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetStartParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFleetStartParams.java index 871239460e..5d5e2c88c5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetStartParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFleetStartParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.fleet.start} RPC method. + * Optional user prompt to combine with the fleet orchestration instructions. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetStartResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFleetStartResult.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetStartResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFleetStartResult.java index a52813aa06..c89f377d76 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFleetStartResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFleetStartResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.fleet.start} RPC method. + * Indicates whether fleet mode was successfully activated. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsAppendFileParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsAppendFileParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsAppendFileParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsAppendFileParams.java index 273031f17f..a3db24a0d9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsAppendFileParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsAppendFileParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.appendFile} RPC method. + * File path, content to append, and optional mode for the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsError.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsError.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsError.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsError.java index a78aa53748..349114dfde 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsError.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsError.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsErrorCode.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsErrorCode.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsErrorCode.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsErrorCode.java index 099ff1236b..4098d43abd 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsErrorCode.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsErrorCode.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsExistsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsExistsParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsExistsParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsExistsParams.java index c59031c57a..29b5107986 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsExistsParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsExistsParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.exists} RPC method. + * Path to test for existence in the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsExistsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsExistsResult.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsExistsResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsExistsResult.java index 8822074652..0068ae3a32 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsExistsResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsExistsResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code sessionFs.exists} RPC method. + * Indicates whether the requested path exists in the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsMkdirParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsMkdirParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsMkdirParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsMkdirParams.java index 33ca53d0f3..c1ed1aec71 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsMkdirParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsMkdirParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.mkdir} RPC method. + * Directory path to create in the client-provided session filesystem, with options for recursive creation and POSIX mode. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReadFileParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReadFileParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReadFileParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsReadFileParams.java index f1cad41edd..d040129cc4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReadFileParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReadFileParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.readFile} RPC method. + * Path of the file to read from the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReadFileResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReadFileResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReadFileResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsReadFileResult.java index d222f88676..c71e1a5143 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReadFileResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReadFileResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code sessionFs.readFile} RPC method. + * File content as a UTF-8 string, or a filesystem error if the read failed. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirParams.java index e3f09c3702..00b865c334 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.readdir} RPC method. + * Directory path whose entries should be listed from the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirResult.java index 3f2201d2dc..745118beb3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code sessionFs.readdir} RPC method. + * Names of entries in the requested directory, or a filesystem error if the read failed. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesEntry.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesEntry.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesEntry.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesEntry.java index ff44088d4b..f4c755951d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesEntry.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesEntry.java @@ -5,13 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `SessionFsReaddirWithTypesEntry` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesEntryType.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesEntryType.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesEntryType.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesEntryType.java index 71640ec347..67e62372ed 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesEntryType.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesEntryType.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesParams.java similarity index 85% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesParams.java index 533dbb4169..a6b80481d2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.readdirWithTypes} RPC method. + * Directory path whose entries (with type information) should be listed from the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesResult.java similarity index 85% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesResult.java index 0fecb63492..3fb693c809 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsReaddirWithTypesResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsReaddirWithTypesResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code sessionFs.readdirWithTypes} RPC method. + * Entries in the requested directory paired with file/directory type information, or a filesystem error if the read failed. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsRenameParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsRenameParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsRenameParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsRenameParams.java index 6a18e80df5..76dbc8cfb9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsRenameParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsRenameParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.rename} RPC method. + * Source and destination paths for renaming or moving an entry in the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsRmParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsRmParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsRmParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsRmParams.java index 50661a58e4..ed50649a30 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsRmParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsRmParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.rm} RPC method. + * Path to remove from the client-provided session filesystem, with options for recursive removal and force. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderCapabilities.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderCapabilities.java new file mode 100644 index 0000000000..7d6c0adb39 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderCapabilities.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Optional capabilities declared by the provider + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionFsSetProviderCapabilities( + /** Whether the provider supports SQLite query/exists operations */ + @JsonProperty("sqlite") Boolean sqlite +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderConventions.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderConventions.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderConventions.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderConventions.java index ac669a1891..abac4795f9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderConventions.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderConventions.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderParams.java similarity index 76% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderParams.java index e0c893db0d..d99a14862f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.setProvider} RPC method. + * Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. * * @since 1.0.0 */ @@ -26,6 +26,8 @@ public record SessionFsSetProviderParams( /** Path within each session's SessionFs where the runtime stores files for that session */ @JsonProperty("sessionStatePath") String sessionStatePath, /** Path conventions used by this filesystem */ - @JsonProperty("conventions") SessionFsSetProviderConventions conventions + @JsonProperty("conventions") SessionFsSetProviderConventions conventions, + /** Optional capabilities declared by the provider */ + @JsonProperty("capabilities") SessionFsSetProviderCapabilities capabilities ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderResult.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderResult.java index dcda9e587a..6088729f56 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsSetProviderResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code sessionFs.setProvider} RPC method. + * Indicates whether the calling client was registered as the session filesystem provider. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteExistsParams.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteExistsParams.java index 911574f568..1956f804ba 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteExistsParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,15 +13,15 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code sessions.fork} RPC method. + * Identifies the target session. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) -public record SessionsForkResult( - /** The new forked session's ID */ +public record SessionFsSqliteExistsParams( + /** Target session identifier */ @JsonProperty("sessionId") String sessionId ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteExistsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteExistsResult.java new file mode 100644 index 0000000000..6c1328e9e9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteExistsResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the per-session SQLite database already exists. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionFsSqliteExistsResult( + /** Whether the session database already exists */ + @JsonProperty("exists") Boolean exists +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryParams.java new file mode 100644 index 0000000000..e489bb1222 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryParams.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * SQL query, query type, and optional bind parameters for executing a SQLite query against the per-session database. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionFsSqliteQueryParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** SQL query to execute */ + @JsonProperty("query") String query, + /** How to execute the query: 'exec' for DDL/multi-statement (no results), 'query' for SELECT (returns rows), 'run' for INSERT/UPDATE/DELETE (returns rowsAffected) */ + @JsonProperty("queryType") SessionFsSqliteQueryType queryType, + /** Optional named bind parameters */ + @JsonProperty("params") Map params +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryResult.java new file mode 100644 index 0000000000..ff14d3ec1b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryResult.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Query results including rows, columns, and rows affected, or a filesystem error if execution failed. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionFsSqliteQueryResult( + /** For SELECT: array of row objects. For others: empty array. */ + @JsonProperty("rows") List> rows, + /** Column names from the result set */ + @JsonProperty("columns") List columns, + /** Number of rows affected (for INSERT/UPDATE/DELETE) */ + @JsonProperty("rowsAffected") Long rowsAffected, + /** SQLite last_insert_rowid() value for INSERT. */ + @JsonProperty("lastInsertRowid") Long lastInsertRowid, + /** Describes a filesystem error. */ + @JsonProperty("error") SessionFsError error +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryType.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryType.java new file mode 100644 index 0000000000..a59bdd1f27 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsSqliteQueryType.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * How to execute the query: 'exec' for DDL/multi-statement (no results), 'query' for SELECT (returns rows), 'run' for INSERT/UPDATE/DELETE (returns rowsAffected) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SessionFsSqliteQueryType { + /** The {@code exec} variant. */ + EXEC("exec"), + /** The {@code query} variant. */ + QUERY("query"), + /** The {@code run} variant. */ + RUN("run"); + + private final String value; + SessionFsSqliteQueryType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SessionFsSqliteQueryType fromValue(String value) { + for (SessionFsSqliteQueryType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SessionFsSqliteQueryType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsStatParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsStatParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsStatParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsStatParams.java index 5d60281c8b..2e6ccfdeae 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsStatParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsStatParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.stat} RPC method. + * Path whose metadata should be returned from the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsStatResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsStatResult.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsStatResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsStatResult.java index 28bb3a9fbd..56d883d106 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsStatResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsStatResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code sessionFs.stat} RPC method. + * Filesystem metadata for the requested path, or a filesystem error if the stat failed. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsWriteFileParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionFsWriteFileParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsWriteFileParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionFsWriteFileParams.java index 1c03df8a78..4f4e026361 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionFsWriteFileParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionFsWriteFileParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessionFs.writeFile} RPC method. + * File path, content to write, and optional mode for the client-provided session filesystem. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryAbortManualCompactionParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryAbortManualCompactionParams.java new file mode 100644 index 0000000000..04749d2b67 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryAbortManualCompactionParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionHistoryAbortManualCompactionParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryAbortManualCompactionResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryAbortManualCompactionResult.java new file mode 100644 index 0000000000..7767202d70 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryAbortManualCompactionResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether an in-progress manual compaction was aborted. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionHistoryAbortManualCompactionResult( + /** Whether an in-progress manual compaction was aborted. False when no manual compaction was running, when its abort controller was already aborted, or when the session is remote. */ + @JsonProperty("aborted") Boolean aborted +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryApi.java new file mode 100644 index 0000000000..91c7702f78 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryApi.java @@ -0,0 +1,87 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code history} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionHistoryApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionHistoryApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Optional compaction parameters. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture compact() { + return caller.invoke("session.history.compact", java.util.Map.of("sessionId", this.sessionId), SessionHistoryCompactResult.class); + } + + /** + * Identifier of the event to truncate to; this event and all later events are removed. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture truncate(SessionHistoryTruncateParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.history.truncate", _p, SessionHistoryTruncateResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture cancelBackgroundCompaction() { + return caller.invoke("session.history.cancelBackgroundCompaction", java.util.Map.of("sessionId", this.sessionId), SessionHistoryCancelBackgroundCompactionResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture abortManualCompaction() { + return caller.invoke("session.history.abortManualCompaction", java.util.Map.of("sessionId", this.sessionId), SessionHistoryAbortManualCompactionResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture summarizeForHandoff() { + return caller.invoke("session.history.summarizeForHandoff", java.util.Map.of("sessionId", this.sessionId), SessionHistorySummarizeForHandoffResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCancelBackgroundCompactionParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCancelBackgroundCompactionParams.java new file mode 100644 index 0000000000..56adc34ae9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCancelBackgroundCompactionParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionHistoryCancelBackgroundCompactionParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCancelBackgroundCompactionResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCancelBackgroundCompactionResult.java new file mode 100644 index 0000000000..c22fdd0928 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCancelBackgroundCompactionResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether an in-progress background compaction was cancelled. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionHistoryCancelBackgroundCompactionResult( + /** Whether an in-progress background compaction was cancelled. False when no compaction was running, when the session is remote, or when the underlying processor was unavailable. */ + @JsonProperty("cancelled") Boolean cancelled +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryCompactParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCompactParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryCompactParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCompactParams.java index 4b352cc623..cbb23e96fd 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryCompactParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCompactParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.history.compact} RPC method. + * Optional compaction parameters. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryCompactResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCompactResult.java similarity index 77% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryCompactResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCompactResult.java index 060b97f48f..46a52f425b 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryCompactResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryCompactResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.history.compact} RPC method. + * Compaction outcome with the number of tokens and messages removed, summary text, and the resulting context window breakdown. * * @since 1.0.0 */ @@ -27,6 +27,8 @@ public record SessionHistoryCompactResult( @JsonProperty("tokensRemoved") Long tokensRemoved, /** Number of messages removed during compaction */ @JsonProperty("messagesRemoved") Long messagesRemoved, + /** Summary text produced by compaction. Omitted when compaction did not produce a summary (e.g. failure path). */ + @JsonProperty("summaryContent") String summaryContent, /** Post-compaction context window usage breakdown */ @JsonProperty("contextWindow") HistoryCompactContextWindow contextWindow ) { diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionHistorySummarizeForHandoffParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistorySummarizeForHandoffParams.java new file mode 100644 index 0000000000..816af2cd1b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistorySummarizeForHandoffParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionHistorySummarizeForHandoffParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionHistorySummarizeForHandoffResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistorySummarizeForHandoffResult.java new file mode 100644 index 0000000000..3723aae25d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistorySummarizeForHandoffResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Markdown summary of the conversation context (empty when not available). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionHistorySummarizeForHandoffResult( + /** Markdown summary of the conversation context produced by an LLM. Empty string when there are no messages or when the session does not support local summarization. */ + @JsonProperty("summary") String summary +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryTruncateParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryTruncateParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryTruncateParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionHistoryTruncateParams.java index 09ddf68df1..70b1331e4f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryTruncateParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryTruncateParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.history.truncate} RPC method. + * Identifier of the event to truncate to; this event and all later events are removed. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryTruncateResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryTruncateResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryTruncateResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionHistoryTruncateResult.java index a295cd1bd2..3c2a74ccbb 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryTruncateResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionHistoryTruncateResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.history.truncate} RPC method. + * Number of events that were removed by the truncation. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionInstalledPlugin.java b/src/generated/java/com/github/copilot/generated/rpc/SessionInstalledPlugin.java new file mode 100644 index 0000000000..5d14285586 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionInstalledPlugin.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `SessionInstalledPlugin` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionInstalledPlugin( + /** Plugin name */ + @JsonProperty("name") String name, + /** Marketplace the plugin came from (empty string for direct repo installs) */ + @JsonProperty("marketplace") String marketplace, + /** Installed version, if known */ + @JsonProperty("version") String version, + /** Installation timestamp (ISO-8601) */ + @JsonProperty("installed_at") String installedAt, + /** Whether the plugin is currently enabled */ + @JsonProperty("enabled") Boolean enabled, + /** Path where the plugin is cached locally */ + @JsonProperty("cache_path") String cachePath, + /** Source descriptor for direct repo installs (when marketplace is empty) */ + @JsonProperty("source") Object source +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsApi.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsApi.java index 1458419504..15f3fce68c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -28,7 +28,9 @@ public final class SessionInstructionsApi { } /** - * Invokes {@code session.instructions.getSources}. + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture getSources() { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsGetSourcesParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsGetSourcesParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsGetSourcesParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsGetSourcesParams.java index 5fbe01602c..f9b683147d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsGetSourcesParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsGetSourcesParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.instructions.getSources} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsGetSourcesResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsGetSourcesResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsGetSourcesResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsGetSourcesResult.java index 66ff52bd29..4d62780dae 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionInstructionsGetSourcesResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionInstructionsGetSourcesResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.instructions.getSources} RPC method. + * Instruction sources loaded for the session, in merge order. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogLevel.java b/src/generated/java/com/github/copilot/generated/rpc/SessionLogLevel.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogLevel.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionLogLevel.java index 7ec7361a74..e9ca23da2f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogLevel.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionLogLevel.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionLogParams.java similarity index 70% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionLogParams.java index 111e58cf51..edd160f82f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionLogParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.log} RPC method. + * Message text, optional severity level, persistence flag, optional follow-up URL, and optional tip. * * @since 1.0.0 */ @@ -27,9 +27,13 @@ public record SessionLogParams( @JsonProperty("message") String message, /** Log severity level. Determines how the message is displayed in the timeline. Defaults to "info". */ @JsonProperty("level") SessionLogLevel level, + /** Domain category for this log entry (e.g., "mcp", "subscription", "policy", "model"). Maps to `infoType`/`warningType`/`errorType` on the emitted event. Defaults to "notification". */ + @JsonProperty("type") String type, /** When true, the message is transient and not persisted to the session event log on disk */ @JsonProperty("ephemeral") Boolean ephemeral, /** Optional URL the user can open in their browser for more details */ - @JsonProperty("url") String url + @JsonProperty("url") String url, + /** Optional actionable tip displayed alongside the message. Only honored on `level: "info"`. */ + @JsonProperty("tip") String tip ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionLogResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionLogResult.java index 7ba330dac9..7d9d79d710 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionLogResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionLogResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.log} RPC method. + * Identifier of the session event that was emitted for the log message. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionLspApi.java similarity index 68% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionLspApi.java index 351a2d14cd..76678266c8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionLspApi.java @@ -5,18 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; /** - * API methods for the {@code commands} namespace. + * API methods for the {@code lsp} namespace. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionCommandsApi { +public final class SessionLspApi { private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; @@ -24,22 +24,24 @@ public final class SessionCommandsApi { private final String sessionId; /** @param caller the RPC transport function */ - SessionCommandsApi(RpcCaller caller, String sessionId) { + SessionLspApi(RpcCaller caller, String sessionId) { this.caller = caller; this.sessionId = sessionId; } /** - * Invokes {@code session.commands.handlePendingCommand}. + * Parameters for (re)loading the merged LSP configuration set. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture handlePendingCommand(SessionCommandsHandlePendingCommandParams params) { + public CompletableFuture initialize(SessionLspInitializeParams params) { com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); _p.put("sessionId", this.sessionId); - return caller.invoke("session.commands.handlePendingCommand", _p, SessionCommandsHandlePendingCommandResult.class); + return caller.invoke("session.lsp.initialize", _p, Void.class); } } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionLspInitializeParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionLspInitializeParams.java new file mode 100644 index 0000000000..bd0387b88d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionLspInitializeParams.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Parameters for (re)loading the merged LSP configuration set. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionLspInitializeParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Working directory used to load project-level LSP configs. Defaults to the session working directory when omitted. */ + @JsonProperty("workingDirectory") String workingDirectory, + /** Git root used as the boundary when traversing for project-level LSP configs (supports monorepos). */ + @JsonProperty("gitRoot") String gitRoot, + /** Force re-initialization even when LSP configs were already loaded for the working directory. */ + @JsonProperty("force") Boolean force +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpApi.java new file mode 100644 index 0000000000..c9e577fd59 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpApi.java @@ -0,0 +1,144 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code mcp} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionMcpApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** API methods for the {@code mcp.oauth} sub-namespace. */ + public final SessionMcpOauthApi oauth; + /** API methods for the {@code mcp.apps} sub-namespace. */ + public final SessionMcpAppsApi apps; + + /** @param caller the RPC transport function */ + SessionMcpApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + this.oauth = new SessionMcpOauthApi(caller, sessionId); + this.apps = new SessionMcpAppsApi(caller, sessionId); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture list() { + return caller.invoke("session.mcp.list", java.util.Map.of("sessionId", this.sessionId), SessionMcpListResult.class); + } + + /** + * Name of the MCP server to enable for the session. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture enable(SessionMcpEnableParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.enable", _p, Void.class); + } + + /** + * Name of the MCP server to disable for the session. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture disable(SessionMcpDisableParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.disable", _p, Void.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture reload() { + return caller.invoke("session.mcp.reload", java.util.Map.of("sessionId", this.sessionId), Void.class); + } + + /** + * Identifiers and raw MCP CreateMessageRequest params used to run a sampling inference. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture executeSampling(SessionMcpExecuteSamplingParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.executeSampling", _p, SessionMcpExecuteSamplingResult.class); + } + + /** + * The requestId previously passed to executeSampling that should be cancelled. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture cancelSamplingExecution(SessionMcpCancelSamplingExecutionParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.cancelSamplingExecution", _p, SessionMcpCancelSamplingExecutionResult.class); + } + + /** + * Mode controlling how MCP server env values are resolved (`direct` or `indirect`). + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setEnvValueMode(SessionMcpSetEnvValueModeParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.setEnvValueMode", _p, SessionMcpSetEnvValueModeResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture removeGitHub() { + return caller.invoke("session.mcp.removeGitHub", java.util.Map.of("sessionId", this.sessionId), SessionMcpRemoveGitHubResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsApi.java new file mode 100644 index 0000000000..b6c131a6aa --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsApi.java @@ -0,0 +1,117 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code mcp.apps} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionMcpAppsApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionMcpAppsApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * MCP server and resource URI to fetch. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture readResource(SessionMcpAppsReadResourceParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.apps.readResource", _p, SessionMcpAppsReadResourceResult.class); + } + + /** + * MCP server to list app-callable tools for. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture listTools(SessionMcpAppsListToolsParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.apps.listTools", _p, SessionMcpAppsListToolsResult.class); + } + + /** + * MCP server, tool name, and arguments to invoke from an MCP App view. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture callTool(SessionMcpAppsCallToolParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.apps.callTool", _p, Void.class); + } + + /** + * Host context to advertise to MCP App guests. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setHostContext(SessionMcpAppsSetHostContextParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.apps.setHostContext", _p, Void.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getHostContext() { + return caller.invoke("session.mcp.apps.getHostContext", java.util.Map.of("sessionId", this.sessionId), SessionMcpAppsGetHostContextResult.class); + } + + /** + * MCP server to diagnose MCP Apps wiring for. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture diagnose(SessionMcpAppsDiagnoseParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.mcp.apps.diagnose", _p, SessionMcpAppsDiagnoseResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsCallToolParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsCallToolParams.java new file mode 100644 index 0000000000..8c4788e471 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsCallToolParams.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * MCP server, tool name, and arguments to invoke from an MCP App view. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsCallToolParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** MCP server hosting the tool */ + @JsonProperty("serverName") String serverName, + /** MCP tool name */ + @JsonProperty("toolName") String toolName, + /** Tool arguments */ + @JsonProperty("arguments") Map arguments, + /** **Required.** Server whose ui:// view issued the request. Per SEP-1865 ('callable by the app from this server only'), the call is rejected when this differs from `serverName`, and rejected outright when missing. */ + @JsonProperty("originServerName") String originServerName +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsDiagnoseParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsDiagnoseParams.java new file mode 100644 index 0000000000..cf700a3412 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsDiagnoseParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * MCP server to diagnose MCP Apps wiring for. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsDiagnoseParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** MCP server to probe */ + @JsonProperty("serverName") String serverName +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsDiagnoseResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsDiagnoseResult.java new file mode 100644 index 0000000000..144081f483 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsDiagnoseResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Diagnostic snapshot of MCP Apps wiring for the named server. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsDiagnoseResult( + /** Capability negotiation snapshot */ + @JsonProperty("capability") McpAppsDiagnoseCapability capability, + /** What the server returned for this session */ + @JsonProperty("server") McpAppsDiagnoseServer server +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsGetHostContextParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsGetHostContextParams.java new file mode 100644 index 0000000000..380164b3cd --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsGetHostContextParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsGetHostContextParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsGetHostContextResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsGetHostContextResult.java new file mode 100644 index 0000000000..a543b48200 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsGetHostContextResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Current host context advertised to MCP App guests. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsGetHostContextResult( + /** Current host context */ + @JsonProperty("context") McpAppsHostContextDetails context +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsListToolsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsListToolsParams.java new file mode 100644 index 0000000000..d5e0c578ac --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsListToolsParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * MCP server to list app-callable tools for. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsListToolsParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** MCP server hosting the app */ + @JsonProperty("serverName") String serverName, + /** **Required.** Server whose ui:// view issued the request. Per SEP-1865 ('callable by the app from this server only'), the call is rejected when this differs from `serverName`, and rejected outright when missing. */ + @JsonProperty("originServerName") String originServerName +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsListToolsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsListToolsResult.java new file mode 100644 index 0000000000..054ce56a8a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsListToolsResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * App-callable tools from the named MCP server. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsListToolsResult( + /** App-callable tools from the server */ + @JsonProperty("tools") List> tools +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsReadResourceParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsReadResourceParams.java new file mode 100644 index 0000000000..26b29ee3d7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsReadResourceParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * MCP server and resource URI to fetch. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsReadResourceParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Name of the MCP server hosting the resource */ + @JsonProperty("serverName") String serverName, + /** Resource URI (typically ui://...) */ + @JsonProperty("uri") String uri +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsReadResourceResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsReadResourceResult.java new file mode 100644 index 0000000000..e0f9810a32 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsReadResourceResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Resource contents returned by the MCP server. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsReadResourceResult( + /** Resource contents returned by the server */ + @JsonProperty("contents") List contents +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsSetHostContextParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsSetHostContextParams.java new file mode 100644 index 0000000000..19c9347b70 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpAppsSetHostContextParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Host context to advertise to MCP App guests. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpAppsSetHostContextParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Host context advertised to MCP App guests */ + @JsonProperty("context") McpAppsSetHostContextDetails context +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpCancelSamplingExecutionParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpCancelSamplingExecutionParams.java new file mode 100644 index 0000000000..c00459e4b7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpCancelSamplingExecutionParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The requestId previously passed to executeSampling that should be cancelled. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpCancelSamplingExecutionParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The requestId previously passed to executeSampling that should be cancelled */ + @JsonProperty("requestId") String requestId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpCancelSamplingExecutionResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpCancelSamplingExecutionResult.java new file mode 100644 index 0000000000..9495602f65 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpCancelSamplingExecutionResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether an in-flight sampling execution with the given requestId was found and cancelled. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpCancelSamplingExecutionResult( + /** True if an in-flight execution with the given requestId was found and signalled to cancel. False when no such execution is in flight (already completed, never started, or cancelled by another caller). */ + @JsonProperty("cancelled") Boolean cancelled +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpDisableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpDisableParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpDisableParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpDisableParams.java index ab0892a9ce..adee20ceb6 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpDisableParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpDisableParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.mcp.disable} RPC method. + * Name of the MCP server to disable for the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpDisableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpDisableResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpDisableResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpDisableResult.java index 0565cf8d1d..834dc2cb75 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpDisableResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpDisableResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpEnableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpEnableParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpEnableParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpEnableParams.java index 0e6b1cf748..53b23f9eea 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpEnableParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpEnableParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.mcp.enable} RPC method. + * Name of the MCP server to enable for the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpEnableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpEnableResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpEnableResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpEnableResult.java index 43319c3a93..86b1a67163 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpEnableResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpEnableResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpExecuteSamplingParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpExecuteSamplingParams.java new file mode 100644 index 0000000000..b6f995971f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpExecuteSamplingParams.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifiers and raw MCP CreateMessageRequest params used to run a sampling inference. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpExecuteSamplingParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Caller-provided unique identifier for this sampling execution. Use this same ID with cancelSamplingExecution to cancel the in-flight call. Must be unique within the session for the lifetime of the call. */ + @JsonProperty("requestId") String requestId, + /** Name of the MCP server that initiated the sampling request */ + @JsonProperty("serverName") String serverName, + /** The original MCP JSON-RPC request ID (string or number). Used by the runtime to correlate the inference with the originating MCP request for telemetry; this is distinct from `requestId` (which is the schema-level cancellation handle). */ + @JsonProperty("mcpRequestId") Object mcpRequestId, + /** Raw MCP CreateMessageRequest params, as received in the `sampling.requested` event. Treated as opaque at the schema layer; the runtime converts the embedded MCP messages into the OpenAI chat-completion shape internally. */ + @JsonProperty("request") McpExecuteSamplingRequest request +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpExecuteSamplingResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpExecuteSamplingResult.java new file mode 100644 index 0000000000..578cb10f2d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpExecuteSamplingResult.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Outcome of an MCP sampling execution: success result, failure error, or cancellation. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpExecuteSamplingResult( + /** Outcome of the sampling inference. 'success' produced a response; 'failure' encountered an error (including agent-side rejection by content filter or criteria); 'cancelled' the caller cancelled this execution via cancelSamplingExecution. */ + @JsonProperty("action") McpSamplingExecutionAction action, + /** MCP CreateMessageResult payload (with optional 'tools' extension), present when action='success'. Treated as opaque at the schema layer; consumers should construct/consume it per the MCP CreateMessageResult shape. */ + @JsonProperty("result") McpExecuteSamplingResult result, + /** Error description, present when action='failure'. */ + @JsonProperty("error") String error +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpListParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpListParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpListParams.java index c3a8a2b8dd..4ae5d6a2c2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpListParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpListParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.mcp.list} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpListResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpListResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpListResult.java index 8128229a04..220f663b6a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpListResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpListResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.mcp.list} RPC method. + * MCP servers configured for the session, with their connection status. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthApi.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthApi.java index 4a864468e3..68535ebc42 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,7 @@ public final class SessionMcpOauthApi { } /** - * Invokes {@code session.mcp.oauth.login}. + * Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, and the callback success-page copy. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthLoginParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthLoginParams.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthLoginParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthLoginParams.java index ef336408d1..4fcca6618d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthLoginParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthLoginParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.mcp.oauth.login} RPC method. + * Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, and the callback success-page copy. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthLoginResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthLoginResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthLoginResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthLoginResult.java index e46ab39efb..e3d9071f7e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpOauthLoginResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpOauthLoginResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.mcp.oauth.login} RPC method. + * OAuth authorization URL the caller should open, or empty when cached tokens already authenticated the server. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpReloadParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpReloadParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpReloadParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpReloadParams.java index b3e3ccf28a..6df56c453c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpReloadParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpReloadParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.mcp.reload} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpReloadResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpReloadResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpReloadResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMcpReloadResult.java index 80a2c4c265..3f0d970fcb 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpReloadResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpReloadResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpRemoveGitHubParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpRemoveGitHubParams.java new file mode 100644 index 0000000000..0213c76f53 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpRemoveGitHubParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpRemoveGitHubParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpRemoveGitHubResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpRemoveGitHubResult.java new file mode 100644 index 0000000000..1845649bc1 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpRemoveGitHubResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpRemoveGitHubResult( + /** True when the auto-managed `github` MCP server was removed; false when no removal happened (e.g. user has explicitly configured a `github` server, or the server was not registered). */ + @JsonProperty("removed") Boolean removed +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpSetEnvValueModeParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpSetEnvValueModeParams.java new file mode 100644 index 0000000000..5a524cfb0c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpSetEnvValueModeParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Mode controlling how MCP server env values are resolved (`direct` or `indirect`). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpSetEnvValueModeParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** How environment-variable values supplied to MCP servers are resolved. "direct" passes literal string values; "indirect" treats values as references (e.g. names of environment variables on the host) that the runtime resolves before launch. Defaults to the runtime's startup mode; clients that intentionally launch MCP servers with literal values (e.g. CLI prompt mode and ACP) set this to "direct". */ + @JsonProperty("mode") McpSetEnvValueModeDetails mode +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMcpSetEnvValueModeResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpSetEnvValueModeResult.java new file mode 100644 index 0000000000..300ef08e78 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMcpSetEnvValueModeResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Env-value mode recorded on the session after the update. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMcpSetEnvValueModeResult( + /** Mode recorded on the session after the update */ + @JsonProperty("mode") McpSetEnvValueModeDetails mode +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadata.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadata.java new file mode 100644 index 0000000000..03a9e3280e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadata.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `SessionMetadata` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadata( + /** Stable session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Session creation time as an ISO 8601 timestamp */ + @JsonProperty("startTime") String startTime, + /** Last-modified time of the session's persisted state, as ISO 8601 */ + @JsonProperty("modifiedTime") String modifiedTime, + /** Short summary of the session, when one has been derived */ + @JsonProperty("summary") String summary, + /** Optional human-friendly name set via /rename */ + @JsonProperty("name") String name, + /** Runtime client name that created/last resumed this session */ + @JsonProperty("clientName") String clientName, + /** True for remote (GitHub) sessions; false for local */ + @JsonProperty("isRemote") Boolean isRemote, + /** True for detached maintenance sessions that should be hidden from normal resume lists. */ + @JsonProperty("isDetached") Boolean isDetached, + /** Schema for the `SessionContext` type. */ + @JsonProperty("context") SessionContext context, + /** GitHub task ID, when this local session is bound to one. Only present for local sessions exported to remote control. */ + @JsonProperty("mcTaskId") String mcTaskId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataApi.java new file mode 100644 index 0000000000..7bd7e66bbf --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataApi.java @@ -0,0 +1,112 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code metadata} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionMetadataApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionMetadataApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture snapshot() { + return caller.invoke("session.metadata.snapshot", java.util.Map.of("sessionId", this.sessionId), SessionMetadataSnapshotResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture isProcessing() { + return caller.invoke("session.metadata.isProcessing", java.util.Map.of("sessionId", this.sessionId), SessionMetadataIsProcessingResult.class); + } + + /** + * Model identifier and token limits used to compute the context-info breakdown. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture contextInfo(SessionMetadataContextInfoParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.metadata.contextInfo", _p, SessionMetadataContextInfoResult.class); + } + + /** + * Updated working-directory/git context to record on the session. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture recordContextChange(SessionMetadataRecordContextChangeParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.metadata.recordContextChange", _p, Void.class); + } + + /** + * Absolute path to set as the session's new working directory. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setWorkingDirectory(SessionMetadataSetWorkingDirectoryParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.metadata.setWorkingDirectory", _p, SessionMetadataSetWorkingDirectoryResult.class); + } + + /** + * Model identifier to use when re-tokenizing the session's existing messages. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture recomputeContextTokens(SessionMetadataRecomputeContextTokensParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.metadata.recomputeContextTokens", _p, SessionMetadataRecomputeContextTokensResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataContextInfoParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataContextInfoParams.java new file mode 100644 index 0000000000..4b6bccf7e3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataContextInfoParams.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Model identifier and token limits used to compute the context-info breakdown. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataContextInfoParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Maximum prompt tokens allowed by the target model. Pass 0 to use the runtime default. */ + @JsonProperty("promptTokenLimit") Long promptTokenLimit, + /** Maximum output tokens allowed by the target model. Pass 0 if unknown. */ + @JsonProperty("outputTokenLimit") Long outputTokenLimit, + /** Model identifier used for tokenization. Omit to use the session default. Used both for token counting and to compute display values. */ + @JsonProperty("selectedModel") String selectedModel +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataContextInfoResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataContextInfoResult.java new file mode 100644 index 0000000000..de9074e8c9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataContextInfoResult.java @@ -0,0 +1,52 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Token breakdown for the session's current context window, or null if uninitialized. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataContextInfoResult( + /** Token breakdown for the current context window, or null if the session has not yet been initialized (no system prompt or tool metadata cached). */ + @JsonProperty("contextInfo") SessionMetadataContextInfoResultContextInfo contextInfo +) { + + /** Token-usage breakdown for the session's current context window */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionMetadataContextInfoResultContextInfo( + /** The model used for token counting */ + @JsonProperty("modelName") String modelName, + /** Tokens consumed by the system prompt */ + @JsonProperty("systemTokens") Long systemTokens, + /** Tokens consumed by user/assistant/tool messages */ + @JsonProperty("conversationTokens") Long conversationTokens, + /** Tokens consumed by tool definitions sent to the model (excludes deferred tools) */ + @JsonProperty("toolDefinitionsTokens") Long toolDefinitionsTokens, + /** Sum of system, conversation and tool-definition tokens */ + @JsonProperty("totalTokens") Long totalTokens, + /** Maximum prompt tokens allowed by the model (or DEFAULT_TOKEN_LIMIT if unspecified) */ + @JsonProperty("promptTokenLimit") Long promptTokenLimit, + /** Token count at which background compaction starts (configurable percentage of promptTokenLimit) */ + @JsonProperty("compactionThreshold") Long compactionThreshold, + /** Total context limit for /context display. promptTokenLimit + min(32k or 64k, outputTokenLimit) depending on model. */ + @JsonProperty("limit") Long limit, + /** Output reserve plus tokens after the buffer-exhaustion blocking threshold (default 95%) */ + @JsonProperty("bufferTokens") Long bufferTokens + ) { + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataIsProcessingParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataIsProcessingParams.java new file mode 100644 index 0000000000..329dbea100 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataIsProcessingParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataIsProcessingParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataIsProcessingResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataIsProcessingResult.java new file mode 100644 index 0000000000..e496bb662e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataIsProcessingResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the local session is currently processing a turn or background continuation. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataIsProcessingResult( + /** Whether the session is currently processing user/agent messages. False for non-local sessions (which don't run a local agentic loop). Reflects an in-flight turn or background continuation. */ + @JsonProperty("processing") Boolean processing +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecomputeContextTokensParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecomputeContextTokensParams.java new file mode 100644 index 0000000000..979f8808da --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecomputeContextTokensParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Model identifier to use when re-tokenizing the session's existing messages. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataRecomputeContextTokensParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Model identifier used for tokenization. The runtime token-counts both chat-context and system-context messages against this model. */ + @JsonProperty("modelId") String modelId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecomputeContextTokensResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecomputeContextTokensResult.java new file mode 100644 index 0000000000..4aab3841a4 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecomputeContextTokensResult.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Re-tokenize the session's existing messages against `modelId` and return the token totals. Useful for hosts that want an initial estimate of context usage on session resume, before the next agent turn fires `session.context_info_changed` events. Returns zeros for an empty session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataRecomputeContextTokensResult( + /** Sum of tokens across chat-context and system-context messages currently held by the session. */ + @JsonProperty("totalTokens") Long totalTokens, + /** Tokens contributed by user/assistant/tool messages (excludes system/developer prompts). */ + @JsonProperty("messagesTokenCount") Long messagesTokenCount, + /** Tokens contributed by system/developer prompt snapshots. */ + @JsonProperty("systemTokenCount") Long systemTokenCount +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecordContextChangeParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecordContextChangeParams.java new file mode 100644 index 0000000000..6b42c822cc --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecordContextChangeParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Updated working-directory/git context to record on the session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataRecordContextChangeParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Updated working directory and git context. Emitted as the new payload of `session.context_changed`. */ + @JsonProperty("context") SessionWorkingDirectoryContext context +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecordContextChangeResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecordContextChangeResult.java new file mode 100644 index 0000000000..41f252b20d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataRecordContextChangeResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Notify the session that its working directory context has changed. Emits a `session.context_changed` event so consumers (telemetry, OTel tracker, ACP, the timeline UI) can react. Use this when the host has detected a cwd/branch/repo change outside the session's normal lifecycle (e.g., after a shell command in interactive mode). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataRecordContextChangeResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSetWorkingDirectoryParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSetWorkingDirectoryParams.java new file mode 100644 index 0000000000..507b0a49fa --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSetWorkingDirectoryParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Absolute path to set as the session's new working directory. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataSetWorkingDirectoryParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Absolute path to set as the session's working directory. The runtime updates the session's recorded cwd so subsequent operations (shell tools, file lookups, telemetry) anchor to it. */ + @JsonProperty("workingDirectory") String workingDirectory +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSetWorkingDirectoryResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSetWorkingDirectoryResult.java new file mode 100644 index 0000000000..85ef81026b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSetWorkingDirectoryResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Update the session's working directory. Used by the host when the user explicitly changes cwd (e.g., the `/cd` slash command). The host is responsible for `process.chdir` and any related side-effects (file index, etc.); this method only updates the session's own recorded path. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataSetWorkingDirectoryResult( + /** Working directory after the update */ + @JsonProperty("workingDirectory") String workingDirectory +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotParams.java new file mode 100644 index 0000000000..d3e94df435 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataSnapshotParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotResult.java new file mode 100644 index 0000000000..5b6ae7b8cf --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotResult.java @@ -0,0 +1,79 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.time.OffsetDateTime; +import javax.annotation.processing.Generated; + +/** + * Point-in-time snapshot of slow-changing session identifier and state fields + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionMetadataSnapshotResult( + /** The unique identifier of the session */ + @JsonProperty("sessionId") String sessionId, + /** ISO 8601 timestamp of when the session started */ + @JsonProperty("startTime") OffsetDateTime startTime, + /** ISO 8601 timestamp of when the session's persisted state was last modified on disk. For new sessions, equals startTime. For resumed sessions, reflects the previous modification time at construction. */ + @JsonProperty("modifiedTime") OffsetDateTime modifiedTime, + /** Whether this is a remote session (i.e., one whose runtime executes elsewhere and is steered through this process) */ + @JsonProperty("isRemote") Boolean isRemote, + /** True when the session was detected to be in use by another process at construction time. Local consumers may surface a confirmation prompt before fully attaching. Always false for new sessions. */ + @JsonProperty("alreadyInUse") Boolean alreadyInUse, + /** Absolute path to the session's workspace directory on disk, or null if the session has no associated workspace */ + @JsonProperty("workspacePath") String workspacePath, + /** User-provided name supplied at session construction (via `--name`), if any. Immutable after construction. */ + @JsonProperty("initialName") String initialName, + /** Runtime client name associated with the session (telemetry identifier). */ + @JsonProperty("clientName") String clientName, + /** Remote-session-specific metadata. Populated only when `isRemote` is true. Fields are immutable for the lifetime of the session. */ + @JsonProperty("remoteMetadata") MetadataSnapshotRemoteMetadata remoteMetadata, + /** Short human-readable summary of the session, if known. Omitted when no summary has been generated. */ + @JsonProperty("summary") String summary, + /** Absolute path to the session's current working directory */ + @JsonProperty("workingDirectory") String workingDirectory, + /** The current agent mode for this session (e.g., 'interactive', 'plan', 'autopilot') */ + @JsonProperty("currentMode") MetadataSnapshotCurrentMode currentMode, + /** Currently selected model identifier, if any */ + @JsonProperty("selectedModel") String selectedModel, + /** Public-facing workspace metadata for this session, or null if the session has no associated workspace. Excludes runtime-internal fields (GitHub IDs, summary count, internal flags). */ + @JsonProperty("workspace") SessionMetadataSnapshotResultWorkspace workspace +) { + + /** Public-facing projection of workspace metadata for SDK / TUI consumers */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionMetadataSnapshotResultWorkspace( + /** Workspace identifier (1:1 with sessionId) */ + @JsonProperty("id") String id, + /** Current working directory at session start */ + @JsonProperty("cwd") String cwd, + /** Resolved git root for cwd, if any */ + @JsonProperty("git_root") String gitRoot, + /** Repository identifier in 'owner/repo' or 'org/project/repo' format, if any */ + @JsonProperty("repository") String repository, + /** Repository host type, if known */ + @JsonProperty("host_type") WorkspaceSummaryHostType hostType, + /** Branch checked out at session start, if any */ + @JsonProperty("branch") String branch, + /** Display name for the session, if set */ + @JsonProperty("name") String name, + /** ISO 8601 timestamp when the workspace was created */ + @JsonProperty("created_at") OffsetDateTime createdAt, + /** ISO 8601 timestamp when the workspace was last updated */ + @JsonProperty("updated_at") OffsetDateTime updatedAt + ) { + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMode.java b/src/generated/java/com/github/copilot/generated/rpc/SessionMode.java similarity index 91% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMode.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionMode.java index 5b246bcb5a..e12db36240 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMode.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionMode.java @@ -5,12 +5,12 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; /** - * The agent mode. Valid values: "interactive", "plan", "autopilot". + * The session mode the agent is operating in * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModeApi.java similarity index 83% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModeApi.java index bf20ad088f..e5201bd6a5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModeApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,9 @@ public final class SessionModeApi { } /** - * The agent mode. Valid values: "interactive", "plan", "autopilot". + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture get() { @@ -38,10 +40,12 @@ public CompletableFuture get() { } /** - * Invokes {@code session.mode.set}. + * Agent interaction mode to apply to the session. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture set(SessionModeSetParams params) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeGetParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModeGetParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeGetParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModeGetParams.java index e62ab01d65..c1a4936214 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeGetParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModeGetParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.mode.get} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeGetResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModeGetResult.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeGetResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModeGetResult.java index 595dff851b..b5123aebf7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeGetResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModeGetResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeSetParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModeSetParams.java similarity index 82% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeSetParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModeSetParams.java index 4153014e5d..b12bea9ff0 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeSetParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModeSetParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.mode.set} RPC method. + * Agent interaction mode to apply to the session. * * @since 1.0.0 */ @@ -23,7 +23,7 @@ public record SessionModeSetParams( /** Target session identifier */ @JsonProperty("sessionId") String sessionId, - /** The agent mode. Valid values: "interactive", "plan", "autopilot". */ + /** The session mode the agent is operating in */ @JsonProperty("mode") SessionMode mode ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeSetResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModeSetResult.java similarity index 97% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeSetResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModeSetResult.java index f4609f6715..c796022723 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModeSetResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModeSetResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModelApi.java similarity index 61% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModelApi.java index 6c8099d0c3..eda751b3ee 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModelApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,9 @@ public final class SessionModelApi { } /** - * Invokes {@code session.model.getCurrent}. + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture getCurrent() { @@ -38,10 +40,12 @@ public CompletableFuture getCurrent() { } /** - * Invokes {@code session.model.switchTo}. + * Target model identifier and optional reasoning effort, summary, and capability overrides. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture switchTo(SessionModelSwitchToParams params) { @@ -50,4 +54,19 @@ public CompletableFuture switchTo(SessionModelSwitch return caller.invoke("session.model.switchTo", _p, SessionModelSwitchToResult.class); } + /** + * Reasoning effort level to apply to the currently selected model. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setReasoningEffort(SessionModelSetReasoningEffortParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.model.setReasoningEffort", _p, SessionModelSetReasoningEffortResult.class); + } + } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelGetCurrentParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelGetCurrentParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentParams.java index e49e4f2dfe..abcf1c2ab3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelGetCurrentParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.model.getCurrent} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentResult.java new file mode 100644 index 0000000000..7bb2f84968 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModelGetCurrentResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The currently selected model and reasoning effort for the session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionModelGetCurrentResult( + /** Currently active model identifier */ + @JsonProperty("modelId") String modelId, + /** Reasoning effort level currently applied to the active model, when one is set. Reads `Session.getReasoningEffort()` synchronously after `getSelectedModel()` resolves so the two values are reported as a snapshot. */ + @JsonProperty("reasoningEffort") String reasoningEffort +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionModelSetReasoningEffortParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModelSetReasoningEffortParams.java new file mode 100644 index 0000000000..6135c2e0a5 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModelSetReasoningEffortParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Reasoning effort level to apply to the currently selected model. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionModelSetReasoningEffortParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Reasoning effort level to apply to the currently selected model. The host is responsible for validating the value against the model's supported levels before calling. */ + @JsonProperty("reasoningEffort") String reasoningEffort +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionModelSetReasoningEffortResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModelSetReasoningEffortResult.java new file mode 100644 index 0000000000..2d6cbd0a6a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModelSetReasoningEffortResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Update the session's reasoning effort without changing the selected model. Use `switchTo` instead when you also need to change the model. The runtime stores the effort on the session and applies it to subsequent turns. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionModelSetReasoningEffortResult( + /** Reasoning effort level recorded on the session after the update */ + @JsonProperty("reasoningEffort") String reasoningEffort +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelSwitchToParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToParams.java similarity index 76% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelSwitchToParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToParams.java index 4d69219fe2..c5c1cbbe02 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelSwitchToParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.model.switchTo} RPC method. + * Target model identifier and optional reasoning effort, summary, and capability overrides. * * @since 1.0.0 */ @@ -25,8 +25,10 @@ public record SessionModelSwitchToParams( @JsonProperty("sessionId") String sessionId, /** Model identifier to switch to */ @JsonProperty("modelId") String modelId, - /** Reasoning effort level to use for the model */ + /** Reasoning effort level to use for the model. "none" disables reasoning. */ @JsonProperty("reasoningEffort") String reasoningEffort, + /** Reasoning summary mode to request for supported model clients */ + @JsonProperty("reasoningSummary") ReasoningSummary reasoningSummary, /** Override individual model capabilities resolved by the runtime */ @JsonProperty("modelCapabilities") ModelCapabilitiesOverride modelCapabilities ) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelSwitchToResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelSwitchToResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java index 5e93b51aed..8bf6f2c8e5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionModelSwitchToResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.model.switchTo} RPC method. + * The model identifier active on the session after the switch. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionNameApi.java similarity index 58% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionNameApi.java index 2998ea6626..e7e1be58ae 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionMcpApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionNameApi.java @@ -5,46 +5,42 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; /** - * API methods for the {@code mcp} namespace. + * API methods for the {@code name} namespace. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionMcpApi { +public final class SessionNameApi { private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; private final RpcCaller caller; private final String sessionId; - /** API methods for the {@code mcp.oauth} sub-namespace. */ - public final SessionMcpOauthApi oauth; - /** @param caller the RPC transport function */ - SessionMcpApi(RpcCaller caller, String sessionId) { + SessionNameApi(RpcCaller caller, String sessionId) { this.caller = caller; this.sessionId = sessionId; - this.oauth = new SessionMcpOauthApi(caller, sessionId); } /** - * Invokes {@code session.mcp.list}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture list() { - return caller.invoke("session.mcp.list", java.util.Map.of("sessionId", this.sessionId), SessionMcpListResult.class); + public CompletableFuture get() { + return caller.invoke("session.name.get", java.util.Map.of("sessionId", this.sessionId), SessionNameGetResult.class); } /** - * Invokes {@code session.mcp.enable}. + * New friendly name to apply to the session. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. @@ -52,14 +48,14 @@ public CompletableFuture list() { * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture enable(SessionMcpEnableParams params) { + public CompletableFuture set(SessionNameSetParams params) { com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); _p.put("sessionId", this.sessionId); - return caller.invoke("session.mcp.enable", _p, Void.class); + return caller.invoke("session.name.set", _p, Void.class); } /** - * Invokes {@code session.mcp.disable}. + * Auto-generated session summary to apply as the session's name when no user-set name exists. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. @@ -67,20 +63,10 @@ public CompletableFuture enable(SessionMcpEnableParams params) { * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture disable(SessionMcpDisableParams params) { + public CompletableFuture setAuto(SessionNameSetAutoParams params) { com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); _p.put("sessionId", this.sessionId); - return caller.invoke("session.mcp.disable", _p, Void.class); - } - - /** - * Invokes {@code session.mcp.reload}. - * - * @apiNote This method is experimental and may change in a future version. - * @since 1.0.0 - */ - public CompletableFuture reload() { - return caller.invoke("session.mcp.reload", java.util.Map.of("sessionId", this.sessionId), Void.class); + return caller.invoke("session.name.setAuto", _p, SessionNameSetAutoResult.class); } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameGetParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionNameGetParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameGetParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionNameGetParams.java index 59b638e4c5..d3728d06d3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameGetParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionNameGetParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.name.get} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameGetResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionNameGetResult.java similarity index 80% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameGetResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionNameGetResult.java index 9e516b45aa..b3e4599674 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameGetResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionNameGetResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.name.get} RPC method. + * The session's friendly name, or null when not yet set. * * @since 1.0.0 */ @@ -21,7 +21,7 @@ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record SessionNameGetResult( - /** The session name, falling back to the auto-generated summary, or null if neither exists */ + /** The session name (user-set or auto-generated), or null if not yet set */ @JsonProperty("name") String name ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionNameSetAutoParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionNameSetAutoParams.java new file mode 100644 index 0000000000..8c69e0d5d7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionNameSetAutoParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Auto-generated session summary to apply as the session's name when no user-set name exists. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionNameSetAutoParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Auto-generated session summary. Empty/whitespace-only values are ignored; values are trimmed before persisting. */ + @JsonProperty("summary") String summary +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionNameSetAutoResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionNameSetAutoResult.java new file mode 100644 index 0000000000..e84407d89c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionNameSetAutoResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the auto-generated summary was applied as the session's name. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionNameSetAutoResult( + /** Whether the auto-generated summary was persisted. False if the session already has a user-set name, the summary normalized to empty, or the session does not have a workspace. */ + @JsonProperty("applied") Boolean applied +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameSetParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionNameSetParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameSetParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionNameSetParams.java index 45e93db451..7fd348c368 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameSetParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionNameSetParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.name.set} RPC method. + * New friendly name to apply to the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsApi.java similarity index 64% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionOptionsApi.java index 1700becb97..4e46d346ad 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionNameApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsApi.java @@ -5,18 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; /** - * API methods for the {@code name} namespace. + * API methods for the {@code options} namespace. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionNameApi { +public final class SessionOptionsApi { private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; @@ -24,30 +24,24 @@ public final class SessionNameApi { private final String sessionId; /** @param caller the RPC transport function */ - SessionNameApi(RpcCaller caller, String sessionId) { + SessionOptionsApi(RpcCaller caller, String sessionId) { this.caller = caller; this.sessionId = sessionId; } /** - * Invokes {@code session.name.get}. - * @since 1.0.0 - */ - public CompletableFuture get() { - return caller.invoke("session.name.get", java.util.Map.of("sessionId", this.sessionId), SessionNameGetResult.class); - } - - /** - * Invokes {@code session.name.set}. + * Patch of mutable session options to apply to the running session. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture set(SessionNameSetParams params) { + public CompletableFuture update(SessionOptionsUpdateParams params) { com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); _p.put("sessionId", this.sessionId); - return caller.invoke("session.name.set", _p, Void.class); + return caller.invoke("session.options.update", _p, SessionOptionsUpdateResult.class); } } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateParams.java new file mode 100644 index 0000000000..8f9a06a4fc --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateParams.java @@ -0,0 +1,103 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Patch of mutable session options to apply to the running session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionOptionsUpdateParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The model ID to use for assistant turns. */ + @JsonProperty("model") String model, + /** Reasoning effort for the selected model (model-defined enum). */ + @JsonProperty("reasoningEffort") String reasoningEffort, + /** Identifier of the client driving the session. */ + @JsonProperty("clientName") String clientName, + /** Identifier sent to LSP-style integrations. */ + @JsonProperty("lspClientName") String lspClientName, + /** Stable integration identifier used for analytics and rate-limit attribution. */ + @JsonProperty("integrationId") String integrationId, + /** Map of feature-flag IDs to their boolean enabled state. */ + @JsonProperty("featureFlags") Map featureFlags, + /** Whether experimental capabilities are enabled. */ + @JsonProperty("isExperimentalMode") Boolean isExperimentalMode, + /** Custom model-provider configuration (BYOK). Opaque shape; see `ProviderConfig` in the runtime. */ + @JsonProperty("provider") Object provider, + /** Absolute working-directory path for shell tools. */ + @JsonProperty("workingDirectory") String workingDirectory, + /** Allowlist of tool names available to this session. */ + @JsonProperty("availableTools") List availableTools, + /** Denylist of tool names for this session. */ + @JsonProperty("excludedTools") List excludedTools, + /** Controls how availableTools (allowlist) and excludedTools (denylist) combine when both are set. */ + @JsonProperty("toolFilterPrecedence") OptionsUpdateToolFilterPrecedence toolFilterPrecedence, + /** Whether shell-script safety heuristics are enabled. */ + @JsonProperty("enableScriptSafety") Boolean enableScriptSafety, + /** Shell init profile (`None` or `NonInteractive`). */ + @JsonProperty("shellInitProfile") String shellInitProfile, + /** Per-shell process flags (e.g., `pwsh` arguments). */ + @JsonProperty("shellProcessFlags") List shellProcessFlags, + /** Sandbox configuration shape; opaque to SDK consumers. See `SandboxConfig` in the runtime. */ + @JsonProperty("sandboxConfig") Object sandboxConfig, + /** Whether interactive shell sessions are logged. */ + @JsonProperty("logInteractiveShells") Boolean logInteractiveShells, + /** How env values are passed to MCP servers (`direct` inlines literal values; `indirect` resolves at launch). */ + @JsonProperty("envValueMode") OptionsUpdateEnvValueMode envValueMode, + /** Additional directories to search for skills. */ + @JsonProperty("skillDirectories") List skillDirectories, + /** Skill IDs that should be excluded from this session. */ + @JsonProperty("disabledSkills") List disabledSkills, + /** Whether to discover custom instructions on demand after successful file views (AGENTS.md / CLAUDE.md / .github/copilot-instructions.md surfacing). Combined with `skipCustomInstructions` and the runtime-side `ON_DEMAND_INSTRUCTIONS` feature flag. */ + @JsonProperty("enableOnDemandInstructionDiscovery") Boolean enableOnDemandInstructionDiscovery, + /** Full set of installed plugins for the session. Replaces the existing list; the runtime invalidates the skills cache only when the list materially changes. */ + @JsonProperty("installedPlugins") List installedPlugins, + /** Whether to default custom agents to local-only execution. */ + @JsonProperty("customAgentsLocalOnly") Boolean customAgentsLocalOnly, + /** Whether to skip loading custom instruction sources. */ + @JsonProperty("skipCustomInstructions") Boolean skipCustomInstructions, + /** Instruction source IDs to exclude from the system prompt. */ + @JsonProperty("disabledInstructionSources") List disabledInstructionSources, + /** Whether to include the `Co-authored-by` trailer in commit messages. */ + @JsonProperty("coauthorEnabled") Boolean coauthorEnabled, + /** Optional path for trajectory output. */ + @JsonProperty("trajectoryFile") String trajectoryFile, + /** Whether to stream model responses. */ + @JsonProperty("enableStreaming") Boolean enableStreaming, + /** Override URL for the Copilot API endpoint. */ + @JsonProperty("copilotUrl") String copilotUrl, + /** Whether to disable the `ask_user` tool (encourages autonomous behavior). */ + @JsonProperty("askUserDisabled") Boolean askUserDisabled, + /** Whether to allow auto-mode continuation across turns. */ + @JsonProperty("continueOnAutoMode") Boolean continueOnAutoMode, + /** Whether the session is running in an interactive UI. */ + @JsonProperty("runningInInteractiveMode") Boolean runningInInteractiveMode, + /** Whether to surface reasoning-summary events from the model. */ + @JsonProperty("enableReasoningSummaries") Boolean enableReasoningSummaries, + /** Runtime context discriminator (e.g., `cli`, `actions`). */ + @JsonProperty("agentContext") String agentContext, + /** Override directory for the session-events log. When unset, the runtime's default events log directory is used. */ + @JsonProperty("eventsLogDirectory") String eventsLogDirectory, + /** Additional content-exclusion policies to merge into the session's policy set. Opaque shape; see `ContentExclusionApiResponse` in the runtime. */ + @JsonProperty("additionalContentExclusionPolicies") List additionalContentExclusionPolicies, + /** Whether to expose the `manage_schedule` tool to the agent. The runtime always owns the per-session schedule registry; this flag only controls tool exposure (typically gated to staff users). */ + @JsonProperty("manageScheduleEnabled") Boolean manageScheduleEnabled +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateResult.java new file mode 100644 index 0000000000..4e514944ca --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionOptionsUpdateResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the session options patch was applied successfully. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionOptionsUpdateResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsApi.java new file mode 100644 index 0000000000..506f1ce31c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsApi.java @@ -0,0 +1,180 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code permissions} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionPermissionsApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** API methods for the {@code permissions.paths} sub-namespace. */ + public final SessionPermissionsPathsApi paths; + /** API methods for the {@code permissions.locations} sub-namespace. */ + public final SessionPermissionsLocationsApi locations; + /** API methods for the {@code permissions.folderTrust} sub-namespace. */ + public final SessionPermissionsFolderTrustApi folderTrust; + /** API methods for the {@code permissions.urls} sub-namespace. */ + public final SessionPermissionsUrlsApi urls; + + /** @param caller the RPC transport function */ + SessionPermissionsApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + this.paths = new SessionPermissionsPathsApi(caller, sessionId); + this.locations = new SessionPermissionsLocationsApi(caller, sessionId); + this.folderTrust = new SessionPermissionsFolderTrustApi(caller, sessionId); + this.urls = new SessionPermissionsUrlsApi(caller, sessionId); + } + + /** + * Patch of permission policy fields to apply (omit a field to leave it unchanged). + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture configure(SessionPermissionsConfigureParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.configure", _p, SessionPermissionsConfigureResult.class); + } + + /** + * Pending permission request ID and the decision to apply (approve/reject and scope). + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture handlePendingPermissionRequest(SessionPermissionsHandlePendingPermissionRequestParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.handlePendingPermissionRequest", _p, SessionPermissionsHandlePendingPermissionRequestResult.class); + } + + /** + * No parameters; returns currently-pending permission requests for the session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture pendingRequests() { + return caller.invoke("session.permissions.pendingRequests", java.util.Map.of("sessionId", this.sessionId), SessionPermissionsPendingRequestsResult.class); + } + + /** + * Allow-all toggle for tool permission requests, with an optional telemetry source. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setApproveAll(SessionPermissionsSetApproveAllParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.setApproveAll", _p, SessionPermissionsSetApproveAllResult.class); + } + + /** + * Whether to enable full allow-all permissions for the session. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setAllowAll(SessionPermissionsSetAllowAllParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.setAllowAll", _p, SessionPermissionsSetAllowAllResult.class); + } + + /** + * No parameters. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getAllowAll() { + return caller.invoke("session.permissions.getAllowAll", java.util.Map.of("sessionId", this.sessionId), SessionPermissionsGetAllowAllResult.class); + } + + /** + * Scope and add/remove instructions for modifying session- or location-scoped permission rules. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture modifyRules(SessionPermissionsModifyRulesParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.modifyRules", _p, SessionPermissionsModifyRulesResult.class); + } + + /** + * Toggles whether permission prompts should be bridged into session events for this client. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setRequired(SessionPermissionsSetRequiredParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.setRequired", _p, SessionPermissionsSetRequiredResult.class); + } + + /** + * No parameters; clears all session-scoped tool permission approvals. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture resetSessionApprovals() { + return caller.invoke("session.permissions.resetSessionApprovals", java.util.Map.of("sessionId", this.sessionId), SessionPermissionsResetSessionApprovalsResult.class); + } + + /** + * Notification payload describing the permission prompt that the client just rendered. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture notifyPromptShown(SessionPermissionsNotifyPromptShownParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.notifyPromptShown", _p, SessionPermissionsNotifyPromptShownResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsConfigureParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsConfigureParams.java new file mode 100644 index 0000000000..0ae82cd21c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsConfigureParams.java @@ -0,0 +1,40 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Patch of permission policy fields to apply (omit a field to leave it unchanged). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsConfigureParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** If specified, sets whether tool permission requests are auto-approved without prompting. Omit to leave the current value unchanged. */ + @JsonProperty("approveAllToolPermissionRequests") Boolean approveAllToolPermissionRequests, + /** If specified, sets whether path/URL read permission requests are auto-approved. Omit to leave the current value unchanged. */ + @JsonProperty("approveAllReadPermissionRequests") Boolean approveAllReadPermissionRequests, + /** If specified, replaces the session's approved/denied permission rules. Omit to leave the current rules unchanged. */ + @JsonProperty("rules") PermissionRulesSet rules, + /** If specified, replaces the session's path-permission policy. The runtime constructs the appropriate PathManager based on these inputs (rooted at the session's working directory). Omit to leave the current path policy unchanged. */ + @JsonProperty("paths") PermissionPathsConfig paths, + /** If specified, replaces the session's URL-permission policy. The runtime constructs a fresh DefaultUrlManager based on these inputs. Omit to leave the current URL policy unchanged. */ + @JsonProperty("urls") PermissionUrlsConfig urls, + /** If specified, replaces the host-supplied GitHub Content Exclusion policies on the session (combined with natively-discovered policies when evaluating tool/file access). Omit to leave the current policies unchanged. */ + @JsonProperty("additionalContentExclusionPolicies") List additionalContentExclusionPolicies +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsConfigureResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsConfigureResult.java new file mode 100644 index 0000000000..267403f092 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsConfigureResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsConfigureResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustAddTrustedParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustAddTrustedParams.java new file mode 100644 index 0000000000..27544af717 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustAddTrustedParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Folder path to add to trusted folders. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsFolderTrustAddTrustedParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Folder path to mark as trusted */ + @JsonProperty("path") String path +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustAddTrustedResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustAddTrustedResult.java new file mode 100644 index 0000000000..d7181cd860 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustAddTrustedResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsFolderTrustAddTrustedResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustApi.java similarity index 58% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustApi.java index d6c1e3b4d3..00191e5c4b 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustApi.java @@ -5,18 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; /** - * API methods for the {@code ui} namespace. + * API methods for the {@code permissions.folderTrust} namespace. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionUiApi { +public final class SessionPermissionsFolderTrustApi { private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; @@ -24,35 +24,39 @@ public final class SessionUiApi { private final String sessionId; /** @param caller the RPC transport function */ - SessionUiApi(RpcCaller caller, String sessionId) { + SessionPermissionsFolderTrustApi(RpcCaller caller, String sessionId) { this.caller = caller; this.sessionId = sessionId; } /** - * The elicitation response (accept with form values, decline, or cancel) + * Folder path to check for trust. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture elicitation(SessionUiElicitationParams params) { + public CompletableFuture isTrusted(SessionPermissionsFolderTrustIsTrustedParams params) { com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); _p.put("sessionId", this.sessionId); - return caller.invoke("session.ui.elicitation", _p, SessionUiElicitationResult.class); + return caller.invoke("session.permissions.folderTrust.isTrusted", _p, SessionPermissionsFolderTrustIsTrustedResult.class); } /** - * Invokes {@code session.ui.handlePendingElicitation}. + * Folder path to add to trusted folders. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture handlePendingElicitation(SessionUiHandlePendingElicitationParams params) { + public CompletableFuture addTrusted(SessionPermissionsFolderTrustAddTrustedParams params) { com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); _p.put("sessionId", this.sessionId); - return caller.invoke("session.ui.handlePendingElicitation", _p, SessionUiHandlePendingElicitationResult.class); + return caller.invoke("session.permissions.folderTrust.addTrusted", _p, SessionPermissionsFolderTrustAddTrustedResult.class); } } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustIsTrustedParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustIsTrustedParams.java new file mode 100644 index 0000000000..f8d666a88f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustIsTrustedParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Folder path to check for trust. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsFolderTrustIsTrustedParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Folder path to check */ + @JsonProperty("path") String path +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustIsTrustedResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustIsTrustedResult.java new file mode 100644 index 0000000000..c969d324b7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsFolderTrustIsTrustedResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Folder trust check result. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsFolderTrustIsTrustedResult( + /** Whether the folder is trusted */ + @JsonProperty("trusted") Boolean trusted +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsGetAllowAllParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsGetAllowAllParams.java new file mode 100644 index 0000000000..ff74dc08d3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsGetAllowAllParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * No parameters. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsGetAllowAllParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsGetAllowAllResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsGetAllowAllResult.java new file mode 100644 index 0000000000..84b7cfbf09 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsGetAllowAllResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Current full allow-all permission state. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsGetAllowAllResult( + /** Whether full allow-all permissions are currently active */ + @JsonProperty("enabled") Boolean enabled +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsHandlePendingPermissionRequestParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsHandlePendingPermissionRequestParams.java similarity index 84% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsHandlePendingPermissionRequestParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsHandlePendingPermissionRequestParams.java index 016d2001c1..2f061ed0c7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsHandlePendingPermissionRequestParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsHandlePendingPermissionRequestParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.permissions.handlePendingPermissionRequest} RPC method. + * Pending permission request ID and the decision to apply (approve/reject and scope). * * @since 1.0.0 */ @@ -25,6 +25,7 @@ public record SessionPermissionsHandlePendingPermissionRequestParams( @JsonProperty("sessionId") String sessionId, /** Request ID of the pending permission request */ @JsonProperty("requestId") String requestId, + /** The client's response to the pending permission prompt */ @JsonProperty("result") Object result ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsHandlePendingPermissionRequestResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsHandlePendingPermissionRequestResult.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsHandlePendingPermissionRequestResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsHandlePendingPermissionRequestResult.java index cbbdd075bf..07bcc16e7d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsHandlePendingPermissionRequestResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsHandlePendingPermissionRequestResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.permissions.handlePendingPermissionRequest} RPC method. + * Indicates whether the permission decision was applied; false when the request was already resolved. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsAddToolApprovalParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsAddToolApprovalParams.java new file mode 100644 index 0000000000..bb99721ab6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsAddToolApprovalParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Location-scoped tool approval to persist. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsLocationsAddToolApprovalParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Location key (git root or cwd) to persist the approval to */ + @JsonProperty("locationKey") String locationKey, + /** Tool approval to persist and apply */ + @JsonProperty("approval") Object approval +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsAddToolApprovalResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsAddToolApprovalResult.java new file mode 100644 index 0000000000..0448517203 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsAddToolApprovalResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsLocationsAddToolApprovalResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApi.java new file mode 100644 index 0000000000..c40877b6b8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApi.java @@ -0,0 +1,77 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code permissions.locations} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionPermissionsLocationsApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionPermissionsLocationsApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Working directory to resolve into a location-permissions key. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture resolve(SessionPermissionsLocationsResolveParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.locations.resolve", _p, SessionPermissionsLocationsResolveResult.class); + } + + /** + * Working directory to load persisted location permissions for. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture apply(SessionPermissionsLocationsApplyParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.locations.apply", _p, SessionPermissionsLocationsApplyResult.class); + } + + /** + * Location-scoped tool approval to persist. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture addToolApproval(SessionPermissionsLocationsAddToolApprovalParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.locations.addToolApproval", _p, SessionPermissionsLocationsAddToolApprovalResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApplyParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApplyParams.java new file mode 100644 index 0000000000..aa40ddb2a8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApplyParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Working directory to load persisted location permissions for. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsLocationsApplyParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Working directory whose persisted location permissions should be applied */ + @JsonProperty("workingDirectory") String workingDirectory +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApplyResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApplyResult.java new file mode 100644 index 0000000000..842226b325 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsApplyResult.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Summary of persisted location permissions applied to the session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsLocationsApplyResult( + /** Location key used in the location-permissions store */ + @JsonProperty("locationKey") String locationKey, + /** Whether the location is a git repo or directory */ + @JsonProperty("locationType") PermissionLocationType locationType, + /** Whether a different location was applied since the previous apply call */ + @JsonProperty("changed") Boolean changed, + /** Number of location-scoped rules added to the live permission service */ + @JsonProperty("appliedRuleCount") Long appliedRuleCount, + /** Number of persisted allowed directories added to the live path manager */ + @JsonProperty("appliedDirectoryCount") Long appliedDirectoryCount, + /** Location-scoped rules applied to the live permission service */ + @JsonProperty("appliedRules") List appliedRules +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsResolveParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsResolveParams.java new file mode 100644 index 0000000000..2e4f5cf2fc --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsResolveParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Working directory to resolve into a location-permissions key. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsLocationsResolveParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Working directory whose permission location should be resolved */ + @JsonProperty("workingDirectory") String workingDirectory +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsResolveResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsResolveResult.java new file mode 100644 index 0000000000..ff22dcafef --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsLocationsResolveResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Resolved location-permissions key and type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsLocationsResolveResult( + /** Location key used in the location-permissions store */ + @JsonProperty("locationKey") String locationKey, + /** Whether the location is a git repo or directory */ + @JsonProperty("locationType") PermissionLocationType locationType +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsModifyRulesParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsModifyRulesParams.java new file mode 100644 index 0000000000..3243aea8b4 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsModifyRulesParams.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Scope and add/remove instructions for modifying session- or location-scoped permission rules. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsModifyRulesParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Whether the change applies to ephemeral session-scoped rules (cleared at session end) or to location-scoped rules persisted via the location-permissions config file. */ + @JsonProperty("scope") PermissionsModifyRulesScope scope, + /** Rules to add to the scope. Applied before `remove`/`removeAll`. */ + @JsonProperty("add") List add, + /** Specific rules to remove from the scope. Ignored when `removeAll` is true. */ + @JsonProperty("remove") List remove, + /** When true, removes every rule currently in the scope (after any `add` is applied). Useful for clearing the location scope wholesale. */ + @JsonProperty("removeAll") Boolean removeAll +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsModifyRulesResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsModifyRulesResult.java new file mode 100644 index 0000000000..6c5c83675d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsModifyRulesResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsModifyRulesResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsNotifyPromptShownParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsNotifyPromptShownParams.java new file mode 100644 index 0000000000..8c4b25c72a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsNotifyPromptShownParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Notification payload describing the permission prompt that the client just rendered. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsNotifyPromptShownParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Human-readable description of the prompt the user is being asked to approve. Used by the runtime to fire the registered `permission_prompt` notification hook (e.g. terminal bell, desktop notification). */ + @JsonProperty("message") String message +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsNotifyPromptShownResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsNotifyPromptShownResult.java new file mode 100644 index 0000000000..092d8abf8b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsNotifyPromptShownResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsNotifyPromptShownResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsAddParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsAddParams.java new file mode 100644 index 0000000000..272408cce5 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsAddParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Directory path to add to the session's allowed directories. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsAddParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Directory to add to the allow-list. The runtime resolves and validates the path before adding. */ + @JsonProperty("path") String path +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsAddResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsAddResult.java new file mode 100644 index 0000000000..182c39b6f3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsAddResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsAddResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsApi.java new file mode 100644 index 0000000000..f4fc1a7709 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsApi.java @@ -0,0 +1,102 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code permissions.paths} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionPermissionsPathsApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionPermissionsPathsApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * No parameters; returns the session's allow-listed directories. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture list() { + return caller.invoke("session.permissions.paths.list", java.util.Map.of("sessionId", this.sessionId), SessionPermissionsPathsListResult.class); + } + + /** + * Directory path to add to the session's allowed directories. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture add(SessionPermissionsPathsAddParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.paths.add", _p, SessionPermissionsPathsAddResult.class); + } + + /** + * Directory path to set as the session's new primary working directory. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture updatePrimary(SessionPermissionsPathsUpdatePrimaryParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.paths.updatePrimary", _p, SessionPermissionsPathsUpdatePrimaryResult.class); + } + + /** + * Path to evaluate against the session's allowed directories. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture isPathWithinAllowedDirectories(SessionPermissionsPathsIsPathWithinAllowedDirectoriesParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.paths.isPathWithinAllowedDirectories", _p, SessionPermissionsPathsIsPathWithinAllowedDirectoriesResult.class); + } + + /** + * Path to evaluate against the session's workspace (primary) directory. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture isPathWithinWorkspace(SessionPermissionsPathsIsPathWithinWorkspaceParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.paths.isPathWithinWorkspace", _p, SessionPermissionsPathsIsPathWithinWorkspaceResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinAllowedDirectoriesParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinAllowedDirectoriesParams.java new file mode 100644 index 0000000000..c9d43aeb21 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinAllowedDirectoriesParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Path to evaluate against the session's allowed directories. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsIsPathWithinAllowedDirectoriesParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Path to check against the session's allowed directories */ + @JsonProperty("path") String path +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinAllowedDirectoriesResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinAllowedDirectoriesResult.java new file mode 100644 index 0000000000..6e876bcca9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinAllowedDirectoriesResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the supplied path is within the session's allowed directories. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsIsPathWithinAllowedDirectoriesResult( + /** Whether the path is within the session's allowed directories */ + @JsonProperty("allowed") Boolean allowed +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinWorkspaceParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinWorkspaceParams.java new file mode 100644 index 0000000000..c8fafd90cc --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinWorkspaceParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Path to evaluate against the session's workspace (primary) directory. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsIsPathWithinWorkspaceParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Path to check against the session workspace directory */ + @JsonProperty("path") String path +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinWorkspaceResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinWorkspaceResult.java new file mode 100644 index 0000000000..3eaf870520 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsIsPathWithinWorkspaceResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the supplied path is within the session's workspace directory. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsIsPathWithinWorkspaceResult( + /** Whether the path is within the session workspace directory */ + @JsonProperty("allowed") Boolean allowed +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsListParams.java new file mode 100644 index 0000000000..43ae1f0404 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsListParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * No parameters; returns the session's allow-listed directories. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsListParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsListResult.java new file mode 100644 index 0000000000..78d86e370e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsListResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Snapshot of the session's allow-listed directories and primary working directory. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsListResult( + /** All directories currently allowed for tool access on this session. */ + @JsonProperty("directories") List directories, + /** The primary working directory for this session. */ + @JsonProperty("primary") String primary +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsUpdatePrimaryParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsUpdatePrimaryParams.java new file mode 100644 index 0000000000..98a7ccfb21 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsUpdatePrimaryParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Directory path to set as the session's new primary working directory. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsUpdatePrimaryParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Directory to set as the new primary working directory for the session's permission policy. */ + @JsonProperty("path") String path +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsUpdatePrimaryResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsUpdatePrimaryResult.java new file mode 100644 index 0000000000..7be2981321 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPathsUpdatePrimaryResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPathsUpdatePrimaryResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPendingRequestsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPendingRequestsParams.java new file mode 100644 index 0000000000..4e3f24cb7f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPendingRequestsParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * No parameters; returns currently-pending permission requests for the session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPendingRequestsParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPendingRequestsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPendingRequestsResult.java new file mode 100644 index 0000000000..33769fa8bd --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsPendingRequestsResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * List of pending permission requests reconstructed from event history. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsPendingRequestsResult( + /** Pending permission prompts reconstructed from the session's event history. Equivalent to the set of `permission.requested` events that have not yet been followed by a matching `permission.completed` event. Used by clients (e.g. the CLI) to hydrate UI for prompts that were emitted before the client attached to the session. */ + @JsonProperty("items") List items +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsResetSessionApprovalsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsResetSessionApprovalsParams.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsResetSessionApprovalsParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsResetSessionApprovalsParams.java index 6fa1b0310f..dd369bf43d 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsResetSessionApprovalsParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsResetSessionApprovalsParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.permissions.resetSessionApprovals} RPC method. + * No parameters; clears all session-scoped tool permission approvals. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsResetSessionApprovalsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsResetSessionApprovalsResult.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsResetSessionApprovalsResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsResetSessionApprovalsResult.java index 91fa4c7822..2097ed0647 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsResetSessionApprovalsResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsResetSessionApprovalsResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.permissions.resetSessionApprovals} RPC method. + * Indicates whether the operation succeeded. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsSetApproveAllParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetAllowAllParams.java similarity index 77% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsSetApproveAllParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetAllowAllParams.java index cd6ad254cc..e6335f45bd 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsSetApproveAllParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetAllowAllParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,17 +13,17 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.permissions.setApproveAll} RPC method. + * Whether to enable full allow-all permissions for the session. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) -public record SessionPermissionsSetApproveAllParams( +public record SessionPermissionsSetAllowAllParams( /** Target session identifier */ @JsonProperty("sessionId") String sessionId, - /** Whether to auto-approve all tool permission requests */ + /** Whether to enable full allow-all permissions */ @JsonProperty("enabled") Boolean enabled ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetAllowAllResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetAllowAllResult.java new file mode 100644 index 0000000000..5026dd78b6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetAllowAllResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded and reports the post-mutation state. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsSetAllowAllResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success, + /** Authoritative allow-all state after the mutation */ + @JsonProperty("enabled") Boolean enabled +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetApproveAllParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetApproveAllParams.java new file mode 100644 index 0000000000..0517a5d86d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetApproveAllParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Allow-all toggle for tool permission requests, with an optional telemetry source. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsSetApproveAllParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Whether to auto-approve all tool permission requests */ + @JsonProperty("enabled") Boolean enabled, + /** Optional source for allow-all telemetry. Defaults to `rpc` when omitted for SDK callers. */ + @JsonProperty("source") PermissionsSetApproveAllSource source +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsSetApproveAllResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetApproveAllResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsSetApproveAllResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetApproveAllResult.java index be59662460..7504cac18f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsSetApproveAllResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetApproveAllResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.permissions.setApproveAll} RPC method. + * Indicates whether the operation succeeded. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetRequiredParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetRequiredParams.java new file mode 100644 index 0000000000..e3c3e0e34b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetRequiredParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Toggles whether permission prompts should be bridged into session events for this client. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsSetRequiredParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Whether the client wants `permission.requested` events bridged from the session-owned permission service. CLI clients that render prompt UI set this to `true` for as long as their listener is mounted; headless callers leave it unset (the default is `false`). */ + @JsonProperty("required") Boolean required +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetRequiredResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetRequiredResult.java new file mode 100644 index 0000000000..eaab9e3787 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsSetRequiredResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsSetRequiredResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsApi.java new file mode 100644 index 0000000000..71b97adff5 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsApi.java @@ -0,0 +1,47 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code permissions.urls} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionPermissionsUrlsApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionPermissionsUrlsApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Whether the URL-permission policy should run in unrestricted mode. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setUnrestrictedMode(SessionPermissionsUrlsSetUnrestrictedModeParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.permissions.urls.setUnrestrictedMode", _p, SessionPermissionsUrlsSetUnrestrictedModeResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsSetUnrestrictedModeParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsSetUnrestrictedModeParams.java new file mode 100644 index 0000000000..6579489eb1 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsSetUnrestrictedModeParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Whether the URL-permission policy should run in unrestricted mode. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsUrlsSetUnrestrictedModeParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Whether to allow access to all URLs without prompting. Toggles the runtime's URL-permission policy in place. */ + @JsonProperty("enabled") Boolean enabled +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsSetUnrestrictedModeResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsSetUnrestrictedModeResult.java new file mode 100644 index 0000000000..beef183a71 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPermissionsUrlsSetUnrestrictedModeResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the operation succeeded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPermissionsUrlsSetUnrestrictedModeResult( + /** Whether the operation succeeded */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanApi.java similarity index 80% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPlanApi.java index 8792bce7e0..25ff6884f2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,9 @@ public final class SessionPlanApi { } /** - * Invokes {@code session.plan.read}. + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture read() { @@ -38,10 +40,12 @@ public CompletableFuture read() { } /** - * Invokes {@code session.plan.update}. + * Replacement contents to write to the session plan file. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture update(SessionPlanUpdateParams params) { @@ -51,7 +55,9 @@ public CompletableFuture update(SessionPlanUpdateParams params) { } /** - * Invokes {@code session.plan.delete}. + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture delete() { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanDeleteParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanDeleteParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanDeleteParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPlanDeleteParams.java index ba09c2d660..d47bd774ea 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanDeleteParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanDeleteParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.plan.delete} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanDeleteResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanDeleteResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanDeleteResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPlanDeleteResult.java index 6661099853..98cb199e6a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanDeleteResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanDeleteResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanReadParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanReadParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanReadParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPlanReadParams.java index 23484403de..57949be2b5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanReadParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanReadParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.plan.read} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanReadResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanReadResult.java similarity index 90% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanReadResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPlanReadResult.java index ddfe1cf5c3..65a1ba75f1 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanReadResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanReadResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.plan.read} RPC method. + * Existence, contents, and resolved path of the session plan file. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanUpdateParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanUpdateParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanUpdateParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPlanUpdateParams.java index 9bd69e3848..128a7b814f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanUpdateParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanUpdateParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.plan.update} RPC method. + * Replacement contents to write to the session plan file. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanUpdateResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanUpdateResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanUpdateResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPlanUpdateResult.java index aa6c64aaf7..3e17cfedae 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPlanUpdateResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPlanUpdateResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsApi.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPluginsApi.java index 897fecd162..e59e2b398f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -28,7 +28,7 @@ public final class SessionPluginsApi { } /** - * Invokes {@code session.plugins.list}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsListParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsListParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPluginsListParams.java index b3407dd520..7229b23a06 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsListParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsListParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.plugins.list} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsListResult.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsListResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionPluginsListResult.java index 501e8760d0..bdf3e6dd81 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPluginsListResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsListResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.plugins.list} RPC method. + * Plugins installed for the session, with their enabled state and version metadata. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionQueueApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionQueueApi.java new file mode 100644 index 0000000000..9c4a13b557 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionQueueApi.java @@ -0,0 +1,60 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code queue} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionQueueApi { + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionQueueApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture pendingItems() { + return caller.invoke("session.queue.pendingItems", java.util.Map.of("sessionId", this.sessionId), SessionQueuePendingItemsResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture removeMostRecent() { + return caller.invoke("session.queue.removeMostRecent", java.util.Map.of("sessionId", this.sessionId), SessionQueueRemoveMostRecentResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture clear() { + return caller.invoke("session.queue.clear", java.util.Map.of("sessionId", this.sessionId), Void.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionQueueClearParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionQueueClearParams.java new file mode 100644 index 0000000000..38d4404c76 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionQueueClearParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueueClearParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionQueuePendingItemsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionQueuePendingItemsParams.java new file mode 100644 index 0000000000..a4e2b10c21 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionQueuePendingItemsParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueuePendingItemsParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionQueuePendingItemsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionQueuePendingItemsResult.java new file mode 100644 index 0000000000..0a8e6540e5 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionQueuePendingItemsResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Snapshot of the session's pending queued items and immediate-steering messages. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueuePendingItemsResult( + /** Pending queued items in submission order. Includes user messages, queued slash commands, and queued model changes; omits internal system items. */ + @JsonProperty("items") List items, + /** Display text for messages currently in the immediate steering queue (interjections sent during a running turn). */ + @JsonProperty("steeringMessages") List steeringMessages +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionQueueRemoveMostRecentParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionQueueRemoveMostRecentParams.java new file mode 100644 index 0000000000..26419bcea6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionQueueRemoveMostRecentParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueueRemoveMostRecentParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionQueueRemoveMostRecentResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionQueueRemoveMostRecentResult.java new file mode 100644 index 0000000000..ecd428322c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionQueueRemoveMostRecentResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether a user-facing pending item was removed. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueueRemoveMostRecentResult( + /** True if a user-facing pending item was removed (LIFO across both queues); false when no removable items remained. */ + @JsonProperty("removed") Boolean removed +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteApi.java similarity index 54% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionRemoteApi.java index 31edf36b7e..3e4f2ce8c3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionPermissionsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteApi.java @@ -5,18 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; /** - * API methods for the {@code permissions} namespace. + * API methods for the {@code remote} namespace. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionPermissionsApi { +public final class SessionRemoteApi { private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; @@ -24,43 +24,49 @@ public final class SessionPermissionsApi { private final String sessionId; /** @param caller the RPC transport function */ - SessionPermissionsApi(RpcCaller caller, String sessionId) { + SessionRemoteApi(RpcCaller caller, String sessionId) { this.caller = caller; this.sessionId = sessionId; } /** - * Invokes {@code session.permissions.handlePendingPermissionRequest}. + * Optional remote session mode ("off", "export", or "on"); defaults to enabling both export and remote steering. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture handlePendingPermissionRequest(SessionPermissionsHandlePendingPermissionRequestParams params) { + public CompletableFuture enable(SessionRemoteEnableParams params) { com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); _p.put("sessionId", this.sessionId); - return caller.invoke("session.permissions.handlePendingPermissionRequest", _p, SessionPermissionsHandlePendingPermissionRequestResult.class); + return caller.invoke("session.remote.enable", _p, SessionRemoteEnableResult.class); } /** - * Invokes {@code session.permissions.setApproveAll}. - *

- * Note: the {@code sessionId} field in the params record is overridden - * by the session-scoped wrapper; any value provided is ignored. + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture setApproveAll(SessionPermissionsSetApproveAllParams params) { - com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); - _p.put("sessionId", this.sessionId); - return caller.invoke("session.permissions.setApproveAll", _p, SessionPermissionsSetApproveAllResult.class); + public CompletableFuture disable() { + return caller.invoke("session.remote.disable", java.util.Map.of("sessionId", this.sessionId), Void.class); } /** - * Invokes {@code session.permissions.resetSessionApprovals}. + * New remote-steerability state to persist as a `session.remote_steerable_changed` event. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture resetSessionApprovals() { - return caller.invoke("session.permissions.resetSessionApprovals", java.util.Map.of("sessionId", this.sessionId), SessionPermissionsResetSessionApprovalsResult.class); + public CompletableFuture notifySteerableChanged(SessionRemoteNotifySteerableChangedParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.remote.notifySteerableChanged", _p, Void.class); } } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteDisableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteDisableParams.java new file mode 100644 index 0000000000..a49197aa14 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteDisableParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionRemoteDisableParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteEnableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteEnableParams.java new file mode 100644 index 0000000000..20c3db98a2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteEnableParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Optional remote session mode ("off", "export", or "on"); defaults to enabling both export and remote steering. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionRemoteEnableParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Per-session remote mode. "off" disables remote, "export" exports session events to GitHub without enabling remote steering, "on" enables both export and remote steering. */ + @JsonProperty("mode") RemoteSessionMode mode +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteEnableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteEnableResult.java new file mode 100644 index 0000000000..5b282f91bd --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteEnableResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * GitHub URL for the session and a flag indicating whether remote steering is enabled. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionRemoteEnableResult( + /** GitHub frontend URL for this session */ + @JsonProperty("url") String url, + /** Whether remote steering is enabled */ + @JsonProperty("remoteSteerable") Boolean remoteSteerable +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteNotifySteerableChangedParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteNotifySteerableChangedParams.java new file mode 100644 index 0000000000..13df7f676e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteNotifySteerableChangedParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * New remote-steerability state to persist as a `session.remote_steerable_changed` event. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionRemoteNotifySteerableChangedParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Whether the session now supports remote steering via GitHub. The runtime persists this as a `session.remote_steerable_changed` event so resume/replay sees the up-to-date capability. */ + @JsonProperty("remoteSteerable") Boolean remoteSteerable +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteNotifySteerableChangedResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteNotifySteerableChangedResult.java new file mode 100644 index 0000000000..4d48e604d6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionRemoteNotifySteerableChangedResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Persist a steerability change as a `session.remote_steerable_changed` event. Used by the host (CLI / SDK consumer) when it has just finished enabling or disabling steering on a remote exporter that the runtime does not directly own. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionRemoteNotifySteerableChangedResult() { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRpc.java b/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java similarity index 55% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRpc.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java index 39ab121b6d..37567e7a77 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRpc.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,6 +30,8 @@ public final class SessionRpc { /** API methods for the {@code auth} namespace. */ public final SessionAuthApi auth; + /** API methods for the {@code canvas} namespace. */ + public final SessionCanvasApi canvas; /** API methods for the {@code model} namespace. */ public final SessionModelApi model; /** API methods for the {@code mode} namespace. */ @@ -46,28 +48,46 @@ public final class SessionRpc { public final SessionFleetApi fleet; /** API methods for the {@code agent} namespace. */ public final SessionAgentApi agent; + /** API methods for the {@code tasks} namespace. */ + public final SessionTasksApi tasks; /** API methods for the {@code skills} namespace. */ public final SessionSkillsApi skills; /** API methods for the {@code mcp} namespace. */ public final SessionMcpApi mcp; /** API methods for the {@code plugins} namespace. */ public final SessionPluginsApi plugins; + /** API methods for the {@code options} namespace. */ + public final SessionOptionsApi options; + /** API methods for the {@code lsp} namespace. */ + public final SessionLspApi lsp; /** API methods for the {@code extensions} namespace. */ public final SessionExtensionsApi extensions; /** API methods for the {@code tools} namespace. */ public final SessionToolsApi tools; /** API methods for the {@code commands} namespace. */ public final SessionCommandsApi commands; + /** API methods for the {@code telemetry} namespace. */ + public final SessionTelemetryApi telemetry; /** API methods for the {@code ui} namespace. */ public final SessionUiApi ui; /** API methods for the {@code permissions} namespace. */ public final SessionPermissionsApi permissions; + /** API methods for the {@code metadata} namespace. */ + public final SessionMetadataApi metadata; /** API methods for the {@code shell} namespace. */ public final SessionShellApi shell; /** API methods for the {@code history} namespace. */ public final SessionHistoryApi history; + /** API methods for the {@code queue} namespace. */ + public final SessionQueueApi queue; + /** API methods for the {@code eventLog} namespace. */ + public final SessionEventLogApi eventLog; /** API methods for the {@code usage} namespace. */ public final SessionUsageApi usage; + /** API methods for the {@code remote} namespace. */ + public final SessionRemoteApi remote; + /** API methods for the {@code schedule} namespace. */ + public final SessionScheduleApi schedule; /** * Creates a new session RPC client. @@ -79,6 +99,7 @@ public SessionRpc(RpcCaller caller, String sessionId) { this.caller = caller; this.sessionId = sessionId; this.auth = new SessionAuthApi(caller, sessionId); + this.canvas = new SessionCanvasApi(caller, sessionId); this.model = new SessionModelApi(caller, sessionId); this.mode = new SessionModeApi(caller, sessionId); this.name = new SessionNameApi(caller, sessionId); @@ -87,24 +108,90 @@ public SessionRpc(RpcCaller caller, String sessionId) { this.instructions = new SessionInstructionsApi(caller, sessionId); this.fleet = new SessionFleetApi(caller, sessionId); this.agent = new SessionAgentApi(caller, sessionId); + this.tasks = new SessionTasksApi(caller, sessionId); this.skills = new SessionSkillsApi(caller, sessionId); this.mcp = new SessionMcpApi(caller, sessionId); this.plugins = new SessionPluginsApi(caller, sessionId); + this.options = new SessionOptionsApi(caller, sessionId); + this.lsp = new SessionLspApi(caller, sessionId); this.extensions = new SessionExtensionsApi(caller, sessionId); this.tools = new SessionToolsApi(caller, sessionId); this.commands = new SessionCommandsApi(caller, sessionId); + this.telemetry = new SessionTelemetryApi(caller, sessionId); this.ui = new SessionUiApi(caller, sessionId); this.permissions = new SessionPermissionsApi(caller, sessionId); + this.metadata = new SessionMetadataApi(caller, sessionId); this.shell = new SessionShellApi(caller, sessionId); this.history = new SessionHistoryApi(caller, sessionId); + this.queue = new SessionQueueApi(caller, sessionId); + this.eventLog = new SessionEventLogApi(caller, sessionId); this.usage = new SessionUsageApi(caller, sessionId); + this.remote = new SessionRemoteApi(caller, sessionId); + this.schedule = new SessionScheduleApi(caller, sessionId); } /** - * Invokes {@code session.log}. + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture suspend() { + return caller.invoke("session.suspend", java.util.Map.of("sessionId", this.sessionId), Void.class); + } + + /** + * Parameters for sending a user message to the session + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture send(SessionSendParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.send", _p, SessionSendResult.class); + } + + /** + * Parameters for aborting the current turn + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture abort(SessionAbortParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.abort", _p, SessionAbortResult.class); + } + + /** + * Parameters for shutting down the session + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture shutdown(SessionShutdownParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.shutdown", _p, Void.class); + } + + /** + * Message text, optional severity level, persistence flag, optional follow-up URL, and optional tip. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture log(SessionLogParams params) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleApi.java similarity index 65% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionScheduleApi.java index e1f179e53b..e35fb21979 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionHistoryApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleApi.java @@ -5,18 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; /** - * API methods for the {@code history} namespace. + * API methods for the {@code schedule} namespace. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionHistoryApi { +public final class SessionScheduleApi { private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; @@ -24,23 +24,23 @@ public final class SessionHistoryApi { private final String sessionId; /** @param caller the RPC transport function */ - SessionHistoryApi(RpcCaller caller, String sessionId) { + SessionScheduleApi(RpcCaller caller, String sessionId) { this.caller = caller; this.sessionId = sessionId; } /** - * Invokes {@code session.history.compact}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture compact() { - return caller.invoke("session.history.compact", java.util.Map.of("sessionId", this.sessionId), SessionHistoryCompactResult.class); + public CompletableFuture list() { + return caller.invoke("session.schedule.list", java.util.Map.of("sessionId", this.sessionId), SessionScheduleListResult.class); } /** - * Invokes {@code session.history.truncate}. + * Identifier of the scheduled prompt to remove. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. @@ -48,10 +48,10 @@ public CompletableFuture compact() { * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture truncate(SessionHistoryTruncateParams params) { + public CompletableFuture stop(SessionScheduleStopParams params) { com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); _p.put("sessionId", this.sessionId); - return caller.invoke("session.history.truncate", _p, SessionHistoryTruncateResult.class); + return caller.invoke("session.schedule.stop", _p, SessionScheduleStopResult.class); } } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleListParams.java new file mode 100644 index 0000000000..3dda01502b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleListParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionScheduleListParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleListResult.java new file mode 100644 index 0000000000..6a5ec101c3 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleListResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Snapshot of the currently active recurring prompts for this session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionScheduleListResult( + /** Active scheduled prompts, ordered by id. */ + @JsonProperty("entries") List entries +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleStopParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleStopParams.java new file mode 100644 index 0000000000..3215999914 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleStopParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifier of the scheduled prompt to remove. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionScheduleStopParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Id of the scheduled prompt to remove. */ + @JsonProperty("id") Long id +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleStopResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleStopResult.java new file mode 100644 index 0000000000..b61b0bb9ed --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionScheduleStopResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Remove a scheduled prompt by id. The result entry is omitted if the id was unknown. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionScheduleStopResult( + /** The removed entry, or omitted if no entry matched. */ + @JsonProperty("entry") ScheduleEntry entry +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionSendParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSendParams.java new file mode 100644 index 0000000000..42177c82d8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSendParams.java @@ -0,0 +1,55 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Parameters for sending a user message to the session + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionSendParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The user message text */ + @JsonProperty("prompt") String prompt, + /** If provided, this is shown in the timeline instead of `prompt` */ + @JsonProperty("displayPrompt") String displayPrompt, + /** Optional attachments (files, directories, selections, blobs, GitHub references) to include with the message */ + @JsonProperty("attachments") List attachments, + /** How to deliver the message. `enqueue` (default) appends to the message queue. `immediate` interjects during an in-progress turn. */ + @JsonProperty("mode") SendMode mode, + /** If true, adds the message to the front of the queue instead of the end */ + @JsonProperty("prepend") Boolean prepend, + /** If false, this message will not trigger a Premium Request Unit charge. User messages default to billable. */ + @JsonProperty("billable") Boolean billable, + /** If set, the request will fail if the named tool is not available when this message is among the user messages at the start of the current exchange */ + @JsonProperty("requiredTool") String requiredTool, + /** Optional provenance tag copied to the resulting user.message event. Supported values are `system`, `command-*`, and `schedule-*`. */ + @JsonProperty("source") Object source, + /** The UI mode the agent was in when this message was sent. Defaults to the session's current mode. */ + @JsonProperty("agentMode") SendAgentMode agentMode, + /** Custom HTTP headers to include in outbound model requests for this turn. Merged with session-level provider headers; per-turn headers augment and overwrite session-level headers with the same key. */ + @JsonProperty("requestHeaders") Map requestHeaders, + /** W3C Trace Context traceparent header for distributed tracing of this agent turn */ + @JsonProperty("traceparent") String traceparent, + /** W3C Trace Context tracestate header for distributed tracing */ + @JsonProperty("tracestate") String tracestate, + /** If true, await completion of the agentic loop for this message before returning. Defaults to false (fire-and-forget). When true, the result still contains the same `messageId`; the caller can rely on the agent having processed the message before the call resolves. */ + @JsonProperty("wait") Boolean wait_ +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionSendResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSendResult.java new file mode 100644 index 0000000000..747435e18e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSendResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Result of sending a user message + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionSendResult( + /** Unique identifier assigned to the message */ + @JsonProperty("messageId") String messageId +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionShellApi.java similarity index 83% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionShellApi.java index b86074342c..9abf8a626f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionShellApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,10 +30,12 @@ public final class SessionShellApi { } /** - * Invokes {@code session.shell.exec}. + * Shell command to run, with optional working directory and timeout in milliseconds. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture exec(SessionShellExecParams params) { @@ -43,10 +45,12 @@ public CompletableFuture exec(SessionShellExecParams par } /** - * Invokes {@code session.shell.kill}. + * Identifier of a process previously returned by "shell.exec" and the signal to send. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture kill(SessionShellKillParams params) { diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellExecParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionShellExecParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellExecParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionShellExecParams.java index 3aeeebff05..817adc93c8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellExecParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionShellExecParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.shell.exec} RPC method. + * Shell command to run, with optional working directory and timeout in milliseconds. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellExecResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionShellExecResult.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellExecResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionShellExecResult.java index 34288630b4..28a7565353 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellExecResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionShellExecResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.shell.exec} RPC method. + * Identifier of the spawned process, used to correlate streamed output and exit notifications. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellKillParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionShellKillParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellKillParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionShellKillParams.java index cb0e128b6d..1b26f1cb49 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellKillParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionShellKillParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.shell.kill} RPC method. + * Identifier of a process previously returned by "shell.exec" and the signal to send. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellKillResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionShellKillResult.java similarity index 85% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellKillResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionShellKillResult.java index e786d93c40..db3ff08cf4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionShellKillResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionShellKillResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.shell.kill} RPC method. + * Indicates whether the signal was delivered; false if the process was unknown or already exited. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionShutdownParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionShutdownParams.java new file mode 100644 index 0000000000..c17bef956d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionShutdownParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Parameters for shutting down the session + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionShutdownParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Why the session is being shut down. Defaults to "routine" when omitted. */ + @JsonProperty("type") ShutdownType type, + /** Optional human-readable reason. Typically the message of the error that triggered shutdown when type is 'error'. */ + @JsonProperty("reason") String reason +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsApi.java similarity index 70% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionSkillsApi.java index b32419a3e6..0d6a2fec37 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,7 +30,7 @@ public final class SessionSkillsApi { } /** - * Invokes {@code session.skills.list}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 @@ -40,7 +40,17 @@ public CompletableFuture list() { } /** - * Invokes {@code session.skills.enable}. + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getInvoked() { + return caller.invoke("session.skills.getInvoked", java.util.Map.of("sessionId", this.sessionId), SessionSkillsGetInvokedResult.class); + } + + /** + * Name of the skill to enable for the session. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. @@ -55,7 +65,7 @@ public CompletableFuture enable(SessionSkillsEnableParams params) { } /** - * Invokes {@code session.skills.disable}. + * Name of the skill to disable for the session. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. @@ -70,13 +80,23 @@ public CompletableFuture disable(SessionSkillsDisableParams params) { } /** - * Invokes {@code session.skills.reload}. + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture reload() { + return caller.invoke("session.skills.reload", java.util.Map.of("sessionId", this.sessionId), SessionSkillsReloadResult.class); + } + + /** + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ - public CompletableFuture reload() { - return caller.invoke("session.skills.reload", java.util.Map.of("sessionId", this.sessionId), Void.class); + public CompletableFuture ensureLoaded() { + return caller.invoke("session.skills.ensureLoaded", java.util.Map.of("sessionId", this.sessionId), Void.class); } } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsDisableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsDisableParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsDisableParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionSkillsDisableParams.java index 163df3a0a0..ba1df8ea2c 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsDisableParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsDisableParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.skills.disable} RPC method. + * Name of the skill to disable for the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsDisableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsDisableResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsDisableResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionSkillsDisableResult.java index 7f3fe40b88..3bd4b7dadb 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsDisableResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsDisableResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsEnableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnableParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsEnableParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnableParams.java index 72b1944cd5..6e6a7fd628 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsEnableParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnableParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.skills.enable} RPC method. + * Name of the skill to enable for the session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsEnableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnableResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsEnableResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnableResult.java index 1e7ea4c7fd..e8684ddc1f 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsEnableResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnableResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnsureLoadedParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnsureLoadedParams.java new file mode 100644 index 0000000000..1d5a7f102c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsEnsureLoadedParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionSkillsEnsureLoadedParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsGetInvokedParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsGetInvokedParams.java new file mode 100644 index 0000000000..c17c00d07b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsGetInvokedParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionSkillsGetInvokedParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsGetInvokedResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsGetInvokedResult.java new file mode 100644 index 0000000000..ed62e0fc7d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsGetInvokedResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Skills invoked during this session, ordered by invocation time (most recent last). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionSkillsGetInvokedResult( + /** Skills invoked during this session, ordered by invocation time (most recent last) */ + @JsonProperty("skills") List skills +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsListParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsListParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionSkillsListParams.java index 5575ef4789..1d45d8fa96 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsListParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsListParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.skills.list} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsListResult.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsListResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionSkillsListResult.java index cd8e8ea8c8..ded58a52f2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsListResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsListResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.skills.list} RPC method. + * Skills available to the session, with their enabled state. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsReloadParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionSkillsReloadParams.java index 664fd836a0..3d580001c0 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsReloadParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.skills.reload} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsReloadResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsReloadResult.java new file mode 100644 index 0000000000..38c426e5be --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSkillsReloadResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Diagnostics from reloading skill definitions, with warnings and errors as separate lists. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionSkillsReloadResult( + /** Warnings emitted while loading skills (e.g. skills that loaded but had issues) */ + @JsonProperty("warnings") List warnings, + /** Errors emitted while loading skills (e.g. skills that failed to load entirely) */ + @JsonProperty("errors") List errors +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionSuspendParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionSuspendParams.java new file mode 100644 index 0000000000..4ca1c33ab4 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionSuspendParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionSuspendParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksApi.java new file mode 100644 index 0000000000..f203c536c4 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksApi.java @@ -0,0 +1,172 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code tasks} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionTasksApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionTasksApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Agent type, prompt, name, and optional description and model override for the new task. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture startAgent(SessionTasksStartAgentParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.tasks.startAgent", _p, SessionTasksStartAgentResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture list() { + return caller.invoke("session.tasks.list", java.util.Map.of("sessionId", this.sessionId), SessionTasksListResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture refresh() { + return caller.invoke("session.tasks.refresh", java.util.Map.of("sessionId", this.sessionId), Void.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture waitForPending() { + return caller.invoke("session.tasks.waitForPending", java.util.Map.of("sessionId", this.sessionId), Void.class); + } + + /** + * Identifier of the background task to fetch progress for. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getProgress(SessionTasksGetProgressParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.tasks.getProgress", _p, SessionTasksGetProgressResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getCurrentPromotable() { + return caller.invoke("session.tasks.getCurrentPromotable", java.util.Map.of("sessionId", this.sessionId), SessionTasksGetCurrentPromotableResult.class); + } + + /** + * Identifier of the task to promote to background mode. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture promoteToBackground(SessionTasksPromoteToBackgroundParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.tasks.promoteToBackground", _p, SessionTasksPromoteToBackgroundResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture promoteCurrentToBackground() { + return caller.invoke("session.tasks.promoteCurrentToBackground", java.util.Map.of("sessionId", this.sessionId), SessionTasksPromoteCurrentToBackgroundResult.class); + } + + /** + * Identifier of the background task to cancel. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture cancel(SessionTasksCancelParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.tasks.cancel", _p, SessionTasksCancelResult.class); + } + + /** + * Identifier of the completed or cancelled task to remove from tracking. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture remove(SessionTasksRemoveParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.tasks.remove", _p, SessionTasksRemoveResult.class); + } + + /** + * Identifier of the target agent task, message content, and optional sender agent ID. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture sendMessage(SessionTasksSendMessageParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.tasks.sendMessage", _p, SessionTasksSendMessageResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksCancelParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksCancelParams.java new file mode 100644 index 0000000000..56fab2d640 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksCancelParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifier of the background task to cancel. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksCancelParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Task identifier */ + @JsonProperty("id") String id +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksCancelResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksCancelResult.java new file mode 100644 index 0000000000..ffb17a6f04 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksCancelResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the background task was successfully cancelled. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksCancelResult( + /** Whether the task was successfully cancelled */ + @JsonProperty("cancelled") Boolean cancelled +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetCurrentPromotableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetCurrentPromotableParams.java new file mode 100644 index 0000000000..25a78bbc76 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetCurrentPromotableParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksGetCurrentPromotableParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetCurrentPromotableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetCurrentPromotableResult.java new file mode 100644 index 0000000000..4ca2200ec2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetCurrentPromotableResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The first sync-waiting task that can currently be promoted to background mode. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksGetCurrentPromotableResult( + /** The first sync-waiting task (agent first, then shell) that can currently be promoted to background mode. Omitted if no such task exists. The returned task is guaranteed to have executionMode='sync' and canPromoteToBackground=true at the time of the call. */ + @JsonProperty("task") Object task +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetProgressParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetProgressParams.java new file mode 100644 index 0000000000..0081430c52 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetProgressParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifier of the background task to fetch progress for. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksGetProgressParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Task identifier (agent ID or shell ID) */ + @JsonProperty("id") String id +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetProgressResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetProgressResult.java new file mode 100644 index 0000000000..6f24e4bc91 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksGetProgressResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Progress information for the task, or null when no task with that ID is tracked. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksGetProgressResult( + /** Progress information for the task, discriminated by type. Returns null when no task with this ID is currently tracked. */ + @JsonProperty("progress") Object progress +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksListParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksListParams.java new file mode 100644 index 0000000000..d645ee3480 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksListParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksListParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksListResult.java new file mode 100644 index 0000000000..ec52af7515 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksListResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Background tasks currently tracked by the session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksListResult( + /** Currently tracked tasks */ + @JsonProperty("tasks") List tasks +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteCurrentToBackgroundParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteCurrentToBackgroundParams.java new file mode 100644 index 0000000000..b7ec7e39ee --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteCurrentToBackgroundParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksPromoteCurrentToBackgroundParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteCurrentToBackgroundResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteCurrentToBackgroundResult.java new file mode 100644 index 0000000000..702aa1c4e0 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteCurrentToBackgroundResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The promoted task as it now exists in background mode, omitted if no promotable task was waiting. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksPromoteCurrentToBackgroundResult( + /** The promoted task as it now exists in background mode, omitted if no promotable task was waiting. Atomic operation: avoids the race window of getCurrentPromotable + promoteToBackground. */ + @JsonProperty("task") Object task +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteToBackgroundParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteToBackgroundParams.java new file mode 100644 index 0000000000..f75e97f393 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteToBackgroundParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifier of the task to promote to background mode. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksPromoteToBackgroundParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Task identifier */ + @JsonProperty("id") String id +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteToBackgroundResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteToBackgroundResult.java new file mode 100644 index 0000000000..5ed332b17c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksPromoteToBackgroundResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the task was successfully promoted to background mode. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksPromoteToBackgroundResult( + /** Whether the task was successfully promoted to background mode */ + @JsonProperty("promoted") Boolean promoted +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRefreshParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRefreshParams.java new file mode 100644 index 0000000000..da6e164dff --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRefreshParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksRefreshParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRefreshResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRefreshResult.java new file mode 100644 index 0000000000..497d412336 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRefreshResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Refresh metadata for any detached background shells the runtime knows about. Use after a long pause to pick up exit/output state for shells running outside the agent loop. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksRefreshResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRemoveParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRemoveParams.java new file mode 100644 index 0000000000..66a730590b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRemoveParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifier of the completed or cancelled task to remove from tracking. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksRemoveParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Task identifier */ + @JsonProperty("id") String id +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRemoveResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRemoveResult.java new file mode 100644 index 0000000000..0d4173cacd --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksRemoveResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the task was removed. False when the task does not exist or is still running/idle. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksRemoveResult( + /** Whether the task was removed. Returns false if the task does not exist or is still running/idle (cancel it first). */ + @JsonProperty("removed") Boolean removed +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksSendMessageParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksSendMessageParams.java new file mode 100644 index 0000000000..841ad104ae --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksSendMessageParams.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifier of the target agent task, message content, and optional sender agent ID. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksSendMessageParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Agent task identifier */ + @JsonProperty("id") String id, + /** Message content to send to the agent */ + @JsonProperty("message") String message, + /** Agent ID of the sender, if sent on behalf of another agent */ + @JsonProperty("fromAgentId") String fromAgentId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksSendMessageResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksSendMessageResult.java new file mode 100644 index 0000000000..dee710d956 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksSendMessageResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the message was delivered, with an error message when delivery failed. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksSendMessageResult( + /** Whether the message was successfully delivered or steered */ + @JsonProperty("sent") Boolean sent, + /** Error message if delivery failed */ + @JsonProperty("error") String error +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksStartAgentParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksStartAgentParams.java new file mode 100644 index 0000000000..f146e6e91c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksStartAgentParams.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Agent type, prompt, name, and optional description and model override for the new task. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksStartAgentParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Type of agent to start (e.g., 'explore', 'task', 'general-purpose') */ + @JsonProperty("agentType") String agentType, + /** Task prompt for the agent */ + @JsonProperty("prompt") String prompt, + /** Short name for the agent, used to generate a human-readable ID */ + @JsonProperty("name") String name, + /** Short description of the task */ + @JsonProperty("description") String description, + /** Optional model override */ + @JsonProperty("model") String model +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksStartAgentResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksStartAgentResult.java new file mode 100644 index 0000000000..24cd051ce7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksStartAgentResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifier assigned to the newly started background agent task. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksStartAgentResult( + /** Generated agent ID for the background task */ + @JsonProperty("agentId") String agentId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksWaitForPendingParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksWaitForPendingParams.java new file mode 100644 index 0000000000..916c9f424a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksWaitForPendingParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksWaitForPendingParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTasksWaitForPendingResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksWaitForPendingResult.java new file mode 100644 index 0000000000..b8ec86d123 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTasksWaitForPendingResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Wait until all in-flight background tasks (agents + shells) and any follow-up turns scheduled by their completions have settled. Returns when the runtime is fully drained or after an internal timeout (default 10 minutes; configurable via COPILOT_TASK_WAIT_TIMEOUT_SECONDS). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTasksWaitForPendingResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTelemetryApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTelemetryApi.java new file mode 100644 index 0000000000..92c24b4e8d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTelemetryApi.java @@ -0,0 +1,47 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code telemetry} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionTelemetryApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionTelemetryApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Feature override key/value pairs to attach to subsequent telemetry events from this session. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture setFeatureOverrides(SessionTelemetrySetFeatureOverridesParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.telemetry.setFeatureOverrides", _p, Void.class); + } + +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionTelemetrySetFeatureOverridesParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionTelemetrySetFeatureOverridesParams.java new file mode 100644 index 0000000000..d0f364e232 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionTelemetrySetFeatureOverridesParams.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Feature override key/value pairs to attach to subsequent telemetry events from this session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionTelemetrySetFeatureOverridesParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Override key/value pairs to attach to subsequent telemetry events from this session. Replaces any previously-set overrides. */ + @JsonProperty("features") Map features +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsApi.java similarity index 72% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionToolsApi.java index 91d0587c72..81c04f2ca3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -30,10 +30,12 @@ public final class SessionToolsApi { } /** - * Invokes {@code session.tools.handlePendingToolCall}. + * Pending external tool call request ID, with the tool result or an error describing why it failed. *

* Note: the {@code sessionId} field in the params record is overridden * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 */ public CompletableFuture handlePendingToolCall(SessionToolsHandlePendingToolCallParams params) { @@ -42,4 +44,14 @@ public CompletableFuture handlePendingT return caller.invoke("session.tools.handlePendingToolCall", _p, SessionToolsHandlePendingToolCallResult.class); } + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture initializeAndValidate() { + return caller.invoke("session.tools.initializeAndValidate", java.util.Map.of("sessionId", this.sessionId), Void.class); + } + } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsHandlePendingToolCallParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsHandlePendingToolCallParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsHandlePendingToolCallParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionToolsHandlePendingToolCallParams.java index 796001d8f1..a5bfa4cca4 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsHandlePendingToolCallParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsHandlePendingToolCallParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.tools.handlePendingToolCall} RPC method. + * Pending external tool call request ID, with the tool result or an error describing why it failed. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsHandlePendingToolCallResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsHandlePendingToolCallResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsHandlePendingToolCallResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionToolsHandlePendingToolCallResult.java index 3f7a2acc1e..fefaa652e8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionToolsHandlePendingToolCallResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsHandlePendingToolCallResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.tools.handlePendingToolCall} RPC method. + * Indicates whether the external tool call result was handled successfully. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionToolsInitializeAndValidateParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsInitializeAndValidateParams.java new file mode 100644 index 0000000000..f605cb8170 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsInitializeAndValidateParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionToolsInitializeAndValidateParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionToolsInitializeAndValidateResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsInitializeAndValidateResult.java new file mode 100644 index 0000000000..b4126b3906 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionToolsInitializeAndValidateResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Resolve, build, and validate the runtime tool list for this session. Subagent sessions and consumer flows that need an initialized tool set before `send` invoke this. Default base-class implementation is a no-op for sessions that don't support tool validation. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionToolsInitializeAndValidateResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiApi.java new file mode 100644 index 0000000000..c3116fe58c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiApi.java @@ -0,0 +1,147 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code ui} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionUiApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionUiApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Prompt message and JSON schema describing the form fields to elicit from the user. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture elicitation(SessionUiElicitationParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.ui.elicitation", _p, SessionUiElicitationResult.class); + } + + /** + * Pending elicitation request ID and the user's response (accept/decline/cancel + form values). + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture handlePendingElicitation(SessionUiHandlePendingElicitationParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.ui.handlePendingElicitation", _p, SessionUiHandlePendingElicitationResult.class); + } + + /** + * Request ID of a pending `user_input.requested` event and the user's response. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture handlePendingUserInput(SessionUiHandlePendingUserInputParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.ui.handlePendingUserInput", _p, SessionUiHandlePendingUserInputResult.class); + } + + /** + * Request ID of a pending `sampling.requested` event and an optional sampling result payload (omit to reject). + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture handlePendingSampling(SessionUiHandlePendingSamplingParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.ui.handlePendingSampling", _p, SessionUiHandlePendingSamplingResult.class); + } + + /** + * Request ID of a pending `auto_mode_switch.requested` event and the user's response. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture handlePendingAutoModeSwitch(SessionUiHandlePendingAutoModeSwitchParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.ui.handlePendingAutoModeSwitch", _p, SessionUiHandlePendingAutoModeSwitchResult.class); + } + + /** + * Request ID of a pending `exit_plan_mode.requested` event and the user's response. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture handlePendingExitPlanMode(SessionUiHandlePendingExitPlanModeParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.ui.handlePendingExitPlanMode", _p, SessionUiHandlePendingExitPlanModeResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture registerDirectAutoModeSwitchHandler() { + return caller.invoke("session.ui.registerDirectAutoModeSwitchHandler", java.util.Map.of("sessionId", this.sessionId), SessionUiRegisterDirectAutoModeSwitchHandlerResult.class); + } + + /** + * Opaque handle previously returned by `registerDirectAutoModeSwitchHandler` to release. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture unregisterDirectAutoModeSwitchHandler(SessionUiUnregisterDirectAutoModeSwitchHandlerParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.ui.unregisterDirectAutoModeSwitchHandler", _p, SessionUiUnregisterDirectAutoModeSwitchHandlerResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiElicitationParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiElicitationParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiElicitationParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionUiElicitationParams.java index 315a857f5d..d684167040 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiElicitationParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiElicitationParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.ui.elicitation} RPC method. + * Prompt message and JSON schema describing the form fields to elicit from the user. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiElicitationResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiElicitationResult.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiElicitationResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionUiElicitationResult.java index 4be941e08b..d08d7453ef 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiElicitationResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiElicitationResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingAutoModeSwitchParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingAutoModeSwitchParams.java new file mode 100644 index 0000000000..1afe7d5e7a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingAutoModeSwitchParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Request ID of a pending `auto_mode_switch.requested` event and the user's response. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiHandlePendingAutoModeSwitchParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The unique request ID from the auto_mode_switch.requested event */ + @JsonProperty("requestId") String requestId, + /** User's choice for auto-mode switching: yes (allow this turn), yes_always (allow + persist as setting), or no (decline). */ + @JsonProperty("response") UIAutoModeSwitchResponse response +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingAutoModeSwitchResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingAutoModeSwitchResult.java new file mode 100644 index 0000000000..335f5d8940 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingAutoModeSwitchResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the pending UI request was resolved by this call. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiHandlePendingAutoModeSwitchResult( + /** True if the request was still pending and was resolved by this call. False if the request ID was unknown, already resolved by another client (e.g. GitHub), expired, or otherwise no longer pending. */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiHandlePendingElicitationParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingElicitationParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiHandlePendingElicitationParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingElicitationParams.java index 23fd0759de..73d97220f8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiHandlePendingElicitationParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingElicitationParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.ui.handlePendingElicitation} RPC method. + * Pending elicitation request ID and the user's response (accept/decline/cancel + form values). * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiHandlePendingElicitationResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingElicitationResult.java similarity index 85% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiHandlePendingElicitationResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingElicitationResult.java index 549609a87b..bb2c91b6ec 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUiHandlePendingElicitationResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingElicitationResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.ui.handlePendingElicitation} RPC method. + * Indicates whether the elicitation response was accepted; false if it was already resolved by another client. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingExitPlanModeParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingExitPlanModeParams.java new file mode 100644 index 0000000000..87c492bdbf --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingExitPlanModeParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Request ID of a pending `exit_plan_mode.requested` event and the user's response. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiHandlePendingExitPlanModeParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The unique request ID from the exit_plan_mode.requested event */ + @JsonProperty("requestId") String requestId, + /** Schema for the `UIExitPlanModeResponse` type. */ + @JsonProperty("response") UIExitPlanModeResponse response +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingExitPlanModeResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingExitPlanModeResult.java new file mode 100644 index 0000000000..69fc6586d2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingExitPlanModeResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the pending UI request was resolved by this call. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiHandlePendingExitPlanModeResult( + /** True if the request was still pending and was resolved by this call. False if the request ID was unknown, already resolved by another client (e.g. GitHub), expired, or otherwise no longer pending. */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingSamplingParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingSamplingParams.java new file mode 100644 index 0000000000..8ce2ad2e12 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingSamplingParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Request ID of a pending `sampling.requested` event and an optional sampling result payload (omit to reject). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiHandlePendingSamplingParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The unique request ID from the sampling.requested event */ + @JsonProperty("requestId") String requestId, + /** Optional sampling result payload. Omit to reject/cancel the sampling request without providing a result. */ + @JsonProperty("response") UIHandlePendingSamplingResponse response +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingSamplingResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingSamplingResult.java new file mode 100644 index 0000000000..ced26ad66b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingSamplingResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the pending UI request was resolved by this call. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiHandlePendingSamplingResult( + /** True if the request was still pending and was resolved by this call. False if the request ID was unknown, already resolved by another client (e.g. GitHub), expired, or otherwise no longer pending. */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingUserInputParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingUserInputParams.java new file mode 100644 index 0000000000..89034cbd2c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingUserInputParams.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Request ID of a pending `user_input.requested` event and the user's response. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiHandlePendingUserInputParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** The unique request ID from the user_input.requested event */ + @JsonProperty("requestId") String requestId, + /** Schema for the `UIUserInputResponse` type. */ + @JsonProperty("response") UIUserInputResponse response +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingUserInputResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingUserInputResult.java new file mode 100644 index 0000000000..ae6369ee0e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiHandlePendingUserInputResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the pending UI request was resolved by this call. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiHandlePendingUserInputResult( + /** True if the request was still pending and was resolved by this call. False if the request ID was unknown, already resolved by another client (e.g. GitHub), expired, or otherwise no longer pending. */ + @JsonProperty("success") Boolean success +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiRegisterDirectAutoModeSwitchHandlerParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiRegisterDirectAutoModeSwitchHandlerParams.java new file mode 100644 index 0000000000..f778d3164a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiRegisterDirectAutoModeSwitchHandlerParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiRegisterDirectAutoModeSwitchHandlerParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiRegisterDirectAutoModeSwitchHandlerResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiRegisterDirectAutoModeSwitchHandlerResult.java new file mode 100644 index 0000000000..991954a268 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiRegisterDirectAutoModeSwitchHandlerResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Register an in-process handler for `auto_mode_switch.requested` events. The caller still attaches the actual listener via the standard event-subscription mechanism; this registration solely tells the server bridge to skip its own dispatch (so a remote client doesn't race the in-process handler for the same requestId). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiRegisterDirectAutoModeSwitchHandlerResult( + /** Opaque handle representing the registration. Pass this same handle to `unregisterDirectAutoModeSwitchHandler` when the in-process handler is no longer active. Multiple registrations are reference-counted; the server bridge will only dispatch auto-mode-switch requests when no handles are active. */ + @JsonProperty("handle") String handle +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiUnregisterDirectAutoModeSwitchHandlerParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiUnregisterDirectAutoModeSwitchHandlerParams.java new file mode 100644 index 0000000000..beab56aa28 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiUnregisterDirectAutoModeSwitchHandlerParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Opaque handle previously returned by `registerDirectAutoModeSwitchHandler` to release. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiUnregisterDirectAutoModeSwitchHandlerParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Handle previously returned by `registerDirectAutoModeSwitchHandler` */ + @JsonProperty("handle") String handle +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionUiUnregisterDirectAutoModeSwitchHandlerResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUiUnregisterDirectAutoModeSwitchHandlerResult.java new file mode 100644 index 0000000000..0836c5c16b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUiUnregisterDirectAutoModeSwitchHandlerResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Indicates whether the handle was active and the registration count was decremented. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionUiUnregisterDirectAutoModeSwitchHandlerResult( + /** True if the handle was active and decremented the counter; false if the handle was unknown. */ + @JsonProperty("unregistered") Boolean unregistered +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUsageApi.java similarity index 92% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionUsageApi.java index 7b34027327..b9a5a14a84 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUsageApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; @@ -28,7 +28,7 @@ public final class SessionUsageApi { } /** - * Invokes {@code session.usage.getMetrics}. + * Identifies the target session. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageGetMetricsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUsageGetMetricsParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageGetMetricsParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionUsageGetMetricsParams.java index 4696c7fc98..035bf64982 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageGetMetricsParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUsageGetMetricsParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.usage.getMetrics} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageGetMetricsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionUsageGetMetricsResult.java similarity index 73% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageGetMetricsResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionUsageGetMetricsResult.java index 9cfdbcfc8d..e51b9453f9 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionUsageGetMetricsResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionUsageGetMetricsResult.java @@ -5,16 +5,17 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import java.time.OffsetDateTime; import java.util.Map; import javax.annotation.processing.Generated; /** - * Result for the {@code session.usage.getMetrics} RPC method. + * Accumulated session usage metrics, including premium request cost, token counts, model breakdown, and code-change totals. * * @since 1.0.0 */ @@ -26,10 +27,14 @@ public record SessionUsageGetMetricsResult( @JsonProperty("totalPremiumRequestCost") Double totalPremiumRequestCost, /** Raw count of user-initiated API requests */ @JsonProperty("totalUserRequests") Long totalUserRequests, + /** Session-wide accumulated nano-AI units cost */ + @JsonProperty("totalNanoAiu") Double totalNanoAiu, + /** Session-wide per-token-type accumulated token counts */ + @JsonProperty("tokenDetails") Map tokenDetails, /** Total time spent in model API calls (milliseconds) */ - @JsonProperty("totalApiDurationMs") Double totalApiDurationMs, - /** Session start timestamp (epoch milliseconds) */ - @JsonProperty("sessionStartTime") Long sessionStartTime, + @JsonProperty("totalApiDurationMs") Long totalApiDurationMs, + /** ISO 8601 timestamp when the session started */ + @JsonProperty("sessionStartTime") OffsetDateTime sessionStartTime, /** Aggregated code change metrics */ @JsonProperty("codeChanges") UsageMetricsCodeChanges codeChanges, /** Per-model token and request metrics, keyed by model identifier */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkingDirectoryContext.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkingDirectoryContext.java new file mode 100644 index 0000000000..b16ef01e83 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkingDirectoryContext.java @@ -0,0 +1,41 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Updated working directory and git context. Emitted as the new payload of `session.context_changed`. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkingDirectoryContext( + /** Current working directory path */ + @JsonProperty("cwd") String cwd, + /** Root directory of the git repository, resolved via git rev-parse */ + @JsonProperty("gitRoot") String gitRoot, + /** Repository identifier derived from the git remote URL ("owner/name" for GitHub, "org/project/repo" for Azure DevOps) */ + @JsonProperty("repository") String repository, + /** Hosting platform type of the repository */ + @JsonProperty("hostType") SessionWorkingDirectoryContextHostType hostType, + /** Raw host string from the git remote URL (e.g. "github.com", "dev.azure.com") */ + @JsonProperty("repositoryHost") String repositoryHost, + /** Current git branch name */ + @JsonProperty("branch") String branch, + /** Head commit of the current git branch */ + @JsonProperty("headCommit") String headCommit, + /** Merge-base commit SHA (fork point from the remote default branch) */ + @JsonProperty("baseCommit") String baseCommit +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkingDirectoryContextHostType.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkingDirectoryContextHostType.java new file mode 100644 index 0000000000..1ed7e60d0e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkingDirectoryContextHostType.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Hosting platform type of the repository + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SessionWorkingDirectoryContextHostType { + /** The {@code github} variant. */ + GITHUB("github"), + /** The {@code ado} variant. */ + ADO("ado"); + + private final String value; + SessionWorkingDirectoryContextHostType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SessionWorkingDirectoryContextHostType fromValue(String value) { + for (SessionWorkingDirectoryContextHostType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SessionWorkingDirectoryContextHostType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceApi.java similarity index 98% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceApi.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceApi.java index 8fd7d7467d..d74f670477 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceApi.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceApi.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import java.util.concurrent.CompletableFuture; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceCreateFileParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceCreateFileParams.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceCreateFileParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceCreateFileParams.java index c25fdd7903..94efe93132 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceCreateFileParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceCreateFileParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceCreateFileResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceCreateFileResult.java similarity index 94% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceCreateFileResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceCreateFileResult.java index e77cf58c56..f0bf113bac 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceCreateFileResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceCreateFileResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceListFilesParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceListFilesParams.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceListFilesParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceListFilesParams.java index 0fb6431c96..a2fd1407c3 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceListFilesParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceListFilesParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceListFilesResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceListFilesResult.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceListFilesResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceListFilesResult.java index 1b46df541b..96e7ce9c45 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceListFilesResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceListFilesResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceReadFileParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceReadFileParams.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceReadFileParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceReadFileParams.java index ded74763a3..c39a8a5254 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceReadFileParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceReadFileParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceReadFileResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceReadFileResult.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceReadFileResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceReadFileResult.java index c8705581e8..b4ece91ef7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspaceReadFileResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspaceReadFileResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesApi.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesApi.java new file mode 100644 index 0000000000..54a79c0c59 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesApi.java @@ -0,0 +1,137 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code workspaces} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionWorkspacesApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionWorkspacesApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture getWorkspace() { + return caller.invoke("session.workspaces.getWorkspace", java.util.Map.of("sessionId", this.sessionId), SessionWorkspacesGetWorkspaceResult.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture listFiles() { + return caller.invoke("session.workspaces.listFiles", java.util.Map.of("sessionId", this.sessionId), SessionWorkspacesListFilesResult.class); + } + + /** + * Relative path of the workspace file to read. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture readFile(SessionWorkspacesReadFileParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workspaces.readFile", _p, SessionWorkspacesReadFileResult.class); + } + + /** + * Relative path and UTF-8 content for the workspace file to create or overwrite. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture createFile(SessionWorkspacesCreateFileParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workspaces.createFile", _p, Void.class); + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture listCheckpoints() { + return caller.invoke("session.workspaces.listCheckpoints", java.util.Map.of("sessionId", this.sessionId), SessionWorkspacesListCheckpointsResult.class); + } + + /** + * Checkpoint number to read. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture readCheckpoint(SessionWorkspacesReadCheckpointParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workspaces.readCheckpoint", _p, SessionWorkspacesReadCheckpointResult.class); + } + + /** + * Pasted content to save as a UTF-8 file in the session workspace. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture saveLargePaste(SessionWorkspacesSaveLargePasteParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workspaces.saveLargePaste", _p, SessionWorkspacesSaveLargePasteResult.class); + } + + /** + * Parameters for computing a workspace diff. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + public CompletableFuture diff(SessionWorkspacesDiffParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workspaces.diff", _p, SessionWorkspacesDiffResult.class); + } + +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesCreateFileParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesCreateFileParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesCreateFileParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesCreateFileParams.java index def2ffe373..3d757f852a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesCreateFileParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesCreateFileParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.workspaces.createFile} RPC method. + * Relative path and UTF-8 content for the workspace file to create or overwrite. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesDiffParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesDiffParams.java new file mode 100644 index 0000000000..02a2668c30 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesDiffParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Parameters for computing a workspace diff. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesDiffParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Diff mode requested by the client. */ + @JsonProperty("mode") WorkspaceDiffMode mode +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesDiffResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesDiffResult.java new file mode 100644 index 0000000000..2800f24e36 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesDiffResult.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Workspace diff result for the requested mode. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesDiffResult( + /** Diff mode requested by the client. */ + @JsonProperty("requestedMode") WorkspaceDiffMode requestedMode, + /** Effective mode used for the returned changes. */ + @JsonProperty("mode") WorkspaceDiffMode mode, + /** Changed files and their unified diffs. */ + @JsonProperty("changes") List changes, + /** Default branch used for a branch diff, when branch mode was requested. */ + @JsonProperty("baseBranch") String baseBranch, + /** Whether a requested branch diff fell back to unstaged changes because branch diff failed. */ + @JsonProperty("isFallback") Boolean isFallback +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesGetWorkspaceParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesGetWorkspaceParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesGetWorkspaceParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesGetWorkspaceParams.java index c2f0e5a16d..6a7482af75 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesGetWorkspaceParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesGetWorkspaceParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.workspaces.getWorkspace} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesGetWorkspaceResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesGetWorkspaceResult.java new file mode 100644 index 0000000000..8e79a82a19 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesGetWorkspaceResult.java @@ -0,0 +1,54 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.time.OffsetDateTime; +import javax.annotation.processing.Generated; + +/** + * Current workspace metadata for the session, including its absolute filesystem path when available. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesGetWorkspaceResult( + /** Current workspace metadata, or null if not available */ + @JsonProperty("workspace") SessionWorkspacesGetWorkspaceResultWorkspace workspace, + /** Absolute filesystem path to the workspace directory. Omitted when the session has no workspace (e.g. remote sessions). */ + @JsonProperty("path") String path +) { + + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionWorkspacesGetWorkspaceResultWorkspace( + @JsonProperty("id") String id, + @JsonProperty("cwd") String cwd, + @JsonProperty("git_root") String gitRoot, + @JsonProperty("repository") String repository, + /** Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration. */ + @JsonProperty("host_type") WorkspacesWorkspaceDetailsHostType hostType, + @JsonProperty("branch") String branch, + @JsonProperty("name") String name, + @JsonProperty("client_name") String clientName, + @JsonProperty("user_named") Boolean userNamed, + @JsonProperty("summary_count") Long summaryCount, + @JsonProperty("created_at") OffsetDateTime createdAt, + @JsonProperty("updated_at") OffsetDateTime updatedAt, + @JsonProperty("remote_steerable") Boolean remoteSteerable, + @JsonProperty("mc_task_id") String mcTaskId, + @JsonProperty("mc_session_id") String mcSessionId, + @JsonProperty("mc_last_event_id") String mcLastEventId, + @JsonProperty("chronicle_sync_dismissed") Boolean chronicleSyncDismissed + ) { + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListCheckpointsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListCheckpointsParams.java new file mode 100644 index 0000000000..3d55cf43a0 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListCheckpointsParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesListCheckpointsParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListCheckpointsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListCheckpointsResult.java new file mode 100644 index 0000000000..b6f562c66f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListCheckpointsResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Workspace checkpoints in chronological order; empty when the workspace is not enabled. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesListCheckpointsResult( + /** Workspace checkpoints in chronological order. Empty when workspace is not enabled. */ + @JsonProperty("checkpoints") List checkpoints +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesListFilesParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListFilesParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesListFilesParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListFilesParams.java index 7bcee441ed..7fd4771a1e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesListFilesParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListFilesParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.workspaces.listFiles} RPC method. + * Identifies the target session. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesListFilesResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListFilesResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesListFilesResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListFilesResult.java index 26064cde40..90a7cf2ce0 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesListFilesResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesListFilesResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.workspaces.listFiles} RPC method. + * Relative paths of files stored in the session workspace files directory. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadCheckpointParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadCheckpointParams.java new file mode 100644 index 0000000000..8266acab46 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadCheckpointParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Checkpoint number to read. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesReadCheckpointParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Checkpoint number to read */ + @JsonProperty("number") Long number +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadCheckpointResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadCheckpointResult.java new file mode 100644 index 0000000000..1b4322994f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadCheckpointResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesReadCheckpointResult( + /** Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing */ + @JsonProperty("content") String content +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesReadFileParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadFileParams.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesReadFileParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadFileParams.java index 40b2778542..85f44b6080 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesReadFileParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadFileParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code session.workspaces.readFile} RPC method. + * Relative path of the workspace file to read. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesReadFileResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadFileResult.java similarity index 88% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesReadFileResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadFileResult.java index c0ce5e7c7a..b85ce3f6ef 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesReadFileResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesReadFileResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.workspaces.readFile} RPC method. + * Contents of the requested workspace file as a UTF-8 string. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesSaveLargePasteParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesSaveLargePasteParams.java new file mode 100644 index 0000000000..23def325c2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesSaveLargePasteParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Pasted content to save as a UTF-8 file in the session workspace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesSaveLargePasteParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Pasted content to save as a UTF-8 file */ + @JsonProperty("content") String content +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesSaveLargePasteResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesSaveLargePasteResult.java new file mode 100644 index 0000000000..523b124889 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionWorkspacesSaveLargePasteResult.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Descriptor for the saved paste file, or null when the workspace is unavailable. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkspacesSaveLargePasteResult( + /** Saved-paste descriptor, or null when the workspace is unavailable (e.g. CCA runtime, non-infinite sessions, remote sessions) */ + @JsonProperty("saved") SessionWorkspacesSaveLargePasteResultSaved saved +) { + + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionWorkspacesSaveLargePasteResultSaved( + /** Absolute filesystem path to the saved paste file */ + @JsonProperty("filePath") String filePath, + /** Filename within the workspace files directory */ + @JsonProperty("filename") String filename, + /** Size of the saved file in bytes */ + @JsonProperty("sizeBytes") Long sizeBytes + ) { + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsBulkDeleteParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsBulkDeleteParams.java new file mode 100644 index 0000000000..e1aa506977 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsBulkDeleteParams.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Session IDs to close, deactivate, and delete from disk. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsBulkDeleteParams( + /** Session IDs to close, deactivate, and delete from disk */ + @JsonProperty("sessionIds") List sessionIds +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsBulkDeleteResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsBulkDeleteResult.java new file mode 100644 index 0000000000..2447d409da --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsBulkDeleteResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Map of sessionId -> bytes freed by removing the session's workspace directory. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsBulkDeleteResult( + /** Map of sessionId -> bytes freed by removing the session's workspace directory. Sessions whose deletion failed are omitted from this map (failures are logged on the server but not surfaced per-id; check the map for absent IDs to detect them). */ + @JsonProperty("freedBytes") Map freedBytes +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsCheckInUseParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsCheckInUseParams.java new file mode 100644 index 0000000000..4be30632d8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsCheckInUseParams.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Session IDs to test for live in-use locks. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsCheckInUseParams( + /** Session IDs to test for live in-use locks */ + @JsonProperty("sessionIds") List sessionIds +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsCheckInUseResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsCheckInUseResult.java new file mode 100644 index 0000000000..1ab7edab79 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsCheckInUseResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Session IDs from the input set that are currently in use by another process. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsCheckInUseResult( + /** Session IDs from the input set that are currently held by another running process via an alive lock file */ + @JsonProperty("inUse") List inUse +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsCloseParams.java similarity index 79% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionsCloseParams.java index 1bfca46e1a..667e18a4cf 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsCloseParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,12 +13,15 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code session.skills.reload} RPC method. + * Session ID to close. * * @since 1.0.0 */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) -public record SessionSkillsReloadResult() { +public record SessionsCloseParams( + /** Session ID to close */ + @JsonProperty("sessionId") String sessionId +) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsCloseResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsCloseResult.java new file mode 100644 index 0000000000..a63c446338 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsCloseResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Closes a session: emits shutdown, flushes pending events to disk, releases the in-use lock, disposes the active session. Idempotent: succeeds even if the session is not currently active. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsCloseResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsConnectParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsConnectParams.java new file mode 100644 index 0000000000..5d0dfffeb9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsConnectParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Remote session connection parameters. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsConnectParams( + /** Session ID to connect to. */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsConnectResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsConnectResult.java new file mode 100644 index 0000000000..42c5d7e2e2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsConnectResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Remote session connection result. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsConnectResult( + /** SDK session ID for the connected remote session. */ + @JsonProperty("sessionId") String sessionId, + /** Metadata for a connected remote session. */ + @JsonProperty("metadata") ConnectedRemoteSessionMetadata metadata +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsEnrichMetadataParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsEnrichMetadataParams.java new file mode 100644 index 0000000000..973c952e9e --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsEnrichMetadataParams.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Session metadata records to enrich with summary and context information. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsEnrichMetadataParams( + /** Session metadata records to enrich. Records that already have summary and context are returned unchanged. */ + @JsonProperty("sessions") List sessions +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsEnrichMetadataResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsEnrichMetadataResult.java new file mode 100644 index 0000000000..7457b84897 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsEnrichMetadataResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * The enriched metadata records, with summary and context fields backfilled where available. Sessions confirmed empty and unnamed are omitted. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsEnrichMetadataResult( + /** Enriched records, with summary and context backfilled. Sessions confirmed empty and unnamed may be omitted. */ + @JsonProperty("sessions") List sessions +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByPrefixParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByPrefixParams.java new file mode 100644 index 0000000000..285876be02 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByPrefixParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * UUID prefix to resolve to a unique session ID. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsFindByPrefixParams( + /** UUID prefix (>=7 hex chars, <36 chars). Returns the unique session ID, or undefined when there is no match or the prefix matches multiple sessions. */ + @JsonProperty("prefix") String prefix +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByPrefixResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByPrefixResult.java new file mode 100644 index 0000000000..27ceb29501 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByPrefixResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session ID matching the prefix, omitted when no unique match exists. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsFindByPrefixResult( + /** Omitted when no unique session matches the prefix (no match or ambiguous) */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByTaskIdParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByTaskIdParams.java new file mode 100644 index 0000000000..cd643796cc --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByTaskIdParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * GitHub task ID to look up. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsFindByTaskIdParams( + /** GitHub task ID to look up */ + @JsonProperty("taskId") String taskId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByTaskIdResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByTaskIdResult.java new file mode 100644 index 0000000000..d276340587 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsFindByTaskIdResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * ID of the local session bound to the given GitHub task, or omitted when none. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsFindByTaskIdResult( + /** Omitted when no local session is bound to that GitHub task */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsForkParams.java similarity index 76% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SessionsForkParams.java index 06ea46c932..33bfb3a81e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsForkParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code sessions.fork} RPC method. + * Source session identifier to fork from, optional event-ID boundary, and optional friendly name for the new session. * * @since 1.0.0 */ @@ -24,6 +24,8 @@ public record SessionsForkParams( /** Source session ID to fork from */ @JsonProperty("sessionId") String sessionId, /** Optional event ID boundary. When provided, the fork includes only events before this ID (exclusive). When omitted, all events are included. */ - @JsonProperty("toEventId") String toEventId + @JsonProperty("toEventId") String toEventId, + /** Optional friendly name to assign to the forked session. */ + @JsonProperty("name") String name ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsForkResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsForkResult.java new file mode 100644 index 0000000000..5e67f101ee --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsForkResult.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Identifier and optional friendly name assigned to the newly forked session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsForkResult( + /** The new forked session's ID */ + @JsonProperty("sessionId") String sessionId, + /** Friendly name assigned to the forked session, if any. */ + @JsonProperty("name") String name +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsGetEventFilePathParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetEventFilePathParams.java new file mode 100644 index 0000000000..a0d19b5a4f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetEventFilePathParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session ID whose event-log file path to compute. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsGetEventFilePathParams( + /** Session ID whose event-log file path to compute */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsGetEventFilePathResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetEventFilePathResult.java new file mode 100644 index 0000000000..9d77f105f6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetEventFilePathResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Absolute path to the session's events.jsonl file on disk. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsGetEventFilePathResult( + /** Absolute path to the session's events.jsonl file */ + @JsonProperty("filePath") String filePath +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsGetLastForContextParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetLastForContextParams.java new file mode 100644 index 0000000000..43a23a89b6 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetLastForContextParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Optional working-directory context used to score session relevance. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsGetLastForContextParams( + /** Optional working-directory context used to score session relevance. When omitted the most-recently-modified session wins. */ + @JsonProperty("context") SessionContext context +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsGetLastForContextResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetLastForContextResult.java new file mode 100644 index 0000000000..018b96f71f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetLastForContextResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Most-relevant session ID for the supplied context, or omitted when no sessions exist. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsGetLastForContextResult( + /** Most-relevant session ID for the supplied context, or omitted when no sessions exist */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsGetPersistedRemoteSteerableParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetPersistedRemoteSteerableParams.java new file mode 100644 index 0000000000..21f26bfcda --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetPersistedRemoteSteerableParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session ID to look up the persisted remote-steerable flag for. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsGetPersistedRemoteSteerableParams( + /** Session ID to look up the persisted remote-steerable flag for */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsGetPersistedRemoteSteerableResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetPersistedRemoteSteerableResult.java new file mode 100644 index 0000000000..9dedef9818 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetPersistedRemoteSteerableResult.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The session's persisted remote-steerable flag, or omitted when no value has been persisted. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsGetPersistedRemoteSteerableResult( + /** The session's persisted remote-steerable flag if recorded; omitted when no value has been persisted */ + @JsonProperty("remoteSteerable") Boolean remoteSteerable +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsGetSizesResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetSizesResult.java new file mode 100644 index 0000000000..958f6e2424 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsGetSizesResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; +import javax.annotation.processing.Generated; + +/** + * Map of sessionId -> on-disk size in bytes for each session's workspace directory. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsGetSizesResult( + /** Map of sessionId -> on-disk size in bytes for the session's workspace directory */ + @JsonProperty("sizes") Map sizes +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsListResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsListResult.java new file mode 100644 index 0000000000..7608fe3f35 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsListResult.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Persisted sessions matching the filter, ordered most-recently-modified first. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsListResult( + /** Sessions ordered most-recently-modified first */ + @JsonProperty("sessions") List sessions +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsLoadDeferredRepoHooksParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsLoadDeferredRepoHooksParams.java new file mode 100644 index 0000000000..347b7c7e7f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsLoadDeferredRepoHooksParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Active session ID whose deferred repo-level hooks should be loaded. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsLoadDeferredRepoHooksParams( + /** Active session ID whose deferred repo-level hooks should be loaded */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsLoadDeferredRepoHooksResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsLoadDeferredRepoHooksResult.java new file mode 100644 index 0000000000..194ce088de --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsLoadDeferredRepoHooksResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Queued repo-level startup prompts and the total hook command count after loading. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsLoadDeferredRepoHooksResult( + /** Repo-level startup prompts queued from repo hook configs. Empty on resume, when no repo configs were pending, or when disableAllHooks is set. */ + @JsonProperty("startupPrompts") List startupPrompts, + /** Total hook command count (user + plugin + repo) loaded for the session by this call. Captured atomically with startupPrompts so callers don't need to read a separate counter. */ + @JsonProperty("hookCount") Long hookCount +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsPruneOldParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsPruneOldParams.java new file mode 100644 index 0000000000..d854387303 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsPruneOldParams.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Age threshold and optional flags controlling which old sessions are pruned (or simulated when dryRun is true). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsPruneOldParams( + /** Delete sessions whose modifiedTime is at least this many days old */ + @JsonProperty("olderThanDays") Long olderThanDays, + /** When true, only report what would be deleted without performing any deletion */ + @JsonProperty("dryRun") Boolean dryRun, + /** When true, named sessions (set via /rename) are also eligible for pruning */ + @JsonProperty("includeNamed") Boolean includeNamed, + /** Session IDs that should never be considered for pruning */ + @JsonProperty("excludeSessionIds") List excludeSessionIds +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsPruneOldResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsPruneOldResult.java new file mode 100644 index 0000000000..c04389b0cc --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsPruneOldResult.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Outcome of the prune operation: deleted IDs, dry-run candidates, skipped IDs, total bytes freed, and the dry-run flag. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsPruneOldResult( + /** Session IDs that were deleted (always empty in dry-run mode) */ + @JsonProperty("deleted") List deleted, + /** Session IDs that would be deleted in dry-run mode (always empty otherwise) */ + @JsonProperty("candidates") List candidates, + /** Session IDs that were skipped (e.g., named sessions) */ + @JsonProperty("skipped") List skipped, + /** Total bytes freed (actual when not dry-run, projected when dry-run) */ + @JsonProperty("freedBytes") Long freedBytes, + /** True when no deletions were actually performed */ + @JsonProperty("dryRun") Boolean dryRun +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsReleaseLockParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsReleaseLockParams.java new file mode 100644 index 0000000000..76add5bcb7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsReleaseLockParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session ID whose in-use lock should be released. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsReleaseLockParams( + /** Session ID whose in-use lock should be released */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsReleaseLockResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsReleaseLockResult.java new file mode 100644 index 0000000000..dde0c445e8 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsReleaseLockResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Release the in-use lock held by this process for the given session. No-op when this process does not currently hold a lock for the session. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsReleaseLockResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsReloadPluginHooksParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsReloadPluginHooksParams.java new file mode 100644 index 0000000000..82978334f1 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsReloadPluginHooksParams.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Active session ID and an optional flag for deferring repo-level hooks until folder trust. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsReloadPluginHooksParams( + /** Active session ID to reload hooks for */ + @JsonProperty("sessionId") String sessionId, + /** When true, skip repo-level hooks. Use before folder trust is confirmed; loadDeferredRepoHooks loads them post-trust. */ + @JsonProperty("deferRepoHooks") Boolean deferRepoHooks +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsReloadPluginHooksResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsReloadPluginHooksResult.java new file mode 100644 index 0000000000..835641e4db --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsReloadPluginHooksResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Reload all hooks (user, plugin, optionally repo) and apply them to the active session. Call after installing or removing plugins so their hooks take effect immediately. No-op when no active session matches the given sessionId. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsReloadPluginHooksResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsSaveParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsSaveParams.java new file mode 100644 index 0000000000..27f49adddb --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsSaveParams.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Session ID whose pending events should be flushed to disk. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsSaveParams( + /** Session ID whose pending events should be flushed to disk */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsSaveResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsSaveResult.java new file mode 100644 index 0000000000..758d11885b --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsSaveResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Flush a session's pending events to disk. No-op when no writer exists for the session (e.g., already closed). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsSaveResult() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsSetAdditionalPluginsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsSetAdditionalPluginsParams.java new file mode 100644 index 0000000000..d03706e3a9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsSetAdditionalPluginsParams.java @@ -0,0 +1,28 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Manager-wide additional plugins to register; replaces any previously-configured set. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsSetAdditionalPluginsParams( + /** Manager-wide additional plugins to register. Replaces any previously-configured set. Pass an empty array to clear. */ + @JsonProperty("plugins") List plugins +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SessionsSetAdditionalPluginsResult.java b/src/generated/java/com/github/copilot/generated/rpc/SessionsSetAdditionalPluginsResult.java new file mode 100644 index 0000000000..848ff9e086 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SessionsSetAdditionalPluginsResult.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Replace the manager-wide additional plugins. New session creations and subsequent hook reloads see the new set; already-running sessions keep their existing hook installation until the next reload. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionsSetAdditionalPluginsResult() { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ShellKillSignal.java b/src/generated/java/com/github/copilot/generated/rpc/ShellKillSignal.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ShellKillSignal.java rename to src/generated/java/com/github/copilot/generated/rpc/ShellKillSignal.java index 92700c5c0f..646fa2be83 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ShellKillSignal.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ShellKillSignal.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/generated/rpc/ShutdownType.java b/src/generated/java/com/github/copilot/generated/rpc/ShutdownType.java new file mode 100644 index 0000000000..1b4e79dd48 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/ShutdownType.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Why the session is being shut down. Defaults to "routine" when omitted. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ShutdownType { + /** The {@code routine} variant. */ + ROUTINE("routine"), + /** The {@code error} variant. */ + ERROR("error"); + + private final String value; + ShutdownType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ShutdownType fromValue(String value) { + for (ShutdownType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ShutdownType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/Skill.java b/src/generated/java/com/github/copilot/generated/rpc/Skill.java similarity index 74% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/Skill.java rename to src/generated/java/com/github/copilot/generated/rpc/Skill.java index 7f3c2a4010..d64f015157 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/Skill.java +++ b/src/generated/java/com/github/copilot/generated/rpc/Skill.java @@ -5,13 +5,18 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import javax.annotation.processing.Generated; +/** + * Schema for the `Skill` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) @@ -20,13 +25,15 @@ public record Skill( @JsonProperty("name") String name, /** Description of what the skill does */ @JsonProperty("description") String description, - /** Source location type (e.g., project, personal, plugin) */ - @JsonProperty("source") String source, + /** Source location type (e.g., project, personal-copilot, plugin, builtin) */ + @JsonProperty("source") SkillSource source, /** Whether the skill can be invoked by the user as a slash command */ @JsonProperty("userInvocable") Boolean userInvocable, /** Whether the skill is currently enabled */ @JsonProperty("enabled") Boolean enabled, /** Absolute path to the skill file */ - @JsonProperty("path") String path + @JsonProperty("path") String path, + /** Name of the plugin that provides the skill, when source is 'plugin' */ + @JsonProperty("pluginName") String pluginName ) { } diff --git a/src/generated/java/com/github/copilot/generated/rpc/SkillSource.java b/src/generated/java/com/github/copilot/generated/rpc/SkillSource.java new file mode 100644 index 0000000000..8d723548be --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SkillSource.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Source location type (e.g., project, personal-copilot, plugin, builtin) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SkillSource { + /** The {@code project} variant. */ + PROJECT("project"), + /** The {@code inherited} variant. */ + INHERITED("inherited"), + /** The {@code personal-copilot} variant. */ + PERSONAL_COPILOT("personal-copilot"), + /** The {@code personal-agents} variant. */ + PERSONAL_AGENTS("personal-agents"), + /** The {@code plugin} variant. */ + PLUGIN("plugin"), + /** The {@code custom} variant. */ + CUSTOM("custom"), + /** The {@code builtin} variant. */ + BUILTIN("builtin"); + + private final String value; + SkillSource(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SkillSource fromValue(String value) { + for (SkillSource v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SkillSource value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsConfigSetDisabledSkillsParams.java b/src/generated/java/com/github/copilot/generated/rpc/SkillsConfigSetDisabledSkillsParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsConfigSetDisabledSkillsParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SkillsConfigSetDisabledSkillsParams.java index 94a32b573b..200e88cd7a 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsConfigSetDisabledSkillsParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SkillsConfigSetDisabledSkillsParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code skills.config.setDisabledSkills} RPC method. + * Skill names to mark as disabled in global configuration, replacing any previous list. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsDiscoverParams.java b/src/generated/java/com/github/copilot/generated/rpc/SkillsDiscoverParams.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsDiscoverParams.java rename to src/generated/java/com/github/copilot/generated/rpc/SkillsDiscoverParams.java index 053d42585a..1176806996 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsDiscoverParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SkillsDiscoverParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code skills.discover} RPC method. + * Optional project paths and additional skill directories to include in discovery. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsDiscoverResult.java b/src/generated/java/com/github/copilot/generated/rpc/SkillsDiscoverResult.java similarity index 89% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsDiscoverResult.java rename to src/generated/java/com/github/copilot/generated/rpc/SkillsDiscoverResult.java index a2f0efe971..f56c814bce 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SkillsDiscoverResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/SkillsDiscoverResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code skills.discover} RPC method. + * Skills discovered across global and project sources. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/SkillsInvokedSkill.java b/src/generated/java/com/github/copilot/generated/rpc/SkillsInvokedSkill.java new file mode 100644 index 0000000000..697e18fa4c --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SkillsInvokedSkill.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Schema for the `SkillsInvokedSkill` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SkillsInvokedSkill( + /** Unique identifier for the skill */ + @JsonProperty("name") String name, + /** Path to the SKILL.md file */ + @JsonProperty("path") String path, + /** Full content of the skill file */ + @JsonProperty("content") String content, + /** Tools that should be auto-approved when this skill is active, captured at invocation time */ + @JsonProperty("allowedTools") List allowedTools, + /** Turn number when the skill was invoked */ + @JsonProperty("invokedAtTurn") Long invokedAtTurn +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInfo.java b/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInfo.java new file mode 100644 index 0000000000..722274524f --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInfo.java @@ -0,0 +1,40 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Schema for the `SlashCommandInfo` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SlashCommandInfo( + /** Canonical command name without a leading slash */ + @JsonProperty("name") String name, + /** Canonical aliases without leading slashes */ + @JsonProperty("aliases") List aliases, + /** Human-readable command description */ + @JsonProperty("description") String description, + /** Coarse command category for grouping and behavior: runtime built-in, skill-backed command, or SDK/client-owned command */ + @JsonProperty("kind") SlashCommandKind kind, + /** Optional unstructured input hint */ + @JsonProperty("input") SlashCommandInput input, + /** Whether the command may run while an agent turn is active */ + @JsonProperty("allowDuringAgentExecution") Boolean allowDuringAgentExecution, + /** Whether the command is experimental */ + @JsonProperty("experimental") Boolean experimental +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInput.java b/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInput.java new file mode 100644 index 0000000000..dcfc2a36e7 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInput.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Optional unstructured input hint + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SlashCommandInput( + /** Hint to display when command input has not been provided */ + @JsonProperty("hint") String hint, + /** When true, the command requires non-empty input; clients should render the input hint as required */ + @JsonProperty("required") Boolean required, + /** Optional completion hint for the input (e.g. 'directory' for filesystem path completion) */ + @JsonProperty("completion") SlashCommandInputCompletion completion, + /** When true, clients should pass the full text after the command name as a single argument rather than splitting on whitespace */ + @JsonProperty("preserveMultilineInput") Boolean preserveMultilineInput +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInputCompletion.java b/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInputCompletion.java new file mode 100644 index 0000000000..bfd2e77874 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SlashCommandInputCompletion.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Optional completion hint for the input (e.g. 'directory' for filesystem path completion) + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SlashCommandInputCompletion { + /** The {@code directory} variant. */ + DIRECTORY("directory"); + + private final String value; + SlashCommandInputCompletion(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SlashCommandInputCompletion fromValue(String value) { + for (SlashCommandInputCompletion v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SlashCommandInputCompletion value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/SlashCommandKind.java b/src/generated/java/com/github/copilot/generated/rpc/SlashCommandKind.java new file mode 100644 index 0000000000..1f05c47735 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/SlashCommandKind.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Coarse command category for grouping and behavior: runtime built-in, skill-backed command, or SDK/client-owned command + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum SlashCommandKind { + /** The {@code builtin} variant. */ + BUILTIN("builtin"), + /** The {@code skill} variant. */ + SKILL("skill"), + /** The {@code client} variant. */ + CLIENT("client"); + + private final String value; + SlashCommandKind(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static SlashCommandKind fromValue(String value) { + for (SlashCommandKind v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown SlashCommandKind value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/Tool.java b/src/generated/java/com/github/copilot/generated/rpc/Tool.java similarity index 93% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/Tool.java rename to src/generated/java/com/github/copilot/generated/rpc/Tool.java index 53fbdcb8ed..e4b1361c87 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/Tool.java +++ b/src/generated/java/com/github/copilot/generated/rpc/Tool.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,6 +13,11 @@ import java.util.Map; import javax.annotation.processing.Generated; +/** + * Schema for the `Tool` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ToolsListParams.java b/src/generated/java/com/github/copilot/generated/rpc/ToolsListParams.java similarity index 87% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ToolsListParams.java rename to src/generated/java/com/github/copilot/generated/rpc/ToolsListParams.java index 2c5aa5b09e..6523f4bdc2 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ToolsListParams.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ToolsListParams.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * Request parameters for the {@code tools.list} RPC method. + * Optional model identifier whose tool overrides should be applied to the listing. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/ToolsListResult.java b/src/generated/java/com/github/copilot/generated/rpc/ToolsListResult.java similarity index 86% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/ToolsListResult.java rename to src/generated/java/com/github/copilot/generated/rpc/ToolsListResult.java index 3a1b7c29d5..5127277fb7 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/ToolsListResult.java +++ b/src/generated/java/com/github/copilot/generated/rpc/ToolsListResult.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Result for the {@code tools.list} RPC method. + * Built-in tools available for the requested model, with their parameters and instructions. * * @since 1.0.0 */ diff --git a/src/generated/java/com/github/copilot/generated/rpc/UIAutoModeSwitchResponse.java b/src/generated/java/com/github/copilot/generated/rpc/UIAutoModeSwitchResponse.java new file mode 100644 index 0000000000..f6a3534d88 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/UIAutoModeSwitchResponse.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * User's choice for auto-mode switching: yes (allow this turn), yes_always (allow + persist as setting), or no (decline). + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum UIAutoModeSwitchResponse { + /** The {@code yes} variant. */ + YES("yes"), + /** The {@code yes_always} variant. */ + YES_ALWAYS("yes_always"), + /** The {@code no} variant. */ + NO("no"); + + private final String value; + UIAutoModeSwitchResponse(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static UIAutoModeSwitchResponse fromValue(String value) { + for (UIAutoModeSwitchResponse v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown UIAutoModeSwitchResponse value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationResponse.java b/src/generated/java/com/github/copilot/generated/rpc/UIElicitationResponse.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationResponse.java rename to src/generated/java/com/github/copilot/generated/rpc/UIElicitationResponse.java index 058a68c0df..e157ee727b 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationResponse.java +++ b/src/generated/java/com/github/copilot/generated/rpc/UIElicitationResponse.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationResponseAction.java b/src/generated/java/com/github/copilot/generated/rpc/UIElicitationResponseAction.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationResponseAction.java rename to src/generated/java/com/github/copilot/generated/rpc/UIElicitationResponseAction.java index e4811ef956..4ce8d95cd8 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationResponseAction.java +++ b/src/generated/java/com/github/copilot/generated/rpc/UIElicitationResponseAction.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import javax.annotation.processing.Generated; diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationSchema.java b/src/generated/java/com/github/copilot/generated/rpc/UIElicitationSchema.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationSchema.java rename to src/generated/java/com/github/copilot/generated/rpc/UIElicitationSchema.java index 171f5c6883..d4f0a26845 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/UIElicitationSchema.java +++ b/src/generated/java/com/github/copilot/generated/rpc/UIElicitationSchema.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/UIExitPlanModeAction.java b/src/generated/java/com/github/copilot/generated/rpc/UIExitPlanModeAction.java new file mode 100644 index 0000000000..1670701e10 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/UIExitPlanModeAction.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * The action the user selected. Defaults to 'autopilot' when autoApproveEdits is true, otherwise 'interactive'. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum UIExitPlanModeAction { + /** The {@code exit_only} variant. */ + EXIT_ONLY("exit_only"), + /** The {@code interactive} variant. */ + INTERACTIVE("interactive"), + /** The {@code autopilot} variant. */ + AUTOPILOT("autopilot"), + /** The {@code autopilot_fleet} variant. */ + AUTOPILOT_FLEET("autopilot_fleet"); + + private final String value; + UIExitPlanModeAction(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static UIExitPlanModeAction fromValue(String value) { + for (UIExitPlanModeAction v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown UIExitPlanModeAction value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/UIExitPlanModeResponse.java b/src/generated/java/com/github/copilot/generated/rpc/UIExitPlanModeResponse.java new file mode 100644 index 0000000000..50e2011427 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/UIExitPlanModeResponse.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `UIExitPlanModeResponse` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record UIExitPlanModeResponse( + /** Whether the plan was approved. */ + @JsonProperty("approved") Boolean approved, + /** The action the user selected. Defaults to 'autopilot' when autoApproveEdits is true, otherwise 'interactive'. */ + @JsonProperty("selectedAction") UIExitPlanModeAction selectedAction, + /** Whether subsequent edits should be auto-approved without confirmation. */ + @JsonProperty("autoApproveEdits") Boolean autoApproveEdits, + /** Feedback from the user when they declined the plan or requested changes. */ + @JsonProperty("feedback") String feedback +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/UIHandlePendingSamplingResponse.java b/src/generated/java/com/github/copilot/generated/rpc/UIHandlePendingSamplingResponse.java new file mode 100644 index 0000000000..590061f4cc --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/UIHandlePendingSamplingResponse.java @@ -0,0 +1,24 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Optional sampling result payload. Omit to reject/cancel the sampling request without providing a result. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record UIHandlePendingSamplingResponse() { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/UIUserInputResponse.java b/src/generated/java/com/github/copilot/generated/rpc/UIUserInputResponse.java new file mode 100644 index 0000000000..d4ce9899dd --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/UIUserInputResponse.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `UIUserInputResponse` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record UIUserInputResponse( + /** The user's answer text */ + @JsonProperty("answer") String answer, + /** True if the user typed a freeform response, false if they selected a presented choice. Used by telemetry to differentiate between free text input and choice selection. */ + @JsonProperty("wasFreeform") Boolean wasFreeform +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsCodeChanges.java b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsCodeChanges.java similarity index 80% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsCodeChanges.java rename to src/generated/java/com/github/copilot/generated/rpc/UsageMetricsCodeChanges.java index 442c88da21..4c445efe1e 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsCodeChanges.java +++ b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsCodeChanges.java @@ -5,11 +5,12 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; import javax.annotation.processing.Generated; /** @@ -26,6 +27,8 @@ public record UsageMetricsCodeChanges( /** Total lines of code removed */ @JsonProperty("linesRemoved") Long linesRemoved, /** Number of distinct files modified */ - @JsonProperty("filesModifiedCount") Long filesModifiedCount + @JsonProperty("filesModifiedCount") Long filesModifiedCount, + /** Distinct file paths modified during the session */ + @JsonProperty("filesModified") List filesModified ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetric.java b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetric.java similarity index 66% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetric.java rename to src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetric.java index 8334872cbb..7e34f43b38 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetric.java +++ b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetric.java @@ -5,13 +5,19 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Map; import javax.annotation.processing.Generated; +/** + * Schema for the `UsageMetricsModelMetric` type. + * + * @since 1.0.0 + */ @javax.annotation.processing.Generated("copilot-sdk-codegen") @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) @@ -19,6 +25,10 @@ public record UsageMetricsModelMetric( /** Request count and cost metrics for this model */ @JsonProperty("requests") UsageMetricsModelMetricRequests requests, /** Token usage metrics for this model */ - @JsonProperty("usage") UsageMetricsModelMetricUsage usage + @JsonProperty("usage") UsageMetricsModelMetricUsage usage, + /** Accumulated nano-AI units cost for this model */ + @JsonProperty("totalNanoAiu") Double totalNanoAiu, + /** Token count details per type */ + @JsonProperty("tokenDetails") Map tokenDetails ) { } diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetricRequests.java b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricRequests.java similarity index 95% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetricRequests.java rename to src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricRequests.java index ac18ded858..ef9fbe47d1 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetricRequests.java +++ b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricRequests.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricTokenDetail.java b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricTokenDetail.java new file mode 100644 index 0000000000..e47a45fde9 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricTokenDetail.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `UsageMetricsModelMetricTokenDetail` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record UsageMetricsModelMetricTokenDetail( + /** Accumulated token count for this token type */ + @JsonProperty("tokenCount") Long tokenCount +) { +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetricUsage.java b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricUsage.java similarity index 96% rename from src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetricUsage.java rename to src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricUsage.java index f7c556a0f8..112c2c06d5 100644 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/UsageMetricsModelMetricUsage.java +++ b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsModelMetricUsage.java @@ -5,7 +5,7 @@ // AUTO-GENERATED FILE - DO NOT EDIT // Generated from: api.schema.json -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; diff --git a/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsTokenDetail.java b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsTokenDetail.java new file mode 100644 index 0000000000..55d0b81c8d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/UsageMetricsTokenDetail.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `UsageMetricsTokenDetail` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record UsageMetricsTokenDetail( + /** Accumulated token count for this token type */ + @JsonProperty("tokenCount") Long tokenCount +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffFileChange.java b/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffFileChange.java new file mode 100644 index 0000000000..f091bc2799 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffFileChange.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * A single changed file and its unified diff. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkspaceDiffFileChange( + /** Path to the changed file, relative to the workspace root. */ + @JsonProperty("path") String path, + /** Unified diff content for the file. Empty when the diff was truncated. */ + @JsonProperty("diff") String diff, + /** Type of change represented by this file diff. */ + @JsonProperty("changeType") WorkspaceDiffFileChangeType changeType, + /** Original file path for renamed files. */ + @JsonProperty("oldPath") String oldPath, + /** Whether the diff content was omitted because it exceeded the per-file size limit. */ + @JsonProperty("isTruncated") Boolean isTruncated +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffFileChangeType.java b/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffFileChangeType.java new file mode 100644 index 0000000000..678ecd187a --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffFileChangeType.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Type of change represented by this file diff. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum WorkspaceDiffFileChangeType { + /** The {@code added} variant. */ + ADDED("added"), + /** The {@code modified} variant. */ + MODIFIED("modified"), + /** The {@code deleted} variant. */ + DELETED("deleted"), + /** The {@code renamed} variant. */ + RENAMED("renamed"); + + private final String value; + WorkspaceDiffFileChangeType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static WorkspaceDiffFileChangeType fromValue(String value) { + for (WorkspaceDiffFileChangeType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown WorkspaceDiffFileChangeType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffMode.java b/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffMode.java new file mode 100644 index 0000000000..a2762954b2 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/WorkspaceDiffMode.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Diff mode requested by the client. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum WorkspaceDiffMode { + /** The {@code unstaged} variant. */ + UNSTAGED("unstaged"), + /** The {@code branch} variant. */ + BRANCH("branch"); + + private final String value; + WorkspaceDiffMode(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static WorkspaceDiffMode fromValue(String value) { + for (WorkspaceDiffMode v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown WorkspaceDiffMode value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/WorkspaceSummaryHostType.java b/src/generated/java/com/github/copilot/generated/rpc/WorkspaceSummaryHostType.java new file mode 100644 index 0000000000..71ce8e4b6d --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/WorkspaceSummaryHostType.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Repository host type, if known + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum WorkspaceSummaryHostType { + /** The {@code github} variant. */ + GITHUB("github"), + /** The {@code ado} variant. */ + ADO("ado"); + + private final String value; + WorkspaceSummaryHostType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static WorkspaceSummaryHostType fromValue(String value) { + for (WorkspaceSummaryHostType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown WorkspaceSummaryHostType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/WorkspacesCheckpoints.java b/src/generated/java/com/github/copilot/generated/rpc/WorkspacesCheckpoints.java new file mode 100644 index 0000000000..07de034a96 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/WorkspacesCheckpoints.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Schema for the `WorkspacesCheckpoints` type. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkspacesCheckpoints( + /** Checkpoint number assigned by the workspace manager */ + @JsonProperty("number") Long number, + /** Human-readable checkpoint title */ + @JsonProperty("title") String title, + /** Filename of the checkpoint within the workspace checkpoints directory */ + @JsonProperty("filename") String filename +) { +} diff --git a/src/generated/java/com/github/copilot/generated/rpc/WorkspacesWorkspaceDetailsHostType.java b/src/generated/java/com/github/copilot/generated/rpc/WorkspacesWorkspaceDetailsHostType.java new file mode 100644 index 0000000000..aca85030e0 --- /dev/null +++ b/src/generated/java/com/github/copilot/generated/rpc/WorkspacesWorkspaceDetailsHostType.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum WorkspacesWorkspaceDetailsHostType { + /** The {@code github} variant. */ + GITHUB("github"), + /** The {@code ado} variant. */ + ADO("ado"); + + private final String value; + WorkspacesWorkspaceDetailsHostType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static WorkspacesWorkspaceDetailsHostType fromValue(String value) { + for (WorkspacesWorkspaceDetailsHostType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown WorkspacesWorkspaceDetailsHostType value: " + value); + } +} diff --git a/src/generated/java/com/github/copilot/sdk/generated/SessionModelChangeEvent.java b/src/generated/java/com/github/copilot/sdk/generated/SessionModelChangeEvent.java deleted file mode 100644 index c23c8a5f50..0000000000 --- a/src/generated/java/com/github/copilot/sdk/generated/SessionModelChangeEvent.java +++ /dev/null @@ -1,48 +0,0 @@ -/*--------------------------------------------------------------------------------------------- - * Copyright (c) Microsoft Corporation. All rights reserved. - *--------------------------------------------------------------------------------------------*/ - -// AUTO-GENERATED FILE - DO NOT EDIT -// Generated from: session-events.schema.json - -package com.github.copilot.sdk.generated; - -import com.fasterxml.jackson.annotation.JsonIgnoreProperties; -import com.fasterxml.jackson.annotation.JsonInclude; -import com.fasterxml.jackson.annotation.JsonProperty; -import javax.annotation.processing.Generated; - -/** - * The {@code session.model_change} session event. - * - * @since 1.0.0 - */ -@JsonIgnoreProperties(ignoreUnknown = true) -@JsonInclude(JsonInclude.Include.NON_NULL) -@javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionModelChangeEvent extends SessionEvent { - - @Override - public String getType() { return "session.model_change"; } - - @JsonProperty("data") - private SessionModelChangeEventData data; - - public SessionModelChangeEventData getData() { return data; } - public void setData(SessionModelChangeEventData data) { this.data = data; } - - /** Data payload for {@link SessionModelChangeEvent}. */ - @JsonIgnoreProperties(ignoreUnknown = true) - @JsonInclude(JsonInclude.Include.NON_NULL) - public record SessionModelChangeEventData( - /** Model that was previously selected, if any */ - @JsonProperty("previousModel") String previousModel, - /** Newly selected model identifier */ - @JsonProperty("newModel") String newModel, - /** Reasoning effort level before the model change, if applicable */ - @JsonProperty("previousReasoningEffort") String previousReasoningEffort, - /** Reasoning effort level after the model change, if applicable */ - @JsonProperty("reasoningEffort") String reasoningEffort - ) { - } -} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesApi.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesApi.java deleted file mode 100644 index b9a5238fac..0000000000 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesApi.java +++ /dev/null @@ -1,74 +0,0 @@ -/*--------------------------------------------------------------------------------------------- - * Copyright (c) Microsoft Corporation. All rights reserved. - *--------------------------------------------------------------------------------------------*/ - -// AUTO-GENERATED FILE - DO NOT EDIT -// Generated from: api.schema.json - -package com.github.copilot.sdk.generated.rpc; - -import java.util.concurrent.CompletableFuture; -import javax.annotation.processing.Generated; - -/** - * API methods for the {@code workspaces} namespace. - * - * @since 1.0.0 - */ -@javax.annotation.processing.Generated("copilot-sdk-codegen") -public final class SessionWorkspacesApi { - - private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; - - private final RpcCaller caller; - private final String sessionId; - - /** @param caller the RPC transport function */ - SessionWorkspacesApi(RpcCaller caller, String sessionId) { - this.caller = caller; - this.sessionId = sessionId; - } - - /** - * Invokes {@code session.workspaces.getWorkspace}. - * @since 1.0.0 - */ - public CompletableFuture getWorkspace() { - return caller.invoke("session.workspaces.getWorkspace", java.util.Map.of("sessionId", this.sessionId), SessionWorkspacesGetWorkspaceResult.class); - } - - /** - * Invokes {@code session.workspaces.listFiles}. - * @since 1.0.0 - */ - public CompletableFuture listFiles() { - return caller.invoke("session.workspaces.listFiles", java.util.Map.of("sessionId", this.sessionId), SessionWorkspacesListFilesResult.class); - } - - /** - * Invokes {@code session.workspaces.readFile}. - *

- * Note: the {@code sessionId} field in the params record is overridden - * by the session-scoped wrapper; any value provided is ignored. - * @since 1.0.0 - */ - public CompletableFuture readFile(SessionWorkspacesReadFileParams params) { - com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); - _p.put("sessionId", this.sessionId); - return caller.invoke("session.workspaces.readFile", _p, SessionWorkspacesReadFileResult.class); - } - - /** - * Invokes {@code session.workspaces.createFile}. - *

- * Note: the {@code sessionId} field in the params record is overridden - * by the session-scoped wrapper; any value provided is ignored. - * @since 1.0.0 - */ - public CompletableFuture createFile(SessionWorkspacesCreateFileParams params) { - com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); - _p.put("sessionId", this.sessionId); - return caller.invoke("session.workspaces.createFile", _p, Void.class); - } - -} diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesGetWorkspaceResult.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesGetWorkspaceResult.java deleted file mode 100644 index 2a2260db8a..0000000000 --- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionWorkspacesGetWorkspaceResult.java +++ /dev/null @@ -1,92 +0,0 @@ -/*--------------------------------------------------------------------------------------------- - * Copyright (c) Microsoft Corporation. All rights reserved. - *--------------------------------------------------------------------------------------------*/ - -// AUTO-GENERATED FILE - DO NOT EDIT -// Generated from: api.schema.json - -package com.github.copilot.sdk.generated.rpc; - -import com.fasterxml.jackson.annotation.JsonIgnoreProperties; -import com.fasterxml.jackson.annotation.JsonInclude; -import com.fasterxml.jackson.annotation.JsonProperty; -import java.time.OffsetDateTime; -import java.util.UUID; -import javax.annotation.processing.Generated; - -/** - * Result for the {@code session.workspaces.getWorkspace} RPC method. - * - * @since 1.0.0 - */ -@javax.annotation.processing.Generated("copilot-sdk-codegen") -@JsonInclude(JsonInclude.Include.NON_NULL) -@JsonIgnoreProperties(ignoreUnknown = true) -public record SessionWorkspacesGetWorkspaceResult( - /** Current workspace metadata, or null if not available */ - @JsonProperty("workspace") SessionWorkspacesGetWorkspaceResultWorkspace workspace -) { - - @JsonIgnoreProperties(ignoreUnknown = true) - @JsonInclude(JsonInclude.Include.NON_NULL) - public record SessionWorkspacesGetWorkspaceResultWorkspace( - @JsonProperty("id") UUID id, - @JsonProperty("cwd") String cwd, - @JsonProperty("git_root") String gitRoot, - @JsonProperty("repository") String repository, - @JsonProperty("host_type") SessionWorkspacesGetWorkspaceResultWorkspaceHostType hostType, - @JsonProperty("branch") String branch, - @JsonProperty("summary") String summary, - @JsonProperty("name") String name, - @JsonProperty("summary_count") Long summaryCount, - @JsonProperty("created_at") OffsetDateTime createdAt, - @JsonProperty("updated_at") OffsetDateTime updatedAt, - @JsonProperty("remote_steerable") Boolean remoteSteerable, - @JsonProperty("mc_task_id") String mcTaskId, - @JsonProperty("mc_session_id") String mcSessionId, - @JsonProperty("mc_last_event_id") String mcLastEventId, - @JsonProperty("session_sync_level") SessionWorkspacesGetWorkspaceResultWorkspaceSessionSyncLevel sessionSyncLevel, - @JsonProperty("chronicle_sync_dismissed") Boolean chronicleSyncDismissed - ) { - - public enum SessionWorkspacesGetWorkspaceResultWorkspaceHostType { - /** The {@code github} variant. */ - GITHUB("github"), - /** The {@code ado} variant. */ - ADO("ado"); - - private final String value; - SessionWorkspacesGetWorkspaceResultWorkspaceHostType(String value) { this.value = value; } - @com.fasterxml.jackson.annotation.JsonValue - public String getValue() { return value; } - @com.fasterxml.jackson.annotation.JsonCreator - public static SessionWorkspacesGetWorkspaceResultWorkspaceHostType fromValue(String value) { - for (SessionWorkspacesGetWorkspaceResultWorkspaceHostType v : values()) { - if (v.value.equals(value)) return v; - } - throw new IllegalArgumentException("Unknown SessionWorkspacesGetWorkspaceResultWorkspaceHostType value: " + value); - } - } - - public enum SessionWorkspacesGetWorkspaceResultWorkspaceSessionSyncLevel { - /** The {@code local} variant. */ - LOCAL("local"), - /** The {@code user} variant. */ - USER("user"), - /** The {@code repo_and_user} variant. */ - REPO_AND_USER("repo_and_user"); - - private final String value; - SessionWorkspacesGetWorkspaceResultWorkspaceSessionSyncLevel(String value) { this.value = value; } - @com.fasterxml.jackson.annotation.JsonValue - public String getValue() { return value; } - @com.fasterxml.jackson.annotation.JsonCreator - public static SessionWorkspacesGetWorkspaceResultWorkspaceSessionSyncLevel fromValue(String value) { - for (SessionWorkspacesGetWorkspaceResultWorkspaceSessionSyncLevel v : values()) { - if (v.value.equals(value)) return v; - } - throw new IllegalArgumentException("Unknown SessionWorkspacesGetWorkspaceResultWorkspaceSessionSyncLevel value: " + value); - } - } - } -} diff --git a/src/main/java/com/github/copilot/sdk/CliServerManager.java b/src/main/java/com/github/copilot/CliServerManager.java similarity index 80% rename from src/main/java/com/github/copilot/sdk/CliServerManager.java rename to src/main/java/com/github/copilot/CliServerManager.java index 07b5eefecc..a6a08a8482 100644 --- a/src/main/java/com/github/copilot/sdk/CliServerManager.java +++ b/src/main/java/com/github/copilot/CliServerManager.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.io.BufferedReader; import java.io.File; @@ -19,7 +19,7 @@ import java.util.regex.Matcher; import java.util.regex.Pattern; -import com.github.copilot.sdk.json.CopilotClientOptions; +import com.github.copilot.rpc.CopilotClientOptions; /** * Manages the lifecycle of the Copilot CLI server process. @@ -30,14 +30,28 @@ final class CliServerManager { private static final Logger LOG = Logger.getLogger(CliServerManager.class.getName()); + private static final int STDERR_READER_JOIN_TIMEOUT_MS = 5000; private final CopilotClientOptions options; private final StringBuilder stderrBuffer = new StringBuilder(); + private volatile Thread stderrThread; + private String connectionToken; CliServerManager(CopilotClientOptions options) { this.options = options; } + /** + * Sets the connection token to pass to the CLI process via environment + * variable. + * + * @param connectionToken + * the token, or {@code null} if not applicable + */ + void setConnectionToken(String connectionToken) { + this.connectionToken = connectionToken; + } + /** * Starts the CLI server process. * @@ -76,16 +90,20 @@ ProcessInfo startCliServer() throws IOException, InterruptedException { } // Default UseLoggedInUser to false when GitHubToken is provided - boolean useLoggedInUser = options.getUseLoggedInUser() != null - ? options.getUseLoggedInUser() - : (options.getGitHubToken() == null || options.getGitHubToken().isEmpty()); + boolean useLoggedInUser = options.getUseLoggedInUser() + .orElse(options.getGitHubToken() == null || options.getGitHubToken().isEmpty()); if (!useLoggedInUser) { args.add("--no-auto-login"); } - if (options.getSessionIdleTimeoutSeconds() != null && options.getSessionIdleTimeoutSeconds() > 0) { + if (options.getSessionIdleTimeoutSeconds().isPresent() + && options.getSessionIdleTimeoutSeconds().getAsInt() > 0) { args.add("--session-idle-timeout"); - args.add(String.valueOf(options.getSessionIdleTimeoutSeconds())); + args.add(String.valueOf(options.getSessionIdleTimeoutSeconds().getAsInt())); + } + + if (options.isRemote()) { + args.add("--remote"); } List command = resolveCliCommand(cliPath, args); @@ -115,6 +133,16 @@ ProcessInfo startCliServer() throws IOException, InterruptedException { pb.environment().put("COPILOT_SDK_AUTH_TOKEN", options.getGitHubToken()); } + // Set Copilot home directory if configured + if (options.getCopilotHome() != null && !options.getCopilotHome().isEmpty()) { + pb.environment().put("COPILOT_HOME", options.getCopilotHome()); + } + + // Set connection token for TCP mode + if (connectionToken != null && !connectionToken.isEmpty()) { + pb.environment().put("COPILOT_CONNECTION_TOKEN", connectionToken); + } + // Set telemetry environment variables if configured if (options.getTelemetry() != null) { var telemetry = options.getTelemetry(); @@ -131,9 +159,9 @@ ProcessInfo startCliServer() throws IOException, InterruptedException { if (telemetry.getSourceName() != null) { pb.environment().put("COPILOT_OTEL_SOURCE_NAME", telemetry.getSourceName()); } - if (telemetry.getCaptureContent() != null) { + if (telemetry.getCaptureContent().isPresent()) { pb.environment().put("OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT", - telemetry.getCaptureContent() ? "true" : "false"); + telemetry.getCaptureContent().get() ? "true" : "false"); } } @@ -177,7 +205,7 @@ JsonRpcClient connectToServer(Process process, String tcpHost, Integer tcpPort) } private void startStderrReader(Process process) { - var stderrThread = new Thread(() -> { + var thread = new Thread(() -> { try (BufferedReader reader = new BufferedReader( new InputStreamReader(process.getErrorStream(), StandardCharsets.UTF_8))) { String line; @@ -191,8 +219,9 @@ private void startStderrReader(Process process) { LOG.log(Level.FINE, "Error reading stderr", e); } }, "cli-stderr-reader"); - stderrThread.setDaemon(true); - stderrThread.start(); + thread.setDaemon(true); + thread.start(); + this.stderrThread = thread; } private Integer waitForPortAnnouncement(Process process) throws IOException { @@ -204,11 +233,9 @@ private Integer waitForPortAnnouncement(Process process) throws IOException { while (System.currentTimeMillis() < deadline) { String line = reader.readLine(); if (line == null) { + awaitStderrReader(); String stderr = getStderrOutput(); - if (!stderr.isEmpty()) { - throw new IOException("CLI process exited unexpectedly. stderr: " + stderr); - } - throw new IOException("CLI process exited unexpectedly"); + throw new IOException(formatCliExitedMessage("CLI process exited unexpectedly.", stderr)); } Matcher matcher = portPattern.matcher(line); @@ -228,12 +255,30 @@ String getStderrOutput() { } } + private void awaitStderrReader() { + Thread t = this.stderrThread; + if (t != null) { + try { + t.join(STDERR_READER_JOIN_TIMEOUT_MS); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + } + private void clearStderrBuffer() { synchronized (stderrBuffer) { stderrBuffer.setLength(0); } } + static String formatCliExitedMessage(String message, String stderrOutput) { + if (stderrOutput == null || stderrOutput.isEmpty()) { + return message; + } + return message + "\nstderr: " + stderrOutput; + } + private List resolveCliCommand(String cliPath, List args) { boolean isJsFile = cliPath.toLowerCase().endsWith(".js"); diff --git a/src/main/java/com/github/copilot/sdk/ConnectionState.java b/src/main/java/com/github/copilot/ConnectionState.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/ConnectionState.java rename to src/main/java/com/github/copilot/ConnectionState.java index d35528006b..5ce3782d16 100644 --- a/src/main/java/com/github/copilot/sdk/ConnectionState.java +++ b/src/main/java/com/github/copilot/ConnectionState.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; /** * Represents the connection state of a {@link CopilotClient}. diff --git a/src/main/java/com/github/copilot/CopilotClient.java b/src/main/java/com/github/copilot/CopilotClient.java new file mode 100644 index 0000000000..36a3c78d1b --- /dev/null +++ b/src/main/java/com/github/copilot/CopilotClient.java @@ -0,0 +1,1211 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import java.io.IOException; +import java.net.URI; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.CompletionException; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.Executor; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.RejectedExecutionException; +import java.util.concurrent.TimeUnit; +import java.util.logging.Level; +import java.util.logging.Logger; + +import com.github.copilot.rpc.CopilotClientMode; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.CreateSessionResponse; +import com.github.copilot.generated.rpc.SessionOptionsUpdateParams; +import com.github.copilot.generated.rpc.SessionInstalledPlugin; +import com.github.copilot.generated.rpc.ConnectParams; +import com.github.copilot.generated.rpc.ServerRpc; +import com.github.copilot.rpc.DeleteSessionResponse; +import com.github.copilot.rpc.GetAuthStatusResponse; +import com.github.copilot.rpc.GetLastSessionIdResponse; +import com.github.copilot.rpc.GetSessionMetadataResponse; +import com.github.copilot.rpc.GetModelsResponse; +import com.github.copilot.rpc.GetStatusResponse; +import com.github.copilot.rpc.ListSessionsResponse; +import com.github.copilot.rpc.ModelInfo; +import com.github.copilot.rpc.PingResponse; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.ResumeSessionResponse; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionLifecycleHandler; +import com.github.copilot.rpc.SessionListFilter; +import com.github.copilot.rpc.SessionMetadata; + +/** + * Provides a client for interacting with the Copilot CLI server. + *

+ * The CopilotClient manages the connection to the Copilot CLI server and + * provides methods to create and manage conversation sessions. It can either + * spawn a CLI server process or connect to an existing server. + *

+ * Example usage: + * + * 

{@code
+ * try (var client = new CopilotClient()) {
+ * 	client.start().get();
+ *
+ * 	var session = client
+ * 			.createSession(
+ * 					new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL).setModel("gpt-5"))
+ * 			.get();
+ *
+ * 	session.on(AssistantMessageEvent.class, msg -> {
+ * 		System.out.println(msg.getData().content());
+ * 	});
+ *
+ * 	session.send(new MessageOptions().setPrompt("Hello!")).get();
+ * }
+ * }
+ * + * @since 1.0.0 + */ +public final class CopilotClient implements AutoCloseable { + + private static final Logger LOG = Logger.getLogger(CopilotClient.class.getName()); + + /** + * Timeout, in seconds, used by {@link #close()} when waiting for graceful + * shutdown via {@link #stop()}. + */ + public static final int AUTOCLOSEABLE_TIMEOUT_SECONDS = 10; + private static final int FORCE_KILL_TIMEOUT_SECONDS = 10; + + /** + * One-shot dispatcher used to run the owned-executor shutdown off any caller + * thread that might itself belong to that executor (e.g. the + * {@link #forceStop()} continuation, which is chained off async work scheduled + * on the internal executor). Spawning a fresh daemon thread guarantees + * {@link java.util.concurrent.ExecutorService#awaitTermination(long, TimeUnit)} + * is never called from inside the very executor it is waiting on. + */ + private static final Executor SHUTDOWN_DISPATCHER = runnable -> { + Thread t = new Thread(runnable, "copilot-client-shutdown"); + t.setDaemon(true); + t.start(); + }; + + private final CopilotClientOptions options; + private final Executor executor; + private final boolean executorCanBeShutdown; + private final CliServerManager serverManager; + private final LifecycleEventManager lifecycleManager = new LifecycleEventManager(); + private final Map sessions = new ConcurrentHashMap<>(); + private volatile CompletableFuture connectionFuture; + private volatile boolean disposed = false; + private final String optionsHost; + private final Integer optionsPort; + private final String effectiveConnectionToken; + private volatile List modelsCache; + private final Object modelsCacheLock = new Object(); + + /** + * Creates a new CopilotClient with default options. + */ + public CopilotClient() { + this(new CopilotClientOptions()); + } + + /** + * Creates a new CopilotClient with the specified options. + * + * @param options + * Options for creating the client + * @throws IllegalArgumentException + * if mutually exclusive options are provided + */ + public CopilotClient(CopilotClientOptions options) { + this.options = options != null ? options : new CopilotClientOptions(); + + // When cliUrl is set, auto-correct useStdio since we're connecting via TCP + if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty()) { + this.options.setUseStdio(false); + } + + // Validate mutually exclusive options: cliUrl and cliPath cannot both be set + if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty() + && this.options.getCliPath() != null) { + throw new IllegalArgumentException("CliUrl is mutually exclusive with CliPath"); + } + + // Validate auth options with external server + if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty() + && (this.options.getGitHubToken() != null || this.options.getUseLoggedInUser().isPresent())) { + throw new IllegalArgumentException( + "GitHubToken and UseLoggedInUser cannot be used with CliUrl (external server manages its own auth)"); + } + + // Validate tcpConnectionToken + if (this.options.getTcpConnectionToken() != null) { + if (this.options.getTcpConnectionToken().isEmpty()) { + throw new IllegalArgumentException("TcpConnectionToken must be a non-empty string"); + } + if (this.options.isUseStdio()) { + throw new IllegalArgumentException("TcpConnectionToken cannot be used with UseStdio = true"); + } + } + + // Compute effective connection token: use provided, or auto-generate for + // SDK-spawned TCP mode, or null for stdio/external server + boolean sdkSpawnsCli = !this.options.isUseStdio() + && (this.options.getCliUrl() == null || this.options.getCliUrl().isEmpty()); + this.effectiveConnectionToken = this.options.getTcpConnectionToken() != null + ? this.options.getTcpConnectionToken() + : (sdkSpawnsCli ? java.util.UUID.randomUUID().toString() : null); + + // Empty mode: validate at construction time that the app supplied a + // per-session persistence location. + if (this.options.getMode() == CopilotClientMode.EMPTY) { + boolean hasPersistence = (this.options.getCopilotHome() != null && !this.options.getCopilotHome().isEmpty()) + || (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty()); + if (!hasPersistence) { + throw new IllegalArgumentException( + "CopilotClient was created with Mode = EMPTY but neither CopilotHome nor CliUrl was set. " + + "Empty mode requires an explicit per-session persistence location."); + } + } + + // Parse CliUrl if provided + if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty()) { + URI uri = CliServerManager.parseCliUrl(this.options.getCliUrl()); + this.optionsHost = uri.getHost(); + this.optionsPort = uri.getPort(); + } else { + this.optionsHost = null; + this.optionsPort = null; + } + + InternalExecutorProvider executorProvider = new InternalExecutorProvider(this.options.getExecutor()); + this.executor = executorProvider.get(); + this.executorCanBeShutdown = executorProvider.canBeShutdown(); + + this.serverManager = new CliServerManager(this.options); + this.serverManager.setConnectionToken(this.effectiveConnectionToken); + } + + /** + * Starts the Copilot client and connects to the server. + * + * @return A future that completes when the connection is established + */ + public CompletableFuture start() { + if (connectionFuture == null) { + synchronized (this) { + if (connectionFuture == null) { + connectionFuture = startCore(); + } + } + } + return connectionFuture.thenApply(c -> null); + } + + private CompletableFuture startCore() { + LOG.fine("Starting Copilot client"); + + try { + return CompletableFuture.supplyAsync(this::startCoreBody, executor); + } catch (RejectedExecutionException e) { + return CompletableFuture.failedFuture(e); + } + } + + private Connection startCoreBody() { + Process process = null; + long startNanos = System.nanoTime(); + try { + JsonRpcClient rpc; + + if (optionsHost != null && optionsPort != null) { + // External server (TCP) + rpc = serverManager.connectToServer(null, optionsHost, optionsPort); + } else { + // Child process (stdio or TCP) + CliServerManager.ProcessInfo processInfo = serverManager.startCliServer(); + process = processInfo.process(); + rpc = serverManager.connectToServer(process, processInfo.port() != null ? "localhost" : null, + processInfo.port()); + } + + LoggingHelpers.logTiming(LOG, Level.FINE, "CopilotClient.start transport setup complete. Elapsed={Elapsed}", + startNanos); + + Connection connection = new Connection(rpc, process, new ServerRpc(rpc::invoke)); + + // Register handlers for server-to-client calls + RpcHandlerDispatcher dispatcher = new RpcHandlerDispatcher(sessions, lifecycleManager::dispatch, executor); + dispatcher.registerHandlers(rpc); + + // Verify protocol version + verifyProtocolVersion(connection); + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotClient.start protocol verification complete. Elapsed={Elapsed}", startNanos); + + LoggingHelpers.logTiming(LOG, Level.FINE, "CopilotClient.start complete. Elapsed={Elapsed}", startNanos); + return connection; + } catch (Exception e) { + if (!(e instanceof java.util.concurrent.CancellationException)) { + LoggingHelpers.logTiming(LOG, Level.WARNING, e, "CopilotClient.start failed. Elapsed={Elapsed}", + startNanos); + } + // Clean up the spawned process if connection setup failed + if (process != null) { + cleanupCliProcess(process); + } + String stderr = serverManager.getStderrOutput(); + if (!stderr.isEmpty()) { + throw new CompletionException(new IOException( + CliServerManager.formatCliExitedMessage("CLI process exited unexpectedly.", stderr), e)); + } + throw new CompletionException(e); + } + } + + private static final int MIN_PROTOCOL_VERSION = 2; + private static final int METHOD_NOT_FOUND_ERROR_CODE = -32601; + + private void verifyProtocolVersion(Connection connection) throws Exception { + int expectedVersion = SdkProtocolVersion.get(); + Integer serverVersion; + + try { + // Try the new 'connect' RPC which supports connection tokens + var connectParams = new ConnectParams(effectiveConnectionToken); + var connectResponse = connection.rpc + .invoke("connect", connectParams, com.github.copilot.generated.rpc.ConnectResult.class) + .get(30, TimeUnit.SECONDS); + serverVersion = connectResponse.protocolVersion() != null + ? connectResponse.protocolVersion().intValue() + : null; + } catch (Exception e) { + // Unwrap CompletionException/ExecutionException to check inner cause + Throwable cause = e; + while (cause instanceof java.util.concurrent.ExecutionException || cause instanceof CompletionException) { + cause = cause.getCause(); + } + if (cause instanceof JsonRpcException rpcEx && isUnsupportedConnectMethod(rpcEx)) { + // Legacy server without 'connect'; fall back to 'ping'. + // A token, if any, is silently dropped β€” the legacy server can't enforce one. + var params = new HashMap(); + params.put("message", null); + PingResponse pingResponse = connection.rpc.invoke("ping", params, PingResponse.class).get(30, + TimeUnit.SECONDS); + serverVersion = pingResponse.protocolVersion(); + } else { + throw e; + } + } + + if (serverVersion == null) { + throw new RuntimeException("SDK protocol version mismatch: SDK supports versions " + MIN_PROTOCOL_VERSION + + "-" + expectedVersion + ", but server does not report a protocol version. " + + "Please update your server to ensure compatibility."); + } + + if (serverVersion < MIN_PROTOCOL_VERSION || serverVersion > expectedVersion) { + throw new RuntimeException("SDK protocol version mismatch: SDK supports versions " + MIN_PROTOCOL_VERSION + + "-" + expectedVersion + ", but server reports version " + serverVersion + ". " + + "Please update your SDK or server to ensure compatibility."); + } + } + + private static boolean isUnsupportedConnectMethod(JsonRpcException ex) { + return ex.getCode() == METHOD_NOT_FOUND_ERROR_CODE || "Unhandled method connect".equals(ex.getMessage()); + } + + /** + * Disconnects from the Copilot server and closes all active sessions. + *

+ * This method performs graceful cleanup: + *

    + *
  1. Closes all active sessions (releases in-memory resources)
    2. + *
  2. Closes the JSON-RPC connection
    3. + *
  3. Terminates the CLI server process (if spawned by this client)
    4. + *
+ *

+ * Note: session data on disk is preserved, so sessions can be resumed later. To + * permanently remove session data before stopping, call + * {@link #deleteSession(String)} for each session first. + * + * @return A future that completes when the client is stopped + */ + public CompletableFuture stop() { + var closeFutures = new ArrayList>(); + + for (CopilotSession session : new ArrayList<>(sessions.values())) { + Runnable closeTask = () -> { + try { + session.close(); + } catch (Exception e) { + LOG.log(Level.WARNING, "Error closing session " + session.getSessionId(), e); + } + }; + CompletableFuture future; + try { + future = CompletableFuture.runAsync(closeTask, executor); + } catch (RejectedExecutionException e) { + LOG.log(Level.WARNING, "Executor rejected session close task; closing inline", e); + closeTask.run(); + future = CompletableFuture.completedFuture(null); + } + closeFutures.add(future); + } + sessions.clear(); + + return CompletableFuture.allOf(closeFutures.toArray(new CompletableFuture[0])) + .thenCompose(v -> cleanupConnection()); + } + + /** + * Forces an immediate stop of the client without graceful cleanup. + * + * @return A future that completes when the client is stopped + */ + public CompletableFuture forceStop() { + disposed = true; + sessions.clear(); + // Dispatch the blocking shutdownOwnedExecutor() on a dedicated thread: + // cleanupConnection() is chained off async work running on the owned + // executor, so a plain whenComplete(...) here could land the awaitTermination + // call on one of the very threads it is waiting to drain, forcing the full + // AUTOCLOSEABLE_TIMEOUT_SECONDS timeout followed by shutdownNow(). + return cleanupConnection().whenCompleteAsync((ignored, error) -> shutdownOwnedExecutor(), SHUTDOWN_DISPATCHER); + } + + private CompletableFuture cleanupConnection() { + CompletableFuture future = connectionFuture; + connectionFuture = null; + + // Clear models cache + modelsCache = null; + + if (future == null) { + return CompletableFuture.completedFuture(null); + } + + return future.thenAccept(connection -> { + try { + connection.rpc.close(); + } catch (Exception e) { + LOG.log(Level.FINE, "Error closing RPC", e); + } + + if (connection.process != null) { + cleanupCliProcess(connection.process); + } + }).exceptionally(ex -> { + LOG.log(Level.FINE, "Ignoring failed Copilot client startup during cleanup", ex); + return null; + }); + } + + private static void cleanupCliProcess(Process process) { + try { + if (process.isAlive()) { + Process destroyedProcess = process.destroyForcibly(); + if (!destroyedProcess.waitFor(FORCE_KILL_TIMEOUT_SECONDS, TimeUnit.SECONDS)) { + LOG.fine("Process did not terminate within force kill timeout"); + } + } + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + LOG.log(Level.FINE, "Interrupted while killing process", e); + } catch (Exception e) { + LOG.log(Level.FINE, "Error killing process", e); + } + } + + /** + * Creates a new Copilot session with the specified configuration. + *

+ * The session maintains conversation state and can be used to send messages and + * receive responses. Remember to close the session when done. + *

+ * A permission handler is required when creating a session. Use + * {@link com.github.copilot.rpc.PermissionHandler#APPROVE_ALL} to approve all + * permission requests, or provide a custom handler to control permissions + * selectively. + * + *

+ * Example: + * + * 

{@code
+     * var session = client.createSession(new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get();
+     * }
+ * + * @param config + * configuration for the session, including the required + * {@link SessionConfig#setOnPermissionRequest(com.github.copilot.rpc.PermissionHandler)} + * handler + * @return a future that resolves with the created CopilotSession + * @throws IllegalArgumentException + * if {@code config} is {@code null} or does not have a permission + * handler set + * @see SessionConfig + * @see com.github.copilot.rpc.PermissionHandler#APPROVE_ALL + */ + public CompletableFuture createSession(SessionConfig config) { + if (config == null || config.getOnPermissionRequest() == null) { + return CompletableFuture.failedFuture( + new IllegalArgumentException("An onPermissionRequest handler is required when creating a session. " + + "For example, to allow all permissions, use: " + + "new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)")); + } + return ensureConnected().thenCompose(connection -> { + long totalNanos = System.nanoTime(); + // For cloud sessions, let the CLI/server assign the session id + // and register the session lazily once the response arrives. For + // non-cloud sessions we generate the id client-side (when the + // caller didn't supply one) so the session can be registered + // BEFORE the RPC β€” the CLI may issue session-scoped requests + // (e.g. sessionFs.writeFile for workspace metadata) during + // session.create processing, before it has sent the response. + String callerSessionId = config.getSessionId(); + boolean useServerGeneratedId = config.getCloud() != null + && (callerSessionId == null || callerSessionId.isEmpty()); + String localSessionId = useServerGeneratedId + ? null + : (callerSessionId != null && !callerSessionId.isEmpty() + ? callerSessionId + : java.util.UUID.randomUUID().toString()); + + // Extract transform callbacks from the system message config. Callbacks + // are registered with the session; a wire-safe copy of the system + // message (with transform sections replaced by action="transform") is + // used in the RPC request. + var extracted = SessionRequestBuilder.extractTransformCallbacks(config.getSystemMessage()); + + // Creates the session, wires up handlers, and registers it in the + // sessions map. + java.util.function.Function initializeSession = sid -> { + long setupNanos = System.nanoTime(); + var s = new CopilotSession(sid, connection.rpc); + s.setExecutor(executor); + SessionRequestBuilder.configureSession(s, config); + if (extracted.transformCallbacks() != null) { + s.registerTransformCallbacks(extracted.transformCallbacks()); + } + sessions.put(sid, s); + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotClient.createSession local setup complete. Elapsed={Elapsed}, SessionId=" + sid, + setupNanos); + return s; + }; + + String[] registeredIdHolder = new String[1]; + CopilotSession[] preRegisteredSessionHolder = new CopilotSession[1]; + + // Pre-register non-cloud sessions BEFORE issuing the RPC so any + // session-scoped requests the CLI emits during session.create + // processing can be routed to the correct handlers. + if (localSessionId != null) { + preRegisteredSessionHolder[0] = initializeSession.apply(localSessionId); + registeredIdHolder[0] = localSessionId; + } + + var request = SessionRequestBuilder.buildCreateRequest(config, localSessionId); + if (extracted.wireSystemMessage() != config.getSystemMessage()) { + request.setSystemMessage(extracted.wireSystemMessage()); + } + + // Empty mode: validate availableTools and set toolFilterPrecedence + if (options.getMode() == CopilotClientMode.EMPTY) { + if (config.getAvailableTools() == null) { + if (registeredIdHolder[0] != null) { + sessions.remove(registeredIdHolder[0]); + } + throw new IllegalArgumentException( + "CopilotClient is in Mode = EMPTY but the session config did not specify " + + "availableTools. Empty mode requires every session to explicitly opt into " + + "the tools it wants β€” e.g. setAvailableTools(new ToolSet().addBuiltIn(BuiltInTools.ISOLATED))."); + } + request.setToolFilterPrecedence("excluded"); + if (request.getMcpOAuthTokenStorage() == null) { + request.setMcpOAuthTokenStorage("in-memory"); + } + } + + long rpcNanos = System.nanoTime(); + return connection.rpc.invoke("session.create", request, CreateSessionResponse.class) + .thenCompose(response -> { + String returnedId = response.sessionId(); + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotClient.createSession session creation request completed. Elapsed={Elapsed}, SessionId=" + + (returnedId != null ? returnedId : localSessionId), + rpcNanos); + if (returnedId == null || returnedId.isEmpty()) { + throw new RuntimeException("session.create response did not include a sessionId"); + } + if (localSessionId != null && !localSessionId.equals(returnedId)) { + throw new RuntimeException("session.create returned sessionId " + returnedId + + " but the caller requested " + localSessionId); + } + CopilotSession session = preRegisteredSessionHolder[0] != null + ? preRegisteredSessionHolder[0] + : initializeSession.apply(returnedId); + registeredIdHolder[0] = returnedId; + session.setWorkspacePath(response.workspacePath()); + session.setCapabilities(response.capabilities()); + + return updateSessionOptionsForMode(session, config.getSkipCustomInstructions().orElse(null), + config.getCustomAgentsLocalOnly().orElse(null), + config.getCoauthorEnabled().orElse(null), + config.getManageScheduleEnabled().orElse(null)).thenApply(v -> { + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotClient.createSession complete. Elapsed={Elapsed}, SessionId=" + + session.getSessionId(), + totalNanos); + return session; + }); + }).exceptionally(ex -> { + if (registeredIdHolder[0] != null) { + sessions.remove(registeredIdHolder[0]); + } + LoggingHelpers.logTiming(LOG, Level.WARNING, ex, + "CopilotClient.createSession failed. Elapsed={Elapsed}, SessionId=" + + (registeredIdHolder[0] != null ? registeredIdHolder[0] : ""), + totalNanos); + throw ex instanceof RuntimeException re ? re : new RuntimeException(ex); + }); + }); + } + + /** + * Resumes an existing Copilot session. + *

+ * This restores a previously saved session, allowing you to continue a + * conversation. The session's history is preserved. + *

+ * A permission handler is required when resuming a session. Use + * {@link com.github.copilot.rpc.PermissionHandler#APPROVE_ALL} to approve all + * permission requests, or provide a custom handler to control permissions + * selectively. + * + * @param sessionId + * the ID of the session to resume + * @param config + * configuration for the resumed session, including the required + * {@link ResumeSessionConfig#setOnPermissionRequest(com.github.copilot.rpc.PermissionHandler)} + * handler + * @return a future that resolves with the resumed CopilotSession + * @throws IllegalArgumentException + * if {@code config} is {@code null} or does not have a permission + * handler set + * @see #listSessions() + * @see #getLastSessionId() + * @see com.github.copilot.rpc.PermissionHandler#APPROVE_ALL + */ + public CompletableFuture resumeSession(String sessionId, ResumeSessionConfig config) { + if (config == null || config.getOnPermissionRequest() == null) { + return CompletableFuture.failedFuture( + new IllegalArgumentException("An onPermissionRequest handler is required when resuming a session. " + + "For example, to allow all permissions, use: " + + "new ResumeSessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)")); + } + return ensureConnected().thenCompose(connection -> { + long totalNanos = System.nanoTime(); + // Register the session before the RPC call to avoid missing early events. + long setupNanos = System.nanoTime(); + var session = new CopilotSession(sessionId, connection.rpc); + session.setExecutor(executor); + SessionRequestBuilder.configureSession(session, config); + sessions.put(sessionId, session); + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotClient.resumeSession local setup complete. Elapsed={Elapsed}, SessionId=" + sessionId, + setupNanos); + + // Extract transform callbacks from the system message config. + var extracted = SessionRequestBuilder.extractTransformCallbacks(config.getSystemMessage()); + if (extracted.transformCallbacks() != null) { + session.registerTransformCallbacks(extracted.transformCallbacks()); + } + + var request = SessionRequestBuilder.buildResumeRequest(sessionId, config); + if (extracted.wireSystemMessage() != config.getSystemMessage()) { + request.setSystemMessage(extracted.wireSystemMessage()); + } + + // Empty mode: validate availableTools and set toolFilterPrecedence for resume + // path + if (options.getMode() == CopilotClientMode.EMPTY) { + if (config.getAvailableTools() == null) { + throw new IllegalArgumentException( + "CopilotClient is in Mode = EMPTY but the resume session config did not specify " + + "availableTools. Empty mode requires every session to explicitly opt into " + + "the tools it wants β€” e.g. setAvailableTools(new ToolSet().addBuiltIn(BuiltInTools.ISOLATED))."); + } + request.setToolFilterPrecedence("excluded"); + if (request.getMcpOAuthTokenStorage() == null) { + request.setMcpOAuthTokenStorage("in-memory"); + } + } + + long rpcNanos = System.nanoTime(); + return connection.rpc.invoke("session.resume", request, ResumeSessionResponse.class) + .thenCompose(response -> { + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotClient.resumeSession session resume request completed. Elapsed={Elapsed}, SessionId=" + + sessionId, + rpcNanos); + session.setWorkspacePath(response.workspacePath()); + session.setCapabilities(response.capabilities()); + // If the server returned a different sessionId than what was requested, + // re-key. + String returnedId = response.sessionId(); + if (returnedId != null && !returnedId.equals(sessionId)) { + sessions.remove(sessionId); + session.setActiveSessionId(returnedId); + sessions.put(returnedId, session); + } + + return updateSessionOptionsForMode(session, config.getSkipCustomInstructions().orElse(null), + config.getCustomAgentsLocalOnly().orElse(null), + config.getCoauthorEnabled().orElse(null), + config.getManageScheduleEnabled().orElse(null)).thenApply(v -> { + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotClient.resumeSession complete. Elapsed={Elapsed}, SessionId=" + + sessionId, + totalNanos); + return session; + }); + }).exceptionally(ex -> { + sessions.remove(sessionId); + // Also remove the re-keyed entry if the server returned a different ID + String activeId = session.getSessionId(); + if (!sessionId.equals(activeId)) { + sessions.remove(activeId); + } + LoggingHelpers.logTiming(LOG, Level.WARNING, ex, + "CopilotClient.resumeSession failed. Elapsed={Elapsed}, SessionId=" + sessionId, + totalNanos); + throw ex instanceof RuntimeException re ? re : new RuntimeException(ex); + }); + }); + } + + /** + * Applies the post-create / post-resume {@code session.options.update} patch. + *

+ * In {@link CopilotClientMode#EMPTY EMPTY} mode this defaults the four + * overridable feature flags to safe values (caller values from the config win); + * {@code installedPlugins=[]} is unconditional under empty mode so apps that + * need plugins must switch modes. In {@link CopilotClientMode#COPILOT_CLI + * COPILOT_CLI} mode only explicitly-set fields are forwarded. + * + * @param session + * the session to patch + * @param skipCustomInstructions + * caller-supplied value, or {@code null} if not set + * @param customAgentsLocalOnly + * caller-supplied value, or {@code null} if not set + * @param coauthorEnabled + * caller-supplied value, or {@code null} if not set + * @param manageScheduleEnabled + * caller-supplied value, or {@code null} if not set + * @return a future that completes when the patch has been applied + */ + CompletableFuture updateSessionOptionsForMode(CopilotSession session, Boolean skipCustomInstructions, + Boolean customAgentsLocalOnly, Boolean coauthorEnabled, Boolean manageScheduleEnabled) { + + Boolean patchSkip = null; + Boolean patchAgents = null; + Boolean patchCoauthor = null; + Boolean patchSchedule = null; + List patchPlugins = null; + boolean hasAnyPatch = false; + + if (options.getMode() == CopilotClientMode.EMPTY) { + patchSkip = skipCustomInstructions != null ? skipCustomInstructions : true; + patchAgents = customAgentsLocalOnly != null ? customAgentsLocalOnly : true; + patchCoauthor = coauthorEnabled != null ? coauthorEnabled : false; + patchSchedule = manageScheduleEnabled != null ? manageScheduleEnabled : false; + patchPlugins = List.of(); + hasAnyPatch = true; + } else { + if (skipCustomInstructions != null) { + patchSkip = skipCustomInstructions; + hasAnyPatch = true; + } + if (customAgentsLocalOnly != null) { + patchAgents = customAgentsLocalOnly; + hasAnyPatch = true; + } + if (coauthorEnabled != null) { + patchCoauthor = coauthorEnabled; + hasAnyPatch = true; + } + if (manageScheduleEnabled != null) { + patchSchedule = manageScheduleEnabled; + hasAnyPatch = true; + } + } + + if (!hasAnyPatch) { + return CompletableFuture.completedFuture(null); + } + + var params = new SessionOptionsUpdateParams(null, // sessionId β€” set by SessionOptionsApi + null, // model + null, // reasoningEffort + null, // clientName + null, // lspClientName + null, // integrationId + null, // featureFlags + null, // isExperimentalMode + null, // provider + null, // workingDirectory + null, // availableTools + null, // excludedTools + null, // toolFilterPrecedence + null, // enableScriptSafety + null, // shellInitProfile + null, // shellProcessFlags + null, // sandboxConfig + null, // logInteractiveShells + null, // envValueMode + null, // skillDirectories + null, // disabledSkills + null, // enableOnDemandInstructionDiscovery + patchPlugins, // installedPlugins + patchAgents, // customAgentsLocalOnly + patchSkip, // skipCustomInstructions + null, // disabledInstructionSources + patchCoauthor, // coauthorEnabled + null, // trajectoryFile + null, // enableStreaming + null, // copilotUrl + null, // askUserDisabled + null, // continueOnAutoMode + null, // runningInInteractiveMode + null, // enableReasoningSummaries + null, // agentContext + null, // eventsLogDirectory + null, // additionalContentExclusionPolicies + patchSchedule // manageScheduleEnabled + ); + + return session.getRpc().options.update(params).thenCompose(result -> { + LOG.fine("session.options.update applied for session " + session.getSessionId()); + return CompletableFuture.completedFuture(null); + }).exceptionally(ex -> { + // The runtime session exists but the post-create options patch failed. + // Best-effort disconnect so we don't leak it (in empty mode it would + // otherwise stay alive with permissive defaults). + LOG.log(Level.WARNING, "session.options.update failed for session " + session.getSessionId(), ex); + sessions.remove(session.getSessionId()); + try { + session.close(); + } catch (Exception closeEx) { + // Swallow: original error is the one the caller needs. + } + throw ex instanceof RuntimeException re ? re : new RuntimeException(ex); + }); + } + + /** + * Gets the current connection state. + * + * @return the current connection state + * @see ConnectionState + */ + public ConnectionState getState() { + if (connectionFuture == null) + return ConnectionState.DISCONNECTED; + if (connectionFuture.isCompletedExceptionally()) + return ConnectionState.ERROR; + if (!connectionFuture.isDone()) + return ConnectionState.CONNECTING; + return ConnectionState.CONNECTED; + } + + /** + * Returns the typed RPC client for server-level methods. + *

+ * Provides strongly-typed access to all server-level API namespaces such as + * {@code models}, {@code tools}, {@code account}, and {@code mcp}. + *

+ * Example usage: + * + * 

{@code
+     * client.start().get();
+     * var models = client.getRpc().models.list().get();
+     * }
+ * + * @return the server-level typed RPC client + * @throws IllegalStateException + * if the client is not connected; call {@link #start()} first + * @since 1.0.0 + */ + public ServerRpc getRpc() { + CompletableFuture future = connectionFuture; + if (future == null || !future.isDone() || future.isCompletedExceptionally()) { + throw new IllegalStateException("Client not connected; call start() first"); + } + return future.join().serverRpc(); + } + + /** + * Pings the server to check connectivity. + *

+ * This can be used to verify that the server is responsive and to check the + * protocol version. + * + * @param message + * an optional message to echo back + * @return a future that resolves with the ping response + * @see PingResponse + */ + public CompletableFuture ping(String message) { + return ensureConnected().thenCompose(connection -> connection.rpc.invoke("ping", + Map.of("message", message != null ? message : ""), PingResponse.class)); + } + + /** + * Gets CLI status including version and protocol information. + * + * @return a future that resolves with the status response containing version + * and protocol version + * @see GetStatusResponse + */ + public CompletableFuture getStatus() { + return ensureConnected() + .thenCompose(connection -> connection.rpc.invoke("status.get", Map.of(), GetStatusResponse.class)); + } + + /** + * Gets current authentication status. + * + * @return a future that resolves with the authentication status + * @see GetAuthStatusResponse + */ + public CompletableFuture getAuthStatus() { + return ensureConnected().thenCompose( + connection -> connection.rpc.invoke("auth.getStatus", Map.of(), GetAuthStatusResponse.class)); + } + + /** + * Lists available models with their metadata. + *

+ * Results are cached after the first successful call to avoid rate limiting. + * The cache is cleared when the client disconnects. + *

+ * If an {@code onListModels} handler was provided in + * {@link com.github.copilot.rpc.CopilotClientOptions}, it is called instead of + * querying the CLI server. This is useful in BYOK mode. + * + * @return a future that resolves with a list of available models + * @see ModelInfo + */ + public CompletableFuture> listModels() { + // Check cache first + List cached = modelsCache; + if (cached != null) { + return CompletableFuture.completedFuture(new ArrayList<>(cached)); + } + + // If a custom handler is configured, use it instead of querying the CLI server + var onListModels = options.getOnListModels(); + if (onListModels != null) { + synchronized (modelsCacheLock) { + if (modelsCache != null) { + return CompletableFuture.completedFuture(new ArrayList<>(modelsCache)); + } + } + return onListModels.get().thenApply(models -> { + synchronized (modelsCacheLock) { + modelsCache = models; + } + return new ArrayList<>(models); + }); + } + + return ensureConnected().thenCompose(connection -> { + // Double-check cache inside lock + synchronized (modelsCacheLock) { + if (modelsCache != null) { + return CompletableFuture.completedFuture(new ArrayList<>(modelsCache)); + } + } + + return connection.rpc.invoke("models.list", Map.of(), GetModelsResponse.class).thenApply(response -> { + List models = response.getModels(); + synchronized (modelsCacheLock) { + modelsCache = models; + } + return new ArrayList<>(models); // Return a copy to prevent cache mutation + }); + }); + } + + /** + * Gets the ID of the most recently used session. + *

+ * This is useful for resuming the last conversation without needing to list all + * sessions. + * + * @return a future that resolves with the last session ID, or {@code null} if + * no sessions exist + * @see #resumeSession(String, com.github.copilot.rpc.ResumeSessionConfig) + */ + public CompletableFuture getLastSessionId() { + return ensureConnected().thenCompose( + connection -> connection.rpc.invoke("session.getLastId", Map.of(), GetLastSessionIdResponse.class) + .thenApply(GetLastSessionIdResponse::sessionId)); + } + + /** + * Permanently deletes a session and all its data from disk, including + * conversation history, planning state, and artifacts. + *

+ * Unlike {@link CopilotSession#close()}, which only releases in-memory + * resources and preserves session data for later resumption, this method is + * irreversible. The session cannot be resumed after deletion. + * + * @param sessionId + * the ID of the session to delete + * @return a future that completes when the session is deleted + * @throws RuntimeException + * if the deletion fails + */ + public CompletableFuture deleteSession(String sessionId) { + return ensureConnected().thenCompose(connection -> connection.rpc + .invoke("session.delete", Map.of("sessionId", sessionId), DeleteSessionResponse.class) + .thenAccept(response -> { + if (!response.success()) { + throw new RuntimeException("Failed to delete session " + sessionId + ": " + response.error()); + } + sessions.remove(sessionId); + })); + } + + /** + * Lists all available sessions. + *

+ * Returns metadata about all sessions that can be resumed, including their IDs, + * start times, and summaries. + * + * @return a future that resolves with a list of session metadata + * @see SessionMetadata + * @see #resumeSession(String, com.github.copilot.rpc.ResumeSessionConfig) + */ + public CompletableFuture> listSessions() { + return listSessions(null); + } + + /** + * Lists all available sessions with optional filtering. + *

+ * Returns metadata about all sessions that can be resumed, including their IDs, + * start times, summaries, and context information. Use the filter parameter to + * narrow down sessions by working directory, git repository, or branch. + * + *

Example Usage

+ * + * 
{@code
+     * // List all sessions
+     * var allSessions = client.listSessions().get();
+     *
+     * // Filter by repository
+     * var filter = new SessionListFilter().setRepository("owner/repo");
+     * var repoSessions = client.listSessions(filter).get();
+     * }
+ * + * @param filter + * optional filter to narrow down sessions by context fields, or + * {@code null} to list all sessions + * @return a future that resolves with a list of session metadata + * @see SessionMetadata + * @see SessionListFilter + * @see #resumeSession(String, com.github.copilot.rpc.ResumeSessionConfig) + */ + public CompletableFuture> listSessions(SessionListFilter filter) { + return ensureConnected().thenCompose(connection -> { + Map params = filter != null ? Map.of("filter", filter) : Map.of(); + return connection.rpc.invoke("session.list", params, ListSessionsResponse.class) + .thenApply(ListSessionsResponse::sessions); + }); + } + + /** + * Gets metadata for a specific session by ID. + *

+ * This provides an efficient O(1) lookup of a single session's metadata instead + * of listing all sessions. + * + *

Example Usage

+ * + * 
{@code
+     * var metadata = client.getSessionMetadata("session-123").get();
+     * if (metadata != null) {
+     * 	System.out.println("Session started at: " + metadata.getStartTime());
+     * }
+     * }
+ * + * @param sessionId + * the ID of the session to look up + * @return a future that resolves with the {@link SessionMetadata}, or + * {@code null} if the session was not found + * @see SessionMetadata + * @since 1.0.0 + */ + public CompletableFuture getSessionMetadata(String sessionId) { + return ensureConnected().thenCompose(connection -> connection.rpc + .invoke("session.getMetadata", Map.of("sessionId", sessionId), GetSessionMetadataResponse.class) + .thenApply(GetSessionMetadataResponse::session)); + } + + /** + * Gets the ID of the session currently displayed in the TUI. + *

+ * This is only available when connecting to a server running in TUI+server mode + * (--ui-server). + * + * @return a future that resolves with the session ID, or null if no foreground + * session is set + */ + public CompletableFuture getForegroundSessionId() { + return ensureConnected().thenCompose(connection -> connection.rpc + .invoke("session.getForeground", Map.of(), com.github.copilot.rpc.GetForegroundSessionResponse.class) + .thenApply(com.github.copilot.rpc.GetForegroundSessionResponse::sessionId)); + } + + /** + * Requests the TUI to switch to displaying the specified session. + *

+ * This is only available when connecting to a server running in TUI+server mode + * (--ui-server). + * + * @param sessionId + * the ID of the session to display in the TUI + * @return a future that completes when the operation is done + * @throws RuntimeException + * if the operation fails + */ + public CompletableFuture setForegroundSessionId(String sessionId) { + return ensureConnected().thenCompose(connection -> connection.rpc + .invoke("session.setForeground", new com.github.copilot.rpc.SetForegroundSessionRequest(sessionId), + com.github.copilot.rpc.SetForegroundSessionResponse.class) + .thenAccept(response -> { + if (!response.success()) { + throw new RuntimeException( + response.error() != null ? response.error() : "Failed to set foreground session"); + } + })); + } + + /** + * Subscribes to all session lifecycle events. + *

+ * Lifecycle events are emitted when sessions are created, deleted, updated, or + * change foreground/background state (in TUI+server mode). + * + * @param handler + * a callback that receives lifecycle events + * @return an AutoCloseable that, when closed, unsubscribes the handler + */ + public AutoCloseable onLifecycle(SessionLifecycleHandler handler) { + return lifecycleManager.subscribe(handler); + } + + /** + * Subscribes to a specific session lifecycle event type. + * + * @param eventType + * the event type to listen for (use + * {@link com.github.copilot.rpc.SessionLifecycleEventTypes} + * constants) + * @param handler + * a callback that receives events of the specified type + * @return an AutoCloseable that, when closed, unsubscribes the handler + */ + public AutoCloseable onLifecycle(String eventType, SessionLifecycleHandler handler) { + return lifecycleManager.subscribe(eventType, handler); + } + + private CompletableFuture ensureConnected() { + if (connectionFuture == null && !options.isAutoStart()) { + throw new IllegalStateException("Client not connected. Call start() first."); + } + + start(); + return connectionFuture; + } + + /** + * Closes this client using graceful shutdown semantics. + *

+ * This method is intended for {@code try-with-resources} usage and blocks while + * waiting for {@link #stop()} to complete, up to + * {@link #AUTOCLOSEABLE_TIMEOUT_SECONDS} seconds. If shutdown fails or times + * out, the error is logged at {@link Level#FINE} and the method returns. + *

+ * This method is idempotent. + * + * @see #stop() + * @see #forceStop() + * @see #AUTOCLOSEABLE_TIMEOUT_SECONDS + */ + @Override + public void close() { + if (disposed) + return; + disposed = true; + try { + stop().get(AUTOCLOSEABLE_TIMEOUT_SECONDS, TimeUnit.SECONDS); + } catch (Exception e) { + LOG.log(Level.FINE, "Error during close", e); + } finally { + shutdownOwnedExecutor(); + } + } + + private void shutdownOwnedExecutor() { + if (!executorCanBeShutdown) { + return; + } + + ExecutorService serviceToShutdown = executor instanceof ExecutorService es ? es : null; + if (serviceToShutdown == null) { + LOG.log(Level.FINE, "Executor is not an ExecutorService; skipping shutdown"); + return; + } + + // Short-circuit when the owned executor is already shut down. close() and + // forceStop() can each call this method (e.g. forceStop() invoked before a + // subsequent close() in user code), and re-entering shutdown() + + // awaitTermination() + // is redundant. Logging at FINE aids diagnostics without spamming normal + // output. + if (serviceToShutdown.isShutdown()) { + LOG.log(Level.FINE, "Owned executor was already shut down; skipping redundant shutdown call."); + return; + } + + serviceToShutdown.shutdown(); + try { + if (!serviceToShutdown.awaitTermination(AUTOCLOSEABLE_TIMEOUT_SECONDS, TimeUnit.SECONDS)) { + LOG.log(Level.FINE, "Owned executor did not terminate within {0} seconds; forcing shutdown.", + AUTOCLOSEABLE_TIMEOUT_SECONDS); + serviceToShutdown.shutdownNow(); + } + } catch (InterruptedException e) { + serviceToShutdown.shutdownNow(); + Thread.currentThread().interrupt(); + LOG.log(Level.FINE, "Interrupted while waiting for owned executor to terminate", e); + } + } + + private static record Connection(JsonRpcClient rpc, Process process, ServerRpc serverRpc) { + }; + +} diff --git a/src/main/java/com/github/copilot/sdk/CopilotSession.java b/src/main/java/com/github/copilot/CopilotSession.java similarity index 83% rename from src/main/java/com/github/copilot/sdk/CopilotSession.java rename to src/main/java/com/github/copilot/CopilotSession.java index c1374320cd..64c02d8b8f 100644 --- a/src/main/java/com/github/copilot/sdk/CopilotSession.java +++ b/src/main/java/com/github/copilot/CopilotSession.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.io.Closeable; import java.io.IOException; @@ -29,66 +29,76 @@ import com.fasterxml.jackson.annotation.JsonProperty; import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.rpc.SessionCommandsHandlePendingCommandParams; -import com.github.copilot.sdk.generated.rpc.SessionLogParams; -import com.github.copilot.sdk.generated.rpc.SessionLogLevel; -import com.github.copilot.sdk.generated.rpc.ModelCapabilitiesOverride; -import com.github.copilot.sdk.generated.rpc.ModelCapabilitiesOverrideLimits; -import com.github.copilot.sdk.generated.rpc.ModelCapabilitiesOverrideSupports; -import com.github.copilot.sdk.generated.rpc.SessionModelSwitchToParams; -import com.github.copilot.sdk.generated.rpc.SessionPermissionsHandlePendingPermissionRequestParams; -import com.github.copilot.sdk.generated.rpc.SessionRpc; -import com.github.copilot.sdk.generated.rpc.SessionToolsHandlePendingToolCallParams; -import com.github.copilot.sdk.generated.rpc.SessionUiElicitationParams; -import com.github.copilot.sdk.generated.rpc.SessionUiHandlePendingElicitationParams; -import com.github.copilot.sdk.generated.rpc.UIElicitationResponse; -import com.github.copilot.sdk.generated.rpc.UIElicitationResponseAction; -import com.github.copilot.sdk.generated.rpc.UIElicitationSchema; -import com.github.copilot.sdk.generated.CapabilitiesChangedEvent; -import com.github.copilot.sdk.generated.CommandExecuteEvent; -import com.github.copilot.sdk.generated.ElicitationRequestedEvent; -import com.github.copilot.sdk.generated.ExternalToolRequestedEvent; -import com.github.copilot.sdk.generated.PermissionRequestedEvent; -import com.github.copilot.sdk.generated.SessionErrorEvent; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.json.AgentInfo; -import com.github.copilot.sdk.json.CommandContext; -import com.github.copilot.sdk.json.CommandDefinition; -import com.github.copilot.sdk.json.CommandHandler; -import com.github.copilot.sdk.json.ElicitationContext; -import com.github.copilot.sdk.json.ElicitationHandler; -import com.github.copilot.sdk.json.ElicitationParams; -import com.github.copilot.sdk.json.ElicitationResult; -import com.github.copilot.sdk.json.ElicitationResultAction; -import com.github.copilot.sdk.json.ElicitationSchema; -import com.github.copilot.sdk.json.GetMessagesResponse; -import com.github.copilot.sdk.json.HookInvocation; -import com.github.copilot.sdk.json.InputOptions; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.PermissionInvocation; -import com.github.copilot.sdk.json.PermissionRequest; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PermissionRequestResultKind; -import com.github.copilot.sdk.json.PostToolUseHookInput; -import com.github.copilot.sdk.json.PreToolUseHookInput; -import com.github.copilot.sdk.json.SendMessageRequest; -import com.github.copilot.sdk.json.SendMessageResponse; -import com.github.copilot.sdk.json.SessionCapabilities; -import com.github.copilot.sdk.json.SessionEndHookInput; -import com.github.copilot.sdk.json.SessionHooks; -import com.github.copilot.sdk.json.SessionStartHookInput; -import com.github.copilot.sdk.json.SessionUiApi; -import com.github.copilot.sdk.json.SessionUiCapabilities; -import com.github.copilot.sdk.json.ToolDefinition; -import com.github.copilot.sdk.json.ToolResultObject; -import com.github.copilot.sdk.json.UserInputHandler; -import com.github.copilot.sdk.json.UserInputInvocation; -import com.github.copilot.sdk.json.UserInputRequest; -import com.github.copilot.sdk.json.UserInputResponse; -import com.github.copilot.sdk.json.UserPromptSubmittedHookInput; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.rpc.SessionCommandsHandlePendingCommandParams; +import com.github.copilot.generated.rpc.SessionLogParams; +import com.github.copilot.generated.rpc.SessionLogLevel; +import com.github.copilot.generated.rpc.ModelCapabilitiesOverride; +import com.github.copilot.generated.rpc.ModelCapabilitiesOverrideLimits; +import com.github.copilot.generated.rpc.ModelCapabilitiesOverrideSupports; +import com.github.copilot.generated.rpc.SessionModelSwitchToParams; +import com.github.copilot.generated.rpc.SessionPermissionsHandlePendingPermissionRequestParams; +import com.github.copilot.generated.rpc.SessionRpc; +import com.github.copilot.generated.rpc.SessionToolsHandlePendingToolCallParams; +import com.github.copilot.generated.rpc.SessionUiElicitationParams; +import com.github.copilot.generated.rpc.SessionUiHandlePendingElicitationParams; +import com.github.copilot.generated.rpc.UIElicitationResponse; +import com.github.copilot.generated.rpc.UIElicitationResponseAction; +import com.github.copilot.generated.rpc.UIElicitationSchema; +import com.github.copilot.generated.CapabilitiesChangedEvent; +import com.github.copilot.generated.CommandExecuteEvent; +import com.github.copilot.generated.ElicitationRequestedEvent; +import com.github.copilot.generated.ExternalToolRequestedEvent; +import com.github.copilot.generated.PermissionRequestedEvent; +import com.github.copilot.generated.SessionErrorEvent; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.rpc.AgentInfo; +import com.github.copilot.rpc.AutoModeSwitchHandler; +import com.github.copilot.rpc.AutoModeSwitchInvocation; +import com.github.copilot.rpc.AutoModeSwitchRequest; +import com.github.copilot.rpc.AutoModeSwitchResponse; +import com.github.copilot.rpc.CommandContext; +import com.github.copilot.rpc.CommandDefinition; +import com.github.copilot.rpc.CommandHandler; +import com.github.copilot.rpc.ElicitationContext; +import com.github.copilot.rpc.ElicitationHandler; +import com.github.copilot.rpc.ElicitationParams; +import com.github.copilot.rpc.ElicitationResult; +import com.github.copilot.rpc.ElicitationResultAction; +import com.github.copilot.rpc.ExitPlanModeHandler; +import com.github.copilot.rpc.ExitPlanModeInvocation; +import com.github.copilot.rpc.ExitPlanModeRequest; +import com.github.copilot.rpc.ExitPlanModeResult; +import com.github.copilot.rpc.ElicitationSchema; +import com.github.copilot.rpc.GetMessagesResponse; +import com.github.copilot.rpc.HookInvocation; +import com.github.copilot.rpc.InputOptions; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.PermissionInvocation; +import com.github.copilot.rpc.PermissionRequest; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PermissionRequestResultKind; +import com.github.copilot.rpc.PostToolUseHookInput; +import com.github.copilot.rpc.PostToolUseFailureHookInput; +import com.github.copilot.rpc.PreMcpToolCallHookInput; +import com.github.copilot.rpc.PreToolUseHookInput; +import com.github.copilot.rpc.SendMessageRequest; +import com.github.copilot.rpc.SendMessageResponse; +import com.github.copilot.rpc.SessionCapabilities; +import com.github.copilot.rpc.SessionEndHookInput; +import com.github.copilot.rpc.SessionHooks; +import com.github.copilot.rpc.SessionStartHookInput; +import com.github.copilot.rpc.SessionUiApi; +import com.github.copilot.rpc.SessionUiCapabilities; +import com.github.copilot.rpc.ToolDefinition; +import com.github.copilot.rpc.ToolResultObject; +import com.github.copilot.rpc.UserInputHandler; +import com.github.copilot.rpc.UserInputInvocation; +import com.github.copilot.rpc.UserInputRequest; +import com.github.copilot.rpc.UserInputResponse; +import com.github.copilot.rpc.UserPromptSubmittedHookInput; /** * Represents a single conversation session with the Copilot CLI. @@ -127,9 +137,9 @@ * session.close(); * } * - * @see CopilotClient#createSession(com.github.copilot.sdk.json.SessionConfig) + * @see CopilotClient#createSession(com.github.copilot.rpc.SessionConfig) * @see CopilotClient#resumeSession(String, - * com.github.copilot.sdk.json.ResumeSessionConfig) + * com.github.copilot.rpc.ResumeSessionConfig) * @see SessionEvent * @since 1.0.0 */ @@ -156,6 +166,8 @@ public final class CopilotSession implements AutoCloseable { private final AtomicReference permissionHandler = new AtomicReference<>(); private final AtomicReference userInputHandler = new AtomicReference<>(); private final AtomicReference elicitationHandler = new AtomicReference<>(); + private final AtomicReference exitPlanModeHandler = new AtomicReference<>(); + private final AtomicReference autoModeSwitchHandler = new AtomicReference<>(); private final AtomicReference hooksHandler = new AtomicReference<>(); private volatile EventErrorHandler eventErrorHandler; private volatile EventErrorPolicy eventErrorPolicy = EventErrorPolicy.PROPAGATE_AND_LOG_ERRORS; @@ -464,7 +476,9 @@ public CompletableFuture send(MessageOptions options) { request.setPrompt(options.getPrompt()); request.setAttachments(options.getAttachments()); request.setMode(options.getMode()); + request.setAgentMode(options.getAgentMode()); request.setRequestHeaders(options.getRequestHeaders()); + request.setDisplayPrompt(options.getDisplayPrompt()); return rpc.invoke("session.send", request, SendMessageResponse.class).thenApply(SendMessageResponse::messageId); } @@ -497,13 +511,24 @@ public CompletableFuture send(MessageOptions options) { */ public CompletableFuture sendAndWait(MessageOptions options, long timeoutMs) { ensureNotTerminated(); + long totalNanos = System.nanoTime(); var future = new CompletableFuture(); var lastAssistantMessage = new AtomicReference(); + var firstAssistantMessageLogged = new java.util.concurrent.atomic.AtomicBoolean(false); Consumer handler = evt -> { if (evt instanceof AssistantMessageEvent msg) { lastAssistantMessage.set(msg); + if (firstAssistantMessageLogged.compareAndSet(false, true)) { + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotSession.sendAndWait first assistant message. Elapsed={Elapsed}, SessionId=" + + sessionId, + totalNanos); + } } else if (evt instanceof SessionIdleEvent) { + LoggingHelpers.logTiming(LOG, Level.FINE, + "CopilotSession.sendAndWait idle received. Elapsed={Elapsed}, SessionId=" + sessionId, + totalNanos); future.complete(lastAssistantMessage.get()); } else if (evt instanceof SessionErrorEvent errorEvent) { String message = errorEvent.getData() != null ? errorEvent.getData().message() : "session error"; @@ -568,8 +593,23 @@ public CompletableFuture sendAndWait(MessageOptions optio } if (!result.isDone()) { if (ex != null) { + if (ex instanceof TimeoutException) { + LoggingHelpers.logTiming(LOG, Level.WARNING, ex, + "CopilotSession.sendAndWait failed. Elapsed={Elapsed}, SessionId=" + sessionId + + ", CompletedBy=timeout", + totalNanos); + } else if (!(ex instanceof java.util.concurrent.CancellationException)) { + LoggingHelpers.logTiming(LOG, Level.WARNING, ex, + "CopilotSession.sendAndWait failed. Elapsed={Elapsed}, SessionId=" + sessionId + + ", CompletedBy=error", + totalNanos); + } result.completeExceptionally(ex); } else { + LoggingHelpers.logTiming( + LOG, Level.FINE, "CopilotSession.sendAndWait complete. Elapsed={Elapsed}, SessionId=" + + sessionId + ", CompletedBy=idle, AssistantMessageReceived=" + (r != null), + totalNanos); result.complete(r); } } @@ -830,7 +870,7 @@ private void executeToolAndRespondAsync(String requestId, String toolName, Strin JsonNode argumentsNode = arguments instanceof JsonNode jn ? jn : (arguments != null ? MAPPER.valueToTree(arguments) : null); - var invocation = new com.github.copilot.sdk.json.ToolInvocation().setSessionId(sessionId) + var invocation = new com.github.copilot.rpc.ToolInvocation().setSessionId(sessionId) .setToolCallId(toolCallId).setToolName(toolName).setArguments(argumentsNode); tool.handler().invoke(invocation).thenAccept(result -> { @@ -1082,9 +1122,9 @@ private void handleElicitationRequestAsync(ElicitationContext context, String re */ private void assertElicitation() { SessionCapabilities caps = capabilities; - if (caps == null || caps.getUi() == null || !Boolean.TRUE.equals(caps.getUi().getElicitation())) { + if (caps == null || caps.getUi() == null || !caps.getUi().getElicitation().orElse(false)) { throw new IllegalStateException("Elicitation is not supported by the host. " - + "Check session.getCapabilities().getUi()?.getElicitation() before calling UI methods."); + + "Check session.getCapabilities().getUi().getElicitation().orElse(false) before calling UI methods."); } } @@ -1165,10 +1205,10 @@ public CompletableFuture input(String message, InputOptions options) { field.put("title", options.getTitle()); if (options.getDescription() != null) field.put("description", options.getDescription()); - if (options.getMinLength() != null) - field.put("minLength", options.getMinLength()); - if (options.getMaxLength() != null) - field.put("maxLength", options.getMaxLength()); + if (options.getMinLength().isPresent()) + field.put("minLength", options.getMinLength().getAsInt()); + if (options.getMaxLength().isPresent()) + field.put("maxLength", options.getMaxLength().getAsInt()); if (options.getFormat() != null) field.put("format", options.getFormat()); if (options.getDefaultValue() != null) @@ -1291,6 +1331,32 @@ void registerElicitationHandler(ElicitationHandler handler) { elicitationHandler.set(handler); } + /** + * Registers an exit-plan-mode handler for this session. + *

+ * Called internally when creating or resuming a session with an exit-plan-mode + * handler. + * + * @param handler + * the handler to invoke when an exit-plan-mode request is received + */ + void registerExitPlanModeHandler(ExitPlanModeHandler handler) { + exitPlanModeHandler.set(handler); + } + + /** + * Registers an auto-mode-switch handler for this session. + *

+ * Called internally when creating or resuming a session with an + * auto-mode-switch handler. + * + * @param handler + * the handler to invoke when an auto-mode-switch request is received + */ + void registerAutoModeSwitchHandler(AutoModeSwitchHandler handler) { + autoModeSwitchHandler.set(handler); + } + /** * Sets the capabilities reported by the host for this session. *

@@ -1330,6 +1396,60 @@ CompletableFuture handleUserInputRequest(UserInputRequest req } } + /** + * Handles an exit-plan-mode request from the Copilot CLI. + *

+ * Called internally when the server sends an {@code exitPlanMode.request}. + * + * @param request + * the exit-plan-mode request + * @return a future that resolves with the user's decision + */ + CompletableFuture handleExitPlanModeRequest(ExitPlanModeRequest request) { + ExitPlanModeHandler handler = exitPlanModeHandler.get(); + if (handler == null) { + return CompletableFuture.completedFuture(new ExitPlanModeResult().setApproved(true)); + } + + try { + var invocation = new ExitPlanModeInvocation().setSessionId(sessionId); + return handler.handle(request, invocation).exceptionally(ex -> { + LOG.log(Level.SEVERE, "Exit plan mode handler threw an exception", ex); + throw new RuntimeException("Exit plan mode handler error", ex); + }); + } catch (Exception e) { + LOG.log(Level.SEVERE, "Failed to process exit plan mode request", e); + return CompletableFuture.failedFuture(e); + } + } + + /** + * Handles an auto-mode-switch request from the Copilot CLI. + *

+ * Called internally when the server sends an {@code autoModeSwitch.request}. + * + * @param request + * the auto-mode-switch request + * @return a future that resolves with the user's decision + */ + CompletableFuture handleAutoModeSwitchRequest(AutoModeSwitchRequest request) { + AutoModeSwitchHandler handler = autoModeSwitchHandler.get(); + if (handler == null) { + return CompletableFuture.completedFuture(AutoModeSwitchResponse.NO); + } + + try { + var invocation = new AutoModeSwitchInvocation().setSessionId(sessionId); + return handler.handle(request, invocation).exceptionally(ex -> { + LOG.log(Level.SEVERE, "Auto mode switch handler threw an exception", ex); + throw new RuntimeException("Auto mode switch handler error", ex); + }); + } catch (Exception e) { + LOG.log(Level.SEVERE, "Failed to process auto mode switch request", e); + return CompletableFuture.failedFuture(e); + } + } + /** * Registers hook handlers for this session. *

@@ -1346,7 +1466,7 @@ void registerHooks(SessionHooks hooks) { * Registers transform callbacks for system message sections. *

* Called internally when creating or resuming a session with - * {@link com.github.copilot.sdk.SystemMessageMode#CUSTOMIZE} and transform + * {@link com.github.copilot.SystemMessageMode#CUSTOMIZE} and transform * callbacks. * * @param callbacks @@ -1427,37 +1547,73 @@ CompletableFuture handleHooksInvoke(String hookType, JsonNode input) { case "preToolUse" : if (hooks.getOnPreToolUse() != null) { PreToolUseHookInput preInput = MAPPER.treeToValue(input, PreToolUseHookInput.class); - return hooks.getOnPreToolUse().handle(preInput, invocation) - .thenApply(output -> (Object) output); + var preResult = hooks.getOnPreToolUse().handle(preInput, invocation); + if (preResult == null) { + return CompletableFuture.completedFuture(null); + } + return preResult.thenApply(output -> (Object) output); + } + break; + case "preMcpToolCall" : + if (hooks.getOnPreMcpToolCall() != null) { + PreMcpToolCallHookInput mcpInput = MAPPER.treeToValue(input, PreMcpToolCallHookInput.class); + var mcpResult = hooks.getOnPreMcpToolCall().handle(mcpInput, invocation); + if (mcpResult == null) { + return CompletableFuture.completedFuture(null); + } + return mcpResult.thenApply(output -> (Object) output); } break; case "postToolUse" : if (hooks.getOnPostToolUse() != null) { PostToolUseHookInput postInput = MAPPER.treeToValue(input, PostToolUseHookInput.class); - return hooks.getOnPostToolUse().handle(postInput, invocation) - .thenApply(output -> (Object) output); + var postResult = hooks.getOnPostToolUse().handle(postInput, invocation); + if (postResult == null) { + return CompletableFuture.completedFuture(null); + } + return postResult.thenApply(output -> (Object) output); + } + break; + case "postToolUseFailure" : + if (hooks.getOnPostToolUseFailure() != null) { + PostToolUseFailureHookInput failureInput = MAPPER.treeToValue(input, + PostToolUseFailureHookInput.class); + var failureResult = hooks.getOnPostToolUseFailure().handle(failureInput, invocation); + if (failureResult == null) { + return CompletableFuture.completedFuture(null); + } + return failureResult.thenApply(output -> (Object) output); } break; case "userPromptSubmitted" : if (hooks.getOnUserPromptSubmitted() != null) { UserPromptSubmittedHookInput promptInput = MAPPER.treeToValue(input, UserPromptSubmittedHookInput.class); - return hooks.getOnUserPromptSubmitted().handle(promptInput, invocation) - .thenApply(output -> (Object) output); + var promptResult = hooks.getOnUserPromptSubmitted().handle(promptInput, invocation); + if (promptResult == null) { + return CompletableFuture.completedFuture(null); + } + return promptResult.thenApply(output -> (Object) output); } break; case "sessionStart" : if (hooks.getOnSessionStart() != null) { SessionStartHookInput startInput = MAPPER.treeToValue(input, SessionStartHookInput.class); - return hooks.getOnSessionStart().handle(startInput, invocation) - .thenApply(output -> (Object) output); + var startResult = hooks.getOnSessionStart().handle(startInput, invocation); + if (startResult == null) { + return CompletableFuture.completedFuture(null); + } + return startResult.thenApply(output -> (Object) output); } break; case "sessionEnd" : if (hooks.getOnSessionEnd() != null) { SessionEndHookInput endInput = MAPPER.treeToValue(input, SessionEndHookInput.class); - return hooks.getOnSessionEnd().handle(endInput, invocation) - .thenApply(output -> (Object) output); + var endResult = hooks.getOnSessionEnd().handle(endInput, invocation); + if (endResult == null) { + return CompletableFuture.completedFuture(null); + } + return endResult.thenApply(output -> (Object) output); } break; default : @@ -1541,7 +1697,7 @@ public CompletableFuture abort() { */ public CompletableFuture setModel(String model, String reasoningEffort) { ensureNotTerminated(); - return getRpc().model.switchTo(new SessionModelSwitchToParams(sessionId, model, reasoningEffort, null)) + return getRpc().model.switchTo(new SessionModelSwitchToParams(sessionId, model, reasoningEffort, null, null)) .thenApply(r -> null); } @@ -1572,14 +1728,44 @@ public CompletableFuture setModel(String model, String reasoningEffort) { * @since 1.3.0 */ public CompletableFuture setModel(String model, String reasoningEffort, - com.github.copilot.sdk.json.ModelCapabilitiesOverride modelCapabilities) { + com.github.copilot.rpc.ModelCapabilitiesOverride modelCapabilities) { + return setModel(model, reasoningEffort, null, modelCapabilities); + } + + /** + * Changes the model for this session with optional reasoning effort, reasoning + * summary mode, and capability overrides. + *

+ * The new model takes effect for the next message. Conversation history is + * preserved. + * + * @param model + * the model ID to switch to (e.g., {@code "gpt-4.1"}) + * @param reasoningEffort + * reasoning effort level; {@code null} to use default + * @param reasoningSummary + * reasoning summary mode ({@code "none"}, {@code "concise"}, or + * {@code "detailed"}); {@code null} to use default. Use + * {@code "none"} to suppress summary output regardless of whether + * reasoning is enabled. + * @param modelCapabilities + * per-property overrides for model capabilities; {@code null} to use + * runtime defaults + * @return a future that completes when the model switch is acknowledged + * @throws IllegalStateException + * if this session has been terminated + * @since 1.3.0 + */ + public CompletableFuture setModel(String model, String reasoningEffort, String reasoningSummary, + com.github.copilot.rpc.ModelCapabilitiesOverride modelCapabilities) { ensureNotTerminated(); ModelCapabilitiesOverride generatedCapabilities = null; if (modelCapabilities != null) { ModelCapabilitiesOverrideSupports supports = null; if (modelCapabilities.getSupports() != null) { var s = modelCapabilities.getSupports(); - supports = new ModelCapabilitiesOverrideSupports(s.getVision(), s.getReasoningEffort()); + supports = new ModelCapabilitiesOverrideSupports(s.getVision().orElse(null), + s.getReasoningEffort().orElse(null)); } ModelCapabilitiesOverrideLimits limits = null; if (modelCapabilities.getLimits() != null) { @@ -1588,9 +1774,11 @@ public CompletableFuture setModel(String model, String reasoningEffort, } generatedCapabilities = new ModelCapabilitiesOverride(supports, limits); } - return getRpc().model - .switchTo(new SessionModelSwitchToParams(sessionId, model, reasoningEffort, generatedCapabilities)) - .thenApply(r -> null); + var generatedReasoningSummary = reasoningSummary == null + ? null + : com.github.copilot.generated.rpc.ReasoningSummary.fromValue(reasoningSummary); + return getRpc().model.switchTo(new SessionModelSwitchToParams(sessionId, model, reasoningEffort, + generatedReasoningSummary, generatedCapabilities)).thenApply(r -> null); } /** @@ -1656,7 +1844,8 @@ public CompletableFuture log(String message, String level, Boolean ephemer rpcLevel = SessionLogLevel.INFO; } } - return getRpc().log(new SessionLogParams(sessionId, message, rpcLevel, ephemeral, url)).thenApply(r -> null); + return getRpc().log(new SessionLogParams(sessionId, message, rpcLevel, null, ephemeral, url, null)) + .thenApply(r -> null); } /** @@ -1824,6 +2013,8 @@ public void close() { permissionHandler.set(null); userInputHandler.set(null); elicitationHandler.set(null); + exitPlanModeHandler.set(null); + autoModeSwitchHandler.set(null); hooksHandler.set(null); } diff --git a/src/main/java/com/github/copilot/sdk/EventErrorHandler.java b/src/main/java/com/github/copilot/EventErrorHandler.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/EventErrorHandler.java rename to src/main/java/com/github/copilot/EventErrorHandler.java index 2ff77d9718..20510f463d 100644 --- a/src/main/java/com/github/copilot/sdk/EventErrorHandler.java +++ b/src/main/java/com/github/copilot/EventErrorHandler.java @@ -2,9 +2,9 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; -import com.github.copilot.sdk.generated.SessionEvent; +import com.github.copilot.generated.SessionEvent; /** * A handler for errors thrown by event handlers during event dispatch. diff --git a/src/main/java/com/github/copilot/sdk/EventErrorPolicy.java b/src/main/java/com/github/copilot/EventErrorPolicy.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/EventErrorPolicy.java rename to src/main/java/com/github/copilot/EventErrorPolicy.java index b7c3dca212..288af00e05 100644 --- a/src/main/java/com/github/copilot/sdk/EventErrorPolicy.java +++ b/src/main/java/com/github/copilot/EventErrorPolicy.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; /** * Controls how event dispatch behaves when an event handler throws an diff --git a/src/main/java/com/github/copilot/sdk/ExtractedTransforms.java b/src/main/java/com/github/copilot/ExtractedTransforms.java similarity index 93% rename from src/main/java/com/github/copilot/sdk/ExtractedTransforms.java rename to src/main/java/com/github/copilot/ExtractedTransforms.java index 717d873d33..bae60fc7c5 100644 --- a/src/main/java/com/github/copilot/sdk/ExtractedTransforms.java +++ b/src/main/java/com/github/copilot/ExtractedTransforms.java @@ -2,13 +2,13 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.util.Map; import java.util.concurrent.CompletableFuture; import java.util.function.Function; -import com.github.copilot.sdk.json.SystemMessageConfig; +import com.github.copilot.rpc.SystemMessageConfig; /** * Result of extracting transform callbacks from a {@link SystemMessageConfig}. diff --git a/src/main/java/com/github/copilot/InternalExecutorProvider.java b/src/main/java/com/github/copilot/InternalExecutorProvider.java new file mode 100644 index 0000000000..284965513a --- /dev/null +++ b/src/main/java/com/github/copilot/InternalExecutorProvider.java @@ -0,0 +1,60 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import java.util.concurrent.Executor; +import java.util.concurrent.ForkJoinPool; + +/** + * Resolves the {@link Executor} used by {@link CopilotClient} for internal + * asynchronous work. + * + *

+ * This is the baseline (JDK 17+) implementation. When no + * user-provided executor is supplied, it falls back to + * {@link ForkJoinPool#commonPool()}, which is shared with the rest of the JVM + * and therefore never owned by the SDK. + * + *

+ * Multi-release JAR contract. This class has a sibling variant + * at {@code src/main/java25/com/github/copilot/InternalExecutorProvider.java} + * that is compiled with {@code --release 25} into {@code META-INF/versions/25/} + * and selected automatically by the JVM on JDK 25+. Any change to the + * package-private surface of this class + * ({@link #InternalExecutorProvider(Executor) constructor}, {@link #get()}, + * {@link #canBeShutdown()}) must be mirrored in both source + * trees. The two implementations must remain behaviourally + * interchangeable from the caller's perspective; only the default-executor + * strategy and ownership semantics differ. + * + * @implNote Maintainers: when editing this file, also edit + * {@code src/main/java25/com/github/copilot/InternalExecutorProvider.java}. + * The packaged JAR is verified at build time (see the + * {@code java25-multi-release} profile in {@code pom.xml}) to ensure + * the JDK 25 overlay is present. + */ +final class InternalExecutorProvider { + + private final Executor executor; + + InternalExecutorProvider(Executor userProvided) { + if (userProvided != null) { + this.executor = userProvided; + } else { + this.executor = ForkJoinPool.commonPool(); + } + } + + Executor get() { + return executor; + } + + boolean canBeShutdown() { + // Since we are using ForkJoinPool.commonPool() or user provided only, + // we should not attempt to shut it down + return false; + } + +} diff --git a/src/main/java/com/github/copilot/sdk/JsonRpcClient.java b/src/main/java/com/github/copilot/JsonRpcClient.java similarity index 92% rename from src/main/java/com/github/copilot/sdk/JsonRpcClient.java rename to src/main/java/com/github/copilot/JsonRpcClient.java index 66ab1726df..a7cd0e120d 100644 --- a/src/main/java/com/github/copilot/sdk/JsonRpcClient.java +++ b/src/main/java/com/github/copilot/JsonRpcClient.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.io.BufferedInputStream; import java.io.IOException; @@ -28,9 +28,9 @@ import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.SerializationFeature; import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; -import com.github.copilot.sdk.json.JsonRpcError; -import com.github.copilot.sdk.json.JsonRpcRequest; -import com.github.copilot.sdk.json.JsonRpcResponse; +import com.github.copilot.rpc.JsonRpcError; +import com.github.copilot.rpc.JsonRpcRequest; +import com.github.copilot.rpc.JsonRpcResponse; /** * JSON-RPC 2.0 client implementation for communicating with the Copilot CLI. @@ -104,6 +104,7 @@ public void registerMethodHandler(String method, BiConsumer ha * Sends a JSON-RPC request and waits for the response. */ public CompletableFuture invoke(String method, Object params, Class responseType) { + long timingNanos = System.nanoTime(); long id = requestIdCounter.incrementAndGet(); var future = new CompletableFuture(); pendingRequests.put(id, future); @@ -123,13 +124,24 @@ public CompletableFuture invoke(String method, Object params, Class re return future.thenApply(result -> { try { - if (responseType == Void.class || responseType == void.class) { - return null; + T value = null; + if (responseType != Void.class && responseType != void.class) { + value = MAPPER.treeToValue(result, responseType); } - return MAPPER.treeToValue(result, responseType); + LoggingHelpers.logTiming(LOG, Level.FINE, + "JsonRpc.invoke JSON-RPC request finished. Elapsed={Elapsed}, Method=" + method + ", RequestId=" + + id + ", Status=Succeeded", + timingNanos); + return value; } catch (JsonProcessingException e) { throw new CompletionException(e); } + }).exceptionally(ex -> { + LoggingHelpers.logTiming(LOG, Level.WARNING, ex, + "JsonRpc.invoke JSON-RPC request finished. Elapsed={Elapsed}, Method=" + method + ", RequestId=" + + id + ", Status=Failed", + timingNanos); + throw ex instanceof RuntimeException re ? re : new RuntimeException(ex); }); } diff --git a/src/main/java/com/github/copilot/sdk/JsonRpcException.java b/src/main/java/com/github/copilot/JsonRpcException.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/JsonRpcException.java rename to src/main/java/com/github/copilot/JsonRpcException.java index dbc3ab77b7..1786466bdd 100644 --- a/src/main/java/com/github/copilot/sdk/JsonRpcException.java +++ b/src/main/java/com/github/copilot/JsonRpcException.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; /** * Exception thrown when a JSON-RPC error occurs during communication with the diff --git a/src/main/java/com/github/copilot/sdk/LifecycleEventManager.java b/src/main/java/com/github/copilot/LifecycleEventManager.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/LifecycleEventManager.java rename to src/main/java/com/github/copilot/LifecycleEventManager.java index 21c00e2337..673b9d10ed 100644 --- a/src/main/java/com/github/copilot/sdk/LifecycleEventManager.java +++ b/src/main/java/com/github/copilot/LifecycleEventManager.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.util.ArrayList; import java.util.List; @@ -11,8 +11,8 @@ import java.util.logging.Level; import java.util.logging.Logger; -import com.github.copilot.sdk.json.SessionLifecycleEvent; -import com.github.copilot.sdk.json.SessionLifecycleHandler; +import com.github.copilot.rpc.SessionLifecycleEvent; +import com.github.copilot.rpc.SessionLifecycleHandler; /** * Manages lifecycle event subscriptions and dispatching. diff --git a/src/main/java/com/github/copilot/LoggingHelpers.java b/src/main/java/com/github/copilot/LoggingHelpers.java new file mode 100644 index 0000000000..c80e8fb698 --- /dev/null +++ b/src/main/java/com/github/copilot/LoggingHelpers.java @@ -0,0 +1,77 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import java.util.concurrent.TimeUnit; +import java.util.logging.Level; +import java.util.logging.Logger; + +/** + * Internal helper for timing-based diagnostic logging. + */ +final class LoggingHelpers { + + private LoggingHelpers() { + // Utility class + } + + /** + * Formats elapsed time as a human-readable duration string. + * + * @param startNanos + * the start time from {@link System#nanoTime()} + * @return formatted duration (e.g. "PT0.123S") + */ + static String formatElapsed(long startNanos) { + long elapsedNanos = System.nanoTime() - startNanos; + long millis = TimeUnit.NANOSECONDS.toMillis(elapsedNanos); + return String.format("PT%d.%03dS", millis / 1000, millis % 1000); + } + + /** + * Logs a timing message at the given level if the logger accepts it. + * + * @param logger + * the logger to use + * @param level + * the log level + * @param message + * the message template + * @param startNanos + * the start time from {@link System#nanoTime()} + */ + static void logTiming(Logger logger, Level level, String message, long startNanos) { + if (!logger.isLoggable(level)) { + return; + } + logger.log(level, message.replace("{Elapsed}", formatElapsed(startNanos))); + } + + /** + * Logs a timing message at the given level with an exception. + * + * @param logger + * the logger to use + * @param level + * the log level + * @param exception + * the exception, may be {@code null} + * @param message + * the message template + * @param startNanos + * the start time from {@link System#nanoTime()} + */ + static void logTiming(Logger logger, Level level, Throwable exception, String message, long startNanos) { + if (!logger.isLoggable(level)) { + return; + } + String formatted = message.replace("{Elapsed}", formatElapsed(startNanos)); + if (exception != null) { + logger.log(level, formatted, exception); + } else { + logger.log(level, formatted); + } + } +} diff --git a/src/main/java/com/github/copilot/sdk/RpcHandlerDispatcher.java b/src/main/java/com/github/copilot/RpcHandlerDispatcher.java similarity index 65% rename from src/main/java/com/github/copilot/sdk/RpcHandlerDispatcher.java rename to src/main/java/com/github/copilot/RpcHandlerDispatcher.java index d085f7fcec..391f270dbf 100644 --- a/src/main/java/com/github/copilot/sdk/RpcHandlerDispatcher.java +++ b/src/main/java/com/github/copilot/RpcHandlerDispatcher.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.io.IOException; import java.util.ArrayList; @@ -16,15 +16,17 @@ import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PermissionRequestResultKind; -import com.github.copilot.sdk.json.SessionLifecycleEvent; -import com.github.copilot.sdk.json.SessionLifecycleEventMetadata; -import com.github.copilot.sdk.json.ToolDefinition; -import com.github.copilot.sdk.json.ToolInvocation; -import com.github.copilot.sdk.json.ToolResultObject; -import com.github.copilot.sdk.json.UserInputRequest; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.rpc.AutoModeSwitchRequest; +import com.github.copilot.rpc.ExitPlanModeRequest; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PermissionRequestResultKind; +import com.github.copilot.rpc.SessionLifecycleEvent; +import com.github.copilot.rpc.SessionLifecycleEventMetadata; +import com.github.copilot.rpc.ToolDefinition; +import com.github.copilot.rpc.ToolInvocation; +import com.github.copilot.rpc.ToolResultObject; +import com.github.copilot.rpc.UserInputRequest; /** * Dispatches incoming JSON-RPC method calls to the appropriate handlers. @@ -79,6 +81,10 @@ void registerHandlers(JsonRpcClient rpc) { (requestId, params) -> handlePermissionRequest(rpc, requestId, params)); rpc.registerMethodHandler("userInput.request", (requestId, params) -> handleUserInputRequest(rpc, requestId, params)); + rpc.registerMethodHandler("exitPlanMode.request", + (requestId, params) -> handleExitPlanModeRequest(rpc, requestId, params)); + rpc.registerMethodHandler("autoModeSwitch.request", + (requestId, params) -> handleAutoModeSwitchRequest(rpc, requestId, params)); rpc.registerMethodHandler("hooks.invoke", (requestId, params) -> handleHooksInvoke(rpc, requestId, params)); rpc.registerMethodHandler("systemMessage.transform", (requestId, params) -> handleSystemMessageTransform(rpc, requestId, params)); @@ -125,6 +131,10 @@ private void handleLifecycleEvent(JsonNode params) { private void handleToolCall(JsonRpcClient rpc, String requestId, JsonNode params) { runAsync(() -> { + final long requestIdLong = parseRequestId(requestId, "tool.call"); + if (requestIdLong == -1) { + return; + } try { String sessionId = params.get("sessionId").asText(); String toolCallId = params.get("toolCallId").asText(); @@ -133,7 +143,7 @@ private void handleToolCall(JsonRpcClient rpc, String requestId, JsonNode params CopilotSession session = sessions.get(sessionId); if (session == null) { - rpc.sendErrorResponse(Long.parseLong(requestId), -32602, "Unknown session " + sessionId); + rpc.sendErrorResponse(requestIdLong, -32602, "Unknown session " + sessionId); return; } @@ -141,7 +151,7 @@ private void handleToolCall(JsonRpcClient rpc, String requestId, JsonNode params if (tool == null || tool.handler() == null) { var result = ToolResultObject.failure("Tool '" + toolName + "' is not supported.", "tool '" + toolName + "' not supported"); - rpc.sendResponse(Long.parseLong(requestId), Map.of("result", result)); + rpc.sendResponse(requestIdLong, Map.of("result", result)); return; } @@ -157,7 +167,7 @@ private void handleToolCall(JsonRpcClient rpc, String requestId, JsonNode params toolResult = ToolResultObject .success(result instanceof String s ? s : MAPPER.writeValueAsString(result)); } - rpc.sendResponse(Long.parseLong(requestId), Map.of("result", toolResult)); + rpc.sendResponse(requestIdLong, Map.of("result", toolResult)); } catch (Exception e) { LOG.log(Level.SEVERE, "Error sending tool result", e); } @@ -166,7 +176,7 @@ private void handleToolCall(JsonRpcClient rpc, String requestId, JsonNode params var result = ToolResultObject.failure( "Invoking this tool produced an error. Detailed information is not available.", ex.getMessage()); - rpc.sendResponse(Long.parseLong(requestId), Map.of("result", result)); + rpc.sendResponse(requestIdLong, Map.of("result", result)); } catch (Exception e) { LOG.log(Level.SEVERE, "Error sending tool error", e); } @@ -175,7 +185,7 @@ private void handleToolCall(JsonRpcClient rpc, String requestId, JsonNode params } catch (Exception e) { LOG.log(Level.SEVERE, "Error handling tool call", e); try { - rpc.sendErrorResponse(Long.parseLong(requestId), -32603, e.getMessage()); + rpc.sendErrorResponse(requestIdLong, -32603, e.getMessage()); } catch (IOException ioe) { LOG.log(Level.SEVERE, "Failed to send error response", ioe); } @@ -185,6 +195,10 @@ private void handleToolCall(JsonRpcClient rpc, String requestId, JsonNode params private void handlePermissionRequest(JsonRpcClient rpc, String requestId, JsonNode params) { runAsync(() -> { + final long requestIdLong = parseRequestId(requestId, "permission.request"); + if (requestIdLong == -1) { + return; + } try { String sessionId = params.get("sessionId").asText(); JsonNode permissionRequest = params.get("permissionRequest"); @@ -193,7 +207,7 @@ private void handlePermissionRequest(JsonRpcClient rpc, String requestId, JsonNo if (session == null) { var result = new PermissionRequestResult() .setKind(PermissionRequestResultKind.DENIED_COULD_NOT_REQUEST_FROM_USER); - rpc.sendResponse(Long.parseLong(requestId), Map.of("result", result)); + rpc.sendResponse(requestIdLong, Map.of("result", result)); return; } @@ -206,7 +220,7 @@ private void handlePermissionRequest(JsonRpcClient rpc, String requestId, JsonNo throw new IllegalStateException( "Permission handlers cannot return 'no-result' when connected to a protocol v2 server."); } - rpc.sendResponse(Long.parseLong(requestId), Map.of("result", result)); + rpc.sendResponse(requestIdLong, Map.of("result", result)); } catch (IOException e) { LOG.log(Level.SEVERE, "Error sending permission result", e); } @@ -214,7 +228,7 @@ private void handlePermissionRequest(JsonRpcClient rpc, String requestId, JsonNo try { var result = new PermissionRequestResult() .setKind(PermissionRequestResultKind.DENIED_COULD_NOT_REQUEST_FROM_USER); - rpc.sendResponse(Long.parseLong(requestId), Map.of("result", result)); + rpc.sendResponse(requestIdLong, Map.of("result", result)); } catch (IOException e) { LOG.log(Level.SEVERE, "Error sending permission denied", e); } @@ -229,6 +243,10 @@ private void handlePermissionRequest(JsonRpcClient rpc, String requestId, JsonNo private void handleUserInputRequest(JsonRpcClient rpc, String requestId, JsonNode params) { LOG.fine("Received userInput.request: " + params); runAsync(() -> { + final long requestIdLong = parseRequestId(requestId, "userInput.request"); + if (requestIdLong == -1) { + return; + } try { String sessionId = params.get("sessionId").asText(); String question = params.get("question").asText(); @@ -240,7 +258,7 @@ private void handleUserInputRequest(JsonRpcClient rpc, String requestId, JsonNod LOG.fine("Found session: " + (session != null)); if (session == null) { LOG.fine("Session not found, sending error"); - rpc.sendErrorResponse(Long.parseLong(requestId), -32602, "Unknown session " + sessionId); + rpc.sendErrorResponse(requestIdLong, -32602, "Unknown session " + sessionId); return; } @@ -262,7 +280,7 @@ private void handleUserInputRequest(JsonRpcClient rpc, String requestId, JsonNod String answer = response.getAnswer() != null ? response.getAnswer() : ""; LOG.fine("Sending userInput response: answer=" + answer + ", wasFreeform=" + response.isWasFreeform()); - rpc.sendResponse(Long.parseLong(requestId), + rpc.sendResponse(requestIdLong, Map.of("answer", answer, "wasFreeform", response.isWasFreeform())); } catch (IOException e) { LOG.log(Level.SEVERE, "Error sending user input response", e); @@ -270,8 +288,7 @@ private void handleUserInputRequest(JsonRpcClient rpc, String requestId, JsonNod }).exceptionally(ex -> { LOG.log(Level.WARNING, "User input handler exception", ex); try { - rpc.sendErrorResponse(Long.parseLong(requestId), -32603, - "User input handler error: " + ex.getMessage()); + rpc.sendErrorResponse(requestIdLong, -32603, "User input handler error: " + ex.getMessage()); } catch (IOException e) { LOG.log(Level.SEVERE, "Error sending user input error", e); } @@ -283,8 +300,110 @@ private void handleUserInputRequest(JsonRpcClient rpc, String requestId, JsonNod }); } + private void handleExitPlanModeRequest(JsonRpcClient rpc, String requestId, JsonNode params) { + runAsync(() -> { + final long requestIdLong = parseRequestId(requestId, "exitPlanMode.request"); + if (requestIdLong == -1) { + return; + } + try { + String sessionId = params.get("sessionId").asText(); + + CopilotSession session = sessions.get(sessionId); + if (session == null) { + rpc.sendErrorResponse(requestIdLong, -32602, "Unknown session " + sessionId); + return; + } + + var request = new ExitPlanModeRequest(); + if (params.has("summary")) { + request.setSummary(params.get("summary").asText()); + } + if (params.has("planContent") && !params.get("planContent").isNull()) { + request.setPlanContent(params.get("planContent").asText()); + } + if (params.has("actions") && params.get("actions").isArray()) { + var actions = new ArrayList(); + for (JsonNode action : params.get("actions")) { + actions.add(action.asText()); + } + request.setActions(actions); + } + if (params.has("recommendedAction") && !params.get("recommendedAction").isNull()) { + request.setRecommendedAction(params.get("recommendedAction").asText()); + } + + session.handleExitPlanModeRequest(request).thenAccept(result -> { + try { + rpc.sendResponse(requestIdLong, MAPPER.valueToTree(result)); + } catch (IOException e) { + LOG.log(Level.SEVERE, "Error sending exit plan mode response", e); + } + }).exceptionally(ex -> { + try { + rpc.sendErrorResponse(requestIdLong, -32603, + "Exit plan mode handler error: " + ex.getMessage()); + } catch (IOException e) { + LOG.log(Level.SEVERE, "Error sending exit plan mode error", e); + } + return null; + }); + } catch (Exception e) { + LOG.log(Level.SEVERE, "Error handling exit plan mode request", e); + } + }); + } + + private void handleAutoModeSwitchRequest(JsonRpcClient rpc, String requestId, JsonNode params) { + runAsync(() -> { + final long requestIdLong = parseRequestId(requestId, "autoModeSwitch.request"); + if (requestIdLong == -1) { + return; + } + try { + String sessionId = params.get("sessionId").asText(); + + CopilotSession session = sessions.get(sessionId); + if (session == null) { + rpc.sendErrorResponse(requestIdLong, -32602, "Unknown session " + sessionId); + return; + } + + var request = new AutoModeSwitchRequest(); + if (params.has("errorCode") && !params.get("errorCode").isNull()) { + request.setErrorCode(params.get("errorCode").asText()); + } + if (params.has("retryAfterSeconds") && !params.get("retryAfterSeconds").isNull()) { + request.setRetryAfterSeconds(params.get("retryAfterSeconds").asDouble()); + } + + session.handleAutoModeSwitchRequest(request).thenAccept(response -> { + try { + rpc.sendResponse(requestIdLong, Map.of("response", response)); + } catch (IOException e) { + LOG.log(Level.SEVERE, "Error sending auto mode switch response", e); + } + }).exceptionally(ex -> { + try { + rpc.sendErrorResponse(requestIdLong, -32603, + "Auto mode switch handler error: " + ex.getMessage()); + } catch (IOException e) { + LOG.log(Level.SEVERE, "Error sending auto mode switch error", e); + } + return null; + }); + } catch (Exception e) { + LOG.log(Level.SEVERE, "Error handling auto mode switch request", e); + } + }); + } + private void handleHooksInvoke(JsonRpcClient rpc, String requestId, JsonNode params) { runAsync(() -> { + final long requestIdLong = parseRequestId(requestId, "hooks.invoke"); + if (requestIdLong == -1) { + return; + } try { String sessionId = params.get("sessionId").asText(); String hookType = params.get("hookType").asText(); @@ -292,20 +411,19 @@ private void handleHooksInvoke(JsonRpcClient rpc, String requestId, JsonNode par CopilotSession session = sessions.get(sessionId); if (session == null) { - rpc.sendErrorResponse(Long.parseLong(requestId), -32602, "Unknown session " + sessionId); + rpc.sendErrorResponse(requestIdLong, -32602, "Unknown session " + sessionId); return; } session.handleHooksInvoke(hookType, input).thenAccept(output -> { try { - rpc.sendResponse(Long.parseLong(requestId), Collections.singletonMap("output", output)); + rpc.sendResponse(requestIdLong, Collections.singletonMap("output", output)); } catch (IOException e) { LOG.log(Level.SEVERE, "Error sending hooks response", e); } }).exceptionally(ex -> { try { - rpc.sendErrorResponse(Long.parseLong(requestId), -32603, - "Hooks handler error: " + ex.getMessage()); + rpc.sendErrorResponse(requestIdLong, -32603, "Hooks handler error: " + ex.getMessage()); } catch (IOException e) { LOG.log(Level.SEVERE, "Error sending hooks error", e); } @@ -328,15 +446,11 @@ interface LifecycleEventDispatcher { private void handleSystemMessageTransform(JsonRpcClient rpc, String requestId, JsonNode params) { runAsync(() -> { + final long requestIdLong = parseRequestId(requestId, "systemMessage.transform"); + if (requestIdLong == -1) { + return; + } try { - final long requestIdLong; - try { - requestIdLong = Long.parseLong(requestId); - } catch (NumberFormatException nfe) { - LOG.log(Level.SEVERE, "Invalid requestId for systemMessage.transform: " + requestId, nfe); - return; - } - String sessionId = params.has("sessionId") ? params.get("sessionId").asText() : null; JsonNode sections = params.get("sections"); @@ -366,6 +480,25 @@ private void handleSystemMessageTransform(JsonRpcClient rpc, String requestId, J }); } + /** + * Parses a JSON-RPC request ID string into a {@code long}. + * + * @param requestId + * the request ID string received from the JSON-RPC layer + * @param methodName + * the RPC method name, used in the log message on failure + * @return the parsed request ID, or {@code -1} if the string is not a valid + * long + */ + private static long parseRequestId(String requestId, String methodName) { + try { + return Long.parseLong(requestId); + } catch (NumberFormatException nfe) { + LOG.log(Level.SEVERE, "Invalid requestId for " + methodName + ": " + requestId, nfe); + return -1; + } + } + private void runAsync(Runnable task) { try { if (executor != null) { diff --git a/src/main/java/com/github/copilot/sdk/SdkProtocolVersion.java b/src/main/java/com/github/copilot/SdkProtocolVersion.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/SdkProtocolVersion.java rename to src/main/java/com/github/copilot/SdkProtocolVersion.java index 3b00a88aee..8569b0104f 100644 --- a/src/main/java/com/github/copilot/sdk/SdkProtocolVersion.java +++ b/src/main/java/com/github/copilot/SdkProtocolVersion.java @@ -4,7 +4,7 @@ // Code generated by update-protocol-version.ts. DO NOT EDIT. -package com.github.copilot.sdk; +package com.github.copilot; /** * Provides the SDK protocol version. This must match the version expected by diff --git a/src/main/java/com/github/copilot/sdk/SessionRequestBuilder.java b/src/main/java/com/github/copilot/SessionRequestBuilder.java similarity index 73% rename from src/main/java/com/github/copilot/sdk/SessionRequestBuilder.java rename to src/main/java/com/github/copilot/SessionRequestBuilder.java index de6977ea8d..52f4e21797 100644 --- a/src/main/java/com/github/copilot/sdk/SessionRequestBuilder.java +++ b/src/main/java/com/github/copilot/SessionRequestBuilder.java @@ -2,21 +2,21 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.util.HashMap; import java.util.Map; import java.util.concurrent.CompletableFuture; import java.util.function.Function; -import com.github.copilot.sdk.json.CreateSessionRequest; -import com.github.copilot.sdk.json.CommandWireDefinition; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.ResumeSessionRequest; -import com.github.copilot.sdk.json.SectionOverride; -import com.github.copilot.sdk.json.SectionOverrideAction; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SystemMessageConfig; +import com.github.copilot.rpc.CreateSessionRequest; +import com.github.copilot.rpc.CommandWireDefinition; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.ResumeSessionRequest; +import com.github.copilot.rpc.SectionOverride; +import com.github.copilot.rpc.SectionOverrideAction; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SystemMessageConfig; /** * Builds JSON-RPC request objects from session configuration. @@ -106,25 +106,37 @@ static CreateSessionRequest buildCreateRequest(SessionConfig config, String sess request.setModel(config.getModel()); request.setClientName(config.getClientName()); request.setReasoningEffort(config.getReasoningEffort()); + request.setReasoningSummary(config.getReasoningSummary()); request.setTools(config.getTools()); request.setSystemMessage(config.getSystemMessage()); request.setAvailableTools(config.getAvailableTools()); request.setExcludedTools(config.getExcludedTools()); request.setProvider(config.getProvider()); - request.setRequestUserInput(config.getOnUserInputRequest() != null ? true : null); - request.setHooks(config.getHooks() != null && config.getHooks().hasHooks() ? true : null); + config.getEnableSessionTelemetry().ifPresent(request::setEnableSessionTelemetry); + if (config.getOnUserInputRequest() != null) { + request.setRequestUserInput(true); + } + if (config.getHooks() != null && config.getHooks().hasHooks()) { + request.setHooks(true); + } request.setWorkingDirectory(config.getWorkingDirectory()); - request.setStreaming(config.isStreaming() ? true : null); - request.setIncludeSubAgentStreamingEvents(config.getIncludeSubAgentStreamingEvents()); + if (config.isStreaming()) { + request.setStreaming(true); + } + config.getIncludeSubAgentStreamingEvents().ifPresent(request::setIncludeSubAgentStreamingEvents); request.setMcpServers(config.getMcpServers()); + request.setMcpOAuthTokenStorage(config.getMcpOAuthTokenStorage()); request.setCustomAgents(config.getCustomAgents()); request.setDefaultAgent(config.getDefaultAgent()); request.setAgent(config.getAgent()); request.setInfiniteSessions(config.getInfiniteSessions()); request.setSkillDirectories(config.getSkillDirectories()); + request.setInstructionDirectories(config.getInstructionDirectories()); + request.setPluginDirectories(config.getPluginDirectories()); + request.setLargeOutput(config.getLargeOutput()); request.setDisabledSkills(config.getDisabledSkills()); - request.setConfigDir(config.getConfigDir()); - request.setEnableConfigDiscovery(config.getEnableConfigDiscovery()); + request.setConfigDirectory(config.getConfigDirectory()); + config.getEnableConfigDiscovery().ifPresent(request::setEnableConfigDiscovery); request.setModelCapabilities(config.getModelCapabilities()); if (config.getCommands() != null && !config.getCommands().isEmpty()) { @@ -136,7 +148,18 @@ static CreateSessionRequest buildCreateRequest(SessionConfig config, String sess if (config.getOnElicitationRequest() != null) { request.setRequestElicitation(true); } + if (config.isEnableMcpApps()) { + request.setRequestMcpApps(true); + } + if (config.getOnExitPlanMode() != null) { + request.setRequestExitPlanMode(true); + } + if (config.getOnAutoModeSwitch() != null) { + request.setRequestAutoModeSwitch(true); + } request.setGitHubToken(config.getGitHubToken()); + request.setRemoteSession(config.getRemoteSession()); + request.setCloud(config.getCloud()); return request; } @@ -181,24 +204,38 @@ static ResumeSessionRequest buildResumeRequest(String sessionId, ResumeSessionCo request.setModel(config.getModel()); request.setClientName(config.getClientName()); request.setReasoningEffort(config.getReasoningEffort()); + request.setReasoningSummary(config.getReasoningSummary()); request.setTools(config.getTools()); request.setSystemMessage(config.getSystemMessage()); request.setAvailableTools(config.getAvailableTools()); request.setExcludedTools(config.getExcludedTools()); request.setProvider(config.getProvider()); - request.setRequestUserInput(config.getOnUserInputRequest() != null ? true : null); - request.setHooks(config.getHooks() != null && config.getHooks().hasHooks() ? true : null); + config.getEnableSessionTelemetry().ifPresent(request::setEnableSessionTelemetry); + if (config.getOnUserInputRequest() != null) { + request.setRequestUserInput(true); + } + if (config.getHooks() != null && config.getHooks().hasHooks()) { + request.setHooks(true); + } request.setWorkingDirectory(config.getWorkingDirectory()); - request.setConfigDir(config.getConfigDir()); - request.setEnableConfigDiscovery(config.getEnableConfigDiscovery()); - request.setDisableResume(config.isDisableResume() ? true : null); - request.setStreaming(config.isStreaming() ? true : null); - request.setIncludeSubAgentStreamingEvents(config.getIncludeSubAgentStreamingEvents()); + request.setConfigDirectory(config.getConfigDirectory()); + config.getEnableConfigDiscovery().ifPresent(request::setEnableConfigDiscovery); + if (config.isDisableResume()) { + request.setDisableResume(true); + } + if (config.isStreaming()) { + request.setStreaming(true); + } + config.getIncludeSubAgentStreamingEvents().ifPresent(request::setIncludeSubAgentStreamingEvents); request.setMcpServers(config.getMcpServers()); + request.setMcpOAuthTokenStorage(config.getMcpOAuthTokenStorage()); request.setCustomAgents(config.getCustomAgents()); request.setDefaultAgent(config.getDefaultAgent()); request.setAgent(config.getAgent()); request.setSkillDirectories(config.getSkillDirectories()); + request.setInstructionDirectories(config.getInstructionDirectories()); + request.setPluginDirectories(config.getPluginDirectories()); + request.setLargeOutput(config.getLargeOutput()); request.setDisabledSkills(config.getDisabledSkills()); request.setInfiniteSessions(config.getInfiniteSessions()); request.setModelCapabilities(config.getModelCapabilities()); @@ -212,7 +249,17 @@ static ResumeSessionRequest buildResumeRequest(String sessionId, ResumeSessionCo if (config.getOnElicitationRequest() != null) { request.setRequestElicitation(true); } + if (config.isEnableMcpApps()) { + request.setRequestMcpApps(true); + } + if (config.getOnExitPlanMode() != null) { + request.setRequestExitPlanMode(true); + } + if (config.getOnAutoModeSwitch() != null) { + request.setRequestAutoModeSwitch(true); + } request.setGitHubToken(config.getGitHubToken()); + request.setRemoteSession(config.getRemoteSession()); return request; } @@ -248,6 +295,12 @@ static void configureSession(CopilotSession session, SessionConfig config) { if (config.getOnElicitationRequest() != null) { session.registerElicitationHandler(config.getOnElicitationRequest()); } + if (config.getOnExitPlanMode() != null) { + session.registerExitPlanModeHandler(config.getOnExitPlanMode()); + } + if (config.getOnAutoModeSwitch() != null) { + session.registerAutoModeSwitchHandler(config.getOnAutoModeSwitch()); + } if (config.getOnEvent() != null) { session.on(config.getOnEvent()); } @@ -284,6 +337,12 @@ static void configureSession(CopilotSession session, ResumeSessionConfig config) if (config.getOnElicitationRequest() != null) { session.registerElicitationHandler(config.getOnElicitationRequest()); } + if (config.getOnExitPlanMode() != null) { + session.registerExitPlanModeHandler(config.getOnExitPlanMode()); + } + if (config.getOnAutoModeSwitch() != null) { + session.registerAutoModeSwitchHandler(config.getOnAutoModeSwitch()); + } if (config.getOnEvent() != null) { session.on(config.getOnEvent()); } diff --git a/src/main/java/com/github/copilot/sdk/SystemMessageMode.java b/src/main/java/com/github/copilot/SystemMessageMode.java similarity index 80% rename from src/main/java/com/github/copilot/sdk/SystemMessageMode.java rename to src/main/java/com/github/copilot/SystemMessageMode.java index 67fb5ea5e0..d693535f92 100644 --- a/src/main/java/com/github/copilot/sdk/SystemMessageMode.java +++ b/src/main/java/com/github/copilot/SystemMessageMode.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import com.fasterxml.jackson.annotation.JsonValue; @@ -13,7 +13,7 @@ * This enum determines whether to append custom instructions to the default * system message or replace it entirely. * - * @see com.github.copilot.sdk.json.SystemMessageConfig + * @see com.github.copilot.rpc.SystemMessageConfig * @since 1.0.0 */ public enum SystemMessageMode { @@ -37,10 +37,10 @@ public enum SystemMessageMode { * Override individual sections of the system prompt. *

* Use this mode with - * {@link com.github.copilot.sdk.json.SystemMessageConfig#setSections} to - * selectively replace, remove, append, prepend, or transform individual - * sections of the default system prompt. An optional {@code content} string is - * appended after all sections when provided. + * {@link com.github.copilot.rpc.SystemMessageConfig#setSections} to selectively + * replace, remove, append, prepend, or transform individual sections of the + * default system prompt. An optional {@code content} string is appended after + * all sections when provided. * * @since 1.2.0 */ diff --git a/src/main/java/com/github/copilot/sdk/package-info.java b/src/main/java/com/github/copilot/package-info.java similarity index 60% rename from src/main/java/com/github/copilot/sdk/package-info.java rename to src/main/java/com/github/copilot/package-info.java index f775d575f2..71025f07af 100644 --- a/src/main/java/com/github/copilot/sdk/package-info.java +++ b/src/main/java/com/github/copilot/package-info.java @@ -13,16 +13,16 @@ * *

Main Classes

*
    - *
  • {@link com.github.copilot.sdk.CopilotClient} - The main client for - * connecting to and communicating with the Copilot CLI. Manages the lifecycle - * of the CLI process and provides methods for creating sessions, querying - * models, and checking authentication status.
    • - *
  • {@link com.github.copilot.sdk.CopilotSession} - Represents a single + *
  • {@link com.github.copilot.CopilotClient} - The main client for connecting + * to and communicating with the Copilot CLI. Manages the lifecycle of the CLI + * process and provides methods for creating sessions, querying models, and + * checking authentication status.
    • + *
  • {@link com.github.copilot.CopilotSession} - Represents a single * conversation session with Copilot. Sessions maintain context across multiple * messages and support streaming responses, tool invocations, and event * handling.
    • - *
  • {@link com.github.copilot.sdk.JsonRpcClient} - Low-level JSON-RPC client - * for communication with the Copilot CLI process.
    • + *
  • {@link com.github.copilot.JsonRpcClient} - Low-level JSON-RPC client for + * communication with the Copilot CLI process.
    • *
* *

Quick Start

@@ -43,15 +43,15 @@ * *

Related Packages

*
    - *
  • {@link com.github.copilot.sdk.generated} - Auto-generated event types - * emitted during session processing
    • - *
  • {@link com.github.copilot.sdk.json} - Configuration and data transfer + *
  • {@link com.github.copilot.generated} - Auto-generated event types emitted + * during session processing
    • + *
  • {@link com.github.copilot.rpc} - Configuration and data transfer * objects
    • *
* - * @see com.github.copilot.sdk.CopilotClient - * @see com.github.copilot.sdk.CopilotSession - * @see GitHub + * @see com.github.copilot.CopilotClient + * @see com.github.copilot.CopilotSession + * @see GitHub * Repository */ -package com.github.copilot.sdk; +package com.github.copilot; diff --git a/src/main/java/com/github/copilot/sdk/json/AgentInfo.java b/src/main/java/com/github/copilot/rpc/AgentInfo.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/AgentInfo.java rename to src/main/java/com/github/copilot/rpc/AgentInfo.java index 1cc10a91d9..84e5126449 100644 --- a/src/main/java/com/github/copilot/sdk/json/AgentInfo.java +++ b/src/main/java/com/github/copilot/rpc/AgentInfo.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/rpc/AgentMode.java b/src/main/java/com/github/copilot/rpc/AgentMode.java new file mode 100644 index 0000000000..4a286dca3b --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/AgentMode.java @@ -0,0 +1,72 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonValue; + +/** + * The UI mode the agent is in for a given turn. + *

+ * Set on {@link MessageOptions#setAgentMode(AgentMode)} to send a message in a + * specific mode; defaults to the session's current mode when unset. + * + * @see MessageOptions + * @since 1.0.0 + */ +public enum AgentMode { + + /** The agent is responding interactively to the user. */ + INTERACTIVE("interactive"), + + /** The agent is preparing a plan before making changes. */ + PLAN("plan"), + + /** The agent is working autonomously toward task completion. */ + AUTOPILOT("autopilot"), + + /** The agent is in shell-focused UI mode. */ + SHELL("shell"); + + private final String value; + + AgentMode(String value) { + this.value = value; + } + + /** + * Returns the JSON value for this agent mode. + * + * @return the string value used in JSON serialization + */ + @JsonValue + public String getValue() { + return value; + } + + /** + * Deserializes a JSON string value into the corresponding {@code AgentMode} + * enum constant. + * + * @param value + * the JSON string value + * @return the matching {@code AgentMode}, or {@code null} if value is + * {@code null} + * @throws IllegalArgumentException + * if the value does not match any known agent mode + */ + @JsonCreator + public static AgentMode fromValue(String value) { + if (value == null) { + return null; + } + for (AgentMode mode : values()) { + if (mode.value.equals(value)) { + return mode; + } + } + throw new IllegalArgumentException("Unknown AgentMode value: " + value); + } +} diff --git a/src/main/java/com/github/copilot/sdk/json/Attachment.java b/src/main/java/com/github/copilot/rpc/Attachment.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/Attachment.java rename to src/main/java/com/github/copilot/rpc/Attachment.java index 04011d6f13..68f66af5b9 100644 --- a/src/main/java/com/github/copilot/sdk/json/Attachment.java +++ b/src/main/java/com/github/copilot/rpc/Attachment.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/rpc/AutoModeSwitchHandler.java b/src/main/java/com/github/copilot/rpc/AutoModeSwitchHandler.java new file mode 100644 index 0000000000..781088ba98 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/AutoModeSwitchHandler.java @@ -0,0 +1,48 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.concurrent.CompletableFuture; + +/** + * Handler for auto-mode-switch requests from the agent. + *

+ * Register an auto-mode-switch handler via + * {@link SessionConfig#setOnAutoModeSwitch(AutoModeSwitchHandler)} or + * {@link ResumeSessionConfig#setOnAutoModeSwitch(AutoModeSwitchHandler)}. When + * provided, the server routes {@code autoModeSwitch.request} callbacks to this + * handler. + * + *

Example Usage

+ * + * 
{@code
+ * AutoModeSwitchHandler handler = (request, invocation) -> {
+ * 	System.out.println("Rate limited: " + request.getErrorCode());
+ * 	return CompletableFuture.completedFuture(AutoModeSwitchResponse.YES);
+ * };
+ *
+ * var session = client.createSession(new SessionConfig().setOnAutoModeSwitch(handler)).get();
+ * }
+ * + * @see AutoModeSwitchRequest + * @see AutoModeSwitchResponse + * @since 1.0.8 + */ +@FunctionalInterface +public interface AutoModeSwitchHandler { + + /** + * Handles an auto-mode-switch request from the agent. + * + * @param request + * the auto-mode-switch request containing the error code and + * retry-after seconds + * @param invocation + * context information about the invocation + * @return a future that resolves with the user's decision + */ + CompletableFuture handle(AutoModeSwitchRequest request, + AutoModeSwitchInvocation invocation); +} diff --git a/src/main/java/com/github/copilot/rpc/AutoModeSwitchInvocation.java b/src/main/java/com/github/copilot/rpc/AutoModeSwitchInvocation.java new file mode 100644 index 0000000000..9dd4994a04 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/AutoModeSwitchInvocation.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +/** + * Context for an auto-mode-switch request invocation. + * + * @since 1.0.8 + */ +public class AutoModeSwitchInvocation { + + private String sessionId; + + /** + * Gets the session ID. + * + * @return the session ID + */ + public String getSessionId() { + return sessionId; + } + + /** + * Sets the session ID. + * + * @param sessionId + * the session ID + * @return this instance for method chaining + */ + public AutoModeSwitchInvocation setSessionId(String sessionId) { + this.sessionId = sessionId; + return this; + } +} diff --git a/src/main/java/com/github/copilot/rpc/AutoModeSwitchRequest.java b/src/main/java/com/github/copilot/rpc/AutoModeSwitchRequest.java new file mode 100644 index 0000000000..5b0f0d4919 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/AutoModeSwitchRequest.java @@ -0,0 +1,68 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Request to switch to auto mode after an eligible rate limit. + *

+ * This is sent by the server when the agent encounters a rate limit and wants + * to switch to an alternative model automatically. + * + * @since 1.0.8 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +public class AutoModeSwitchRequest { + + @JsonProperty("errorCode") + private String errorCode; + + @JsonProperty("retryAfterSeconds") + private Double retryAfterSeconds; + + /** + * Gets the rate-limit error code that triggered the request. + * + * @return the error code, or {@code null} + */ + public String getErrorCode() { + return errorCode; + } + + /** + * Sets the rate-limit error code. + * + * @param errorCode + * the error code + * @return this instance for method chaining + */ + public AutoModeSwitchRequest setErrorCode(String errorCode) { + this.errorCode = errorCode; + return this; + } + + /** + * Gets the seconds until the rate limit resets, when known. + * + * @return the retry-after seconds, or {@code null} + */ + public Double getRetryAfterSeconds() { + return retryAfterSeconds; + } + + /** + * Sets the seconds until the rate limit resets. + * + * @param retryAfterSeconds + * the retry-after seconds + * @return this instance for method chaining + */ + public AutoModeSwitchRequest setRetryAfterSeconds(Double retryAfterSeconds) { + this.retryAfterSeconds = retryAfterSeconds; + return this; + } +} diff --git a/src/main/java/com/github/copilot/rpc/AutoModeSwitchResponse.java b/src/main/java/com/github/copilot/rpc/AutoModeSwitchResponse.java new file mode 100644 index 0000000000..a254f9ca88 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/AutoModeSwitchResponse.java @@ -0,0 +1,40 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonValue; + +/** + * Response to an auto-mode-switch request. + * + * @since 1.0.8 + */ +public enum AutoModeSwitchResponse { + + /** Approve the switch for this rate-limit cycle. */ + YES("yes"), + + /** Approve and remember the choice for this session. */ + YES_ALWAYS("yes_always"), + + /** Decline the switch. */ + NO("no"); + + private final String value; + + AutoModeSwitchResponse(String value) { + this.value = value; + } + + /** + * Gets the wire value of this response. + * + * @return the string value + */ + @JsonValue + public String getValue() { + return value; + } +} diff --git a/src/main/java/com/github/copilot/sdk/json/AzureOptions.java b/src/main/java/com/github/copilot/rpc/AzureOptions.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/AzureOptions.java rename to src/main/java/com/github/copilot/rpc/AzureOptions.java index c2e146c196..7adbc5656b 100644 --- a/src/main/java/com/github/copilot/sdk/json/AzureOptions.java +++ b/src/main/java/com/github/copilot/rpc/AzureOptions.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/BlobAttachment.java b/src/main/java/com/github/copilot/rpc/BlobAttachment.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/BlobAttachment.java rename to src/main/java/com/github/copilot/rpc/BlobAttachment.java index d58a1e15e7..fe15293c62 100644 --- a/src/main/java/com/github/copilot/sdk/json/BlobAttachment.java +++ b/src/main/java/com/github/copilot/rpc/BlobAttachment.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/rpc/BuiltInTools.java b/src/main/java/com/github/copilot/rpc/BuiltInTools.java new file mode 100644 index 0000000000..090c362ceb --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/BuiltInTools.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.Collections; +import java.util.List; + +/** + * Curated sets of built-in tool names for common scenarios. Each constant is + * meant to be passed to {@link ToolSet#addBuiltIn(java.util.Collection)}. + * + * @since 1.3.0 + */ +public final class BuiltInTools { + + /** + * Built-in tools that operate only within the bounds of a single session β€” no + * host filesystem access outside the session, no cross-session state, no host + * environment access, no network. Safe to enable in + * {@link CopilotClientMode#EMPTY} scenarios (e.g. multi-tenant servers) without + * leaking host capabilities. + *

+ * Contract: tools in this set MUST NOT be extended (even behind options + * or args) to read or write state outside the session boundary. Adding + * cross-session or host-state behavior to one of these tools is a breaking + * change that requires removing it from this set. + */ + public static final List ISOLATED = Collections + .unmodifiableList(List.of("ask_user", "task_complete", "exit_plan_mode", "task", "read_agent", + "write_agent", "list_agents", "send_inbox", "context_board", "skill")); + + private BuiltInTools() { + // utility class + } +} diff --git a/src/main/java/com/github/copilot/rpc/CloudSessionOptions.java b/src/main/java/com/github/copilot/rpc/CloudSessionOptions.java new file mode 100644 index 0000000000..b63bfbbcd5 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/CloudSessionOptions.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Options for creating a remote session in the cloud. + * + * @since 1.5.0 + */ +@JsonInclude(JsonInclude.Include.NON_NULL) +public class CloudSessionOptions { + + @JsonProperty("repository") + private CloudSessionRepository repository; + + /** + * Gets the optional GitHub repository metadata to associate with the cloud + * session. + * + * @return the repository metadata, or {@code null} if not set + */ + public CloudSessionRepository getRepository() { + return repository; + } + + /** + * Sets the optional GitHub repository metadata to associate with the cloud + * session. + * + * @param repository + * the repository metadata + * @return this instance for method chaining + */ + public CloudSessionOptions setRepository(CloudSessionRepository repository) { + this.repository = repository; + return this; + } +} diff --git a/src/main/java/com/github/copilot/rpc/CloudSessionRepository.java b/src/main/java/com/github/copilot/rpc/CloudSessionRepository.java new file mode 100644 index 0000000000..c502693c3d --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/CloudSessionRepository.java @@ -0,0 +1,89 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * GitHub repository metadata to associate with a cloud session. + * + * @since 1.5.0 + */ +@JsonInclude(JsonInclude.Include.NON_NULL) +public class CloudSessionRepository { + + @JsonProperty("owner") + private String owner; + + @JsonProperty("name") + private String name; + + @JsonProperty("branch") + private String branch; + + /** + * Gets the repository owner. + * + * @return the repository owner + */ + public String getOwner() { + return owner; + } + + /** + * Sets the repository owner. + * + * @param owner + * the repository owner + * @return this instance for method chaining + */ + public CloudSessionRepository setOwner(String owner) { + this.owner = owner; + return this; + } + + /** + * Gets the repository name. + * + * @return the repository name + */ + public String getName() { + return name; + } + + /** + * Sets the repository name. + * + * @param name + * the repository name + * @return this instance for method chaining + */ + public CloudSessionRepository setName(String name) { + this.name = name; + return this; + } + + /** + * Gets the optional branch name. + * + * @return the branch name, or {@code null} if not set + */ + public String getBranch() { + return branch; + } + + /** + * Sets the optional branch name. + * + * @param branch + * the branch name + * @return this instance for method chaining + */ + public CloudSessionRepository setBranch(String branch) { + this.branch = branch; + return this; + } +} diff --git a/src/main/java/com/github/copilot/sdk/json/CommandContext.java b/src/main/java/com/github/copilot/rpc/CommandContext.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/CommandContext.java rename to src/main/java/com/github/copilot/rpc/CommandContext.java index 4657699bb9..ec423831b6 100644 --- a/src/main/java/com/github/copilot/sdk/json/CommandContext.java +++ b/src/main/java/com/github/copilot/rpc/CommandContext.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Context passed to a {@link CommandHandler} when a slash command is executed. diff --git a/src/main/java/com/github/copilot/sdk/json/CommandDefinition.java b/src/main/java/com/github/copilot/rpc/CommandDefinition.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/CommandDefinition.java rename to src/main/java/com/github/copilot/rpc/CommandDefinition.java index 33a6cbada5..c64c71cd9e 100644 --- a/src/main/java/com/github/copilot/sdk/json/CommandDefinition.java +++ b/src/main/java/com/github/copilot/rpc/CommandDefinition.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Defines a slash command that users can invoke from the CLI TUI. diff --git a/src/main/java/com/github/copilot/sdk/json/CommandHandler.java b/src/main/java/com/github/copilot/rpc/CommandHandler.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/CommandHandler.java rename to src/main/java/com/github/copilot/rpc/CommandHandler.java index d63955638b..1d54c9535d 100644 --- a/src/main/java/com/github/copilot/sdk/json/CommandHandler.java +++ b/src/main/java/com/github/copilot/rpc/CommandHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/CommandWireDefinition.java b/src/main/java/com/github/copilot/rpc/CommandWireDefinition.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/CommandWireDefinition.java rename to src/main/java/com/github/copilot/rpc/CommandWireDefinition.java index 2ee65c58ed..20b8d5b63d 100644 --- a/src/main/java/com/github/copilot/sdk/json/CommandWireDefinition.java +++ b/src/main/java/com/github/copilot/rpc/CommandWireDefinition.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/rpc/CopilotClientMode.java b/src/main/java/com/github/copilot/rpc/CopilotClientMode.java new file mode 100644 index 0000000000..9298f76b5d --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/CopilotClientMode.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +/** + * Selects the defaulting strategy used by + * {@link com.github.copilot.CopilotClient}. + * + * @since 1.3.0 + */ +public enum CopilotClientMode { + + /** + * Disables optional features by default. The app must explicitly opt into + * anything it needs. Required for any scenario where CLI-like ambient behavior + * is unsafe (e.g., multi-user servers). + *

+ * When this mode is selected: + *

    + *
  • The client constructor requires + * {@link CopilotClientOptions#getCopilotHome()} or + * {@link CopilotClientOptions#getCliUrl()} to be set.
    • + *
  • {@link SessionConfig#getAvailableTools()} must be supplied on every + * session β€” no tools are exposed by default.
    • + *
  • {@code session.create} always sets + * {@code toolFilterPrecedence: "excluded"} so the allowlist and denylist + * compose naturally.
    • + *
  • The SDK injects safe defaults for ambient session features (telemetry, + * custom instructions, plugins, environment context, etc.).
    • + *
+ */ + EMPTY, + + /** + * Uses defaults equivalent to GitHub Copilot CLI. The default. Useful when + * building a coding agent that shares sessions with Copilot CLI. + *

+ * Do not use this mode for server-based multi-user applications β€” the + * default coding agent has tools and capabilities that operate across sessions + * and can access the host OS environment. + */ + COPILOT_CLI +} diff --git a/src/main/java/com/github/copilot/sdk/json/CopilotClientOptions.java b/src/main/java/com/github/copilot/rpc/CopilotClientOptions.java similarity index 70% rename from src/main/java/com/github/copilot/sdk/json/CopilotClientOptions.java rename to src/main/java/com/github/copilot/rpc/CopilotClientOptions.java index 3a14d17335..9414670597 100644 --- a/src/main/java/com/github/copilot/sdk/json/CopilotClientOptions.java +++ b/src/main/java/com/github/copilot/rpc/CopilotClientOptions.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Arrays; import java.util.HashMap; @@ -14,10 +14,13 @@ import java.util.function.Supplier; import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.Optional; +import java.util.OptionalInt; /** * Configuration options for creating a - * {@link com.github.copilot.sdk.CopilotClient}. + * {@link com.github.copilot.CopilotClient}. *

* This class provides a fluent API for configuring how the client connects to * and manages the Copilot CLI server. All setter methods return {@code this} @@ -32,7 +35,7 @@ * var client = new CopilotClient(options); * } * - * @see com.github.copilot.sdk.CopilotClient + * @see com.github.copilot.CopilotClient * @since 1.0.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) @@ -44,15 +47,19 @@ public class CopilotClientOptions { private String[] cliArgs; private String cliPath; private String cliUrl; + private String copilotHome; private String cwd; private Map environment; private Executor executor; private String gitHubToken; private String logLevel = "info"; + private CopilotClientMode mode = CopilotClientMode.COPILOT_CLI; private Supplier>> onListModels; private int port; private TelemetryConfig telemetry; private Integer sessionIdleTimeoutSeconds; + private boolean remote; + private String tcpConnectionToken; private Boolean useLoggedInUser; private boolean useStdio = true; @@ -191,6 +198,37 @@ public CopilotClientOptions setCliUrl(String cliUrl) { return this; } + /** + * Gets the base directory for Copilot data (session state, config, etc.). + * + * @return the Copilot home directory path, or {@code null} to use the CLI + * default ({@code ~/.copilot}) + */ + public String getCopilotHome() { + return copilotHome; + } + + /** + * Sets the base directory for Copilot data (session state, config, etc.). + *

+ * Sets the {@code COPILOT_HOME} environment variable on the spawned CLI + * process. When {@code null}, the {@code COPILOT_HOME} env var is not set on + * the spawned process, so the CLI falls back to its default + * ({@code ~/.copilot}). + *

+ * This option is only used when the SDK spawns the CLI process; it is ignored + * when connecting to an external server via {@link #setCliUrl(String)}. + * + * @param copilotHome + * the Copilot home directory path, or {@code null} to use the CLI + * default + * @return this options instance for method chaining + */ + public CopilotClientOptions setCopilotHome(String copilotHome) { + this.copilotHome = copilotHome; + return this; + } + /** * Gets the working directory for the CLI process. * @@ -250,9 +288,11 @@ public CopilotClientOptions setEnvironment(Map environment) { /** * Gets the executor used for internal asynchronous operations. + *

+ * Returns {@code null} if no executor has been explicitly set, indicating that + * the SDK should use its default executor strategy. * - * @return the executor, or {@code null} to use the default - * {@code ForkJoinPool.commonPool()} + * @return the executor, or {@code null} if using SDK defaults */ public Executor getExecutor() { return executor; @@ -262,15 +302,18 @@ public Executor getExecutor() { * Sets the executor used for internal asynchronous operations. *

* When provided, the SDK uses this executor for all internal - * {@code CompletableFuture} combinators instead of the default - * {@code ForkJoinPool.commonPool()}. This allows callers to isolate SDK work - * onto a dedicated thread pool or integrate with container-managed threading. + * {@code CompletableFuture} combinators. This allows callers to isolate SDK + * work onto a dedicated thread pool or integrate with container-managed + * threading. *

- * Passing {@code null} reverts to the default {@code ForkJoinPool.commonPool()} - * behavior. + * The SDK will not shut down a user-provided executor. If you pass a custom + * {@code ExecutorService}, you remain responsible for shutting it down. + *

+ * If not set (or set to {@code null}), the SDK uses its default executor: + * virtual threads on JDK 25+, {@code ForkJoinPool.commonPool()} on older JDKs. * * @param executor - * the executor to use, or {@code null} for the default + * the executor to use, or {@code null} for SDK defaults * @return this options instance for fluent chaining */ public CopilotClientOptions setExecutor(Executor executor) { @@ -354,6 +397,35 @@ public CopilotClientOptions setLogLevel(String logLevel) { return this; } + /** + * Gets the SDK defaulting strategy. + * + * @return the client mode (never {@code null}) + * @since 1.3.0 + */ + public CopilotClientMode getMode() { + return mode; + } + + /** + * Sets the SDK defaulting strategy. + *

+ * When set to {@link CopilotClientMode#EMPTY}, the SDK validates that the app + * has supplied the required configuration (e.g. + * {@link #setCopilotHome(String)}) and translates session creation requests + * into runtime options that flip tool filter precedence to + * {@code excluded}-wins so exclusions are expressible. + * + * @param mode + * the client mode + * @return this options instance for method chaining + * @since 1.3.0 + */ + public CopilotClientOptions setMode(CopilotClientMode mode) { + this.mode = Objects.requireNonNull(mode, "mode must not be null"); + return this; + } + /** * Gets the custom handler for listing available models. * @@ -405,6 +477,37 @@ public CopilotClientOptions setPort(int port) { return this; } + /** + * Returns whether remote session support (Mission Control integration) is + * enabled. + *

+ * When {@code true}, sessions in a GitHub repository working directory are + * accessible from GitHub web and mobile. + * + * @return {@code true} if remote sessions are enabled + */ + public boolean isRemote() { + return remote; + } + + /** + * Enables remote session support (Mission Control integration). + *

+ * When {@code true}, sessions in a GitHub repository working directory are + * accessible from GitHub web and mobile. + *

+ * This option is only used when the SDK spawns the CLI process; it is ignored + * when connecting to an external server via {@link #setCliUrl(String)}. + * + * @param remote + * {@code true} to enable remote sessions + * @return this options instance for method chaining + */ + public CopilotClientOptions setRemote(boolean remote) { + this.remote = remote; + return this; + } + /** * Gets the OpenTelemetry configuration for the CLI server. * @@ -434,42 +537,80 @@ public CopilotClientOptions setTelemetry(TelemetryConfig telemetry) { /** * Gets the server-wide idle timeout for sessions in seconds. * - * @return the session idle timeout in seconds, or {@code null} to disable - * (sessions live indefinitely) + * @return an {@link OptionalInt} containing the session idle timeout in + * seconds, or {@link java.util.OptionalInt#empty()} if not set. Use + * {@link #clearSessionIdleTimeoutSeconds()} to revert to the default. * @since 1.3.0 */ - public Integer getSessionIdleTimeoutSeconds() { - return sessionIdleTimeoutSeconds; + @JsonIgnore + public OptionalInt getSessionIdleTimeoutSeconds() { + return sessionIdleTimeoutSeconds == null ? OptionalInt.empty() : OptionalInt.of(sessionIdleTimeoutSeconds); } /** * Sets the server-wide idle timeout for sessions in seconds. *

* Sessions without activity for this duration are automatically cleaned up. Set - * to {@code 0} or leave as {@code null} to disable (sessions live - * indefinitely). + * to {@code 0} to disable (sessions live indefinitely). Use + * {@link #clearSessionIdleTimeoutSeconds()} to revert to the default. *

* This option is only used when the SDK spawns the CLI process; it is ignored * when connecting to an external server via {@link #setCliUrl(String)}. * * @param sessionIdleTimeoutSeconds - * the idle timeout in seconds, or {@code null} to disable + * the idle timeout in seconds * @return this options instance for method chaining * @since 1.3.0 */ - public CopilotClientOptions setSessionIdleTimeoutSeconds(Integer sessionIdleTimeoutSeconds) { + public CopilotClientOptions setSessionIdleTimeoutSeconds(int sessionIdleTimeoutSeconds) { this.sessionIdleTimeoutSeconds = sessionIdleTimeoutSeconds; return this; } + /** + * Clears the sessionIdleTimeoutSeconds setting, reverting to the default + * behavior. + * + * @return this instance for method chaining + */ + public CopilotClientOptions clearSessionIdleTimeoutSeconds() { + this.sessionIdleTimeoutSeconds = null; + return this; + } + + /** + * Gets the connection token for the headless CLI server (TCP only). + * + * @return the connection token, or {@code null} if not set + */ + public String getTcpConnectionToken() { + return tcpConnectionToken; + } + + /** + * Sets the connection token for the headless CLI server (TCP only). + *

+ * When the SDK spawns its own CLI in TCP mode and this is omitted, a UUID is + * generated automatically so the loopback listener is safe by default. Cannot + * be combined with {@link #setUseStdio(boolean)} = {@code true}. + * + * @param tcpConnectionToken + * the connection token (must not be {@code null} or empty) + * @return this options instance for method chaining + */ + public CopilotClientOptions setTcpConnectionToken(String tcpConnectionToken) { + this.tcpConnectionToken = Objects.requireNonNull(tcpConnectionToken, "tcpConnectionToken must not be null"); + return this; + } + /** * Returns whether to use the logged-in user for authentication. * - * @return {@code true} to use logged-in user auth, {@code false} to use only - * explicit tokens, or {@code null} to use default behavior + * @return an {@link Optional} containing the boolean value, or empty if not set */ - public Boolean getUseLoggedInUser() { - return useLoggedInUser; + @JsonIgnore + public Optional getUseLoggedInUser() { + return Optional.ofNullable(useLoggedInUser); } /** @@ -479,15 +620,23 @@ public Boolean getUseLoggedInUser() { * auth. When false, only explicit tokens (gitHubToken or environment variables) * are used. Default: true (but defaults to false when gitHubToken is provided). *

- * Passing {@code null} is equivalent to passing {@link Boolean#FALSE}. * * @param useLoggedInUser - * {@code true} to use logged-in user auth, {@code false} or - * {@code null} otherwise + * {@code true} to use logged-in user auth, {@code false} otherwise * @return this options instance for method chaining */ - public CopilotClientOptions setUseLoggedInUser(Boolean useLoggedInUser) { - this.useLoggedInUser = useLoggedInUser != null ? useLoggedInUser : Boolean.FALSE; + public CopilotClientOptions setUseLoggedInUser(boolean useLoggedInUser) { + this.useLoggedInUser = useLoggedInUser; + return this; + } + + /** + * Clears the useLoggedInUser setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public CopilotClientOptions clearUseLoggedInUser() { + this.useLoggedInUser = null; return this; } @@ -533,6 +682,7 @@ public CopilotClientOptions clone() { copy.cliArgs = this.cliArgs != null ? this.cliArgs.clone() : null; copy.cliPath = this.cliPath; copy.cliUrl = this.cliUrl; + copy.copilotHome = this.copilotHome; copy.cwd = this.cwd; copy.environment = this.environment != null ? new java.util.HashMap<>(this.environment) : null; copy.executor = this.executor; @@ -540,7 +690,9 @@ public CopilotClientOptions clone() { copy.logLevel = this.logLevel; copy.onListModels = this.onListModels; copy.port = this.port; + copy.remote = this.remote; copy.sessionIdleTimeoutSeconds = this.sessionIdleTimeoutSeconds; + copy.tcpConnectionToken = this.tcpConnectionToken; copy.telemetry = this.telemetry; copy.useLoggedInUser = this.useLoggedInUser; copy.useStdio = this.useStdio; diff --git a/src/main/java/com/github/copilot/sdk/json/CreateSessionRequest.java b/src/main/java/com/github/copilot/rpc/CreateSessionRequest.java similarity index 60% rename from src/main/java/com/github/copilot/sdk/json/CreateSessionRequest.java rename to src/main/java/com/github/copilot/rpc/CreateSessionRequest.java index ef8d5fda2d..b8dddbec77 100644 --- a/src/main/java/com/github/copilot/sdk/json/CreateSessionRequest.java +++ b/src/main/java/com/github/copilot/rpc/CreateSessionRequest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; @@ -15,10 +15,9 @@ * Internal request object for creating a new session. *

* This is a low-level class for JSON-RPC communication. For creating sessions, - * use - * {@link com.github.copilot.sdk.CopilotClient#createSession(SessionConfig)}. + * use {@link com.github.copilot.CopilotClient#createSession(SessionConfig)}. * - * @see com.github.copilot.sdk.CopilotClient#createSession(SessionConfig) + * @see com.github.copilot.CopilotClient#createSession(SessionConfig) * @see SessionConfig * @since 1.0.0 */ @@ -37,6 +36,9 @@ public final class CreateSessionRequest { @JsonProperty("reasoningEffort") private String reasoningEffort; + @JsonProperty("reasoningSummary") + private String reasoningSummary; + @JsonProperty("tools") private List tools; @@ -49,9 +51,15 @@ public final class CreateSessionRequest { @JsonProperty("excludedTools") private List excludedTools; + @JsonProperty("toolFilterPrecedence") + private String toolFilterPrecedence; + @JsonProperty("provider") private ProviderConfig provider; + @JsonProperty("enableSessionTelemetry") + private Boolean enableSessionTelemetry; + @JsonProperty("requestPermission") private Boolean requestPermission; @@ -73,6 +81,9 @@ public final class CreateSessionRequest { @JsonProperty("mcpServers") private Map mcpServers; + @JsonProperty("mcpOAuthTokenStorage") + private String mcpOAuthTokenStorage; + @JsonProperty("envValueMode") private String envValueMode; @@ -91,11 +102,20 @@ public final class CreateSessionRequest { @JsonProperty("skillDirectories") private List skillDirectories; + @JsonProperty("instructionDirectories") + private List instructionDirectories; + + @JsonProperty("pluginDirectories") + private List pluginDirectories; + + @JsonProperty("largeOutput") + private LargeToolOutputConfig largeOutput; + @JsonProperty("disabledSkills") private List disabledSkills; @JsonProperty("configDir") - private String configDir; + private String configDirectory; @JsonProperty("enableConfigDiscovery") private Boolean enableConfigDiscovery; @@ -106,12 +126,27 @@ public final class CreateSessionRequest { @JsonProperty("requestElicitation") private Boolean requestElicitation; + @JsonProperty("requestMcpApps") + private Boolean requestMcpApps; + + @JsonProperty("requestExitPlanMode") + private Boolean requestExitPlanMode; + + @JsonProperty("requestAutoModeSwitch") + private Boolean requestAutoModeSwitch; + @JsonProperty("modelCapabilities") private ModelCapabilitiesOverride modelCapabilities; @JsonProperty("gitHubToken") private String gitHubToken; + @JsonProperty("remoteSession") + private String remoteSession; + + @JsonProperty("cloud") + private CloudSessionOptions cloud; + /** Gets the model name. @return the model */ public String getModel() { return model; @@ -154,6 +189,19 @@ public void setReasoningEffort(String reasoningEffort) { this.reasoningEffort = reasoningEffort; } + /** Gets the reasoning summary mode. @return the reasoning summary mode */ + public String getReasoningSummary() { + return reasoningSummary; + } + + /** + * Sets the reasoning summary mode. @param reasoningSummary the reasoning + * summary mode + */ + public void setReasoningSummary(String reasoningSummary) { + this.reasoningSummary = reasoningSummary; + } + /** Gets the tools. @return the tool definitions */ public List getTools() { return tools == null ? null : Collections.unmodifiableList(tools); @@ -194,6 +242,19 @@ public void setExcludedTools(List excludedTools) { this.excludedTools = excludedTools; } + /** Gets the tool filter precedence. @return the precedence value */ + public String getToolFilterPrecedence() { + return toolFilterPrecedence; + } + + /** + * Sets the tool filter precedence. @param toolFilterPrecedence the precedence + * ("excluded" or null) + */ + public void setToolFilterPrecedence(String toolFilterPrecedence) { + this.toolFilterPrecedence = toolFilterPrecedence; + } + /** Gets the provider config. @return the provider */ public ProviderConfig getProvider() { return provider; @@ -204,36 +265,76 @@ public void setProvider(ProviderConfig provider) { this.provider = provider; } + /** Gets enable session telemetry flag. @return the flag */ + public Boolean getEnableSessionTelemetry() { + return enableSessionTelemetry; + } + + /** + * Sets enable session telemetry flag. @param enableSessionTelemetry the flag + */ + public void setEnableSessionTelemetry(boolean enableSessionTelemetry) { + this.enableSessionTelemetry = enableSessionTelemetry; + } + + /** + * Clears the enableSessionTelemetry setting, reverting to the default behavior. + */ + public void clearEnableSessionTelemetry() { + this.enableSessionTelemetry = null; + } + /** Gets request permission flag. @return the flag */ public Boolean getRequestPermission() { return requestPermission; } /** Sets request permission flag. @param requestPermission the flag */ - public void setRequestPermission(Boolean requestPermission) { + public void setRequestPermission(boolean requestPermission) { this.requestPermission = requestPermission; } + /** + * Clears the requestPermission setting, reverting to the default behavior. + */ + public void clearRequestPermission() { + this.requestPermission = null; + } + /** Gets request user input flag. @return the flag */ public Boolean getRequestUserInput() { return requestUserInput; } /** Sets request user input flag. @param requestUserInput the flag */ - public void setRequestUserInput(Boolean requestUserInput) { + public void setRequestUserInput(boolean requestUserInput) { this.requestUserInput = requestUserInput; } + /** + * Clears the requestUserInput setting, reverting to the default behavior. + */ + public void clearRequestUserInput() { + this.requestUserInput = null; + } + /** Gets hooks flag. @return the flag */ public Boolean getHooks() { return hooks; } /** Sets hooks flag. @param hooks the flag */ - public void setHooks(Boolean hooks) { + public void setHooks(boolean hooks) { this.hooks = hooks; } + /** + * Clears the hooks setting, reverting to the default behavior. + */ + public void clearHooks() { + this.hooks = null; + } + /** Gets working directory. @return the working directory */ public String getWorkingDirectory() { return workingDirectory; @@ -250,10 +351,17 @@ public Boolean getStreaming() { } /** Sets streaming flag. @param streaming the flag */ - public void setStreaming(Boolean streaming) { + public void setStreaming(boolean streaming) { this.streaming = streaming; } + /** + * Clears the streaming setting, reverting to the default behavior. + */ + public void clearStreaming() { + this.streaming = null; + } + /** Gets MCP servers. @return the servers map */ public Map getMcpServers() { return mcpServers == null ? null : Collections.unmodifiableMap(mcpServers); @@ -264,6 +372,19 @@ public void setMcpServers(Map mcpServers) { this.mcpServers = mcpServers; } + /** Gets MCP OAuth token storage mode. @return the storage mode */ + public String getMcpOAuthTokenStorage() { + return mcpOAuthTokenStorage; + } + + /** + * Sets MCP OAuth token storage mode. @param mcpOAuthTokenStorage the storage + * mode + */ + public void setMcpOAuthTokenStorage(String mcpOAuthTokenStorage) { + this.mcpOAuthTokenStorage = mcpOAuthTokenStorage; + } + /** Gets MCP environment variable value mode. @return the mode */ public String getEnvValueMode() { return envValueMode; @@ -326,6 +447,38 @@ public void setSkillDirectories(List skillDirectories) { this.skillDirectories = skillDirectories; } + /** Gets instruction directories. @return the instruction directories */ + public List getInstructionDirectories() { + return instructionDirectories == null ? null : Collections.unmodifiableList(instructionDirectories); + } + + /** + * Sets instruction directories. @param instructionDirectories the directories + */ + public void setInstructionDirectories(List instructionDirectories) { + this.instructionDirectories = instructionDirectories; + } + + /** Gets plugin directories. @return the plugin directories */ + public List getPluginDirectories() { + return pluginDirectories == null ? null : Collections.unmodifiableList(pluginDirectories); + } + + /** Sets plugin directories. @param pluginDirectories the directories */ + public void setPluginDirectories(List pluginDirectories) { + this.pluginDirectories = pluginDirectories; + } + + /** Gets large output config. @return the large output config */ + public LargeToolOutputConfig getLargeOutput() { + return largeOutput; + } + + /** Sets large output config. @param largeOutput the large output config */ + public void setLargeOutput(LargeToolOutputConfig largeOutput) { + this.largeOutput = largeOutput; + } + /** Gets disabled skills. @return the disabled skill names */ public List getDisabledSkills() { return disabledSkills == null ? null : Collections.unmodifiableList(disabledSkills); @@ -337,13 +490,13 @@ public void setDisabledSkills(List disabledSkills) { } /** Gets config directory. @return the config directory path */ - public String getConfigDir() { - return configDir; + public String getConfigDirectory() { + return configDirectory; } - /** Sets config directory. @param configDir the config directory path */ - public void setConfigDir(String configDir) { - this.configDir = configDir; + /** Sets config directory. @param configDirectory the config directory path */ + public void setConfigDirectory(String configDirectory) { + this.configDirectory = configDirectory; } /** Gets enable config discovery flag. @return the flag */ @@ -352,10 +505,17 @@ public Boolean getEnableConfigDiscovery() { } /** Sets enable config discovery flag. @param enableConfigDiscovery the flag */ - public void setEnableConfigDiscovery(Boolean enableConfigDiscovery) { + public void setEnableConfigDiscovery(boolean enableConfigDiscovery) { this.enableConfigDiscovery = enableConfigDiscovery; } + /** + * Clears the enableConfigDiscovery setting, reverting to the default behavior. + */ + public void clearEnableConfigDiscovery() { + this.enableConfigDiscovery = null; + } + /** Gets include sub-agent streaming events flag. @return the flag */ public Boolean getIncludeSubAgentStreamingEvents() { return includeSubAgentStreamingEvents; @@ -365,10 +525,18 @@ public Boolean getIncludeSubAgentStreamingEvents() { * Sets include sub-agent streaming events flag. @param * includeSubAgentStreamingEvents the flag */ - public void setIncludeSubAgentStreamingEvents(Boolean includeSubAgentStreamingEvents) { + public void setIncludeSubAgentStreamingEvents(boolean includeSubAgentStreamingEvents) { this.includeSubAgentStreamingEvents = includeSubAgentStreamingEvents; } + /** + * Clears the includeSubAgentStreamingEvents setting, reverting to the default + * behavior. + */ + public void clearIncludeSubAgentStreamingEvents() { + this.includeSubAgentStreamingEvents = null; + } + /** Gets the commands wire definitions. @return the commands */ public List getCommands() { return commands == null ? null : Collections.unmodifiableList(commands); @@ -385,10 +553,54 @@ public Boolean getRequestElicitation() { } /** Sets the requestElicitation flag. @param requestElicitation the flag */ - public void setRequestElicitation(Boolean requestElicitation) { + public void setRequestElicitation(boolean requestElicitation) { this.requestElicitation = requestElicitation; } + /** + * Clears the requestElicitation setting, reverting to the default behavior. + */ + public void clearRequestElicitation() { + this.requestElicitation = null; + } + + /** Gets the requestMcpApps flag. @return the flag */ + public Boolean getRequestMcpApps() { + return requestMcpApps; + } + + /** Sets the requestMcpApps flag. @param requestMcpApps the flag */ + public void setRequestMcpApps(boolean requestMcpApps) { + this.requestMcpApps = requestMcpApps; + } + + /** Clears the requestMcpApps setting, reverting to the default behavior. */ + public void clearRequestMcpApps() { + this.requestMcpApps = null; + } + + /** Gets the requestExitPlanMode flag. @return the flag */ + public Boolean getRequestExitPlanMode() { + return requestExitPlanMode; + } + + /** Sets the requestExitPlanMode flag. @param requestExitPlanMode the flag */ + public void setRequestExitPlanMode(Boolean requestExitPlanMode) { + this.requestExitPlanMode = requestExitPlanMode; + } + + /** Gets the requestAutoModeSwitch flag. @return the flag */ + public Boolean getRequestAutoModeSwitch() { + return requestAutoModeSwitch; + } + + /** + * Sets the requestAutoModeSwitch flag. @param requestAutoModeSwitch the flag + */ + public void setRequestAutoModeSwitch(Boolean requestAutoModeSwitch) { + this.requestAutoModeSwitch = requestAutoModeSwitch; + } + /** Gets the model capabilities override. @return the override */ public ModelCapabilitiesOverride getModelCapabilities() { return modelCapabilities; @@ -413,4 +625,26 @@ public String getGitHubToken() { public void setGitHubToken(String gitHubToken) { this.gitHubToken = gitHubToken; } + + /** Gets the remote session mode. @return the remote session mode */ + public String getRemoteSession() { + return remoteSession; + } + + /** + * Sets the remote session mode. @param remoteSession the remote session mode + */ + public void setRemoteSession(String remoteSession) { + this.remoteSession = remoteSession; + } + + /** Gets the cloud session options. @return the cloud session options */ + public CloudSessionOptions getCloud() { + return cloud; + } + + /** Sets the cloud session options. @param cloud the cloud session options */ + public void setCloud(CloudSessionOptions cloud) { + this.cloud = cloud; + } } diff --git a/src/main/java/com/github/copilot/sdk/json/CreateSessionResponse.java b/src/main/java/com/github/copilot/rpc/CreateSessionResponse.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/CreateSessionResponse.java rename to src/main/java/com/github/copilot/rpc/CreateSessionResponse.java index b47af050bc..e109267692 100644 --- a/src/main/java/com/github/copilot/sdk/json/CreateSessionResponse.java +++ b/src/main/java/com/github/copilot/rpc/CreateSessionResponse.java @@ -1,4 +1,4 @@ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/CustomAgentConfig.java b/src/main/java/com/github/copilot/rpc/CustomAgentConfig.java similarity index 82% rename from src/main/java/com/github/copilot/sdk/json/CustomAgentConfig.java rename to src/main/java/com/github/copilot/rpc/CustomAgentConfig.java index 1421db603f..5136f77786 100644 --- a/src/main/java/com/github/copilot/sdk/json/CustomAgentConfig.java +++ b/src/main/java/com/github/copilot/rpc/CustomAgentConfig.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; @@ -10,6 +10,8 @@ import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.Optional; /** * Configuration for a custom agent in a Copilot session. @@ -58,6 +60,9 @@ public class CustomAgentConfig { @JsonProperty("skills") private List skills; + @JsonProperty("model") + private String model; + /** * Gets the unique identifier name for this agent. * @@ -197,10 +202,12 @@ public CustomAgentConfig setMcpServers(Map mcpServers) /** * Gets whether inference mode is enabled. * - * @return the infer flag, or {@code null} if not set + * @return an {@link java.util.Optional} containing the infer flag, or + * {@link java.util.Optional#empty()} if not set */ - public Boolean getInfer() { - return infer; + @JsonIgnore + public Optional getInfer() { + return Optional.ofNullable(infer); } /** @@ -210,11 +217,21 @@ public Boolean getInfer() { * {@code true} to enable inference mode * @return this config for method chaining */ - public CustomAgentConfig setInfer(Boolean infer) { + public CustomAgentConfig setInfer(boolean infer) { this.infer = infer; return this; } + /** + * Clears the infer setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public CustomAgentConfig clearInfer() { + this.infer = null; + return this; + } + /** * Gets the list of skill names to preload into this agent's context. * @@ -241,4 +258,28 @@ public CustomAgentConfig setSkills(List skills) { this.skills = skills; return this; } + + /** + * Gets the model identifier for this agent. + * + * @return the model identifier, or {@code null} if not set + */ + public String getModel() { + return model; + } + + /** + * Sets the model identifier for this agent. + *

+ * When set, the runtime will attempt to use this model for the agent, falling + * back to the parent session model if unavailable. + * + * @param model + * the model identifier (e.g., "claude-haiku-4.5") + * @return this config for method chaining + */ + public CustomAgentConfig setModel(String model) { + this.model = model; + return this; + } } diff --git a/src/main/java/com/github/copilot/sdk/json/DefaultAgentConfig.java b/src/main/java/com/github/copilot/rpc/DefaultAgentConfig.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/DefaultAgentConfig.java rename to src/main/java/com/github/copilot/rpc/DefaultAgentConfig.java index 88f39ecff9..4be5dbbb9b 100644 --- a/src/main/java/com/github/copilot/sdk/json/DefaultAgentConfig.java +++ b/src/main/java/com/github/copilot/rpc/DefaultAgentConfig.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; diff --git a/src/main/java/com/github/copilot/sdk/json/DeleteSessionResponse.java b/src/main/java/com/github/copilot/rpc/DeleteSessionResponse.java similarity index 89% rename from src/main/java/com/github/copilot/sdk/json/DeleteSessionResponse.java rename to src/main/java/com/github/copilot/rpc/DeleteSessionResponse.java index 1f53dfac3a..33e7091830 100644 --- a/src/main/java/com/github/copilot/sdk/json/DeleteSessionResponse.java +++ b/src/main/java/com/github/copilot/rpc/DeleteSessionResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; @@ -13,7 +13,7 @@ * This is a low-level class for JSON-RPC communication containing the result of * a session deletion operation. * - * @see com.github.copilot.sdk.CopilotClient#deleteSession(String) + * @see com.github.copilot.CopilotClient#deleteSession(String) * @since 1.0.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) diff --git a/src/main/java/com/github/copilot/sdk/json/ElicitationContext.java b/src/main/java/com/github/copilot/rpc/ElicitationContext.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/ElicitationContext.java rename to src/main/java/com/github/copilot/rpc/ElicitationContext.java index 87687b1940..84c870e93a 100644 --- a/src/main/java/com/github/copilot/sdk/json/ElicitationContext.java +++ b/src/main/java/com/github/copilot/rpc/ElicitationContext.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Context for an elicitation request received from the server or MCP tools. diff --git a/src/main/java/com/github/copilot/sdk/json/ElicitationHandler.java b/src/main/java/com/github/copilot/rpc/ElicitationHandler.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/ElicitationHandler.java rename to src/main/java/com/github/copilot/rpc/ElicitationHandler.java index d0a0d06163..ed62d1248f 100644 --- a/src/main/java/com/github/copilot/sdk/json/ElicitationHandler.java +++ b/src/main/java/com/github/copilot/rpc/ElicitationHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/ElicitationParams.java b/src/main/java/com/github/copilot/rpc/ElicitationParams.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/ElicitationParams.java rename to src/main/java/com/github/copilot/rpc/ElicitationParams.java index 8bd81022e0..273681bba9 100644 --- a/src/main/java/com/github/copilot/sdk/json/ElicitationParams.java +++ b/src/main/java/com/github/copilot/rpc/ElicitationParams.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Parameters for an elicitation request sent from the SDK to the host. diff --git a/src/main/java/com/github/copilot/sdk/json/ElicitationResult.java b/src/main/java/com/github/copilot/rpc/ElicitationResult.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/ElicitationResult.java rename to src/main/java/com/github/copilot/rpc/ElicitationResult.java index 3ba30b83d9..42073de351 100644 --- a/src/main/java/com/github/copilot/sdk/json/ElicitationResult.java +++ b/src/main/java/com/github/copilot/rpc/ElicitationResult.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Map; diff --git a/src/main/java/com/github/copilot/sdk/json/ElicitationResultAction.java b/src/main/java/com/github/copilot/rpc/ElicitationResultAction.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/ElicitationResultAction.java rename to src/main/java/com/github/copilot/rpc/ElicitationResultAction.java index fd280cdebb..51fea7852d 100644 --- a/src/main/java/com/github/copilot/sdk/json/ElicitationResultAction.java +++ b/src/main/java/com/github/copilot/rpc/ElicitationResultAction.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Action value for an {@link ElicitationResult}. diff --git a/src/main/java/com/github/copilot/sdk/json/ElicitationSchema.java b/src/main/java/com/github/copilot/rpc/ElicitationSchema.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/ElicitationSchema.java rename to src/main/java/com/github/copilot/rpc/ElicitationSchema.java index c3d5487753..6111bf53b3 100644 --- a/src/main/java/com/github/copilot/sdk/json/ElicitationSchema.java +++ b/src/main/java/com/github/copilot/rpc/ElicitationSchema.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.List; import java.util.Map; diff --git a/src/main/java/com/github/copilot/rpc/ExitPlanModeHandler.java b/src/main/java/com/github/copilot/rpc/ExitPlanModeHandler.java new file mode 100644 index 0000000000..28addcb0c2 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/ExitPlanModeHandler.java @@ -0,0 +1,48 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.concurrent.CompletableFuture; + +/** + * Handler for exit-plan-mode requests from the agent. + *

+ * Register an exit-plan-mode handler via + * {@link SessionConfig#setOnExitPlanMode(ExitPlanModeHandler)} or + * {@link ResumeSessionConfig#setOnExitPlanMode(ExitPlanModeHandler)}. When + * provided, the server routes {@code exitPlanMode.request} callbacks to this + * handler. + * + *

Example Usage

+ * + * 
{@code
+ * ExitPlanModeHandler handler = (request, invocation) -> {
+ * 	// Review the plan and decide whether to approve
+ * 	return CompletableFuture
+ * 			.completedFuture(new ExitPlanModeResult().setApproved(true).setSelectedAction("interactive"));
+ * };
+ *
+ * var session = client.createSession(new SessionConfig().setOnExitPlanMode(handler)).get();
+ * }
+ * + * @see ExitPlanModeRequest + * @see ExitPlanModeResult + * @since 1.0.8 + */ +@FunctionalInterface +public interface ExitPlanModeHandler { + + /** + * Handles an exit-plan-mode request from the agent. + * + * @param request + * the exit-plan-mode request containing the summary, plan content, + * and available actions + * @param invocation + * context information about the invocation + * @return a future that resolves with the user's decision + */ + CompletableFuture handle(ExitPlanModeRequest request, ExitPlanModeInvocation invocation); +} diff --git a/src/main/java/com/github/copilot/rpc/ExitPlanModeInvocation.java b/src/main/java/com/github/copilot/rpc/ExitPlanModeInvocation.java new file mode 100644 index 0000000000..934c77d65f --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/ExitPlanModeInvocation.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +/** + * Context for an exit-plan-mode request invocation. + * + * @since 1.0.8 + */ +public class ExitPlanModeInvocation { + + private String sessionId; + + /** + * Gets the session ID. + * + * @return the session ID + */ + public String getSessionId() { + return sessionId; + } + + /** + * Sets the session ID. + * + * @param sessionId + * the session ID + * @return this instance for method chaining + */ + public ExitPlanModeInvocation setSessionId(String sessionId) { + this.sessionId = sessionId; + return this; + } +} diff --git a/src/main/java/com/github/copilot/rpc/ExitPlanModeRequest.java b/src/main/java/com/github/copilot/rpc/ExitPlanModeRequest.java new file mode 100644 index 0000000000..63499ee570 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/ExitPlanModeRequest.java @@ -0,0 +1,119 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.Collections; +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Request to exit plan mode and continue with a selected action. + *

+ * This is sent by the server when the agent wants to exit plan mode and + * requests user confirmation. + * + * @since 1.0.8 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +public class ExitPlanModeRequest { + + @JsonProperty("summary") + private String summary = ""; + + @JsonProperty("planContent") + private String planContent; + + @JsonProperty("actions") + private List actions; + + @JsonProperty("recommendedAction") + private String recommendedAction = "autopilot"; + + /** + * Gets the summary of the plan or proposed next step. + * + * @return the summary + */ + public String getSummary() { + return summary; + } + + /** + * Sets the summary of the plan or proposed next step. + * + * @param summary + * the summary + * @return this instance for method chaining + */ + public ExitPlanModeRequest setSummary(String summary) { + this.summary = summary; + return this; + } + + /** + * Gets the full plan content, when available. + * + * @return the plan content, or {@code null} if not available + */ + public String getPlanContent() { + return planContent; + } + + /** + * Sets the full plan content. + * + * @param planContent + * the plan content + * @return this instance for method chaining + */ + public ExitPlanModeRequest setPlanContent(String planContent) { + this.planContent = planContent; + return this; + } + + /** + * Gets the available actions the user can select. + * + * @return the list of actions, or {@code null} if not specified + */ + public List getActions() { + return actions == null ? null : Collections.unmodifiableList(actions); + } + + /** + * Sets the available actions the user can select. + * + * @param actions + * the list of actions + * @return this instance for method chaining + */ + public ExitPlanModeRequest setActions(List actions) { + this.actions = actions; + return this; + } + + /** + * Gets the action recommended by the runtime. + * + * @return the recommended action + */ + public String getRecommendedAction() { + return recommendedAction; + } + + /** + * Sets the action recommended by the runtime. + * + * @param recommendedAction + * the recommended action + * @return this instance for method chaining + */ + public ExitPlanModeRequest setRecommendedAction(String recommendedAction) { + this.recommendedAction = recommendedAction; + return this; + } +} diff --git a/src/main/java/com/github/copilot/rpc/ExitPlanModeResult.java b/src/main/java/com/github/copilot/rpc/ExitPlanModeResult.java new file mode 100644 index 0000000000..d61377cbcc --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/ExitPlanModeResult.java @@ -0,0 +1,87 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Response to an exit-plan-mode request. + * + * @since 1.0.8 + */ +public class ExitPlanModeResult { + + @JsonProperty("approved") + private boolean approved = true; + + @JsonProperty("selectedAction") + private String selectedAction; + + @JsonProperty("feedback") + private String feedback; + + /** + * Returns whether the user approved exiting plan mode. + * + * @return {@code true} if approved + */ + public boolean isApproved() { + return approved; + } + + /** + * Sets whether the user approved exiting plan mode. + * + * @param approved + * {@code true} if approved + * @return this instance for method chaining + */ + public ExitPlanModeResult setApproved(boolean approved) { + this.approved = approved; + return this; + } + + /** + * Gets the selected action, if the user chose one. + * + * @return the selected action, or {@code null} + */ + public String getSelectedAction() { + return selectedAction; + } + + /** + * Sets the selected action. + * + * @param selectedAction + * the selected action + * @return this instance for method chaining + */ + public ExitPlanModeResult setSelectedAction(String selectedAction) { + this.selectedAction = selectedAction; + return this; + } + + /** + * Gets optional feedback provided by the user. + * + * @return the feedback, or {@code null} + */ + public String getFeedback() { + return feedback; + } + + /** + * Sets feedback from the user. + * + * @param feedback + * the feedback text + * @return this instance for method chaining + */ + public ExitPlanModeResult setFeedback(String feedback) { + this.feedback = feedback; + return this; + } +} diff --git a/src/main/java/com/github/copilot/sdk/json/GetAuthStatusResponse.java b/src/main/java/com/github/copilot/rpc/GetAuthStatusResponse.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/GetAuthStatusResponse.java rename to src/main/java/com/github/copilot/rpc/GetAuthStatusResponse.java index 4cf5d80c6a..d2e65c89b5 100644 --- a/src/main/java/com/github/copilot/sdk/json/GetAuthStatusResponse.java +++ b/src/main/java/com/github/copilot/rpc/GetAuthStatusResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/GetForegroundSessionResponse.java b/src/main/java/com/github/copilot/rpc/GetForegroundSessionResponse.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/GetForegroundSessionResponse.java rename to src/main/java/com/github/copilot/rpc/GetForegroundSessionResponse.java index 96962c6903..65c0557cac 100644 --- a/src/main/java/com/github/copilot/sdk/json/GetForegroundSessionResponse.java +++ b/src/main/java/com/github/copilot/rpc/GetForegroundSessionResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/GetLastSessionIdResponse.java b/src/main/java/com/github/copilot/rpc/GetLastSessionIdResponse.java similarity index 89% rename from src/main/java/com/github/copilot/sdk/json/GetLastSessionIdResponse.java rename to src/main/java/com/github/copilot/rpc/GetLastSessionIdResponse.java index 52042f57c1..3f488d0e9e 100644 --- a/src/main/java/com/github/copilot/sdk/json/GetLastSessionIdResponse.java +++ b/src/main/java/com/github/copilot/rpc/GetLastSessionIdResponse.java @@ -1,4 +1,4 @@ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/GetMessagesResponse.java b/src/main/java/com/github/copilot/rpc/GetMessagesResponse.java similarity index 91% rename from src/main/java/com/github/copilot/sdk/json/GetMessagesResponse.java rename to src/main/java/com/github/copilot/rpc/GetMessagesResponse.java index 1a3ed6aaec..7726ab649f 100644 --- a/src/main/java/com/github/copilot/sdk/json/GetMessagesResponse.java +++ b/src/main/java/com/github/copilot/rpc/GetMessagesResponse.java @@ -1,4 +1,4 @@ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.List; diff --git a/src/main/java/com/github/copilot/sdk/json/GetModelsResponse.java b/src/main/java/com/github/copilot/rpc/GetModelsResponse.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/GetModelsResponse.java rename to src/main/java/com/github/copilot/rpc/GetModelsResponse.java index 8f13912b99..b5eefa9ef2 100644 --- a/src/main/java/com/github/copilot/sdk/json/GetModelsResponse.java +++ b/src/main/java/com/github/copilot/rpc/GetModelsResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/GetSessionMetadataResponse.java b/src/main/java/com/github/copilot/rpc/GetSessionMetadataResponse.java similarity index 94% rename from src/main/java/com/github/copilot/sdk/json/GetSessionMetadataResponse.java rename to src/main/java/com/github/copilot/rpc/GetSessionMetadataResponse.java index eeceb41776..7ffeb29d03 100644 --- a/src/main/java/com/github/copilot/sdk/json/GetSessionMetadataResponse.java +++ b/src/main/java/com/github/copilot/rpc/GetSessionMetadataResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/GetStatusResponse.java b/src/main/java/com/github/copilot/rpc/GetStatusResponse.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/GetStatusResponse.java rename to src/main/java/com/github/copilot/rpc/GetStatusResponse.java index a77f378abe..434f00353b 100644 --- a/src/main/java/com/github/copilot/sdk/json/GetStatusResponse.java +++ b/src/main/java/com/github/copilot/rpc/GetStatusResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/HookInvocation.java b/src/main/java/com/github/copilot/rpc/HookInvocation.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/HookInvocation.java rename to src/main/java/com/github/copilot/rpc/HookInvocation.java index 39ab506862..40d807246a 100644 --- a/src/main/java/com/github/copilot/sdk/json/HookInvocation.java +++ b/src/main/java/com/github/copilot/rpc/HookInvocation.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Context for a hook invocation. diff --git a/src/main/java/com/github/copilot/sdk/json/InfiniteSessionConfig.java b/src/main/java/com/github/copilot/rpc/InfiniteSessionConfig.java similarity index 58% rename from src/main/java/com/github/copilot/sdk/json/InfiniteSessionConfig.java rename to src/main/java/com/github/copilot/rpc/InfiniteSessionConfig.java index d45851f8a1..02718d6a2f 100644 --- a/src/main/java/com/github/copilot/sdk/json/InfiniteSessionConfig.java +++ b/src/main/java/com/github/copilot/rpc/InfiniteSessionConfig.java @@ -2,10 +2,13 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.Optional; +import java.util.OptionalDouble; /** * Configuration for infinite sessions with automatic context compaction and @@ -43,10 +46,12 @@ public class InfiniteSessionConfig { /** * Gets whether infinite sessions are enabled. * - * @return {@code true} if enabled, {@code null} to use default (true) + * @return an {@link Optional} containing the boolean value, or empty to use + * default (true) */ - public Boolean getEnabled() { - return enabled; + @JsonIgnore + public Optional getEnabled() { + return Optional.ofNullable(enabled); } /** @@ -58,18 +63,32 @@ public Boolean getEnabled() { * {@code true} to enable infinite sessions * @return this config instance for method chaining */ - public InfiniteSessionConfig setEnabled(Boolean enabled) { + public InfiniteSessionConfig setEnabled(boolean enabled) { this.enabled = enabled; return this; } + /** + * Clears the enabled setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public InfiniteSessionConfig clearEnabled() { + this.enabled = null; + return this; + } + /** * Gets the background compaction threshold. * - * @return the threshold (0.0-1.0), or {@code null} to use default + * @return an {@link OptionalDouble} containing the threshold (0.0-1.0), or + * empty to use default */ - public Double getBackgroundCompactionThreshold() { - return backgroundCompactionThreshold; + @JsonIgnore + public OptionalDouble getBackgroundCompactionThreshold() { + return backgroundCompactionThreshold == null + ? OptionalDouble.empty() + : OptionalDouble.of(backgroundCompactionThreshold); } /** @@ -82,18 +101,33 @@ public Double getBackgroundCompactionThreshold() { * the threshold (0.0-1.0) * @return this config instance for method chaining */ - public InfiniteSessionConfig setBackgroundCompactionThreshold(Double backgroundCompactionThreshold) { + public InfiniteSessionConfig setBackgroundCompactionThreshold(double backgroundCompactionThreshold) { this.backgroundCompactionThreshold = backgroundCompactionThreshold; return this; } + /** + * Clears the backgroundCompactionThreshold setting, reverting to the default + * behavior. + * + * @return this instance for method chaining + */ + public InfiniteSessionConfig clearBackgroundCompactionThreshold() { + this.backgroundCompactionThreshold = null; + return this; + } + /** * Gets the buffer exhaustion threshold. * - * @return the threshold (0.0-1.0), or {@code null} to use default + * @return an {@link OptionalDouble} containing the threshold (0.0-1.0), or + * empty to use default */ - public Double getBufferExhaustionThreshold() { - return bufferExhaustionThreshold; + @JsonIgnore + public OptionalDouble getBufferExhaustionThreshold() { + return bufferExhaustionThreshold == null + ? OptionalDouble.empty() + : OptionalDouble.of(bufferExhaustionThreshold); } /** @@ -107,8 +141,20 @@ public Double getBufferExhaustionThreshold() { * the threshold (0.0-1.0) * @return this config instance for method chaining */ - public InfiniteSessionConfig setBufferExhaustionThreshold(Double bufferExhaustionThreshold) { + public InfiniteSessionConfig setBufferExhaustionThreshold(double bufferExhaustionThreshold) { this.bufferExhaustionThreshold = bufferExhaustionThreshold; return this; } + + /** + * Clears the bufferExhaustionThreshold setting, reverting to the default + * behavior. + * + * @return this instance for method chaining + */ + public InfiniteSessionConfig clearBufferExhaustionThreshold() { + this.bufferExhaustionThreshold = null; + return this; + } + } diff --git a/src/main/java/com/github/copilot/sdk/json/InputOptions.java b/src/main/java/com/github/copilot/rpc/InputOptions.java similarity index 61% rename from src/main/java/com/github/copilot/sdk/json/InputOptions.java rename to src/main/java/com/github/copilot/rpc/InputOptions.java index 9b0b6c8dd8..db938a3f49 100644 --- a/src/main/java/com/github/copilot/sdk/json/InputOptions.java +++ b/src/main/java/com/github/copilot/rpc/InputOptions.java @@ -2,7 +2,12 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.OptionalInt; /** * Options for the {@link SessionUiApi#input(String, InputOptions)} convenience @@ -10,11 +15,14 @@ * * @since 1.0.0 */ +@JsonInclude(JsonInclude.Include.NON_NULL) public class InputOptions { private String title; private String description; + @JsonProperty("minLength") private Integer minLength; + @JsonProperty("maxLength") private Integer maxLength; private String format; private String defaultValue; @@ -46,34 +54,66 @@ public InputOptions setDescription(String description) { return this; } - /** Gets the minimum character length. @return the min length */ - public Integer getMinLength() { - return minLength; + /** + * Gets the minimum character length. + * + * @return an {@link java.util.OptionalInt} containing the min length, or + * {@link java.util.OptionalInt#empty()} if not set + */ + @JsonIgnore + public OptionalInt getMinLength() { + return minLength == null ? OptionalInt.empty() : OptionalInt.of(minLength); } /** * Sets the minimum character length. @param minLength the min length @return * this */ - public InputOptions setMinLength(Integer minLength) { + public InputOptions setMinLength(int minLength) { this.minLength = minLength; return this; } - /** Gets the maximum character length. @return the max length */ - public Integer getMaxLength() { - return maxLength; + /** + * Clears the minLength setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public InputOptions clearMinLength() { + this.minLength = null; + return this; + } + + /** + * Gets the maximum character length. + * + * @return an {@link java.util.OptionalInt} containing the max length, or + * {@link java.util.OptionalInt#empty()} if not set + */ + @JsonIgnore + public OptionalInt getMaxLength() { + return maxLength == null ? OptionalInt.empty() : OptionalInt.of(maxLength); } /** * Sets the maximum character length. @param maxLength the max length @return * this */ - public InputOptions setMaxLength(Integer maxLength) { + public InputOptions setMaxLength(int maxLength) { this.maxLength = maxLength; return this; } + /** + * Clears the maxLength setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public InputOptions clearMaxLength() { + this.maxLength = null; + return this; + } + /** * Gets the semantic format hint (e.g., {@code "email"}, {@code "uri"}, * {@code "date"}, {@code "date-time"}). diff --git a/src/main/java/com/github/copilot/sdk/json/JsonRpcError.java b/src/main/java/com/github/copilot/rpc/JsonRpcError.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/JsonRpcError.java rename to src/main/java/com/github/copilot/rpc/JsonRpcError.java index e7f021f43d..f270c43274 100644 --- a/src/main/java/com/github/copilot/sdk/json/JsonRpcError.java +++ b/src/main/java/com/github/copilot/rpc/JsonRpcError.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/JsonRpcRequest.java b/src/main/java/com/github/copilot/rpc/JsonRpcRequest.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/JsonRpcRequest.java rename to src/main/java/com/github/copilot/rpc/JsonRpcRequest.java index 1921370e25..6bef7f370f 100644 --- a/src/main/java/com/github/copilot/sdk/json/JsonRpcRequest.java +++ b/src/main/java/com/github/copilot/rpc/JsonRpcRequest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/JsonRpcResponse.java b/src/main/java/com/github/copilot/rpc/JsonRpcResponse.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/JsonRpcResponse.java rename to src/main/java/com/github/copilot/rpc/JsonRpcResponse.java index 1a78ed0174..6c80474afd 100644 --- a/src/main/java/com/github/copilot/sdk/json/JsonRpcResponse.java +++ b/src/main/java/com/github/copilot/rpc/JsonRpcResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/rpc/LargeToolOutputConfig.java b/src/main/java/com/github/copilot/rpc/LargeToolOutputConfig.java new file mode 100644 index 0000000000..cd1e6b5252 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/LargeToolOutputConfig.java @@ -0,0 +1,96 @@ +/* + * Copyright (c) Microsoft Corporation. All rights reserved. + * Licensed under the MIT License. + */ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Configuration for large tool output handling. + *

+ * When a tool produces output exceeding {@link #getMaxSizeBytes()}, the SDK + * writes the full output to a file in {@link #getOutputDirectory()} and returns + * a truncated preview to the model. + * + * @since 1.3.0 + */ +@JsonInclude(JsonInclude.Include.NON_NULL) +public class LargeToolOutputConfig { + + @JsonProperty("enabled") + private Boolean enabled; + + @JsonProperty("maxSizeBytes") + private Long maxSizeBytes; + + @JsonProperty("outputDir") + private String outputDirectory; + + /** + * Gets whether large tool output handling is enabled. + * + * @return {@code true} if enabled, {@code false} if disabled, {@code null} for + * default + */ + public Boolean getEnabled() { + return enabled; + } + + /** + * Sets whether large tool output handling is enabled. Defaults to {@code true} + * when unset. + * + * @param enabled + * {@code true} to enable, {@code false} to disable + * @return this config for method chaining + */ + public LargeToolOutputConfig setEnabled(Boolean enabled) { + this.enabled = enabled; + return this; + } + + /** + * Gets the maximum tool output size in bytes before it is redirected to a file. + * + * @return the maximum size in bytes, or {@code null} for default + */ + public Long getMaxSizeBytes() { + return maxSizeBytes; + } + + /** + * Sets the maximum tool output size in bytes before it is redirected to a file. + * + * @param maxSizeBytes + * the maximum size in bytes + * @return this config for method chaining + */ + public LargeToolOutputConfig setMaxSizeBytes(Long maxSizeBytes) { + this.maxSizeBytes = maxSizeBytes; + return this; + } + + /** + * Gets the directory where large tool output files are written. + * + * @return the output directory path, or {@code null} for default + */ + public String getOutputDirectory() { + return outputDirectory; + } + + /** + * Sets the directory where large tool output files are written. + * + * @param outputDirectory + * the output directory path + * @return this config for method chaining + */ + public LargeToolOutputConfig setOutputDirectory(String outputDirectory) { + this.outputDirectory = outputDirectory; + return this; + } +} diff --git a/src/main/java/com/github/copilot/sdk/json/ListSessionsResponse.java b/src/main/java/com/github/copilot/rpc/ListSessionsResponse.java similarity index 89% rename from src/main/java/com/github/copilot/sdk/json/ListSessionsResponse.java rename to src/main/java/com/github/copilot/rpc/ListSessionsResponse.java index b535ee396a..61955eb422 100644 --- a/src/main/java/com/github/copilot/sdk/json/ListSessionsResponse.java +++ b/src/main/java/com/github/copilot/rpc/ListSessionsResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.List; @@ -15,7 +15,7 @@ * This is a low-level class for JSON-RPC communication containing the list of * available sessions. * - * @see com.github.copilot.sdk.CopilotClient#listSessions() + * @see com.github.copilot.CopilotClient#listSessions() * @see SessionMetadata * @since 1.0.0 */ diff --git a/src/main/java/com/github/copilot/sdk/json/McpHttpServerConfig.java b/src/main/java/com/github/copilot/rpc/McpHttpServerConfig.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/McpHttpServerConfig.java rename to src/main/java/com/github/copilot/rpc/McpHttpServerConfig.java index 7017db3d2d..83a42a88f8 100644 --- a/src/main/java/com/github/copilot/sdk/json/McpHttpServerConfig.java +++ b/src/main/java/com/github/copilot/rpc/McpHttpServerConfig.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; diff --git a/src/main/java/com/github/copilot/sdk/json/McpServerConfig.java b/src/main/java/com/github/copilot/rpc/McpServerConfig.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/McpServerConfig.java rename to src/main/java/com/github/copilot/rpc/McpServerConfig.java index 7cf39af6b6..aef365d3f3 100644 --- a/src/main/java/com/github/copilot/sdk/json/McpServerConfig.java +++ b/src/main/java/com/github/copilot/rpc/McpServerConfig.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; diff --git a/src/main/java/com/github/copilot/sdk/json/McpStdioServerConfig.java b/src/main/java/com/github/copilot/rpc/McpStdioServerConfig.java similarity index 99% rename from src/main/java/com/github/copilot/sdk/json/McpStdioServerConfig.java rename to src/main/java/com/github/copilot/rpc/McpStdioServerConfig.java index 900034be61..8ce739ffbd 100644 --- a/src/main/java/com/github/copilot/sdk/json/McpStdioServerConfig.java +++ b/src/main/java/com/github/copilot/rpc/McpStdioServerConfig.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; diff --git a/src/main/java/com/github/copilot/sdk/json/MessageAttachment.java b/src/main/java/com/github/copilot/rpc/MessageAttachment.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/MessageAttachment.java rename to src/main/java/com/github/copilot/rpc/MessageAttachment.java index 3371a56ba3..e28c5da2ea 100644 --- a/src/main/java/com/github/copilot/sdk/json/MessageAttachment.java +++ b/src/main/java/com/github/copilot/rpc/MessageAttachment.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonSubTypes; import com.fasterxml.jackson.annotation.JsonTypeInfo; diff --git a/src/main/java/com/github/copilot/sdk/json/MessageOptions.java b/src/main/java/com/github/copilot/rpc/MessageOptions.java similarity index 76% rename from src/main/java/com/github/copilot/sdk/json/MessageOptions.java rename to src/main/java/com/github/copilot/rpc/MessageOptions.java index 21909d5766..c781011ff8 100644 --- a/src/main/java/com/github/copilot/sdk/json/MessageOptions.java +++ b/src/main/java/com/github/copilot/rpc/MessageOptions.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.ArrayList; import java.util.Collections; @@ -36,7 +36,7 @@ * session.send(options).get(); * } * - * @see com.github.copilot.sdk.CopilotSession#send(MessageOptions) + * @see com.github.copilot.CopilotSession#send(MessageOptions) * @since 1.0.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) @@ -45,7 +45,9 @@ public class MessageOptions { private String prompt; private List attachments; private String mode; + private AgentMode agentMode; private Map requestHeaders; + private String displayPrompt; /** * Gets the message prompt. @@ -126,6 +128,30 @@ public String getMode() { return mode; } + /** + * Sets the per-message agent UI mode. + *

+ * Defaults to the session's current mode when unset. + * + * @param agentMode + * the agent mode (for example {@link AgentMode#PLAN} or + * {@link AgentMode#AUTOPILOT}) + * @return this options instance for method chaining + */ + public MessageOptions setAgentMode(AgentMode agentMode) { + this.agentMode = agentMode; + return this; + } + + /** + * Gets the per-message agent UI mode. + * + * @return the agent mode, or {@code null} if not set + */ + public AgentMode getAgentMode() { + return agentMode; + } + /** * Gets the custom per-turn HTTP headers for outbound model requests. * @@ -151,6 +177,30 @@ public MessageOptions setRequestHeaders(Map requestHeaders) { return this; } + /** + * Gets the display prompt shown in the timeline instead of the prompt. + * + * @return the display prompt, or {@code null} if not set + */ + public String getDisplayPrompt() { + return displayPrompt; + } + + /** + * Sets the display prompt shown in the timeline instead of the prompt. + *

+ * If provided, this text is displayed in the conversation timeline UI instead + * of the actual prompt text. + * + * @param displayPrompt + * the display prompt text + * @return this options instance for method chaining + */ + public MessageOptions setDisplayPrompt(String displayPrompt) { + this.displayPrompt = displayPrompt; + return this; + } + /** * Creates a shallow clone of this {@code MessageOptions} instance. *

@@ -167,7 +217,9 @@ public MessageOptions clone() { copy.prompt = this.prompt; copy.attachments = this.attachments != null ? new ArrayList<>(this.attachments) : null; copy.mode = this.mode; + copy.agentMode = this.agentMode; copy.requestHeaders = this.requestHeaders != null ? new HashMap<>(this.requestHeaders) : null; + copy.displayPrompt = this.displayPrompt; return copy; } diff --git a/src/main/java/com/github/copilot/sdk/json/ModelBilling.java b/src/main/java/com/github/copilot/rpc/ModelBilling.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/ModelBilling.java rename to src/main/java/com/github/copilot/rpc/ModelBilling.java index d04ef0d3e5..c7bfc72b59 100644 --- a/src/main/java/com/github/copilot/sdk/json/ModelBilling.java +++ b/src/main/java/com/github/copilot/rpc/ModelBilling.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/ModelCapabilities.java b/src/main/java/com/github/copilot/rpc/ModelCapabilities.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/ModelCapabilities.java rename to src/main/java/com/github/copilot/rpc/ModelCapabilities.java index 1cadcb05e4..2a71601cfd 100644 --- a/src/main/java/com/github/copilot/sdk/json/ModelCapabilities.java +++ b/src/main/java/com/github/copilot/rpc/ModelCapabilities.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/ModelCapabilitiesOverride.java b/src/main/java/com/github/copilot/rpc/ModelCapabilitiesOverride.java similarity index 63% rename from src/main/java/com/github/copilot/sdk/json/ModelCapabilitiesOverride.java rename to src/main/java/com/github/copilot/rpc/ModelCapabilitiesOverride.java index 18701ad671..6a670252a4 100644 --- a/src/main/java/com/github/copilot/sdk/json/ModelCapabilitiesOverride.java +++ b/src/main/java/com/github/copilot/rpc/ModelCapabilitiesOverride.java @@ -2,18 +2,21 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.Optional; +import java.util.OptionalInt; /** * Per-property overrides for model capabilities, deep-merged over runtime * defaults. *

* Use this to override specific model capabilities when creating a session or - * switching models with {@link com.github.copilot.sdk.CopilotSession#setModel}. + * switching models with {@link com.github.copilot.CopilotSession#setModel}. * Only non-null fields are applied; unset fields retain their runtime defaults. * *

Example: Disable vision for a session

@@ -30,7 +33,7 @@ * new ModelCapabilitiesOverride().setSupports(new ModelCapabilitiesOverride.Supports().setVision(true))).get(); * } * - * @see com.github.copilot.sdk.CopilotSession#setModel(String, String, + * @see com.github.copilot.CopilotSession#setModel(String, String, * ModelCapabilitiesOverride) * @see SessionConfig#setModelCapabilities(ModelCapabilitiesOverride) * @since 1.3.0 @@ -106,48 +109,73 @@ public static class Supports { /** * Gets the vision override. * - * @return {@code true} to enable vision, {@code false} to disable, or - * {@code null} to use the runtime default + * @return an {@link java.util.Optional} containing {@code true} to enable + * vision or {@code false} to disable, or + * {@link java.util.Optional#empty()} to use the runtime default */ - public Boolean getVision() { - return vision; + @JsonIgnore + public Optional getVision() { + return Optional.ofNullable(vision); } /** - * Sets whether vision (image input) is enabled. + * Sets whether vision (image input) is enabled. Use {@link #clearVision()} to + * revert to the runtime default. * * @param vision - * {@code true} to enable, {@code false} to disable, or {@code null} - * to use the runtime default + * {@code true} to enable, {@code false} to disable * @return this instance for method chaining */ - public Supports setVision(Boolean vision) { + public Supports setVision(boolean vision) { this.vision = vision; return this; } + /** + * Clears the vision setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public Supports clearVision() { + this.vision = null; + return this; + } + /** * Gets the reasoning effort override. * - * @return {@code true} to enable reasoning effort, {@code false} to disable, or - * {@code null} to use the runtime default + * @return an {@link java.util.Optional} containing {@code true} to enable + * reasoning effort or {@code false} to disable, or + * {@link java.util.Optional#empty()} to use the runtime default */ - public Boolean getReasoningEffort() { - return reasoningEffort; + @JsonIgnore + public Optional getReasoningEffort() { + return Optional.ofNullable(reasoningEffort); } /** - * Sets whether reasoning effort configuration is enabled. + * Sets whether reasoning effort configuration is enabled. Use + * {@link #clearReasoningEffort()} to revert to the runtime default. * * @param reasoningEffort - * {@code true} to enable, {@code false} to disable, or {@code null} - * to use the runtime default + * {@code true} to enable, {@code false} to disable * @return this instance for method chaining */ - public Supports setReasoningEffort(Boolean reasoningEffort) { + public Supports setReasoningEffort(boolean reasoningEffort) { this.reasoningEffort = reasoningEffort; return this; } + + /** + * Clears the reasoningEffort setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public Supports clearReasoningEffort() { + this.reasoningEffort = null; + return this; + } + } /** @@ -174,8 +202,9 @@ public static class Limits { * * @return the override value, or {@code null} to use the runtime default */ - public Integer getMaxPromptTokens() { - return maxPromptTokens; + @JsonIgnore + public OptionalInt getMaxPromptTokens() { + return maxPromptTokens == null ? OptionalInt.empty() : OptionalInt.of(maxPromptTokens); } /** @@ -185,18 +214,29 @@ public Integer getMaxPromptTokens() { * the override value, or {@code null} to use the runtime default * @return this instance for method chaining */ - public Limits setMaxPromptTokens(Integer maxPromptTokens) { + public Limits setMaxPromptTokens(int maxPromptTokens) { this.maxPromptTokens = maxPromptTokens; return this; } + /** + * Clears the maxPromptTokens setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public Limits clearMaxPromptTokens() { + this.maxPromptTokens = null; + return this; + } + /** * Gets the maximum output tokens override. * * @return the override value, or {@code null} to use the runtime default */ - public Integer getMaxOutputTokens() { - return maxOutputTokens; + @JsonIgnore + public OptionalInt getMaxOutputTokens() { + return maxOutputTokens == null ? OptionalInt.empty() : OptionalInt.of(maxOutputTokens); } /** @@ -206,18 +246,29 @@ public Integer getMaxOutputTokens() { * the override value, or {@code null} to use the runtime default * @return this instance for method chaining */ - public Limits setMaxOutputTokens(Integer maxOutputTokens) { + public Limits setMaxOutputTokens(int maxOutputTokens) { this.maxOutputTokens = maxOutputTokens; return this; } + /** + * Clears the maxOutputTokens setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public Limits clearMaxOutputTokens() { + this.maxOutputTokens = null; + return this; + } + /** * Gets the maximum context window tokens override. * * @return the override value, or {@code null} to use the runtime default */ - public Integer getMaxContextWindowTokens() { - return maxContextWindowTokens; + @JsonIgnore + public OptionalInt getMaxContextWindowTokens() { + return maxContextWindowTokens == null ? OptionalInt.empty() : OptionalInt.of(maxContextWindowTokens); } /** @@ -227,9 +278,20 @@ public Integer getMaxContextWindowTokens() { * the override value, or {@code null} to use the runtime default * @return this instance for method chaining */ - public Limits setMaxContextWindowTokens(Integer maxContextWindowTokens) { + public Limits setMaxContextWindowTokens(int maxContextWindowTokens) { this.maxContextWindowTokens = maxContextWindowTokens; return this; } + + /** + * Clears the maxContextWindowTokens setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public Limits clearMaxContextWindowTokens() { + this.maxContextWindowTokens = null; + return this; + } + } } diff --git a/src/main/java/com/github/copilot/sdk/json/ModelInfo.java b/src/main/java/com/github/copilot/rpc/ModelInfo.java similarity index 99% rename from src/main/java/com/github/copilot/sdk/json/ModelInfo.java rename to src/main/java/com/github/copilot/rpc/ModelInfo.java index e047900698..b9331c8681 100644 --- a/src/main/java/com/github/copilot/sdk/json/ModelInfo.java +++ b/src/main/java/com/github/copilot/rpc/ModelInfo.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.List; diff --git a/src/main/java/com/github/copilot/sdk/json/ModelLimits.java b/src/main/java/com/github/copilot/rpc/ModelLimits.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/ModelLimits.java rename to src/main/java/com/github/copilot/rpc/ModelLimits.java index 734a50deda..a27741823b 100644 --- a/src/main/java/com/github/copilot/sdk/json/ModelLimits.java +++ b/src/main/java/com/github/copilot/rpc/ModelLimits.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/ModelPolicy.java b/src/main/java/com/github/copilot/rpc/ModelPolicy.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/ModelPolicy.java rename to src/main/java/com/github/copilot/rpc/ModelPolicy.java index 9cf2262722..75fe36b11e 100644 --- a/src/main/java/com/github/copilot/sdk/json/ModelPolicy.java +++ b/src/main/java/com/github/copilot/rpc/ModelPolicy.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/ModelSupports.java b/src/main/java/com/github/copilot/rpc/ModelSupports.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/ModelSupports.java rename to src/main/java/com/github/copilot/rpc/ModelSupports.java index 905ac68235..1462cdd983 100644 --- a/src/main/java/com/github/copilot/sdk/json/ModelSupports.java +++ b/src/main/java/com/github/copilot/rpc/ModelSupports.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/ModelVisionLimits.java b/src/main/java/com/github/copilot/rpc/ModelVisionLimits.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/ModelVisionLimits.java rename to src/main/java/com/github/copilot/rpc/ModelVisionLimits.java index 331985e539..204099adfd 100644 --- a/src/main/java/com/github/copilot/sdk/json/ModelVisionLimits.java +++ b/src/main/java/com/github/copilot/rpc/ModelVisionLimits.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/PermissionHandler.java b/src/main/java/com/github/copilot/rpc/PermissionHandler.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/PermissionHandler.java rename to src/main/java/com/github/copilot/rpc/PermissionHandler.java index d230748fcf..bd8e70b750 100644 --- a/src/main/java/com/github/copilot/sdk/json/PermissionHandler.java +++ b/src/main/java/com/github/copilot/rpc/PermissionHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/PermissionInvocation.java b/src/main/java/com/github/copilot/rpc/PermissionInvocation.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/PermissionInvocation.java rename to src/main/java/com/github/copilot/rpc/PermissionInvocation.java index 218a570cf5..bda5bdde0a 100644 --- a/src/main/java/com/github/copilot/sdk/json/PermissionInvocation.java +++ b/src/main/java/com/github/copilot/rpc/PermissionInvocation.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Context information for a permission request invocation. diff --git a/src/main/java/com/github/copilot/sdk/json/PermissionRequest.java b/src/main/java/com/github/copilot/rpc/PermissionRequest.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/PermissionRequest.java rename to src/main/java/com/github/copilot/rpc/PermissionRequest.java index 99dc7018ab..51a303feb0 100644 --- a/src/main/java/com/github/copilot/sdk/json/PermissionRequest.java +++ b/src/main/java/com/github/copilot/rpc/PermissionRequest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Map; diff --git a/src/main/java/com/github/copilot/sdk/json/PermissionRequestResult.java b/src/main/java/com/github/copilot/rpc/PermissionRequestResult.java similarity index 54% rename from src/main/java/com/github/copilot/sdk/json/PermissionRequestResult.java rename to src/main/java/com/github/copilot/rpc/PermissionRequestResult.java index 3d7390f036..2e5c60100a 100644 --- a/src/main/java/com/github/copilot/sdk/json/PermissionRequestResult.java +++ b/src/main/java/com/github/copilot/rpc/PermissionRequestResult.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.List; @@ -39,6 +39,56 @@ public final class PermissionRequestResult { @JsonProperty("rules") private List rules; + @JsonProperty("feedback") + private String feedback; + + /** + * Creates a result that approves this single request. + * + * @return a new approved result + * @since 1.3.0 + */ + public static PermissionRequestResult approveOnce() { + return new PermissionRequestResult().setKind(PermissionRequestResultKind.APPROVED); + } + + /** + * Creates a result that rejects the request, optionally forwarding feedback to + * the LLM. + * + * @param feedback + * optional feedback message, or {@code null} + * @return a new rejected result + * @since 1.3.0 + */ + public static PermissionRequestResult reject(String feedback) { + var result = new PermissionRequestResult().setKind(PermissionRequestResultKind.REJECTED); + result.setFeedback(feedback); + return result; + } + + /** + * Creates a result denying the request because no user is available to confirm + * it. + * + * @return a new user-not-available result + * @since 1.3.0 + */ + public static PermissionRequestResult userNotAvailable() { + return new PermissionRequestResult().setKind(PermissionRequestResultKind.USER_NOT_AVAILABLE); + } + + /** + * Creates a result that declines to respond to this permission request, + * allowing another connected client to answer instead. + * + * @return a new no-result result + * @since 1.3.0 + */ + public static PermissionRequestResult noResult() { + return new PermissionRequestResult().setKind(PermissionRequestResultKind.NO_RESULT); + } + /** * Gets the result kind as a string. * @@ -93,4 +143,29 @@ public PermissionRequestResult setRules(List rules) { this.rules = rules; return this; } + + /** + * Gets optional human-readable feedback to forward to the LLM along with the + * decision. + * + * @return the feedback message, or {@code null} + * @since 1.3.0 + */ + public String getFeedback() { + return feedback; + } + + /** + * Sets optional human-readable feedback to forward to the LLM along with the + * decision. + * + * @param feedback + * the feedback message + * @return this result for method chaining + * @since 1.3.0 + */ + public PermissionRequestResult setFeedback(String feedback) { + this.feedback = feedback; + return this; + } } diff --git a/src/main/java/com/github/copilot/sdk/json/PermissionRequestResultKind.java b/src/main/java/com/github/copilot/rpc/PermissionRequestResultKind.java similarity index 99% rename from src/main/java/com/github/copilot/sdk/json/PermissionRequestResultKind.java rename to src/main/java/com/github/copilot/rpc/PermissionRequestResultKind.java index f782fd76b6..95476c36f6 100644 --- a/src/main/java/com/github/copilot/sdk/json/PermissionRequestResultKind.java +++ b/src/main/java/com/github/copilot/rpc/PermissionRequestResultKind.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Objects; diff --git a/src/main/java/com/github/copilot/sdk/json/PingResponse.java b/src/main/java/com/github/copilot/rpc/PingResponse.java similarity index 82% rename from src/main/java/com/github/copilot/sdk/json/PingResponse.java rename to src/main/java/com/github/copilot/rpc/PingResponse.java index e86499b2f3..efa607c6b1 100644 --- a/src/main/java/com/github/copilot/sdk/json/PingResponse.java +++ b/src/main/java/com/github/copilot/rpc/PingResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; @@ -13,15 +13,15 @@ * The ping response confirms connectivity and provides information about the * server, including the protocol version. * - * @see com.github.copilot.sdk.CopilotClient#ping(String) + * @see com.github.copilot.CopilotClient#ping(String) * @since 1.0.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) public record PingResponse( /** The echo message from the server. */ @JsonProperty("message") String message, - /** The server timestamp in milliseconds since epoch. */ - @JsonProperty("timestamp") long timestamp, + /** The server timestamp as an ISO 8601 string. */ + @JsonProperty("timestamp") String timestamp, /** * The SDK protocol version supported by the server. The SDK validates that this * version matches the expected version to ensure compatibility. diff --git a/src/main/java/com/github/copilot/rpc/PostToolUseFailureHandler.java b/src/main/java/com/github/copilot/rpc/PostToolUseFailureHandler.java new file mode 100644 index 0000000000..0b648ecbfb --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/PostToolUseFailureHandler.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.concurrent.CompletableFuture; + +/** + * Handler for post-tool-use-failure hooks. + *

+ * This hook is called after a tool execution whose result was a failure. + * {@link PostToolUseHandler} only fires for successful tool executions; + * register this handler in addition to observe failed tool calls. + * + * @since 1.3.0 + */ +@FunctionalInterface +public interface PostToolUseFailureHandler { + + /** + * Handles a post-tool-use-failure hook invocation. + * + * @param input + * the hook input containing tool name, arguments, and error message + * @param invocation + * context information about the invocation + * @return a future that resolves with the hook output, or {@code null} to use + * defaults + */ + CompletableFuture handle(PostToolUseFailureHookInput input, + HookInvocation invocation); +} diff --git a/src/main/java/com/github/copilot/rpc/PostToolUseFailureHookInput.java b/src/main/java/com/github/copilot/rpc/PostToolUseFailureHookInput.java new file mode 100644 index 0000000000..820976b96f --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/PostToolUseFailureHookInput.java @@ -0,0 +1,166 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.JsonNode; + +/** + * Input for a post-tool-use-failure hook. + *

+ * Fires after a tool execution whose result was "failure". The CLI extracts the + * failure message from the tool result and passes it as the {@link #getError()} + * field (rather than passing the full result object). + * + * @since 1.3.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +public class PostToolUseFailureHookInput { + + @JsonProperty("sessionId") + private String sessionId; + + @JsonProperty("timestamp") + private long timestamp; + + @JsonProperty("cwd") + private String cwd; + + @JsonProperty("toolName") + private String toolName; + + @JsonProperty("toolArgs") + private JsonNode toolArgs; + + @JsonProperty("error") + private String error; + + /** + * Gets the runtime session ID of the session that triggered the hook. + * + * @return the session ID + */ + public String getSessionId() { + return sessionId; + } + + /** + * Sets the runtime session ID of the session that triggered the hook. + * + * @param sessionId + * the session ID + * @return this instance for method chaining + */ + public PostToolUseFailureHookInput setSessionId(String sessionId) { + this.sessionId = sessionId; + return this; + } + + /** + * Gets the timestamp of the hook invocation. + * + * @return the timestamp in milliseconds + */ + public long getTimestamp() { + return timestamp; + } + + /** + * Sets the timestamp of the hook invocation. + * + * @param timestamp + * the timestamp in milliseconds + * @return this instance for method chaining + */ + public PostToolUseFailureHookInput setTimestamp(long timestamp) { + this.timestamp = timestamp; + return this; + } + + /** + * Gets the current working directory. + * + * @return the working directory path + */ + public String getCwd() { + return cwd; + } + + /** + * Sets the current working directory. + * + * @param cwd + * the working directory path + * @return this instance for method chaining + */ + public PostToolUseFailureHookInput setCwd(String cwd) { + this.cwd = cwd; + return this; + } + + /** + * Gets the name of the tool that failed. + * + * @return the tool name + */ + public String getToolName() { + return toolName; + } + + /** + * Sets the name of the tool that failed. + * + * @param toolName + * the tool name + * @return this instance for method chaining + */ + public PostToolUseFailureHookInput setToolName(String toolName) { + this.toolName = toolName; + return this; + } + + /** + * Gets the arguments passed to the tool. + * + * @return the tool arguments as a JSON node + */ + public JsonNode getToolArgs() { + return toolArgs; + } + + /** + * Sets the arguments passed to the tool. + * + * @param toolArgs + * the tool arguments as a JSON node + * @return this instance for method chaining + */ + public PostToolUseFailureHookInput setToolArgs(JsonNode toolArgs) { + this.toolArgs = toolArgs; + return this; + } + + /** + * Gets the failure message extracted from the tool's result. + * + * @return the error message + */ + public String getError() { + return error; + } + + /** + * Sets the failure message extracted from the tool's result. + * + * @param error + * the error message + * @return this instance for method chaining + */ + public PostToolUseFailureHookInput setError(String error) { + this.error = error; + return this; + } +} diff --git a/src/main/java/com/github/copilot/rpc/PostToolUseFailureHookOutput.java b/src/main/java/com/github/copilot/rpc/PostToolUseFailureHookOutput.java new file mode 100644 index 0000000000..ec37cc2f3a --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/PostToolUseFailureHookOutput.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Output for a post-tool-use-failure hook. + *

+ * Only {@link #getAdditionalContext()} is consumed by the host CLI β€” it is + * appended as hidden guidance to the model alongside the failed tool result. + * + * @since 1.3.0 + */ +@JsonInclude(JsonInclude.Include.NON_NULL) +public class PostToolUseFailureHookOutput { + + @JsonProperty("additionalContext") + private String additionalContext; + + /** + * Gets the additional context to inject into the conversation. + * + * @return the additional context, or {@code null} + */ + public String getAdditionalContext() { + return additionalContext; + } + + /** + * Sets the additional context to inject into the conversation for the language + * model. + * + * @param additionalContext + * the additional context + * @return this instance for method chaining + */ + public PostToolUseFailureHookOutput setAdditionalContext(String additionalContext) { + this.additionalContext = additionalContext; + return this; + } +} diff --git a/src/main/java/com/github/copilot/sdk/json/PostToolUseHandler.java b/src/main/java/com/github/copilot/rpc/PostToolUseHandler.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/PostToolUseHandler.java rename to src/main/java/com/github/copilot/rpc/PostToolUseHandler.java index 12688e63c4..7b5f1601cd 100644 --- a/src/main/java/com/github/copilot/sdk/json/PostToolUseHandler.java +++ b/src/main/java/com/github/copilot/rpc/PostToolUseHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/PostToolUseHookInput.java b/src/main/java/com/github/copilot/rpc/PostToolUseHookInput.java similarity index 84% rename from src/main/java/com/github/copilot/sdk/json/PostToolUseHookInput.java rename to src/main/java/com/github/copilot/rpc/PostToolUseHookInput.java index 18e9201b54..9da5aee883 100644 --- a/src/main/java/com/github/copilot/sdk/json/PostToolUseHookInput.java +++ b/src/main/java/com/github/copilot/rpc/PostToolUseHookInput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; @@ -16,6 +16,9 @@ @JsonIgnoreProperties(ignoreUnknown = true) public class PostToolUseHookInput { + @JsonProperty("sessionId") + private String sessionId; + @JsonProperty("timestamp") private long timestamp; @@ -31,6 +34,27 @@ public class PostToolUseHookInput { @JsonProperty("toolResult") private JsonNode toolResult; + /** + * Gets the runtime session ID of the session that triggered the hook. + * + * @return the session ID + */ + public String getSessionId() { + return sessionId; + } + + /** + * Sets the runtime session ID of the session that triggered the hook. + * + * @param sessionId + * the session ID + * @return this instance for method chaining + */ + public PostToolUseHookInput setSessionId(String sessionId) { + this.sessionId = sessionId; + return this; + } + /** * Gets the timestamp of the hook invocation. * diff --git a/src/main/java/com/github/copilot/sdk/json/PostToolUseHookOutput.java b/src/main/java/com/github/copilot/rpc/PostToolUseHookOutput.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/PostToolUseHookOutput.java rename to src/main/java/com/github/copilot/rpc/PostToolUseHookOutput.java index a532bf15e6..24af027076 100644 --- a/src/main/java/com/github/copilot/sdk/json/PostToolUseHookOutput.java +++ b/src/main/java/com/github/copilot/rpc/PostToolUseHookOutput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/rpc/PreMcpToolCallHandler.java b/src/main/java/com/github/copilot/rpc/PreMcpToolCallHandler.java new file mode 100644 index 0000000000..9e7d147edd --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/PreMcpToolCallHandler.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.concurrent.CompletableFuture; + +/** + * Handler for pre-MCP-tool-call hooks. + *

+ * This hook is called before an MCP tool call is dispatched to an MCP server, + * allowing you to: + *

    + *
  • Inspect the tool call arguments and server name
    • + *
  • Set, replace, or remove MCP request metadata ({@code _meta})
    • + *
+ * + * @since 1.0.8 + */ +@FunctionalInterface +public interface PreMcpToolCallHandler { + + /** + * Handles a pre-MCP-tool-call hook invocation. + * + * @param input + * the hook input containing server name, tool name, and arguments + * @param invocation + * context information about the invocation + * @return a future that resolves with the hook output, or {@code null} to + * preserve existing metadata (no-op) + */ + CompletableFuture handle(PreMcpToolCallHookInput input, HookInvocation invocation); +} diff --git a/src/main/java/com/github/copilot/rpc/PreMcpToolCallHookInput.java b/src/main/java/com/github/copilot/rpc/PreMcpToolCallHookInput.java new file mode 100644 index 0000000000..881065aa86 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/PreMcpToolCallHookInput.java @@ -0,0 +1,215 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.JsonNode; + +/** + * Input for a pre-MCP-tool-call hook. + *

+ * This hook fires before an MCP tool call is dispatched to an MCP server, + * allowing you to inspect or modify the request metadata. + * + * @since 1.0.8 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +public class PreMcpToolCallHookInput { + + @JsonProperty("sessionId") + private String sessionId; + + @JsonProperty("timestamp") + private long timestamp; + + @JsonProperty("cwd") + private String cwd; + + @JsonProperty("serverName") + private String serverName; + + @JsonProperty("toolName") + private String toolName; + + @JsonProperty("arguments") + private JsonNode arguments; + + @JsonProperty("toolCallId") + private String toolCallId; + + @JsonProperty("_meta") + private Map meta; + + /** + * Gets the runtime session ID of the session that triggered the hook. + * + * @return the session ID + */ + public String getSessionId() { + return sessionId; + } + + /** + * Sets the runtime session ID of the session that triggered the hook. + * + * @param sessionId + * the session ID + * @return this instance for method chaining + */ + public PreMcpToolCallHookInput setSessionId(String sessionId) { + this.sessionId = sessionId; + return this; + } + + /** + * Gets the timestamp of the hook invocation. + * + * @return the timestamp in milliseconds + */ + public long getTimestamp() { + return timestamp; + } + + /** + * Sets the timestamp of the hook invocation. + * + * @param timestamp + * the timestamp in milliseconds + * @return this instance for method chaining + */ + public PreMcpToolCallHookInput setTimestamp(long timestamp) { + this.timestamp = timestamp; + return this; + } + + /** + * Gets the current working directory. + * + * @return the working directory path + */ + public String getCwd() { + return cwd; + } + + /** + * Sets the current working directory. + * + * @param cwd + * the working directory path + * @return this instance for method chaining + */ + public PreMcpToolCallHookInput setCwd(String cwd) { + this.cwd = cwd; + return this; + } + + /** + * Gets the name of the MCP server being called. + * + * @return the server name + */ + public String getServerName() { + return serverName; + } + + /** + * Sets the name of the MCP server being called. + * + * @param serverName + * the server name + * @return this instance for method chaining + */ + public PreMcpToolCallHookInput setServerName(String serverName) { + this.serverName = serverName; + return this; + } + + /** + * Gets the name of the MCP tool being called. + * + * @return the tool name + */ + public String getToolName() { + return toolName; + } + + /** + * Sets the name of the MCP tool being called. + * + * @param toolName + * the tool name + * @return this instance for method chaining + */ + public PreMcpToolCallHookInput setToolName(String toolName) { + this.toolName = toolName; + return this; + } + + /** + * Gets the arguments for the MCP tool call. + * + * @return the arguments as a JSON node, or {@code null} + */ + public JsonNode getArguments() { + return arguments; + } + + /** + * Sets the arguments for the MCP tool call. + * + * @param arguments + * the arguments as a JSON node + * @return this instance for method chaining + */ + public PreMcpToolCallHookInput setArguments(JsonNode arguments) { + this.arguments = arguments; + return this; + } + + /** + * Gets the tool call ID, if available. + * + * @return the tool call ID, or {@code null} + */ + public String getToolCallId() { + return toolCallId; + } + + /** + * Sets the tool call ID. + * + * @param toolCallId + * the tool call ID + * @return this instance for method chaining + */ + public PreMcpToolCallHookInput setToolCallId(String toolCallId) { + this.toolCallId = toolCallId; + return this; + } + + /** + * Gets the MCP request metadata, if present. + * + * @return the metadata map, or {@code null} + */ + public Map getMeta() { + return meta; + } + + /** + * Sets the MCP request metadata. + * + * @param meta + * the metadata map + * @return this instance for method chaining + */ + public PreMcpToolCallHookInput setMeta(Map meta) { + this.meta = meta; + return this; + } +} diff --git a/src/main/java/com/github/copilot/rpc/PreMcpToolCallHookOutput.java b/src/main/java/com/github/copilot/rpc/PreMcpToolCallHookOutput.java new file mode 100644 index 0000000000..21da35e5e6 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/PreMcpToolCallHookOutput.java @@ -0,0 +1,72 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.JsonNode; + +/** + * Output for a pre-MCP-tool-call hook. + *

+ * The {@link #metaToUse} property controls outgoing MCP request metadata: + *

    + *
  • Return {@code null} from the hook handler: preserve existing + * {@code _meta} (no-op).
    • + *
  • Return a {@code PreMcpToolCallHookOutput} with {@code metaToUse} left as + * {@code null}: remove {@code _meta} from the request.
    • + *
  • Return a {@code PreMcpToolCallHookOutput} with {@code metaToUse} set to a + * JSON object: replace {@code _meta} with that object.
    • + *
+ * + * @since 1.0.8 + */ +@JsonInclude(JsonInclude.Include.ALWAYS) +public class PreMcpToolCallHookOutput { + + @JsonProperty("metaToUse") + private JsonNode metaToUse; + + /** + * Gets the metadata to use for the outgoing MCP request. + * + * @return the metadata JSON node, or {@code null} to remove metadata + */ + public JsonNode getMetaToUse() { + return metaToUse; + } + + /** + * Sets the metadata to use for the outgoing MCP request. + * + * @param metaToUse + * the metadata JSON node, or {@code null} to remove metadata + * @return this instance for method chaining + */ + public PreMcpToolCallHookOutput setMetaToUse(JsonNode metaToUse) { + this.metaToUse = metaToUse; + return this; + } + + /** + * Creates a hook output that sets the given metadata on the MCP request. + * + * @param metaToUse + * the metadata JSON node to use + * @return the hook output + */ + public static PreMcpToolCallHookOutput withMeta(JsonNode metaToUse) { + return new PreMcpToolCallHookOutput().setMetaToUse(metaToUse); + } + + /** + * Creates a hook output that removes metadata from the MCP request. + * + * @return the hook output with {@code null} metaToUse + */ + public static PreMcpToolCallHookOutput removeMeta() { + return new PreMcpToolCallHookOutput(); + } +} diff --git a/src/main/java/com/github/copilot/sdk/json/PreToolUseHandler.java b/src/main/java/com/github/copilot/rpc/PreToolUseHandler.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/PreToolUseHandler.java rename to src/main/java/com/github/copilot/rpc/PreToolUseHandler.java index 3f98972e54..94f17acab4 100644 --- a/src/main/java/com/github/copilot/sdk/json/PreToolUseHandler.java +++ b/src/main/java/com/github/copilot/rpc/PreToolUseHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/PreToolUseHookInput.java b/src/main/java/com/github/copilot/rpc/PreToolUseHookInput.java similarity index 81% rename from src/main/java/com/github/copilot/sdk/json/PreToolUseHookInput.java rename to src/main/java/com/github/copilot/rpc/PreToolUseHookInput.java index 63785e98d3..b6cb118590 100644 --- a/src/main/java/com/github/copilot/sdk/json/PreToolUseHookInput.java +++ b/src/main/java/com/github/copilot/rpc/PreToolUseHookInput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; @@ -16,6 +16,9 @@ @JsonIgnoreProperties(ignoreUnknown = true) public class PreToolUseHookInput { + @JsonProperty("sessionId") + private String sessionId; + @JsonProperty("timestamp") private long timestamp; @@ -28,6 +31,27 @@ public class PreToolUseHookInput { @JsonProperty("toolArgs") private JsonNode toolArgs; + /** + * Gets the runtime session ID of the session that triggered the hook. + * + * @return the session ID + */ + public String getSessionId() { + return sessionId; + } + + /** + * Sets the runtime session ID of the session that triggered the hook. + * + * @param sessionId + * the session ID + * @return this instance for method chaining + */ + public PreToolUseHookInput setSessionId(String sessionId) { + this.sessionId = sessionId; + return this; + } + /** * Gets the timestamp of the hook invocation. * diff --git a/src/main/java/com/github/copilot/sdk/json/PreToolUseHookOutput.java b/src/main/java/com/github/copilot/rpc/PreToolUseHookOutput.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/PreToolUseHookOutput.java rename to src/main/java/com/github/copilot/rpc/PreToolUseHookOutput.java index a92c8f01a9..25d49a54d5 100644 --- a/src/main/java/com/github/copilot/sdk/json/PreToolUseHookOutput.java +++ b/src/main/java/com/github/copilot/rpc/PreToolUseHookOutput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/ProviderConfig.java b/src/main/java/com/github/copilot/rpc/ProviderConfig.java similarity index 56% rename from src/main/java/com/github/copilot/sdk/json/ProviderConfig.java rename to src/main/java/com/github/copilot/rpc/ProviderConfig.java index 3b29956814..6c9cf379fe 100644 --- a/src/main/java/com/github/copilot/sdk/json/ProviderConfig.java +++ b/src/main/java/com/github/copilot/rpc/ProviderConfig.java @@ -2,13 +2,15 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.Map; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.OptionalInt; /** * Configuration for a custom API provider (BYOK - Bring Your Own Key). @@ -57,6 +59,18 @@ public class ProviderConfig { @JsonProperty("headers") private Map headers; + @JsonProperty("modelId") + private String modelId; + + @JsonProperty("wireModel") + private String wireModel; + + @JsonProperty("maxPromptTokens") + private Integer maxPromptTokens; + + @JsonProperty("maxOutputTokens") + private Integer maxOutputTokens; + /** * Gets the provider type. * @@ -225,4 +239,134 @@ public ProviderConfig setHeaders(Map headers) { this.headers = headers; return this; } + + /** + * Gets the well-known model name used by the runtime. + *

+ * Used to look up agent configuration (tools, prompts, reasoning behavior) and + * default token limits. Also used as the wire model when + * {@link #getWireModel()} is not set. + * + * @return the model ID, or {@code null} if not set + */ + public String getModelId() { + return modelId; + } + + /** + * Sets the well-known model name used by the runtime. + *

+ * Used to look up agent configuration (tools, prompts, reasoning behavior) and + * default token limits. Also used as the wire model when + * {@link #getWireModel()} is not set. Falls back to + * {@link SessionConfig#getModel()}. + * + * @param modelId + * the model ID + * @return this config for method chaining + */ + public ProviderConfig setModelId(String modelId) { + this.modelId = modelId; + return this; + } + + /** + * Gets the model name sent to the provider API for inference. + * + * @return the wire model name, or {@code null} if not set + */ + public String getWireModel() { + return wireModel; + } + + /** + * Sets the model name sent to the provider API for inference. + *

+ * Use this when the provider's model name (e.g. an Azure deployment name or a + * custom fine-tune name) differs from {@link #getModelId()}. Falls back to + * {@link #getModelId()}, then {@link SessionConfig#getModel()}. + * + * @param wireModel + * the wire model name + * @return this config for method chaining + */ + public ProviderConfig setWireModel(String wireModel) { + this.wireModel = wireModel; + return this; + } + + /** + * Gets the maximum prompt token override. + * + * @return an {@link java.util.OptionalInt} containing the max prompt tokens, or + * {@link java.util.OptionalInt#empty()} if not set + */ + @JsonIgnore + public OptionalInt getMaxPromptTokens() { + return maxPromptTokens == null ? OptionalInt.empty() : OptionalInt.of(maxPromptTokens); + } + + /** + * Sets the maximum prompt tokens override. + *

+ * Overrides the resolved model's default max prompt tokens. The runtime + * triggers conversation compaction before sending a request when the prompt + * (system message, history, tool definitions, user message) would exceed this + * limit. + * + * @param maxPromptTokens + * the max prompt tokens + * @return this config for method chaining + */ + public ProviderConfig setMaxPromptTokens(int maxPromptTokens) { + this.maxPromptTokens = maxPromptTokens; + return this; + } + + /** + * Clears the maxPromptTokens setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public ProviderConfig clearMaxPromptTokens() { + this.maxPromptTokens = null; + return this; + } + + /** + * Gets the maximum output token override. + * + * @return an {@link java.util.OptionalInt} containing the max output tokens, or + * {@link java.util.OptionalInt#empty()} if not set + */ + @JsonIgnore + public OptionalInt getMaxOutputTokens() { + return maxOutputTokens == null ? OptionalInt.empty() : OptionalInt.of(maxOutputTokens); + } + + /** + * Sets the maximum output tokens override. + *

+ * Overrides the resolved model's default max output tokens. When hit, the model + * stops generating and returns a truncated response. + * + * @param maxOutputTokens + * the max output tokens + * @return this config for method chaining + */ + public ProviderConfig setMaxOutputTokens(int maxOutputTokens) { + this.maxOutputTokens = maxOutputTokens; + return this; + } + + /** + * Clears the maxOutputTokens setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public ProviderConfig clearMaxOutputTokens() { + this.maxOutputTokens = null; + return this; + } + } diff --git a/src/main/java/com/github/copilot/sdk/json/ResumeSessionConfig.java b/src/main/java/com/github/copilot/rpc/ResumeSessionConfig.java similarity index 57% rename from src/main/java/com/github/copilot/sdk/json/ResumeSessionConfig.java rename to src/main/java/com/github/copilot/rpc/ResumeSessionConfig.java index b4dacf3702..beef40de55 100644 --- a/src/main/java/com/github/copilot/sdk/json/ResumeSessionConfig.java +++ b/src/main/java/com/github/copilot/rpc/ResumeSessionConfig.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.ArrayList; import java.util.Collections; @@ -11,8 +11,10 @@ import java.util.function.Consumer; import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonIgnore; -import com.github.copilot.sdk.generated.SessionEvent; +import com.github.copilot.generated.SessionEvent; +import java.util.Optional; /** * Configuration for resuming an existing Copilot session. @@ -29,7 +31,7 @@ * var session = client.resumeSession(sessionId, config).get(); * } * - * @see com.github.copilot.sdk.CopilotClient#resumeSession(String, + * @see com.github.copilot.CopilotClient#resumeSession(String, * ResumeSessionConfig) * @since 1.0.0 */ @@ -43,28 +45,42 @@ public class ResumeSessionConfig { private List availableTools; private List excludedTools; private ProviderConfig provider; + private Boolean enableSessionTelemetry; + private Boolean skipCustomInstructions; + private Boolean customAgentsLocalOnly; + private Boolean coauthorEnabled; + private Boolean manageScheduleEnabled; private String reasoningEffort; + private String reasoningSummary; private ModelCapabilitiesOverride modelCapabilities; private PermissionHandler onPermissionRequest; private UserInputHandler onUserInputRequest; private SessionHooks hooks; private String workingDirectory; - private String configDir; + private String configDirectory; private Boolean enableConfigDiscovery; private boolean disableResume; private boolean streaming; private Boolean includeSubAgentStreamingEvents; private Map mcpServers; + private String mcpOAuthTokenStorage; private List customAgents; private DefaultAgentConfig defaultAgent; private String agent; private List skillDirectories; + private List instructionDirectories; + private List pluginDirectories; + private LargeToolOutputConfig largeOutput; private List disabledSkills; private InfiniteSessionConfig infiniteSessions; private Consumer onEvent; private List commands; private ElicitationHandler onElicitationRequest; + private ExitPlanModeHandler onExitPlanMode; + private AutoModeSwitchHandler onAutoModeSwitch; + private boolean enableMcpApps; private String gitHubToken; + private String remoteSession; /** * Gets the AI model to use. @@ -228,6 +244,212 @@ public ResumeSessionConfig setProvider(ProviderConfig provider) { return this; } + /** + * Enables or disables internal session telemetry for this session. When + * {@code false}, disables session telemetry. When unset (the default) or + * {@code true}, telemetry is enabled for GitHub-authenticated sessions. When a + * custom {@link ProviderConfig} (BYOK) is configured, session telemetry is + * always disabled regardless of this setting. This is independent of + * {@link com.github.copilot.rpc.CopilotClientOptions#getTelemetry() + * CopilotClientOptions.TelemetryConfig}, which configures OpenTelemetry export + * for observability. + * + * @return an {@link java.util.Optional} containing whether session telemetry is + * enabled, or {@link java.util.Optional#empty()} for the default + */ + @JsonIgnore + public Optional getEnableSessionTelemetry() { + return Optional.ofNullable(enableSessionTelemetry); + } + + /** + * Enables or disables internal session telemetry for this session. When + * {@code false}, disables session telemetry. When unset (the default) or + * {@code true}, telemetry is enabled for GitHub-authenticated sessions. When a + * custom {@link ProviderConfig} (BYOK) is configured, session telemetry is + * always disabled regardless of this setting. + * + * @param enableSessionTelemetry + * whether to enable session telemetry + * @return this config for method chaining + */ + public ResumeSessionConfig setEnableSessionTelemetry(boolean enableSessionTelemetry) { + this.enableSessionTelemetry = enableSessionTelemetry; + return this; + } + + /** + * Clears the enableSessionTelemetry setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public ResumeSessionConfig clearEnableSessionTelemetry() { + this.enableSessionTelemetry = null; + return this; + } + + /** + * Gets whether custom instruction file loading is suppressed. + * + * @return {@code true} to suppress, or empty if not explicitly set + * @since 1.3.0 + */ + @JsonIgnore + public Optional getSkipCustomInstructions() { + return Optional.ofNullable(skipCustomInstructions); + } + + /** + * Sets whether to suppress loading of custom instruction files. + *

+ * This option is sent to the server via a {@code session.options.update} + * JSON-RPC call immediately after session resume. In + * {@link CopilotClientMode#EMPTY EMPTY} mode the default is {@code true} + * (skip); in {@link CopilotClientMode#COPILOT_CLI COPILOT_CLI} mode the value + * is forwarded only when explicitly set. + * + * @param skipCustomInstructions + * whether to skip custom instructions + * @return this config instance for method chaining + * @since 1.3.0 + */ + public ResumeSessionConfig setSkipCustomInstructions(boolean skipCustomInstructions) { + this.skipCustomInstructions = skipCustomInstructions; + return this; + } + + /** + * Clears the skipCustomInstructions setting. + * + * @return this instance for method chaining + */ + public ResumeSessionConfig clearSkipCustomInstructions() { + this.skipCustomInstructions = null; + return this; + } + + /** + * Gets whether custom-agent discovery is restricted to local only. + * + * @return {@code true} for local only, or empty if not explicitly set + * @since 1.3.0 + */ + @JsonIgnore + public Optional getCustomAgentsLocalOnly() { + return Optional.ofNullable(customAgentsLocalOnly); + } + + /** + * Sets whether custom-agent discovery is restricted to the session's local + * working directory. + *

+ * This option is sent to the server via a {@code session.options.update} + * JSON-RPC call immediately after session resume. In + * {@link CopilotClientMode#EMPTY EMPTY} mode the default is {@code true} (local + * only); in {@link CopilotClientMode#COPILOT_CLI COPILOT_CLI} mode the value is + * forwarded only when explicitly set. + * + * @param customAgentsLocalOnly + * whether to restrict to local agents + * @return this config instance for method chaining + * @since 1.3.0 + */ + public ResumeSessionConfig setCustomAgentsLocalOnly(boolean customAgentsLocalOnly) { + this.customAgentsLocalOnly = customAgentsLocalOnly; + return this; + } + + /** + * Clears the customAgentsLocalOnly setting. + * + * @return this instance for method chaining + */ + public ResumeSessionConfig clearCustomAgentsLocalOnly() { + this.customAgentsLocalOnly = null; + return this; + } + + /** + * Gets whether the runtime may append a Co-authored-by trailer. + * + * @return the coauthor enabled flag, or empty if not explicitly set + * @since 1.3.0 + */ + @JsonIgnore + public Optional getCoauthorEnabled() { + return Optional.ofNullable(coauthorEnabled); + } + + /** + * Sets whether the runtime is allowed to append a {@code Co-authored-by} + * trailer. + *

+ * This option is sent to the server via a {@code session.options.update} + * JSON-RPC call immediately after session resume. In + * {@link CopilotClientMode#EMPTY EMPTY} mode the default is {@code false} + * (disabled); in {@link CopilotClientMode#COPILOT_CLI COPILOT_CLI} mode the + * value is forwarded only when explicitly set. + * + * @param coauthorEnabled + * whether coauthor is enabled + * @return this config instance for method chaining + * @since 1.3.0 + */ + public ResumeSessionConfig setCoauthorEnabled(boolean coauthorEnabled) { + this.coauthorEnabled = coauthorEnabled; + return this; + } + + /** + * Clears the coauthorEnabled setting. + * + * @return this instance for method chaining + */ + public ResumeSessionConfig clearCoauthorEnabled() { + this.coauthorEnabled = null; + return this; + } + + /** + * Gets whether the manage_schedule tool is enabled. + * + * @return the manage schedule flag, or empty if not explicitly set + * @since 1.3.0 + */ + @JsonIgnore + public Optional getManageScheduleEnabled() { + return Optional.ofNullable(manageScheduleEnabled); + } + + /** + * Sets whether to enable the {@code manage_schedule} tool. + *

+ * This option is sent to the server via a {@code session.options.update} + * JSON-RPC call immediately after session resume. In + * {@link CopilotClientMode#EMPTY EMPTY} mode the default is {@code false} + * (disabled); in {@link CopilotClientMode#COPILOT_CLI COPILOT_CLI} mode the + * value is forwarded only when explicitly set. + * + * @param manageScheduleEnabled + * whether manage schedule is enabled + * @return this config instance for method chaining + * @since 1.3.0 + */ + public ResumeSessionConfig setManageScheduleEnabled(boolean manageScheduleEnabled) { + this.manageScheduleEnabled = manageScheduleEnabled; + return this; + } + + /** + * Clears the manageScheduleEnabled setting. + * + * @return this instance for method chaining + */ + public ResumeSessionConfig clearManageScheduleEnabled() { + this.manageScheduleEnabled = null; + return this; + } + /** * Gets the reasoning effort level. * @@ -251,6 +473,29 @@ public ResumeSessionConfig setReasoningEffort(String reasoningEffort) { return this; } + /** + * Gets the reasoning summary mode. + * + * @return the reasoning summary mode ("none", "concise", or "detailed") + */ + public String getReasoningSummary() { + return reasoningSummary; + } + + /** + * Sets the reasoning summary mode for models that support configurable + * reasoning summaries. Use {@code "none"} to suppress summary output regardless + * of whether reasoning is enabled. + * + * @param reasoningSummary + * the reasoning summary mode + * @return this config for method chaining + */ + public ResumeSessionConfig setReasoningSummary(String reasoningSummary) { + this.reasoningSummary = reasoningSummary; + return this; + } + /** * Gets the permission request handler. * @@ -343,8 +588,8 @@ public ResumeSessionConfig setWorkingDirectory(String workingDirectory) { * * @return the configuration directory path */ - public String getConfigDir() { - return configDir; + public String getConfigDirectory() { + return configDirectory; } /** @@ -352,12 +597,12 @@ public String getConfigDir() { *

* Override the default configuration directory location. * - * @param configDir + * @param configDirectory * the configuration directory path * @return this config for method chaining */ - public ResumeSessionConfig setConfigDir(String configDir) { - this.configDir = configDir; + public ResumeSessionConfig setConfigDirectory(String configDirectory) { + this.configDirectory = configDirectory; return this; } @@ -367,8 +612,9 @@ public ResumeSessionConfig setConfigDir(String configDir) { * @return {@code true} to enable discovery, {@code false} to disable, or * {@code null} to use the runtime default */ - public Boolean getEnableConfigDiscovery() { - return enableConfigDiscovery; + @JsonIgnore + public Optional getEnableConfigDiscovery() { + return Optional.ofNullable(enableConfigDiscovery); } /** @@ -384,19 +630,30 @@ public Boolean getEnableConfigDiscovery() { * {@code null} to use the runtime default * @return this config for method chaining */ - public ResumeSessionConfig setEnableConfigDiscovery(Boolean enableConfigDiscovery) { + public ResumeSessionConfig setEnableConfigDiscovery(boolean enableConfigDiscovery) { this.enableConfigDiscovery = enableConfigDiscovery; return this; } + /** + * Clears the enableConfigDiscovery setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public ResumeSessionConfig clearEnableConfigDiscovery() { + this.enableConfigDiscovery = null; + return this; + } + /** * Gets whether sub-agent streaming events are included. * * @return {@code true} to include sub-agent streaming events, {@code false} to * suppress them, or {@code null} to use the runtime default */ - public Boolean getIncludeSubAgentStreamingEvents() { - return includeSubAgentStreamingEvents; + @JsonIgnore + public Optional getIncludeSubAgentStreamingEvents() { + return Optional.ofNullable(includeSubAgentStreamingEvents); } /** @@ -407,11 +664,22 @@ public Boolean getIncludeSubAgentStreamingEvents() { * suppress * @return this config for method chaining */ - public ResumeSessionConfig setIncludeSubAgentStreamingEvents(Boolean includeSubAgentStreamingEvents) { + public ResumeSessionConfig setIncludeSubAgentStreamingEvents(boolean includeSubAgentStreamingEvents) { this.includeSubAgentStreamingEvents = includeSubAgentStreamingEvents; return this; } + /** + * Clears the includeSubAgentStreamingEvents setting, reverting to the default + * behavior. + * + * @return this instance for method chaining + */ + public ResumeSessionConfig clearIncludeSubAgentStreamingEvents() { + this.includeSubAgentStreamingEvents = null; + return this; + } + /** * Gets the model capabilities override. * @@ -500,6 +768,38 @@ public ResumeSessionConfig setMcpServers(Map mcpServers return this; } + /** + * Gets the MCP OAuth token storage mode. + * + * @return the storage mode, or {@code null} if not set + */ + public String getMcpOAuthTokenStorage() { + return mcpOAuthTokenStorage; + } + + /** + * Sets the MCP OAuth token storage mode. + *

+ * Controls how MCP OAuth tokens are stored for this session: + *

    + *
  • {@code "persistent"} β€” tokens are stored in the OS keychain (shared + * across sessions)
    • + *
  • {@code "in-memory"} β€” tokens are stored in memory and discarded when the + * session ends
    • + *
+ * If not set and the client is in {@link CopilotClientMode#EMPTY EMPTY} mode, + * the SDK defaults to {@code "in-memory"} for safe multitenant behavior. In + * other modes this field is left unset. + * + * @param mcpOAuthTokenStorage + * the storage mode + * @return this config for method chaining + */ + public ResumeSessionConfig setMcpOAuthTokenStorage(String mcpOAuthTokenStorage) { + this.mcpOAuthTokenStorage = mcpOAuthTokenStorage; + return this; + } + /** * Gets the custom agent configurations. * @@ -591,6 +891,69 @@ public ResumeSessionConfig setSkillDirectories(List skillDirectories) { return this; } + /** + * Gets the additional directories to search for custom instruction files. + * + * @return the list of instruction directory paths + */ + public List getInstructionDirectories() { + return instructionDirectories == null ? null : Collections.unmodifiableList(instructionDirectories); + } + + /** + * Sets additional directories to search for custom instruction files. + * + * @param instructionDirectories + * the list of instruction directory paths + * @return this config for method chaining + */ + public ResumeSessionConfig setInstructionDirectories(List instructionDirectories) { + this.instructionDirectories = instructionDirectories; + return this; + } + + /** + * Gets the plugin directories to load Open Plugin definitions from. + * + * @return the list of plugin directory paths + */ + public List getPluginDirectories() { + return pluginDirectories == null ? null : Collections.unmodifiableList(pluginDirectories); + } + + /** + * Sets the plugin directories to load Open Plugin definitions from. + * + * @param pluginDirectories + * the list of plugin directory paths + * @return this config for method chaining + */ + public ResumeSessionConfig setPluginDirectories(List pluginDirectories) { + this.pluginDirectories = pluginDirectories; + return this; + } + + /** + * Gets the configuration for large tool output handling. + * + * @return the large output config, or {@code null} for default + */ + public LargeToolOutputConfig getLargeOutput() { + return largeOutput; + } + + /** + * Sets the configuration for large tool output handling. + * + * @param largeOutput + * the large output config + * @return this config for method chaining + */ + public ResumeSessionConfig setLargeOutput(LargeToolOutputConfig largeOutput) { + this.largeOutput = largeOutput; + return this; + } + /** * Gets the disabled skills. * @@ -648,9 +1011,9 @@ public Consumer getOnEvent() { * Sets an event handler that is registered on the session before the * {@code session.resume} RPC is issued. *

- * Equivalent to calling - * {@link com.github.copilot.sdk.CopilotSession#on(Consumer)} immediately after - * resumption, but executes earlier in the lifecycle so no events are missed. + * Equivalent to calling {@link com.github.copilot.CopilotSession#on(Consumer)} + * immediately after resumption, but executes earlier in the lifecycle so no + * events are missed. * * @param onEvent * the event handler to register before session resumption @@ -711,6 +1074,85 @@ public ResumeSessionConfig setOnElicitationRequest(ElicitationHandler onElicitat return this; } + /** + * Returns whether MCP Apps (SEP-1865) UI passthrough is enabled on resume. + * + * @return {@code true} if the consumer has opted into MCP Apps, otherwise + * {@code false} + * @see #setEnableMcpApps(boolean) + */ + public boolean isEnableMcpApps() { + return enableMcpApps; + } + + /** + * Enables MCP Apps (SEP-1865) UI passthrough on the resumed session. See + * {@link SessionConfig#setEnableMcpApps(boolean)} for full semantics (runtime + * gate, capability inspection, renderer requirement). + * + * @param enableMcpApps + * {@code true} to opt into MCP Apps support on resume + * @return this config for method chaining + */ + public ResumeSessionConfig setEnableMcpApps(boolean enableMcpApps) { + this.enableMcpApps = enableMcpApps; + return this; + } + + /** + * Gets the exit-plan-mode request handler. + * + * @return the exit-plan-mode handler, or {@code null} + * @since 1.0.8 + */ + public ExitPlanModeHandler getOnExitPlanMode() { + return onExitPlanMode; + } + + /** + * Sets a handler for exit-plan-mode requests from the server. + *

+ * When provided, the server will route {@code exitPlanMode.request} callbacks + * to this handler. + * + * @param onExitPlanMode + * the exit-plan-mode handler + * @return this config for method chaining + * @see ExitPlanModeHandler + * @since 1.0.8 + */ + public ResumeSessionConfig setOnExitPlanMode(ExitPlanModeHandler onExitPlanMode) { + this.onExitPlanMode = onExitPlanMode; + return this; + } + + /** + * Gets the auto-mode-switch request handler. + * + * @return the auto-mode-switch handler, or {@code null} + * @since 1.0.8 + */ + public AutoModeSwitchHandler getOnAutoModeSwitch() { + return onAutoModeSwitch; + } + + /** + * Sets a handler for auto-mode-switch requests from the server. + *

+ * When provided, the server will route {@code autoModeSwitch.request} callbacks + * to this handler. + * + * @param onAutoModeSwitch + * the auto-mode-switch handler + * @return this config for method chaining + * @see AutoModeSwitchHandler + * @since 1.0.8 + */ + public ResumeSessionConfig setOnAutoModeSwitch(AutoModeSwitchHandler onAutoModeSwitch) { + this.onAutoModeSwitch = onAutoModeSwitch; + return this; + } + /** * Gets the GitHub token for per-session authentication. * @@ -738,6 +1180,34 @@ public ResumeSessionConfig setGitHubToken(String gitHubToken) { return this; } + /** + * Gets the per-session remote behavior control. + *

+ * See {@link SessionConfig#getRemoteSession()} for details on possible values. + * + * @return the remote session mode, or {@code null} if not set + * @since 1.4.0 + */ + public String getRemoteSession() { + return remoteSession; + } + + /** + * Sets the per-session remote behavior control. + *

+ * See {@link SessionConfig#setRemoteSession(String)} for details on possible + * values. + * + * @param remoteSession + * the remote session mode + * @return this config for method chaining + * @since 1.4.0 + */ + public ResumeSessionConfig setRemoteSession(String remoteSession) { + this.remoteSession = remoteSession; + return this; + } + /** * Creates a shallow clone of this {@code ResumeSessionConfig} instance. *

@@ -759,13 +1229,15 @@ public ResumeSessionConfig clone() { copy.availableTools = this.availableTools != null ? new ArrayList<>(this.availableTools) : null; copy.excludedTools = this.excludedTools != null ? new ArrayList<>(this.excludedTools) : null; copy.provider = this.provider; + copy.enableSessionTelemetry = this.enableSessionTelemetry; copy.reasoningEffort = this.reasoningEffort; + copy.reasoningSummary = this.reasoningSummary; copy.modelCapabilities = this.modelCapabilities; copy.onPermissionRequest = this.onPermissionRequest; copy.onUserInputRequest = this.onUserInputRequest; copy.hooks = this.hooks; copy.workingDirectory = this.workingDirectory; - copy.configDir = this.configDir; + copy.configDirectory = this.configDirectory; copy.enableConfigDiscovery = this.enableConfigDiscovery; copy.disableResume = this.disableResume; copy.streaming = this.streaming; @@ -775,12 +1247,21 @@ public ResumeSessionConfig clone() { copy.defaultAgent = this.defaultAgent; copy.agent = this.agent; copy.skillDirectories = this.skillDirectories != null ? new ArrayList<>(this.skillDirectories) : null; + copy.instructionDirectories = this.instructionDirectories != null + ? new ArrayList<>(this.instructionDirectories) + : null; + copy.pluginDirectories = this.pluginDirectories != null ? new ArrayList<>(this.pluginDirectories) : null; + copy.largeOutput = this.largeOutput; copy.disabledSkills = this.disabledSkills != null ? new ArrayList<>(this.disabledSkills) : null; copy.infiniteSessions = this.infiniteSessions; copy.onEvent = this.onEvent; copy.commands = this.commands != null ? new ArrayList<>(this.commands) : null; copy.onElicitationRequest = this.onElicitationRequest; + copy.onExitPlanMode = this.onExitPlanMode; + copy.onAutoModeSwitch = this.onAutoModeSwitch; + copy.enableMcpApps = this.enableMcpApps; copy.gitHubToken = this.gitHubToken; + copy.remoteSession = this.remoteSession; return copy; } } diff --git a/src/main/java/com/github/copilot/sdk/json/ResumeSessionRequest.java b/src/main/java/com/github/copilot/rpc/ResumeSessionRequest.java similarity index 61% rename from src/main/java/com/github/copilot/sdk/json/ResumeSessionRequest.java rename to src/main/java/com/github/copilot/rpc/ResumeSessionRequest.java index e36e90b675..5305639edc 100644 --- a/src/main/java/com/github/copilot/sdk/json/ResumeSessionRequest.java +++ b/src/main/java/com/github/copilot/rpc/ResumeSessionRequest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; @@ -16,9 +16,9 @@ *

* This is a low-level class for JSON-RPC communication. For resuming sessions, * use - * {@link com.github.copilot.sdk.CopilotClient#resumeSession(String, ResumeSessionConfig)}. + * {@link com.github.copilot.CopilotClient#resumeSession(String, ResumeSessionConfig)}. * - * @see com.github.copilot.sdk.CopilotClient#resumeSession(String, + * @see com.github.copilot.CopilotClient#resumeSession(String, * ResumeSessionConfig) * @see ResumeSessionConfig * @since 1.0.0 @@ -38,6 +38,9 @@ public final class ResumeSessionRequest { @JsonProperty("reasoningEffort") private String reasoningEffort; + @JsonProperty("reasoningSummary") + private String reasoningSummary; + @JsonProperty("tools") private List tools; @@ -50,9 +53,15 @@ public final class ResumeSessionRequest { @JsonProperty("excludedTools") private List excludedTools; + @JsonProperty("toolFilterPrecedence") + private String toolFilterPrecedence; + @JsonProperty("provider") private ProviderConfig provider; + @JsonProperty("enableSessionTelemetry") + private Boolean enableSessionTelemetry; + @JsonProperty("requestPermission") private Boolean requestPermission; @@ -66,7 +75,7 @@ public final class ResumeSessionRequest { private String workingDirectory; @JsonProperty("configDir") - private String configDir; + private String configDirectory; @JsonProperty("enableConfigDiscovery") private Boolean enableConfigDiscovery; @@ -83,6 +92,9 @@ public final class ResumeSessionRequest { @JsonProperty("mcpServers") private Map mcpServers; + @JsonProperty("mcpOAuthTokenStorage") + private String mcpOAuthTokenStorage; + @JsonProperty("envValueMode") private String envValueMode; @@ -98,6 +110,15 @@ public final class ResumeSessionRequest { @JsonProperty("skillDirectories") private List skillDirectories; + @JsonProperty("instructionDirectories") + private List instructionDirectories; + + @JsonProperty("pluginDirectories") + private List pluginDirectories; + + @JsonProperty("largeOutput") + private LargeToolOutputConfig largeOutput; + @JsonProperty("disabledSkills") private List disabledSkills; @@ -110,12 +131,24 @@ public final class ResumeSessionRequest { @JsonProperty("requestElicitation") private Boolean requestElicitation; + @JsonProperty("requestMcpApps") + private Boolean requestMcpApps; + + @JsonProperty("requestExitPlanMode") + private Boolean requestExitPlanMode; + + @JsonProperty("requestAutoModeSwitch") + private Boolean requestAutoModeSwitch; + @JsonProperty("modelCapabilities") private ModelCapabilitiesOverride modelCapabilities; @JsonProperty("gitHubToken") private String gitHubToken; + @JsonProperty("remoteSession") + private String remoteSession; + /** Gets the session ID. @return the session ID */ public String getSessionId() { return sessionId; @@ -158,6 +191,19 @@ public void setReasoningEffort(String reasoningEffort) { this.reasoningEffort = reasoningEffort; } + /** Gets the reasoning summary mode. @return the reasoning summary mode */ + public String getReasoningSummary() { + return reasoningSummary; + } + + /** + * Sets the reasoning summary mode. @param reasoningSummary the reasoning + * summary mode + */ + public void setReasoningSummary(String reasoningSummary) { + this.reasoningSummary = reasoningSummary; + } + /** Gets the tools. @return the tool definitions */ public List getTools() { return tools == null ? null : Collections.unmodifiableList(tools); @@ -201,6 +247,19 @@ public void setExcludedTools(List excludedTools) { this.excludedTools = excludedTools; } + /** Gets the tool filter precedence. @return the precedence value */ + public String getToolFilterPrecedence() { + return toolFilterPrecedence; + } + + /** + * Sets the tool filter precedence. @param toolFilterPrecedence the precedence + * ("excluded" or null) + */ + public void setToolFilterPrecedence(String toolFilterPrecedence) { + this.toolFilterPrecedence = toolFilterPrecedence; + } + /** Gets the provider config. @return the provider */ public ProviderConfig getProvider() { return provider; @@ -211,36 +270,76 @@ public void setProvider(ProviderConfig provider) { this.provider = provider; } + /** Gets enable session telemetry flag. @return the flag */ + public Boolean getEnableSessionTelemetry() { + return enableSessionTelemetry; + } + + /** + * Sets enable session telemetry flag. @param enableSessionTelemetry the flag + */ + public void setEnableSessionTelemetry(boolean enableSessionTelemetry) { + this.enableSessionTelemetry = enableSessionTelemetry; + } + + /** + * Clears the enableSessionTelemetry setting, reverting to the default behavior. + */ + public void clearEnableSessionTelemetry() { + this.enableSessionTelemetry = null; + } + /** Gets request permission flag. @return the flag */ public Boolean getRequestPermission() { return requestPermission; } /** Sets request permission flag. @param requestPermission the flag */ - public void setRequestPermission(Boolean requestPermission) { + public void setRequestPermission(boolean requestPermission) { this.requestPermission = requestPermission; } + /** + * Clears the requestPermission setting, reverting to the default behavior. + */ + public void clearRequestPermission() { + this.requestPermission = null; + } + /** Gets request user input flag. @return the flag */ public Boolean getRequestUserInput() { return requestUserInput; } /** Sets request user input flag. @param requestUserInput the flag */ - public void setRequestUserInput(Boolean requestUserInput) { + public void setRequestUserInput(boolean requestUserInput) { this.requestUserInput = requestUserInput; } + /** + * Clears the requestUserInput setting, reverting to the default behavior. + */ + public void clearRequestUserInput() { + this.requestUserInput = null; + } + /** Gets hooks flag. @return the flag */ public Boolean getHooks() { return hooks; } /** Sets hooks flag. @param hooks the flag */ - public void setHooks(Boolean hooks) { + public void setHooks(boolean hooks) { this.hooks = hooks; } + /** + * Clears the hooks setting, reverting to the default behavior. + */ + public void clearHooks() { + this.hooks = null; + } + /** Gets working directory. @return the working directory */ public String getWorkingDirectory() { return workingDirectory; @@ -252,13 +351,13 @@ public void setWorkingDirectory(String workingDirectory) { } /** Gets config directory. @return the config directory */ - public String getConfigDir() { - return configDir; + public String getConfigDirectory() { + return configDirectory; } - /** Sets config directory. @param configDir the config directory */ - public void setConfigDir(String configDir) { - this.configDir = configDir; + /** Sets config directory. @param configDirectory the config directory */ + public void setConfigDirectory(String configDirectory) { + this.configDirectory = configDirectory; } /** Gets enable config discovery flag. @return the flag */ @@ -267,30 +366,51 @@ public Boolean getEnableConfigDiscovery() { } /** Sets enable config discovery flag. @param enableConfigDiscovery the flag */ - public void setEnableConfigDiscovery(Boolean enableConfigDiscovery) { + public void setEnableConfigDiscovery(boolean enableConfigDiscovery) { this.enableConfigDiscovery = enableConfigDiscovery; } + /** + * Clears the enableConfigDiscovery setting, reverting to the default behavior. + */ + public void clearEnableConfigDiscovery() { + this.enableConfigDiscovery = null; + } + /** Gets disable resume flag. @return the flag */ public Boolean getDisableResume() { return disableResume; } /** Sets disable resume flag. @param disableResume the flag */ - public void setDisableResume(Boolean disableResume) { + public void setDisableResume(boolean disableResume) { this.disableResume = disableResume; } + /** + * Clears the disableResume setting, reverting to the default behavior. + */ + public void clearDisableResume() { + this.disableResume = null; + } + /** Gets streaming flag. @return the flag */ public Boolean getStreaming() { return streaming; } /** Sets streaming flag. @param streaming the flag */ - public void setStreaming(Boolean streaming) { + public void setStreaming(boolean streaming) { this.streaming = streaming; } + /** + * Clears the streaming setting, reverting to the default behavior. + */ + public void clearStreaming() { + this.streaming = null; + } + /** Gets include sub-agent streaming events flag. @return the flag */ public Boolean getIncludeSubAgentStreamingEvents() { return includeSubAgentStreamingEvents; @@ -300,10 +420,18 @@ public Boolean getIncludeSubAgentStreamingEvents() { * Sets include sub-agent streaming events flag. @param * includeSubAgentStreamingEvents the flag */ - public void setIncludeSubAgentStreamingEvents(Boolean includeSubAgentStreamingEvents) { + public void setIncludeSubAgentStreamingEvents(boolean includeSubAgentStreamingEvents) { this.includeSubAgentStreamingEvents = includeSubAgentStreamingEvents; } + /** + * Clears the includeSubAgentStreamingEvents setting, reverting to the default + * behavior. + */ + public void clearIncludeSubAgentStreamingEvents() { + this.includeSubAgentStreamingEvents = null; + } + /** Gets MCP servers. @return the servers map */ public Map getMcpServers() { return mcpServers == null ? null : Collections.unmodifiableMap(mcpServers); @@ -314,6 +442,19 @@ public void setMcpServers(Map mcpServers) { this.mcpServers = mcpServers; } + /** Gets MCP OAuth token storage mode. @return the storage mode */ + public String getMcpOAuthTokenStorage() { + return mcpOAuthTokenStorage; + } + + /** + * Sets MCP OAuth token storage mode. @param mcpOAuthTokenStorage the storage + * mode + */ + public void setMcpOAuthTokenStorage(String mcpOAuthTokenStorage) { + this.mcpOAuthTokenStorage = mcpOAuthTokenStorage; + } + /** Gets MCP environment variable value mode. @return the mode */ public String getEnvValueMode() { return envValueMode; @@ -366,6 +507,38 @@ public void setSkillDirectories(List skillDirectories) { this.skillDirectories = skillDirectories; } + /** Gets instruction directories. @return the instruction directories */ + public List getInstructionDirectories() { + return instructionDirectories == null ? null : Collections.unmodifiableList(instructionDirectories); + } + + /** + * Sets instruction directories. @param instructionDirectories the directories + */ + public void setInstructionDirectories(List instructionDirectories) { + this.instructionDirectories = instructionDirectories; + } + + /** Gets plugin directories. @return the plugin directories */ + public List getPluginDirectories() { + return pluginDirectories == null ? null : Collections.unmodifiableList(pluginDirectories); + } + + /** Sets plugin directories. @param pluginDirectories the directories */ + public void setPluginDirectories(List pluginDirectories) { + this.pluginDirectories = pluginDirectories; + } + + /** Gets large output config. @return the large output config */ + public LargeToolOutputConfig getLargeOutput() { + return largeOutput; + } + + /** Sets large output config. @param largeOutput the large output config */ + public void setLargeOutput(LargeToolOutputConfig largeOutput) { + this.largeOutput = largeOutput; + } + /** Gets disabled skills. @return the disabled skill names */ public List getDisabledSkills() { return disabledSkills == null ? null : Collections.unmodifiableList(disabledSkills); @@ -405,10 +578,54 @@ public Boolean getRequestElicitation() { } /** Sets the requestElicitation flag. @param requestElicitation the flag */ - public void setRequestElicitation(Boolean requestElicitation) { + public void setRequestElicitation(boolean requestElicitation) { this.requestElicitation = requestElicitation; } + /** + * Clears the requestElicitation setting, reverting to the default behavior. + */ + public void clearRequestElicitation() { + this.requestElicitation = null; + } + + /** Gets the requestMcpApps flag. @return the flag */ + public Boolean getRequestMcpApps() { + return requestMcpApps; + } + + /** Sets the requestMcpApps flag. @param requestMcpApps the flag */ + public void setRequestMcpApps(boolean requestMcpApps) { + this.requestMcpApps = requestMcpApps; + } + + /** Clears the requestMcpApps setting, reverting to the default behavior. */ + public void clearRequestMcpApps() { + this.requestMcpApps = null; + } + + /** Gets the requestExitPlanMode flag. @return the flag */ + public Boolean getRequestExitPlanMode() { + return requestExitPlanMode; + } + + /** Sets the requestExitPlanMode flag. @param requestExitPlanMode the flag */ + public void setRequestExitPlanMode(Boolean requestExitPlanMode) { + this.requestExitPlanMode = requestExitPlanMode; + } + + /** Gets the requestAutoModeSwitch flag. @return the flag */ + public Boolean getRequestAutoModeSwitch() { + return requestAutoModeSwitch; + } + + /** + * Sets the requestAutoModeSwitch flag. @param requestAutoModeSwitch the flag + */ + public void setRequestAutoModeSwitch(Boolean requestAutoModeSwitch) { + this.requestAutoModeSwitch = requestAutoModeSwitch; + } + /** Gets the model capabilities override. @return the override */ public ModelCapabilitiesOverride getModelCapabilities() { return modelCapabilities; @@ -433,4 +650,16 @@ public String getGitHubToken() { public void setGitHubToken(String gitHubToken) { this.gitHubToken = gitHubToken; } + + /** Gets the remote session mode. @return the remote session mode */ + public String getRemoteSession() { + return remoteSession; + } + + /** + * Sets the remote session mode. @param remoteSession the remote session mode + */ + public void setRemoteSession(String remoteSession) { + this.remoteSession = remoteSession; + } } diff --git a/src/main/java/com/github/copilot/sdk/json/ResumeSessionResponse.java b/src/main/java/com/github/copilot/rpc/ResumeSessionResponse.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/ResumeSessionResponse.java rename to src/main/java/com/github/copilot/rpc/ResumeSessionResponse.java index 8349c5d307..cd787d37fb 100644 --- a/src/main/java/com/github/copilot/sdk/json/ResumeSessionResponse.java +++ b/src/main/java/com/github/copilot/rpc/ResumeSessionResponse.java @@ -1,4 +1,4 @@ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/SectionOverride.java b/src/main/java/com/github/copilot/rpc/SectionOverride.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/SectionOverride.java rename to src/main/java/com/github/copilot/rpc/SectionOverride.java index 40a58449d3..cde6d20684 100644 --- a/src/main/java/com/github/copilot/sdk/json/SectionOverride.java +++ b/src/main/java/com/github/copilot/rpc/SectionOverride.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; import java.util.function.Function; @@ -13,7 +13,7 @@ /** * Override operation for a single system prompt section in - * {@link SystemMessageMode#CUSTOMIZE} mode. + * {@link com.github.copilot.SystemMessageMode#CUSTOMIZE} mode. *

* Each {@code SectionOverride} describes how one named section of the default * system prompt should be modified. The section name keys come from diff --git a/src/main/java/com/github/copilot/sdk/json/SectionOverrideAction.java b/src/main/java/com/github/copilot/rpc/SectionOverrideAction.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/SectionOverrideAction.java rename to src/main/java/com/github/copilot/rpc/SectionOverrideAction.java index 2d179f753f..f3569009b8 100644 --- a/src/main/java/com/github/copilot/sdk/json/SectionOverrideAction.java +++ b/src/main/java/com/github/copilot/rpc/SectionOverrideAction.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonValue; diff --git a/src/main/java/com/github/copilot/sdk/json/SendMessageRequest.java b/src/main/java/com/github/copilot/rpc/SendMessageRequest.java similarity index 71% rename from src/main/java/com/github/copilot/sdk/json/SendMessageRequest.java rename to src/main/java/com/github/copilot/rpc/SendMessageRequest.java index 2ef39770f0..c87dda7623 100644 --- a/src/main/java/com/github/copilot/sdk/json/SendMessageRequest.java +++ b/src/main/java/com/github/copilot/rpc/SendMessageRequest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; @@ -15,10 +15,10 @@ * Internal request object for sending a message to a session. *

* This is a low-level class for JSON-RPC communication. For sending messages, - * use {@link com.github.copilot.sdk.CopilotSession#send(String)} or - * {@link com.github.copilot.sdk.CopilotSession#sendAndWait(String)}. + * use {@link com.github.copilot.CopilotSession#send(String)} or + * {@link com.github.copilot.CopilotSession#sendAndWait(String)}. * - * @see com.github.copilot.sdk.CopilotSession + * @see com.github.copilot.CopilotSession * @see MessageOptions * @since 1.0.0 */ @@ -37,9 +37,15 @@ public final class SendMessageRequest { @JsonProperty("mode") private String mode; + @JsonProperty("agentMode") + private AgentMode agentMode; + @JsonProperty("requestHeaders") private Map requestHeaders; + @JsonProperty("displayPrompt") + private String displayPrompt; + /** Gets the session ID. @return the session ID */ public String getSessionId() { return sessionId; @@ -80,6 +86,16 @@ public void setMode(String mode) { this.mode = mode; } + /** Gets the per-message agent UI mode. @return the agent mode */ + public AgentMode getAgentMode() { + return agentMode; + } + + /** Sets the per-message agent UI mode. @param agentMode the agent mode */ + public void setAgentMode(AgentMode agentMode) { + this.agentMode = agentMode; + } + /** Gets the per-turn request headers. @return the headers map */ public Map getRequestHeaders() { return requestHeaders == null ? null : Collections.unmodifiableMap(requestHeaders); @@ -89,4 +105,19 @@ public Map getRequestHeaders() { public void setRequestHeaders(Map requestHeaders) { this.requestHeaders = requestHeaders; } + + /** Gets the display prompt. @return the display prompt */ + public String getDisplayPrompt() { + return displayPrompt; + } + + /** + * Sets the display prompt shown in the timeline instead of the prompt. + * + * @param displayPrompt + * the display prompt + */ + public void setDisplayPrompt(String displayPrompt) { + this.displayPrompt = displayPrompt; + } } diff --git a/src/main/java/com/github/copilot/sdk/json/SendMessageResponse.java b/src/main/java/com/github/copilot/rpc/SendMessageResponse.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/SendMessageResponse.java rename to src/main/java/com/github/copilot/rpc/SendMessageResponse.java index 7d79a7a2b2..b3d158864d 100644 --- a/src/main/java/com/github/copilot/sdk/json/SendMessageResponse.java +++ b/src/main/java/com/github/copilot/rpc/SendMessageResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/SessionCapabilities.java b/src/main/java/com/github/copilot/rpc/SessionCapabilities.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/SessionCapabilities.java rename to src/main/java/com/github/copilot/rpc/SessionCapabilities.java index 4eb4fc025c..b0daf4a5b9 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionCapabilities.java +++ b/src/main/java/com/github/copilot/rpc/SessionCapabilities.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Represents the capabilities reported by the host for a session. diff --git a/src/main/java/com/github/copilot/sdk/json/SessionConfig.java b/src/main/java/com/github/copilot/rpc/SessionConfig.java similarity index 54% rename from src/main/java/com/github/copilot/sdk/json/SessionConfig.java rename to src/main/java/com/github/copilot/rpc/SessionConfig.java index 09661346a2..79594c151d 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionConfig.java +++ b/src/main/java/com/github/copilot/rpc/SessionConfig.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.ArrayList; import java.util.Collections; @@ -11,8 +11,10 @@ import java.util.function.Consumer; import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonIgnore; -import com.github.copilot.sdk.generated.SessionEvent; +import com.github.copilot.generated.SessionEvent; +import java.util.Optional; /** * Configuration for creating a new Copilot session. @@ -30,7 +32,7 @@ * var session = client.createSession(config).get(); * } * - * @see com.github.copilot.sdk.CopilotClient#createSession(SessionConfig) + * @see com.github.copilot.CopilotClient#createSession(SessionConfig) * @since 1.0.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) @@ -40,11 +42,17 @@ public class SessionConfig { private String clientName; private String model; private String reasoningEffort; + private String reasoningSummary; private List tools; private SystemMessageConfig systemMessage; private List availableTools; private List excludedTools; private ProviderConfig provider; + private Boolean enableSessionTelemetry; + private Boolean skipCustomInstructions; + private Boolean customAgentsLocalOnly; + private Boolean coauthorEnabled; + private Boolean manageScheduleEnabled; private PermissionHandler onPermissionRequest; private UserInputHandler onUserInputRequest; private SessionHooks hooks; @@ -52,19 +60,28 @@ public class SessionConfig { private boolean streaming; private Boolean includeSubAgentStreamingEvents; private Map mcpServers; + private String mcpOAuthTokenStorage; private List customAgents; private DefaultAgentConfig defaultAgent; private String agent; private InfiniteSessionConfig infiniteSessions; private List skillDirectories; + private List instructionDirectories; + private List pluginDirectories; + private LargeToolOutputConfig largeOutput; private List disabledSkills; - private String configDir; + private String configDirectory; private Boolean enableConfigDiscovery; private ModelCapabilitiesOverride modelCapabilities; private Consumer onEvent; private List commands; private ElicitationHandler onElicitationRequest; + private ExitPlanModeHandler onExitPlanMode; + private AutoModeSwitchHandler onAutoModeSwitch; + private boolean enableMcpApps; private String gitHubToken; + private String remoteSession; + private CloudSessionOptions cloud; /** * Gets the custom session ID. @@ -159,6 +176,29 @@ public SessionConfig setReasoningEffort(String reasoningEffort) { return this; } + /** + * Gets the reasoning summary mode. + * + * @return the reasoning summary mode ("none", "concise", or "detailed") + */ + public String getReasoningSummary() { + return reasoningSummary; + } + + /** + * Sets the reasoning summary mode for models that support configurable + * reasoning summaries. Use {@code "none"} to suppress summary output regardless + * of whether reasoning is enabled. + * + * @param reasoningSummary + * the reasoning summary mode + * @return this config instance for method chaining + */ + public SessionConfig setReasoningSummary(String reasoningSummary) { + this.reasoningSummary = reasoningSummary; + return this; + } + /** * Gets the custom tools for this session. * @@ -197,9 +237,9 @@ public SystemMessageConfig getSystemMessage() { * Sets the system message configuration. *

* The system message controls the behavior and personality of the assistant. - * Use {@link com.github.copilot.sdk.SystemMessageMode#APPEND} to add - * instructions while preserving default behavior, or - * {@link com.github.copilot.sdk.SystemMessageMode#REPLACE} to fully customize. + * Use {@link com.github.copilot.SystemMessageMode#APPEND} to add instructions + * while preserving default behavior, or + * {@link com.github.copilot.SystemMessageMode#REPLACE} to fully customize. * * @param systemMessage * the system message configuration @@ -282,6 +322,219 @@ public SessionConfig setProvider(ProviderConfig provider) { return this; } + /** + * Enables or disables internal session telemetry for this session. When + * {@code false}, disables session telemetry. When unset (the default) or + * {@code true}, telemetry is enabled for GitHub-authenticated sessions. When a + * custom {@link ProviderConfig} (BYOK) is configured, session telemetry is + * always disabled regardless of this setting. This is independent of + * {@link com.github.copilot.rpc.CopilotClientOptions#getTelemetry() + * CopilotClientOptions.TelemetryConfig}, which configures OpenTelemetry export + * for observability. + * + * @return an {@link java.util.Optional} containing whether session telemetry is + * enabled, or {@link java.util.Optional#empty()} for the default + */ + @JsonIgnore + public Optional getEnableSessionTelemetry() { + return Optional.ofNullable(enableSessionTelemetry); + } + + /** + * Enables or disables internal session telemetry for this session. When + * {@code false}, disables session telemetry. When unset (the default) or + * {@code true}, telemetry is enabled for GitHub-authenticated sessions. When a + * custom {@link ProviderConfig} (BYOK) is configured, session telemetry is + * always disabled regardless of this setting. + * + * @param enableSessionTelemetry + * whether to enable session telemetry + * @return this config instance for method chaining + */ + public SessionConfig setEnableSessionTelemetry(boolean enableSessionTelemetry) { + this.enableSessionTelemetry = enableSessionTelemetry; + return this; + } + + /** + * Clears the enableSessionTelemetry setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public SessionConfig clearEnableSessionTelemetry() { + this.enableSessionTelemetry = null; + return this; + } + + /** + * Gets whether custom instruction file loading is suppressed. + * + * @return {@code true} to suppress, or empty if not explicitly set + * @since 1.3.0 + */ + @JsonIgnore + public Optional getSkipCustomInstructions() { + return Optional.ofNullable(skipCustomInstructions); + } + + /** + * Sets whether to suppress loading of custom instruction files (e.g. + * {@code .github/copilot-instructions.md}, {@code AGENTS.md}) from the working + * directory. + *

+ * This option is sent to the server via a {@code session.options.update} + * JSON-RPC call immediately after session creation. In + * {@link CopilotClientMode#EMPTY EMPTY} mode the default is {@code true} + * (skip); in {@link CopilotClientMode#COPILOT_CLI COPILOT_CLI} mode the value + * is forwarded only when explicitly set. + * + * @param skipCustomInstructions + * whether to skip custom instructions + * @return this config instance for method chaining + * @since 1.3.0 + */ + public SessionConfig setSkipCustomInstructions(boolean skipCustomInstructions) { + this.skipCustomInstructions = skipCustomInstructions; + return this; + } + + /** + * Clears the skipCustomInstructions setting. + * + * @return this instance for method chaining + * @since 1.3.0 + */ + public SessionConfig clearSkipCustomInstructions() { + this.skipCustomInstructions = null; + return this; + } + + /** + * Gets whether custom-agent discovery is restricted to local only. + * + * @return {@code true} for local only, or empty if not explicitly set + * @since 1.3.0 + */ + @JsonIgnore + public Optional getCustomAgentsLocalOnly() { + return Optional.ofNullable(customAgentsLocalOnly); + } + + /** + * Sets whether custom-agent discovery is restricted to the session's local + * working directory (no organisation-level discovery). + *

+ * This option is sent to the server via a {@code session.options.update} + * JSON-RPC call immediately after session creation. In + * {@link CopilotClientMode#EMPTY EMPTY} mode the default is {@code true} (local + * only); in {@link CopilotClientMode#COPILOT_CLI COPILOT_CLI} mode the value is + * forwarded only when explicitly set. + * + * @param customAgentsLocalOnly + * whether to restrict to local agents + * @return this config instance for method chaining + * @since 1.3.0 + */ + public SessionConfig setCustomAgentsLocalOnly(boolean customAgentsLocalOnly) { + this.customAgentsLocalOnly = customAgentsLocalOnly; + return this; + } + + /** + * Clears the customAgentsLocalOnly setting. + * + * @return this instance for method chaining + * @since 1.3.0 + */ + public SessionConfig clearCustomAgentsLocalOnly() { + this.customAgentsLocalOnly = null; + return this; + } + + /** + * Gets whether the runtime may append a Co-authored-by trailer. + * + * @return the coauthor enabled flag, or empty if not explicitly set + * @since 1.3.0 + */ + @JsonIgnore + public Optional getCoauthorEnabled() { + return Optional.ofNullable(coauthorEnabled); + } + + /** + * Sets whether the runtime is allowed to append a {@code Co-authored-by} + * trailer when it commits on behalf of the user. + *

+ * This option is sent to the server via a {@code session.options.update} + * JSON-RPC call immediately after session creation. In + * {@link CopilotClientMode#EMPTY EMPTY} mode the default is {@code false} + * (disabled); in {@link CopilotClientMode#COPILOT_CLI COPILOT_CLI} mode the + * value is forwarded only when explicitly set. + * + * @param coauthorEnabled + * whether coauthor is enabled + * @return this config instance for method chaining + * @since 1.3.0 + */ + public SessionConfig setCoauthorEnabled(boolean coauthorEnabled) { + this.coauthorEnabled = coauthorEnabled; + return this; + } + + /** + * Clears the coauthorEnabled setting. + * + * @return this instance for method chaining + * @since 1.3.0 + */ + public SessionConfig clearCoauthorEnabled() { + this.coauthorEnabled = null; + return this; + } + + /** + * Gets whether the manage_schedule tool is enabled. + * + * @return the manage schedule flag, or empty if not explicitly set + * @since 1.3.0 + */ + @JsonIgnore + public Optional getManageScheduleEnabled() { + return Optional.ofNullable(manageScheduleEnabled); + } + + /** + * Sets whether to enable the {@code manage_schedule} tool (host scheduler + * integration). + *

+ * This option is sent to the server via a {@code session.options.update} + * JSON-RPC call immediately after session creation. In + * {@link CopilotClientMode#EMPTY EMPTY} mode the default is {@code false} + * (disabled); in {@link CopilotClientMode#COPILOT_CLI COPILOT_CLI} mode the + * value is forwarded only when explicitly set. + * + * @param manageScheduleEnabled + * whether manage schedule is enabled + * @return this config instance for method chaining + * @since 1.3.0 + */ + public SessionConfig setManageScheduleEnabled(boolean manageScheduleEnabled) { + this.manageScheduleEnabled = manageScheduleEnabled; + return this; + } + + /** + * Clears the manageScheduleEnabled setting. + * + * @return this instance for method chaining + * @since 1.3.0 + */ + public SessionConfig clearManageScheduleEnabled() { + this.manageScheduleEnabled = null; + return this; + } + /** * Gets the permission request handler. * @@ -425,6 +678,38 @@ public SessionConfig setMcpServers(Map mcpServers) { return this; } + /** + * Gets the MCP OAuth token storage mode. + * + * @return the storage mode, or {@code null} if not set + */ + public String getMcpOAuthTokenStorage() { + return mcpOAuthTokenStorage; + } + + /** + * Sets the MCP OAuth token storage mode. + *

+ * Controls how MCP OAuth tokens are stored for this session: + *

    + *
  • {@code "persistent"} β€” tokens are stored in the OS keychain (shared + * across sessions)
    • + *
  • {@code "in-memory"} β€” tokens are stored in memory and discarded when the + * session ends
    • + *
+ * If not set and the client is in {@link CopilotClientMode#EMPTY EMPTY} mode, + * the SDK defaults to {@code "in-memory"} for safe multitenant behavior. In + * other modes this field is left unset. + * + * @param mcpOAuthTokenStorage + * the storage mode + * @return this config instance for method chaining + */ + public SessionConfig setMcpOAuthTokenStorage(String mcpOAuthTokenStorage) { + this.mcpOAuthTokenStorage = mcpOAuthTokenStorage; + return this; + } + /** * Gets the custom agent configurations. * @@ -550,6 +835,69 @@ public SessionConfig setSkillDirectories(List skillDirectories) { return this; } + /** + * Gets the additional directories to search for custom instruction files. + * + * @return the list of instruction directory paths + */ + public List getInstructionDirectories() { + return instructionDirectories == null ? null : Collections.unmodifiableList(instructionDirectories); + } + + /** + * Sets additional directories to search for custom instruction files. + * + * @param instructionDirectories + * the list of instruction directory paths + * @return this config instance for method chaining + */ + public SessionConfig setInstructionDirectories(List instructionDirectories) { + this.instructionDirectories = instructionDirectories; + return this; + } + + /** + * Gets the plugin directories to load Open Plugin definitions from. + * + * @return the list of plugin directory paths + */ + public List getPluginDirectories() { + return pluginDirectories == null ? null : Collections.unmodifiableList(pluginDirectories); + } + + /** + * Sets the plugin directories to load Open Plugin definitions from. + * + * @param pluginDirectories + * the list of plugin directory paths + * @return this config instance for method chaining + */ + public SessionConfig setPluginDirectories(List pluginDirectories) { + this.pluginDirectories = pluginDirectories; + return this; + } + + /** + * Gets the configuration for large tool output handling. + * + * @return the large output config, or {@code null} for default + */ + public LargeToolOutputConfig getLargeOutput() { + return largeOutput; + } + + /** + * Sets the configuration for large tool output handling. + * + * @param largeOutput + * the large output config + * @return this config instance for method chaining + */ + public SessionConfig setLargeOutput(LargeToolOutputConfig largeOutput) { + this.largeOutput = largeOutput; + return this; + } + /** * Gets the disabled skill names. * @@ -579,8 +927,8 @@ public SessionConfig setDisabledSkills(List disabledSkills) { * * @return the config directory path */ - public String getConfigDir() { - return configDir; + public String getConfigDirectory() { + return configDirectory; } /** @@ -589,23 +937,25 @@ public String getConfigDir() { * This allows using a specific directory for session configuration instead of * the default location. * - * @param configDir + * @param configDirectory * the configuration directory path * @return this config instance for method chaining */ - public SessionConfig setConfigDir(String configDir) { - this.configDir = configDir; + public SessionConfig setConfigDirectory(String configDirectory) { + this.configDirectory = configDirectory; return this; } /** * Gets whether automatic configuration discovery is enabled. * - * @return {@code true} to enable discovery, {@code false} to disable, or - * {@code null} to use the runtime default + * @return an {@link java.util.Optional} containing {@code true} to enable + * discovery or {@code false} to disable, or + * {@link java.util.Optional#empty()} to use the runtime default */ - public Boolean getEnableConfigDiscovery() { - return enableConfigDiscovery; + @JsonIgnore + public Optional getEnableConfigDiscovery() { + return Optional.ofNullable(enableConfigDiscovery); } /** @@ -619,23 +969,34 @@ public Boolean getEnableConfigDiscovery() { * name collision. * * @param enableConfigDiscovery - * {@code true} to enable discovery, {@code false} to disable, or - * {@code null} to use the runtime default + * {@code true} to enable discovery, {@code false} to disable * @return this config instance for method chaining */ - public SessionConfig setEnableConfigDiscovery(Boolean enableConfigDiscovery) { + public SessionConfig setEnableConfigDiscovery(boolean enableConfigDiscovery) { this.enableConfigDiscovery = enableConfigDiscovery; return this; } + /** + * Clears the enableConfigDiscovery setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public SessionConfig clearEnableConfigDiscovery() { + this.enableConfigDiscovery = null; + return this; + } + /** * Gets whether sub-agent streaming events are included. * - * @return {@code true} to include sub-agent streaming events, {@code false} to - * suppress them, or {@code null} to use the runtime default + * @return an {@link java.util.Optional} containing {@code true} to include + * sub-agent streaming events or {@code false} to suppress them, or + * {@link java.util.Optional#empty()} to use the runtime default */ - public Boolean getIncludeSubAgentStreamingEvents() { - return includeSubAgentStreamingEvents; + @JsonIgnore + public Optional getIncludeSubAgentStreamingEvents() { + return Optional.ofNullable(includeSubAgentStreamingEvents); } /** @@ -652,11 +1013,22 @@ public Boolean getIncludeSubAgentStreamingEvents() { * suppress * @return this config instance for method chaining */ - public SessionConfig setIncludeSubAgentStreamingEvents(Boolean includeSubAgentStreamingEvents) { + public SessionConfig setIncludeSubAgentStreamingEvents(boolean includeSubAgentStreamingEvents) { this.includeSubAgentStreamingEvents = includeSubAgentStreamingEvents; return this; } + /** + * Clears the includeSubAgentStreamingEvents setting, reverting to the default + * behavior. + * + * @return this instance for method chaining + */ + public SessionConfig clearIncludeSubAgentStreamingEvents() { + this.includeSubAgentStreamingEvents = null; + return this; + } + /** * Gets the model capabilities override. * @@ -697,12 +1069,12 @@ public Consumer getOnEvent() { * Sets an event handler that is registered on the session before the * {@code session.create} RPC is issued. *

- * Equivalent to calling - * {@link com.github.copilot.sdk.CopilotSession#on(Consumer)} immediately after - * creation, but executes earlier in the lifecycle so no events are missed. - * Using this property rather than {@code CopilotSession.on()} guarantees that - * early events emitted by the CLI during session creation (e.g. - * {@code session.start}) are delivered to the handler. + * Equivalent to calling {@link com.github.copilot.CopilotSession#on(Consumer)} + * immediately after creation, but executes earlier in the lifecycle so no + * events are missed. Using this property rather than + * {@code CopilotSession.on()} guarantees that early events emitted by the CLI + * during session creation (e.g. {@code session.start}) are delivered to the + * handler. * * @param onEvent * the event handler to register before session creation @@ -763,6 +1135,103 @@ public SessionConfig setOnElicitationRequest(ElicitationHandler onElicitationReq return this; } + /** + * Returns whether MCP Apps (SEP-1865) UI passthrough is enabled on this + * session. + * + * @return {@code true} if the consumer has opted into MCP Apps, otherwise + * {@code false} + * @see #setEnableMcpApps(boolean) + */ + public boolean isEnableMcpApps() { + return enableMcpApps; + } + + /** + * Enables MCP Apps (SEP-1865) UI passthrough on this session. + *

+ * When {@code true} and the runtime has MCP Apps enabled (via the + * {@code MCP_APPS} feature flag or {@code COPILOT_MCP_APPS=true} environment + * override), the runtime adds the {@code mcp-apps} capability to the session, + * which causes it to advertise the + * {@code extensions.io.modelcontextprotocol/ui} extension to MCP servers (so + * they expose {@code _meta.ui.resourceUri} on tools) and to expose the + * {@code session.rpc.mcp.apps.{listTools,callTool,readResource, + * setHostContext,getHostContext,diagnose}} JSON-RPC methods. + *

+ * If the runtime gate is off, the opt-in is silently dropped server-side (the + * runtime logs a warning); the session is created normally but the MCP Apps + * surface is unavailable. Inspect {@link SessionUiCapabilities#getMcpApps()} on + * {@link com.github.copilot.CopilotSession#getCapabilities()} to detect this. + *

+ * SDK consumers MUST set this to {@code true} only when they have an iframe + * renderer that can display {@code ui://} MCP App bundles. Setting it without a + * renderer will cause MCP servers to register UI-enabled tool variants the + * consumer cannot display. + * + * @param enableMcpApps + * {@code true} to opt into MCP Apps support + * @return this config instance for method chaining + */ + public SessionConfig setEnableMcpApps(boolean enableMcpApps) { + this.enableMcpApps = enableMcpApps; + return this; + } + + /** + * Gets the exit-plan-mode request handler. + * + * @return the exit-plan-mode handler, or {@code null} + * @since 1.0.8 + */ + public ExitPlanModeHandler getOnExitPlanMode() { + return onExitPlanMode; + } + + /** + * Sets a handler for exit-plan-mode requests from the server. + *

+ * When provided, the server will route {@code exitPlanMode.request} callbacks + * to this handler. + * + * @param onExitPlanMode + * the exit-plan-mode handler + * @return this config instance for method chaining + * @see ExitPlanModeHandler + * @since 1.0.8 + */ + public SessionConfig setOnExitPlanMode(ExitPlanModeHandler onExitPlanMode) { + this.onExitPlanMode = onExitPlanMode; + return this; + } + + /** + * Gets the auto-mode-switch request handler. + * + * @return the auto-mode-switch handler, or {@code null} + * @since 1.0.8 + */ + public AutoModeSwitchHandler getOnAutoModeSwitch() { + return onAutoModeSwitch; + } + + /** + * Sets a handler for auto-mode-switch requests from the server. + *

+ * When provided, the server will route {@code autoModeSwitch.request} callbacks + * to this handler. + * + * @param onAutoModeSwitch + * the auto-mode-switch handler + * @return this config instance for method chaining + * @see AutoModeSwitchHandler + * @since 1.0.8 + */ + public SessionConfig setOnAutoModeSwitch(AutoModeSwitchHandler onAutoModeSwitch) { + this.onAutoModeSwitch = onAutoModeSwitch; + return this; + } + /** * Gets the GitHub token for per-session authentication. * @@ -790,6 +1259,74 @@ public SessionConfig setGitHubToken(String gitHubToken) { return this; } + /** + * Gets the per-session remote behavior control. + *

+ * Possible values: + *

    + *
  • {@code "off"} β€” local only, no remote export (default)
    • + *
  • {@code "export"} β€” export session events to GitHub without enabling + * remote steering
    • + *
  • {@code "on"} β€” export to GitHub AND enable remote steering
    • + *
+ * + * @return the remote session mode, or {@code null} if not set + * @since 1.4.0 + */ + public String getRemoteSession() { + return remoteSession; + } + + /** + * Sets the per-session remote behavior control. + *

+ * Possible values: + *

    + *
  • {@code "off"} β€” local only, no remote export (default)
    • + *
  • {@code "export"} β€” export session events to GitHub without enabling + * remote steering
    • + *
  • {@code "on"} β€” export to GitHub AND enable remote steering
    • + *
+ * + * @param remoteSession + * the remote session mode + * @return this config instance for method chaining + * @since 1.4.0 + */ + public SessionConfig setRemoteSession(String remoteSession) { + this.remoteSession = remoteSession; + return this; + } + + /** + * Gets the cloud session options. + *

+ * When set, creates a remote session in the cloud instead of a local session. + * The optional repository is associated with the cloud session. + * + * @return the cloud session options, or {@code null} if not set + * @since 1.5.0 + */ + public CloudSessionOptions getCloud() { + return cloud; + } + + /** + * Sets the cloud session options. + *

+ * When set, creates a remote session in the cloud instead of a local session. + * The optional repository is associated with the cloud session. + * + * @param cloud + * the cloud session options + * @return this config instance for method chaining + * @since 1.5.0 + */ + public SessionConfig setCloud(CloudSessionOptions cloud) { + this.cloud = cloud; + return this; + } + /** * Creates a shallow clone of this {@code SessionConfig} instance. *

@@ -808,11 +1345,17 @@ public SessionConfig clone() { copy.clientName = this.clientName; copy.model = this.model; copy.reasoningEffort = this.reasoningEffort; + copy.reasoningSummary = this.reasoningSummary; copy.tools = this.tools != null ? new ArrayList<>(this.tools) : null; copy.systemMessage = this.systemMessage; copy.availableTools = this.availableTools != null ? new ArrayList<>(this.availableTools) : null; copy.excludedTools = this.excludedTools != null ? new ArrayList<>(this.excludedTools) : null; copy.provider = this.provider; + copy.enableSessionTelemetry = this.enableSessionTelemetry; + copy.skipCustomInstructions = this.skipCustomInstructions; + copy.customAgentsLocalOnly = this.customAgentsLocalOnly; + copy.coauthorEnabled = this.coauthorEnabled; + copy.manageScheduleEnabled = this.manageScheduleEnabled; copy.onPermissionRequest = this.onPermissionRequest; copy.onUserInputRequest = this.onUserInputRequest; copy.hooks = this.hooks; @@ -825,14 +1368,24 @@ public SessionConfig clone() { copy.agent = this.agent; copy.infiniteSessions = this.infiniteSessions; copy.skillDirectories = this.skillDirectories != null ? new ArrayList<>(this.skillDirectories) : null; + copy.instructionDirectories = this.instructionDirectories != null + ? new ArrayList<>(this.instructionDirectories) + : null; + copy.pluginDirectories = this.pluginDirectories != null ? new ArrayList<>(this.pluginDirectories) : null; + copy.largeOutput = this.largeOutput; copy.disabledSkills = this.disabledSkills != null ? new ArrayList<>(this.disabledSkills) : null; - copy.configDir = this.configDir; + copy.configDirectory = this.configDirectory; copy.enableConfigDiscovery = this.enableConfigDiscovery; copy.modelCapabilities = this.modelCapabilities; copy.onEvent = this.onEvent; copy.commands = this.commands != null ? new ArrayList<>(this.commands) : null; copy.onElicitationRequest = this.onElicitationRequest; + copy.onExitPlanMode = this.onExitPlanMode; + copy.onAutoModeSwitch = this.onAutoModeSwitch; + copy.enableMcpApps = this.enableMcpApps; copy.gitHubToken = this.gitHubToken; + copy.remoteSession = this.remoteSession; + copy.cloud = this.cloud; return copy; } } diff --git a/src/main/java/com/github/copilot/sdk/json/SessionContext.java b/src/main/java/com/github/copilot/rpc/SessionContext.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/SessionContext.java rename to src/main/java/com/github/copilot/rpc/SessionContext.java index fb6e16f8c6..1703082671 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionContext.java +++ b/src/main/java/com/github/copilot/rpc/SessionContext.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/SessionEndHandler.java b/src/main/java/com/github/copilot/rpc/SessionEndHandler.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/SessionEndHandler.java rename to src/main/java/com/github/copilot/rpc/SessionEndHandler.java index e8fc908df8..d7d6082618 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionEndHandler.java +++ b/src/main/java/com/github/copilot/rpc/SessionEndHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/SessionEndHookInput.java b/src/main/java/com/github/copilot/rpc/SessionEndHookInput.java similarity index 79% rename from src/main/java/com/github/copilot/sdk/json/SessionEndHookInput.java rename to src/main/java/com/github/copilot/rpc/SessionEndHookInput.java index 79f63fbb93..f29b698385 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionEndHookInput.java +++ b/src/main/java/com/github/copilot/rpc/SessionEndHookInput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; @@ -13,6 +13,8 @@ * This hook is invoked when a session ends, allowing you to perform cleanup or * logging. * + * @param sessionId + * the runtime session ID of the session that triggered the hook * @param timestamp * the timestamp in milliseconds since epoch when the session ended * @param cwd @@ -27,7 +29,8 @@ * @since 1.0.7 */ @JsonIgnoreProperties(ignoreUnknown = true) -public record SessionEndHookInput(@JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd, +public record SessionEndHookInput(@JsonProperty("sessionId") String sessionId, + @JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd, @JsonProperty("reason") String reason, @JsonProperty("finalMessage") String finalMessage, @JsonProperty("error") String error) { } diff --git a/src/main/java/com/github/copilot/sdk/json/SessionEndHookOutput.java b/src/main/java/com/github/copilot/rpc/SessionEndHookOutput.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/SessionEndHookOutput.java rename to src/main/java/com/github/copilot/rpc/SessionEndHookOutput.java index 23ebf958e0..068e85682a 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionEndHookOutput.java +++ b/src/main/java/com/github/copilot/rpc/SessionEndHookOutput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.List; diff --git a/src/main/java/com/github/copilot/sdk/json/SessionHooks.java b/src/main/java/com/github/copilot/rpc/SessionHooks.java similarity index 72% rename from src/main/java/com/github/copilot/sdk/json/SessionHooks.java rename to src/main/java/com/github/copilot/rpc/SessionHooks.java index 8e22c3ee88..f13e081316 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionHooks.java +++ b/src/main/java/com/github/copilot/rpc/SessionHooks.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Hook handlers configuration for a session. @@ -38,7 +38,9 @@ public class SessionHooks { private PreToolUseHandler onPreToolUse; + private PreMcpToolCallHandler onPreMcpToolCall; private PostToolUseHandler onPostToolUse; + private PostToolUseFailureHandler onPostToolUseFailure; private UserPromptSubmittedHandler onUserPromptSubmitted; private SessionStartHandler onSessionStart; private SessionEndHandler onSessionEnd; @@ -64,6 +66,30 @@ public SessionHooks setOnPreToolUse(PreToolUseHandler onPreToolUse) { return this; } + /** + * Gets the pre-MCP-tool-call handler. + * + * @return the handler, or {@code null} if not set + * @since 1.0.8 + */ + public PreMcpToolCallHandler getOnPreMcpToolCall() { + return onPreMcpToolCall; + } + + /** + * Sets the handler called before an MCP tool call is dispatched to an MCP + * server. + * + * @param onPreMcpToolCall + * the handler + * @return this instance for method chaining + * @since 1.0.8 + */ + public SessionHooks setOnPreMcpToolCall(PreMcpToolCallHandler onPreMcpToolCall) { + this.onPreMcpToolCall = onPreMcpToolCall; + return this; + } + /** * Gets the post-tool-use handler. * @@ -85,6 +111,32 @@ public SessionHooks setOnPostToolUse(PostToolUseHandler onPostToolUse) { return this; } + /** + * Gets the post-tool-use-failure handler. + * + * @return the handler, or {@code null} if not set + * @since 1.3.0 + */ + public PostToolUseFailureHandler getOnPostToolUseFailure() { + return onPostToolUseFailure; + } + + /** + * Sets the handler called after a tool execution whose result was a failure. + *

+ * {@link #getOnPostToolUse()} only fires for successful tool executions; + * register this handler in addition to observe failed tool calls. + * + * @param onPostToolUseFailure + * the handler + * @return this instance for method chaining + * @since 1.3.0 + */ + public SessionHooks setOnPostToolUseFailure(PostToolUseFailureHandler onPostToolUseFailure) { + this.onPostToolUseFailure = onPostToolUseFailure; + return this; + } + /** * Gets the user-prompt-submitted handler. * @@ -160,7 +212,7 @@ public SessionHooks setOnSessionEnd(SessionEndHandler onSessionEnd) { * @return {@code true} if at least one hook handler is set */ public boolean hasHooks() { - return onPreToolUse != null || onPostToolUse != null || onUserPromptSubmitted != null || onSessionStart != null - || onSessionEnd != null; + return onPreToolUse != null || onPreMcpToolCall != null || onPostToolUse != null || onPostToolUseFailure != null + || onUserPromptSubmitted != null || onSessionStart != null || onSessionEnd != null; } } diff --git a/src/main/java/com/github/copilot/sdk/json/SessionLifecycleEvent.java b/src/main/java/com/github/copilot/rpc/SessionLifecycleEvent.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/SessionLifecycleEvent.java rename to src/main/java/com/github/copilot/rpc/SessionLifecycleEvent.java index 59d1e252fa..55857a74a8 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionLifecycleEvent.java +++ b/src/main/java/com/github/copilot/rpc/SessionLifecycleEvent.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/SessionLifecycleEventMetadata.java b/src/main/java/com/github/copilot/rpc/SessionLifecycleEventMetadata.java similarity index 94% rename from src/main/java/com/github/copilot/sdk/json/SessionLifecycleEventMetadata.java rename to src/main/java/com/github/copilot/rpc/SessionLifecycleEventMetadata.java index 7c76c07aae..bf384a7ce7 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionLifecycleEventMetadata.java +++ b/src/main/java/com/github/copilot/rpc/SessionLifecycleEventMetadata.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/SessionLifecycleEventTypes.java b/src/main/java/com/github/copilot/rpc/SessionLifecycleEventTypes.java similarity index 90% rename from src/main/java/com/github/copilot/sdk/json/SessionLifecycleEventTypes.java rename to src/main/java/com/github/copilot/rpc/SessionLifecycleEventTypes.java index b3eb35598b..109c85b940 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionLifecycleEventTypes.java +++ b/src/main/java/com/github/copilot/rpc/SessionLifecycleEventTypes.java @@ -2,13 +2,13 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Types of session lifecycle events. *

* Constants for session lifecycle event types used with - * {@link com.github.copilot.sdk.CopilotClient#onLifecycle(String, SessionLifecycleHandler)}. + * {@link com.github.copilot.CopilotClient#onLifecycle(String, SessionLifecycleHandler)}. * * @since 1.0.0 */ diff --git a/src/main/java/com/github/copilot/sdk/json/SessionLifecycleHandler.java b/src/main/java/com/github/copilot/rpc/SessionLifecycleHandler.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/SessionLifecycleHandler.java rename to src/main/java/com/github/copilot/rpc/SessionLifecycleHandler.java index 11937ee643..755f2aa4ea 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionLifecycleHandler.java +++ b/src/main/java/com/github/copilot/rpc/SessionLifecycleHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Handler for session lifecycle events. diff --git a/src/main/java/com/github/copilot/sdk/json/SessionListFilter.java b/src/main/java/com/github/copilot/rpc/SessionListFilter.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/SessionListFilter.java rename to src/main/java/com/github/copilot/rpc/SessionListFilter.java index f62f7674f1..d6c4548525 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionListFilter.java +++ b/src/main/java/com/github/copilot/rpc/SessionListFilter.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Filter options for listing sessions. @@ -22,7 +22,7 @@ * var sessions = client.listSessions(filter).get(); * } * - * @see com.github.copilot.sdk.CopilotClient#listSessions(SessionListFilter) + * @see com.github.copilot.CopilotClient#listSessions(SessionListFilter) * @since 1.0.0 */ public class SessionListFilter extends SessionContext { diff --git a/src/main/java/com/github/copilot/sdk/json/SessionMetadata.java b/src/main/java/com/github/copilot/rpc/SessionMetadata.java similarity index 94% rename from src/main/java/com/github/copilot/sdk/json/SessionMetadata.java rename to src/main/java/com/github/copilot/rpc/SessionMetadata.java index cb2690d199..90207b9c7c 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionMetadata.java +++ b/src/main/java/com/github/copilot/rpc/SessionMetadata.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; @@ -11,7 +11,7 @@ * Metadata about an existing Copilot session. *

* This class represents session information returned when listing available - * sessions via {@link com.github.copilot.sdk.CopilotClient#listSessions()}. It + * sessions via {@link com.github.copilot.CopilotClient#listSessions()}. It * includes timing information, a summary of the conversation, and whether the * session is stored remotely. * @@ -26,8 +26,8 @@ * } * } * - * @see com.github.copilot.sdk.CopilotClient#listSessions() - * @see com.github.copilot.sdk.CopilotClient#resumeSession(String, + * @see com.github.copilot.CopilotClient#listSessions() + * @see com.github.copilot.CopilotClient#resumeSession(String, * ResumeSessionConfig) * @since 1.0.0 */ diff --git a/src/main/java/com/github/copilot/sdk/json/SessionStartHandler.java b/src/main/java/com/github/copilot/rpc/SessionStartHandler.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/SessionStartHandler.java rename to src/main/java/com/github/copilot/rpc/SessionStartHandler.java index fd631cb7f1..3c65a6944a 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionStartHandler.java +++ b/src/main/java/com/github/copilot/rpc/SessionStartHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/SessionStartHookInput.java b/src/main/java/com/github/copilot/rpc/SessionStartHookInput.java similarity index 77% rename from src/main/java/com/github/copilot/sdk/json/SessionStartHookInput.java rename to src/main/java/com/github/copilot/rpc/SessionStartHookInput.java index 2047175572..d6e5b37596 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionStartHookInput.java +++ b/src/main/java/com/github/copilot/rpc/SessionStartHookInput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; @@ -13,6 +13,8 @@ * This hook is invoked when a session starts, allowing you to perform * initialization or modify the session configuration. * + * @param sessionId + * the runtime session ID of the session that triggered the hook * @param timestamp * the timestamp in milliseconds since epoch when the session started * @param cwd @@ -24,6 +26,7 @@ * @since 1.0.7 */ @JsonIgnoreProperties(ignoreUnknown = true) -public record SessionStartHookInput(@JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd, +public record SessionStartHookInput(@JsonProperty("sessionId") String sessionId, + @JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd, @JsonProperty("source") String source, @JsonProperty("initialPrompt") String initialPrompt) { } diff --git a/src/main/java/com/github/copilot/sdk/json/SessionStartHookOutput.java b/src/main/java/com/github/copilot/rpc/SessionStartHookOutput.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/SessionStartHookOutput.java rename to src/main/java/com/github/copilot/rpc/SessionStartHookOutput.java index 3ef5971c43..2650a5efa1 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionStartHookOutput.java +++ b/src/main/java/com/github/copilot/rpc/SessionStartHookOutput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Map; diff --git a/src/main/java/com/github/copilot/sdk/json/SessionUiApi.java b/src/main/java/com/github/copilot/rpc/SessionUiApi.java similarity index 94% rename from src/main/java/com/github/copilot/sdk/json/SessionUiApi.java rename to src/main/java/com/github/copilot/rpc/SessionUiApi.java index f0a43f2610..1cf32e4680 100644 --- a/src/main/java/com/github/copilot/sdk/json/SessionUiApi.java +++ b/src/main/java/com/github/copilot/rpc/SessionUiApi.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; @@ -11,7 +11,7 @@ *

* All methods on this interface throw {@link IllegalStateException} if the host * does not report elicitation support via - * {@link com.github.copilot.sdk.CopilotSession#getCapabilities()}. Check + * {@link com.github.copilot.CopilotSession#getCapabilities()}. Check * {@code session.getCapabilities().getUi() != null && * Boolean.TRUE.equals(session.getCapabilities().getUi().getElicitation())} * before calling. @@ -25,7 +25,7 @@ * } * } * - * @see com.github.copilot.sdk.CopilotSession#getUi() + * @see com.github.copilot.CopilotSession#getUi() * @since 1.0.0 */ public interface SessionUiApi { diff --git a/src/main/java/com/github/copilot/rpc/SessionUiCapabilities.java b/src/main/java/com/github/copilot/rpc/SessionUiCapabilities.java new file mode 100644 index 0000000000..1d3397c8f4 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/SessionUiCapabilities.java @@ -0,0 +1,96 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.Optional; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * UI-specific capability flags for a session. + * + * @since 1.0.0 + */ +@JsonInclude(JsonInclude.Include.NON_NULL) +public class SessionUiCapabilities { + + @JsonProperty("elicitation") + private Boolean elicitation; + + @JsonProperty("mcpApps") + private Boolean mcpApps; + + /** + * Returns whether the host supports interactive elicitation dialogs. + * + * @return an {@link Optional} containing the boolean value, or empty if not set + */ + @JsonIgnore + public Optional getElicitation() { + return Optional.ofNullable(elicitation); + } + + /** + * Sets whether the host supports interactive elicitation dialogs. + * + * @param elicitation + * {@code true} if elicitation is supported + * @return this instance for method chaining + */ + public SessionUiCapabilities setElicitation(boolean elicitation) { + this.elicitation = elicitation; + return this; + } + + /** + * Clears the elicitation setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public SessionUiCapabilities clearElicitation() { + this.elicitation = null; + return this; + } + + /** + * Returns whether the runtime has accepted the session's MCP Apps (SEP-1865) + * opt-in. Present and {@code true} when the consumer set + * {@code enableMcpApps=true} on create/resume and the runtime's + * {@code MCP_APPS} feature flag (or {@code COPILOT_MCP_APPS=true} env override) + * is on. Otherwise empty or {@code false}, indicating the runtime silently + * dropped the opt-in. + * + * @return an {@link Optional} containing the boolean value, or empty if not set + */ + @JsonIgnore + public Optional getMcpApps() { + return Optional.ofNullable(mcpApps); + } + + /** + * Sets whether the runtime has accepted the MCP Apps opt-in. + * + * @param mcpApps + * {@code true} if MCP Apps is enabled for this session + * @return this instance for method chaining + */ + public SessionUiCapabilities setMcpApps(boolean mcpApps) { + this.mcpApps = mcpApps; + return this; + } + + /** + * Clears the mcpApps setting. + * + * @return this instance for method chaining + */ + public SessionUiCapabilities clearMcpApps() { + this.mcpApps = null; + return this; + } + +} diff --git a/src/main/java/com/github/copilot/rpc/SetForegroundSessionRequest.java b/src/main/java/com/github/copilot/rpc/SetForegroundSessionRequest.java new file mode 100644 index 0000000000..faa35406b5 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/SetForegroundSessionRequest.java @@ -0,0 +1,20 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Request body for session.setForeground RPC call. + *

+ * Using an explicit record type (rather than an ad-hoc map) ensures correct + * JSON serialization in all execution environments. + * + * @since 1.0.0 + */ +public record SetForegroundSessionRequest( + /** The session ID to bring to the foreground. */ + @JsonProperty("sessionId") String sessionId) { +} diff --git a/src/main/java/com/github/copilot/sdk/json/SetForegroundSessionResponse.java b/src/main/java/com/github/copilot/rpc/SetForegroundSessionResponse.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/SetForegroundSessionResponse.java rename to src/main/java/com/github/copilot/rpc/SetForegroundSessionResponse.java index c4680c95dd..43bc907359 100644 --- a/src/main/java/com/github/copilot/sdk/json/SetForegroundSessionResponse.java +++ b/src/main/java/com/github/copilot/rpc/SetForegroundSessionResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/SystemMessageConfig.java b/src/main/java/com/github/copilot/rpc/SystemMessageConfig.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/SystemMessageConfig.java rename to src/main/java/com/github/copilot/rpc/SystemMessageConfig.java index 94af117ea5..973168f4d4 100644 --- a/src/main/java/com/github/copilot/sdk/json/SystemMessageConfig.java +++ b/src/main/java/com/github/copilot/rpc/SystemMessageConfig.java @@ -2,12 +2,12 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Map; import com.fasterxml.jackson.annotation.JsonInclude; -import com.github.copilot.sdk.SystemMessageMode; +import com.github.copilot.SystemMessageMode; /** * Configuration for customizing the system message. diff --git a/src/main/java/com/github/copilot/sdk/json/SystemPromptSections.java b/src/main/java/com/github/copilot/rpc/SystemPromptSections.java similarity index 88% rename from src/main/java/com/github/copilot/sdk/json/SystemPromptSections.java rename to src/main/java/com/github/copilot/rpc/SystemPromptSections.java index fa512d032b..0aaf0113e6 100644 --- a/src/main/java/com/github/copilot/sdk/json/SystemPromptSections.java +++ b/src/main/java/com/github/copilot/rpc/SystemPromptSections.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Well-known system prompt section identifiers for use with @@ -54,6 +54,15 @@ public final class SystemPromptSections { /** Repository and organization custom instructions. */ public static final String CUSTOM_INSTRUCTIONS = "custom_instructions"; + /** + * Runtime-provided context and instructions (e.g. system notifications, + * memories, workspace context, mode-specific instructions, content-exclusion + * policy). + * + * @since 1.3.0 + */ + public static final String RUNTIME_INSTRUCTIONS = "runtime_instructions"; + /** * End-of-prompt instructions: parallel tool calling, persistence, task * completion. diff --git a/src/main/java/com/github/copilot/sdk/json/TelemetryConfig.java b/src/main/java/com/github/copilot/rpc/TelemetryConfig.java similarity index 82% rename from src/main/java/com/github/copilot/sdk/json/TelemetryConfig.java rename to src/main/java/com/github/copilot/rpc/TelemetryConfig.java index 8407ab6098..c0b75f29d6 100644 --- a/src/main/java/com/github/copilot/sdk/json/TelemetryConfig.java +++ b/src/main/java/com/github/copilot/rpc/TelemetryConfig.java @@ -2,7 +2,12 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; + +import java.util.Optional; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonInclude; /** * OpenTelemetry configuration for the Copilot CLI server. @@ -21,6 +26,7 @@ * @see CopilotClientOptions#setTelemetry(TelemetryConfig) * @since 1.2.0 */ +@JsonInclude(JsonInclude.Include.NON_NULL) public class TelemetryConfig { private String otlpEndpoint; @@ -128,11 +134,13 @@ public TelemetryConfig setSourceName(String sourceName) { * Maps to the {@code OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT} * environment variable. * - * @return {@code true} to capture content, {@code false} to suppress it, or - * {@code null} to use the default + * @return an {@link java.util.Optional} containing {@code true} to capture + * content or {@code false} to suppress it, or + * {@link java.util.Optional#empty()} to use the default */ - public Boolean getCaptureContent() { - return captureContent; + @JsonIgnore + public Optional getCaptureContent() { + return Optional.ofNullable(captureContent); } /** @@ -142,8 +150,19 @@ public Boolean getCaptureContent() { * {@code true} to capture content, {@code false} to suppress it * @return this config for method chaining */ - public TelemetryConfig setCaptureContent(Boolean captureContent) { + public TelemetryConfig setCaptureContent(boolean captureContent) { this.captureContent = captureContent; return this; } + + /** + * Clears the captureContent setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public TelemetryConfig clearCaptureContent() { + this.captureContent = null; + return this; + } + } diff --git a/src/main/java/com/github/copilot/sdk/json/ToolBinaryResult.java b/src/main/java/com/github/copilot/rpc/ToolBinaryResult.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/ToolBinaryResult.java rename to src/main/java/com/github/copilot/rpc/ToolBinaryResult.java index e00fce9cf6..f89b6a55f7 100644 --- a/src/main/java/com/github/copilot/sdk/json/ToolBinaryResult.java +++ b/src/main/java/com/github/copilot/rpc/ToolBinaryResult.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/ToolDefinition.java b/src/main/java/com/github/copilot/rpc/ToolDefinition.java similarity index 99% rename from src/main/java/com/github/copilot/sdk/json/ToolDefinition.java rename to src/main/java/com/github/copilot/rpc/ToolDefinition.java index ba33ce1e35..c880e5a77a 100644 --- a/src/main/java/com/github/copilot/sdk/json/ToolDefinition.java +++ b/src/main/java/com/github/copilot/rpc/ToolDefinition.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Map; diff --git a/src/main/java/com/github/copilot/sdk/json/ToolHandler.java b/src/main/java/com/github/copilot/rpc/ToolHandler.java similarity index 98% rename from src/main/java/com/github/copilot/sdk/json/ToolHandler.java rename to src/main/java/com/github/copilot/rpc/ToolHandler.java index e3e421b65f..15e52512e3 100644 --- a/src/main/java/com/github/copilot/sdk/json/ToolHandler.java +++ b/src/main/java/com/github/copilot/rpc/ToolHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/ToolInvocation.java b/src/main/java/com/github/copilot/rpc/ToolInvocation.java similarity index 99% rename from src/main/java/com/github/copilot/sdk/json/ToolInvocation.java rename to src/main/java/com/github/copilot/rpc/ToolInvocation.java index e5febba6ff..dddfdd06f0 100644 --- a/src/main/java/com/github/copilot/sdk/json/ToolInvocation.java +++ b/src/main/java/com/github/copilot/rpc/ToolInvocation.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Map; diff --git a/src/main/java/com/github/copilot/sdk/json/ToolResultObject.java b/src/main/java/com/github/copilot/rpc/ToolResultObject.java similarity index 99% rename from src/main/java/com/github/copilot/sdk/json/ToolResultObject.java rename to src/main/java/com/github/copilot/rpc/ToolResultObject.java index dcb5ad78f1..e55ff9ab6e 100644 --- a/src/main/java/com/github/copilot/sdk/json/ToolResultObject.java +++ b/src/main/java/com/github/copilot/rpc/ToolResultObject.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.List; import java.util.Map; diff --git a/src/main/java/com/github/copilot/rpc/ToolSet.java b/src/main/java/com/github/copilot/rpc/ToolSet.java new file mode 100644 index 0000000000..5009223a16 --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/ToolSet.java @@ -0,0 +1,122 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot.rpc; + +import java.util.ArrayList; +import java.util.Collection; +import java.util.Objects; +import java.util.regex.Pattern; + +/** + * Builder for {@link SessionConfig#setAvailableTools(java.util.List)} / + * {@link SessionConfig#setExcludedTools(java.util.List)} using source-qualified + * filter patterns ({@code builtin:*}, {@code mcp:}, {@code custom:*}, + * etc.). + *

+ * Tools are classified by the runtime at registration time (not from name + * parsing), so {@link #addBuiltIn(String)} matches only tools the runtime + * registered as built-in, even if an MCP server or custom-agent extension + * happens to register a tool with the same wire name. + *

+ * {@code ToolSet} extends {@link ArrayList} so instances can be passed directly + * to {@link SessionConfig#setAvailableTools(java.util.List)} or + * {@link SessionConfig#setExcludedTools(java.util.List)}. + * + *

Example

+ * + * 
{@code
+ * var session = client
+ * 		.createSession(new SessionConfig()
+ * 				.setAvailableTools(new ToolSet().addBuiltIn(BuiltInTools.ISOLATED).addMcp("*").addCustom("*")))
+ * 		.get();
+ * }
+ * + * @since 1.3.0 + */ +public class ToolSet extends ArrayList { + + private static final Pattern VALID_TOOL_NAME = Pattern.compile("^[a-zA-Z0-9_-]+$"); + + /** + * Adds a built-in tool pattern. + * + * @param name + * a specific built-in tool name (e.g. {@code "bash"}) or {@code "*"} + * to match all built-in tools + * @return this {@code ToolSet} for chaining + * @throws IllegalArgumentException + * if name is null, empty, or contains invalid characters + */ + public ToolSet addBuiltIn(String name) { + validateName("builtin", name); + add("builtin:" + name); + return this; + } + + /** + * Adds a list of built-in tool patterns (e.g. {@link BuiltInTools#ISOLATED}). + * + * @param names + * built-in tool names to add + * @return this {@code ToolSet} for chaining + * @throws NullPointerException + * if names is null + */ + public ToolSet addBuiltIn(Collection names) { + Objects.requireNonNull(names, "names must not be null"); + for (String name : names) { + addBuiltIn(name); + } + return this; + } + + /** + * Adds a custom tool pattern. Matches tools registered via the SDK's + * {@link SessionConfig#setTools(java.util.List)} option or via custom agents. + * + * @param name + * a specific custom tool name or {@code "*"} to match all custom + * tools + * @return this {@code ToolSet} for chaining + * @throws IllegalArgumentException + * if name is null, empty, or contains invalid characters + */ + public ToolSet addCustom(String name) { + validateName("custom", name); + add("custom:" + name); + return this; + } + + /** + * Adds an MCP tool pattern. Matches tools advertised by any configured MCP + * server. + * + * @param toolName + * the runtime's canonical wire name for the MCP tool (e.g. + * {@code "github-list_issues"}), or {@code "*"} to match all MCP + * tools from any server + * @return this {@code ToolSet} for chaining + * @throws IllegalArgumentException + * if toolName is null, empty, or contains invalid characters + */ + public ToolSet addMcp(String toolName) { + validateName("mcp", toolName); + add("mcp:" + toolName); + return this; + } + + private static void validateName(String kind, String name) { + if (name == null || name.isEmpty()) { + throw new IllegalArgumentException("Invalid " + kind + " tool name: must not be null or empty."); + } + if ("*".equals(name)) { + return; + } + if (!VALID_TOOL_NAME.matcher(name).matches()) { + throw new IllegalArgumentException("Invalid " + kind + " tool name '" + name + + "': tool names must match /^[a-zA-Z0-9_-]+$/ or be the wildcard '*'."); + } + } +} diff --git a/src/main/java/com/github/copilot/sdk/json/UserInputHandler.java b/src/main/java/com/github/copilot/rpc/UserInputHandler.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/UserInputHandler.java rename to src/main/java/com/github/copilot/rpc/UserInputHandler.java index e5d1710989..7595bc5b97 100644 --- a/src/main/java/com/github/copilot/sdk/json/UserInputHandler.java +++ b/src/main/java/com/github/copilot/rpc/UserInputHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/UserInputInvocation.java b/src/main/java/com/github/copilot/rpc/UserInputInvocation.java similarity index 95% rename from src/main/java/com/github/copilot/sdk/json/UserInputInvocation.java rename to src/main/java/com/github/copilot/rpc/UserInputInvocation.java index 3232b0c344..3eed480ca3 100644 --- a/src/main/java/com/github/copilot/sdk/json/UserInputInvocation.java +++ b/src/main/java/com/github/copilot/rpc/UserInputInvocation.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; /** * Context for a user input request invocation. diff --git a/src/main/java/com/github/copilot/sdk/json/UserInputRequest.java b/src/main/java/com/github/copilot/rpc/UserInputRequest.java similarity index 74% rename from src/main/java/com/github/copilot/sdk/json/UserInputRequest.java rename to src/main/java/com/github/copilot/rpc/UserInputRequest.java index 9b466f866c..8e3551c5ac 100644 --- a/src/main/java/com/github/copilot/sdk/json/UserInputRequest.java +++ b/src/main/java/com/github/copilot/rpc/UserInputRequest.java @@ -2,13 +2,16 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.Collections; import java.util.List; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.Optional; /** * Request for user input from the agent. @@ -19,6 +22,7 @@ * @since 1.0.6 */ @JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) public class UserInputRequest { @JsonProperty("question") @@ -75,11 +79,13 @@ public UserInputRequest setChoices(List choices) { /** * Returns whether freeform text input is allowed. * - * @return {@code true} if freeform input is allowed, {@code null} if not + * @return an {@link java.util.Optional} containing {@code true} if freeform + * input is allowed, or {@link java.util.Optional#empty()} if not * specified */ - public Boolean getAllowFreeform() { - return allowFreeform; + @JsonIgnore + public Optional getAllowFreeform() { + return Optional.ofNullable(allowFreeform); } /** @@ -89,8 +95,19 @@ public Boolean getAllowFreeform() { * {@code true} to allow freeform input * @return this instance for method chaining */ - public UserInputRequest setAllowFreeform(Boolean allowFreeform) { + public UserInputRequest setAllowFreeform(boolean allowFreeform) { this.allowFreeform = allowFreeform; return this; } + + /** + * Clears the allowFreeform setting, reverting to the default behavior. + * + * @return this instance for method chaining + */ + public UserInputRequest clearAllowFreeform() { + this.allowFreeform = null; + return this; + } + } diff --git a/src/main/java/com/github/copilot/sdk/json/UserInputResponse.java b/src/main/java/com/github/copilot/rpc/UserInputResponse.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/UserInputResponse.java rename to src/main/java/com/github/copilot/rpc/UserInputResponse.java index 4cfaa13f02..c9e0133c74 100644 --- a/src/main/java/com/github/copilot/sdk/json/UserInputResponse.java +++ b/src/main/java/com/github/copilot/rpc/UserInputResponse.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHandler.java b/src/main/java/com/github/copilot/rpc/UserPromptSubmittedHandler.java similarity index 97% rename from src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHandler.java rename to src/main/java/com/github/copilot/rpc/UserPromptSubmittedHandler.java index 0dc59762be..e0953ed7f7 100644 --- a/src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHandler.java +++ b/src/main/java/com/github/copilot/rpc/UserPromptSubmittedHandler.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import java.util.concurrent.CompletableFuture; diff --git a/src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHookInput.java b/src/main/java/com/github/copilot/rpc/UserPromptSubmittedHookInput.java similarity index 75% rename from src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHookInput.java rename to src/main/java/com/github/copilot/rpc/UserPromptSubmittedHookInput.java index bbfdf85bb3..8b37df6773 100644 --- a/src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHookInput.java +++ b/src/main/java/com/github/copilot/rpc/UserPromptSubmittedHookInput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; @@ -13,6 +13,8 @@ * This hook is invoked when the user submits a prompt, allowing you to * intercept and modify the prompt before it is processed. * + * @param sessionId + * the runtime session ID of the session that triggered the hook * @param timestamp * the timestamp in milliseconds since epoch when the prompt was * submitted @@ -23,6 +25,7 @@ * @since 1.0.7 */ @JsonIgnoreProperties(ignoreUnknown = true) -public record UserPromptSubmittedHookInput(@JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd, +public record UserPromptSubmittedHookInput(@JsonProperty("sessionId") String sessionId, + @JsonProperty("timestamp") long timestamp, @JsonProperty("cwd") String cwd, @JsonProperty("prompt") String prompt) { } diff --git a/src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHookOutput.java b/src/main/java/com/github/copilot/rpc/UserPromptSubmittedHookOutput.java similarity index 96% rename from src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHookOutput.java rename to src/main/java/com/github/copilot/rpc/UserPromptSubmittedHookOutput.java index d5b345556d..ac37f2bd98 100644 --- a/src/main/java/com/github/copilot/sdk/json/UserPromptSubmittedHookOutput.java +++ b/src/main/java/com/github/copilot/rpc/UserPromptSubmittedHookOutput.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.json; +package com.github.copilot.rpc; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; diff --git a/src/main/java/com/github/copilot/rpc/package-info.java b/src/main/java/com/github/copilot/rpc/package-info.java new file mode 100644 index 0000000000..edc7dedcfc --- /dev/null +++ b/src/main/java/com/github/copilot/rpc/package-info.java @@ -0,0 +1,95 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +/** + * Configuration classes and data transfer objects for the Copilot SDK. + * + *

+ * This package contains all the configuration, request, response, and data + * transfer objects used throughout the SDK. These classes are designed for JSON + * serialization with Jackson and provide fluent setter methods for convenient + * configuration. + * + *

Client Configuration

+ *
    + *
  • {@link com.github.copilot.rpc.CopilotClientOptions} - Options for + * configuring the {@link com.github.copilot.CopilotClient}, including CLI path, + * port, transport mode, and auto-start behavior.
    • + *
+ * + *

Session Configuration

+ *
    + *
  • {@link com.github.copilot.rpc.SessionConfig} - Configuration for creating + * a new session, including model selection, tools, system message, and MCP + * server configuration.
    • + *
  • {@link com.github.copilot.rpc.ResumeSessionConfig} - Configuration for + * resuming an existing session.
    • + *
  • {@link com.github.copilot.rpc.InfiniteSessionConfig} - Configuration for + * infinite sessions with automatic context compaction.
    • + *
  • {@link com.github.copilot.rpc.SystemMessageConfig} - System message + * customization options.
    • + *
+ * + *

Message and Tool Configuration

+ *
    + *
  • {@link com.github.copilot.rpc.MessageOptions} - Options for sending + * messages, including prompt text and attachments.
    • + *
  • {@link com.github.copilot.rpc.ToolDefinition} - Definition of a custom + * tool that can be invoked by the assistant.
    • + *
  • {@link com.github.copilot.rpc.ToolInvocation} - Represents a tool + * invocation request from the assistant.
    • + *
  • {@link com.github.copilot.rpc.Attachment} - File attachment for + * messages.
    • + *
+ * + *

Provider Configuration (BYOK)

+ *
    + *
  • {@link com.github.copilot.rpc.ProviderConfig} - Configuration for using + * your own API keys with custom providers (OpenAI, Azure, etc.).
    • + *
  • {@link com.github.copilot.rpc.AzureOptions} - Azure-specific + * configuration options.
    • + *
+ * + *

Model Information

+ *
    + *
  • {@link com.github.copilot.rpc.ModelInfo} - Information about an available + * AI model.
    • + *
  • {@link com.github.copilot.rpc.ModelCapabilities} - Model capabilities and + * limits.
    • + *
  • {@link com.github.copilot.rpc.ModelPolicy} - Model policy and state + * information.
    • + *
+ * + *

Custom Agents

+ *
    + *
  • {@link com.github.copilot.rpc.CustomAgentConfig} - Configuration for + * custom agents with specialized behaviors and tools.
    • + *
+ * + *

Permissions

+ *
    + *
  • {@link com.github.copilot.rpc.PermissionHandler} - Handler for permission + * requests from the assistant.
    • + *
  • {@link com.github.copilot.rpc.PermissionRequest} - A permission request + * from the assistant.
    • + *
  • {@link com.github.copilot.rpc.PermissionRequestResult} - Result of a + * permission request decision.
    • + *
+ * + *

Usage Example

+ * + * 
{@code
+ * var config = new SessionConfig().setModel("gpt-4.1").setStreaming(true)
+ * 		.setSystemMessage(new SystemMessageConfig().setMode(SystemMessageMode.APPEND)
+ * 				.setContent("Be concise in your responses."))
+ * 		.setTools(List.of(ToolDefinition.create("my_tool", "Description", schema, handler)));
+ *
+ * var session = client.createSession(config).get();
+ * }
+ * + * @see com.github.copilot.CopilotClient + * @see com.github.copilot.CopilotSession + */ +@edu.umd.cs.findbugs.annotations.SuppressFBWarnings(value = "EI_EXPOSE_REP2", justification = "DTOs for JSON deserialization - low risk") +package com.github.copilot.rpc; diff --git a/src/main/java/com/github/copilot/sdk/CopilotClient.java b/src/main/java/com/github/copilot/sdk/CopilotClient.java deleted file mode 100644 index 4b3bb0904f..0000000000 --- a/src/main/java/com/github/copilot/sdk/CopilotClient.java +++ /dev/null @@ -1,828 +0,0 @@ -/*--------------------------------------------------------------------------------------------- - * Copyright (c) Microsoft Corporation. All rights reserved. - *--------------------------------------------------------------------------------------------*/ - -package com.github.copilot.sdk; - -import java.io.IOException; -import java.net.URI; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Map; -import java.util.concurrent.CompletableFuture; -import java.util.concurrent.CompletionException; -import java.util.concurrent.ConcurrentHashMap; -import java.util.concurrent.Executor; -import java.util.concurrent.RejectedExecutionException; -import java.util.concurrent.TimeUnit; -import java.util.logging.Level; -import java.util.logging.Logger; - -import com.github.copilot.sdk.json.CopilotClientOptions; -import com.github.copilot.sdk.json.CreateSessionResponse; -import com.github.copilot.sdk.generated.rpc.ServerRpc; -import com.github.copilot.sdk.json.DeleteSessionResponse; -import com.github.copilot.sdk.json.GetAuthStatusResponse; -import com.github.copilot.sdk.json.GetLastSessionIdResponse; -import com.github.copilot.sdk.json.GetSessionMetadataResponse; -import com.github.copilot.sdk.json.GetModelsResponse; -import com.github.copilot.sdk.json.GetStatusResponse; -import com.github.copilot.sdk.json.ListSessionsResponse; -import com.github.copilot.sdk.json.ModelInfo; -import com.github.copilot.sdk.json.PingResponse; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.ResumeSessionResponse; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SessionLifecycleHandler; -import com.github.copilot.sdk.json.SessionListFilter; -import com.github.copilot.sdk.json.SessionMetadata; - -/** - * Provides a client for interacting with the Copilot CLI server. - *

- * The CopilotClient manages the connection to the Copilot CLI server and - * provides methods to create and manage conversation sessions. It can either - * spawn a CLI server process or connect to an existing server. - *

- * Example usage: - * - * 

{@code
- * try (var client = new CopilotClient()) {
- * 	client.start().get();
- *
- * 	var session = client
- * 			.createSession(
- * 					new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL).setModel("gpt-5"))
- * 			.get();
- *
- * 	session.on(AssistantMessageEvent.class, msg -> {
- * 		System.out.println(msg.getData().content());
- * 	});
- *
- * 	session.send(new MessageOptions().setPrompt("Hello!")).get();
- * }
- * }
- * - * @since 1.0.0 - */ -public final class CopilotClient implements AutoCloseable { - - private static final Logger LOG = Logger.getLogger(CopilotClient.class.getName()); - - /** - * Timeout, in seconds, used by {@link #close()} when waiting for graceful - * shutdown via {@link #stop()}. - */ - public static final int AUTOCLOSEABLE_TIMEOUT_SECONDS = 10; - private final CopilotClientOptions options; - private final CliServerManager serverManager; - private final LifecycleEventManager lifecycleManager = new LifecycleEventManager(); - private final Map sessions = new ConcurrentHashMap<>(); - private volatile CompletableFuture connectionFuture; - private volatile boolean disposed = false; - private final String optionsHost; - private final Integer optionsPort; - private volatile List modelsCache; - private final Object modelsCacheLock = new Object(); - - /** - * Creates a new CopilotClient with default options. - */ - public CopilotClient() { - this(new CopilotClientOptions()); - } - - /** - * Creates a new CopilotClient with the specified options. - * - * @param options - * Options for creating the client - * @throws IllegalArgumentException - * if mutually exclusive options are provided - */ - public CopilotClient(CopilotClientOptions options) { - this.options = options != null ? options : new CopilotClientOptions(); - - // When cliUrl is set, auto-correct useStdio since we're connecting via TCP - if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty()) { - this.options.setUseStdio(false); - } - - // Validate mutually exclusive options: cliUrl and cliPath cannot both be set - if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty() - && this.options.getCliPath() != null) { - throw new IllegalArgumentException("CliUrl is mutually exclusive with CliPath"); - } - - // Validate auth options with external server - if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty() - && (this.options.getGitHubToken() != null || this.options.getUseLoggedInUser() != null)) { - throw new IllegalArgumentException( - "GitHubToken and UseLoggedInUser cannot be used with CliUrl (external server manages its own auth)"); - } - - // Parse CliUrl if provided - if (this.options.getCliUrl() != null && !this.options.getCliUrl().isEmpty()) { - URI uri = CliServerManager.parseCliUrl(this.options.getCliUrl()); - this.optionsHost = uri.getHost(); - this.optionsPort = uri.getPort(); - } else { - this.optionsHost = null; - this.optionsPort = null; - } - - this.serverManager = new CliServerManager(this.options); - } - - /** - * Starts the Copilot client and connects to the server. - * - * @return A future that completes when the connection is established - */ - public CompletableFuture start() { - if (connectionFuture == null) { - synchronized (this) { - if (connectionFuture == null) { - connectionFuture = startCore(); - } - } - } - return connectionFuture.thenApply(c -> null); - } - - private CompletableFuture startCore() { - LOG.fine("Starting Copilot client"); - - Executor exec = options.getExecutor(); - try { - return exec != null - ? CompletableFuture.supplyAsync(this::startCoreBody, exec) - : CompletableFuture.supplyAsync(this::startCoreBody); - } catch (RejectedExecutionException e) { - return CompletableFuture.failedFuture(e); - } - } - - private Connection startCoreBody() { - try { - JsonRpcClient rpc; - Process process = null; - - if (optionsHost != null && optionsPort != null) { - // External server (TCP) - rpc = serverManager.connectToServer(null, optionsHost, optionsPort); - } else { - // Child process (stdio or TCP) - CliServerManager.ProcessInfo processInfo = serverManager.startCliServer(); - process = processInfo.process(); - rpc = serverManager.connectToServer(process, processInfo.port() != null ? "localhost" : null, - processInfo.port()); - } - - Connection connection = new Connection(rpc, process, new ServerRpc(rpc::invoke)); - - // Register handlers for server-to-client calls - RpcHandlerDispatcher dispatcher = new RpcHandlerDispatcher(sessions, lifecycleManager::dispatch, - options.getExecutor()); - dispatcher.registerHandlers(rpc); - - // Verify protocol version - verifyProtocolVersion(connection); - - LOG.info("Copilot client connected"); - return connection; - } catch (Exception e) { - String stderr = serverManager.getStderrOutput(); - if (!stderr.isEmpty()) { - throw new CompletionException(new IOException("CLI process exited unexpectedly. stderr: " + stderr, e)); - } - throw new CompletionException(e); - } - } - - private static final int MIN_PROTOCOL_VERSION = 2; - - private void verifyProtocolVersion(Connection connection) throws Exception { - int expectedVersion = SdkProtocolVersion.get(); - var params = new HashMap(); - params.put("message", null); - PingResponse pingResponse = connection.rpc.invoke("ping", params, PingResponse.class).get(30, TimeUnit.SECONDS); - - if (pingResponse.protocolVersion() == null) { - throw new RuntimeException("SDK protocol version mismatch: SDK expects version " + expectedVersion - + ", but server does not report a protocol version. " - + "Please update your server to ensure compatibility."); - } - - int serverVersion = pingResponse.protocolVersion(); - if (serverVersion < MIN_PROTOCOL_VERSION || serverVersion > expectedVersion) { - throw new RuntimeException("SDK protocol version mismatch: SDK expects version " + expectedVersion - + " (minimum " + MIN_PROTOCOL_VERSION + "), but server reports version " + serverVersion + ". " - + "Please update your SDK or server to ensure compatibility."); - } - } - - /** - * Disconnects from the Copilot server and closes all active sessions. - *

- * This method performs graceful cleanup: - *

    - *
  1. Closes all active sessions (releases in-memory resources)
    2. - *
  2. Closes the JSON-RPC connection
    3. - *
  3. Terminates the CLI server process (if spawned by this client)
    4. - *
- *

- * Note: session data on disk is preserved, so sessions can be resumed later. To - * permanently remove session data before stopping, call - * {@link #deleteSession(String)} for each session first. - * - * @return A future that completes when the client is stopped - */ - public CompletableFuture stop() { - var closeFutures = new ArrayList>(); - Executor exec = options.getExecutor(); - - for (CopilotSession session : new ArrayList<>(sessions.values())) { - Runnable closeTask = () -> { - try { - session.close(); - } catch (Exception e) { - LOG.log(Level.WARNING, "Error closing session " + session.getSessionId(), e); - } - }; - CompletableFuture future; - try { - future = exec != null - ? CompletableFuture.runAsync(closeTask, exec) - : CompletableFuture.runAsync(closeTask); - } catch (RejectedExecutionException e) { - LOG.log(Level.WARNING, "Executor rejected session close task; closing inline", e); - closeTask.run(); - future = CompletableFuture.completedFuture(null); - } - closeFutures.add(future); - } - sessions.clear(); - - return CompletableFuture.allOf(closeFutures.toArray(new CompletableFuture[0])) - .thenCompose(v -> cleanupConnection()); - } - - /** - * Forces an immediate stop of the client without graceful cleanup. - * - * @return A future that completes when the client is stopped - */ - public CompletableFuture forceStop() { - disposed = true; - sessions.clear(); - return cleanupConnection(); - } - - private CompletableFuture cleanupConnection() { - CompletableFuture future = connectionFuture; - connectionFuture = null; - - // Clear models cache - modelsCache = null; - - if (future == null) { - return CompletableFuture.completedFuture(null); - } - - return future.thenAccept(connection -> { - try { - connection.rpc.close(); - } catch (Exception e) { - LOG.log(Level.FINE, "Error closing RPC", e); - } - - if (connection.process != null) { - try { - if (connection.process.isAlive()) { - connection.process.destroyForcibly(); - } - } catch (Exception e) { - LOG.log(Level.FINE, "Error killing process", e); - } - } - }).exceptionally(ex -> null); - } - - /** - * Creates a new Copilot session with the specified configuration. - *

- * The session maintains conversation state and can be used to send messages and - * receive responses. Remember to close the session when done. - *

- * A permission handler is required when creating a session. Use - * {@link com.github.copilot.sdk.json.PermissionHandler#APPROVE_ALL} to approve - * all permission requests, or provide a custom handler to control permissions - * selectively. - * - *

- * Example: - * - * 

{@code
-     * var session = client.createSession(new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get();
-     * }
- * - * @param config - * configuration for the session, including the required - * {@link SessionConfig#setOnPermissionRequest(com.github.copilot.sdk.json.PermissionHandler)} - * handler - * @return a future that resolves with the created CopilotSession - * @throws IllegalArgumentException - * if {@code config} is {@code null} or does not have a permission - * handler set - * @see SessionConfig - * @see com.github.copilot.sdk.json.PermissionHandler#APPROVE_ALL - */ - public CompletableFuture createSession(SessionConfig config) { - if (config == null || config.getOnPermissionRequest() == null) { - return CompletableFuture.failedFuture( - new IllegalArgumentException("An onPermissionRequest handler is required when creating a session. " - + "For example, to allow all permissions, use: " - + "new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)")); - } - return ensureConnected().thenCompose(connection -> { - // Pre-generate session ID so the session can be registered before the RPC call, - // ensuring no events emitted by the CLI during creation are lost. - String sessionId = config.getSessionId() != null - ? config.getSessionId() - : java.util.UUID.randomUUID().toString(); - - var session = new CopilotSession(sessionId, connection.rpc); - if (options.getExecutor() != null) { - session.setExecutor(options.getExecutor()); - } - SessionRequestBuilder.configureSession(session, config); - sessions.put(sessionId, session); - - // Extract transform callbacks from the system message config. - // Callbacks are registered with the session; a wire-safe copy of the - // system message (with transform sections replaced by action="transform") - // is used in the RPC request. - var extracted = SessionRequestBuilder.extractTransformCallbacks(config.getSystemMessage()); - if (extracted.transformCallbacks() != null) { - session.registerTransformCallbacks(extracted.transformCallbacks()); - } - - var request = SessionRequestBuilder.buildCreateRequest(config, sessionId); - if (extracted.wireSystemMessage() != config.getSystemMessage()) { - request.setSystemMessage(extracted.wireSystemMessage()); - } - - return connection.rpc.invoke("session.create", request, CreateSessionResponse.class).thenApply(response -> { - session.setWorkspacePath(response.workspacePath()); - session.setCapabilities(response.capabilities()); - // If the server returned a different sessionId (e.g. a v2 CLI that ignores - // the client-supplied ID), re-key the sessions map. - String returnedId = response.sessionId(); - if (returnedId != null && !returnedId.equals(sessionId)) { - sessions.remove(sessionId); - session.setActiveSessionId(returnedId); - sessions.put(returnedId, session); - } - return session; - }).exceptionally(ex -> { - sessions.remove(sessionId); - throw ex instanceof RuntimeException re ? re : new RuntimeException(ex); - }); - }); - } - - /** - * Resumes an existing Copilot session. - *

- * This restores a previously saved session, allowing you to continue a - * conversation. The session's history is preserved. - *

- * A permission handler is required when resuming a session. Use - * {@link com.github.copilot.sdk.json.PermissionHandler#APPROVE_ALL} to approve - * all permission requests, or provide a custom handler to control permissions - * selectively. - * - * @param sessionId - * the ID of the session to resume - * @param config - * configuration for the resumed session, including the required - * {@link ResumeSessionConfig#setOnPermissionRequest(com.github.copilot.sdk.json.PermissionHandler)} - * handler - * @return a future that resolves with the resumed CopilotSession - * @throws IllegalArgumentException - * if {@code config} is {@code null} or does not have a permission - * handler set - * @see #listSessions() - * @see #getLastSessionId() - * @see com.github.copilot.sdk.json.PermissionHandler#APPROVE_ALL - */ - public CompletableFuture resumeSession(String sessionId, ResumeSessionConfig config) { - if (config == null || config.getOnPermissionRequest() == null) { - return CompletableFuture.failedFuture( - new IllegalArgumentException("An onPermissionRequest handler is required when resuming a session. " - + "For example, to allow all permissions, use: " - + "new ResumeSessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)")); - } - return ensureConnected().thenCompose(connection -> { - // Register the session before the RPC call to avoid missing early events. - var session = new CopilotSession(sessionId, connection.rpc); - if (options.getExecutor() != null) { - session.setExecutor(options.getExecutor()); - } - SessionRequestBuilder.configureSession(session, config); - sessions.put(sessionId, session); - - // Extract transform callbacks from the system message config. - var extracted = SessionRequestBuilder.extractTransformCallbacks(config.getSystemMessage()); - if (extracted.transformCallbacks() != null) { - session.registerTransformCallbacks(extracted.transformCallbacks()); - } - - var request = SessionRequestBuilder.buildResumeRequest(sessionId, config); - if (extracted.wireSystemMessage() != config.getSystemMessage()) { - request.setSystemMessage(extracted.wireSystemMessage()); - } - - return connection.rpc.invoke("session.resume", request, ResumeSessionResponse.class).thenApply(response -> { - session.setWorkspacePath(response.workspacePath()); - session.setCapabilities(response.capabilities()); - // If the server returned a different sessionId than what was requested, re-key. - String returnedId = response.sessionId(); - if (returnedId != null && !returnedId.equals(sessionId)) { - sessions.remove(sessionId); - session.setActiveSessionId(returnedId); - sessions.put(returnedId, session); - } - return session; - }).exceptionally(ex -> { - sessions.remove(sessionId); - throw ex instanceof RuntimeException re ? re : new RuntimeException(ex); - }); - }); - } - - /** - * Gets the current connection state. - * - * @return the current connection state - * @see ConnectionState - */ - public ConnectionState getState() { - if (connectionFuture == null) - return ConnectionState.DISCONNECTED; - if (connectionFuture.isCompletedExceptionally()) - return ConnectionState.ERROR; - if (!connectionFuture.isDone()) - return ConnectionState.CONNECTING; - return ConnectionState.CONNECTED; - } - - /** - * Returns the typed RPC client for server-level methods. - *

- * Provides strongly-typed access to all server-level API namespaces such as - * {@code models}, {@code tools}, {@code account}, and {@code mcp}. - *

- * Example usage: - * - * 

{@code
-     * client.start().get();
-     * var models = client.getRpc().models.list().get();
-     * }
- * - * @return the server-level typed RPC client - * @throws IllegalStateException - * if the client is not connected; call {@link #start()} first - * @since 1.0.0 - */ - public ServerRpc getRpc() { - CompletableFuture future = connectionFuture; - if (future == null || !future.isDone() || future.isCompletedExceptionally()) { - throw new IllegalStateException("Client not connected; call start() first"); - } - return future.join().serverRpc(); - } - - /** - * Pings the server to check connectivity. - *

- * This can be used to verify that the server is responsive and to check the - * protocol version. - * - * @param message - * an optional message to echo back - * @return a future that resolves with the ping response - * @see PingResponse - */ - public CompletableFuture ping(String message) { - return ensureConnected().thenCompose(connection -> connection.rpc.invoke("ping", - Map.of("message", message != null ? message : ""), PingResponse.class)); - } - - /** - * Gets CLI status including version and protocol information. - * - * @return a future that resolves with the status response containing version - * and protocol version - * @see GetStatusResponse - */ - public CompletableFuture getStatus() { - return ensureConnected() - .thenCompose(connection -> connection.rpc.invoke("status.get", Map.of(), GetStatusResponse.class)); - } - - /** - * Gets current authentication status. - * - * @return a future that resolves with the authentication status - * @see GetAuthStatusResponse - */ - public CompletableFuture getAuthStatus() { - return ensureConnected().thenCompose( - connection -> connection.rpc.invoke("auth.getStatus", Map.of(), GetAuthStatusResponse.class)); - } - - /** - * Lists available models with their metadata. - *

- * Results are cached after the first successful call to avoid rate limiting. - * The cache is cleared when the client disconnects. - *

- * If an {@code onListModels} handler was provided in - * {@link com.github.copilot.sdk.json.CopilotClientOptions}, it is called - * instead of querying the CLI server. This is useful in BYOK mode. - * - * @return a future that resolves with a list of available models - * @see ModelInfo - */ - public CompletableFuture> listModels() { - // Check cache first - List cached = modelsCache; - if (cached != null) { - return CompletableFuture.completedFuture(new ArrayList<>(cached)); - } - - // If a custom handler is configured, use it instead of querying the CLI server - var onListModels = options.getOnListModels(); - if (onListModels != null) { - synchronized (modelsCacheLock) { - if (modelsCache != null) { - return CompletableFuture.completedFuture(new ArrayList<>(modelsCache)); - } - } - return onListModels.get().thenApply(models -> { - synchronized (modelsCacheLock) { - modelsCache = models; - } - return new ArrayList<>(models); - }); - } - - return ensureConnected().thenCompose(connection -> { - // Double-check cache inside lock - synchronized (modelsCacheLock) { - if (modelsCache != null) { - return CompletableFuture.completedFuture(new ArrayList<>(modelsCache)); - } - } - - return connection.rpc.invoke("models.list", Map.of(), GetModelsResponse.class).thenApply(response -> { - List models = response.getModels(); - synchronized (modelsCacheLock) { - modelsCache = models; - } - return new ArrayList<>(models); // Return a copy to prevent cache mutation - }); - }); - } - - /** - * Gets the ID of the most recently used session. - *

- * This is useful for resuming the last conversation without needing to list all - * sessions. - * - * @return a future that resolves with the last session ID, or {@code null} if - * no sessions exist - * @see #resumeSession(String, com.github.copilot.sdk.json.ResumeSessionConfig) - */ - public CompletableFuture getLastSessionId() { - return ensureConnected().thenCompose( - connection -> connection.rpc.invoke("session.getLastId", Map.of(), GetLastSessionIdResponse.class) - .thenApply(GetLastSessionIdResponse::sessionId)); - } - - /** - * Permanently deletes a session and all its data from disk, including - * conversation history, planning state, and artifacts. - *

- * Unlike {@link CopilotSession#close()}, which only releases in-memory - * resources and preserves session data for later resumption, this method is - * irreversible. The session cannot be resumed after deletion. - * - * @param sessionId - * the ID of the session to delete - * @return a future that completes when the session is deleted - * @throws RuntimeException - * if the deletion fails - */ - public CompletableFuture deleteSession(String sessionId) { - return ensureConnected().thenCompose(connection -> connection.rpc - .invoke("session.delete", Map.of("sessionId", sessionId), DeleteSessionResponse.class) - .thenAccept(response -> { - if (!response.success()) { - throw new RuntimeException("Failed to delete session " + sessionId + ": " + response.error()); - } - sessions.remove(sessionId); - })); - } - - /** - * Lists all available sessions. - *

- * Returns metadata about all sessions that can be resumed, including their IDs, - * start times, and summaries. - * - * @return a future that resolves with a list of session metadata - * @see SessionMetadata - * @see #resumeSession(String, com.github.copilot.sdk.json.ResumeSessionConfig) - */ - public CompletableFuture> listSessions() { - return listSessions(null); - } - - /** - * Lists all available sessions with optional filtering. - *

- * Returns metadata about all sessions that can be resumed, including their IDs, - * start times, summaries, and context information. Use the filter parameter to - * narrow down sessions by working directory, git repository, or branch. - * - *

Example Usage

- * - * 
{@code
-     * // List all sessions
-     * var allSessions = client.listSessions().get();
-     *
-     * // Filter by repository
-     * var filter = new SessionListFilter().setRepository("owner/repo");
-     * var repoSessions = client.listSessions(filter).get();
-     * }
- * - * @param filter - * optional filter to narrow down sessions by context fields, or - * {@code null} to list all sessions - * @return a future that resolves with a list of session metadata - * @see SessionMetadata - * @see SessionListFilter - * @see #resumeSession(String, com.github.copilot.sdk.json.ResumeSessionConfig) - */ - public CompletableFuture> listSessions(SessionListFilter filter) { - return ensureConnected().thenCompose(connection -> { - Map params = filter != null ? Map.of("filter", filter) : Map.of(); - return connection.rpc.invoke("session.list", params, ListSessionsResponse.class) - .thenApply(ListSessionsResponse::sessions); - }); - } - - /** - * Gets metadata for a specific session by ID. - *

- * This provides an efficient O(1) lookup of a single session's metadata instead - * of listing all sessions. - * - *

Example Usage

- * - * 
{@code
-     * var metadata = client.getSessionMetadata("session-123").get();
-     * if (metadata != null) {
-     * 	System.out.println("Session started at: " + metadata.getStartTime());
-     * }
-     * }
- * - * @param sessionId - * the ID of the session to look up - * @return a future that resolves with the {@link SessionMetadata}, or - * {@code null} if the session was not found - * @see SessionMetadata - * @since 1.0.0 - */ - public CompletableFuture getSessionMetadata(String sessionId) { - return ensureConnected().thenCompose(connection -> connection.rpc - .invoke("session.getMetadata", Map.of("sessionId", sessionId), GetSessionMetadataResponse.class) - .thenApply(GetSessionMetadataResponse::session)); - } - - /** - * Gets the ID of the session currently displayed in the TUI. - *

- * This is only available when connecting to a server running in TUI+server mode - * (--ui-server). - * - * @return a future that resolves with the session ID, or null if no foreground - * session is set - */ - public CompletableFuture getForegroundSessionId() { - return ensureConnected().thenCompose(connection -> connection.rpc - .invoke("session.getForeground", Map.of(), - com.github.copilot.sdk.json.GetForegroundSessionResponse.class) - .thenApply(com.github.copilot.sdk.json.GetForegroundSessionResponse::sessionId)); - } - - /** - * Requests the TUI to switch to displaying the specified session. - *

- * This is only available when connecting to a server running in TUI+server mode - * (--ui-server). - * - * @param sessionId - * the ID of the session to display in the TUI - * @return a future that completes when the operation is done - * @throws RuntimeException - * if the operation fails - */ - public CompletableFuture setForegroundSessionId(String sessionId) { - return ensureConnected() - .thenCompose( - connection -> connection.rpc - .invoke("session.setForeground", Map.of("sessionId", sessionId), - com.github.copilot.sdk.json.SetForegroundSessionResponse.class) - .thenAccept(response -> { - if (!response.success()) { - throw new RuntimeException(response.error() != null - ? response.error() - : "Failed to set foreground session"); - } - })); - } - - /** - * Subscribes to all session lifecycle events. - *

- * Lifecycle events are emitted when sessions are created, deleted, updated, or - * change foreground/background state (in TUI+server mode). - * - * @param handler - * a callback that receives lifecycle events - * @return an AutoCloseable that, when closed, unsubscribes the handler - */ - public AutoCloseable onLifecycle(SessionLifecycleHandler handler) { - return lifecycleManager.subscribe(handler); - } - - /** - * Subscribes to a specific session lifecycle event type. - * - * @param eventType - * the event type to listen for (use - * {@link com.github.copilot.sdk.json.SessionLifecycleEventTypes} - * constants) - * @param handler - * a callback that receives events of the specified type - * @return an AutoCloseable that, when closed, unsubscribes the handler - */ - public AutoCloseable onLifecycle(String eventType, SessionLifecycleHandler handler) { - return lifecycleManager.subscribe(eventType, handler); - } - - private CompletableFuture ensureConnected() { - if (connectionFuture == null && !options.isAutoStart()) { - throw new IllegalStateException("Client not connected. Call start() first."); - } - - start(); - return connectionFuture; - } - - /** - * Closes this client using graceful shutdown semantics. - *

- * This method is intended for {@code try-with-resources} usage and blocks while - * waiting for {@link #stop()} to complete, up to - * {@link #AUTOCLOSEABLE_TIMEOUT_SECONDS} seconds. If shutdown fails or times - * out, the error is logged at {@link Level#FINE} and the method returns. - *

- * This method is idempotent. - * - * @see #stop() - * @see #forceStop() - * @see #AUTOCLOSEABLE_TIMEOUT_SECONDS - */ - @Override - public void close() { - if (disposed) - return; - disposed = true; - try { - stop().get(AUTOCLOSEABLE_TIMEOUT_SECONDS, TimeUnit.SECONDS); - } catch (Exception e) { - LOG.log(Level.FINE, "Error during close", e); - } - } - - private static record Connection(JsonRpcClient rpc, Process process, ServerRpc serverRpc) { - }; - -} diff --git a/src/main/java/com/github/copilot/sdk/json/SessionUiCapabilities.java b/src/main/java/com/github/copilot/sdk/json/SessionUiCapabilities.java deleted file mode 100644 index 9b8e0b5872..0000000000 --- a/src/main/java/com/github/copilot/sdk/json/SessionUiCapabilities.java +++ /dev/null @@ -1,37 +0,0 @@ -/*--------------------------------------------------------------------------------------------- - * Copyright (c) Microsoft Corporation. All rights reserved. - *--------------------------------------------------------------------------------------------*/ - -package com.github.copilot.sdk.json; - -/** - * UI-specific capability flags for a session. - * - * @since 1.0.0 - */ -public class SessionUiCapabilities { - - private Boolean elicitation; - - /** - * Returns whether the host supports interactive elicitation dialogs. - * - * @return {@code true} if elicitation is supported, {@code false} or - * {@code null} otherwise - */ - public Boolean getElicitation() { - return elicitation; - } - - /** - * Sets whether the host supports interactive elicitation dialogs. - * - * @param elicitation - * {@code true} if elicitation is supported - * @return this instance for method chaining - */ - public SessionUiCapabilities setElicitation(Boolean elicitation) { - this.elicitation = elicitation; - return this; - } -} diff --git a/src/main/java/com/github/copilot/sdk/json/package-info.java b/src/main/java/com/github/copilot/sdk/json/package-info.java deleted file mode 100644 index aabf620691..0000000000 --- a/src/main/java/com/github/copilot/sdk/json/package-info.java +++ /dev/null @@ -1,95 +0,0 @@ -/*--------------------------------------------------------------------------------------------- - * Copyright (c) Microsoft Corporation. All rights reserved. - *--------------------------------------------------------------------------------------------*/ - -/** - * Configuration classes and data transfer objects for the Copilot SDK. - * - *

- * This package contains all the configuration, request, response, and data - * transfer objects used throughout the SDK. These classes are designed for JSON - * serialization with Jackson and provide fluent setter methods for convenient - * configuration. - * - *

Client Configuration

- *
    - *
  • {@link com.github.copilot.sdk.json.CopilotClientOptions} - Options for - * configuring the {@link com.github.copilot.sdk.CopilotClient}, including CLI - * path, port, transport mode, and auto-start behavior.
    • - *
- * - *

Session Configuration

- *
    - *
  • {@link com.github.copilot.sdk.json.SessionConfig} - Configuration for - * creating a new session, including model selection, tools, system message, and - * MCP server configuration.
    • - *
  • {@link com.github.copilot.sdk.json.ResumeSessionConfig} - Configuration - * for resuming an existing session.
    • - *
  • {@link com.github.copilot.sdk.json.InfiniteSessionConfig} - Configuration - * for infinite sessions with automatic context compaction.
    • - *
  • {@link com.github.copilot.sdk.json.SystemMessageConfig} - System message - * customization options.
    • - *
- * - *

Message and Tool Configuration

- *
    - *
  • {@link com.github.copilot.sdk.json.MessageOptions} - Options for sending - * messages, including prompt text and attachments.
    • - *
  • {@link com.github.copilot.sdk.json.ToolDefinition} - Definition of a - * custom tool that can be invoked by the assistant.
    • - *
  • {@link com.github.copilot.sdk.json.ToolInvocation} - Represents a tool - * invocation request from the assistant.
    • - *
  • {@link com.github.copilot.sdk.json.Attachment} - File attachment for - * messages.
    • - *
- * - *

Provider Configuration (BYOK)

- *
    - *
  • {@link com.github.copilot.sdk.json.ProviderConfig} - Configuration for - * using your own API keys with custom providers (OpenAI, Azure, etc.).
    • - *
  • {@link com.github.copilot.sdk.json.AzureOptions} - Azure-specific - * configuration options.
    • - *
- * - *

Model Information

- *
    - *
  • {@link com.github.copilot.sdk.json.ModelInfo} - Information about an - * available AI model.
    • - *
  • {@link com.github.copilot.sdk.json.ModelCapabilities} - Model - * capabilities and limits.
    • - *
  • {@link com.github.copilot.sdk.json.ModelPolicy} - Model policy and state - * information.
    • - *
- * - *

Custom Agents

- *
    - *
  • {@link com.github.copilot.sdk.json.CustomAgentConfig} - Configuration for - * custom agents with specialized behaviors and tools.
    • - *
- * - *

Permissions

- *
    - *
  • {@link com.github.copilot.sdk.json.PermissionHandler} - Handler for - * permission requests from the assistant.
    • - *
  • {@link com.github.copilot.sdk.json.PermissionRequest} - A permission - * request from the assistant.
    • - *
  • {@link com.github.copilot.sdk.json.PermissionRequestResult} - Result of a - * permission request decision.
    • - *
- * - *

Usage Example

- * - * 
{@code
- * var config = new SessionConfig().setModel("gpt-4.1").setStreaming(true)
- * 		.setSystemMessage(new SystemMessageConfig().setMode(SystemMessageMode.APPEND)
- * 				.setContent("Be concise in your responses."))
- * 		.setTools(List.of(ToolDefinition.create("my_tool", "Description", schema, handler)));
- *
- * var session = client.createSession(config).get();
- * }
- * - * @see com.github.copilot.sdk.CopilotClient - * @see com.github.copilot.sdk.CopilotSession - */ -@edu.umd.cs.findbugs.annotations.SuppressFBWarnings(value = "EI_EXPOSE_REP2", justification = "DTOs for JSON deserialization - low risk") -package com.github.copilot.sdk.json; diff --git a/src/main/java/module-info.java b/src/main/java/module-info.java new file mode 100644 index 0000000000..01b7416949 --- /dev/null +++ b/src/main/java/module-info.java @@ -0,0 +1,26 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +/** + * GitHub Copilot SDK for Java. + */ +module com.github.copilot.java { + requires transitive com.fasterxml.jackson.annotation; + requires com.fasterxml.jackson.core; + requires transitive com.fasterxml.jackson.databind; + requires com.fasterxml.jackson.datatype.jsr310; + requires static com.github.spotbugs.annotations; + requires static java.compiler; + requires static java.net.http; + requires java.logging; + + exports com.github.copilot; + exports com.github.copilot.generated; + exports com.github.copilot.generated.rpc; + exports com.github.copilot.rpc; + + opens com.github.copilot to com.fasterxml.jackson.databind; + opens com.github.copilot.generated to com.fasterxml.jackson.databind; + opens com.github.copilot.rpc to com.fasterxml.jackson.databind; +} diff --git a/src/main/java25/com/github/copilot/InternalExecutorProvider.java b/src/main/java25/com/github/copilot/InternalExecutorProvider.java new file mode 100644 index 0000000000..10878bb0c4 --- /dev/null +++ b/src/main/java25/com/github/copilot/InternalExecutorProvider.java @@ -0,0 +1,65 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import java.util.concurrent.Executor; +import java.util.concurrent.Executors; +import java.util.concurrent.ForkJoinPool; + +/** + * Resolves the {@link Executor} used by {@link CopilotClient} for internal + * asynchronous work. + * + *

This is the JDK 25+ multi-release variant. It is + * compiled with {@code --release 25} into + * {@code META-INF/versions/25/com/github/copilot/InternalExecutorProvider.class} + * inside the packaged JAR and is automatically loaded in preference to the + * baseline class when the JVM runtime feature version is 25 or greater. + * When no user-provided executor is supplied, it creates an SDK-owned + * {@link Executors#newVirtualThreadPerTaskExecutor() virtual-thread executor} + * that is shut down by {@link CopilotClient#close()}. + * + *

Multi-release JAR contract. This class is the + * JDK 25 sibling of the baseline implementation at + * {@code src/main/java/com/github/copilot/InternalExecutorProvider.java}. + * The package-private surface of both classes + * ({@link #InternalExecutorProvider(Executor) constructor}, + * {@link #get()}, {@link #canBeShutdown()}) must be kept in + * lock-step; only the default-executor strategy and ownership + * semantics differ. + * + * @implNote + * Maintainers: when editing this file, also edit + * {@code src/main/java/com/github/copilot/InternalExecutorProvider.java}. + * The packaged JAR is verified at build time (see the + * {@code java25-multi-release} profile in {@code pom.xml}) to ensure this + * overlay class is present. + */ +final class InternalExecutorProvider { + + private final Executor executor; + private final boolean owned; + + InternalExecutorProvider(Executor userProvided) { + if (userProvided != null) { + this.executor = userProvided; + this.owned = false; + } else { + this.executor = Executors.newVirtualThreadPerTaskExecutor(); + this.owned = true; + } + } + + Executor get() { + return executor; + } + + boolean canBeShutdown() { + // We can only shut down the executor if we created it (i.e., if it's owned) + // such as when using Executors.newVirtualThreadPerTaskExecutor(), + // which creates an executor that we are responsible for shutting down. + return owned; + } +} diff --git a/src/site/markdown/advanced.md b/src/site/markdown/advanced.md index a4c4d830ad..5a2cafda37 100644 --- a/src/site/markdown/advanced.md +++ b/src/site/markdown/advanced.md @@ -53,6 +53,9 @@ This guide covers advanced scenarios for extending and customizing your Copilot - [Incoming Elicitation Handler](#Incoming_Elicitation_Handler) - [Session Capabilities](#Session_Capabilities) - [Outgoing Elicitation via session.getUi()](#Outgoing_Elicitation_via_session.getUi) +- [Mode Handlers](#Mode_Handlers) + - [Exit Plan Mode](#Exit_Plan_Mode) + - [Auto Mode Switch](#Auto_Mode_Switch) - [Getting Session Metadata by ID](#Getting_Session_Metadata_by_ID) --- @@ -87,7 +90,7 @@ var session = client.createSession( ).get(); ``` -See [ToolDefinition](apidocs/com/github/copilot/sdk/json/ToolDefinition.html) Javadoc for schema details. +See [ToolDefinition](apidocs/com/github/copilot/rpc/ToolDefinition.html) Javadoc for schema details. ### Overriding Built-in Tools @@ -146,7 +149,7 @@ var safeLookup = ToolDefinition.createSkipPermission( The CLI bypasses the permission request for this tool invocation, so no `PermissionRequestedEvent` is emitted and the `onPermissionRequest` handler is not called. -See [ToolDefinition](apidocs/com/github/copilot/sdk/json/ToolDefinition.html) Javadoc for details. +See [ToolDefinition](apidocs/com/github/copilot/rpc/ToolDefinition.html) Javadoc for details. --- @@ -174,10 +177,10 @@ session.sendAndWait(new MessageOptions().setPrompt("Continue with the new model" The `reasoningEffort` parameter accepts `"low"`, `"medium"`, `"high"`, or `"xhigh"` for models that support reasoning. Pass `null` (or use the single-argument overload) to use the default. -The session emits a [`SessionModelChangeEvent`](apidocs/com/github/copilot/sdk/generated/SessionModelChangeEvent.html) +The session emits a [`SessionModelChangeEvent`](apidocs/com/github/copilot/generated/SessionModelChangeEvent.html) when the switch completes, which you can observe with `session.on(SessionModelChangeEvent.class, event -> ...)`. -See [CopilotSession.setModel()](apidocs/com/github/copilot/sdk/CopilotSession.html#setModel(java.lang.String)) Javadoc for details. +See [CopilotSession.setModel()](apidocs/com/github/copilot/CopilotSession.html#setModel(java.lang.String)) Javadoc for details. --- @@ -262,9 +265,9 @@ var session = client.createSession( ).get(); ``` -See [SystemMessageConfig](apidocs/com/github/copilot/sdk/json/SystemMessageConfig.html), -[SectionOverride](apidocs/com/github/copilot/sdk/json/SectionOverride.html), and -[SystemPromptSections](apidocs/com/github/copilot/sdk/json/SystemPromptSections.html) Javadoc for details. +See [SystemMessageConfig](apidocs/com/github/copilot/rpc/SystemMessageConfig.html), +[SectionOverride](apidocs/com/github/copilot/rpc/SectionOverride.html), and +[SystemPromptSections](apidocs/com/github/copilot/rpc/SystemPromptSections.html) Javadoc for details. --- @@ -320,7 +323,7 @@ session.send(new MessageOptions() ).get(); ``` -See [BlobAttachment](apidocs/com/github/copilot/sdk/json/BlobAttachment.html) Javadoc for details. +See [BlobAttachment](apidocs/com/github/copilot/rpc/BlobAttachment.html) Javadoc for details. Both `Attachment` and `BlobAttachment` implement the sealed `MessageAttachment` interface. For a mixed list with both types, use an explicit type hint: @@ -383,6 +386,29 @@ var session = client.createSession( > **Note:** The `bearerToken` option accepts a **static token string** only. The SDK does not refresh this token automatically. If your token expires, requests will fail and you'll need to create a new session with a fresh token. +### Model Overrides + +Use `modelId` and `wireModel` to control model resolution and the model name on the wire: + +```java +var session = client.createSession( + new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + .setProvider(new ProviderConfig() + .setType("openai") + .setBaseUrl("https://api.openai.com/v1") + .setApiKey("sk-...") + .setModelId("gpt-4o") // Runtime config lookup + .setWireModel("my-finetune-v3") // Sent to the provider API + .setMaxPromptTokens(100_000) // Override max prompt tokens + .setMaxOutputTokens(4096)) // Override max output tokens +).get(); +``` + +- **`modelId`** β€” Well-known model name used by the runtime to look up agent configuration (tools, prompts, reasoning behavior) and default token limits. Also used as the wire model when `wireModel` is not set. +- **`wireModel`** β€” Model name sent to the provider API for inference. Use when the provider's model name (e.g., an Azure deployment name or a custom fine-tune name) differs from `modelId`. +- **`maxPromptTokens`** β€” Overrides the resolved model's default max prompt tokens. The runtime triggers conversation compaction when the prompt would exceed this limit. +- **`maxOutputTokens`** β€” Overrides the resolved model's default max output tokens. + ### Microsoft Foundry Local [Microsoft Foundry Local](https://foundrylocal.ai) lets you run AI models locally on your own device with an OpenAI-compatible API. Install it via the Foundry Local CLI, then point the SDK at your local endpoint: @@ -539,6 +565,8 @@ session.send("@code-reviewer Review src/Main.java").get(); | `tools` | List<String> | Tool names available to this agent | | `mcpServers` | Map | MCP servers available to this agent | | `infer` | Boolean | Whether the agent can be auto-selected based on context | +| `skills` | List<String> | Skill names to preload into the agent's context | +| `model` | String | Model identifier for this agent (e.g., "claude-haiku-4.5"); falls back to the parent session model if unavailable | ### Multiple Agents @@ -562,7 +590,7 @@ var session = client.createSession( ).get(); ``` -See [CustomAgentConfig](apidocs/com/github/copilot/sdk/json/CustomAgentConfig.html) Javadoc for full details. +See [CustomAgentConfig](apidocs/com/github/copilot/rpc/CustomAgentConfig.html) Javadoc for full details. ### Programmatic Agent Selection @@ -626,6 +654,31 @@ var session = client.createSession( --- +## Instruction Directories + +Provide additional directories containing custom instruction files. These instructions are automatically included in the system message for all conversations in the session. + +```java +var session = client.createSession( + new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + .setInstructionDirectories(List.of("/path/to/instructions")) +).get(); +``` + +Instruction files are discovered from `.github/instructions/` subdirectories within each specified path and should use the `.instructions.md` extension. + +This is also supported on session resume: + +```java +var session = client.resumeSession(sessionId, + new ResumeSessionConfig() + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + .setInstructionDirectories(List.of("/path/to/instructions")) +); +``` + +--- + ## Custom Configuration Directory Use a custom configuration directory for session settings: @@ -664,7 +717,7 @@ Use cases: - Sending status updates to the session log - Debugging session behavior with contextual messages -See [CopilotSession.log()](apidocs/com/github/copilot/sdk/CopilotSession.html#log(java.lang.String)) Javadoc for details. +See [CopilotSession.log()](apidocs/com/github/copilot/CopilotSession.html#log(java.lang.String)) Javadoc for details. --- @@ -730,7 +783,7 @@ The `UserInputResponse` should include: - `setAnswer(String)` - The user's answer - `setWasFreeform(boolean)` - `true` if the answer was freeform text, `false` if it was from the provided choices -See [UserInputHandler](apidocs/com/github/copilot/sdk/json/UserInputHandler.html) Javadoc for more details. +See [UserInputHandler](apidocs/com/github/copilot/rpc/UserInputHandler.html) Javadoc for more details. --- @@ -759,7 +812,7 @@ The `PermissionRequestResultKind` class provides well-known constants for common | `PermissionRequestResultKind.NO_RESULT` | `"no-result"` | No permission decision was made (protocol v3 only) | You can also pass a raw string to `setKind(String)` for custom or extension values. Use -[`PermissionHandler.APPROVE_ALL`](apidocs/com/github/copilot/sdk/json/PermissionHandler.html) to approve all +[`PermissionHandler.APPROVE_ALL`](apidocs/com/github/copilot/rpc/PermissionHandler.html) to approve all requests without writing a handler. --- @@ -774,6 +827,12 @@ var hooks = new SessionHooks() System.out.println("Tool: " + input.getToolName()); return CompletableFuture.completedFuture(PreToolUseHookOutput.allow()); }) + .setOnPreMcpToolCall((input, invocation) -> { + System.out.println("MCP Tool: " + input.getServerName() + "/" + input.getToolName()); + // Set metadata on the MCP request + JsonNode meta = mapper.valueToTree(Map.of("source", "my-app")); + return CompletableFuture.completedFuture(PreMcpToolCallHookOutput.withMeta(meta)); + }) .setOnPostToolUse((input, invocation) -> { System.out.println("Result: " + input.getToolResult()); return CompletableFuture.completedFuture(null); @@ -784,7 +843,7 @@ var session = client.createSession( ).get(); ``` -πŸ“– **[Full Session Hooks documentation β†’](hooks.html)** for all 5 hook types, inputs/outputs, and examples. +πŸ“– **[Full Session Hooks documentation β†’](hooks.html)** for all 6 hook types, inputs/outputs, and examples. --- @@ -911,7 +970,7 @@ subscription.close(); ### Subscribing to Specific Event Types ```java -import com.github.copilot.sdk.json.SessionLifecycleEventTypes; +import com.github.copilot.rpc.SessionLifecycleEventTypes; // Listen only for session creation var subscription = client.onLifecycle( @@ -1059,7 +1118,7 @@ session.setEventErrorPolicy(EventErrorPolicy.PROPAGATE_AND_LOG_ERRORS); session.setEventErrorPolicy(EventErrorPolicy.SUPPRESS_AND_LOG_ERRORS); ``` -See [EventErrorPolicy](apidocs/com/github/copilot/sdk/EventErrorPolicy.html) and [EventErrorHandler](apidocs/com/github/copilot/sdk/EventErrorHandler.html) Javadoc for details. +See [EventErrorPolicy](apidocs/com/github/copilot/EventErrorPolicy.html) and [EventErrorHandler](apidocs/com/github/copilot/EventErrorHandler.html) Javadoc for details. --- @@ -1096,7 +1155,7 @@ var options = new CopilotClientOptions() | `sourceName` | `COPILOT_OTEL_SOURCE_NAME` | Source name for telemetry spans | | `captureContent` | `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` | Whether to capture message content | -See [TelemetryConfig](apidocs/com/github/copilot/sdk/json/TelemetryConfig.html) Javadoc for details. +See [TelemetryConfig](apidocs/com/github/copilot/rpc/TelemetryConfig.html) Javadoc for details. --- @@ -1219,6 +1278,66 @@ All `getUi()` methods throw `IllegalStateException` if the host does not support --- +## Mode Handlers + +Mode handlers let your application respond to mode transitions requested by the Copilot CLI. + +### Exit Plan Mode + +When the model finishes creating a plan and wants to transition out of plan mode, it invokes the `exitPlanMode` handler. Register the handler via `SessionConfig.setOnExitPlanMode()`: + +```java +var session = client.createSession(new SessionConfig() + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + .setOnExitPlanMode((request, invocation) -> { + System.out.println("Plan summary: " + request.getSummary()); + System.out.println("Available actions: " + request.getActions()); + System.out.println("Recommended: " + request.getRecommendedAction()); + + return CompletableFuture.completedFuture( + new ExitPlanModeResult() + .setApproved(true) + .setSelectedAction("interactive") + .setFeedback("Looks good, proceed!")); + })).get(); +``` + +When no handler is registered, the SDK automatically approves the plan (`approved=true`). The handler receives an `ExitPlanModeRequest` with: + +| Field | Description | +|---------------------|-------------------------------------------------| +| `summary` | Summary of the plan that was created | +| `planContent` | Full content of the plan file | +| `actions` | Available actions (e.g., interactive, autopilot) | +| `recommendedAction` | The recommended action for the user | + +### Auto Mode Switch + +When the model encounters a rate limit or similar constraint, it may request to switch modes automatically. Register the handler via `SessionConfig.setOnAutoModeSwitch()`: + +```java +var session = client.createSession(new SessionConfig() + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + .setOnAutoModeSwitch((request, invocation) -> { + System.out.println("Error: " + request.getErrorCode()); + System.out.println("Retry after: " + request.getRetryAfterSeconds() + "s"); + + return CompletableFuture.completedFuture(AutoModeSwitchResponse.YES); + })).get(); +``` + +When no handler is registered, the SDK returns `NO` (declining the mode switch). The response options are: + +| Response | Description | +|---------------------------------|------------------------------------------| +| `AutoModeSwitchResponse.YES` | Allow the mode switch this time | +| `AutoModeSwitchResponse.YES_ALWAYS`| Always allow automatic mode switches | +| `AutoModeSwitchResponse.NO` | Decline the mode switch | + +Both handlers are also available on `ResumeSessionConfig` for resumed sessions. + +--- + ## Getting Session Metadata by ID Retrieve metadata for a specific session without listing all sessions: @@ -1237,10 +1356,63 @@ This is more efficient than `listSessions()` when you already know the session I --- +## Remote Sessions + +Remote sessions enable Mission Control integration, making sessions accessible from GitHub web and mobile. When enabled, sessions in a GitHub repository working directory receive a remote URL. + +### Enabling Remote Sessions + +Set `remote(true)` on the client options to enable remote session support for all sessions: + +```java +var options = new CopilotClientOptions() + .setRemote(true) + .setCwd("/path/to/github-repo"); + +try (var client = new CopilotClient(options)) { + var session = client.createSession( + new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + ).get(); + + // Listen for the remote URL info event + session.on(SessionInfoEvent.class, event -> { + System.out.println("Remote URL: " + event.getData()); + }); +} +``` + +### Prerequisites + +- The user must be authenticated (GitHub token or logged-in user) +- The session's working directory must be a GitHub repository +- This option is only used when the SDK spawns the CLI process; it is ignored when connecting to an external server via `setCliUrl()` + +### Cloud Sessions + +Cloud sessions create a remote session in the cloud instead of a local session. Optionally associate repository metadata with the cloud session: + +```java +var cloudOptions = new CloudSessionOptions() + .setRepository(new CloudSessionRepository() + .setOwner("my-org") + .setName("my-repo") + .setBranch("main")); + +var session = client.createSession( + new SessionConfig() + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + .setCloud(cloudOptions) +).get(); +``` + +See [CloudSessionOptions](apidocs/com/github/copilot/rpc/CloudSessionOptions.html) and [CloudSessionRepository](apidocs/com/github/copilot/rpc/CloudSessionRepository.html) Javadoc for details. + +--- + ## Next Steps - πŸ“– **[Documentation](documentation.html)** - Core concepts, events, streaming, models, tool filtering, reasoning effort -- πŸ“– **[Session Hooks](hooks.html)** - All 5 hook types with inputs, outputs, and examples +- πŸ“– **[Session Hooks](hooks.html)** - All 6 hook types with inputs, outputs, and examples - πŸ“– **[MCP Servers](mcp.html)** - Local and remote MCP server integration - πŸ“– **[Setup & Deployment](setup.html)** - OAuth, backend services, scaling, configuration reference - πŸ“– **[API Javadoc](apidocs/index.html)** - Complete API reference diff --git a/src/site/markdown/cookbook/error-handling.md b/src/site/markdown/cookbook/error-handling.md index 4fffd2ba0d..e651360099 100644 --- a/src/site/markdown/cookbook/error-handling.md +++ b/src/site/markdown/cookbook/error-handling.md @@ -30,12 +30,12 @@ jbang BasicErrorHandling.java **Code:** ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; public class BasicErrorHandling { public static void main(String[] args) { @@ -64,8 +64,8 @@ public class BasicErrorHandling { ## Handling specific error types ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; import java.util.concurrent.ExecutionException; public class SpecificErrorHandling { @@ -99,10 +99,10 @@ public class SpecificErrorHandling { ## Timeout handling ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotSession; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotSession; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; import java.util.concurrent.TimeUnit; import java.util.concurrent.TimeoutException; @@ -130,9 +130,9 @@ public class TimeoutHandling { ## Aborting a request ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotSession; -import com.github.copilot.sdk.json.MessageOptions; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotSession; +import com.github.copilot.rpc.MessageOptions; import java.util.concurrent.Executors; import java.util.concurrent.ScheduledExecutorService; import java.util.concurrent.TimeUnit; @@ -162,8 +162,8 @@ public class AbortRequest { ## Graceful shutdown ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; public class GracefulShutdown { public static void main(String[] args) { @@ -192,12 +192,12 @@ public class GracefulShutdown { ## Try-with-resources pattern ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; public class TryWithResources { public static void doWork() throws Exception { @@ -224,14 +224,14 @@ public class TryWithResources { ## Handling tool errors ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.ToolDefinition; -import com.github.copilot.sdk.json.ToolResultObject; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.ToolDefinition; +import com.github.copilot.rpc.ToolResultObject; import java.util.Map; import java.util.List; import java.util.concurrent.CompletableFuture; diff --git a/src/site/markdown/cookbook/managing-local-files.md b/src/site/markdown/cookbook/managing-local-files.md index 723d9b1059..2bf4fac813 100644 --- a/src/site/markdown/cookbook/managing-local-files.md +++ b/src/site/markdown/cookbook/managing-local-files.md @@ -34,15 +34,15 @@ jbang ManagingLocalFiles.java **Code:** ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.generated.ToolExecutionCompleteEvent; -import com.github.copilot.sdk.generated.ToolExecutionStartEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.generated.ToolExecutionCompleteEvent; +import com.github.copilot.generated.ToolExecutionStartEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; import java.nio.file.Paths; import java.util.concurrent.CountDownLatch; @@ -161,7 +161,7 @@ session.send(new MessageOptions().setPrompt(prompt)); ## Interactive file organization ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 import java.io.BufferedReader; import java.io.InputStreamReader; diff --git a/src/site/markdown/cookbook/multiple-sessions.md b/src/site/markdown/cookbook/multiple-sessions.md index c7ac909f18..dffc2866e1 100644 --- a/src/site/markdown/cookbook/multiple-sessions.md +++ b/src/site/markdown/cookbook/multiple-sessions.md @@ -30,12 +30,12 @@ jbang MultipleSessions.java **Code:** ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; public class MultipleSessions { public static void main(String[] args) throws Exception { @@ -123,7 +123,7 @@ try { ## Managing session lifecycle with CompletableFuture ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 import java.util.concurrent.CompletableFuture; import java.util.List; @@ -177,11 +177,11 @@ common-pool threads: ```java //DEPS com.github:copilot-sdk-java:${project.version} -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.json.CopilotClientOptions; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; +import com.github.copilot.CopilotClient; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; import java.util.List; import java.util.concurrent.CompletableFuture; import java.util.concurrent.ExecutorService; diff --git a/src/site/markdown/cookbook/persisting-sessions.md b/src/site/markdown/cookbook/persisting-sessions.md index de50001fcf..cda812e638 100644 --- a/src/site/markdown/cookbook/persisting-sessions.md +++ b/src/site/markdown/cookbook/persisting-sessions.md @@ -30,12 +30,12 @@ jbang PersistingSessions.java **Code:** ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; public class PersistingSessions { public static void main(String[] args) throws Exception { @@ -127,12 +127,12 @@ public class DeleteSession { ## Getting session history ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.UserMessageEvent; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.ResumeSessionConfig; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.UserMessageEvent; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.ResumeSessionConfig; public class SessionHistory { public static void main(String[] args) throws Exception { @@ -162,7 +162,7 @@ public class SessionHistory { ## Complete example with session management ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 import java.util.Scanner; public class SessionManager { diff --git a/src/site/markdown/cookbook/pr-visualization.md b/src/site/markdown/cookbook/pr-visualization.md index 40d7cde768..90c93987d3 100644 --- a/src/site/markdown/cookbook/pr-visualization.md +++ b/src/site/markdown/cookbook/pr-visualization.md @@ -34,14 +34,14 @@ jbang PRVisualization.java github/copilot-sdk ## Full example: PRVisualization.java ```java -//DEPS com.github:copilot-sdk-java:0.3.0-java.2 -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.ToolExecutionStartEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SystemMessageConfig; +//DEPS com.github:copilot-sdk-java:1.0.0-beta-10-java.0 +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.ToolExecutionStartEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SystemMessageConfig; import java.io.BufferedReader; import java.io.EOFException; import java.io.IOException; diff --git a/src/site/markdown/documentation.md b/src/site/markdown/documentation.md index 7b0c958e3d..5812e83fdf 100644 --- a/src/site/markdown/documentation.md +++ b/src/site/markdown/documentation.md @@ -27,9 +27,9 @@ This guide covers common use cases for the GitHub Copilot SDK for Java. For comp Create a client, start a session, and send a message: ```java -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.CopilotClient; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; try (var client = new CopilotClient()) { client.start().get(); @@ -266,7 +266,7 @@ The SDK supports event types organized by category. All events extend `SessionEv | `ExitPlanModeRequestedEvent` | `exit_plan_mode.requested` | Exit from plan mode was requested | | `ExitPlanModeCompletedEvent` | `exit_plan_mode.completed` | Exit from plan mode completed | -See the [generated package Javadoc](apidocs/com/github/copilot/sdk/generated/package-summary.html) for detailed event data structures. +See the [generated package Javadoc](apidocs/com/github/copilot/generated/package-summary.html) for detailed event data structures. --- @@ -563,7 +563,7 @@ var pong = client.ping("hello").get(); System.out.println("Server responded, protocol version: " + pong.protocolVersion()); ``` -See [ConnectionState](apidocs/com/github/copilot/sdk/ConnectionState.html), [GetStatusResponse](apidocs/com/github/copilot/sdk/json/GetStatusResponse.html), and [GetAuthStatusResponse](apidocs/com/github/copilot/sdk/json/GetAuthStatusResponse.html) Javadoc for details. +See [ConnectionState](apidocs/com/github/copilot/ConnectionState.html), [GetStatusResponse](apidocs/com/github/copilot/rpc/GetStatusResponse.html), and [GetAuthStatusResponse](apidocs/com/github/copilot/rpc/GetAuthStatusResponse.html) Javadoc for details. --- @@ -662,7 +662,7 @@ var config = new ResumeSessionConfig().setOnPermissionRequest(PermissionHandler. var session = client.resumeSession("user-123-task-456", config).get(); ``` -See [ResumeSessionConfig](apidocs/com/github/copilot/sdk/json/ResumeSessionConfig.html) Javadoc for complete options. +See [ResumeSessionConfig](apidocs/com/github/copilot/rpc/ResumeSessionConfig.html) Javadoc for complete options. ### Clean Up Sessions @@ -725,7 +725,7 @@ var derived = base.clone() `clone()` creates a shallow copy. Collection fields are copied into new collection instances, while nested objects/handlers are shared references. -See [SessionConfig](apidocs/com/github/copilot/sdk/json/SessionConfig.html) Javadoc for full details. +See [SessionConfig](apidocs/com/github/copilot/rpc/SessionConfig.html) Javadoc for full details. --- diff --git a/src/site/markdown/getting-started.md b/src/site/markdown/getting-started.md index 724b1a2dd5..0bde2ef50d 100644 --- a/src/site/markdown/getting-started.md +++ b/src/site/markdown/getting-started.md @@ -64,10 +64,10 @@ For the fastest way to try the SDK without setting up a project, use [JBang](htt Create a new file and add the following code. This is the simplest way to use the SDK. ```java -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.CopilotClient; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; public class HelloCopilot { public static void main(String[] args) throws Exception { @@ -109,12 +109,12 @@ Congratulations! You just built your first Copilot-powered app. Right now, you wait for the complete response before seeing anything. Let's make it interactive by streaming the response as it's generated. ```java -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageDeltaEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageDeltaEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; import java.util.concurrent.CompletableFuture; public class StreamingExample { @@ -156,13 +156,13 @@ Run the code again. You'll see the response appear word by word. Now for the powerful part. Let's give Copilot the ability to call your code by defining a custom tool. We'll create a simple weather lookup tool. ```java -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageDeltaEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.ToolDefinition; +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageDeltaEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.ToolDefinition; import java.util.List; import java.util.Map; import java.util.Random; @@ -238,13 +238,13 @@ Run it and you'll see Copilot call your tool to get weather data, then respond w Let's put it all together into a useful interactive assistant: ```java -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageDeltaEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.ToolDefinition; +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageDeltaEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.ToolDefinition; import java.util.List; import java.util.Map; import java.util.Random; diff --git a/src/site/markdown/hooks.md b/src/site/markdown/hooks.md index 97c7468915..3bed031df8 100644 --- a/src/site/markdown/hooks.md +++ b/src/site/markdown/hooks.md @@ -9,6 +9,7 @@ Session hooks allow you to intercept and modify tool execution, user prompts, an | Hook | When It's Called | Can Modify | |------|------------------|------------| | [Pre-Tool Use](#Pre-Tool_Use_Hook) | Before a tool executes | Tool arguments, permission decision | +| [Pre-MCP-Tool-Call](#Pre-MCP-Tool-Call_Hook) | Before an MCP tool call is dispatched | MCP request metadata (`_meta`) | | [Post-Tool Use](#Post-Tool_Use_Hook) | After a tool executes | Tool result, additional context | | [User Prompt Submitted](#User_Prompt_Submitted_Hook) | When user sends a message | Nothing (observation only) | | [Session Start](#Session_Start_Hook) | When session begins | Nothing (observation only) | @@ -53,6 +54,7 @@ Called **before** a tool executes. Use this to: | Field | Type | Description | |-------|------|-------------| +| `getSessionId()` | `String` | Runtime session ID of the session that triggered the hook | | `getToolName()` | `String` | Name of the tool being called | | `getToolArgs()` | `JsonNode` | Arguments passed to the tool | | `getCwd()` | `String` | Current working directory | @@ -118,6 +120,53 @@ var hooks = new SessionHooks() --- +## Pre-MCP-Tool-Call Hook + +Called **before** an MCP tool call is dispatched to an MCP server. Use this to: +- Inspect or log MCP tool calls +- Set, replace, or remove MCP request metadata (`_meta`) + +### Input + +| Field | Type | Description | +|-------|------|-------------| +| `getSessionId()` | `String` | Runtime session ID of the session that triggered the hook | +| `getTimestamp()` | `long` | Unix timestamp in milliseconds | +| `getCwd()` | `String` | Current working directory | +| `getServerName()` | `String` | Name of the MCP server being called | +| `getToolName()` | `String` | Name of the MCP tool being called | +| `getArguments()` | `JsonNode` | Arguments for the MCP tool call | +| `getToolCallId()` | `String` | Tool call ID (may be null) | +| `getMeta()` | `Map` | Existing MCP request metadata (may be null) | + +### Output + +Return `null` from the handler to preserve existing `_meta` (no-op). Otherwise, return a `PreMcpToolCallHookOutput`: + +| Factory Method | Effect | +|----------------|--------| +| `PreMcpToolCallHookOutput.withMeta(jsonNode)` | Replace `_meta` with the given JSON object | +| `PreMcpToolCallHookOutput.removeMeta()` | Remove `_meta` from the request | + +### Example: Inject metadata into MCP requests + +```java +var hooks = new SessionHooks() + .setOnPreMcpToolCall((input, invocation) -> { + System.out.println("MCP call: " + input.getServerName() + "/" + input.getToolName()); + + // Inject custom metadata into the MCP request + var mapper = new ObjectMapper(); + JsonNode meta = mapper.valueToTree(Map.of( + "source", "my-application", + "requestId", UUID.randomUUID().toString() + )); + return CompletableFuture.completedFuture(PreMcpToolCallHookOutput.withMeta(meta)); + }); +``` + +--- + ## Post-Tool Use Hook Called **after** a tool executes. Use this to: @@ -130,6 +179,7 @@ Called **after** a tool executes. Use this to: | Field | Type | Description | |-------|------|-------------| +| `getSessionId()` | `String` | Runtime session ID of the session that triggered the hook | | `getToolName()` | `String` | Name of the tool that was called | | `getToolArgs()` | `JsonNode` | Arguments that were passed | | `getToolResult()` | `JsonNode` | Result from the tool | @@ -187,8 +237,9 @@ Called when the user submits a prompt, before the LLM processes it. This is an o | Field | Type | Description | |-------|------|-------------| +| `sessionId()` | `String` | Runtime session ID of the session that triggered the hook | | `prompt()` | `String` | The user's prompt text | -| `getTimestamp()` | `long` | Timestamp in milliseconds | +| `timestamp()` | `long` | Timestamp in milliseconds | ### Output @@ -221,8 +272,9 @@ Called when a session starts (either new or resumed). | Field | Type | Description | |-------|------|-------------| +| `sessionId()` | `String` | Runtime session ID of the session that triggered the hook | | `source()` | `String` | `"startup"`, `"resume"`, or `"new"` | -| `getTimestamp()` | `long` | Timestamp in milliseconds | +| `timestamp()` | `long` | Timestamp in milliseconds | ### Output @@ -253,8 +305,9 @@ Called when a session ends. | Field | Type | Description | |-------|------|-------------| +| `sessionId()` | `String` | Runtime session ID of the session that triggered the hook | | `reason()` | `String` | Why the session ended | -| `getTimestamp()` | `long` | Timestamp in milliseconds | +| `timestamp()` | `long` | Timestamp in milliseconds | ### Output @@ -284,11 +337,11 @@ var hooks = new SessionHooks() Combining multiple hooks for comprehensive session control: ```java -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.PreToolUseHookOutput; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SessionHooks; +import com.github.copilot.CopilotClient; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.PreToolUseHookOutput; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionHooks; import java.util.concurrent.CompletableFuture; public class HooksExample { @@ -406,11 +459,11 @@ To handle errors gracefully in your hooks: ## See Also -- [SessionHooks Javadoc](apidocs/com/github/copilot/sdk/json/SessionHooks.html) -- [PreToolUseHookInput Javadoc](apidocs/com/github/copilot/sdk/json/PreToolUseHookInput.html) -- [PreToolUseHookOutput Javadoc](apidocs/com/github/copilot/sdk/json/PreToolUseHookOutput.html) -- [PostToolUseHookInput Javadoc](apidocs/com/github/copilot/sdk/json/PostToolUseHookInput.html) -- [PostToolUseHookOutput Javadoc](apidocs/com/github/copilot/sdk/json/PostToolUseHookOutput.html) +- [SessionHooks Javadoc](apidocs/com/github/copilot/rpc/SessionHooks.html) +- [PreToolUseHookInput Javadoc](apidocs/com/github/copilot/rpc/PreToolUseHookInput.html) +- [PreToolUseHookOutput Javadoc](apidocs/com/github/copilot/rpc/PreToolUseHookOutput.html) +- [PostToolUseHookInput Javadoc](apidocs/com/github/copilot/rpc/PostToolUseHookInput.html) +- [PostToolUseHookOutput Javadoc](apidocs/com/github/copilot/rpc/PostToolUseHookOutput.html) --- diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md index a097da69e4..645645d4bc 100644 --- a/src/site/markdown/index.md +++ b/src/site/markdown/index.md @@ -36,12 +36,12 @@ implementation 'com.github:copilot-sdk-java:${project.version}' ### Quick Example ```java -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; import java.util.concurrent.CompletableFuture; public class Example { @@ -87,12 +87,12 @@ You can quickly try the SDK without setting up a full project using [JBang](http # Create a simple script cat > hello-copilot.java << 'EOF' //DEPS com.github:copilot-sdk-java:${project.version} -import com.github.copilot.sdk.CopilotClient; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.CopilotClient; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; import java.util.concurrent.CompletableFuture; class hello { diff --git a/src/site/markdown/setup.md b/src/site/markdown/setup.md index 10c1cb3d80..224fc1948c 100644 --- a/src/site/markdown/setup.md +++ b/src/site/markdown/setup.md @@ -157,12 +157,28 @@ try (var client = new CopilotClient(options)) { Multiple application instances can share a single CLI server: ```java -// In different parts of your application or different containers -var client1 = new CopilotClient(new CopilotClientOptions().setCliUrl("cli-server:4321")); -var client2 = new CopilotClient(new CopilotClientOptions().setCliUrl("cli-server:4321")); +// Use an explicit connection token so all clients can authenticate +var token = "my-shared-secret"; +var client1 = new CopilotClient(new CopilotClientOptions() + .setCliUrl("cli-server:4321").setTcpConnectionToken(token)); +var client2 = new CopilotClient(new CopilotClientOptions() + .setCliUrl("cli-server:4321").setTcpConnectionToken(token)); // Both connect to the same CLI server ``` +### Connection Token (TCP Security) + +When the SDK spawns the CLI in TCP mode, a random connection token is generated automatically +to protect the loopback listener. You can also provide an explicit token: + +```java +var options = new CopilotClientOptions() + .setUseStdio(false) + .setTcpConnectionToken("my-secret-token"); +``` + +> **Note:** `tcpConnectionToken` cannot be used with `useStdio = true`. + ### Deployment Patterns **Container deployment:** @@ -340,10 +356,12 @@ Complete list of `CopilotClientOptions` settings: | `cliPath` | String | Path to CLI executable | `"copilot"` from PATH | | `cliUrl` | String | External CLI server URL | `null` (spawn process) | | `cliArgs` | String[] | Extra CLI arguments | `null` | +| `copilotHome` | String | Base directory for Copilot data | `null` (~/.copilot) | | `gitHubToken` | String | GitHub OAuth token | `null` | | `useLoggedInUser` | Boolean | Use system credentials | `true` | | `useStdio` | boolean | Use stdio transport | `true` | | `port` | int | TCP port for CLI | `0` (random) | +| `tcpConnectionToken` | String | Connection token for TCP mode | `null` (auto-generated) | | `autoStart` | boolean | Auto-start server | `true` | | `autoRestart` | boolean | Auto-restart on crash | `true` | | `logLevel` | String | CLI log level | `"info"` | diff --git a/src/test/java/com/github/copilot/sdk/AgentInfoTest.java b/src/test/java/com/github/copilot/AgentInfoTest.java similarity index 96% rename from src/test/java/com/github/copilot/sdk/AgentInfoTest.java rename to src/test/java/com/github/copilot/AgentInfoTest.java index 0893773e71..3b15f5582c 100644 --- a/src/test/java/com/github/copilot/sdk/AgentInfoTest.java +++ b/src/test/java/com/github/copilot/AgentInfoTest.java @@ -2,13 +2,13 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.AgentInfo; +import com.github.copilot.rpc.AgentInfo; /** * Unit tests for {@link AgentInfo} getters, setters, and fluent chaining. diff --git a/src/test/java/com/github/copilot/AgentModeTest.java b/src/test/java/com/github/copilot/AgentModeTest.java new file mode 100644 index 0000000000..dd1aa01de3 --- /dev/null +++ b/src/test/java/com/github/copilot/AgentModeTest.java @@ -0,0 +1,70 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.EnumSource; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.github.copilot.rpc.AgentMode; + +/** + * Unit tests for {@link AgentMode} serialization, deserialization, and + * unknown-value behavior. + */ +public class AgentModeTest { + + private final ObjectMapper mapper = new ObjectMapper(); + + @ParameterizedTest + @EnumSource(AgentMode.class) + void jsonRoundTrip_allValues(AgentMode mode) throws Exception { + String json = mapper.writeValueAsString(mode); + AgentMode deserialized = mapper.readValue(json, AgentMode.class); + assertEquals(mode, deserialized); + } + + @Test + void getValue_returnsExpectedStrings() { + assertEquals("interactive", AgentMode.INTERACTIVE.getValue()); + assertEquals("plan", AgentMode.PLAN.getValue()); + assertEquals("autopilot", AgentMode.AUTOPILOT.getValue()); + assertEquals("shell", AgentMode.SHELL.getValue()); + } + + @Test + void fromValue_knownValues_returnsCorrectEnum() { + assertEquals(AgentMode.INTERACTIVE, AgentMode.fromValue("interactive")); + assertEquals(AgentMode.PLAN, AgentMode.fromValue("plan")); + assertEquals(AgentMode.AUTOPILOT, AgentMode.fromValue("autopilot")); + assertEquals(AgentMode.SHELL, AgentMode.fromValue("shell")); + } + + @Test + void fromValue_null_returnsNull() { + assertNull(AgentMode.fromValue(null)); + } + + @Test + void fromValue_unknownValue_throwsWithConsistentMessage() { + var ex = assertThrows(IllegalArgumentException.class, () -> AgentMode.fromValue("unknown")); + assertEquals("Unknown AgentMode value: unknown", ex.getMessage()); + } + + @Test + void jsonDeserialize_unknownValue_throws() { + String json = "\"not-a-mode\""; + assertThrows(Exception.class, () -> mapper.readValue(json, AgentMode.class)); + } + + @Test + void jsonSerialize_writesStringValue() throws Exception { + String json = mapper.writeValueAsString(AgentMode.AUTOPILOT); + assertEquals("\"autopilot\"", json); + } +} diff --git a/src/test/java/com/github/copilot/sdk/AskUserTest.java b/src/test/java/com/github/copilot/AskUserTest.java similarity index 95% rename from src/test/java/com/github/copilot/sdk/AskUserTest.java rename to src/test/java/com/github/copilot/AskUserTest.java index a2ad13b188..f32a6632d1 100644 --- a/src/test/java/com/github/copilot/sdk/AskUserTest.java +++ b/src/test/java/com/github/copilot/AskUserTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -14,11 +14,11 @@ import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.UserInputRequest; -import com.github.copilot.sdk.json.UserInputResponse; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.UserInputRequest; +import com.github.copilot.rpc.UserInputResponse; /** * Tests for user input handler (ask_user) functionality. diff --git a/src/test/java/com/github/copilot/sdk/CapiProxy.java b/src/test/java/com/github/copilot/CapiProxy.java similarity index 89% rename from src/test/java/com/github/copilot/sdk/CapiProxy.java rename to src/test/java/com/github/copilot/CapiProxy.java index 30f8434363..90c2dd0a75 100644 --- a/src/test/java/com/github/copilot/sdk/CapiProxy.java +++ b/src/test/java/com/github/copilot/CapiProxy.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.io.BufferedReader; import java.io.IOException; @@ -56,10 +56,12 @@ public class CapiProxy implements AutoCloseable { private static final ObjectMapper MAPPER = new ObjectMapper(); - private static final Pattern LISTENING_PATTERN = Pattern.compile("Listening: (http://[^\\s]+)"); + private static final Pattern LISTENING_PATTERN = Pattern.compile("Listening: (http://[^\\s]+)(?:\\s+(\\{.*\\}))?$"); private Process process; private String proxyUrl; + private String connectProxyUrl; + private String caFilePath; private final HttpClient httpClient; private BufferedReader stdoutReader; @@ -96,6 +98,10 @@ public String start() throws IOException, InterruptedException { : new ProcessBuilder("npx", "tsx", "server.ts"); pb.directory(harnessDir.toFile()); pb.redirectErrorStream(false); + // Tell the replaying proxy to fail fast on unmatched requests rather than + // forwarding them to the real API. Without this, unmatched requests hit the + // live API with a fake token and crash the proxy's JSON parser. + pb.environment().put("GITHUB_ACTIONS", "true"); process = pb.start(); @@ -137,7 +143,24 @@ public String start() throws IOException, InterruptedException { throw new IOException("Unexpected proxy output: " + line); } - proxyUrl = matcher.group(1); + String url = matcher.group(1); + + // Parse optional metadata (CONNECT proxy details) + String metadata = matcher.group(2); + if (metadata != null && !metadata.isEmpty()) { + try { + Map meta = MAPPER.readValue(metadata, new TypeReference>() { + }); + connectProxyUrl = meta.get("connectProxyUrl"); + caFilePath = meta.get("caFilePath"); + } catch (Exception e) { + process.destroyForcibly(); + throw new IOException("Failed to parse proxy startup metadata: " + metadata, e); + } + } + + // Only set proxyUrl after all parsing succeeds to avoid inconsistent state + proxyUrl = url; return proxyUrl; } @@ -329,6 +352,8 @@ public void stop(boolean skipWritingCache) throws IOException, InterruptedExcept process = null; proxyUrl = null; + connectProxyUrl = null; + caFilePath = null; } /** @@ -340,6 +365,24 @@ public String getProxyUrl() { return proxyUrl; } + /** + * Gets the CONNECT proxy URL for HTTPS interception. + * + * @return the CONNECT proxy URL, or null if not available + */ + public String getConnectProxyUrl() { + return connectProxyUrl; + } + + /** + * Gets the CA file path for trusting the CONNECT proxy's certificate. + * + * @return the CA file path, or null if not available + */ + public String getCaFilePath() { + return caFilePath; + } + /** * Checks if the proxy process is still alive and responsive. This does both a * process alive check AND an HTTP health check. diff --git a/src/test/java/com/github/copilot/sdk/CliServerManagerTest.java b/src/test/java/com/github/copilot/CliServerManagerTest.java similarity index 98% rename from src/test/java/com/github/copilot/sdk/CliServerManagerTest.java rename to src/test/java/com/github/copilot/CliServerManagerTest.java index 90e6dcc3c3..2df5dafabb 100644 --- a/src/test/java/com/github/copilot/sdk/CliServerManagerTest.java +++ b/src/test/java/com/github/copilot/CliServerManagerTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -12,8 +12,8 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.CopilotClientOptions; -import com.github.copilot.sdk.json.TelemetryConfig; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.TelemetryConfig; /** * Unit tests for {@link CliServerManager} covering parseCliUrl, diff --git a/src/test/java/com/github/copilot/sdk/ClosedSessionGuardTest.java b/src/test/java/com/github/copilot/ClosedSessionGuardTest.java similarity index 98% rename from src/test/java/com/github/copilot/sdk/ClosedSessionGuardTest.java rename to src/test/java/com/github/copilot/ClosedSessionGuardTest.java index edc503f948..12636fb77e 100644 --- a/src/test/java/com/github/copilot/sdk/ClosedSessionGuardTest.java +++ b/src/test/java/com/github/copilot/ClosedSessionGuardTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.assertDoesNotThrow; import static org.junit.jupiter.api.Assertions.assertEquals; @@ -13,10 +13,10 @@ import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; /** * Tests for closed-session guard functionality in CopilotSession. diff --git a/src/test/java/com/github/copilot/sdk/CommandsTest.java b/src/test/java/com/github/copilot/CommandsTest.java similarity index 93% rename from src/test/java/com/github/copilot/sdk/CommandsTest.java rename to src/test/java/com/github/copilot/CommandsTest.java index 6bddbed288..0da8822a2b 100644 --- a/src/test/java/com/github/copilot/sdk/CommandsTest.java +++ b/src/test/java/com/github/copilot/CommandsTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -11,13 +11,13 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.CommandContext; -import com.github.copilot.sdk.json.CommandDefinition; -import com.github.copilot.sdk.json.CommandHandler; -import com.github.copilot.sdk.json.CommandWireDefinition; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.rpc.CommandContext; +import com.github.copilot.rpc.CommandDefinition; +import com.github.copilot.rpc.CommandHandler; +import com.github.copilot.rpc.CommandWireDefinition; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; /** * Unit tests for the Commands feature (CommandDefinition, CommandContext, diff --git a/src/test/java/com/github/copilot/sdk/CompactionTest.java b/src/test/java/com/github/copilot/CompactionTest.java similarity index 88% rename from src/test/java/com/github/copilot/sdk/CompactionTest.java rename to src/test/java/com/github/copilot/CompactionTest.java index da24dabd15..100b8e8fe1 100644 --- a/src/test/java/com/github/copilot/sdk/CompactionTest.java +++ b/src/test/java/com/github/copilot/CompactionTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -12,17 +12,18 @@ import org.junit.jupiter.api.AfterAll; import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Disabled; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Timeout; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionCompactionCompleteEvent; -import com.github.copilot.sdk.generated.SessionCompactionStartEvent; -import com.github.copilot.sdk.json.InfiniteSessionConfig; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionCompactionCompleteEvent; +import com.github.copilot.generated.SessionCompactionStartEvent; +import com.github.copilot.rpc.InfiniteSessionConfig; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; /** * Tests for compaction and infinite sessions functionality. @@ -52,10 +53,17 @@ static void teardown() throws Exception { /** * Verifies that compaction is triggered with low threshold and emits events. * + *

+ * Disabled due to flakiness β€” compaction timing is non-deterministic and the + * snapshot cannot reliably match across platforms. The reference implementation + * (nodejs) also skips this test. See copilot-sdk#1227. + * * @see Snapshot: * compaction/should_trigger_compaction_with_low_threshold_and_emit_events */ @Test + @Disabled("Flaky: compaction timing varies by platform β€” see https://github.com/github/copilot-sdk/issues/1227") @Timeout(value = 300, unit = TimeUnit.SECONDS) void testShouldTriggerCompactionWithLowThresholdAndEmitEvents() throws Exception { ctx.configureForTest("compaction", "should_trigger_compaction_with_low_threshold_and_emit_events"); diff --git a/src/test/java/com/github/copilot/sdk/ConfigCloneTest.java b/src/test/java/com/github/copilot/ConfigCloneTest.java similarity index 68% rename from src/test/java/com/github/copilot/sdk/ConfigCloneTest.java rename to src/test/java/com/github/copilot/ConfigCloneTest.java index f4f702f9ee..e40a3048b0 100644 --- a/src/test/java/com/github/copilot/sdk/ConfigCloneTest.java +++ b/src/test/java/com/github/copilot/ConfigCloneTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -15,16 +15,19 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.json.CopilotClientOptions; -import com.github.copilot.sdk.json.DefaultAgentConfig; -import com.github.copilot.sdk.json.InfiniteSessionConfig; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.ModelInfo; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SystemMessageConfig; -import com.github.copilot.sdk.json.TelemetryConfig; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.rpc.AutoModeSwitchResponse; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.DefaultAgentConfig; +import com.github.copilot.rpc.ExitPlanModeResult; +import com.github.copilot.rpc.InfiniteSessionConfig; +import com.github.copilot.rpc.LargeToolOutputConfig; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.ModelInfo; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SystemMessageConfig; +import com.github.copilot.rpc.TelemetryConfig; class ConfigCloneTest { @@ -36,6 +39,11 @@ void copilotClientOptionsCloneBasic() { original.setPort(9000); original.setGitHubToken("ghp_test"); original.setUseLoggedInUser(false); + original.setCopilotHome("/custom/copilot/home"); + original.setRemote(true); + original.setSessionIdleTimeoutSeconds(600); + original.setUseStdio(false); + original.setTcpConnectionToken("my-token-123"); CopilotClientOptions cloned = original.clone(); @@ -44,6 +52,10 @@ void copilotClientOptionsCloneBasic() { assertEquals(original.getPort(), cloned.getPort()); assertEquals(original.getGitHubToken(), cloned.getGitHubToken()); assertEquals(original.getUseLoggedInUser(), cloned.getUseLoggedInUser()); + assertEquals(original.getCopilotHome(), cloned.getCopilotHome()); + assertEquals(original.isRemote(), cloned.isRemote()); + assertEquals(original.getSessionIdleTimeoutSeconds(), cloned.getSessionIdleTimeoutSeconds()); + assertEquals(original.getTcpConnectionToken(), cloned.getTcpConnectionToken()); } @Test @@ -103,6 +115,10 @@ void sessionConfigCloneBasic() { original.setSessionId("my-session"); original.setClientName("my-app"); original.setModel("gpt-4o"); + original.setReasoningSummary("detailed"); + original.setPluginDirectories(List.of("/plugins/a", "/plugins/b")); + original.setLargeOutput( + new LargeToolOutputConfig().setEnabled(true).setMaxSizeBytes(1024L).setOutputDirectory("/tmp/out")); original.setStreaming(true); SessionConfig cloned = original.clone(); @@ -110,6 +126,9 @@ void sessionConfigCloneBasic() { assertEquals(original.getSessionId(), cloned.getSessionId()); assertEquals(original.getClientName(), cloned.getClientName()); assertEquals(original.getModel(), cloned.getModel()); + assertEquals(original.getReasoningSummary(), cloned.getReasoningSummary()); + assertEquals(original.getPluginDirectories(), cloned.getPluginDirectories()); + assertEquals(original.getLargeOutput(), cloned.getLargeOutput()); assertEquals(original.isStreaming(), cloned.isStreaming()); } @@ -120,6 +139,7 @@ void sessionConfigListIndependence() { toolList.add("grep"); toolList.add("bash"); original.setAvailableTools(toolList); + original.setInstructionDirectories(new ArrayList<>(List.of("/path/a", "/path/b"))); SessionConfig cloned = original.clone(); @@ -129,6 +149,7 @@ void sessionConfigListIndependence() { // The cloned config should be unaffected by mutations to the original list assertEquals(2, cloned.getAvailableTools().size()); assertEquals(3, original.getAvailableTools().size()); + assertEquals(List.of("/path/a", "/path/b"), cloned.getInstructionDirectories()); } @Test @@ -149,11 +170,18 @@ void sessionConfigAgentAndOnEventCloned() { void resumeSessionConfigCloneBasic() { ResumeSessionConfig original = new ResumeSessionConfig(); original.setModel("o1"); + original.setReasoningSummary("none"); + original.setPluginDirectories(List.of("/plugins/r")); + original.setLargeOutput( + new LargeToolOutputConfig().setEnabled(false).setMaxSizeBytes(2048L).setOutputDirectory("/tmp/resume")); original.setStreaming(false); ResumeSessionConfig cloned = original.clone(); assertEquals(original.getModel(), cloned.getModel()); + assertEquals(original.getReasoningSummary(), cloned.getReasoningSummary()); + assertEquals(original.getPluginDirectories(), cloned.getPluginDirectories()); + assertEquals(original.getLargeOutput(), cloned.getLargeOutput()); assertEquals(original.isStreaming(), cloned.isStreaming()); } @@ -183,6 +211,44 @@ void messageOptionsCloneBasic() { assertEquals(original.getMode(), cloned.getMode()); } + @Test + void sessionConfigEnableSessionTelemetryCopied() { + SessionConfig original = new SessionConfig(); + original.setEnableSessionTelemetry(false); + + SessionConfig cloned = original.clone(); + + assertFalse(cloned.getEnableSessionTelemetry().orElse(true)); + } + + @Test + void sessionConfigEnableSessionTelemetryDefaultIsNull() { + SessionConfig original = new SessionConfig(); + + SessionConfig cloned = original.clone(); + + assertTrue(cloned.getEnableSessionTelemetry().isEmpty()); + } + + @Test + void resumeSessionConfigEnableSessionTelemetryCopied() { + ResumeSessionConfig original = new ResumeSessionConfig(); + original.setEnableSessionTelemetry(false); + + ResumeSessionConfig cloned = original.clone(); + + assertFalse(cloned.getEnableSessionTelemetry().orElse(true)); + } + + @Test + void resumeSessionConfigEnableSessionTelemetryDefaultIsNull() { + ResumeSessionConfig original = new ResumeSessionConfig(); + + ResumeSessionConfig cloned = original.clone(); + + assertTrue(cloned.getEnableSessionTelemetry().isEmpty()); + } + @Test void clonePreservesNullFields() { CopilotClientOptions opts = new CopilotClientOptions(); @@ -250,11 +316,11 @@ void copilotClientOptionsSetTelemetry() { } @Test - void copilotClientOptionsSetUseLoggedInUserNull() { + void copilotClientOptionsClearUseLoggedInUser() { var opts = new CopilotClientOptions(); - opts.setUseLoggedInUser(null); - // null β†’ Boolean.FALSE - assertEquals(Boolean.FALSE, opts.getUseLoggedInUser()); + opts.setUseLoggedInUser(true); + opts.clearUseLoggedInUser(); + assertTrue(opts.getUseLoggedInUser().isEmpty()); } @Test @@ -277,8 +343,8 @@ void resumeSessionConfigAllSetters() { config.setWorkingDirectory("/project/src"); assertEquals("/project/src", config.getWorkingDirectory()); - config.setConfigDir("/home/user/.config/copilot"); - assertEquals("/home/user/.config/copilot", config.getConfigDir()); + config.setConfigDirectory("/home/user/.config/copilot"); + assertEquals("/home/user/.config/copilot", config.getConfigDirectory()); config.setSkillDirectories(List.of("/skills/custom")); assertEquals(List.of("/skills/custom"), config.getSkillDirectories()); @@ -324,6 +390,34 @@ void copilotClientOptionsSessionIdleTimeoutCloned() { CopilotClientOptions cloned = original.clone(); - assertEquals(600, cloned.getSessionIdleTimeoutSeconds()); + assertEquals(600, cloned.getSessionIdleTimeoutSeconds().getAsInt()); + } + + @Test + void sessionConfigCloneCopiesModeSwitchHandlers() { + SessionConfig original = new SessionConfig(); + original.setOnExitPlanMode( + (request, invocation) -> CompletableFuture.completedFuture(new ExitPlanModeResult())); + original.setOnAutoModeSwitch( + (request, invocation) -> CompletableFuture.completedFuture(AutoModeSwitchResponse.NO)); + + SessionConfig cloned = original.clone(); + + assertSame(original.getOnExitPlanMode(), cloned.getOnExitPlanMode()); + assertSame(original.getOnAutoModeSwitch(), cloned.getOnAutoModeSwitch()); + } + + @Test + void resumeSessionConfigCloneCopiesModeSwitchHandlers() { + ResumeSessionConfig original = new ResumeSessionConfig(); + original.setOnExitPlanMode( + (request, invocation) -> CompletableFuture.completedFuture(new ExitPlanModeResult())); + original.setOnAutoModeSwitch( + (request, invocation) -> CompletableFuture.completedFuture(AutoModeSwitchResponse.NO)); + + ResumeSessionConfig cloned = original.clone(); + + assertSame(original.getOnExitPlanMode(), cloned.getOnExitPlanMode()); + assertSame(original.getOnAutoModeSwitch(), cloned.getOnAutoModeSwitch()); } } diff --git a/src/test/java/com/github/copilot/CopilotClientModeTest.java b/src/test/java/com/github/copilot/CopilotClientModeTest.java new file mode 100644 index 0000000000..3b70174050 --- /dev/null +++ b/src/test/java/com/github/copilot/CopilotClientModeTest.java @@ -0,0 +1,63 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import org.junit.jupiter.api.Test; + +import com.github.copilot.rpc.CopilotClientMode; +import com.github.copilot.rpc.CopilotClientOptions; + +/** + * Tests for {@link CopilotClientMode} and Empty mode validation. + */ +public class CopilotClientModeTest { + + @Test + void testDefaultModeIsCopilotCli() { + var opts = new CopilotClientOptions(); + assertEquals(CopilotClientMode.COPILOT_CLI, opts.getMode()); + } + + @Test + void testSetModeEmpty() { + var opts = new CopilotClientOptions(); + opts.setMode(CopilotClientMode.EMPTY); + assertEquals(CopilotClientMode.EMPTY, opts.getMode()); + } + + @Test + void testEmptyModeRequiresCopilotHome() { + var opts = new CopilotClientOptions().setMode(CopilotClientMode.EMPTY).setAutoStart(false); + // Empty mode without copilotHome should throw + var ex = assertThrows(IllegalArgumentException.class, () -> new CopilotClient(opts)); + assertTrue(ex.getMessage().contains("Empty mode")); + } + + @Test + void testEmptyModeWithCopilotHome() { + var opts = new CopilotClientOptions().setMode(CopilotClientMode.EMPTY).setCopilotHome("/tmp/copilot-home") + .setAutoStart(false); + // Should not throw - copilotHome is set + var client = new CopilotClient(opts); + assertEquals(ConnectionState.DISCONNECTED, client.getState()); + client.close(); + } + + @Test + void testCopilotClientModeEnumValues() { + assertEquals(2, CopilotClientMode.values().length); + assertEquals(CopilotClientMode.EMPTY, CopilotClientMode.valueOf("EMPTY")); + assertEquals(CopilotClientMode.COPILOT_CLI, CopilotClientMode.valueOf("COPILOT_CLI")); + } + + @Test + void testEnumSerializationNames() { + // CopilotClientMode is a plain enum; verify the values exist + assertNotNull(CopilotClientMode.EMPTY); + assertNotNull(CopilotClientMode.COPILOT_CLI); + } +} diff --git a/src/test/java/com/github/copilot/sdk/CopilotClientTest.java b/src/test/java/com/github/copilot/CopilotClientTest.java similarity index 90% rename from src/test/java/com/github/copilot/sdk/CopilotClientTest.java rename to src/test/java/com/github/copilot/CopilotClientTest.java index 1cc067587e..1d6bfc7044 100644 --- a/src/test/java/com/github/copilot/sdk/CopilotClientTest.java +++ b/src/test/java/com/github/copilot/CopilotClientTest.java @@ -2,17 +2,17 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.CopilotClientOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.PingResponse; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SessionLifecycleEvent; -import com.github.copilot.sdk.json.SessionLifecycleEventTypes; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.PingResponse; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionLifecycleEvent; +import com.github.copilot.rpc.SessionLifecycleEventTypes; import java.lang.reflect.Field; import java.util.ArrayList; @@ -20,6 +20,7 @@ import java.util.concurrent.ExecutionException; import static org.junit.jupiter.api.Assertions.*; +import java.util.Optional; /** * Tests for CopilotClient. @@ -91,7 +92,7 @@ void testStartAndConnectUsingStdio() throws Exception { PingResponse pong = client.ping("test message").get(); assertEquals("pong: test message", pong.message()); - assertTrue(pong.timestamp() >= 0); + assertNotNull(pong.timestamp()); client.stop().get(); assertEquals(ConnectionState.DISCONNECTED, client.getState()); @@ -153,14 +154,14 @@ void testGitHubTokenOptionAccepted() { void testUseLoggedInUserDefaultsToNull() { var options = new CopilotClientOptions().setCliPath("/path/to/cli"); - assertNull(options.getUseLoggedInUser()); + assertTrue(options.getUseLoggedInUser().isEmpty()); } @Test void testExplicitUseLoggedInUserFalse() { var options = new CopilotClientOptions().setCliPath("/path/to/cli").setUseLoggedInUser(false); - assertEquals(false, options.getUseLoggedInUser()); + assertEquals(Optional.of(false), options.getUseLoggedInUser()); } @Test @@ -168,7 +169,7 @@ void testExplicitUseLoggedInUserTrueWithGitHubToken() { var options = new CopilotClientOptions().setCliPath("/path/to/cli").setGitHubToken("gho_test_token") .setUseLoggedInUser(true); - assertEquals(true, options.getUseLoggedInUser()); + assertEquals(Optional.of(true), options.getUseLoggedInUser()); } @Test @@ -189,14 +190,38 @@ void testUseLoggedInUserWithCliUrlThrows() { void testSessionIdleTimeoutSecondsDefaultsToNull() { var options = new CopilotClientOptions(); - assertNull(options.getSessionIdleTimeoutSeconds()); + assertTrue(options.getSessionIdleTimeoutSeconds().isEmpty()); } @Test void testSessionIdleTimeoutSecondsOptionAccepted() { var options = new CopilotClientOptions().setSessionIdleTimeoutSeconds(600); - assertEquals(600, options.getSessionIdleTimeoutSeconds()); + assertEquals(600, options.getSessionIdleTimeoutSeconds().getAsInt()); + } + + @Test + void testTcpConnectionTokenWithUseStdioThrows() { + var options = new CopilotClientOptions().setUseStdio(true).setTcpConnectionToken("my-token"); + + assertThrows(IllegalArgumentException.class, () -> new CopilotClient(options)); + } + + @Test + void testTcpConnectionTokenAcceptedInTcpMode() { + var options = new CopilotClientOptions().setUseStdio(false).setTcpConnectionToken("my-token"); + + // Should not throw + try (var client = new CopilotClient(options)) { + assertNotNull(client); + } + } + + @Test + void testCopilotHomeOptionSetOnOptions() { + var options = new CopilotClientOptions().setCopilotHome("/custom/home"); + + assertEquals("/custom/home", options.getCopilotHome()); } // ===== onLifecycle tests ===== @@ -448,8 +473,8 @@ void testNullOptionsDefaultsToEmpty() { @Test void testListModels_WithCustomHandler_CallsHandler() throws Exception { - var customModels = new ArrayList(); - var model = new com.github.copilot.sdk.json.ModelInfo(); + var customModels = new ArrayList(); + var model = new com.github.copilot.rpc.ModelInfo(); model.setId("my-custom-model"); customModels.add(model); @@ -469,8 +494,8 @@ void testListModels_WithCustomHandler_CallsHandler() throws Exception { @Test void testListModels_WithCustomHandler_CachesResults() throws Exception { - var customModels = new ArrayList(); - var model = new com.github.copilot.sdk.json.ModelInfo(); + var customModels = new ArrayList(); + var model = new com.github.copilot.rpc.ModelInfo(); model.setId("cached-model"); customModels.add(model); @@ -489,8 +514,8 @@ void testListModels_WithCustomHandler_CachesResults() throws Exception { @Test void testListModels_WithCustomHandler_WorksWithoutStart() throws Exception { - var customModels = new ArrayList(); - var model = new com.github.copilot.sdk.json.ModelInfo(); + var customModels = new ArrayList(); + var model = new com.github.copilot.rpc.ModelInfo(); model.setId("no-start-model"); customModels.add(model); diff --git a/src/test/java/com/github/copilot/sdk/CopilotSessionTest.java b/src/test/java/com/github/copilot/CopilotSessionTest.java similarity index 91% rename from src/test/java/com/github/copilot/sdk/CopilotSessionTest.java rename to src/test/java/com/github/copilot/CopilotSessionTest.java index 8a78c0e4f7..44a7373ec7 100644 --- a/src/test/java/com/github/copilot/sdk/CopilotSessionTest.java +++ b/src/test/java/com/github/copilot/CopilotSessionTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.assertEquals; import static org.junit.jupiter.api.Assertions.assertFalse; @@ -20,23 +20,24 @@ import org.junit.jupiter.api.AfterAll; import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Tag; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.AbortEvent; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.generated.SessionStartEvent; -import com.github.copilot.sdk.generated.ToolExecutionStartEvent; -import com.github.copilot.sdk.generated.UserMessageEvent; -import com.github.copilot.sdk.generated.rpc.SessionRpc; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.DefaultAgentConfig; -import com.github.copilot.sdk.json.SystemMessageConfig; -import com.github.copilot.sdk.json.ToolDefinition; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.AbortEvent; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.generated.SessionStartEvent; +import com.github.copilot.generated.ToolExecutionStartEvent; +import com.github.copilot.generated.UserMessageEvent; +import com.github.copilot.generated.rpc.SessionRpc; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.DefaultAgentConfig; +import com.github.copilot.rpc.SystemMessageConfig; +import com.github.copilot.rpc.ToolDefinition; /** * Tests for CopilotSession. @@ -306,6 +307,7 @@ void testShouldResumeSessionUsingTheSameClient() throws Exception { * @see Snapshot: session/should_resume_a_session_using_a_new_client */ @Test + @Tag("isolated-resume") void testShouldResumeSessionUsingNewClient() throws Exception { ctx.configureForTest("session", "should_resume_a_session_using_a_new_client"); @@ -557,7 +559,7 @@ void testShouldCreateSessionWithCustomConfigDir() throws Exception { String customConfigDir = ctx.getWorkDir().resolve("custom-config").toString(); SessionConfig config = new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL) - .setConfigDir(customConfigDir); + .setConfigDirectory(customConfigDir); CopilotSession session = client.createSession(config).get(); assertNotNull(session.getSessionId()); @@ -758,12 +760,30 @@ void testShouldGetLastSessionId() throws Exception { .createSession(new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); session.sendAndWait(new MessageOptions().setPrompt("Say hello")).get(60, TimeUnit.SECONDS); + String sessionId = session.getSessionId(); + session.close(); - String lastId = client.getLastSessionId().get(30, TimeUnit.SECONDS); + // Poll until getLastSessionId returns the expected value. + // Session state is persisted asynchronously; polling keeps fast + // machines fast and slow CI safe (mirrors Node.js/.NET patterns). + String lastId = null; + long deadline = System.currentTimeMillis() + 10_000; + while (System.currentTimeMillis() < deadline) { + long remaining = Math.max(1, deadline - System.currentTimeMillis()); + long iterationTimeout = Math.min(remaining, 500); + try { + lastId = client.getLastSessionId().get(iterationTimeout, TimeUnit.MILLISECONDS); + } catch (java.util.concurrent.TimeoutException ignored) { + // RPC call took longer than the per-iteration cap; retry + continue; + } + if (sessionId.equals(lastId)) { + break; + } + Thread.sleep(50); + } assertNotNull(lastId, "Last session ID should not be null"); - assertEquals(session.getSessionId(), lastId, "Last session ID should match the current session ID"); - - session.close(); + assertEquals(sessionId, lastId, "Last session ID should match the current session ID"); } } @@ -810,8 +830,8 @@ void testSessionListFilterFluentAPI() throws Exception { var session = client .createSession(new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); - var filter = new com.github.copilot.sdk.json.SessionListFilter().setCwd("/test/path") - .setRepository("owner/repo").setBranch("main").setGitRoot("/test"); + var filter = new com.github.copilot.rpc.SessionListFilter().setCwd("/test/path").setRepository("owner/repo") + .setBranch("main").setGitRoot("/test"); assertEquals("/test/path", filter.getCwd()); assertEquals("owner/repo", filter.getRepository()); @@ -838,11 +858,31 @@ void testShouldGetSessionMetadataById() throws Exception { var session = client .createSession(new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + // Send a message to persist the session to disk session.sendAndWait(new MessageOptions().setPrompt("Say hello")).get(60, TimeUnit.SECONDS); - var metadata = client.getSessionMetadata(session.getSessionId()).get(30, TimeUnit.SECONDS); - assertNotNull(metadata, "Metadata should not be null for known session"); - assertEquals(session.getSessionId(), metadata.getSessionId(), "Metadata session ID should match"); + // Poll until metadata becomes available; the CLI persists session + // state asynchronously so it may not be queryable immediately + // (mirrors .NET WaitForConditionAsync pattern). + var sessionId = session.getSessionId(); + com.github.copilot.rpc.SessionMetadata metadata = null; + long deadline = System.currentTimeMillis() + 10_000; + while (System.currentTimeMillis() < deadline) { + long remaining = Math.max(1, deadline - System.currentTimeMillis()); + long iterationTimeout = Math.min(remaining, 500); + try { + metadata = client.getSessionMetadata(sessionId).get(iterationTimeout, TimeUnit.MILLISECONDS); + } catch (java.util.concurrent.TimeoutException ignored) { + // RPC call took longer than the per-iteration cap; retry + continue; + } + if (metadata != null) { + break; + } + Thread.sleep(50); + } + assertNotNull(metadata, "Timed out waiting for getSessionMetadata() to return the persisted session"); + assertEquals(sessionId, metadata.getSessionId(), "Metadata session ID should match"); // A non-existent session should return null var notFound = client.getSessionMetadata("non-existent-session-id").get(30, TimeUnit.SECONDS); diff --git a/src/test/java/com/github/copilot/CreateSessionReKeyEntryTest.java b/src/test/java/com/github/copilot/CreateSessionReKeyEntryTest.java new file mode 100644 index 0000000000..156c968489 --- /dev/null +++ b/src/test/java/com/github/copilot/CreateSessionReKeyEntryTest.java @@ -0,0 +1,262 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import java.io.OutputStream; +import java.lang.reflect.Field; +import java.net.ServerSocket; +import java.net.Socket; +import java.nio.charset.StandardCharsets; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutionException; + +import org.junit.jupiter.api.Test; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; + +/** + * Tests that CopilotClient rejects session.create responses whose sessionId + * differs from the client-supplied one. Re-keying the sessions map at runtime + * is intentionally not supported β€” the server must honor the client-supplied + * sessionId (or generate one when none is supplied). + */ +class CreateSessionReKeyEntryTest { + + private static final ObjectMapper MAPPER = JsonRpcClient.getObjectMapper(); + + /** + * A connected socket pair where the server replies to "session.create" with a + * configurable sessionId and then replies to "session.options.update" with + * success or failure. + */ + private static final class ReKeyServer implements AutoCloseable { + + final Socket clientSocket; + final Socket serverSocket; + final JsonRpcClient rpcClient; + private volatile boolean running = true; + private final Thread replyThread; + + /** The sessionId to return in the session.create response. */ + private final String returnedSessionId; + /** If true, the session.options.update call will fail. */ + private final boolean failOptionsUpdate; + + ReKeyServer(String returnedSessionId, boolean failOptionsUpdate) throws Exception { + this.returnedSessionId = returnedSessionId; + this.failOptionsUpdate = failOptionsUpdate; + + try (var ss = new ServerSocket(0)) { + clientSocket = new Socket("localhost", ss.getLocalPort()); + serverSocket = ss.accept(); + } + serverSocket.setSoTimeout(5000); + rpcClient = JsonRpcClient.fromSocket(clientSocket); + + replyThread = new Thread(() -> { + try { + var in = serverSocket.getInputStream(); + var out = serverSocket.getOutputStream(); + while (running) { + // Read Content-Length header + var header = new StringBuilder(); + int b; + while ((b = in.read()) != -1) { + if (b == '\n' && header.toString().endsWith("\r")) { + break; + } + header.append((char) b); + } + if (b == -1) + break; + // Skip blank line + in.read(); // '\r' + in.read(); // '\n' + + String hdr = header.toString().trim(); + int colon = hdr.indexOf(':'); + int len = Integer.parseInt(hdr.substring(colon + 1).trim()); + byte[] body = in.readNBytes(len); + JsonNode msg = MAPPER.readTree(body); + + String method = msg.get("method").asText(); + long id = msg.get("id").asLong(); + + if ("session.create".equals(method)) { + // Return a response with the (possibly different) session ID + ObjectNode result = MAPPER.createObjectNode(); + result.put("sessionId", returnedSessionId); + String response = MAPPER.writeValueAsString(MAPPER.createObjectNode().put("jsonrpc", "2.0") + .put("id", id).set("result", result)); + sendRpcMessage(out, response); + } else if ("session.options.update".equals(method)) { + if (failOptionsUpdate) { + // Send an error response + ObjectNode error = MAPPER.createObjectNode(); + error.put("code", -32000); + error.put("message", "simulated options update failure"); + String response = MAPPER.writeValueAsString(MAPPER.createObjectNode() + .put("jsonrpc", "2.0").put("id", id).set("error", error)); + sendRpcMessage(out, response); + } else { + // Send a success response + String response = MAPPER.writeValueAsString( + MAPPER.createObjectNode().put("jsonrpc", "2.0").put("id", id).set("result", + MAPPER.createObjectNode().put("success", true))); + sendRpcMessage(out, response); + } + } else { + // Generic success for anything else + String response = MAPPER.writeValueAsString(MAPPER.createObjectNode().put("jsonrpc", "2.0") + .put("id", id).set("result", MAPPER.createObjectNode().put("success", true))); + sendRpcMessage(out, response); + } + } + } catch (Exception e) { + if (running) { + // Ignore expected exceptions on shutdown + } + } + }); + replyThread.setDaemon(true); + replyThread.start(); + } + + private static void sendRpcMessage(OutputStream out, String json) throws Exception { + byte[] bytes = json.getBytes(StandardCharsets.UTF_8); + String header = "Content-Length: " + bytes.length + "\r\n\r\n"; + out.write(header.getBytes(StandardCharsets.UTF_8)); + out.write(bytes); + out.flush(); + } + + @Override + public void close() throws Exception { + running = false; + rpcClient.close(); + clientSocket.close(); + serverSocket.close(); + replyThread.join(3000); + } + } + + @SuppressWarnings("unchecked") + private static Map getSessionsMap(CopilotClient client) throws Exception { + Field f = CopilotClient.class.getDeclaredField("sessions"); + f.setAccessible(true); + return (Map) f.get(client); + } + + private static void injectConnection(CopilotClient client, JsonRpcClient rpc) throws Exception { + // Build a Connection record via the private record constructor + Class connClass = null; + for (Class c : CopilotClient.class.getDeclaredClasses()) { + if (c.getSimpleName().equals("Connection")) { + connClass = c; + break; + } + } + assertNotNull(connClass, "Could not find Connection inner class"); + + var ctor = connClass.getDeclaredConstructors()[0]; + ctor.setAccessible(true); + // Connection(JsonRpcClient rpc, Process process, ServerRpc serverRpc) + Object connection = ctor.newInstance(rpc, null, null); + + Field f = CopilotClient.class.getDeclaredField("connectionFuture"); + f.setAccessible(true); + f.set(client, CompletableFuture.completedFuture(connection)); + } + + @Test + void createSession_serverReturnsDifferentSessionId_throwsAndRemovesPreRegisteredEntry() throws Exception { + String clientSessionId = "client-supplied-id"; + String serverSessionId = "server-returned-id"; + + try (var server = new ReKeyServer(serverSessionId, false)) { + var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false)); + injectConnection(client, server.rpcClient); + + var config = new SessionConfig().setSessionId(clientSessionId) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL); + + ExecutionException ex = assertThrows(ExecutionException.class, () -> client.createSession(config).get()); + assertNotNull(ex.getCause()); + assertTrue(ex.getCause().getMessage().contains(serverSessionId), + "Error message should mention the server-returned sessionId"); + assertTrue(ex.getCause().getMessage().contains(clientSessionId), + "Error message should mention the client-requested sessionId"); + + Map sessions = getSessionsMap(client); + assertNull(sessions.get(clientSessionId), + "Pre-registered client-supplied sessionId should be removed after rejection"); + assertNull(sessions.get(serverSessionId), + "Server-returned sessionId should never be registered after rejection"); + assertTrue(sessions.isEmpty(), "Sessions map should be empty after rejected create"); + + client.close(); + } + } + + @Test + void createSession_serverReturnsDifferentSessionIdWithSkipCustomInstructions_throwsAndCleansUp() throws Exception { + String clientSessionId = "client-supplied-id"; + String serverSessionId = "server-returned-id"; + + try (var server = new ReKeyServer(serverSessionId, true)) { + var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false)); + injectConnection(client, server.rpcClient); + + // Even when skipCustomInstructions would trigger session.options.update, + // the sessionId-mismatch error fires first and short-circuits the flow. + var config = new SessionConfig().setSessionId(clientSessionId) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL).setSkipCustomInstructions(true); + + ExecutionException ex = assertThrows(ExecutionException.class, () -> client.createSession(config).get()); + assertNotNull(ex.getCause()); + + Map sessions = getSessionsMap(client); + assertNull(sessions.get(clientSessionId), + "Pre-registered client-supplied sessionId should be removed on failure"); + assertNull(sessions.get(serverSessionId), + "Server-returned sessionId should never be registered on failure"); + assertTrue(sessions.isEmpty(), "Sessions map should be empty after failed create"); + + client.close(); + } + } + + @Test + void createSession_serverReturnsSameSessionId_sessionKeptUnderClientId() throws Exception { + String sessionId = "same-id-for-both"; + + try (var server = new ReKeyServer(sessionId, false)) { + var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false)); + injectConnection(client, server.rpcClient); + + var config = new SessionConfig().setSessionId(sessionId) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL); + + CopilotSession session = client.createSession(config).get(); + + Map sessions = getSessionsMap(client); + + // When IDs match, the session stays under the original key + assertSame(session, sessions.get(sessionId), + "Session should remain under original key when server returns same ID"); + assertEquals(1, sessions.size(), "Should have exactly one entry in sessions map"); + + client.close(); + } + } +} diff --git a/src/test/java/com/github/copilot/sdk/DataObjectCoverageTest.java b/src/test/java/com/github/copilot/DataObjectCoverageTest.java similarity index 50% rename from src/test/java/com/github/copilot/sdk/DataObjectCoverageTest.java rename to src/test/java/com/github/copilot/DataObjectCoverageTest.java index 203f5faed6..ece824234b 100644 --- a/src/test/java/com/github/copilot/sdk/DataObjectCoverageTest.java +++ b/src/test/java/com/github/copilot/DataObjectCoverageTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -10,17 +10,22 @@ import com.fasterxml.jackson.databind.node.JsonNodeFactory; import com.fasterxml.jackson.databind.node.ObjectNode; -import com.github.copilot.sdk.json.GetForegroundSessionResponse; -import com.github.copilot.sdk.json.PermissionRequest; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PostToolUseHookInput; -import com.github.copilot.sdk.json.PostToolUseHookOutput; -import com.github.copilot.sdk.json.PreToolUseHookInput; -import com.github.copilot.sdk.json.PreToolUseHookOutput; -import com.github.copilot.sdk.json.SectionOverride; -import com.github.copilot.sdk.json.SetForegroundSessionResponse; -import com.github.copilot.sdk.json.ToolBinaryResult; -import com.github.copilot.sdk.json.ToolResultObject; +import com.github.copilot.rpc.CustomAgentConfig; +import com.github.copilot.rpc.GetForegroundSessionResponse; +import com.github.copilot.rpc.McpHttpServerConfig; +import com.github.copilot.rpc.McpStdioServerConfig; +import com.github.copilot.rpc.ModelCapabilitiesOverride; +import com.github.copilot.rpc.PermissionRequest; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PostToolUseHookInput; +import com.github.copilot.rpc.PostToolUseHookOutput; +import com.github.copilot.rpc.PreToolUseHookInput; +import com.github.copilot.rpc.PreToolUseHookOutput; +import com.github.copilot.rpc.SectionOverride; +import com.github.copilot.rpc.SetForegroundSessionRequest; +import com.github.copilot.rpc.SetForegroundSessionResponse; +import com.github.copilot.rpc.ToolBinaryResult; +import com.github.copilot.rpc.ToolResultObject; /** * Unit tests for various data transfer objects and record types that were @@ -86,6 +91,14 @@ void getForegroundSessionResponseRecord() { assertEquals("/home/user/project", response.workspacePath()); } + // ===== SetForegroundSessionRequest record ===== + + @Test + void setForegroundSessionRequestRecord() { + var request = new SetForegroundSessionRequest("session-123"); + assertEquals("session-123", request.sessionId()); + } + // ===== SetForegroundSessionResponse record ===== @Test @@ -144,6 +157,14 @@ void preToolUseHookInputGetters() { assertEquals(0L, input.getTimestamp()); assertNull(input.getCwd()); assertNull(input.getToolArgs()); + assertNull(input.getSessionId()); + } + + @Test + void preToolUseHookInputSessionIdRoundTrip() { + var input = new PreToolUseHookInput(); + input.setSessionId("session-abc"); + assertEquals("session-abc", input.getSessionId()); } // ===== PostToolUseHookInput getters ===== @@ -155,6 +176,55 @@ void postToolUseHookInputGetters() { assertEquals(0L, input.getTimestamp()); assertNull(input.getCwd()); assertNull(input.getToolArgs()); + assertNull(input.getSessionId()); + } + + @Test + void postToolUseHookInputSessionIdRoundTrip() { + var input = new PostToolUseHookInput(); + input.setSessionId("session-xyz"); + assertEquals("session-xyz", input.getSessionId()); + } + + // ===== CustomAgentConfig model field ===== + + @Test + void customAgentConfigModelGetterAndSetter() { + var cfg = new CustomAgentConfig(); + assertNull(cfg.getModel()); + + cfg.setModel("claude-haiku-4.5"); + assertEquals("claude-haiku-4.5", cfg.getModel()); + } + + @Test + void customAgentConfigModelFluentChaining() { + var cfg = new CustomAgentConfig().setName("reviewer").setModel("gpt-5").setDescription("Code reviewer"); + assertEquals("reviewer", cfg.getName()); + assertEquals("gpt-5", cfg.getModel()); + assertEquals("Code reviewer", cfg.getDescription()); + } + + @Test + void customAgentConfigModelSerializationRoundTrip() throws Exception { + var mapper = JsonRpcClient.getObjectMapper(); + var cfg = new CustomAgentConfig().setName("my-agent").setModel("claude-haiku-4.5"); + + var json = mapper.writeValueAsString(cfg); + assertTrue(json.contains("\"model\":\"claude-haiku-4.5\"")); + + var deserialized = mapper.readValue(json, CustomAgentConfig.class); + assertEquals("my-agent", deserialized.getName()); + assertEquals("claude-haiku-4.5", deserialized.getModel()); + } + + @Test + void customAgentConfigModelOmittedWhenNull() throws Exception { + var mapper = JsonRpcClient.getObjectMapper(); + var cfg = new CustomAgentConfig().setName("no-model-agent"); + + var json = mapper.writeValueAsString(cfg); + assertFalse(json.contains("\"model\"")); } // ===== PermissionRequestResult setRules ===== @@ -169,4 +239,52 @@ void permissionRequestResultSetRules() { assertEquals(2, result.getRules().size()); assertEquals("bash:read", result.getRules().get(0)); } + + @Test + void mcpHttpServerConfigCoversGettersAndFluentSetters() { + var headers = java.util.Map.of("Authorization", "Bearer token"); + var tools = java.util.List.of("*", "search"); + + var cfg = new McpHttpServerConfig().setUrl("https://mcp.example.com/sse").setHeaders(headers).setTools(tools) + .setTimeout(45); + + assertEquals("http", cfg.getType()); + assertEquals("https://mcp.example.com/sse", cfg.getUrl()); + assertEquals("Bearer token", cfg.getHeaders().get("Authorization")); + assertEquals(tools, cfg.getTools()); + assertEquals(45, cfg.getTimeout()); + } + + @Test + void mcpStdioServerConfigCoversGettersAndFluentSetters() { + var args = java.util.List.of("-y", "@modelcontextprotocol/server-filesystem"); + var env = java.util.Map.of("DEBUG", "1"); + var tools = java.util.List.of("*"); + + var cfg = new McpStdioServerConfig().setCommand("npx").setArgs(args).setEnv(env).setWorkingDirectory("/tmp") + .setTools(tools).setTimeout(30); + + assertEquals("stdio", cfg.getType()); + assertEquals("npx", cfg.getCommand()); + assertEquals(args, cfg.getArgs()); + assertEquals("1", cfg.getEnv().get("DEBUG")); + assertEquals("/tmp", cfg.getWorkingDirectory()); + assertEquals(tools, cfg.getTools()); + assertEquals(30, cfg.getTimeout()); + } + + @Test + void modelCapabilitiesOverrideCoversNestedSupportsAndLimits() { + var supports = new ModelCapabilitiesOverride.Supports().setVision(true).setReasoningEffort(false); + var limits = new ModelCapabilitiesOverride.Limits().setMaxPromptTokens(2048).setMaxOutputTokens(512) + .setMaxContextWindowTokens(8192); + + var override = new ModelCapabilitiesOverride().setSupports(supports).setLimits(limits); + + assertTrue(override.getSupports().getVision().orElse(false)); + assertFalse(override.getSupports().getReasoningEffort().orElse(true)); + assertEquals(2048, override.getLimits().getMaxPromptTokens().getAsInt()); + assertEquals(512, override.getLimits().getMaxOutputTokens().getAsInt()); + assertEquals(8192, override.getLimits().getMaxContextWindowTokens().getAsInt()); + } } diff --git a/src/test/java/com/github/copilot/sdk/DocumentationSamplesTest.java b/src/test/java/com/github/copilot/DocumentationSamplesTest.java similarity index 94% rename from src/test/java/com/github/copilot/sdk/DocumentationSamplesTest.java rename to src/test/java/com/github/copilot/DocumentationSamplesTest.java index bb8a6f07e2..f7170f4fde 100644 --- a/src/test/java/com/github/copilot/sdk/DocumentationSamplesTest.java +++ b/src/test/java/com/github/copilot/DocumentationSamplesTest.java @@ -1,4 +1,4 @@ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.assertFalse; @@ -7,7 +7,6 @@ import java.nio.file.Path; import java.util.ArrayList; import java.util.List; -import java.util.stream.Stream; import org.junit.jupiter.api.Test; @@ -135,11 +134,6 @@ private static List documentationFiles() throws IOException { List files = new ArrayList<>(); files.add(root.resolve("README.md")); files.add(root.resolve("jbang-example.java")); - - try (Stream markdownFiles = Files.walk(root.resolve("src/site/markdown"))) { - markdownFiles.filter(Files::isRegularFile).filter(path -> path.toString().endsWith(".md")) - .forEach(files::add); - } return files; } } diff --git a/src/test/java/com/github/copilot/sdk/E2ETestContext.java b/src/test/java/com/github/copilot/E2ETestContext.java similarity index 91% rename from src/test/java/com/github/copilot/sdk/E2ETestContext.java rename to src/test/java/com/github/copilot/E2ETestContext.java index 45fcbc0a5d..2bc139d940 100644 --- a/src/test/java/com/github/copilot/sdk/E2ETestContext.java +++ b/src/test/java/com/github/copilot/E2ETestContext.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.io.BufferedReader; import java.io.IOException; @@ -18,7 +18,7 @@ import java.util.regex.Matcher; import java.util.regex.Pattern; -import com.github.copilot.sdk.json.CopilotClientOptions; +import com.github.copilot.rpc.CopilotClientOptions; /** * E2E test context that manages the test environment including the CapiProxy, @@ -121,6 +121,13 @@ public Path getWorkDir() { return workDir; } + /** + * Gets the repository root for locating shared test assets. + */ + public Path getRepoRoot() { + return repoRoot; + } + /** * Gets the proxy URL. */ @@ -249,8 +256,33 @@ public List> getExchanges() throws IOException, InterruptedE public Map getEnvironment() { Map env = new HashMap<>(System.getenv()); env.put("COPILOT_API_URL", proxyUrl); + env.put("COPILOT_HOME", homeDir.toString()); + env.put("GH_CONFIG_DIR", homeDir.toString()); env.put("XDG_CONFIG_HOME", homeDir.toString()); env.put("XDG_STATE_HOME", homeDir.toString()); + + // Configure CONNECT proxy for HTTPS interception if available + String connectUrl = proxy.getConnectProxyUrl(); + String caFile = proxy.getCaFilePath(); + if (connectUrl != null && !connectUrl.isEmpty() && caFile != null && !caFile.isEmpty()) { + String noProxy = "127.0.0.1,localhost,::1"; + env.put("HTTP_PROXY", connectUrl); + env.put("HTTPS_PROXY", connectUrl); + env.put("http_proxy", connectUrl); + env.put("https_proxy", connectUrl); + env.put("NO_PROXY", noProxy); + env.put("no_proxy", noProxy); + env.put("NODE_EXTRA_CA_CERTS", caFile); + env.put("SSL_CERT_FILE", caFile); + env.put("REQUESTS_CA_BUNDLE", caFile); + env.put("CURL_CA_BUNDLE", caFile); + env.put("GIT_SSL_CAINFO", caFile); + env.put("GH_TOKEN", "fake-token-for-e2e-tests"); + env.put("GITHUB_TOKEN", "fake-token-for-e2e-tests"); + env.put("GH_ENTERPRISE_TOKEN", ""); + env.put("GITHUB_ENTERPRISE_TOKEN", ""); + } + return env; } @@ -261,13 +293,7 @@ public Map getEnvironment() { */ public CopilotClient createClient() { CopilotClientOptions options = new CopilotClientOptions().setCliPath(cliPath).setCwd(workDir.toString()) - .setEnvironment(getEnvironment()); - - // In CI (GitHub Actions), use a fake token to avoid auth issues - String ci = System.getenv("GITHUB_ACTIONS"); - if (ci != null && !ci.isEmpty()) { - options.setGitHubToken("fake-token-for-e2e-tests"); - } + .setEnvironment(getEnvironment()).setGitHubToken("fake-token-for-e2e-tests"); return new CopilotClient(options); } @@ -291,10 +317,7 @@ public CopilotClient createClient(CopilotClientOptions options) { if (options.getEnvironment() == null || options.getEnvironment().isEmpty()) { options.setEnvironment(getEnvironment()); } - - // In CI (GitHub Actions), use a fake token to avoid auth issues - String ci = System.getenv("GITHUB_ACTIONS"); - if (ci != null && !ci.isEmpty() && options.getGitHubToken() == null) { + if (options.getGitHubToken() == null) { options.setGitHubToken("fake-token-for-e2e-tests"); } diff --git a/src/test/java/com/github/copilot/sdk/ElicitationTest.java b/src/test/java/com/github/copilot/ElicitationTest.java similarity index 86% rename from src/test/java/com/github/copilot/sdk/ElicitationTest.java rename to src/test/java/com/github/copilot/ElicitationTest.java index 6b748b4cc2..2fcb03fe5e 100644 --- a/src/test/java/com/github/copilot/sdk/ElicitationTest.java +++ b/src/test/java/com/github/copilot/ElicitationTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -12,18 +12,18 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.ElicitationContext; -import com.github.copilot.sdk.json.ElicitationHandler; -import com.github.copilot.sdk.json.ElicitationParams; -import com.github.copilot.sdk.json.ElicitationResult; -import com.github.copilot.sdk.json.ElicitationResultAction; -import com.github.copilot.sdk.json.ElicitationSchema; -import com.github.copilot.sdk.json.InputOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.SessionCapabilities; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SessionUiCapabilities; +import com.github.copilot.rpc.ElicitationContext; +import com.github.copilot.rpc.ElicitationHandler; +import com.github.copilot.rpc.ElicitationParams; +import com.github.copilot.rpc.ElicitationResult; +import com.github.copilot.rpc.ElicitationResultAction; +import com.github.copilot.rpc.ElicitationSchema; +import com.github.copilot.rpc.InputOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionCapabilities; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionUiCapabilities; /** * Unit tests for the Elicitation feature and Session Capabilities. @@ -40,7 +40,7 @@ void sessionCapabilitiesTypesAreProperlyStructured() { var capabilities = new SessionCapabilities().setUi(new SessionUiCapabilities().setElicitation(true)); assertNotNull(capabilities.getUi()); - assertTrue(capabilities.getUi().getElicitation()); + assertTrue(capabilities.getUi().getElicitation().get()); // Test with null UI var emptyCapabilities = new SessionCapabilities(); @@ -119,8 +119,8 @@ void inputOptionsHasAllFields() { assertEquals("My Title", opts.getTitle()); assertEquals("My Desc", opts.getDescription()); - assertEquals(1, opts.getMinLength()); - assertEquals(100, opts.getMaxLength()); + assertEquals(1, opts.getMinLength().getAsInt()); + assertEquals(100, opts.getMaxLength().getAsInt()); assertEquals("email", opts.getFormat()); assertEquals("default@example.com", opts.getDefaultValue()); } @@ -164,7 +164,7 @@ void buildCreateRequestSetsRequestElicitationWhenHandlerPresent() { var request = SessionRequestBuilder.buildCreateRequest(config); - assertTrue(Boolean.TRUE.equals(request.getRequestElicitation())); + assertEquals(Boolean.TRUE, request.getRequestElicitation()); } @Test @@ -186,6 +186,6 @@ void buildResumeRequestSetsRequestElicitationWhenHandlerPresent() { var request = SessionRequestBuilder.buildResumeRequest("session-1", config); - assertTrue(Boolean.TRUE.equals(request.getRequestElicitation())); + assertEquals(Boolean.TRUE, request.getRequestElicitation()); } } diff --git a/src/test/java/com/github/copilot/sdk/ErrorHandlingTest.java b/src/test/java/com/github/copilot/ErrorHandlingTest.java similarity index 95% rename from src/test/java/com/github/copilot/sdk/ErrorHandlingTest.java rename to src/test/java/com/github/copilot/ErrorHandlingTest.java index 8c606930a7..32579ffc4e 100644 --- a/src/test/java/com/github/copilot/sdk/ErrorHandlingTest.java +++ b/src/test/java/com/github/copilot/ErrorHandlingTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -16,13 +16,13 @@ import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionErrorEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.ToolDefinition; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionErrorEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.ToolDefinition; import java.util.Map; @@ -84,7 +84,7 @@ void testHandlesToolCallingErrors_toolErrorDoesNotCrashSession() throws Exceptio assertNotNull(response, "Should receive a response even when tool fails"); // Should have received session.idle (indicating successful completion) - assertTrue(allEvents.stream().anyMatch(e -> e instanceof com.github.copilot.sdk.generated.SessionIdleEvent), + assertTrue(allEvents.stream().anyMatch(e -> e instanceof com.github.copilot.generated.SessionIdleEvent), "Session should reach idle state after handling tool error"); session.close(); diff --git a/src/test/java/com/github/copilot/EventFidelityTest.java b/src/test/java/com/github/copilot/EventFidelityTest.java new file mode 100644 index 0000000000..cca63b4d67 --- /dev/null +++ b/src/test/java/com/github/copilot/EventFidelityTest.java @@ -0,0 +1,111 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.github.copilot.generated.AssistantUsageEvent; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.SessionUsageInfoEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; + +/** + * E2E tests for event fidelity β€” verifying the shape, ordering, and presence of + * key events emitted from the runtime. + * + *

+ * Snapshots are stored in {@code test/snapshots/event_fidelity/}. + *

+ */ +public class EventFidelityTest { + + private static E2ETestContext ctx; + + @BeforeAll + static void setup() throws Exception { + ctx = E2ETestContext.create(); + } + + @AfterAll + static void teardown() throws Exception { + if (ctx != null) { + ctx.close(); + } + } + + /** + * Verifies that an {@code assistant.usage} event is emitted after the model + * processes a prompt. + * + * @see Snapshot: + * event_fidelity/should_emit_assistant_usage_event_after_model_call + */ + @Test + void testShouldEmitAssistantUsageEventAfterModelCall() throws Exception { + ctx.configureForTest("event_fidelity", "should_emit_assistant_usage_event_after_model_call"); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client + .createSession(new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + List events = new ArrayList<>(); + session.on(events::add); + + session.sendAndWait(new MessageOptions().setPrompt("What is 5+5? Reply with just the number.")).get(60, + TimeUnit.SECONDS); + + List usageEvents = events.stream().filter(e -> e instanceof AssistantUsageEvent) + .map(e -> (AssistantUsageEvent) e).toList(); + + assertFalse(usageEvents.isEmpty(), "Should have received an assistant.usage event after model call"); + + AssistantUsageEvent lastUsage = usageEvents.get(usageEvents.size() - 1); + assertNotNull(lastUsage.getData().model(), "Usage event should have a model field"); + assertFalse(lastUsage.getData().model().isEmpty(), "Model field should not be empty"); + + session.close(); + } + } + + /** + * Verifies that a {@code session.usage_info} event is emitted after the model + * processes a prompt. + * + * @see Snapshot: + * event_fidelity/should_emit_session_usage_info_event_after_model_call + */ + @Test + void testShouldEmitSessionUsageInfoEventAfterModelCall() throws Exception { + ctx.configureForTest("event_fidelity", "should_emit_session_usage_info_event_after_model_call"); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client + .createSession(new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + List events = new ArrayList<>(); + session.on(events::add); + + session.sendAndWait(new MessageOptions().setPrompt("What is 5+5? Reply with just the number.")).get(60, + TimeUnit.SECONDS); + + List usageInfoEvents = events.stream() + .filter(e -> e instanceof SessionUsageInfoEvent).map(e -> (SessionUsageInfoEvent) e).toList(); + + assertFalse(usageInfoEvents.isEmpty(), "Should have received a session.usage_info event after model call"); + + session.close(); + } + } +} diff --git a/src/test/java/com/github/copilot/sdk/ExecutorWiringTest.java b/src/test/java/com/github/copilot/ExecutorWiringTest.java similarity index 94% rename from src/test/java/com/github/copilot/sdk/ExecutorWiringTest.java rename to src/test/java/com/github/copilot/ExecutorWiringTest.java index f836be89a3..78764db0fb 100644 --- a/src/test/java/com/github/copilot/sdk/ExecutorWiringTest.java +++ b/src/test/java/com/github/copilot/ExecutorWiringTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -21,17 +21,17 @@ import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.CopilotClientOptions; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PermissionRequestResultKind; -import com.github.copilot.sdk.json.PreToolUseHookOutput; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SessionHooks; -import com.github.copilot.sdk.json.ToolDefinition; -import com.github.copilot.sdk.json.UserInputResponse; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PermissionRequestResultKind; +import com.github.copilot.rpc.PreToolUseHookOutput; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionHooks; +import com.github.copilot.rpc.ToolDefinition; +import com.github.copilot.rpc.UserInputResponse; /** * Tests verifying that when an {@link Executor} is provided via @@ -87,12 +87,8 @@ int getTaskCount() { private CopilotClientOptions createOptionsWithExecutor(TrackingExecutor executor) { CopilotClientOptions options = new CopilotClientOptions().setCliPath(ctx.getCliPath()) - .setCwd(ctx.getWorkDir().toString()).setEnvironment(ctx.getEnvironment()).setExecutor(executor); - - String ci = System.getenv("GITHUB_ACTIONS"); - if (ci != null && !ci.isEmpty()) { - options.setGitHubToken("fake-token-for-e2e-tests"); - } + .setCwd(ctx.getWorkDir().toString()).setEnvironment(ctx.getEnvironment()).setExecutor(executor) + .setGitHubToken("fake-token-for-e2e-tests"); return options; } diff --git a/src/test/java/com/github/copilot/sdk/ForwardCompatibilityTest.java b/src/test/java/com/github/copilot/ForwardCompatibilityTest.java similarity index 94% rename from src/test/java/com/github/copilot/sdk/ForwardCompatibilityTest.java rename to src/test/java/com/github/copilot/ForwardCompatibilityTest.java index 06e2af5cf0..40166307e3 100644 --- a/src/test/java/com/github/copilot/sdk/ForwardCompatibilityTest.java +++ b/src/test/java/com/github/copilot/ForwardCompatibilityTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -10,9 +10,9 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.UnknownSessionEvent; -import com.github.copilot.sdk.generated.UserMessageEvent; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.UnknownSessionEvent; +import com.github.copilot.generated.UserMessageEvent; /** * Unit tests for forward-compatible handling of unknown session event types. diff --git a/src/test/java/com/github/copilot/sdk/HooksTest.java b/src/test/java/com/github/copilot/HooksTest.java similarity index 95% rename from src/test/java/com/github/copilot/sdk/HooksTest.java rename to src/test/java/com/github/copilot/HooksTest.java index 1278d082b5..4608848f19 100644 --- a/src/test/java/com/github/copilot/sdk/HooksTest.java +++ b/src/test/java/com/github/copilot/HooksTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -18,13 +18,13 @@ import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.PostToolUseHookInput; -import com.github.copilot.sdk.json.PreToolUseHookInput; -import com.github.copilot.sdk.json.PreToolUseHookOutput; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SessionHooks; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.PostToolUseHookInput; +import com.github.copilot.rpc.PreToolUseHookInput; +import com.github.copilot.rpc.PreToolUseHookOutput; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionHooks; /** * Tests for hooks functionality (pre-tool-use and post-tool-use hooks). diff --git a/src/test/java/com/github/copilot/InternalExecutorProviderIT.java b/src/test/java/com/github/copilot/InternalExecutorProviderIT.java new file mode 100644 index 0000000000..1cc6b482e8 --- /dev/null +++ b/src/test/java/com/github/copilot/InternalExecutorProviderIT.java @@ -0,0 +1,108 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.File; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.Test; + +/** + * Failsafe integration test that asserts the multi-release behaviour of + * {@link InternalExecutorProvider} against the actually packaged JAR. + *

+ * Runs after {@code package}, when {@code target/${finalName}.jar} exists with + * its real {@code Multi-Release: true} manifest and (on JDK 25+ builds) the + * {@code META-INF/versions/25/} override produced by {@code maven-jar-plugin}. + *

+ * The test spawns a child JVM with the packaged JAR plus {@code test-classes} + * on the classpath, runs {@link InternalExecutorProviderProbe}, and asserts + * that the executor selected for the current runtime matches expectations. + */ +class InternalExecutorProviderIT { + + @Test + void packagedJarSelectsExecutorPerRuntimeVersion() throws Exception { + Path packagedJar = locatePackagedJar(); + Path testClasses = locateTestClassesDir(); + String javaBin = locateJavaBinary(); + + String classpath = packagedJar.toString() + File.pathSeparator + testClasses.toString(); + Process process = new ProcessBuilder(javaBin, "-cp", classpath, + "com.github.copilot.InternalExecutorProviderProbe").redirectErrorStream(true).start(); + + String output; + try { + output = new String(process.getInputStream().readAllBytes(), StandardCharsets.UTF_8); + assertTrue(process.waitFor(30, TimeUnit.SECONDS), "Probe JVM did not exit within 30s. Output:\n" + output); + } finally { + if (process.isAlive()) { + process.destroyForcibly(); + } + } + + assertEquals(0, process.exitValue(), "Probe exited non-zero. Output:\n" + output); + + Map kv = parseKeyValues(output); + String featureRaw = kv.get("feature"); + assertNotNull(featureRaw, "Probe did not report 'feature'. Output:\n" + output); + int feature = Integer.parseInt(featureRaw); + + boolean expectOwnedVirtual = feature >= 25; + assertEquals(String.valueOf(expectOwnedVirtual), kv.get("canBeShutdown"), + "canBeShutdown mismatch for JDK feature=" + feature + ". Output:\n" + output); + assertEquals(String.valueOf(expectOwnedVirtual), kv.get("virtual"), + "virtual mismatch for JDK feature=" + feature + ". Output:\n" + output); + } + + private static Path locatePackagedJar() { + String buildDir = System.getProperty("project.build.directory"); + String finalName = System.getProperty("project.build.finalName"); + assertNotNull(buildDir, "System property 'project.build.directory' must be set by failsafe"); + assertNotNull(finalName, "System property 'project.build.finalName' must be set by failsafe"); + Path jar = Path.of(buildDir, finalName + ".jar"); + assertTrue(Files.isRegularFile(jar), "Packaged JAR must exist: " + jar); + return jar; + } + + private static Path locateTestClassesDir() { + String testOutput = System.getProperty("project.build.testOutputDirectory"); + assertNotNull(testOutput, "System property 'project.build.testOutputDirectory' must be set by failsafe"); + Path dir = Path.of(testOutput); + assertTrue(Files.isDirectory(dir), "test-classes dir must exist: " + dir); + return dir; + } + + private static String locateJavaBinary() { + Path javaHome = Path.of(System.getProperty("java.home")); + Path candidate = javaHome.resolve("bin").resolve(isWindows() ? "java.exe" : "java"); + assertTrue(Files.isExecutable(candidate), "java binary must be executable: " + candidate); + return candidate.toString(); + } + + private static boolean isWindows() { + return System.getProperty("os.name", "").toLowerCase().contains("win"); + } + + private static Map parseKeyValues(String output) { + Map map = new HashMap<>(); + for (String line : output.split("\\R")) { + int eq = line.indexOf('='); + if (eq > 0) { + map.put(line.substring(0, eq).trim(), line.substring(eq + 1).trim()); + } + } + return map; + } +} diff --git a/src/test/java/com/github/copilot/InternalExecutorProviderProbe.java b/src/test/java/com/github/copilot/InternalExecutorProviderProbe.java new file mode 100644 index 0000000000..85d12f14f1 --- /dev/null +++ b/src/test/java/com/github/copilot/InternalExecutorProviderProbe.java @@ -0,0 +1,74 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import java.lang.reflect.Method; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.Executor; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicBoolean; + +/** + * Diagnostic main launched as a separate JVM by + * {@code InternalExecutorProviderIT} to inspect the multi-release behaviour of + * {@link InternalExecutorProvider} against the actually packaged JAR. + *

+ * Lives in the same package as {@link InternalExecutorProvider} so it can use + * its package-private API directly, without reflection. + *

+ * Output format (key=value, one per line): + * + * 

+ *   feature=<JDK feature version>
+ *   canBeShutdown=<true|false>
+ *   virtual=<true|false>
+ *
+ */ +final class InternalExecutorProviderProbe { + + private InternalExecutorProviderProbe() { + } + + public static void main(String[] args) throws Exception { + InternalExecutorProvider provider = new InternalExecutorProvider(null); + Executor executor = provider.get(); + boolean canBeShutdown = provider.canBeShutdown(); + + AtomicBoolean virtual = new AtomicBoolean(); + CountDownLatch latch = new CountDownLatch(1); + executor.execute(() -> { + try { + virtual.set(isCurrentThreadVirtual()); + } finally { + latch.countDown(); + } + }); + + try { + if (!latch.await(5, TimeUnit.SECONDS)) { + System.out.println("error=task-timeout"); + System.exit(2); + } + } finally { + if (executor instanceof ExecutorService es) { + es.shutdownNow(); + } + } + + System.out.println("feature=" + Runtime.version().feature()); + System.out.println("canBeShutdown=" + canBeShutdown); + System.out.println("virtual=" + virtual.get()); + } + + private static boolean isCurrentThreadVirtual() { + try { + Method isVirtual = Thread.class.getMethod("isVirtual"); + return (Boolean) isVirtual.invoke(Thread.currentThread()); + } catch (ReflectiveOperationException e) { + return false; + } + } +} diff --git a/src/test/java/com/github/copilot/InternalExecutorProviderTest.java b/src/test/java/com/github/copilot/InternalExecutorProviderTest.java new file mode 100644 index 0000000000..f1d854cb53 --- /dev/null +++ b/src/test/java/com/github/copilot/InternalExecutorProviderTest.java @@ -0,0 +1,55 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertSame; + +import java.lang.reflect.Modifier; +import java.util.concurrent.Executor; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.ForkJoinPool; + +import org.junit.jupiter.api.Test; + +import com.github.copilot.rpc.CopilotClientOptions; + +class InternalExecutorProviderTest { + + @Test + void baseProviderReturnsCommonPool() { + Executor executor = new InternalExecutorProvider(null).get(); + + assertSame(ForkJoinPool.commonPool(), executor); + } + + @Test + void userProvidedExecutorIsNotOwned() { + Executor executor = ForkJoinPool.commonPool(); + + assertFalse(new InternalExecutorProvider(executor).canBeShutdown()); + } + + @Test + void providerIsPackagePrivate() { + assertFalse(Modifier.isPublic(InternalExecutorProvider.class.getModifiers())); + } + + @Test + void clientDoesNotShutDownUserProvidedExecutor() { + ExecutorService executor = Executors.newSingleThreadExecutor(); + try { + try (var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false).setExecutor(executor))) { + assertNotNull(client); + } + + assertFalse(executor.isShutdown()); + } finally { + executor.shutdownNow(); + } + } +} diff --git a/src/test/java/com/github/copilot/JsonIncludeNonNullTest.java b/src/test/java/com/github/copilot/JsonIncludeNonNullTest.java new file mode 100644 index 0000000000..7a9554b7b4 --- /dev/null +++ b/src/test/java/com/github/copilot/JsonIncludeNonNullTest.java @@ -0,0 +1,159 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +import org.junit.jupiter.api.Test; + +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.CustomAgentConfig; +import com.github.copilot.rpc.InfiniteSessionConfig; +import com.github.copilot.rpc.InputOptions; +import com.github.copilot.rpc.ModelCapabilitiesOverride; +import com.github.copilot.rpc.ProviderConfig; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionUiCapabilities; +import com.github.copilot.rpc.TelemetryConfig; +import com.github.copilot.rpc.UserInputRequest; + +/** + * Verifies that public DTO classes in the {@code com.github.copilot.rpc} + * package are annotated with {@code @JsonInclude(JsonInclude.Include.NON_NULL)} + * so that null-valued fields are omitted during JSON serialization. + */ +class JsonIncludeNonNullTest { + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + // --- Annotation presence checks --- + + @Test + void copilotClientOptionsHasNonNullAnnotation() { + assertHasNonNullInclude(CopilotClientOptions.class); + } + + @Test + void sessionConfigHasNonNullAnnotation() { + assertHasNonNullInclude(SessionConfig.class); + } + + @Test + void resumeSessionConfigHasNonNullAnnotation() { + assertHasNonNullInclude(ResumeSessionConfig.class); + } + + @Test + void infiniteSessionConfigHasNonNullAnnotation() { + assertHasNonNullInclude(InfiniteSessionConfig.class); + } + + @Test + void inputOptionsHasNonNullAnnotation() { + assertHasNonNullInclude(InputOptions.class); + } + + @Test + void modelCapabilitiesOverrideHasNonNullAnnotation() { + assertHasNonNullInclude(ModelCapabilitiesOverride.class); + } + + @Test + void providerConfigHasNonNullAnnotation() { + assertHasNonNullInclude(ProviderConfig.class); + } + + @Test + void telemetryConfigHasNonNullAnnotation() { + assertHasNonNullInclude(TelemetryConfig.class); + } + + @Test + void sessionUiCapabilitiesHasNonNullAnnotation() { + assertHasNonNullInclude(SessionUiCapabilities.class); + } + + @Test + void customAgentConfigHasNonNullAnnotation() { + assertHasNonNullInclude(CustomAgentConfig.class); + } + + @Test + void userInputRequestHasNonNullAnnotation() { + assertHasNonNullInclude(UserInputRequest.class); + } + + // --- Serialization tests: null fields are omitted --- + + @Test + void inputOptionsOmitsNullFieldsInJson() throws JsonProcessingException { + var opts = new InputOptions(); + String json = MAPPER.writeValueAsString(opts); + assertEquals("{}", json, "All-null InputOptions should serialize to empty JSON"); + } + + @Test + void telemetryConfigOmitsNullFieldsInJson() throws JsonProcessingException { + var config = new TelemetryConfig(); + String json = MAPPER.writeValueAsString(config); + assertEquals("{}", json, "All-null TelemetryConfig should serialize to empty JSON"); + } + + @Test + void sessionUiCapabilitiesOmitsNullFieldsInJson() throws JsonProcessingException { + var caps = new SessionUiCapabilities(); + String json = MAPPER.writeValueAsString(caps); + assertEquals("{}", json, "All-null SessionUiCapabilities should serialize to empty JSON"); + } + + @Test + void userInputRequestOmitsNullFieldsInJson() throws JsonProcessingException { + var req = new UserInputRequest(); + String json = MAPPER.writeValueAsString(req); + assertFalse(json.contains("null"), "UserInputRequest with no fields set should not contain 'null' values"); + } + + @Test + void inputOptionsIncludesSetFieldsInJson() throws JsonProcessingException { + var opts = new InputOptions(); + opts.setMinLength(5); + opts.setMaxLength(100); + String json = MAPPER.writeValueAsString(opts); + assertTrue(json.contains("\"minLength\":5"), "Set minLength should appear in JSON"); + assertTrue(json.contains("\"maxLength\":100"), "Set maxLength should appear in JSON"); + assertFalse(json.contains("\"title\""), "Unset title should be omitted from JSON"); + } + + @Test + void telemetryConfigIncludesSetFieldsInJson() throws JsonProcessingException { + var config = new TelemetryConfig(); + config.setOtlpEndpoint("http://localhost:4318"); + String json = MAPPER.writeValueAsString(config); + assertTrue(json.contains("\"otlpEndpoint\":\"http://localhost:4318\""), + "Set otlpEndpoint should appear in JSON"); + assertFalse(json.contains("\"filePath\""), "Unset filePath should be omitted from JSON"); + } + + @Test + void sessionUiCapabilitiesIncludesSetFieldsInJson() throws JsonProcessingException { + var caps = new SessionUiCapabilities(); + caps.setElicitation(true); + String json = MAPPER.writeValueAsString(caps); + assertTrue(json.contains("\"elicitation\":true"), "Set elicitation should appear in JSON"); + } + + private void assertHasNonNullInclude(Class clazz) { + JsonInclude annotation = clazz.getAnnotation(JsonInclude.class); + assertNotNull(annotation, clazz.getSimpleName() + " should be annotated with @JsonInclude"); + assertEquals(JsonInclude.Include.NON_NULL, annotation.value(), + clazz.getSimpleName() + " @JsonInclude should use Include.NON_NULL"); + } + +} diff --git a/src/test/java/com/github/copilot/sdk/JsonRpcClientTest.java b/src/test/java/com/github/copilot/JsonRpcClientTest.java similarity index 99% rename from src/test/java/com/github/copilot/sdk/JsonRpcClientTest.java rename to src/test/java/com/github/copilot/JsonRpcClientTest.java index 4fb43f4b62..3491ac8ab4 100644 --- a/src/test/java/com/github/copilot/sdk/JsonRpcClientTest.java +++ b/src/test/java/com/github/copilot/JsonRpcClientTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; diff --git a/src/test/java/com/github/copilot/sdk/LifecycleEventManagerTest.java b/src/test/java/com/github/copilot/LifecycleEventManagerTest.java similarity index 98% rename from src/test/java/com/github/copilot/sdk/LifecycleEventManagerTest.java rename to src/test/java/com/github/copilot/LifecycleEventManagerTest.java index 1500f2794f..6ec6fb5a32 100644 --- a/src/test/java/com/github/copilot/sdk/LifecycleEventManagerTest.java +++ b/src/test/java/com/github/copilot/LifecycleEventManagerTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -11,7 +11,7 @@ import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.SessionLifecycleEvent; +import com.github.copilot.rpc.SessionLifecycleEvent; /** * Unit tests for {@link LifecycleEventManager} covering subscribe, unsubscribe, diff --git a/src/test/java/com/github/copilot/sdk/McpAndAgentsTest.java b/src/test/java/com/github/copilot/McpAndAgentsTest.java similarity index 80% rename from src/test/java/com/github/copilot/sdk/McpAndAgentsTest.java rename to src/test/java/com/github/copilot/McpAndAgentsTest.java index a7d81646b3..f39e56eab3 100644 --- a/src/test/java/com/github/copilot/sdk/McpAndAgentsTest.java +++ b/src/test/java/com/github/copilot/McpAndAgentsTest.java @@ -2,10 +2,11 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; +import java.nio.file.Path; import java.util.HashMap; import java.util.List; import java.util.Map; @@ -16,16 +17,17 @@ import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.CustomAgentConfig; -import com.github.copilot.sdk.json.DefaultAgentConfig; -import com.github.copilot.sdk.json.McpServerConfig; -import com.github.copilot.sdk.json.McpStdioServerConfig; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.ToolDefinition; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.rpc.McpServerStatus; +import com.github.copilot.rpc.CustomAgentConfig; +import com.github.copilot.rpc.DefaultAgentConfig; +import com.github.copilot.rpc.McpServerConfig; +import com.github.copilot.rpc.McpStdioServerConfig; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.ToolDefinition; /** * Tests for MCP Servers and Custom Agents functionality. @@ -51,9 +53,33 @@ static void teardown() throws Exception { } } - // Helper method to create an MCP stdio server configuration - private McpStdioServerConfig createLocalMcpServer(String command, List args) { - return new McpStdioServerConfig().setCommand(command).setArgs(args).setTools(List.of("*")); + private Map createTestMcpServers(String... serverNames) { + Map servers = new HashMap<>(); + for (String serverName : serverNames) { + servers.put(serverName, createTestMcpServer()); + } + return servers; + } + + private McpStdioServerConfig createTestMcpServer() { + Path harnessDir = ctx.getRepoRoot().resolve("test").resolve("harness"); + return new McpStdioServerConfig().setCommand("node") + .setArgs(List.of(harnessDir.resolve("test-mcp-server.mjs").toString())) + .setWorkingDirectory(harnessDir.toString()).setTools(List.of("*")); + } + + private void waitForMcpServerStatus(CopilotSession session, String serverName, McpServerStatus expectedStatus) + throws Exception { + long deadline = System.nanoTime() + TimeUnit.SECONDS.toNanos(60); + while (System.nanoTime() < deadline) { + var result = session.getRpc().mcp.list().get(5, TimeUnit.SECONDS); + if (result.servers() != null && result.servers().stream() + .anyMatch(server -> serverName.equals(server.name()) && expectedStatus == server.status())) { + return; + } + Thread.sleep(200); + } + fail(serverName + " did not reach " + expectedStatus); } // ============ MCP Server Tests ============ @@ -68,8 +94,7 @@ private McpStdioServerConfig createLocalMcpServer(String command, List a void testShouldAcceptMcpServerConfigurationOnSessionCreate() throws Exception { ctx.configureForTest("mcp_and_agents", "should_accept_mcp_server_configuration_on_session_create"); - var mcpServers = new HashMap(); - mcpServers.put("test-server", createLocalMcpServer("echo", List.of("hello"))); + var mcpServers = createTestMcpServers("test-server"); try (CopilotClient client = ctx.createClient()) { CopilotSession session = client.createSession( @@ -77,6 +102,7 @@ void testShouldAcceptMcpServerConfigurationOnSessionCreate() throws Exception { .get(); assertNotNull(session.getSessionId()); + waitForMcpServerStatus(session, "test-server", McpServerStatus.CONNECTED); // Simple interaction to verify session works AssistantMessageEvent response = session.sendAndWait(new MessageOptions().setPrompt("What is 2+2?")).get(60, @@ -108,20 +134,13 @@ void testShouldAcceptMcpServerConfigurationOnSessionResume() throws Exception { session1.sendAndWait(new MessageOptions().setPrompt("What is 1+1?")).get(60, TimeUnit.SECONDS); // Resume with MCP servers - var mcpServers = new HashMap(); - mcpServers.put("test-server", createLocalMcpServer("echo", List.of("hello"))); + var mcpServers = createTestMcpServers("test-server"); CopilotSession session2 = client.resumeSession(sessionId, new ResumeSessionConfig() .setMcpServers(mcpServers).setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); assertEquals(sessionId, session2.getSessionId()); - - AssistantMessageEvent response = session2.sendAndWait(new MessageOptions().setPrompt("What is 3+3?")) - .get(60, TimeUnit.SECONDS); - - assertNotNull(response); - assertTrue(response.getData().content().contains("6"), - "Response should contain 6: " + response.getData().content()); + waitForMcpServerStatus(session2, "test-server", McpServerStatus.CONNECTED); session2.close(); } @@ -139,9 +158,36 @@ void testShouldHandleMultipleMcpServers() throws Exception { // count ctx.configureForTest("mcp_and_agents", "should_accept_mcp_server_configuration_on_session_create"); + var mcpServers = createTestMcpServers("server1", "server2"); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession( + new SessionConfig().setMcpServers(mcpServers).setOnPermissionRequest(PermissionHandler.APPROVE_ALL)) + .get(); + + assertNotNull(session.getSessionId()); + waitForMcpServerStatus(session, "server1", McpServerStatus.CONNECTED); + waitForMcpServerStatus(session, "server2", McpServerStatus.CONNECTED); + session.close(); + } + } + + // ============ Custom Agent Tests ============ + + /** + * Verifies that MCP server configuration is accepted without args. + * + * @see Snapshot: + * mcp_and_agents/should_accept_mcp_server_configuration_on_session_create + */ + @Test + void testAcceptMcpServerConfigWithoutArgs() throws Exception { + // Reuse existing snapshot - this test validates that args can be omitted + ctx.configureForTest("mcp_and_agents", "should_accept_mcp_server_configuration_on_session_create"); + var mcpServers = new HashMap(); - mcpServers.put("server1", createLocalMcpServer("echo", List.of("server1"))); - mcpServers.put("server2", createLocalMcpServer("echo", List.of("server2"))); + // Create MCP server config without specifying args + mcpServers.put("test-server", new McpStdioServerConfig().setCommand("echo").setTools(List.of("*"))); try (CopilotClient client = ctx.createClient()) { CopilotSession session = client.createSession( @@ -149,6 +195,14 @@ void testShouldHandleMultipleMcpServers() throws Exception { .get(); assertNotNull(session.getSessionId()); + + AssistantMessageEvent response = session.sendAndWait(new MessageOptions().setPrompt("What is 2+2?")).get(60, + TimeUnit.SECONDS); + + assertNotNull(response); + assertTrue(response.getData().content().contains("4"), + "Response should contain 4: " + response.getData().content()); + session.close(); } } @@ -261,8 +315,7 @@ void testShouldAcceptCustomAgentWithMcpServers() throws Exception { // Use combined snapshot since this uses both MCP servers and custom agents ctx.configureForTest("mcp_and_agents", "should_accept_both_mcp_servers_and_custom_agents"); - var agentMcpServers = new HashMap(); - agentMcpServers.put("agent-server", createLocalMcpServer("echo", List.of("agent-mcp"))); + var agentMcpServers = createTestMcpServers("agent-server"); List customAgents = List.of(new CustomAgentConfig().setName("mcp-agent") .setDisplayName("MCP Agent").setDescription("An agent with its own MCP servers") @@ -315,8 +368,7 @@ void testShouldAcceptMultipleCustomAgents() throws Exception { void testShouldAcceptBothMcpServersAndCustomAgents() throws Exception { ctx.configureForTest("mcp_and_agents", "should_accept_both_mcp_servers_and_custom_agents"); - var mcpServers = new HashMap(); - mcpServers.put("shared-server", createLocalMcpServer("echo", List.of("shared"))); + var mcpServers = createTestMcpServers("shared-server"); List customAgents = List.of(new CustomAgentConfig().setName("combined-agent") .setDisplayName("Combined Agent").setDescription("An agent using shared MCP servers") @@ -327,6 +379,7 @@ void testShouldAcceptBothMcpServersAndCustomAgents() throws Exception { .setCustomAgents(customAgents).setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); assertNotNull(session.getSessionId()); + waitForMcpServerStatus(session, "shared-server", McpServerStatus.CONNECTED); AssistantMessageEvent response = session.sendAndWait(new MessageOptions().setPrompt("What is 7+7?")).get(60, TimeUnit.SECONDS); diff --git a/src/test/java/com/github/copilot/sdk/MessageAttachmentTest.java b/src/test/java/com/github/copilot/MessageAttachmentTest.java similarity index 95% rename from src/test/java/com/github/copilot/sdk/MessageAttachmentTest.java rename to src/test/java/com/github/copilot/MessageAttachmentTest.java index 3150cecc2e..27e9f56cc3 100644 --- a/src/test/java/com/github/copilot/sdk/MessageAttachmentTest.java +++ b/src/test/java/com/github/copilot/MessageAttachmentTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -12,11 +12,11 @@ import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.json.Attachment; -import com.github.copilot.sdk.json.BlobAttachment; -import com.github.copilot.sdk.json.MessageAttachment; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.SendMessageRequest; +import com.github.copilot.rpc.Attachment; +import com.github.copilot.rpc.BlobAttachment; +import com.github.copilot.rpc.MessageAttachment; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.SendMessageRequest; /** * Tests for the {@link MessageAttachment} sealed interface and type-safe diff --git a/src/test/java/com/github/copilot/sdk/MetadataApiTest.java b/src/test/java/com/github/copilot/MetadataApiTest.java similarity index 98% rename from src/test/java/com/github/copilot/sdk/MetadataApiTest.java rename to src/test/java/com/github/copilot/MetadataApiTest.java index 3a9120a525..b2c775eb13 100644 --- a/src/test/java/com/github/copilot/sdk/MetadataApiTest.java +++ b/src/test/java/com/github/copilot/MetadataApiTest.java @@ -2,12 +2,12 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.ToolExecutionProgressEvent; -import com.github.copilot.sdk.json.*; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.ToolExecutionProgressEvent; +import com.github.copilot.rpc.*; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; diff --git a/src/test/java/com/github/copilot/ModeHandlersTest.java b/src/test/java/com/github/copilot/ModeHandlersTest.java new file mode 100644 index 0000000000..62202c903e --- /dev/null +++ b/src/test/java/com/github/copilot/ModeHandlersTest.java @@ -0,0 +1,151 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.github.copilot.generated.ExitPlanModeAction; +import com.github.copilot.generated.ExitPlanModeCompletedEvent; +import com.github.copilot.generated.ExitPlanModeRequestedEvent; +import com.github.copilot.rpc.AutoModeSwitchRequest; +import com.github.copilot.rpc.AutoModeSwitchResponse; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.ExitPlanModeRequest; +import com.github.copilot.rpc.ExitPlanModeResult; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; + +/** + * E2E tests for exit-plan-mode and auto-mode-switch handler APIs. + * + *

+ * Ported from {@code ModeHandlersE2ETests.cs} in the reference implementation + * dotnet SDK. + *

+ */ +public class ModeHandlersTest { + + private static final String TOKEN = "mode-handler-token"; + + private static E2ETestContext ctx; + + @BeforeAll + static void setup() throws Exception { + ctx = E2ETestContext.create(); + } + + @AfterAll + static void teardown() throws Exception { + if (ctx != null) { + ctx.close(); + } + } + + private CopilotClient createAuthenticatedClient() { + Map env = new HashMap<>(ctx.getEnvironment()); + env.put("COPILOT_DEBUG_GITHUB_API_URL", ctx.getProxyUrl()); + + return ctx.createClient(new CopilotClientOptions().setEnvironment(env)); + } + + private void configureAuthenticatedUser(String testName) throws Exception { + ctx.configureForTest("mode_handlers", testName); + ctx.setCopilotUserByToken(TOKEN, "mode-handler-user", "individual_pro", ctx.getProxyUrl(), + "https://localhost:1/telemetry", "mode-handler-tracking-id"); + } + + @Test + void shouldInvokeExitPlanModeHandlerWhenModelUsesTool() throws Exception { + final String summary = "Greeting file implementation plan"; + configureAuthenticatedUser("should_invoke_exit_plan_mode_handler_when_model_uses_tool"); + + var handlerCalled = new CompletableFuture(); + + try (var client = createAuthenticatedClient()) { + var session = client.createSession(new SessionConfig().setGitHubToken(TOKEN) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL).setOnExitPlanMode((request, invocation) -> { + handlerCalled.complete(request); + return CompletableFuture.completedFuture(new ExitPlanModeResult().setApproved(true) + .setSelectedAction("interactive").setFeedback("Approved by the Java E2E test")); + })).get(30, TimeUnit.SECONDS); + + var requestedEvent = new CompletableFuture(); + var completedEvent = new CompletableFuture(); + + session.on(event -> { + if (event instanceof ExitPlanModeRequestedEvent requested + && summary.equals(requested.getData().summary())) { + requestedEvent.complete(requested); + } else if (event instanceof ExitPlanModeCompletedEvent completed + && Boolean.TRUE.equals(completed.getData().approved()) + && ExitPlanModeAction.INTERACTIVE == completed.getData().selectedAction()) { + completedEvent.complete(completed); + } + }); + + var response = session.sendAndWait(new MessageOptions().setPrompt( + "Create a brief implementation plan for adding a greeting.txt file, then request approval with exit_plan_mode.") + .setMode("plan")).get(120, TimeUnit.SECONDS); + + var request = handlerCalled.get(10, TimeUnit.SECONDS); + assertEquals(summary, request.getSummary()); + assertNotNull(request.getActions()); + assertTrue(request.getActions().contains("interactive")); + assertNotNull(request.getPlanContent()); + + var reqEvent = requestedEvent.get(10, TimeUnit.SECONDS); + assertEquals(request.getSummary(), reqEvent.getData().summary()); + + var compEvent = completedEvent.get(10, TimeUnit.SECONDS); + assertTrue(compEvent.getData().approved()); + assertEquals(ExitPlanModeAction.INTERACTIVE, compEvent.getData().selectedAction()); + + assertNotNull(response); + + session.close(); + } + } + + @Test + void shouldInvokeAutoModeSwitchHandlerWhenRateLimited() throws Exception { + configureAuthenticatedUser("should_invoke_auto_mode_switch_handler_when_rate_limited"); + + var handlerCalled = new CompletableFuture(); + + try (var client = createAuthenticatedClient()) { + var session = client.createSession( + new SessionConfig().setGitHubToken(TOKEN).setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + .setOnAutoModeSwitch((request, invocation) -> { + handlerCalled.complete(request); + return CompletableFuture.completedFuture(AutoModeSwitchResponse.YES); + })) + .get(30, TimeUnit.SECONDS); + + var messageId = session + .send(new MessageOptions() + .setPrompt("Explain that auto mode recovered from a rate limit in one short sentence.")) + .get(30, TimeUnit.SECONDS); + + assertNotNull(messageId); + assertFalse(messageId.isEmpty()); + + var request = handlerCalled.get(30, TimeUnit.SECONDS); + assertEquals("user_weekly_rate_limited", request.getErrorCode()); + assertEquals(1.0, request.getRetryAfterSeconds()); + + session.close(); + } + } +} diff --git a/src/test/java/com/github/copilot/sdk/ModelInfoTest.java b/src/test/java/com/github/copilot/ModelInfoTest.java similarity index 91% rename from src/test/java/com/github/copilot/sdk/ModelInfoTest.java rename to src/test/java/com/github/copilot/ModelInfoTest.java index f36d0c4bd7..b4936d1cca 100644 --- a/src/test/java/com/github/copilot/sdk/ModelInfoTest.java +++ b/src/test/java/com/github/copilot/ModelInfoTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -10,9 +10,9 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.ModelInfo; -import com.github.copilot.sdk.json.ModelSupports; -import com.github.copilot.sdk.json.SessionMetadata; +import com.github.copilot.rpc.ModelInfo; +import com.github.copilot.rpc.ModelSupports; +import com.github.copilot.rpc.SessionMetadata; /** * Unit tests for {@link ModelInfo}, {@link ModelSupports}, and diff --git a/src/test/java/com/github/copilot/ModuleDescriptorTest.java b/src/test/java/com/github/copilot/ModuleDescriptorTest.java new file mode 100644 index 0000000000..f7c16bb233 --- /dev/null +++ b/src/test/java/com/github/copilot/ModuleDescriptorTest.java @@ -0,0 +1,27 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.lang.module.ModuleDescriptor; +import org.junit.jupiter.api.Test; + +class ModuleDescriptorTest { + + @Test + void sdkHasExplicitModuleDescriptor() { + Module module = CopilotClient.class.getModule(); + assertTrue(module.isNamed()); + assertEquals("com.github.copilot.java", module.getName()); + + ModuleDescriptor descriptor = module.getDescriptor(); + assertTrue(descriptor.exports().stream().anyMatch(export -> export.source().equals("com.github.copilot"))); + assertTrue(descriptor.exports().stream().anyMatch(export -> export.source().equals("com.github.copilot.rpc"))); + assertTrue(descriptor.requires().stream() + .anyMatch(require -> require.name().equals("com.fasterxml.jackson.databind"))); + } +} diff --git a/src/test/java/com/github/copilot/OptionalApiAndJacksonTest.java b/src/test/java/com/github/copilot/OptionalApiAndJacksonTest.java new file mode 100644 index 0000000000..1db593dbe2 --- /dev/null +++ b/src/test/java/com/github/copilot/OptionalApiAndJacksonTest.java @@ -0,0 +1,635 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.CustomAgentConfig; +import com.github.copilot.rpc.InfiniteSessionConfig; +import com.github.copilot.rpc.InputOptions; +import com.github.copilot.rpc.ModelCapabilitiesOverride; +import com.github.copilot.rpc.ProviderConfig; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionUiCapabilities; +import com.github.copilot.rpc.TelemetryConfig; +import com.github.copilot.rpc.UserInputRequest; +import org.junit.jupiter.api.Test; + +/** + * Validates that every {@code clearXxx()} method resets its field to absent, + * that Optional-returning getters report the correct state, and that Jackson + * omits cleared fields from serialized output. + */ +class OptionalApiAndJacksonTest { + + private static final ObjectMapper MAPPER = JsonRpcClient.getObjectMapper(); + + // ── CopilotClientOptions ────────────────────────────────────────── + + @Test + void copilotClientOptions_clearSessionIdleTimeoutSeconds() { + var opts = new CopilotClientOptions(); + opts.setSessionIdleTimeoutSeconds(120); + assertFalse(opts.getSessionIdleTimeoutSeconds().isEmpty()); + + opts.clearSessionIdleTimeoutSeconds(); + assertTrue(opts.getSessionIdleTimeoutSeconds().isEmpty()); + } + + @Test + void copilotClientOptions_clearUseLoggedInUser() { + var opts = new CopilotClientOptions(); + opts.setUseLoggedInUser(true); + assertTrue(opts.getUseLoggedInUser().isPresent()); + + opts.clearUseLoggedInUser(); + assertTrue(opts.getUseLoggedInUser().isEmpty()); + } + + // ── SessionConfig ───────────────────────────────────────────────── + + @Test + void sessionConfig_clearEnableSessionTelemetry() { + var cfg = new SessionConfig(); + cfg.setEnableSessionTelemetry(true); + assertTrue(cfg.getEnableSessionTelemetry().isPresent()); + + cfg.clearEnableSessionTelemetry(); + assertTrue(cfg.getEnableSessionTelemetry().isEmpty()); + } + + @Test + void sessionConfig_clearEnableConfigDiscovery() { + var cfg = new SessionConfig(); + cfg.setEnableConfigDiscovery(false); + assertTrue(cfg.getEnableConfigDiscovery().isPresent()); + + cfg.clearEnableConfigDiscovery(); + assertTrue(cfg.getEnableConfigDiscovery().isEmpty()); + } + + @Test + void sessionConfig_clearIncludeSubAgentStreamingEvents() { + var cfg = new SessionConfig(); + cfg.setIncludeSubAgentStreamingEvents(true); + assertTrue(cfg.getIncludeSubAgentStreamingEvents().isPresent()); + + cfg.clearIncludeSubAgentStreamingEvents(); + assertTrue(cfg.getIncludeSubAgentStreamingEvents().isEmpty()); + } + + // ── ResumeSessionConfig ─────────────────────────────────────────── + + @Test + void resumeSessionConfig_clearEnableSessionTelemetry() { + var cfg = new ResumeSessionConfig(); + cfg.setEnableSessionTelemetry(false); + assertTrue(cfg.getEnableSessionTelemetry().isPresent()); + + cfg.clearEnableSessionTelemetry(); + assertTrue(cfg.getEnableSessionTelemetry().isEmpty()); + } + + @Test + void resumeSessionConfig_clearEnableConfigDiscovery() { + var cfg = new ResumeSessionConfig(); + cfg.setEnableConfigDiscovery(true); + assertTrue(cfg.getEnableConfigDiscovery().isPresent()); + + cfg.clearEnableConfigDiscovery(); + assertTrue(cfg.getEnableConfigDiscovery().isEmpty()); + } + + @Test + void resumeSessionConfig_clearIncludeSubAgentStreamingEvents() { + var cfg = new ResumeSessionConfig(); + cfg.setIncludeSubAgentStreamingEvents(false); + assertTrue(cfg.getIncludeSubAgentStreamingEvents().isPresent()); + + cfg.clearIncludeSubAgentStreamingEvents(); + assertTrue(cfg.getIncludeSubAgentStreamingEvents().isEmpty()); + } + + // ── InfiniteSessionConfig ───────────────────────────────────────── + + @Test + void infiniteSessionConfig_clearEnabled() { + var cfg = new InfiniteSessionConfig(); + cfg.setEnabled(true); + assertTrue(cfg.getEnabled().isPresent()); + + cfg.clearEnabled(); + assertTrue(cfg.getEnabled().isEmpty()); + } + + @Test + void infiniteSessionConfig_clearBackgroundCompactionThreshold() { + var cfg = new InfiniteSessionConfig(); + cfg.setBackgroundCompactionThreshold(0.75); + assertFalse(cfg.getBackgroundCompactionThreshold().isEmpty()); + + cfg.clearBackgroundCompactionThreshold(); + assertTrue(cfg.getBackgroundCompactionThreshold().isEmpty()); + } + + @Test + void infiniteSessionConfig_clearBufferExhaustionThreshold() { + var cfg = new InfiniteSessionConfig(); + cfg.setBufferExhaustionThreshold(0.9); + assertFalse(cfg.getBufferExhaustionThreshold().isEmpty()); + + cfg.clearBufferExhaustionThreshold(); + assertTrue(cfg.getBufferExhaustionThreshold().isEmpty()); + } + + // ── InputOptions ────────────────────────────────────────────────── + + @Test + void inputOptions_clearMinLength() { + var opts = new InputOptions(); + opts.setMinLength(5); + assertFalse(opts.getMinLength().isEmpty()); + + opts.clearMinLength(); + assertTrue(opts.getMinLength().isEmpty()); + } + + @Test + void inputOptions_clearMaxLength() { + var opts = new InputOptions(); + opts.setMaxLength(100); + assertFalse(opts.getMaxLength().isEmpty()); + + opts.clearMaxLength(); + assertTrue(opts.getMaxLength().isEmpty()); + } + + // ── ModelCapabilitiesOverride.Supports ───────────────────────────── + + @Test + void supports_clearVision() { + var s = new ModelCapabilitiesOverride.Supports(); + s.setVision(true); + assertTrue(s.getVision().isPresent()); + + s.clearVision(); + assertTrue(s.getVision().isEmpty()); + } + + @Test + void supports_clearReasoningEffort() { + var s = new ModelCapabilitiesOverride.Supports(); + s.setReasoningEffort(false); + assertTrue(s.getReasoningEffort().isPresent()); + + s.clearReasoningEffort(); + assertTrue(s.getReasoningEffort().isEmpty()); + } + + // ── ModelCapabilitiesOverride.Limits ─────────────────────────────── + + @Test + void limits_clearMaxPromptTokens() { + var l = new ModelCapabilitiesOverride.Limits(); + l.setMaxPromptTokens(4096); + assertFalse(l.getMaxPromptTokens().isEmpty()); + + l.clearMaxPromptTokens(); + assertTrue(l.getMaxPromptTokens().isEmpty()); + } + + @Test + void limits_clearMaxOutputTokens() { + var l = new ModelCapabilitiesOverride.Limits(); + l.setMaxOutputTokens(1024); + assertFalse(l.getMaxOutputTokens().isEmpty()); + + l.clearMaxOutputTokens(); + assertTrue(l.getMaxOutputTokens().isEmpty()); + } + + @Test + void limits_clearMaxContextWindowTokens() { + var l = new ModelCapabilitiesOverride.Limits(); + l.setMaxContextWindowTokens(16384); + assertFalse(l.getMaxContextWindowTokens().isEmpty()); + + l.clearMaxContextWindowTokens(); + assertTrue(l.getMaxContextWindowTokens().isEmpty()); + } + + // ── ProviderConfig ──────────────────────────────────────────────── + + @Test + void providerConfig_clearMaxPromptTokens() { + var cfg = new ProviderConfig(); + cfg.setMaxPromptTokens(2048); + assertFalse(cfg.getMaxPromptTokens().isEmpty()); + + cfg.clearMaxPromptTokens(); + assertTrue(cfg.getMaxPromptTokens().isEmpty()); + } + + @Test + void providerConfig_clearMaxOutputTokens() { + var cfg = new ProviderConfig(); + cfg.setMaxOutputTokens(512); + assertFalse(cfg.getMaxOutputTokens().isEmpty()); + + cfg.clearMaxOutputTokens(); + assertTrue(cfg.getMaxOutputTokens().isEmpty()); + } + + // ── TelemetryConfig ─────────────────────────────────────────────── + + @Test + void telemetryConfig_clearCaptureContent() { + var cfg = new TelemetryConfig(); + cfg.setCaptureContent(true); + assertTrue(cfg.getCaptureContent().isPresent()); + + cfg.clearCaptureContent(); + assertTrue(cfg.getCaptureContent().isEmpty()); + } + + // ── SessionUiCapabilities ───────────────────────────────────────── + + @Test + void sessionUiCapabilities_clearElicitation() { + var caps = new SessionUiCapabilities(); + caps.setElicitation(true); + assertTrue(caps.getElicitation().isPresent()); + + caps.clearElicitation(); + assertTrue(caps.getElicitation().isEmpty()); + } + + // ── CustomAgentConfig ───────────────────────────────────────────── + + @Test + void customAgentConfig_clearInfer() { + var cfg = new CustomAgentConfig(); + cfg.setInfer(true); + assertTrue(cfg.getInfer().isPresent()); + + cfg.clearInfer(); + assertTrue(cfg.getInfer().isEmpty()); + } + + // ── UserInputRequest ────────────────────────────────────────────── + + @Test + void userInputRequest_clearAllowFreeform() { + var req = new UserInputRequest(); + req.setAllowFreeform(false); + assertTrue(req.getAllowFreeform().isPresent()); + + req.clearAllowFreeform(); + assertTrue(req.getAllowFreeform().isEmpty()); + } + + // ── Value retrieval through Optional getters ──────────────────────── + + @Test + void copilotClientOptions_sessionIdleTimeoutSecondsValue() { + var opts = new CopilotClientOptions(); + assertTrue(opts.getSessionIdleTimeoutSeconds().isEmpty()); + + opts.setSessionIdleTimeoutSeconds(300); + assertEquals(300, opts.getSessionIdleTimeoutSeconds().getAsInt()); + + opts.setSessionIdleTimeoutSeconds(0); + assertTrue(opts.getSessionIdleTimeoutSeconds().isPresent()); + assertEquals(0, opts.getSessionIdleTimeoutSeconds().getAsInt()); + } + + @Test + void copilotClientOptions_useLoggedInUserValue() { + var opts = new CopilotClientOptions(); + assertTrue(opts.getUseLoggedInUser().isEmpty()); + + opts.setUseLoggedInUser(true); + assertEquals(Boolean.TRUE, opts.getUseLoggedInUser().get()); + + opts.setUseLoggedInUser(false); + assertEquals(Boolean.FALSE, opts.getUseLoggedInUser().get()); + } + + @Test + void sessionConfig_enableSessionTelemetryValue() { + var cfg = new SessionConfig(); + assertFalse(cfg.getEnableSessionTelemetry().orElse(false)); + + cfg.setEnableSessionTelemetry(true); + assertTrue(cfg.getEnableSessionTelemetry().orElse(false)); + + cfg.setEnableSessionTelemetry(false); + assertFalse(cfg.getEnableSessionTelemetry().orElse(true)); + } + + @Test + void sessionConfig_enableConfigDiscoveryValue() { + var cfg = new SessionConfig(); + assertTrue(cfg.getEnableConfigDiscovery().isEmpty()); + + cfg.setEnableConfigDiscovery(true); + assertTrue(cfg.getEnableConfigDiscovery().get()); + + cfg.setEnableConfigDiscovery(false); + assertFalse(cfg.getEnableConfigDiscovery().get()); + } + + @Test + void sessionConfig_includeSubAgentStreamingEventsValue() { + var cfg = new SessionConfig(); + assertTrue(cfg.getIncludeSubAgentStreamingEvents().isEmpty()); + + cfg.setIncludeSubAgentStreamingEvents(true); + assertTrue(cfg.getIncludeSubAgentStreamingEvents().get()); + } + + @Test + void resumeSessionConfig_enableSessionTelemetryValue() { + var cfg = new ResumeSessionConfig(); + assertTrue(cfg.getEnableSessionTelemetry().isEmpty()); + + cfg.setEnableSessionTelemetry(true); + assertTrue(cfg.getEnableSessionTelemetry().get()); + + cfg.setEnableSessionTelemetry(false); + assertFalse(cfg.getEnableSessionTelemetry().get()); + } + + @Test + void resumeSessionConfig_enableConfigDiscoveryValue() { + var cfg = new ResumeSessionConfig(); + assertTrue(cfg.getEnableConfigDiscovery().isEmpty()); + + cfg.setEnableConfigDiscovery(true); + assertTrue(cfg.getEnableConfigDiscovery().get()); + } + + @Test + void resumeSessionConfig_includeSubAgentStreamingEventsValue() { + var cfg = new ResumeSessionConfig(); + assertTrue(cfg.getIncludeSubAgentStreamingEvents().isEmpty()); + + cfg.setIncludeSubAgentStreamingEvents(false); + assertFalse(cfg.getIncludeSubAgentStreamingEvents().get()); + } + + @Test + void infiniteSessionConfig_thresholdValues() { + var cfg = new InfiniteSessionConfig(); + assertTrue(cfg.getBackgroundCompactionThreshold().isEmpty()); + assertTrue(cfg.getBufferExhaustionThreshold().isEmpty()); + + cfg.setBackgroundCompactionThreshold(0.6); + cfg.setBufferExhaustionThreshold(0.85); + assertEquals(0.6, cfg.getBackgroundCompactionThreshold().getAsDouble(), 0.001); + assertEquals(0.85, cfg.getBufferExhaustionThreshold().getAsDouble(), 0.001); + } + + @Test + void infiniteSessionConfig_enabledValue() { + var cfg = new InfiniteSessionConfig(); + assertTrue(cfg.getEnabled().isEmpty()); + + cfg.setEnabled(true); + assertTrue(cfg.getEnabled().get()); + + cfg.setEnabled(false); + assertFalse(cfg.getEnabled().get()); + } + + @Test + void inputOptions_minAndMaxLengthValues() { + var opts = new InputOptions(); + assertTrue(opts.getMinLength().isEmpty()); + assertTrue(opts.getMaxLength().isEmpty()); + + opts.setMinLength(1); + opts.setMaxLength(255); + assertEquals(1, opts.getMinLength().getAsInt()); + assertEquals(255, opts.getMaxLength().getAsInt()); + } + + @Test + void supports_visionAndReasoningEffortValues() { + var s = new ModelCapabilitiesOverride.Supports(); + assertTrue(s.getVision().isEmpty()); + assertTrue(s.getReasoningEffort().isEmpty()); + + s.setVision(true); + s.setReasoningEffort(false); + assertTrue(s.getVision().get()); + assertFalse(s.getReasoningEffort().get()); + } + + @Test + void limits_tokenValues() { + var l = new ModelCapabilitiesOverride.Limits(); + assertTrue(l.getMaxPromptTokens().isEmpty()); + assertTrue(l.getMaxOutputTokens().isEmpty()); + assertTrue(l.getMaxContextWindowTokens().isEmpty()); + + l.setMaxPromptTokens(4096); + l.setMaxOutputTokens(1024); + l.setMaxContextWindowTokens(16384); + assertEquals(4096, l.getMaxPromptTokens().getAsInt()); + assertEquals(1024, l.getMaxOutputTokens().getAsInt()); + assertEquals(16384, l.getMaxContextWindowTokens().getAsInt()); + } + + @Test + void providerConfig_tokenValues() { + var cfg = new ProviderConfig(); + assertTrue(cfg.getMaxPromptTokens().isEmpty()); + assertTrue(cfg.getMaxOutputTokens().isEmpty()); + + cfg.setMaxPromptTokens(8192); + cfg.setMaxOutputTokens(2048); + assertEquals(8192, cfg.getMaxPromptTokens().getAsInt()); + assertEquals(2048, cfg.getMaxOutputTokens().getAsInt()); + } + + @Test + void telemetryConfig_captureContentValue() { + var cfg = new TelemetryConfig(); + assertTrue(cfg.getCaptureContent().isEmpty()); + + cfg.setCaptureContent(true); + assertTrue(cfg.getCaptureContent().get()); + + cfg.setCaptureContent(false); + assertFalse(cfg.getCaptureContent().get()); + } + + @Test + void sessionUiCapabilities_elicitationValue() { + var caps = new SessionUiCapabilities(); + assertTrue(caps.getElicitation().isEmpty()); + assertFalse(caps.getElicitation().orElse(false)); + + caps.setElicitation(true); + assertTrue(caps.getElicitation().orElse(false)); + } + + @Test + void customAgentConfig_inferValue() { + var cfg = new CustomAgentConfig(); + assertTrue(cfg.getInfer().isEmpty()); + + cfg.setInfer(true); + assertTrue(cfg.getInfer().get()); + + cfg.setInfer(false); + assertFalse(cfg.getInfer().get()); + } + + @Test + void userInputRequest_allowFreeformValue() { + var req = new UserInputRequest(); + assertTrue(req.getAllowFreeform().isEmpty()); + + req.setAllowFreeform(true); + assertTrue(req.getAllowFreeform().get()); + + req.setAllowFreeform(false); + assertFalse(req.getAllowFreeform().get()); + } + + // ── JSON deserialization into Optional-returning classes ─────────── + + @Test + void jackson_deserializeSupportsWithFields() throws Exception { + String json = "{\"vision\":true,\"reasoningEffort\":false}"; + var supports = MAPPER.readValue(json, ModelCapabilitiesOverride.Supports.class); + assertTrue(supports.getVision().get()); + assertFalse(supports.getReasoningEffort().get()); + } + + @Test + void jackson_deserializeSupportsEmpty() throws Exception { + String json = "{}"; + var supports = MAPPER.readValue(json, ModelCapabilitiesOverride.Supports.class); + assertTrue(supports.getVision().isEmpty()); + assertTrue(supports.getReasoningEffort().isEmpty()); + } + + @Test + void jackson_deserializeLimitsWithFields() throws Exception { + String json = "{\"max_prompt_tokens\":4096,\"max_output_tokens\":1024,\"max_context_window_tokens\":16384}"; + var limits = MAPPER.readValue(json, ModelCapabilitiesOverride.Limits.class); + assertEquals(4096, limits.getMaxPromptTokens().getAsInt()); + assertEquals(1024, limits.getMaxOutputTokens().getAsInt()); + assertEquals(16384, limits.getMaxContextWindowTokens().getAsInt()); + } + + @Test + void jackson_deserializeLimitsEmpty() throws Exception { + String json = "{}"; + var limits = MAPPER.readValue(json, ModelCapabilitiesOverride.Limits.class); + assertTrue(limits.getMaxPromptTokens().isEmpty()); + assertTrue(limits.getMaxOutputTokens().isEmpty()); + assertTrue(limits.getMaxContextWindowTokens().isEmpty()); + } + + @Test + void jackson_deserializeInfiniteSessionConfigWithFields() throws Exception { + String json = "{\"enabled\":true,\"backgroundCompactionThreshold\":0.7,\"bufferExhaustionThreshold\":0.9}"; + var cfg = MAPPER.readValue(json, InfiniteSessionConfig.class); + assertTrue(cfg.getEnabled().get()); + assertEquals(0.7, cfg.getBackgroundCompactionThreshold().getAsDouble(), 0.001); + assertEquals(0.9, cfg.getBufferExhaustionThreshold().getAsDouble(), 0.001); + } + + @Test + void jackson_deserializeInfiniteSessionConfigEmpty() throws Exception { + String json = "{}"; + var cfg = MAPPER.readValue(json, InfiniteSessionConfig.class); + assertTrue(cfg.getEnabled().isEmpty()); + assertTrue(cfg.getBackgroundCompactionThreshold().isEmpty()); + assertTrue(cfg.getBufferExhaustionThreshold().isEmpty()); + } + + // ── Jackson serialization roundtrip ─────────────────────────────── + // + // Classes whose fields carry @JsonProperty (InfiniteSessionConfig, + // ModelCapabilitiesOverride inner classes) are serialized via field + // access: Jackson writes the field when set and omits it when cleared. + // + // Classes without @JsonProperty on fields (SessionConfig, + // CopilotClientOptions, TelemetryConfig, ProviderConfig) are not + // directly serialized β€” their values are copied to wire DTOs by + // SessionRequestBuilder. The @JsonIgnore on their Optional-returning + // getters prevents Jackson from attempting to serialize Optional + // wrappers if the class is ever processed. + + @Test + void jackson_infiniteSessionConfigClearedFieldsOmitted() throws Exception { + var cfg = new InfiniteSessionConfig(); + cfg.setEnabled(true); + cfg.setBackgroundCompactionThreshold(0.75); + cfg.setBufferExhaustionThreshold(0.9); + + String withFields = MAPPER.writeValueAsString(cfg); + assertTrue(withFields.contains("enabled")); + assertTrue(withFields.contains("backgroundCompactionThreshold")); + assertTrue(withFields.contains("bufferExhaustionThreshold")); + + cfg.clearEnabled(); + cfg.clearBackgroundCompactionThreshold(); + cfg.clearBufferExhaustionThreshold(); + + String cleared = MAPPER.writeValueAsString(cfg); + assertFalse(cleared.contains("enabled")); + assertFalse(cleared.contains("backgroundCompactionThreshold")); + assertFalse(cleared.contains("bufferExhaustionThreshold")); + } + + @Test + void jackson_modelCapabilitiesOverrideSupportsClearedFieldsOmitted() throws Exception { + var supports = new ModelCapabilitiesOverride.Supports(); + supports.setVision(true); + supports.setReasoningEffort(false); + + String withFields = MAPPER.writeValueAsString(supports); + assertTrue(withFields.contains("vision")); + assertTrue(withFields.contains("reasoningEffort")); + + supports.clearVision(); + supports.clearReasoningEffort(); + + String cleared = MAPPER.writeValueAsString(supports); + assertFalse(cleared.contains("vision")); + assertFalse(cleared.contains("reasoningEffort")); + } + + @Test + void jackson_modelCapabilitiesOverrideLimitsClearedFieldsOmitted() throws Exception { + var limits = new ModelCapabilitiesOverride.Limits(); + limits.setMaxPromptTokens(2048); + limits.setMaxOutputTokens(512); + limits.setMaxContextWindowTokens(16384); + + String withFields = MAPPER.writeValueAsString(limits); + assertTrue(withFields.contains("max_prompt_tokens")); + assertTrue(withFields.contains("max_output_tokens")); + assertTrue(withFields.contains("max_context_window_tokens")); + + limits.clearMaxPromptTokens(); + limits.clearMaxOutputTokens(); + limits.clearMaxContextWindowTokens(); + + String cleared = MAPPER.writeValueAsString(limits); + assertFalse(cleared.contains("max_prompt_tokens")); + assertFalse(cleared.contains("max_output_tokens")); + assertFalse(cleared.contains("max_context_window_tokens")); + } +} diff --git a/src/test/java/com/github/copilot/sdk/PerSessionAuthTest.java b/src/test/java/com/github/copilot/PerSessionAuthTest.java similarity index 95% rename from src/test/java/com/github/copilot/sdk/PerSessionAuthTest.java rename to src/test/java/com/github/copilot/PerSessionAuthTest.java index dd5de81b83..000d36e4ba 100644 --- a/src/test/java/com/github/copilot/sdk/PerSessionAuthTest.java +++ b/src/test/java/com/github/copilot/PerSessionAuthTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -13,10 +13,10 @@ import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.rpc.SessionAuthGetStatusResult; -import com.github.copilot.sdk.json.CopilotClientOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.generated.rpc.SessionAuthGetStatusResult; +import com.github.copilot.rpc.CopilotClientOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; /** * Tests for per-session GitHub authentication. diff --git a/src/test/java/com/github/copilot/sdk/PermissionRequestResultKindTest.java b/src/test/java/com/github/copilot/PermissionRequestResultKindTest.java similarity index 96% rename from src/test/java/com/github/copilot/sdk/PermissionRequestResultKindTest.java rename to src/test/java/com/github/copilot/PermissionRequestResultKindTest.java index ab81966dc9..0bd08f47d7 100644 --- a/src/test/java/com/github/copilot/sdk/PermissionRequestResultKindTest.java +++ b/src/test/java/com/github/copilot/PermissionRequestResultKindTest.java @@ -2,15 +2,15 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; import org.junit.jupiter.api.Test; import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PermissionRequestResultKind; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PermissionRequestResultKind; /** * Unit tests for {@link PermissionRequestResultKind}. diff --git a/src/test/java/com/github/copilot/PermissionRequestResultTest.java b/src/test/java/com/github/copilot/PermissionRequestResultTest.java new file mode 100644 index 0000000000..4a1ff03137 --- /dev/null +++ b/src/test/java/com/github/copilot/PermissionRequestResultTest.java @@ -0,0 +1,73 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import org.junit.jupiter.api.Test; + +import com.github.copilot.rpc.PermissionRequestResult; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.json.JsonMapper; +import com.fasterxml.jackson.annotation.JsonInclude; + +/** + * Tests for {@link PermissionRequestResult} factory methods and feedback field. + */ +public class PermissionRequestResultTest { + + private static final ObjectMapper MAPPER = JsonMapper.builder().serializationInclusion(JsonInclude.Include.NON_NULL) + .build(); + + @Test + void testApproveOnce() { + var result = PermissionRequestResult.approveOnce(); + assertEquals("approve-once", result.getKind()); + assertNull(result.getFeedback()); + } + + @Test + void testRejectWithFeedback() { + var result = PermissionRequestResult.reject("Not allowed"); + assertEquals("reject", result.getKind()); + assertEquals("Not allowed", result.getFeedback()); + } + + @Test + void testRejectWithoutFeedback() { + var result = PermissionRequestResult.reject(null); + assertEquals("reject", result.getKind()); + assertNull(result.getFeedback()); + } + + @Test + void testUserNotAvailable() { + var result = PermissionRequestResult.userNotAvailable(); + assertEquals("user-not-available", result.getKind()); + assertNull(result.getFeedback()); + } + + @Test + void testNoResult() { + var result = PermissionRequestResult.noResult(); + assertEquals("no-result", result.getKind()); + assertNull(result.getFeedback()); + } + + @Test + void testFeedbackSerialized() throws Exception { + var result = PermissionRequestResult.reject("Unsafe operation"); + var json = MAPPER.writeValueAsString(result); + assertTrue(json.contains("\"feedback\":\"Unsafe operation\"")); + assertTrue(json.contains("\"kind\":\"reject\"")); + } + + @Test + void testFeedbackNotSerializedWhenNull() throws Exception { + var result = PermissionRequestResult.approveOnce(); + var json = MAPPER.writeValueAsString(result); + assertFalse(json.contains("feedback")); + } +} diff --git a/src/test/java/com/github/copilot/sdk/PermissionsTest.java b/src/test/java/com/github/copilot/PermissionsTest.java similarity index 73% rename from src/test/java/com/github/copilot/sdk/PermissionsTest.java rename to src/test/java/com/github/copilot/PermissionsTest.java index b498c1ce76..6f10f353c2 100644 --- a/src/test/java/com/github/copilot/sdk/PermissionsTest.java +++ b/src/test/java/com/github/copilot/PermissionsTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -17,15 +17,15 @@ import org.junit.jupiter.api.Test; import org.junit.jupiter.api.TestInfo; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.ToolExecutionCompleteEvent; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.PermissionRequest; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PermissionRequestResultKind; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.MessageOptions; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.ToolExecutionCompleteEvent; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.PermissionRequest; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PermissionRequestResultKind; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.MessageOptions; /** * Tests for permission callback functionality. @@ -363,4 +363,115 @@ void testShouldDenyToolOperationsWhenHandlerExplicitlyDeniesAfterResume(TestInfo session2.close(); } } + + /** + * Verifies that a permission handler returning {@code noResult} is handled + * correctly β€” the handler is called, and the session can be aborted afterward. + * + * @see Snapshot: permissions/should_deny_permission_with_noresult_kind + */ + @Test + void testShouldDenyPermissionWithNoResultKind() throws Exception { + ctx.configureForTest("permissions", "should_deny_permission_with_noresult_kind"); + + var permissionCalled = new CompletableFuture(); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client + .createSession(new SessionConfig().setOnPermissionRequest((request, invocation) -> { + permissionCalled.complete(true); + return CompletableFuture.completedFuture( + new PermissionRequestResult().setKind(PermissionRequestResultKind.NO_RESULT)); + })).get(); + + session.send(new MessageOptions().setPrompt("Run 'node --version'")); + + assertTrue(permissionCalled.get(30, TimeUnit.SECONDS), + "Expected the no-result permission handler to be called."); + + session.abort().get(10, TimeUnit.SECONDS); + session.close(); + } + } + + /** + * Verifies that the runtime short-circuits the permission handler when + * {@code session.permissions.setApproveAll(true)} has been called. + * + * @see Snapshot: + * permissions/should_short_circuit_permission_handler_when_set_approve_all_enabled + */ + @Test + void testShouldShortCircuitPermissionHandlerWhenSetApproveAllEnabled() throws Exception { + ctx.configureForTest("permissions", "should_short_circuit_permission_handler_when_set_approve_all_enabled"); + + var handlerCallCount = new int[]{0}; + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client + .createSession(new SessionConfig().setOnPermissionRequest((request, invocation) -> { + handlerCallCount[0]++; + return CompletableFuture.completedFuture( + new PermissionRequestResult().setKind(PermissionRequestResultKind.APPROVED)); + })).get(); + + // Set approve-all so the runtime short-circuits + var setResult = session.getRpc().permissions + .setApproveAll(new com.github.copilot.generated.rpc.SessionPermissionsSetApproveAllParams( + session.getSessionId(), true, null)) + .get(10, TimeUnit.SECONDS); + assertTrue(setResult.success(), "setApproveAll should succeed"); + + AssistantMessageEvent response = session + .sendAndWait(new MessageOptions().setPrompt("Run 'echo test' and tell me what happens")) + .get(60, TimeUnit.SECONDS); + assertNotNull(response); + + // Handler should not have been called since runtime approves all + assertEquals(0, handlerCallCount[0], + "Permission handler should not be called when setApproveAll is enabled"); + + session.close(); + } + } + + /** + * Verifies that the SDK correctly waits for a slow permission handler before + * completing tool execution. + * + * @see Snapshot: permissions/should_wait_for_slow_permission_handler + */ + @Test + void testShouldWaitForSlowPermissionHandler() throws Exception { + ctx.configureForTest("permissions", "should_wait_for_slow_permission_handler"); + + var handlerEntered = new CompletableFuture(); + var releaseHandler = new CompletableFuture(); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client + .createSession(new SessionConfig().setOnPermissionRequest((request, invocation) -> { + handlerEntered.complete(null); + return releaseHandler.thenApply( + v -> new PermissionRequestResult().setKind(PermissionRequestResultKind.APPROVED)); + })).get(); + + // Capture the sendAndWait future before awaiting it so we can interact with the + // handler + CompletableFuture responseFuture = session + .sendAndWait(new MessageOptions().setPrompt("Run 'echo slow_handler_test'")); + + // Wait for permission handler to be entered + handlerEntered.get(30, TimeUnit.SECONDS); + + // Release the handler + releaseHandler.complete(null); + + // Session should complete successfully + AssistantMessageEvent message = responseFuture.get(60, TimeUnit.SECONDS); + assertNotNull(message); + + session.close(); + } + } } diff --git a/src/test/java/com/github/copilot/PreMcpToolCallHookTest.java b/src/test/java/com/github/copilot/PreMcpToolCallHookTest.java new file mode 100644 index 0000000000..5da0d2002f --- /dev/null +++ b/src/test/java/com/github/copilot/PreMcpToolCallHookTest.java @@ -0,0 +1,177 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Disabled; +import org.junit.jupiter.api.Test; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.McpServerConfig; +import com.github.copilot.rpc.McpStdioServerConfig; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.PreMcpToolCallHookInput; +import com.github.copilot.rpc.PreMcpToolCallHookOutput; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionHooks; + +/** + * Tests for preMcpToolCall hook functionality. + * + *

+ * These tests use the shared CapiProxy infrastructure for deterministic API + * response replay. Snapshots are stored in + * test/snapshots/pre_mcp_tool_call_hook/. + *

+ */ +public class PreMcpToolCallHookTest { + + private static final ObjectMapper MAPPER = JsonRpcClient.getObjectMapper(); + private static E2ETestContext ctx; + + @BeforeAll + static void setup() throws Exception { + ctx = E2ETestContext.create(); + } + + @AfterAll + static void teardown() throws Exception { + if (ctx != null) { + ctx.close(); + } + } + + /** + * Verifies that preMcpToolCall hook can set metadata on the MCP request. + * + * @see Snapshot: pre_mcp_tool_call_hook/should_set_meta_via_premcptoolcall_hook + */ + @Disabled("Requires snapshot: pre_mcp_tool_call_hook/should_set_meta_via_premcptoolcall_hook") + @Test + void testShouldSetMetaViaPreMcpToolCallHook() throws Exception { + ctx.configureForTest("pre_mcp_tool_call_hook", "should_set_meta_via_premcptoolcall_hook"); + + var hookInputs = new java.util.ArrayList(); + + var mcpServers = new HashMap(); + mcpServers.put("meta-echo", new McpStdioServerConfig().setCommand("npx").setArgs(List.of("-y", "mcp-meta-echo")) + .setTools(List.of("*")).setWorkingDirectory(ctx.getWorkDir().toString())); + + var hooks = new SessionHooks().setOnPreMcpToolCall((input, invocation) -> { + hookInputs.add(input); + JsonNode metaNode = MAPPER.valueToTree(Map.of("injected", "by-hook", "source", "test")); + return CompletableFuture.completedFuture(PreMcpToolCallHookOutput.withMeta(metaNode)); + }); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig().setMcpServers(mcpServers).setHooks(hooks) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + AssistantMessageEvent response = session.sendAndWait(new MessageOptions().setPrompt( + "Use the meta-echo/echo_meta tool with value 'test-set'. Reply with just the raw tool result.")) + .get(60, TimeUnit.SECONDS); + + assertNotNull(response); + assertFalse(hookInputs.isEmpty(), "Should have received preMcpToolCall hook calls"); + + // Verify hook input fields + PreMcpToolCallHookInput hookInput = hookInputs.get(0); + assertEquals("meta-echo", hookInput.getServerName()); + assertNotNull(hookInput.getToolName()); + assertNotNull(hookInput.getCwd()); + assertTrue(hookInput.getTimestamp() > 0); + + // Verify the response contains the injected metadata + String content = response.getData().content(); + assertTrue(content.contains("by-hook"), "Response should contain injected metadata: " + content); + + session.close(); + } + } + + /** + * Verifies that preMcpToolCall hook can replace existing metadata. + * + * @see Snapshot: + * pre_mcp_tool_call_hook/should_replace_meta_via_premcptoolcall_hook + */ + @Disabled("Requires snapshot: pre_mcp_tool_call_hook/should_replace_meta_via_premcptoolcall_hook") + @Test + void testShouldReplaceMetaViaPreMcpToolCallHook() throws Exception { + ctx.configureForTest("pre_mcp_tool_call_hook", "should_replace_meta_via_premcptoolcall_hook"); + + var mcpServers = new HashMap(); + mcpServers.put("meta-echo", new McpStdioServerConfig().setCommand("npx").setArgs(List.of("-y", "mcp-meta-echo")) + .setTools(List.of("*")).setWorkingDirectory(ctx.getWorkDir().toString())); + + var hooks = new SessionHooks().setOnPreMcpToolCall((input, invocation) -> { + JsonNode metaNode = MAPPER.valueToTree(Map.of("replaced", "true", "original", "gone")); + return CompletableFuture.completedFuture(PreMcpToolCallHookOutput.withMeta(metaNode)); + }); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig().setMcpServers(mcpServers).setHooks(hooks) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + AssistantMessageEvent response = session.sendAndWait(new MessageOptions().setPrompt( + "Use the meta-echo/echo_meta tool with value 'test-replace'. Reply with just the raw tool result.")) + .get(60, TimeUnit.SECONDS); + + assertNotNull(response); + + // Verify the response contains the replaced metadata + String content = response.getData().content(); + assertTrue(content.contains("replaced"), "Response should contain replaced metadata: " + content); + + session.close(); + } + } + + /** + * Verifies that preMcpToolCall hook can remove metadata from the MCP request. + * + * @see Snapshot: + * pre_mcp_tool_call_hook/should_remove_meta_via_premcptoolcall_hook + */ + @Disabled("Requires snapshot: pre_mcp_tool_call_hook/should_remove_meta_via_premcptoolcall_hook") + @Test + void testShouldRemoveMetaViaPreMcpToolCallHook() throws Exception { + ctx.configureForTest("pre_mcp_tool_call_hook", "should_remove_meta_via_premcptoolcall_hook"); + + var mcpServers = new HashMap(); + mcpServers.put("meta-echo", new McpStdioServerConfig().setCommand("npx").setArgs(List.of("-y", "mcp-meta-echo")) + .setTools(List.of("*")).setWorkingDirectory(ctx.getWorkDir().toString())); + + var hooks = new SessionHooks().setOnPreMcpToolCall((input, invocation) -> { + // Return output with null metaToUse to remove metadata + return CompletableFuture.completedFuture(PreMcpToolCallHookOutput.removeMeta()); + }); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig().setMcpServers(mcpServers).setHooks(hooks) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + AssistantMessageEvent response = session.sendAndWait(new MessageOptions().setPrompt( + "Use the meta-echo/echo_meta tool with value 'test-remove'. Reply with just the raw tool result.")) + .get(60, TimeUnit.SECONDS); + + assertNotNull(response); + + session.close(); + } + } +} diff --git a/src/test/java/com/github/copilot/sdk/ProviderConfigTest.java b/src/test/java/com/github/copilot/ProviderConfigTest.java similarity index 86% rename from src/test/java/com/github/copilot/sdk/ProviderConfigTest.java rename to src/test/java/com/github/copilot/ProviderConfigTest.java index d3e18010bc..5c40230ecc 100644 --- a/src/test/java/com/github/copilot/sdk/ProviderConfigTest.java +++ b/src/test/java/com/github/copilot/ProviderConfigTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.assertEquals; import static org.junit.jupiter.api.Assertions.assertNotNull; @@ -14,10 +14,10 @@ import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.json.AzureOptions; -import com.github.copilot.sdk.json.ProviderConfig; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.rpc.AzureOptions; +import com.github.copilot.rpc.ProviderConfig; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; /** * Tests for {@link ProviderConfig} and {@link AzureOptions} BYOK (Bring Your @@ -386,4 +386,52 @@ void testResumeSessionConfigWithoutProviderOmitsField() throws Exception { assertTrue(json.path("provider").isMissingNode(), "provider field should be omitted when null"); } + + // ========================================================================= + // Provider model and token limit overrides + // ========================================================================= + + @Test + void testProviderModelIdAndWireModelSerialization() throws Exception { + var provider = new ProviderConfig().setBaseUrl("https://example.com/provider") + .setHeaders(java.util.Map.of("Authorization", "Bearer provider-token")).setModelId("gpt-4o") + .setWireModel("my-finetune-v3").setMaxPromptTokens(100_000).setMaxOutputTokens(4096); + + JsonNode json = MAPPER.valueToTree(provider); + + assertEquals("https://example.com/provider", json.get("baseUrl").asText()); + assertEquals("Bearer provider-token", json.get("headers").get("Authorization").asText()); + assertEquals("gpt-4o", json.get("modelId").asText()); + assertEquals("my-finetune-v3", json.get("wireModel").asText()); + assertEquals(100_000, json.get("maxPromptTokens").asInt()); + assertEquals(4096, json.get("maxOutputTokens").asInt()); + + // Round-trip + ProviderConfig deserialized = MAPPER.readValue(MAPPER.writeValueAsString(provider), ProviderConfig.class); + assertEquals("gpt-4o", deserialized.getModelId()); + assertEquals("my-finetune-v3", deserialized.getWireModel()); + assertEquals(100_000, deserialized.getMaxPromptTokens().getAsInt()); + assertEquals(4096, deserialized.getMaxOutputTokens().getAsInt()); + } + + @Test + void testProviderModelFieldsDefaultToNull() { + var provider = new ProviderConfig(); + assertNull(provider.getModelId()); + assertNull(provider.getWireModel()); + assertTrue(provider.getMaxPromptTokens().isEmpty()); + assertTrue(provider.getMaxOutputTokens().isEmpty()); + } + + @Test + void testProviderModelFieldsOmittedWhenNull() throws Exception { + var provider = new ProviderConfig().setType("openai"); + + JsonNode json = MAPPER.valueToTree(provider); + + assertTrue(json.path("modelId").isMissingNode()); + assertTrue(json.path("wireModel").isMissingNode()); + assertTrue(json.path("maxPromptTokens").isMissingNode()); + assertTrue(json.path("maxOutputTokens").isMissingNode()); + } } diff --git a/src/test/java/com/github/copilot/RemoteSessionTest.java b/src/test/java/com/github/copilot/RemoteSessionTest.java new file mode 100644 index 0000000000..67c5f5bb6a --- /dev/null +++ b/src/test/java/com/github/copilot/RemoteSessionTest.java @@ -0,0 +1,399 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.ValueSource; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.github.copilot.rpc.CreateSessionRequest; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.ResumeSessionRequest; +import com.github.copilot.rpc.SessionConfig; + +/** + * Tests for the {@code remoteSession} feature across all session config types. + *

+ * Validates the complete lifecycle of the remote session mode: + *

    + *
  • Getter/setter and fluent chaining on {@link SessionConfig} and + * {@link ResumeSessionConfig}
    • + *
  • Propagation through {@link SessionRequestBuilder} into + * {@link CreateSessionRequest} and {@link ResumeSessionRequest}
    • + *
  • JSON wire-format serialization: correct key, correct value, omission when + * unset
    • + *
  • Defensive copy via {@code copy()} preserves the value
    • + *
  • All three supported mode values ("off", "export", "on") are transmitted + * correctly
    • + *
+ */ +class RemoteSessionTest { + + private static final ObjectMapper MAPPER = JsonRpcClient.getObjectMapper(); + + // ========================================================================= + // SessionConfig getter/setter/copy + // ========================================================================= + + @Test + void sessionConfig_remoteSessionDefaultsToNull() { + var cfg = new SessionConfig(); + assertNull(cfg.getRemoteSession(), "remoteSession should be null when not set"); + } + + @ParameterizedTest + @ValueSource(strings = {"off", "export", "on"}) + void sessionConfig_setRemoteSessionReturnsSelf(String mode) { + var cfg = new SessionConfig(); + SessionConfig result = cfg.setRemoteSession(mode); + assertSame(cfg, result, "setRemoteSession should return the same instance for chaining"); + assertEquals(mode, cfg.getRemoteSession()); + } + + @Test + void sessionConfig_copyPreservesRemoteSession() { + var original = new SessionConfig().setRemoteSession("export"); + var copy = original.clone(); + assertEquals("export", copy.getRemoteSession()); + } + + @Test + void sessionConfig_copyPreservesNullRemoteSession() { + var original = new SessionConfig(); + var copy = original.clone(); + assertNull(copy.getRemoteSession()); + } + + @Test + void sessionConfig_setRemoteSessionToNullClearsValue() { + var cfg = new SessionConfig().setRemoteSession("on"); + cfg.setRemoteSession(null); + assertNull(cfg.getRemoteSession()); + } + + // ========================================================================= + // ResumeSessionConfig getter/setter/copy + // ========================================================================= + + @Test + void resumeSessionConfig_remoteSessionDefaultsToNull() { + var cfg = new ResumeSessionConfig(); + assertNull(cfg.getRemoteSession(), "remoteSession should be null when not set"); + } + + @ParameterizedTest + @ValueSource(strings = {"off", "export", "on"}) + void resumeSessionConfig_setRemoteSessionReturnsSelf(String mode) { + var cfg = new ResumeSessionConfig(); + ResumeSessionConfig result = cfg.setRemoteSession(mode); + assertSame(cfg, result, "setRemoteSession should return the same instance for chaining"); + assertEquals(mode, cfg.getRemoteSession()); + } + + @Test + void resumeSessionConfig_copyPreservesRemoteSession() { + var original = new ResumeSessionConfig().setRemoteSession("on"); + var copy = original.clone(); + assertEquals("on", copy.getRemoteSession()); + } + + // ========================================================================= + // SessionRequestBuilder – CreateSessionRequest wiring + // ========================================================================= + + @ParameterizedTest + @ValueSource(strings = {"off", "export", "on"}) + void buildCreateRequest_propagatesRemoteSession(String mode) { + var config = new SessionConfig().setRemoteSession(mode); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + assertEquals(mode, request.getRemoteSession()); + } + + @Test + void buildCreateRequest_nullConfig_remoteSessionIsNull() { + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(null); + assertNull(request.getRemoteSession()); + } + + @Test + void buildCreateRequest_unsetRemoteSession_isNull() { + var config = new SessionConfig(); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + assertNull(request.getRemoteSession()); + } + + // ========================================================================= + // SessionRequestBuilder – ResumeSessionRequest wiring + // ========================================================================= + + @ParameterizedTest + @ValueSource(strings = {"off", "export", "on"}) + void buildResumeRequest_propagatesRemoteSession(String mode) { + var config = new ResumeSessionConfig().setRemoteSession(mode); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", config); + assertEquals(mode, request.getRemoteSession()); + } + + @Test + void buildResumeRequest_nullConfig_remoteSessionIsNull() { + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", null); + assertNull(request.getRemoteSession()); + } + + @Test + void buildResumeRequest_unsetRemoteSession_isNull() { + var config = new ResumeSessionConfig(); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", config); + assertNull(request.getRemoteSession()); + } + + // ========================================================================= + // JSON wire-format: CreateSessionRequest + // ========================================================================= + + @ParameterizedTest + @ValueSource(strings = {"off", "export", "on"}) + void createRequest_serializesRemoteSessionCorrectly(String mode) throws Exception { + var config = new SessionConfig().setRemoteSession(mode); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + String json = MAPPER.writeValueAsString(request); + JsonNode tree = MAPPER.readTree(json); + + assertTrue(tree.has("remoteSession"), "Serialized JSON should contain 'remoteSession' field for mode: " + mode); + assertEquals(mode, tree.get("remoteSession").asText()); + } + + @Test + void createRequest_omitsRemoteSessionWhenNull() throws Exception { + var config = new SessionConfig(); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + String json = MAPPER.writeValueAsString(request); + JsonNode tree = MAPPER.readTree(json); + + assertFalse(tree.has("remoteSession"), "Serialized JSON should omit 'remoteSession' when not set"); + } + + // ========================================================================= + // JSON wire-format: ResumeSessionRequest + // ========================================================================= + + @ParameterizedTest + @ValueSource(strings = {"off", "export", "on"}) + void resumeRequest_serializesRemoteSessionCorrectly(String mode) throws Exception { + var config = new ResumeSessionConfig().setRemoteSession(mode); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", config); + + String json = MAPPER.writeValueAsString(request); + JsonNode tree = MAPPER.readTree(json); + + assertTrue(tree.has("remoteSession"), "Serialized JSON should contain 'remoteSession' field for mode: " + mode); + assertEquals(mode, tree.get("remoteSession").asText()); + } + + @Test + void resumeRequest_omitsRemoteSessionWhenNull() throws Exception { + var config = new ResumeSessionConfig(); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", config); + + String json = MAPPER.writeValueAsString(request); + JsonNode tree = MAPPER.readTree(json); + + assertFalse(tree.has("remoteSession"), "Serialized JSON should omit 'remoteSession' when not set"); + } + + // ========================================================================= + // JSON round-trip: CreateSessionRequest + // ========================================================================= + + @ParameterizedTest + @ValueSource(strings = {"off", "export", "on"}) + void createRequest_roundTripsRemoteSession(String mode) throws Exception { + var config = new SessionConfig().setRemoteSession(mode); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + String json = MAPPER.writeValueAsString(request); + CreateSessionRequest deserialized = MAPPER.readValue(json, CreateSessionRequest.class); + assertEquals(mode, deserialized.getRemoteSession()); + } + + @Test + void createRequest_roundTripsNullRemoteSession() throws Exception { + var config = new SessionConfig(); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + String json = MAPPER.writeValueAsString(request); + CreateSessionRequest deserialized = MAPPER.readValue(json, CreateSessionRequest.class); + assertNull(deserialized.getRemoteSession()); + } + + // ========================================================================= + // JSON round-trip: ResumeSessionRequest + // ========================================================================= + + @ParameterizedTest + @ValueSource(strings = {"off", "export", "on"}) + void resumeRequest_roundTripsRemoteSession(String mode) throws Exception { + var config = new ResumeSessionConfig().setRemoteSession(mode); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", config); + + String json = MAPPER.writeValueAsString(request); + ResumeSessionRequest deserialized = MAPPER.readValue(json, ResumeSessionRequest.class); + assertEquals(mode, deserialized.getRemoteSession()); + } + + // ========================================================================= + // Fluent chaining: remoteSession composes with other config options + // ========================================================================= + + @Test + void sessionConfig_remoteSessionComposesWithOtherFields() { + var config = new SessionConfig().setModel("gpt-4o").setRemoteSession("export").setReasoningEffort("high"); + + assertEquals("gpt-4o", config.getModel()); + assertEquals("export", config.getRemoteSession()); + assertEquals("high", config.getReasoningEffort()); + } + + @Test + void resumeSessionConfig_remoteSessionComposesWithOtherFields() { + var config = new ResumeSessionConfig().setModel("gpt-4o").setRemoteSession("on").setReasoningEffort("medium"); + + assertEquals("gpt-4o", config.getModel()); + assertEquals("on", config.getRemoteSession()); + assertEquals("medium", config.getReasoningEffort()); + } + + @Test + void createRequest_remoteSessionDoesNotAffectOtherFields() throws Exception { + var config = new SessionConfig().setModel("gpt-4o").setRemoteSession("export").setReasoningEffort("high") + .setGitHubToken("ghp_test"); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + String json = MAPPER.writeValueAsString(request); + JsonNode tree = MAPPER.readTree(json); + + assertEquals("export", tree.get("remoteSession").asText()); + assertEquals("gpt-4o", tree.get("model").asText()); + assertEquals("high", tree.get("reasoningEffort").asText()); + assertEquals("ghp_test", tree.get("gitHubToken").asText()); + } + + @Test + void resumeRequest_remoteSessionDoesNotAffectOtherFields() throws Exception { + var config = new ResumeSessionConfig().setModel("gpt-4o").setRemoteSession("on").setReasoningEffort("medium") + .setGitHubToken("ghp_test"); + + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", config); + String json = MAPPER.writeValueAsString(request); + JsonNode tree = MAPPER.readTree(json); + + assertEquals("on", tree.get("remoteSession").asText()); + assertEquals("gpt-4o", tree.get("model").asText()); + assertEquals("medium", tree.get("reasoningEffort").asText()); + assertEquals("ghp_test", tree.get("gitHubToken").asText()); + } + + // ========================================================================= + // Deserialization from raw JSON (simulates CLI response ingestion) + // ========================================================================= + + @Test + void createRequest_deserializesRemoteSessionFromRawJson() throws Exception { + String json = """ + { + "sessionId": "test-session", + "remoteSession": "export", + "model": "gpt-4o" + } + """; + CreateSessionRequest request = MAPPER.readValue(json, CreateSessionRequest.class); + assertEquals("export", request.getRemoteSession()); + assertEquals("test-session", request.getSessionId()); + } + + @Test + void resumeRequest_deserializesRemoteSessionFromRawJson() throws Exception { + String json = """ + { + "sessionId": "resume-session", + "remoteSession": "on", + "model": "gpt-4o" + } + """; + ResumeSessionRequest request = MAPPER.readValue(json, ResumeSessionRequest.class); + assertEquals("on", request.getRemoteSession()); + assertEquals("resume-session", request.getSessionId()); + } + + @Test + void createRequest_deserializesWithMissingRemoteSession() throws Exception { + String json = """ + { + "sessionId": "test-session", + "model": "gpt-4o" + } + """; + CreateSessionRequest request = MAPPER.readValue(json, CreateSessionRequest.class); + assertNull(request.getRemoteSession()); + } + + // ========================================================================= + // Handoff event with remoteSessionId (remote session lifecycle) + // ========================================================================= + + @Test + void handoffEvent_withRemoteSourceType_containsRemoteSessionId() throws Exception { + String json = """ + { + "type": "session.handoff", + "data": { + "handoffTime": "2025-06-01T12:00:00Z", + "sourceType": "remote", + "remoteSessionId": "remote-sess-42", + "summary": "Session exported for remote execution", + "repository": { + "owner": "test-org", + "name": "test-repo", + "branch": "feature-branch" + } + } + } + """; + + var event = (com.github.copilot.generated.SessionHandoffEvent) MAPPER.readValue(json, + com.github.copilot.generated.SessionEvent.class); + assertNotNull(event); + var data = event.getData(); + assertEquals("remote-sess-42", data.remoteSessionId()); + assertEquals(com.github.copilot.generated.HandoffSourceType.REMOTE, data.sourceType()); + assertEquals("Session exported for remote execution", data.summary()); + assertEquals("test-org", data.repository().owner()); + assertEquals("test-repo", data.repository().name()); + assertEquals("feature-branch", data.repository().branch()); + } + + @Test + void handoffEvent_withoutRemoteSessionId_fieldIsNull() throws Exception { + String json = """ + { + "type": "session.handoff", + "data": { + "targetAgent": "local-agent" + } + } + """; + + var event = (com.github.copilot.generated.SessionHandoffEvent) MAPPER.readValue(json, + com.github.copilot.generated.SessionEvent.class); + assertNotNull(event); + assertNull(event.getData().remoteSessionId()); + } +} diff --git a/src/test/java/com/github/copilot/sdk/RpcHandlerDispatcherTest.java b/src/test/java/com/github/copilot/RpcHandlerDispatcherTest.java similarity index 97% rename from src/test/java/com/github/copilot/sdk/RpcHandlerDispatcherTest.java rename to src/test/java/com/github/copilot/RpcHandlerDispatcherTest.java index 7453a7b266..76c2d41b29 100644 --- a/src/test/java/com/github/copilot/sdk/RpcHandlerDispatcherTest.java +++ b/src/test/java/com/github/copilot/RpcHandlerDispatcherTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -24,14 +24,14 @@ import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.node.ObjectNode; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PermissionRequestResultKind; -import com.github.copilot.sdk.json.PreToolUseHookOutput; -import com.github.copilot.sdk.json.SessionHooks; -import com.github.copilot.sdk.json.SessionLifecycleEvent; -import com.github.copilot.sdk.json.ToolDefinition; -import com.github.copilot.sdk.json.ToolResultObject; -import com.github.copilot.sdk.json.UserInputResponse; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PermissionRequestResultKind; +import com.github.copilot.rpc.PreToolUseHookOutput; +import com.github.copilot.rpc.SessionHooks; +import com.github.copilot.rpc.SessionLifecycleEvent; +import com.github.copilot.rpc.ToolDefinition; +import com.github.copilot.rpc.ToolResultObject; +import com.github.copilot.rpc.UserInputResponse; /** * Unit tests for {@link RpcHandlerDispatcher} focusing on coverage gaps diff --git a/src/test/java/com/github/copilot/sdk/RpcWrappersTest.java b/src/test/java/com/github/copilot/RpcWrappersTest.java similarity index 96% rename from src/test/java/com/github/copilot/sdk/RpcWrappersTest.java rename to src/test/java/com/github/copilot/RpcWrappersTest.java index 519f9ebd43..7b01e1d386 100644 --- a/src/test/java/com/github/copilot/sdk/RpcWrappersTest.java +++ b/src/test/java/com/github/copilot/RpcWrappersTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -15,13 +15,13 @@ import org.junit.jupiter.api.Test; import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.generated.rpc.McpConfigAddParams; -import com.github.copilot.sdk.generated.rpc.McpDiscoverParams; -import com.github.copilot.sdk.generated.rpc.RpcCaller; -import com.github.copilot.sdk.generated.rpc.ServerRpc; -import com.github.copilot.sdk.generated.rpc.SessionAgentSelectParams; -import com.github.copilot.sdk.generated.rpc.SessionModelSwitchToParams; -import com.github.copilot.sdk.generated.rpc.SessionRpc; +import com.github.copilot.generated.rpc.McpConfigAddParams; +import com.github.copilot.generated.rpc.McpDiscoverParams; +import com.github.copilot.generated.rpc.RpcCaller; +import com.github.copilot.generated.rpc.ServerRpc; +import com.github.copilot.generated.rpc.SessionAgentSelectParams; +import com.github.copilot.generated.rpc.SessionModelSwitchToParams; +import com.github.copilot.generated.rpc.SessionRpc; /** * Unit tests for the generated RPC wrapper classes ({@link ServerRpc} and @@ -90,7 +90,7 @@ void serverRpc_ping_passes_params_directly() { var stub = new StubCaller(); var server = new ServerRpc(stub); - var params = new com.github.copilot.sdk.generated.rpc.PingParams(null); + var params = new com.github.copilot.generated.rpc.PingParams(null); server.ping(params); assertEquals(1, stub.calls.size()); @@ -183,7 +183,7 @@ void sessionRpc_model_switchTo_merges_sessionId_with_extra_params() { var session = new SessionRpc(stub, "sess-xyz"); // switchTo takes extra params beyond sessionId - var switchParams = new SessionModelSwitchToParams(null, "gpt-5", null, null); + var switchParams = new SessionModelSwitchToParams(null, "gpt-5", null, null, null); session.model.switchTo(switchParams); assertEquals(1, stub.calls.size()); diff --git a/src/test/java/com/github/copilot/sdk/SchedulerShutdownRaceTest.java b/src/test/java/com/github/copilot/SchedulerShutdownRaceTest.java similarity index 97% rename from src/test/java/com/github/copilot/sdk/SchedulerShutdownRaceTest.java rename to src/test/java/com/github/copilot/SchedulerShutdownRaceTest.java index e60e4aa345..48a58bbc90 100644 --- a/src/test/java/com/github/copilot/sdk/SchedulerShutdownRaceTest.java +++ b/src/test/java/com/github/copilot/SchedulerShutdownRaceTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; import static org.mockito.ArgumentMatchers.*; @@ -16,7 +16,7 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.MessageOptions; +import com.github.copilot.rpc.MessageOptions; /** * Regression coverage for the race between {@code sendAndWait()} and diff --git a/src/test/java/com/github/copilot/SessionConfigE2ETest.java b/src/test/java/com/github/copilot/SessionConfigE2ETest.java new file mode 100644 index 0000000000..dbae0fe9f9 --- /dev/null +++ b/src/test/java/com/github/copilot/SessionConfigE2ETest.java @@ -0,0 +1,174 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.ProviderConfig; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; + +/** + * E2E tests for session configuration features. + */ +public class SessionConfigE2ETest { + + private static E2ETestContext ctx; + + @BeforeAll + static void setup() throws Exception { + ctx = E2ETestContext.create(); + } + + @AfterAll + static void teardown() throws Exception { + if (ctx != null) { + ctx.close(); + } + } + + @Test + void testShouldApplyInstructionDirectoriesOnCreate() throws Exception { + ctx.configureForTest("session_config", "should_apply_instructiondirectories_on_create"); + + // Set up instruction directory with a custom instruction file + Path projectDir = ctx.getWorkDir().resolve("instruction-create-project"); + Path instructionDir = ctx.getWorkDir().resolve("extra-create-instructions"); + Path instructionFilesDir = instructionDir.resolve(".github").resolve("instructions"); + String sentinel = "JAVA_CREATE_INSTRUCTION_DIRECTORIES_SENTINEL"; + Files.createDirectories(projectDir); + Files.createDirectories(instructionFilesDir); + Files.writeString(instructionFilesDir.resolve("extra.instructions.md"), "Always include " + sentinel + "."); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig().setWorkingDirectory(projectDir.toString()) + .setInstructionDirectories(List.of(instructionDir.toString())) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + session.sendAndWait(new MessageOptions().setPrompt("What is 1+1?")).get(60, TimeUnit.SECONDS); + + List> exchanges = ctx.getExchanges(); + assertFalse(exchanges.isEmpty(), "Should have at least one exchange"); + String systemMessage = getSystemMessage(exchanges.get(0)); + assertNotNull(systemMessage, "System message should not be null"); + assertTrue(systemMessage.contains(sentinel), + "System message should contain the instruction sentinel: " + sentinel); + } + } + + @Test + void testShouldApplyInstructionDirectoriesOnResume() throws Exception { + ctx.configureForTest("session_config", "should_apply_instructiondirectories_on_resume"); + + // Set up instruction directory with a custom instruction file + Path projectDir = ctx.getWorkDir().resolve("instruction-resume-project"); + Path instructionDir = ctx.getWorkDir().resolve("extra-resume-instructions"); + Path instructionFilesDir = instructionDir.resolve(".github").resolve("instructions"); + String sentinel = "JAVA_RESUME_INSTRUCTION_DIRECTORIES_SENTINEL"; + Files.createDirectories(projectDir); + Files.createDirectories(instructionFilesDir); + Files.writeString(instructionFilesDir.resolve("extra.instructions.md"), "Always include " + sentinel + "."); + + try (CopilotClient client = ctx.createClient()) { + // Create a session first + CopilotSession session1 = client.createSession(new SessionConfig() + .setWorkingDirectory(projectDir.toString()).setOnPermissionRequest(PermissionHandler.APPROVE_ALL)) + .get(); + + // Resume with instructionDirectories + CopilotSession session2 = client.resumeSession(session1.getSessionId(), + new ResumeSessionConfig().setWorkingDirectory(projectDir.toString()) + .setInstructionDirectories(List.of(instructionDir.toString())) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)) + .get(); + + session2.sendAndWait(new MessageOptions().setPrompt("What is 1+1?")).get(60, TimeUnit.SECONDS); + + List> exchanges = ctx.getExchanges(); + assertFalse(exchanges.isEmpty(), "Should have at least one exchange"); + String systemMessage = getSystemMessage(exchanges.get(0)); + assertNotNull(systemMessage, "System message should not be null"); + assertTrue(systemMessage.contains(sentinel), + "System message should contain the instruction sentinel: " + sentinel); + } + } + + @Test + void testShouldForwardProviderWireModel() throws Exception { + ctx.configureForTest("session_config", "should_forward_provider_wire_model"); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client + .createSession(new SessionConfig().setModel("claude-sonnet-4.5") + .setProvider(new ProviderConfig().setType("openai").setBaseUrl(ctx.getProxyUrl()) + .setApiKey("test-provider-key").setWireModel("test-wire-model") + .setMaxOutputTokens(1024)) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)) + .get(); + + session.sendAndWait(new MessageOptions().setPrompt("What is 1+1?")).get(30, TimeUnit.SECONDS); + + List> exchanges = ctx.getExchanges(); + assertFalse(exchanges.isEmpty(), "Should have at least one exchange"); + @SuppressWarnings("unchecked") + Map request = (Map) exchanges.get(0).get("request"); + assertEquals("test-wire-model", request.get("model")); + } + } + + @Test + void testShouldUseProviderModelIdAsWireModel() throws Exception { + ctx.configureForTest("session_config", "should_use_provider_model_id_as_wire_model"); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig() + .setProvider(new ProviderConfig().setType("openai").setBaseUrl(ctx.getProxyUrl()) + .setApiKey("test-provider-key").setModelId("claude-sonnet-4.5")) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + session.sendAndWait(new MessageOptions().setPrompt("What is 1+1?")).get(30, TimeUnit.SECONDS); + + List> exchanges = ctx.getExchanges(); + assertFalse(exchanges.isEmpty(), "Should have at least one exchange"); + @SuppressWarnings("unchecked") + Map request = (Map) exchanges.get(0).get("request"); + assertEquals("claude-sonnet-4.5", request.get("model")); + } + } + + @SuppressWarnings("unchecked") + private static String getSystemMessage(Map exchange) { + // The exchange structure is: { request: { messages: [...] }, response: ..., + // requestHeaders: ... } + Object requestObj = exchange.get("request"); + if (!(requestObj instanceof Map request)) { + return null; + } + Object messagesObj = request.get("messages"); + if (messagesObj instanceof List messages) { + for (Object msg : messages) { + if (msg instanceof Map msgMap) { + if ("system".equals(msgMap.get("role"))) { + Object content = msgMap.get("content"); + return content != null ? content.toString() : null; + } + } + } + } + return null; + } +} diff --git a/src/test/java/com/github/copilot/sdk/SessionEventDeserializationTest.java b/src/test/java/com/github/copilot/SessionEventDeserializationTest.java similarity index 96% rename from src/test/java/com/github/copilot/sdk/SessionEventDeserializationTest.java rename to src/test/java/com/github/copilot/SessionEventDeserializationTest.java index 2da7783587..07b4c2eed2 100644 --- a/src/test/java/com/github/copilot/sdk/SessionEventDeserializationTest.java +++ b/src/test/java/com/github/copilot/SessionEventDeserializationTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -12,7 +12,7 @@ import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.generated.*; +import com.github.copilot.generated.*; /** * Tests for session event deserialization. @@ -736,7 +736,7 @@ void testParseAbortEvent() throws Exception { { "type": "abort", "data": { - "reason": "user_requested" + "reason": "user_initiated" } } """; @@ -792,10 +792,10 @@ void testParseSessionShutdownEvent() throws Exception { var shutdownEvent = (SessionShutdownEvent) event; assertEquals(ShutdownType.ROUTINE, shutdownEvent.getData().shutdownType()); - assertEquals(5.0, shutdownEvent.getData().totalPremiumRequests()); + assertEquals(Double.valueOf(5.0), shutdownEvent.getData().totalPremiumRequests()); assertEquals("gpt-4", shutdownEvent.getData().currentModel()); assertNotNull(shutdownEvent.getData().codeChanges()); - assertEquals(10.0, shutdownEvent.getData().codeChanges().linesAdded()); + assertEquals((Long) 10L, shutdownEvent.getData().codeChanges().linesAdded()); } @Test @@ -841,7 +841,7 @@ void testParseUnknownEventType() throws Exception { SessionEvent event = parseJson(json); assertNotNull(event, "Unknown event types should return an UnknownSessionEvent"); - assertInstanceOf(com.github.copilot.sdk.generated.UnknownSessionEvent.class, event, + assertInstanceOf(com.github.copilot.generated.UnknownSessionEvent.class, event, "Unknown event types should return UnknownSessionEvent for forward compatibility"); assertEquals("unknown.event.type", event.getType(), "UnknownSessionEvent should preserve the original type from JSON"); @@ -859,7 +859,7 @@ void testParseMissingTypeField() throws Exception { SessionEvent event = parseJson(json); assertNotNull(event, "Events without type field should return UnknownSessionEvent"); - assertInstanceOf(com.github.copilot.sdk.generated.UnknownSessionEvent.class, event); + assertInstanceOf(com.github.copilot.generated.UnknownSessionEvent.class, event); } @Test @@ -887,7 +887,7 @@ void testParseEmptyJson() throws Exception { SessionEvent event = parseJson(json); assertNotNull(event, "Empty JSON should return UnknownSessionEvent"); - assertInstanceOf(com.github.copilot.sdk.generated.UnknownSessionEvent.class, event); + assertInstanceOf(com.github.copilot.generated.UnknownSessionEvent.class, event); } // ========================================================================= @@ -1054,7 +1054,7 @@ void testSessionStartEventAllFields() throws Exception { assertNotNull(event); var data = event.getData(); assertEquals("sess-full", data.sessionId()); - assertEquals(2.0, data.version()); + assertEquals((Long) 2L, data.version()); assertEquals("copilot-cli", data.producer()); assertEquals("1.2.3", data.copilotVersion()); assertNotNull(data.startTime()); @@ -1077,7 +1077,7 @@ void testSessionResumeEventAllFields() throws Exception { assertNotNull(event); var data = event.getData(); assertNotNull(data.resumeTime()); - assertEquals(42.0, data.eventCount()); + assertEquals((Long) 42L, data.eventCount()); } @Test @@ -1178,13 +1178,13 @@ void testSessionTruncationEventAllFields() throws Exception { var event = (SessionTruncationEvent) parseJson(json); assertNotNull(event); var data = event.getData(); - assertEquals(128000.0, data.tokenLimit()); - assertEquals(150000.0, data.preTruncationTokensInMessages()); - assertEquals(100.0, data.preTruncationMessagesLength()); - assertEquals(120000.0, data.postTruncationTokensInMessages()); - assertEquals(80.0, data.postTruncationMessagesLength()); - assertEquals(30000.0, data.tokensRemovedDuringTruncation()); - assertEquals(20.0, data.messagesRemovedDuringTruncation()); + assertEquals((Long) 128000L, data.tokenLimit()); + assertEquals((Long) 150000L, data.preTruncationTokensInMessages()); + assertEquals((Long) 100L, data.preTruncationMessagesLength()); + assertEquals((Long) 120000L, data.postTruncationTokensInMessages()); + assertEquals((Long) 80L, data.postTruncationMessagesLength()); + assertEquals((Long) 30000L, data.tokensRemovedDuringTruncation()); + assertEquals((Long) 20L, data.messagesRemovedDuringTruncation()); assertEquals("system", data.performedBy()); } @@ -1204,9 +1204,9 @@ void testSessionUsageInfoEventAllFields() throws Exception { var event = (SessionUsageInfoEvent) parseJson(json); assertNotNull(event); var data = event.getData(); - assertEquals(128000.0, data.tokenLimit()); - assertEquals(50000.0, data.currentTokens()); - assertEquals(25.0, data.messagesLength()); + assertEquals((Long) 128000L, data.tokenLimit()); + assertEquals((Long) 50000L, data.currentTokens()); + assertEquals((Long) 25L, data.messagesLength()); } @Test @@ -1240,21 +1240,21 @@ void testSessionCompactionCompleteEventAllFields() throws Exception { var data = event.getData(); assertTrue(data.success()); assertNull(data.error()); - assertEquals(150000.0, data.preCompactionTokens()); - assertEquals(60000.0, data.postCompactionTokens()); - assertEquals(100.0, data.preCompactionMessagesLength()); - assertEquals(50.0, data.messagesRemoved()); - assertEquals(90000.0, data.tokensRemoved()); + assertEquals((Long) 150000L, data.preCompactionTokens()); + assertEquals((Long) 60000L, data.postCompactionTokens()); + assertEquals((Long) 100L, data.preCompactionMessagesLength()); + assertEquals((Long) 50L, data.messagesRemoved()); + assertEquals((Long) 90000L, data.tokensRemoved()); assertEquals("Compacted conversation", data.summaryContent()); - assertEquals(3.0, data.checkpointNumber()); + assertEquals((Long) 3L, data.checkpointNumber()); assertEquals("/checkpoints/3", data.checkpointPath()); assertEquals("req-compact-1", data.requestId()); var tokens = data.compactionTokensUsed(); assertNotNull(tokens); - assertEquals(1000.0, tokens.inputTokens()); - assertEquals(500.0, tokens.outputTokens()); - assertEquals(200.0, tokens.cacheReadTokens()); + assertEquals((Long) 1000L, tokens.inputTokens()); + assertEquals((Long) 500L, tokens.outputTokens()); + assertEquals((Long) 200L, tokens.cacheReadTokens()); } @Test @@ -1288,16 +1288,16 @@ void testSessionShutdownEventAllFields() throws Exception { var data = event.getData(); assertEquals(ShutdownType.ERROR, data.shutdownType()); assertEquals("OOM", data.errorReason()); - assertEquals(10.0, data.totalPremiumRequests()); - assertEquals(5000.5, data.totalApiDurationMs()); - assertEquals(1700000000000.0, data.sessionStartTime()); + assertEquals(Double.valueOf(10.0), data.totalPremiumRequests()); + assertEquals((Long) 5000L, data.totalApiDurationMs()); + assertEquals((Long) 1700000000000L, data.sessionStartTime()); assertEquals("gpt-4-turbo", data.currentModel()); assertNotNull(data.modelMetrics()); var changes = data.codeChanges(); assertNotNull(changes); - assertEquals(50.0, changes.linesAdded()); - assertEquals(20.0, changes.linesRemoved()); + assertEquals((Long) 50L, changes.linesAdded()); + assertEquals((Long) 20L, changes.linesRemoved()); assertNotNull(changes.filesModified()); assertEquals(3, changes.filesModified().size()); assertEquals("a.java", changes.filesModified().get(0)); @@ -1391,7 +1391,7 @@ void testAssistantStreamingDeltaEventAllFields() throws Exception { var event = (AssistantStreamingDeltaEvent) parseJson(json); assertNotNull(event); assertEquals("assistant.streaming_delta", event.getType()); - assertEquals(4096.0, event.getData().totalResponseSizeBytes()); + assertEquals((Long) 4096L, event.getData().totalResponseSizeBytes()); } @Test @@ -1482,12 +1482,12 @@ void testAssistantUsageEventAllFields() throws Exception { assertNotNull(event); var data = event.getData(); assertEquals("gpt-4-turbo", data.model()); - assertEquals(500.0, data.inputTokens()); - assertEquals(200.0, data.outputTokens()); - assertEquals(50.0, data.cacheReadTokens()); - assertEquals(150.0, data.cacheWriteTokens()); + assertEquals((Long) 500L, data.inputTokens()); + assertEquals((Long) 200L, data.outputTokens()); + assertEquals((Long) 50L, data.cacheReadTokens()); + assertEquals((Long) 150L, data.cacheWriteTokens()); assertEquals(0.05, data.cost()); - assertEquals(1234.5, data.duration()); + assertEquals((Long) 1234L, data.duration()); assertEquals("user", data.initiator()); assertEquals("api-1", data.apiCallId()); assertEquals("prov-1", data.providerCallId()); @@ -1497,11 +1497,11 @@ void testAssistantUsageEventAllFields() throws Exception { // Verify copilotUsage assertNotNull(data.copilotUsage()); - assertEquals(1234567.0, data.copilotUsage().totalNanoAiu()); + assertEquals(Double.valueOf(1234567.0), data.copilotUsage().totalNanoAiu()); assertNotNull(data.copilotUsage().tokenDetails()); assertEquals(2, data.copilotUsage().tokenDetails().size()); assertEquals("input", data.copilotUsage().tokenDetails().get(0).tokenType()); - assertEquals(500.0, data.copilotUsage().tokenDetails().get(0).tokenCount()); + assertEquals((Long) 500L, data.copilotUsage().tokenDetails().get(0).tokenCount()); assertEquals("output", data.copilotUsage().tokenDetails().get(1).tokenType()); } @@ -1522,10 +1522,8 @@ void testAssistantUsageEventWithNullQuotaSnapshots() throws Exception { assertNotNull(event); var data = event.getData(); assertEquals("gpt-4-turbo", data.model()); - assertEquals(500.0, data.inputTokens()); - assertEquals(200.0, data.outputTokens()); - // quotaSnapshots is null when absent in JSON (generated class uses nullable - // fields) + assertEquals((Long) 500L, data.inputTokens()); + assertEquals((Long) 200L, data.outputTokens()); assertNull(data.quotaSnapshots()); } @@ -1987,14 +1985,14 @@ void testAbortEventAllFields() throws Exception { { "type": "abort", "data": { - "reason": "user_cancelled" + "reason": "user_abort" } } """; var event = (AbortEvent) parseJson(json); assertNotNull(event); - assertEquals("user_cancelled", event.getData().reason()); + assertEquals(AbortReason.USER_ABORT, event.getData().reason()); } @Test @@ -2147,7 +2145,7 @@ void testParseJsonNodeSessionShutdownWithCodeChanges() throws Exception { var event = (SessionShutdownEvent) parseJson(json); assertNotNull(event); assertEquals(ShutdownType.ROUTINE, event.getData().shutdownType()); - assertEquals(100.0, event.getData().codeChanges().linesAdded()); + assertEquals((Long) 100L, event.getData().codeChanges().linesAdded()); assertEquals(1, event.getData().codeChanges().filesModified().size()); } @@ -2275,7 +2273,10 @@ void testParsePermissionCompletedEvent() throws Exception { assertNotNull(event); assertEquals("permission.completed", event.getType()); assertEquals("perm-req-456", event.getData().requestId()); - assertEquals(PermissionCompletedKind.APPROVED, event.getData().result().kind()); + assertNotNull(event.getData().result()); + @SuppressWarnings("unchecked") + var result = (java.util.Map) event.getData().result(); + assertEquals("approved", result.get("kind")); } @Test @@ -2323,8 +2324,8 @@ void testParseExitPlanModeRequestedEvent() throws Exception { "requestId": "plan-req-001", "summary": "Plan is ready", "planContent": "## Plan\\n1. Do thing", - "actions": ["approve", "edit", "reject"], - "recommendedAction": "approve" + "actions": ["exit_only", "interactive", "autopilot"], + "recommendedAction": "interactive" } } """; @@ -2335,7 +2336,7 @@ void testParseExitPlanModeRequestedEvent() throws Exception { assertEquals("plan-req-001", event.getData().requestId()); assertEquals("Plan is ready", event.getData().summary()); assertEquals(3, event.getData().actions().size()); - assertEquals("approve", event.getData().recommendedAction()); + assertEquals(ExitPlanModeAction.INTERACTIVE, event.getData().recommendedAction()); } @Test @@ -2398,7 +2399,8 @@ void testParseCapabilitiesChangedEvent() throws Exception { assertTrue(castedEvent.getData().ui().elicitation()); // Verify setData round-trip - var newData = new CapabilitiesChangedEvent.CapabilitiesChangedEventData(new CapabilitiesChangedUI(false)); + var newData = new CapabilitiesChangedEvent.CapabilitiesChangedEventData( + new CapabilitiesChangedUI(false, null, null)); castedEvent.setData(newData); assertFalse(castedEvent.getData().ui().elicitation()); } diff --git a/src/test/java/com/github/copilot/sdk/SessionEventHandlingTest.java b/src/test/java/com/github/copilot/SessionEventHandlingTest.java similarity index 98% rename from src/test/java/com/github/copilot/sdk/SessionEventHandlingTest.java rename to src/test/java/com/github/copilot/SessionEventHandlingTest.java index 73ed6fffa3..8ab6f9bfeb 100644 --- a/src/test/java/com/github/copilot/sdk/SessionEventHandlingTest.java +++ b/src/test/java/com/github/copilot/SessionEventHandlingTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -21,10 +21,10 @@ import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.generated.SessionStartEvent; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.generated.SessionStartEvent; /** * Unit tests for session event handling API. @@ -180,7 +180,7 @@ void testHandlerReceivesCorrectEventData() { SessionStartEvent startEvent = createSessionStartEvent(); startEvent.setData(new SessionStartEvent.SessionStartEventData("my-session-123", null, null, null, null, null, - null, null, null, null)); + null, null, null, null, null, null)); dispatchEvent(startEvent); AssistantMessageEvent msgEvent = createAssistantMessageEvent("Test content"); @@ -857,15 +857,15 @@ private SessionStartEvent createSessionStartEvent() { private SessionStartEvent createSessionStartEvent(String sessionId) { var event = new SessionStartEvent(); var data = new SessionStartEvent.SessionStartEventData(sessionId, null, null, null, null, null, null, null, - null, null); + null, null, null, null); event.setData(data); return event; } private AssistantMessageEvent createAssistantMessageEvent(String content) { var event = new AssistantMessageEvent(); - var data = new AssistantMessageEvent.AssistantMessageEventData(null, content, null, null, null, null, null, - null, null, null, null); + var data = new AssistantMessageEvent.AssistantMessageEventData(null, null, content, null, null, null, null, + null, null, null, null, null, null, null, null, null); event.setData(data); return event; } diff --git a/src/test/java/com/github/copilot/sdk/SessionEventsE2ETest.java b/src/test/java/com/github/copilot/SessionEventsE2ETest.java similarity index 94% rename from src/test/java/com/github/copilot/sdk/SessionEventsE2ETest.java rename to src/test/java/com/github/copilot/SessionEventsE2ETest.java index d13c84247d..161839a533 100644 --- a/src/test/java/com/github/copilot/sdk/SessionEventsE2ETest.java +++ b/src/test/java/com/github/copilot/SessionEventsE2ETest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.assertFalse; import static org.junit.jupiter.api.Assertions.assertTrue; @@ -16,18 +16,18 @@ import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.generated.AssistantTurnEndEvent; -import com.github.copilot.sdk.generated.AssistantTurnStartEvent; -import com.github.copilot.sdk.generated.AssistantUsageEvent; -import com.github.copilot.sdk.generated.SessionIdleEvent; -import com.github.copilot.sdk.generated.ToolExecutionCompleteEvent; -import com.github.copilot.sdk.generated.ToolExecutionStartEvent; -import com.github.copilot.sdk.generated.UserMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.generated.AssistantTurnEndEvent; +import com.github.copilot.generated.AssistantTurnStartEvent; +import com.github.copilot.generated.AssistantUsageEvent; +import com.github.copilot.generated.SessionIdleEvent; +import com.github.copilot.generated.ToolExecutionCompleteEvent; +import com.github.copilot.generated.ToolExecutionStartEvent; +import com.github.copilot.generated.UserMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; /** * E2E tests for session events to verify event lifecycle. diff --git a/src/test/java/com/github/copilot/sdk/SessionHandlerTest.java b/src/test/java/com/github/copilot/SessionHandlerTest.java similarity index 82% rename from src/test/java/com/github/copilot/sdk/SessionHandlerTest.java rename to src/test/java/com/github/copilot/SessionHandlerTest.java index 847734b4a0..1b672e6e25 100644 --- a/src/test/java/com/github/copilot/sdk/SessionHandlerTest.java +++ b/src/test/java/com/github/copilot/SessionHandlerTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -16,15 +16,15 @@ import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PermissionRequestResultKind; -import com.github.copilot.sdk.json.SessionEndHookOutput; -import com.github.copilot.sdk.json.SessionHooks; -import com.github.copilot.sdk.json.SessionStartHookOutput; -import com.github.copilot.sdk.json.ToolDefinition; -import com.github.copilot.sdk.json.UserInputRequest; -import com.github.copilot.sdk.json.UserInputResponse; -import com.github.copilot.sdk.json.UserPromptSubmittedHookOutput; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PermissionRequestResultKind; +import com.github.copilot.rpc.SessionEndHookOutput; +import com.github.copilot.rpc.SessionHooks; +import com.github.copilot.rpc.SessionStartHookOutput; +import com.github.copilot.rpc.ToolDefinition; +import com.github.copilot.rpc.UserInputRequest; +import com.github.copilot.rpc.UserInputResponse; +import com.github.copilot.rpc.UserPromptSubmittedHookOutput; /** * Unit tests for CopilotSession internal handler methods. @@ -262,6 +262,54 @@ void testHandleHooksInvokeSessionEnd() throws Exception { assertEquals("summary", output.sessionSummary()); } + // ===== handleHooksInvoke: sessionId deserialization on hook inputs ===== + + @Test + void testHookInputSessionIdDeserializedForSessionStart() throws Exception { + var hooks = new SessionHooks().setOnSessionStart((hookInput, invocation) -> { + assertEquals("runtime-session-123", hookInput.sessionId()); + assertEquals(1735689600L, hookInput.timestamp()); + assertEquals("/tmp", hookInput.cwd()); + return CompletableFuture.completedFuture(new SessionStartHookOutput(null, null)); + }); + session.registerHooks(hooks); + + JsonNode input = MAPPER.valueToTree( + Map.of("sessionId", "runtime-session-123", "timestamp", 1735689600L, "cwd", "/tmp", "source", "new")); + + session.handleHooksInvoke("sessionStart", input).get(); + } + + @Test + void testHookInputSessionIdDeserializedForSessionEnd() throws Exception { + var hooks = new SessionHooks().setOnSessionEnd((hookInput, invocation) -> { + assertEquals("runtime-session-456", hookInput.sessionId()); + assertEquals("user_closed", hookInput.reason()); + return CompletableFuture.completedFuture(new SessionEndHookOutput(false, null, null)); + }); + session.registerHooks(hooks); + + JsonNode input = MAPPER.valueToTree(Map.of("sessionId", "runtime-session-456", "timestamp", 1735689600L, "cwd", + "/tmp", "reason", "user_closed")); + + session.handleHooksInvoke("sessionEnd", input).get(); + } + + @Test + void testHookInputSessionIdDeserializedForUserPromptSubmitted() throws Exception { + var hooks = new SessionHooks().setOnUserPromptSubmitted((hookInput, invocation) -> { + assertEquals("runtime-session-789", hookInput.sessionId()); + assertEquals("hello", hookInput.prompt()); + return CompletableFuture.completedFuture(new UserPromptSubmittedHookOutput(null, null, null)); + }); + session.registerHooks(hooks); + + JsonNode input = MAPPER.valueToTree( + Map.of("sessionId", "runtime-session-789", "timestamp", 1735689600L, "cwd", "/tmp", "prompt", "hello")); + + session.handleHooksInvoke("userPromptSubmitted", input).get(); + } + // ===== handleHooksInvoke: unhandled hook type ===== @Test diff --git a/src/test/java/com/github/copilot/sdk/SessionRequestBuilderTest.java b/src/test/java/com/github/copilot/SessionRequestBuilderTest.java similarity index 50% rename from src/test/java/com/github/copilot/sdk/SessionRequestBuilderTest.java rename to src/test/java/com/github/copilot/SessionRequestBuilderTest.java index abb4447f52..9fca584d1b 100644 --- a/src/test/java/com/github/copilot/sdk/SessionRequestBuilderTest.java +++ b/src/test/java/com/github/copilot/SessionRequestBuilderTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -12,17 +12,22 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.CreateSessionRequest; -import com.github.copilot.sdk.json.DefaultAgentConfig; -import com.github.copilot.sdk.json.ElicitationHandler; -import com.github.copilot.sdk.json.ElicitationResult; -import com.github.copilot.sdk.json.ElicitationResultAction; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.ResumeSessionRequest; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.SessionHooks; -import com.github.copilot.sdk.json.ToolDefinition; -import com.github.copilot.sdk.json.UserInputResponse; +import com.github.copilot.rpc.AutoModeSwitchResponse; +import com.github.copilot.rpc.CloudSessionOptions; +import com.github.copilot.rpc.CloudSessionRepository; +import com.github.copilot.rpc.CreateSessionRequest; +import com.github.copilot.rpc.DefaultAgentConfig; +import com.github.copilot.rpc.ElicitationHandler; +import com.github.copilot.rpc.ElicitationResult; +import com.github.copilot.rpc.ElicitationResultAction; +import com.github.copilot.rpc.ExitPlanModeResult; +import com.github.copilot.rpc.LargeToolOutputConfig; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.ResumeSessionRequest; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.SessionHooks; +import com.github.copilot.rpc.ToolDefinition; +import com.github.copilot.rpc.UserInputResponse; /** * Unit tests for {@link SessionRequestBuilder} branch coverage. @@ -86,6 +91,57 @@ void testBuildCreateRequestSetsClientName() { assertEquals("my-app", request.getClientName()); } + @Test + void testBuildCreateRequestSetsReasoningSummary() { + var config = new SessionConfig().setReasoningSummary("concise"); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + assertEquals("concise", request.getReasoningSummary()); + } + + @Test + void testBuildCreateRequestSetsPluginDirectoriesAndLargeOutput() { + var largeOutput = new LargeToolOutputConfig().setEnabled(true).setMaxSizeBytes(1024L) + .setOutputDirectory("/tmp/out"); + var config = new SessionConfig().setPluginDirectories(List.of("/plugins/a")).setLargeOutput(largeOutput); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + assertEquals(List.of("/plugins/a"), request.getPluginDirectories()); + assertEquals(largeOutput, request.getLargeOutput()); + } + + @Test + void testBuildCreateRequestForwardsEnableSessionTelemetryWhenFalse() { + var config = new SessionConfig().setEnableSessionTelemetry(false); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + assertFalse(request.getEnableSessionTelemetry()); + } + + @Test + void testBuildCreateRequestOmitsEnableSessionTelemetryWhenNotSet() { + var config = new SessionConfig(); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + assertNull(request.getEnableSessionTelemetry()); + } + + @Test + void testBuildCreateRequestPassesThroughNullMcpOAuthTokenStorage() { + var config = new SessionConfig(); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + assertNull(request.getMcpOAuthTokenStorage()); + } + + @Test + void testBuildCreateRequestForwardsExplicitMcpOAuthTokenStorage() { + var config = new SessionConfig().setMcpOAuthTokenStorage("persistent"); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + assertEquals("persistent", request.getMcpOAuthTokenStorage()); + } + + @Test + void testBuildCreateRequestNullConfigHasNullMcpOAuthTokenStorage() { + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(null); + assertNull(request.getMcpOAuthTokenStorage()); + } + // ========================================================================= // buildResumeRequest // ========================================================================= @@ -99,6 +155,20 @@ void testBuildResumeRequestNullConfig() { assertEquals("direct", request.getEnvValueMode(), "envValueMode should be 'direct' even for null config"); } + @Test + void testBuildResumeRequestForwardsEnableSessionTelemetryWhenFalse() { + var config = new ResumeSessionConfig().setEnableSessionTelemetry(false); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", config); + assertFalse(request.getEnableSessionTelemetry()); + } + + @Test + void testBuildResumeRequestOmitsEnableSessionTelemetryWhenNotSet() { + var config = new ResumeSessionConfig(); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-1", config); + assertNull(request.getEnableSessionTelemetry()); + } + @Test void testBuildResumeRequestWithTools() { var tool = ToolDefinition.create("my_tool", "A tool", Map.of("type", "object"), @@ -180,6 +250,43 @@ void testBuildResumeRequestSetsClientName() { assertEquals("my-app", request.getClientName()); } + @Test + void testBuildResumeRequestPassesThroughNullMcpOAuthTokenStorage() { + var config = new ResumeSessionConfig(); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-11", config); + assertNull(request.getMcpOAuthTokenStorage()); + } + + @Test + void testBuildResumeRequestForwardsExplicitMcpOAuthTokenStorage() { + var config = new ResumeSessionConfig().setMcpOAuthTokenStorage("persistent"); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-12", config); + assertEquals("persistent", request.getMcpOAuthTokenStorage()); + } + + @Test + void testBuildResumeRequestNullConfigHasNullMcpOAuthTokenStorage() { + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-13", null); + assertNull(request.getMcpOAuthTokenStorage()); + } + + @Test + void testBuildResumeRequestSetsReasoningSummary() { + var config = new ResumeSessionConfig().setReasoningSummary("none"); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-14", config); + assertEquals("none", request.getReasoningSummary()); + } + + @Test + void testBuildResumeRequestSetsPluginDirectoriesAndLargeOutput() { + var largeOutput = new LargeToolOutputConfig().setEnabled(false).setMaxSizeBytes(2048L) + .setOutputDirectory("/tmp/resume"); + var config = new ResumeSessionConfig().setPluginDirectories(List.of("/plugins/r")).setLargeOutput(largeOutput); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-15", config); + assertEquals(List.of("/plugins/r"), request.getPluginDirectories()); + assertEquals(largeOutput, request.getLargeOutput()); + } + // ========================================================================= // configureSession (ResumeSessionConfig overload) // ========================================================================= @@ -213,7 +320,7 @@ void testConfigureResumeSessionWithUserInputHandler() throws Exception { // Handler was registered β€” verify by calling handleUserInputRequest // (package-private) - var response = session.handleUserInputRequest(new com.github.copilot.sdk.json.UserInputRequest()).get(); + var response = session.handleUserInputRequest(new com.github.copilot.rpc.UserInputRequest()).get(); assertNotNull(response); } @@ -269,8 +376,8 @@ void extractTransformCallbacks_nullSystemMessage_returnsNull() { @Test void extractTransformCallbacks_appendMode_returnsOriginalConfig() { - var config = new com.github.copilot.sdk.json.SystemMessageConfig() - .setMode(com.github.copilot.sdk.SystemMessageMode.APPEND).setContent("extra content"); + var config = new com.github.copilot.rpc.SystemMessageConfig() + .setMode(com.github.copilot.SystemMessageMode.APPEND).setContent("extra content"); ExtractedTransforms result = SessionRequestBuilder.extractTransformCallbacks(config); assertSame(config, result.wireSystemMessage()); assertNull(result.transformCallbacks()); @@ -278,10 +385,10 @@ void extractTransformCallbacks_appendMode_returnsOriginalConfig() { @Test void extractTransformCallbacks_customizeModeNoTransforms_returnsOriginalConfig() { - var sections = Map.of("tone", new com.github.copilot.sdk.json.SectionOverride() - .setAction(com.github.copilot.sdk.json.SectionOverrideAction.REMOVE)); - var config = new com.github.copilot.sdk.json.SystemMessageConfig() - .setMode(com.github.copilot.sdk.SystemMessageMode.CUSTOMIZE).setSections(sections); + var sections = Map.of("tone", new com.github.copilot.rpc.SectionOverride() + .setAction(com.github.copilot.rpc.SectionOverrideAction.REMOVE)); + var config = new com.github.copilot.rpc.SystemMessageConfig() + .setMode(com.github.copilot.SystemMessageMode.CUSTOMIZE).setSections(sections); ExtractedTransforms result = SessionRequestBuilder.extractTransformCallbacks(config); assertSame(config, result.wireSystemMessage()); assertNull(result.transformCallbacks()); @@ -291,9 +398,9 @@ void extractTransformCallbacks_customizeModeNoTransforms_returnsOriginalConfig() void extractTransformCallbacks_customizeModeWithTransform_extractsCallbacks() { var transformFn = (java.util.function.Function>) content -> CompletableFuture .completedFuture(content + " modified"); - var sections = Map.of("identity", new com.github.copilot.sdk.json.SectionOverride().setTransform(transformFn)); - var config = new com.github.copilot.sdk.json.SystemMessageConfig() - .setMode(com.github.copilot.sdk.SystemMessageMode.CUSTOMIZE).setSections(sections); + var sections = Map.of("identity", new com.github.copilot.rpc.SectionOverride().setTransform(transformFn)); + var config = new com.github.copilot.rpc.SystemMessageConfig() + .setMode(com.github.copilot.SystemMessageMode.CUSTOMIZE).setSections(sections); ExtractedTransforms result = SessionRequestBuilder.extractTransformCallbacks(config); @@ -306,7 +413,7 @@ void extractTransformCallbacks_customizeModeWithTransform_extractsCallbacks() { assertNotNull(result.wireSystemMessage().getSections()); var wireSection = result.wireSystemMessage().getSections().get("identity"); assertNotNull(wireSection); - assertEquals(com.github.copilot.sdk.json.SectionOverrideAction.TRANSFORM, wireSection.getAction()); + assertEquals(com.github.copilot.rpc.SectionOverrideAction.TRANSFORM, wireSection.getAction()); assertNull(wireSection.getTransform()); } @@ -334,7 +441,7 @@ void configureSessionWithNullConfig_returnsEarly() { void configureSessionWithCommands_registersCommands() { CopilotSession session = new CopilotSession("session-1", null); - var cmd = new com.github.copilot.sdk.json.CommandDefinition().setName("deploy") + var cmd = new com.github.copilot.rpc.CommandDefinition().setName("deploy") .setHandler(ctx -> CompletableFuture.completedFuture(null)); var config = new SessionConfig().setCommands(List.of(cmd)); @@ -370,7 +477,7 @@ void configureSessionWithOnEvent_registersEventHandler() { void configureResumedSessionWithCommands_registersCommands() { CopilotSession session = new CopilotSession("session-1", null); - var cmd = new com.github.copilot.sdk.json.CommandDefinition().setName("rollback") + var cmd = new com.github.copilot.rpc.CommandDefinition().setName("rollback") .setHandler(ctx -> CompletableFuture.completedFuture(null)); var config = new ResumeSessionConfig().setCommands(List.of(cmd)); @@ -441,4 +548,238 @@ void testBuildResumeRequestWithGitHubToken() { assertEquals("ghp_per_session_token", request.getGitHubToken()); } + + // ========================================================================= + // instructionDirectories propagation + // ========================================================================= + + @Test + void testBuildCreateRequestPropagatesInstructionDirectories() { + var dirs = List.of("/path/to/instructions", "/another/path"); + var config = new SessionConfig().setInstructionDirectories(dirs); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + assertEquals(dirs, request.getInstructionDirectories()); + } + + @Test + void testBuildResumeRequestPropagatesInstructionDirectories() { + var dirs = List.of("/resume/instructions", "/other/dir"); + var config = new ResumeSessionConfig().setInstructionDirectories(dirs); + + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-inst", config); + + assertEquals(dirs, request.getInstructionDirectories()); + } + + // ========================================================================= + // enableSessionTelemetry serialization + // ========================================================================= + + @Test + void testCreateRequestSerializesEnableSessionTelemetryWhenFalse() throws Exception { + var config = new SessionConfig().setEnableSessionTelemetry(false); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + var mapper = JsonRpcClient.getObjectMapper(); + var json = mapper.writeValueAsString(request); + assertTrue(json.contains("\"enableSessionTelemetry\":false"), + "enableSessionTelemetry should be serialized when set to false"); + } + + @Test + void testCreateRequestOmitsEnableSessionTelemetryWhenNull() throws Exception { + var config = new SessionConfig(); + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + var mapper = JsonRpcClient.getObjectMapper(); + var json = mapper.writeValueAsString(request); + assertFalse(json.contains("enableSessionTelemetry"), "enableSessionTelemetry should be omitted when null"); + } + + @Test + void testResumeRequestSerializesEnableSessionTelemetryWhenFalse() throws Exception { + var config = new ResumeSessionConfig().setEnableSessionTelemetry(false); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-tel", config); + var mapper = JsonRpcClient.getObjectMapper(); + var json = mapper.writeValueAsString(request); + assertTrue(json.contains("\"enableSessionTelemetry\":false"), + "enableSessionTelemetry should be serialized when set to false"); + } + + @Test + void testResumeRequestOmitsEnableSessionTelemetryWhenNull() throws Exception { + var config = new ResumeSessionConfig(); + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("sid-tel", config); + var mapper = JsonRpcClient.getObjectMapper(); + var json = mapper.writeValueAsString(request); + assertFalse(json.contains("enableSessionTelemetry"), "enableSessionTelemetry should be omitted when null"); + } + + // ========================================================================= + // Mode handler request flags + // ========================================================================= + + @Test + void testBuildCreateRequestWithExitPlanModeHandler() { + var config = new SessionConfig().setOnExitPlanMode( + (request, invocation) -> CompletableFuture.completedFuture(new ExitPlanModeResult())); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + assertTrue(request.getRequestExitPlanMode()); + } + + @Test + void testBuildCreateRequestWithAutoModeSwitchHandler() { + var config = new SessionConfig().setOnAutoModeSwitch( + (request, invocation) -> CompletableFuture.completedFuture(AutoModeSwitchResponse.NO)); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + assertTrue(request.getRequestAutoModeSwitch()); + } + + @Test + void testBuildCreateRequestWithoutModeHandlers() { + var config = new SessionConfig(); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + assertNull(request.getRequestExitPlanMode()); + assertNull(request.getRequestAutoModeSwitch()); + } + + @Test + void testBuildResumeRequestWithExitPlanModeHandler() { + var config = new ResumeSessionConfig().setOnExitPlanMode( + (request, invocation) -> CompletableFuture.completedFuture(new ExitPlanModeResult())); + + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("session-1", config); + + assertTrue(request.getRequestExitPlanMode()); + } + + @Test + void testBuildResumeRequestWithAutoModeSwitchHandler() { + var config = new ResumeSessionConfig().setOnAutoModeSwitch( + (request, invocation) -> CompletableFuture.completedFuture(AutoModeSwitchResponse.NO)); + + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("session-1", config); + + assertTrue(request.getRequestAutoModeSwitch()); + } + + @Test + void configureSessionWithExitPlanModeHandler_registersHandler() { + CopilotSession session = new CopilotSession("session-1", null); + + var config = new SessionConfig().setOnExitPlanMode( + (request, invocation) -> CompletableFuture.completedFuture(new ExitPlanModeResult())); + + SessionRequestBuilder.configureSession(session, config); + } + + @Test + void configureSessionWithAutoModeSwitchHandler_registersHandler() { + CopilotSession session = new CopilotSession("session-1", null); + + var config = new SessionConfig().setOnAutoModeSwitch( + (request, invocation) -> CompletableFuture.completedFuture(AutoModeSwitchResponse.NO)); + + SessionRequestBuilder.configureSession(session, config); + } + + @Test + void configureResumedSessionWithExitPlanModeHandler_registersHandler() { + CopilotSession session = new CopilotSession("session-1", null); + + var config = new ResumeSessionConfig().setOnExitPlanMode( + (request, invocation) -> CompletableFuture.completedFuture(new ExitPlanModeResult())); + + SessionRequestBuilder.configureSession(session, config); + } + + @Test + void configureResumedSessionWithAutoModeSwitchHandler_registersHandler() { + CopilotSession session = new CopilotSession("session-1", null); + + var config = new ResumeSessionConfig().setOnAutoModeSwitch( + (request, invocation) -> CompletableFuture.completedFuture(AutoModeSwitchResponse.NO)); + + SessionRequestBuilder.configureSession(session, config); + } + + @Test + void testCreateRequestSerializesModeFlags() throws Exception { + var config = new SessionConfig() + .setOnExitPlanMode((r, i) -> CompletableFuture.completedFuture(new ExitPlanModeResult())) + .setOnAutoModeSwitch((r, i) -> CompletableFuture.completedFuture(AutoModeSwitchResponse.NO)); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + var mapper = JsonRpcClient.getObjectMapper(); + var json = mapper.writeValueAsString(request); + + assertTrue(json.contains("\"requestExitPlanMode\":true")); + assertTrue(json.contains("\"requestAutoModeSwitch\":true")); + } + + @Test + void testResumeRequestSerializesModeFlags() throws Exception { + var config = new ResumeSessionConfig() + .setOnExitPlanMode((r, i) -> CompletableFuture.completedFuture(new ExitPlanModeResult())) + .setOnAutoModeSwitch((r, i) -> CompletableFuture.completedFuture(AutoModeSwitchResponse.NO)); + + ResumeSessionRequest request = SessionRequestBuilder.buildResumeRequest("session-1", config); + var mapper = JsonRpcClient.getObjectMapper(); + var json = mapper.writeValueAsString(request); + + assertTrue(json.contains("\"requestExitPlanMode\":true")); + assertTrue(json.contains("\"requestAutoModeSwitch\":true")); + } + + // ========================================================================= + // Cloud session options wiring + // ========================================================================= + + @Test + void testBuildCreateRequestPropagatesCloudSessionOptions() throws Exception { + var cloud = new CloudSessionOptions() + .setRepository(new CloudSessionRepository().setOwner("my-org").setName("my-repo").setBranch("main")); + var config = new SessionConfig().setCloud(cloud); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + + assertNotNull(request.getCloud()); + assertEquals("my-org", request.getCloud().getRepository().getOwner()); + assertEquals("my-repo", request.getCloud().getRepository().getName()); + assertEquals("main", request.getCloud().getRepository().getBranch()); + } + + @Test + void testBuildCreateRequestOmitsCloudWhenNull() throws Exception { + var config = new SessionConfig(); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + var mapper = JsonRpcClient.getObjectMapper(); + var json = mapper.writeValueAsString(request); + + assertNull(request.getCloud()); + assertFalse(json.contains("\"cloud\""), "cloud should be omitted when null"); + } + + @Test + void testCloudSessionOptionsSerializesCorrectly() throws Exception { + var cloud = new CloudSessionOptions() + .setRepository(new CloudSessionRepository().setOwner("acme").setName("widgets").setBranch("feature-1")); + var config = new SessionConfig().setCloud(cloud); + + CreateSessionRequest request = SessionRequestBuilder.buildCreateRequest(config); + var mapper = JsonRpcClient.getObjectMapper(); + var json = mapper.writeValueAsString(request); + + assertTrue(json.contains("\"cloud\"")); + assertTrue(json.contains("\"owner\":\"acme\"")); + assertTrue(json.contains("\"name\":\"widgets\"")); + assertTrue(json.contains("\"branch\":\"feature-1\"")); + } } diff --git a/src/test/java/com/github/copilot/sdk/SkillsTest.java b/src/test/java/com/github/copilot/SkillsTest.java similarity index 96% rename from src/test/java/com/github/copilot/sdk/SkillsTest.java rename to src/test/java/com/github/copilot/SkillsTest.java index 6cf34044fe..6d4b7e1f76 100644 --- a/src/test/java/com/github/copilot/sdk/SkillsTest.java +++ b/src/test/java/com/github/copilot/SkillsTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -17,11 +17,11 @@ import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.CustomAgentConfig; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.CustomAgentConfig; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; /** * Tests for skills configuration functionality. diff --git a/src/test/java/com/github/copilot/sdk/StreamingFidelityTest.java b/src/test/java/com/github/copilot/StreamingFidelityTest.java similarity index 58% rename from src/test/java/com/github/copilot/sdk/StreamingFidelityTest.java rename to src/test/java/com/github/copilot/StreamingFidelityTest.java index f3f5976523..631496a8f7 100644 --- a/src/test/java/com/github/copilot/sdk/StreamingFidelityTest.java +++ b/src/test/java/com/github/copilot/StreamingFidelityTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.assertFalse; import static org.junit.jupiter.api.Assertions.assertNotNull; @@ -14,15 +14,16 @@ import org.junit.jupiter.api.AfterAll; import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Tag; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.SessionEvent; -import com.github.copilot.sdk.generated.AssistantMessageDeltaEvent; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.ResumeSessionConfig; -import com.github.copilot.sdk.json.SessionConfig; +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.AssistantMessageDeltaEvent; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.ResumeSessionConfig; +import com.github.copilot.rpc.SessionConfig; /** * E2E tests for streaming fidelity β€” verifying that delta events are produced @@ -139,6 +140,7 @@ void testShouldNotProduceDeltasWhenStreamingIsDisabled() throws Exception { * @see Snapshot: streaming_fidelity/should_produce_deltas_after_session_resume */ @Test + @Tag("isolated-resume") void testShouldProduceDeltasAfterSessionResume() throws Exception { ctx.configureForTest("streaming_fidelity", "should_produce_deltas_after_session_resume"); @@ -182,4 +184,98 @@ void testShouldProduceDeltasAfterSessionResume() throws Exception { } } } + + /** + * Verifies that no delta events are produced after resuming a session with + * streaming disabled (even though it was originally created with streaming + * enabled). + * + * @see Snapshot: + * streaming_fidelity/should_not_produce_deltas_after_session_resume_with_streaming_disabled + */ + @Test + @Tag("isolated-resume") + void testShouldNotProduceDeltasAfterSessionResumeWithStreamingDisabled() throws Exception { + ctx.configureForTest("streaming_fidelity", + "should_not_produce_deltas_after_session_resume_with_streaming_disabled"); + + try (CopilotClient client = ctx.createClient()) { + // Create a streaming session and send an initial message + CopilotSession session = client.createSession( + new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL).setStreaming(true)).get(); + session.sendAndWait(new MessageOptions().setPrompt("What is 3 + 6?")).get(60, TimeUnit.SECONDS); + String sessionId = session.getSessionId(); + session.close(); + + // Resume using a new client with streaming DISABLED + try (CopilotClient newClient = ctx.createClient()) { + CopilotSession session2 = newClient.resumeSession(sessionId, new ResumeSessionConfig() + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL).setStreaming(false)).get(); + + List events = new ArrayList<>(); + session2.on(events::add); + + AssistantMessageEvent answer = session2 + .sendAndWait(new MessageOptions().setPrompt("Now if you double that, what do you get?")) + .get(60, TimeUnit.SECONDS); + assertNotNull(answer); + assertTrue(answer.getData().content().contains("18"), + "Follow-up response should contain 18: " + answer.getData().content()); + + // No deltas when streaming is toggled off + List deltaEvents = events.stream() + .filter(e -> e instanceof AssistantMessageDeltaEvent).map(e -> (AssistantMessageDeltaEvent) e) + .toList(); + assertTrue(deltaEvents.isEmpty(), + "Should not receive delta events when streaming is disabled on resume"); + + // But should still have a final assistant.message + List assistantEvents = events.stream() + .filter(e -> e instanceof AssistantMessageEvent).map(e -> (AssistantMessageEvent) e).toList(); + assertFalse(assistantEvents.isEmpty(), + "Should still have a final assistant.message when streaming is disabled"); + + session2.close(); + } + } + } + + /** + * Verifies that setting reasoningEffort alongside streaming=true does not break + * the streaming pipeline β€” deltas still arrive and complete successfully. + * + * @see Snapshot: + * streaming_fidelity/should_emit_streaming_deltas_with_reasoning_effort_configured + */ + @Test + void testShouldEmitStreamingDeltasWithReasoningEffortConfigured() throws Exception { + ctx.configureForTest("streaming_fidelity", "should_emit_streaming_deltas_with_reasoning_effort_configured"); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client + .createSession(new SessionConfig().setOnPermissionRequest(PermissionHandler.APPROVE_ALL) + .setStreaming(true).setReasoningEffort("high")) + .get(); + + List events = new ArrayList<>(); + session.on(events::add); + + session.sendAndWait(new MessageOptions().setPrompt("What is 15 * 17?")).get(60, TimeUnit.SECONDS); + + // With streaming + reasoning effort, we should still get content deltas + List deltaEvents = events.stream() + .filter(e -> e instanceof AssistantMessageDeltaEvent).map(e -> (AssistantMessageDeltaEvent) e) + .toList(); + assertFalse(deltaEvents.isEmpty(), "Should have received delta events with reasoning effort configured"); + + // And a final assistant.message with the answer + List assistantEvents = events.stream() + .filter(e -> e instanceof AssistantMessageEvent).map(e -> (AssistantMessageEvent) e).toList(); + assertFalse(assistantEvents.isEmpty(), "Should have received assistant message events"); + assertTrue(assistantEvents.get(assistantEvents.size() - 1).getData().content().contains("255"), + "Response should contain 255"); + + session.close(); + } + } } diff --git a/src/test/java/com/github/copilot/sdk/TelemetryConfigTest.java b/src/test/java/com/github/copilot/TelemetryConfigTest.java similarity index 88% rename from src/test/java/com/github/copilot/sdk/TelemetryConfigTest.java rename to src/test/java/com/github/copilot/TelemetryConfigTest.java index 99b360d2db..2dd41c28a7 100644 --- a/src/test/java/com/github/copilot/sdk/TelemetryConfigTest.java +++ b/src/test/java/com/github/copilot/TelemetryConfigTest.java @@ -2,13 +2,13 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.json.TelemetryConfig; +import com.github.copilot.rpc.TelemetryConfig; /** * Unit tests for {@link TelemetryConfig} getters, setters, and fluent chaining. @@ -22,7 +22,7 @@ void defaultValuesAreNull() { assertNull(config.getFilePath()); assertNull(config.getExporterType()); assertNull(config.getSourceName()); - assertNull(config.getCaptureContent()); + assertTrue(config.getCaptureContent().isEmpty()); } @Test @@ -57,10 +57,10 @@ void sourceNameGetterSetter() { void captureContentGetterSetter() { var config = new TelemetryConfig(); config.setCaptureContent(true); - assertTrue(config.getCaptureContent()); + assertTrue(config.getCaptureContent().get()); config.setCaptureContent(false); - assertFalse(config.getCaptureContent()); + assertFalse(config.getCaptureContent().get()); } @Test @@ -72,6 +72,6 @@ void fluentChainingReturnsThis() { assertEquals("/tmp/spans.json", config.getFilePath()); assertEquals("file", config.getExporterType()); assertEquals("sdk-test", config.getSourceName()); - assertTrue(config.getCaptureContent()); + assertTrue(config.getCaptureContent().get()); } } diff --git a/src/test/java/com/github/copilot/sdk/TestUtil.java b/src/test/java/com/github/copilot/TestUtil.java similarity index 94% rename from src/test/java/com/github/copilot/sdk/TestUtil.java rename to src/test/java/com/github/copilot/TestUtil.java index d9462af87f..cadef040b6 100644 --- a/src/test/java/com/github/copilot/sdk/TestUtil.java +++ b/src/test/java/com/github/copilot/TestUtil.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import java.io.BufferedReader; import java.io.InputStreamReader; @@ -36,9 +36,9 @@ public static String tempPath(String filename) { *

* Resolution order: *

    - *
  1. Search the system PATH using {@code where.exe} (Windows) or {@code which} - * (Linux/macOS).
    2. - *
  2. Fall back to the {@code COPILOT_CLI_PATH} environment variable.
    3. + *
  3. Use the {@code COPILOT_CLI_PATH} environment variable when set.
    4. + *
  4. Otherwise search the system PATH using {@code where.exe} (Windows) or + * {@code which} (Linux/macOS).
    5. *
  5. Walk parent directories looking for * {@code nodejs/node_modules/@github/copilot/index.js}.
    6. *
@@ -55,16 +55,16 @@ public static String tempPath(String filename) { * {@code null} if none was found */ static String findCliPath() { - String copilotInPath = findCopilotInPath(); - if (copilotInPath != null) { - return copilotInPath; - } - String envPath = System.getenv("COPILOT_CLI_PATH"); if (envPath != null && !envPath.isEmpty()) { return envPath; } + String copilotInPath = findCopilotInPath(); + if (copilotInPath != null) { + return copilotInPath; + } + Path current = Paths.get(System.getProperty("user.dir")); while (current != null) { Path cliPath = current.resolve("nodejs/node_modules/@github/copilot/index.js"); diff --git a/src/test/java/com/github/copilot/sdk/TimeoutEdgeCaseTest.java b/src/test/java/com/github/copilot/TimeoutEdgeCaseTest.java similarity index 97% rename from src/test/java/com/github/copilot/sdk/TimeoutEdgeCaseTest.java rename to src/test/java/com/github/copilot/TimeoutEdgeCaseTest.java index b771f65b2c..17e1851bb4 100644 --- a/src/test/java/com/github/copilot/sdk/TimeoutEdgeCaseTest.java +++ b/src/test/java/com/github/copilot/TimeoutEdgeCaseTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.assertFalse; import static org.junit.jupiter.api.Assertions.assertTrue; @@ -15,8 +15,8 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; /** * Regression tests for timeout edge cases in diff --git a/src/test/java/com/github/copilot/sdk/ToolInvocationTest.java b/src/test/java/com/github/copilot/ToolInvocationTest.java similarity index 98% rename from src/test/java/com/github/copilot/sdk/ToolInvocationTest.java rename to src/test/java/com/github/copilot/ToolInvocationTest.java index 3dcbf7c9ac..2bc9edb1b4 100644 --- a/src/test/java/com/github/copilot/sdk/ToolInvocationTest.java +++ b/src/test/java/com/github/copilot/ToolInvocationTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -10,7 +10,7 @@ import com.fasterxml.jackson.databind.node.JsonNodeFactory; import com.fasterxml.jackson.databind.node.ObjectNode; -import com.github.copilot.sdk.json.ToolInvocation; +import com.github.copilot.rpc.ToolInvocation; /** * Unit tests for {@link ToolInvocation}. diff --git a/src/test/java/com/github/copilot/ToolResultsTest.java b/src/test/java/com/github/copilot/ToolResultsTest.java new file mode 100644 index 0000000000..54216d9216 --- /dev/null +++ b/src/test/java/com/github/copilot/ToolResultsTest.java @@ -0,0 +1,148 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.github.copilot.generated.SessionEvent; +import com.github.copilot.generated.ToolExecutionCompleteEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.ToolDefinition; +import com.github.copilot.rpc.ToolResultObject; + +/** + * E2E tests for tool result types β€” verifying that rejected and denied result + * types are handled correctly by the runtime. + * + *

+ * Snapshots are stored in {@code test/snapshots/tool_results/}. + *

+ */ +public class ToolResultsTest { + + private static E2ETestContext ctx; + + @BeforeAll + static void setup() throws Exception { + ctx = E2ETestContext.create(); + } + + @AfterAll + static void teardown() throws Exception { + if (ctx != null) { + ctx.close(); + } + } + + /** + * Verifies that a tool returning a "rejected" resultType is reported as a + * failed tool execution with the correct error code. + * + * @see Snapshot: + * tool_results/should_handle_tool_result_with_rejected_resulttype + */ + @Test + void testShouldHandleToolResultWithRejectedResultType() throws Exception { + ctx.configureForTest("tool_results", "should_handle_tool_result_with_rejected_resulttype"); + + var toolHandlerCalled = new boolean[]{false}; + + Map params = Map.of("type", "object", "properties", Map.of(), "required", List.of()); + + ToolDefinition deployTool = ToolDefinition.create("deploy_service", "Deploys a service", params, + (invocation) -> { + toolHandlerCalled[0] = true; + return CompletableFuture.completedFuture(new ToolResultObject("rejected", + "Deployment rejected: policy violation - production deployments require approval", null, + null, null, null)); + }); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig().setTools(List.of(deployTool)) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + List events = new ArrayList<>(); + session.on(events::add); + + session.sendAndWait(new MessageOptions().setPrompt( + "Deploy the service using deploy_service. If it's rejected, tell me it was 'rejected by policy'.")) + .get(60, TimeUnit.SECONDS); + + assertTrue(toolHandlerCalled[0], "Tool handler should have been called"); + + List toolEvents = events.stream() + .filter(e -> e instanceof ToolExecutionCompleteEvent).map(e -> (ToolExecutionCompleteEvent) e) + .toList(); + assertFalse(toolEvents.isEmpty(), "Should have a tool.execution_complete event"); + + ToolExecutionCompleteEvent toolEvt = toolEvents.get(0); + assertFalse(toolEvt.getData().success(), "Tool execution should not be marked as successful"); + assertNotNull(toolEvt.getData().error(), "Should have error details"); + assertEquals("rejected", toolEvt.getData().error().code(), "Error code should be 'rejected'"); + + session.close(); + } + } + + /** + * Verifies that a tool returning a "denied" resultType is reported as a failed + * tool execution with the correct error code. + * + * @see Snapshot: tool_results/should_handle_tool_result_with_denied_resulttype + */ + @Test + void testShouldHandleToolResultWithDeniedResultType() throws Exception { + ctx.configureForTest("tool_results", "should_handle_tool_result_with_denied_resulttype"); + + var toolHandlerCalled = new boolean[]{false}; + + Map params = Map.of("type", "object", "properties", Map.of(), "required", List.of()); + + ToolDefinition accessTool = ToolDefinition.create("access_secret", "Accesses a secret", params, + (invocation) -> { + toolHandlerCalled[0] = true; + return CompletableFuture.completedFuture(new ToolResultObject("denied", + "Access denied: insufficient permissions to read secrets", null, null, null, null)); + }); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig().setTools(List.of(accessTool)) + .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get(); + + List events = new ArrayList<>(); + session.on(events::add); + + session.sendAndWait(new MessageOptions().setPrompt( + "Use access_secret to get the API key. If access is denied, tell me it was 'access denied'.")) + .get(60, TimeUnit.SECONDS); + + assertTrue(toolHandlerCalled[0], "Tool handler should have been called"); + + List toolEvents = events.stream() + .filter(e -> e instanceof ToolExecutionCompleteEvent).map(e -> (ToolExecutionCompleteEvent) e) + .toList(); + assertFalse(toolEvents.isEmpty(), "Should have a tool.execution_complete event"); + + ToolExecutionCompleteEvent toolEvt = toolEvents.get(0); + assertFalse(toolEvt.getData().success(), "Tool execution should not be marked as successful"); + assertNotNull(toolEvt.getData().error(), "Should have error details"); + assertEquals("denied", toolEvt.getData().error().code(), "Error code should be 'denied'"); + + session.close(); + } + } +} diff --git a/src/test/java/com/github/copilot/ToolSetTest.java b/src/test/java/com/github/copilot/ToolSetTest.java new file mode 100644 index 0000000000..0415a74fac --- /dev/null +++ b/src/test/java/com/github/copilot/ToolSetTest.java @@ -0,0 +1,100 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import java.util.Collection; +import java.util.List; + +import org.junit.jupiter.api.Test; + +import com.github.copilot.rpc.BuiltInTools; +import com.github.copilot.rpc.ToolSet; + +/** + * Tests for {@link ToolSet} and {@link BuiltInTools}. + */ +public class ToolSetTest { + + @Test + void testAddBuiltIn() { + var ts = new ToolSet().addBuiltIn("bash"); + assertEquals(1, ts.size()); + assertEquals("builtin:bash", ts.get(0)); + } + + @Test + void testAddBuiltInWildcard() { + var ts = new ToolSet().addBuiltIn("*"); + assertEquals("builtin:*", ts.get(0)); + } + + @Test + void testAddCustom() { + var ts = new ToolSet().addCustom("my_tool"); + assertEquals("custom:my_tool", ts.get(0)); + } + + @Test + void testAddMcp() { + var ts = new ToolSet().addMcp("github-list_issues"); + assertEquals("mcp:github-list_issues", ts.get(0)); + } + + @Test + void testAddMcpWildcard() { + var ts = new ToolSet().addMcp("*"); + assertEquals("mcp:*", ts.get(0)); + } + + @Test + void testChaining() { + var ts = new ToolSet().addBuiltIn("bash").addMcp("*").addCustom("my_tool"); + assertEquals(3, ts.size()); + assertEquals("builtin:bash", ts.get(0)); + assertEquals("mcp:*", ts.get(1)); + assertEquals("custom:my_tool", ts.get(2)); + } + + @Test + void testAddBuiltInCollection() { + var ts = new ToolSet(); + ts.addBuiltIn((Collection) BuiltInTools.ISOLATED); + assertEquals(BuiltInTools.ISOLATED.size(), ts.size()); + assertTrue(ts.contains("builtin:ask_user")); + assertTrue(ts.contains("builtin:task_complete")); + } + + @Test + void testInvalidNameThrows() { + assertThrows(IllegalArgumentException.class, () -> new ToolSet().addBuiltIn("")); + assertThrows(IllegalArgumentException.class, () -> new ToolSet().addBuiltIn((String) null)); + assertThrows(IllegalArgumentException.class, () -> new ToolSet().addBuiltIn("bad/name")); + assertThrows(IllegalArgumentException.class, () -> new ToolSet().addBuiltIn("bad name")); + assertThrows(IllegalArgumentException.class, () -> new ToolSet().addMcp("bad.name")); + assertThrows(IllegalArgumentException.class, () -> new ToolSet().addCustom("bad:name")); + } + + @Test + void testValidNamePatterns() { + // Names with letters, digits, hyphens, underscores are valid + assertDoesNotThrow(() -> new ToolSet().addBuiltIn("my-tool_123")); + assertDoesNotThrow(() -> new ToolSet().addMcp("github-list_issues")); + } + + @Test + void testBuiltInToolsIsolatedIsUnmodifiable() { + assertThrows(UnsupportedOperationException.class, () -> BuiltInTools.ISOLATED.add("new_tool")); + } + + @Test + void testToolSetIsListOfStrings() { + var ts = new ToolSet().addBuiltIn("bash").addMcp("*"); + // ToolSet extends ArrayList, so it is a List + List list = ts; + assertEquals(2, list.size()); + } +} diff --git a/src/test/java/com/github/copilot/sdk/ToolsTest.java b/src/test/java/com/github/copilot/ToolsTest.java similarity index 72% rename from src/test/java/com/github/copilot/sdk/ToolsTest.java rename to src/test/java/com/github/copilot/ToolsTest.java index d13db36856..3bbe767847 100644 --- a/src/test/java/com/github/copilot/sdk/ToolsTest.java +++ b/src/test/java/com/github/copilot/ToolsTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; @@ -20,14 +20,14 @@ import org.junit.jupiter.api.Test; import org.junit.jupiter.api.TestInfo; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; -import com.github.copilot.sdk.json.PermissionHandler; -import com.github.copilot.sdk.json.PermissionRequest; -import com.github.copilot.sdk.json.PermissionRequestResult; -import com.github.copilot.sdk.json.PermissionRequestResultKind; -import com.github.copilot.sdk.json.SessionConfig; -import com.github.copilot.sdk.json.ToolDefinition; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; +import com.github.copilot.rpc.PermissionHandler; +import com.github.copilot.rpc.PermissionRequest; +import com.github.copilot.rpc.PermissionRequestResult; +import com.github.copilot.rpc.PermissionRequestResultKind; +import com.github.copilot.rpc.SessionConfig; +import com.github.copilot.rpc.ToolDefinition; /** * Tests for custom tools functionality. @@ -360,4 +360,109 @@ void testOverridesBuiltInToolWithCustomTool() throws Exception { session.close(); } } + + /** + * Verifies that the model can call multiple custom tools in parallel within a + * single turn. + * + * @see Snapshot: + * tools/should_execute_multiple_custom_tools_in_parallel_single_turn + */ + @Test + void testShouldExecuteMultipleCustomToolsInParallelSingleTurn() throws Exception { + ctx.configureForTest("tools", "should_execute_multiple_custom_tools_in_parallel_single_turn"); + + var toolACalled = new CompletableFuture(); + var toolBCalled = new CompletableFuture(); + + Map cityParams = Map.of("type", "object", "properties", + Map.of("city", Map.of("type", "string", "description", "City name")), "required", List.of("city")); + Map countryParams = Map.of("type", "object", "properties", + Map.of("country", Map.of("type", "string", "description", "Country name")), "required", + List.of("country")); + + ToolDefinition lookupCity = ToolDefinition.create("lookup_city", "Looks up city information", cityParams, + (invocation) -> { + String city = (String) invocation.getArguments().get("city"); + toolACalled.complete(city); + return CompletableFuture.completedFuture("CITY_" + city.toUpperCase()); + }); + + ToolDefinition lookupCountry = ToolDefinition.create("lookup_country", "Looks up country information", + countryParams, (invocation) -> { + String country = (String) invocation.getArguments().get("country"); + toolBCalled.complete(country); + return CompletableFuture.completedFuture("COUNTRY_" + country.toUpperCase()); + }); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig() + .setTools(List.of(lookupCity, lookupCountry)).setOnPermissionRequest(PermissionHandler.APPROVE_ALL)) + .get(); + + AssistantMessageEvent response = session.sendAndWait(new MessageOptions().setPrompt( + "Use lookup_city with 'Paris' and lookup_country with 'France' at the same time, then combine both results in your reply.")) + .get(60, TimeUnit.SECONDS); + + // Both tools should have been called + assertEquals("Paris", toolACalled.get(10, TimeUnit.SECONDS)); + assertEquals("France", toolBCalled.get(10, TimeUnit.SECONDS)); + + assertNotNull(response); + String content = response.getData().content(); + assertTrue(content.contains("CITY_PARIS"), "Response should contain CITY_PARIS: " + content); + assertTrue(content.contains("COUNTRY_FRANCE"), "Response should contain COUNTRY_FRANCE: " + content); + + session.close(); + } + } + + /** + * Verifies that excludedTools are respected even when also listed in + * availableTools. + * + * @see Snapshot: tools/should_respect_availabletools_and_excludedtools_combined + */ + @Test + void testShouldRespectAvailableToolsAndExcludedToolsCombined() throws Exception { + ctx.configureForTest("tools", "should_respect_availabletools_and_excludedtools_combined"); + + var excludedToolCalled = new boolean[]{false}; + + Map inputParams = Map.of("type", "object", "properties", + Map.of("input", Map.of("type", "string", "description", "Input value")), "required", List.of("input")); + + ToolDefinition allowedTool = ToolDefinition.create("allowed_tool", "An allowed tool", inputParams, + (invocation) -> { + String input = (String) invocation.getArguments().get("input"); + return CompletableFuture.completedFuture("ALLOWED_" + input.toUpperCase()); + }); + + ToolDefinition excludedTool = ToolDefinition.create("excluded_tool", "A tool that should be excluded", + inputParams, (invocation) -> { + excludedToolCalled[0] = true; + String input = (String) invocation.getArguments().get("input"); + return CompletableFuture.completedFuture("EXCLUDED_" + input.toUpperCase()); + }); + + try (CopilotClient client = ctx.createClient()) { + CopilotSession session = client.createSession(new SessionConfig() + .setTools(List.of(allowedTool, excludedTool)) + .setAvailableTools(List.of("allowed_tool", "excluded_tool")) + .setExcludedTools(List.of("excluded_tool")).setOnPermissionRequest(PermissionHandler.APPROVE_ALL)) + .get(); + + AssistantMessageEvent response = session + .sendAndWait(new MessageOptions() + .setPrompt("Use the allowed_tool with input 'test'. Do NOT use excluded_tool.")) + .get(60, TimeUnit.SECONDS); + + assertNotNull(response); + assertTrue(response.getData().content().contains("ALLOWED_TEST"), + "Response should contain ALLOWED_TEST: " + response.getData().content()); + assertFalse(excludedToolCalled[0], "Excluded tool should not have been called"); + + session.close(); + } + } } diff --git a/src/test/java/com/github/copilot/UpdateSessionOptionsForModeTest.java b/src/test/java/com/github/copilot/UpdateSessionOptionsForModeTest.java new file mode 100644 index 0000000000..d02ea3097d --- /dev/null +++ b/src/test/java/com/github/copilot/UpdateSessionOptionsForModeTest.java @@ -0,0 +1,260 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +package com.github.copilot; + +import static org.junit.jupiter.api.Assertions.*; + +import java.io.OutputStream; +import java.net.ServerSocket; +import java.net.Socket; +import java.nio.charset.StandardCharsets; + +import org.junit.jupiter.api.Test; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.github.copilot.rpc.CopilotClientMode; +import com.github.copilot.rpc.CopilotClientOptions; + +/** + * Tests for {@link CopilotClient#updateSessionOptionsForMode}. + */ +class UpdateSessionOptionsForModeTest { + + private static final ObjectMapper MAPPER = JsonRpcClient.getObjectMapper(); + + /** + * A connected socket pair where the "server" side auto-replies to every + * JSON-RPC request with {@code {"success": true}}. + */ + private static final class AutoReplyPair implements AutoCloseable { + + final Socket clientSocket; + final Socket serverSocket; + final JsonRpcClient rpcClient; + private volatile boolean running = true; + private final Thread replyThread; + /** The last JSON-RPC params node received by the stub server. */ + volatile JsonNode lastParams; + /** The last JSON-RPC method received by the stub server. */ + volatile String lastMethod; + + AutoReplyPair() throws Exception { + try (var ss = new ServerSocket(0)) { + clientSocket = new Socket("localhost", ss.getLocalPort()); + serverSocket = ss.accept(); + } + serverSocket.setSoTimeout(5000); + rpcClient = JsonRpcClient.fromSocket(clientSocket); + + // Background thread that reads requests and sends back success responses + replyThread = new Thread(() -> { + try { + var in = serverSocket.getInputStream(); + var out = serverSocket.getOutputStream(); + while (running) { + // Read Content-Length header + var header = new StringBuilder(); + int b; + while ((b = in.read()) != -1) { + if (b == '\n' && header.toString().endsWith("\r")) { + break; + } + header.append((char) b); + } + if (b == -1) + break; + // Skip blank line + in.read(); // '\r' + in.read(); // '\n' + + String hdr = header.toString().trim(); + int colon = hdr.indexOf(':'); + int len = Integer.parseInt(hdr.substring(colon + 1).trim()); + byte[] body = in.readNBytes(len); + JsonNode msg = MAPPER.readTree(body); + + lastMethod = msg.get("method").asText(); + lastParams = msg.get("params"); + long id = msg.get("id").asLong(); + + // Send back a success response + String response = MAPPER.writeValueAsString(MAPPER.createObjectNode().put("jsonrpc", "2.0") + .put("id", id).set("result", MAPPER.createObjectNode().put("success", true))); + sendRpcMessage(out, response); + } + } catch (Exception e) { + if (running) { + // Ignore expected exceptions on shutdown + } + } + }); + replyThread.setDaemon(true); + replyThread.start(); + } + + private static void sendRpcMessage(OutputStream out, String json) throws Exception { + byte[] bytes = json.getBytes(StandardCharsets.UTF_8); + String header = "Content-Length: " + bytes.length + "\r\n\r\n"; + out.write(header.getBytes(StandardCharsets.UTF_8)); + out.write(bytes); + out.flush(); + } + + @Override + public void close() throws Exception { + running = false; + rpcClient.close(); + clientSocket.close(); + serverSocket.close(); + replyThread.join(3000); + } + } + + // ── COPILOT_CLI mode tests ──────────────────────────────────────────────── + + @Test + void copilotCliMode_noFieldsSet_noPatchSent() throws Exception { + try (var pair = new AutoReplyPair()) { + var session = new CopilotSession("sess-1", pair.rpcClient); + var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false)); + + client.updateSessionOptionsForMode(session, null, null, null, null).get(); + + assertNull(pair.lastMethod, "No RPC call should be made when no fields are set in COPILOT_CLI mode"); + client.close(); + } + } + + @Test + void copilotCliMode_skipCustomInstructionsSet_patchContainsOnlyThatField() throws Exception { + try (var pair = new AutoReplyPair()) { + var session = new CopilotSession("sess-1", pair.rpcClient); + var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false)); + + client.updateSessionOptionsForMode(session, true, null, null, null).get(); + + assertEquals("session.options.update", pair.lastMethod); + assertTrue(pair.lastParams.get("skipCustomInstructions").asBoolean()); + assertTrue(pair.lastParams.path("customAgentsLocalOnly").isMissingNode(), + "customAgentsLocalOnly should be absent"); + assertTrue(pair.lastParams.path("coauthorEnabled").isMissingNode(), "coauthorEnabled should be absent"); + assertTrue(pair.lastParams.path("manageScheduleEnabled").isMissingNode(), + "manageScheduleEnabled should be absent"); + assertTrue(pair.lastParams.path("installedPlugins").isMissingNode(), "installedPlugins should be absent"); + client.close(); + } + } + + @Test + void copilotCliMode_allFieldsSet_allPropagated() throws Exception { + try (var pair = new AutoReplyPair()) { + var session = new CopilotSession("sess-1", pair.rpcClient); + var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false)); + + client.updateSessionOptionsForMode(session, false, true, true, false).get(); + + assertEquals("session.options.update", pair.lastMethod); + assertFalse(pair.lastParams.get("skipCustomInstructions").asBoolean()); + assertTrue(pair.lastParams.get("customAgentsLocalOnly").asBoolean()); + assertTrue(pair.lastParams.get("coauthorEnabled").asBoolean()); + assertFalse(pair.lastParams.get("manageScheduleEnabled").asBoolean()); + client.close(); + } + } + + @Test + void copilotCliMode_onlyCoauthorEnabled_patchSent() throws Exception { + try (var pair = new AutoReplyPair()) { + var session = new CopilotSession("sess-1", pair.rpcClient); + var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false)); + + client.updateSessionOptionsForMode(session, null, null, true, null).get(); + + assertEquals("session.options.update", pair.lastMethod); + assertTrue(pair.lastParams.get("coauthorEnabled").asBoolean()); + client.close(); + } + } + + // ── EMPTY mode tests ────────────────────────────────────────────────────── + + @Test + void emptyMode_noFieldsSet_safeDefaultsSent() throws Exception { + try (var pair = new AutoReplyPair()) { + var session = new CopilotSession("sess-1", pair.rpcClient); + var client = new CopilotClient(new CopilotClientOptions().setMode(CopilotClientMode.EMPTY) + .setCopilotHome("/tmp/copilot-home").setAutoStart(false)); + + client.updateSessionOptionsForMode(session, null, null, null, null).get(); + + assertEquals("session.options.update", pair.lastMethod); + assertTrue(pair.lastParams.get("skipCustomInstructions").asBoolean(), "default: skip custom instructions"); + assertTrue(pair.lastParams.get("customAgentsLocalOnly").asBoolean(), "default: local agents only"); + assertFalse(pair.lastParams.get("coauthorEnabled").asBoolean(), "default: coauthor disabled"); + assertFalse(pair.lastParams.get("manageScheduleEnabled").asBoolean(), "default: schedule disabled"); + assertTrue(pair.lastParams.get("installedPlugins").isArray(), "installedPlugins should be empty array"); + assertEquals(0, pair.lastParams.get("installedPlugins").size()); + client.close(); + } + } + + @Test + void emptyMode_callerOverridesWin() throws Exception { + try (var pair = new AutoReplyPair()) { + var session = new CopilotSession("sess-1", pair.rpcClient); + var client = new CopilotClient(new CopilotClientOptions().setMode(CopilotClientMode.EMPTY) + .setCopilotHome("/tmp/copilot-home").setAutoStart(false)); + + client.updateSessionOptionsForMode(session, false, false, true, true).get(); + + assertEquals("session.options.update", pair.lastMethod); + assertFalse(pair.lastParams.get("skipCustomInstructions").asBoolean(), "caller override: don't skip"); + assertFalse(pair.lastParams.get("customAgentsLocalOnly").asBoolean(), "caller override: not local only"); + assertTrue(pair.lastParams.get("coauthorEnabled").asBoolean(), "caller override: coauthor enabled"); + assertTrue(pair.lastParams.get("manageScheduleEnabled").asBoolean(), "caller override: schedule enabled"); + assertTrue(pair.lastParams.get("installedPlugins").isArray(), + "installedPlugins always empty in EMPTY mode"); + assertEquals(0, pair.lastParams.get("installedPlugins").size()); + client.close(); + } + } + + @Test + void emptyMode_partialOverrides_restGetDefaults() throws Exception { + try (var pair = new AutoReplyPair()) { + var session = new CopilotSession("sess-1", pair.rpcClient); + var client = new CopilotClient(new CopilotClientOptions().setMode(CopilotClientMode.EMPTY) + .setCopilotHome("/tmp/copilot-home").setAutoStart(false)); + + // Only override coauthorEnabled, rest should use safe defaults + client.updateSessionOptionsForMode(session, null, null, true, null).get(); + + assertEquals("session.options.update", pair.lastMethod); + assertTrue(pair.lastParams.get("skipCustomInstructions").asBoolean(), "default: skip"); + assertTrue(pair.lastParams.get("customAgentsLocalOnly").asBoolean(), "default: local only"); + assertTrue(pair.lastParams.get("coauthorEnabled").asBoolean(), "override: coauthor enabled"); + assertFalse(pair.lastParams.get("manageScheduleEnabled").asBoolean(), "default: schedule disabled"); + client.close(); + } + } + + // ── SessionId injection ─────────────────────────────────────────────────── + + @Test + void sessionIdInjectedBySessionOptionsApi() throws Exception { + try (var pair = new AutoReplyPair()) { + var session = new CopilotSession("my-session-id", pair.rpcClient); + var client = new CopilotClient(new CopilotClientOptions().setAutoStart(false)); + + client.updateSessionOptionsForMode(session, true, null, null, null).get(); + + assertEquals("session.options.update", pair.lastMethod); + assertEquals("my-session-id", pair.lastParams.get("sessionId").asText(), + "SessionOptionsApi should inject sessionId"); + client.close(); + } + } +} diff --git a/src/test/java/com/github/copilot/sdk/ZeroTimeoutContractTest.java b/src/test/java/com/github/copilot/ZeroTimeoutContractTest.java similarity index 94% rename from src/test/java/com/github/copilot/sdk/ZeroTimeoutContractTest.java rename to src/test/java/com/github/copilot/ZeroTimeoutContractTest.java index 524026e698..3d986566dc 100644 --- a/src/test/java/com/github/copilot/sdk/ZeroTimeoutContractTest.java +++ b/src/test/java/com/github/copilot/ZeroTimeoutContractTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk; +package com.github.copilot; import static org.junit.jupiter.api.Assertions.*; import static org.mockito.ArgumentMatchers.*; @@ -12,8 +12,8 @@ import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.generated.AssistantMessageEvent; -import com.github.copilot.sdk.json.MessageOptions; +import com.github.copilot.generated.AssistantMessageEvent; +import com.github.copilot.rpc.MessageOptions; /** * Verifies the documented contract that {@code timeoutMs <= 0} means "no diff --git a/src/test/java/com/github/copilot/sdk/generated/GeneratedEventTypesCoverageTest.java b/src/test/java/com/github/copilot/generated/GeneratedEventTypesCoverageTest.java similarity index 98% rename from src/test/java/com/github/copilot/sdk/generated/GeneratedEventTypesCoverageTest.java rename to src/test/java/com/github/copilot/generated/GeneratedEventTypesCoverageTest.java index 2e0b2ed094..28e2aba3b3 100644 --- a/src/test/java/com/github/copilot/sdk/generated/GeneratedEventTypesCoverageTest.java +++ b/src/test/java/com/github/copilot/generated/GeneratedEventTypesCoverageTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.generated; +package com.github.copilot.generated; import static org.junit.jupiter.api.Assertions.*; @@ -15,8 +15,8 @@ /** * Deserialization tests for generated session event types that are not covered - * in {@link com.github.copilot.sdk.SessionEventDeserializationTest}. Verifies - * that each event deserializes correctly from JSON and that the {@code type} + * in {@link com.github.copilot.SessionEventDeserializationTest}. Verifies that + * each event deserializes correctly from JSON and that the {@code type} * discriminator and {@code data} fields are accessible. */ public class GeneratedEventTypesCoverageTest { @@ -45,7 +45,7 @@ void testParseAssistantStreamingDeltaEvent() throws Exception { assertInstanceOf(AssistantStreamingDeltaEvent.class, event); assertEquals("assistant.streaming_delta", event.getType()); var typed = (AssistantStreamingDeltaEvent) event; - assertEquals(1024.0, typed.getData().totalResponseSizeBytes()); + assertEquals((Long) 1024L, typed.getData().totalResponseSizeBytes()); } // ── CapabilitiesChangedEvent ─────────────────────────────────────────── @@ -210,14 +210,14 @@ void testParseElicitationCompletedEventCancel() throws Exception { void testParseExitPlanModeRequestedEvent() throws Exception { var event = parse( """ - {"type":"exit_plan_mode.requested","data":{"requestId":"epm-1","summary":"Implement login","planContent":"# Plan\\n1. Create login","actions":["approve","edit","reject"],"recommendedAction":"approve"}} + {"type":"exit_plan_mode.requested","data":{"requestId":"epm-1","summary":"Implement login","planContent":"# Plan\\n1. Create login","actions":["exit_only","interactive","autopilot"],"recommendedAction":"interactive"}} """); assertInstanceOf(ExitPlanModeRequestedEvent.class, event); assertEquals("exit_plan_mode.requested", event.getType()); var typed = (ExitPlanModeRequestedEvent) event; assertEquals("epm-1", typed.getData().requestId()); assertEquals("Implement login", typed.getData().summary()); - assertEquals("approve", typed.getData().recommendedAction()); + assertEquals(ExitPlanModeAction.INTERACTIVE, typed.getData().recommendedAction()); assertEquals(3, typed.getData().actions().size()); } @@ -464,7 +464,7 @@ void testParseSessionMcpServersLoadedEvent() throws Exception { assertNotNull(typed.getData().servers()); assertEquals(1, typed.getData().servers().size()); assertEquals("mcp1", typed.getData().servers().get(0).name()); - assertEquals(McpServersLoadedServerStatus.CONNECTED, typed.getData().servers().get(0).status()); + assertEquals(McpServerStatus.CONNECTED, typed.getData().servers().get(0).status()); } @Test @@ -529,7 +529,7 @@ void testParseSessionSkillsLoadedEvent() throws Exception { assertEquals(1, typed.getData().skills().size()); var skill = typed.getData().skills().get(0); assertEquals("deploy", skill.name()); - assertEquals("project", skill.source()); + assertEquals(SkillSource.PROJECT, skill.source()); assertTrue(skill.userInvocable()); assertTrue(skill.enabled()); } @@ -699,6 +699,6 @@ void testSessionContextChangedHostTypeEnumFromValue() { @Test void testSessionMcpServersLoadedStatusEnumFromValue() { - assertThrows(IllegalArgumentException.class, () -> McpServersLoadedServerStatus.fromValue("unknown")); + assertThrows(IllegalArgumentException.class, () -> McpServerStatus.fromValue("unknown")); } } diff --git a/src/test/java/com/github/copilot/sdk/generated/rpc/GeneratedRpcApiCoverageTest.java b/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcApiCoverageTest.java similarity index 99% rename from src/test/java/com/github/copilot/sdk/generated/rpc/GeneratedRpcApiCoverageTest.java rename to src/test/java/com/github/copilot/generated/rpc/GeneratedRpcApiCoverageTest.java index 89943e3758..4bc1cc06bf 100644 --- a/src/test/java/com/github/copilot/sdk/generated/rpc/GeneratedRpcApiCoverageTest.java +++ b/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcApiCoverageTest.java @@ -2,7 +2,7 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import static org.junit.jupiter.api.Assertions.*; @@ -58,7 +58,7 @@ void serverRpc_sessionFs_setProvider_invokes_correct_method() { var stub = new StubCaller(); var server = new ServerRpc(stub); - var params = new SessionFsSetProviderParams("/workspace", "/state", null); + var params = new SessionFsSetProviderParams("/workspace", "/state", null, null); server.sessionFs.setProvider(params); assertEquals(1, stub.calls.size()); @@ -71,7 +71,7 @@ void serverRpc_sessions_fork_invokes_correct_method() { var stub = new StubCaller(); var server = new ServerRpc(stub); - var params = new SessionsForkParams("parent-session-id", null); + var params = new SessionsForkParams("parent-session-id", null, null); server.sessions.fork(params); assertEquals(1, stub.calls.size()); @@ -633,7 +633,7 @@ void sessionRpc_log_merges_sessionId() { var stub = new StubCaller(); var session = new SessionRpc(stub, "sess-log"); - var logParams = new SessionLogParams(null, "Hello from test", null, null, null); + var logParams = new SessionLogParams(null, "Hello from test", null, null, null, null, null); session.log(logParams); assertEquals(1, stub.calls.size()); @@ -649,15 +649,16 @@ void sessionRpc_log_merges_sessionId() { @Test void serverRpc_sessionFs_setProvider_params_record() { - var params = new SessionFsSetProviderParams("/workspace", "/state", null); + var params = new SessionFsSetProviderParams("/workspace", "/state", null, null); assertEquals("/workspace", params.initialCwd()); assertEquals("/state", params.sessionStatePath()); assertNull(params.conventions()); + assertNull(params.capabilities()); } @Test void sessionsForkParams_record() { - var params = new SessionsForkParams("parent-id", "event-123"); + var params = new SessionsForkParams("parent-id", "event-123", null); assertEquals("parent-id", params.sessionId()); assertEquals("event-123", params.toEventId()); } diff --git a/src/test/java/com/github/copilot/sdk/generated/rpc/GeneratedRpcRecordsCoverageTest.java b/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcRecordsCoverageTest.java similarity index 94% rename from src/test/java/com/github/copilot/sdk/generated/rpc/GeneratedRpcRecordsCoverageTest.java rename to src/test/java/com/github/copilot/generated/rpc/GeneratedRpcRecordsCoverageTest.java index 8e86bddf22..d34fa76b1b 100644 --- a/src/test/java/com/github/copilot/sdk/generated/rpc/GeneratedRpcRecordsCoverageTest.java +++ b/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcRecordsCoverageTest.java @@ -2,17 +2,18 @@ * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ -package com.github.copilot.sdk.generated.rpc; +package com.github.copilot.generated.rpc; import static org.junit.jupiter.api.Assertions.*; +import java.time.OffsetDateTime; import java.util.List; import java.util.Map; import java.util.UUID; import org.junit.jupiter.api.Test; -import com.github.copilot.sdk.TestUtil; +import com.github.copilot.TestUtil; /** * Tests for generated RPC param and result record types. Exercises @@ -32,9 +33,9 @@ void pingParams_record() { @Test void pingResult_record() { - var result = new PingResult("pong", 1234L, 2L); + var result = new PingResult("pong", null, 2L); assertEquals("pong", result.message()); - assertEquals(1234L, result.timestamp()); + assertNull(result.timestamp()); assertEquals(2L, result.protocolVersion()); } @@ -67,7 +68,7 @@ void toolsListParams_record() { @Test void sessionsForkParams_record() { - var params = new SessionsForkParams("sess-1", "event-abc"); + var params = new SessionsForkParams("sess-1", "event-abc", null); assertEquals("sess-1", params.sessionId()); assertEquals("event-abc", params.toEventId()); } @@ -246,7 +247,7 @@ void sessionHistoryTruncateParams_record() { @Test void sessionLogParams_record() { - var params = new SessionLogParams("sess-24", "test message", SessionLogLevel.INFO, false, null); + var params = new SessionLogParams("sess-24", "test message", SessionLogLevel.INFO, null, false, null, null); assertEquals("sess-24", params.sessionId()); assertEquals("test message", params.message()); assertEquals(SessionLogLevel.INFO, params.level()); @@ -320,10 +321,11 @@ void sessionModelGetCurrentParams_record() { @Test void sessionModelSwitchToParams_record() { - var params = new SessionModelSwitchToParams("sess-32", "claude-sonnet-4.5", "high", null); + var params = new SessionModelSwitchToParams("sess-32", "claude-sonnet-4.5", "high", null, null); assertEquals("sess-32", params.sessionId()); assertEquals("claude-sonnet-4.5", params.modelId()); assertEquals("high", params.reasoningEffort()); + assertNull(params.reasoningSummary()); assertNull(params.modelCapabilities()); } @@ -470,9 +472,10 @@ void sessionWorkspaceReadFileParams_record() { @Test void pingResult_fields() { - var result = new PingResult("pong", 9999L, 1L); + var ts = OffsetDateTime.now(); + var result = new PingResult("pong", ts, 1L); assertEquals("pong", result.message()); - assertEquals(9999L, result.timestamp()); + assertEquals(ts, result.timestamp()); assertEquals(1L, result.protocolVersion()); } @@ -483,21 +486,25 @@ void sessionAgentDeselectResult_empty() { @Test void sessionAgentListResult_with_items() { - var item = new AgentInfo("name1", "Name One", "Desc 1"); + var item = new AgentInfo("name1", "Name One", "Desc 1", "/path/to/agent1", null, null, null, null, null, null, + null); var result = new SessionAgentListResult(List.of(item)); assertEquals(1, result.agents().size()); assertEquals("name1", result.agents().get(0).name()); assertEquals("Name One", result.agents().get(0).displayName()); assertEquals("Desc 1", result.agents().get(0).description()); + assertEquals("/path/to/agent1", result.agents().get(0).path()); } @Test void sessionAgentGetCurrentResult_nested() { - var agent = new AgentInfo("agent-1", "Agent One", "Does things"); + var agent = new AgentInfo("agent-1", "Agent One", "Does things", null, null, null, null, null, null, null, + null); var result = new SessionAgentGetCurrentResult(agent); assertEquals("agent-1", result.agent().name()); assertEquals("Agent One", result.agent().displayName()); assertEquals("Does things", result.agent().description()); + assertNull(result.agent().path()); } @Test @@ -508,7 +515,7 @@ void sessionAgentGetCurrentResult_null_agent() { @Test void sessionAgentReloadResult_with_items() { - var item = new AgentInfo("a", "A", "Desc"); + var item = new AgentInfo("a", "A", "Desc", "/path/to/a", null, null, null, null, null, null, null); var result = new SessionAgentReloadResult(List.of(item)); assertEquals(1, result.agents().size()); assertEquals("a", result.agents().get(0).name()); @@ -516,7 +523,8 @@ void sessionAgentReloadResult_with_items() { @Test void sessionAgentSelectResult_nested() { - var agent = new AgentInfo("selected", "Selected", "The selected agent"); + var agent = new AgentInfo("selected", "Selected", "The selected agent", "/path/to/selected", null, null, null, + null, null, null, null); var result = new SessionAgentSelectResult(agent); assertEquals("selected", result.agent().name()); } @@ -635,7 +643,7 @@ void sessionFsStatResult_record() { @Test void sessionHistoryCompactResult_nested() { var ctx = new HistoryCompactContextWindow(100000L, 5000L, 20L, 1000L, 3000L, 500L); - var result = new SessionHistoryCompactResult(true, 2000L, 5L, ctx); + var result = new SessionHistoryCompactResult(true, 2000L, 5L, null, ctx); assertTrue(result.success()); assertEquals(2000L, result.tokensRemoved()); assertEquals(5L, result.messagesRemoved()); @@ -712,7 +720,7 @@ void sessionModeSetResult_enum() { @Test void sessionModelGetCurrentResult_record() { - var result = new SessionModelGetCurrentResult("claude-sonnet-4.5"); + var result = new SessionModelGetCurrentResult("claude-sonnet-4.5", null); assertEquals("claude-sonnet-4.5", result.modelId()); } @@ -783,17 +791,17 @@ void sessionSkillsEnableResult_empty() { @Test void sessionSkillsListResult_nested() { - var item = new Skill("deploy", "Deploy the app", "project", true, true, "/skills/deploy.md"); + var item = new Skill("deploy", "Deploy the app", SkillSource.PROJECT, true, true, "/skills/deploy.md", null); var result = new SessionSkillsListResult(List.of(item)); assertEquals(1, result.skills().size()); assertEquals("deploy", result.skills().get(0).name()); - assertEquals("project", result.skills().get(0).source()); + assertEquals(SkillSource.PROJECT, result.skills().get(0).source()); assertTrue(result.skills().get(0).enabled()); } @Test void sessionSkillsReloadResult_empty() { - assertNotNull(new SessionSkillsReloadResult()); + assertNotNull(new SessionSkillsReloadResult(null, null)); } @Test @@ -829,8 +837,8 @@ void sessionUiHandlePendingElicitationResult_record() { @Test void sessionUsageGetMetricsResult_nested() { - var changes = new UsageMetricsCodeChanges(100L, 50L, 5L); - var result = new SessionUsageGetMetricsResult(0.5, 10L, 2000.0, 1700000000000L, changes, null, "gpt-5", 1000L, + var changes = new UsageMetricsCodeChanges(100L, 50L, 5L, null); + var result = new SessionUsageGetMetricsResult(0.5, 10L, null, null, 2000L, null, changes, null, "gpt-5", 1000L, 500L); assertEquals(0.5, result.totalPremiumRequestCost()); assertEquals(10L, result.totalUserRequests()); @@ -861,7 +869,7 @@ void sessionWorkspaceReadFileResult_record() { @Test void sessionsForkResult_record() { - var result = new SessionsForkResult("forked-sess-id"); + var result = new SessionsForkResult("forked-sess-id", null); assertEquals("forked-sess-id", result.sessionId()); } @@ -869,7 +877,8 @@ void sessionsForkResult_record() { @Test void accountGetQuotaResult_nested() { - var snapshot = new AccountQuotaSnapshot(null, 100L, 40L, null, 60.0, 5.0, true, "2026-05-01"); + var snapshot = new AccountQuotaSnapshot(null, 100L, 40L, null, 60.0, 5.0, true, + java.time.OffsetDateTime.parse("2026-05-01T00:00:00Z")); var result = new AccountGetQuotaResult(Map.of("chat", snapshot)); assertEquals(1, result.quotaSnapshots().size()); var s = result.quotaSnapshots().get("chat"); @@ -878,7 +887,7 @@ void accountGetQuotaResult_nested() { assertEquals(60.0, s.remainingPercentage()); assertEquals(5.0, s.overage()); assertTrue(s.overageAllowedWithExhaustedQuota()); - assertEquals("2026-05-01", s.resetDate()); + assertEquals(java.time.OffsetDateTime.parse("2026-05-01T00:00:00Z"), s.resetDate()); } @Test @@ -890,13 +899,13 @@ void mcpConfigListResult_record() { @Test void mcpDiscoverResult_nested() { - var server = new DiscoveredMcpServer("discovered-server", DiscoveredMcpServerType.STDIO, - DiscoveredMcpServerSource.USER, true); + var server = new DiscoveredMcpServer("discovered-server", DiscoveredMcpServerType.STDIO, McpServerSource.USER, + true); var result = new McpDiscoverResult(List.of(server)); assertEquals(1, result.servers().size()); assertEquals("discovered-server", result.servers().get(0).name()); assertEquals(DiscoveredMcpServerType.STDIO, result.servers().get(0).type()); - assertEquals(DiscoveredMcpServerSource.USER, result.servers().get(0).source()); + assertEquals(McpServerSource.USER, result.servers().get(0).source()); assertTrue(result.servers().get(0).enabled()); } @@ -914,9 +923,9 @@ void modelsListResult_nested() { var supports = new ModelCapabilitiesSupports(true, false); var limits = new ModelCapabilitiesLimits(100000L, 8192L, 128000L, null); var capabilities = new ModelCapabilities(supports, limits); - var policy = new ModelPolicy("active", null); - var billing = new ModelBilling(1.0); - var modelItem = new Model("gpt-5", "GPT-5", capabilities, policy, billing, null, null); + var policy = new ModelPolicy(ModelPolicyState.ENABLED, null); + var billing = new ModelBilling(1.0, null); + var modelItem = new Model("gpt-5", "GPT-5", capabilities, policy, billing, null, null, null, null); var result = new ModelsListResult(List.of(modelItem)); assertEquals(1, result.models().size()); @@ -925,7 +934,7 @@ void modelsListResult_nested() { assertTrue(result.models().get(0).capabilities().supports().vision()); assertFalse(result.models().get(0).capabilities().supports().reasoningEffort()); assertEquals(100000L, result.models().get(0).capabilities().limits().maxPromptTokens()); - assertEquals("active", result.models().get(0).policy().state()); + assertEquals(ModelPolicyState.ENABLED, result.models().get(0).policy().state()); assertEquals(Double.valueOf(1.0), result.models().get(0).billing().multiplier()); } @@ -948,7 +957,7 @@ void sessionModelSwitchToParams_nested_records() { var limits = new ModelCapabilitiesOverrideLimits(100000L, 8192L, 128000L, limitsVision); var supports = new ModelCapabilitiesOverrideSupports(true, true); var capabilities = new ModelCapabilitiesOverride(supports, limits); - var params = new SessionModelSwitchToParams("sess-m", "gpt-5", null, capabilities); + var params = new SessionModelSwitchToParams("sess-m", "gpt-5", null, null, capabilities); assertEquals("gpt-5", params.modelId()); assertNotNull(params.modelCapabilities()); diff --git a/src/test/resources/logging-debug.properties b/src/test/resources/logging-debug.properties index 096ed002e7..d461aa1e3c 100644 --- a/src/test/resources/logging-debug.properties +++ b/src/test/resources/logging-debug.properties @@ -15,7 +15,7 @@ java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter java.util.logging.SimpleFormatter.format=%1$tF %1$tT.%1$tL %4$-7s [%3$s] %5$s%6$s%n # Set FINE level for Copilot SDK classes -com.github.copilot.sdk.level=FINE +com.github.copilot.level=FINE # Root logger level .level=INFO diff --git a/src/test/resources/logging.properties b/src/test/resources/logging.properties index d294b56610..6aff48d466 100644 --- a/src/test/resources/logging.properties +++ b/src/test/resources/logging.properties @@ -3,6 +3,6 @@ java.util.logging.ConsoleHandler.level=INFO java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter java.util.logging.SimpleFormatter.format=%1$tF %1$tT.%1$tL %4$-7s [%3$s] %5$s%6$s%n -com.github.copilot.sdk.level=INFO +com.github.copilot.level=INFO .level=INFO