Add Java SDK cookbook with 7 recipes#1313
Merged
brunoborges merged 3 commits intogithub:mainfrom Apr 6, 2026
Merged
Conversation
Add complete Java cookbook matching the pattern of existing .NET, Go, Node.js, and Python cookbooks. All 7 recipes included: - Ralph Loop: Autonomous AI task loops with JBang - Error Handling: try-with-resources, ExecutionException, timeouts - Multiple Sessions: Parallel sessions with CompletableFuture - Managing Local Files: AI-powered file organization - PR Visualization: Interactive PR age charts - Persisting Sessions: Save/resume with custom IDs - Accessibility Report: WCAG reports via Playwright MCP Each recipe includes both markdown documentation and a standalone JBang-runnable Java file in recipe/.
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
main, but PRs should target staged.
The main branch is auto-published from staged and should not receive direct PRs.
Please close this PR and re-open it against the staged branch.
You can change the base branch using the Edit button at the top of this PR,
or run: gh pr edit 1313 --base staged
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new Java section to the Copilot SDK cookbook, including Java-language recipe docs and runnable JBang-based examples, to align Java coverage with the existing .NET/Go/Node.js/Python cookbooks.
Changes:
- Added a full Java cookbook section with 7 recipe markdown docs under
cookbook/copilot-sdk/java/. - Added 7 runnable JBang Java scripts under
cookbook/copilot-sdk/java/recipe/. - Updated top-level cookbook READMEs to include Java and updated language count.
Show a summary per file
| File | Description |
|---|---|
| cookbook/README.md | Adds Java to the cookbook language list for the Copilot SDK cookbook. |
| cookbook/copilot-sdk/README.md | Adds Java recipe links + Java “Running Examples” instructions + updates supported language count. |
| cookbook/copilot-sdk/java/README.md | New Java cookbook landing page with recipe index. |
| cookbook/copilot-sdk/java/recipe/README.md | New guide for running Java examples via JBang. |
| cookbook/copilot-sdk/java/ralph-loop.md | New Java Ralph Loop recipe documentation. |
| cookbook/copilot-sdk/java/error-handling.md | New Java error handling patterns documentation. |
| cookbook/copilot-sdk/java/multiple-sessions.md | New Java multi-session patterns documentation. |
| cookbook/copilot-sdk/java/managing-local-files.md | New Java local file organization recipe documentation. |
| cookbook/copilot-sdk/java/pr-visualization.md | New Java PR visualization recipe documentation. |
| cookbook/copilot-sdk/java/persisting-sessions.md | New Java session persistence documentation. |
| cookbook/copilot-sdk/java/accessibility-report.md | New Java accessibility reporting recipe documentation. |
| cookbook/copilot-sdk/java/recipe/RalphLoop.java | Runnable JBang script implementing a basic Ralph loop. |
| cookbook/copilot-sdk/java/recipe/ErrorHandling.java | Runnable JBang script demonstrating basic error handling. |
| cookbook/copilot-sdk/java/recipe/MultipleSessions.java | Runnable JBang script demonstrating parallel sessions. |
| cookbook/copilot-sdk/java/recipe/ManagingLocalFiles.java | Runnable JBang script demonstrating file grouping (dry-run style). |
| cookbook/copilot-sdk/java/recipe/PRVisualization.java | Runnable JBang script for PR-age visualization using MCP tools. |
| cookbook/copilot-sdk/java/recipe/PersistingSessions.java | Runnable JBang script for creating a session with a stable ID. |
| cookbook/copilot-sdk/java/recipe/AccessibilityReport.java | Runnable JBang script using Playwright MCP for WCAG reporting + optional test generation. |
Copilot's findings
- Files reviewed: 18/18 changed files
- Comments generated: 9
Comment on lines
+96
to
+101
| session.send(new MessageOptions().setPrompt(prompt)); | ||
|
|
||
| // Wait a bit for initial processing | ||
| Thread.sleep(10000); | ||
|
|
||
| // Interactive loop |
There was a problem hiding this comment.
This recipe uses fixed Thread.sleep(...) delays after sending messages. That makes the CLI behavior timing-dependent (responses can take longer or shorter than the sleep), and can lead to missing/partial output or awkward interleaving. Prefer waiting on SessionIdleEvent (like the other Java recipes do with a CountDownLatch) or using sendAndWait(...) for requests where you need completion before continuing.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
- Replace Thread.sleep with sendAndWait in PRVisualization - Fix top-level statements in multiple-sessions.md (wrap in class) - Fix .getMessage() → .getData().content() in MultipleSessions.java - Guard against null readLine() in AccessibilityReport.java - Add null-safe getCause() + InterruptedException handling in ErrorHandling.java - Fix paths: jbang commands now include recipe/ prefix - Fix root README path: cd java/recipe (not java/cookbook/recipe) - Fix recipe/README.md ralph-loop CLI example
This was referenced Apr 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a complete Java cookbook to the Copilot SDK cookbook collection, matching the structure and coverage of the existing .NET, Go, Node.js, and Python cookbooks.
What's included
7 recipe documentation files (
cookbook/copilot-sdk/java/*.md)7 runnable recipe files (
cookbook/copilot-sdk/java/recipe/*.java)All examples are standalone JBang scripts — no project setup required:
README updates
cookbook/copilot-sdk/java/README.md— Language README with recipe indexcookbook/copilot-sdk/java/recipe/README.md— Runnable examples guidecookbook/copilot-sdk/README.md— Added Java section + updated language countcookbook/README.md— Added Java to language listJava SDK specifics
com.github:copilot-sdk-java:0.2.1-java.1(Maven coordinates)//DEPSinline dependency declaration)Stats