[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7529C4KXMCY39SYA2HGMDTH":3,"skill-same:01M7529C4KXMCY39SYA2HGMDTH":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7529C4KXMCY39SYA2HGMDTH","java-coding-skill",null,"Use this skill whenever editing `*.java` files in the `java\u002F` SDK in order to write idiomatic, well-structured Java code for the Copilot SDK","review-bench\u002Fgithub_copilot-sdk","review-bench","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F286778065?v=4","01M7517F9NTEPDZDAXJBR30FWT","ReviewBench","01M7528XAPJMCHT2F9YHNWHYXT",0,"MIT","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Fgithub_copilot-sdk\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fjava-coding-skill\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: java-coding-skill\ndescription: \"Use this skill whenever editing `*.java` files in the `java\u002F` SDK in order to write idiomatic, well-structured Java code for the Copilot SDK\"\n---\n\n# Java Coding Skill\n\n## Core Principles\n\n- The SDK is in public preview and may have breaking changes\n- Requires Java 17 or later\n- Requires GitHub Copilot CLI installed and in PATH\n- Uses `CompletableFuture` for all async operations\n- Implements `AutoCloseable` for resource cleanup (try-with-resources)\n\n## Installation\n\n### Maven\n\n```xml\n\u003Cdependency>\n    \u003CgroupId>com.github\u003C\u002FgroupId>\n    \u003CartifactId>copilot-sdk-java\u003C\u002FartifactId>\n    \u003Cversion>${copilot-sdk-java.version}\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\n### Gradle\n\n```groovy\nimplementation \"com.github:copilot-sdk-java:${copilotSdkJavaVersion}\"\n```\n\n## Client Initialization\n\n### Basic Client Setup\n\n```java\ntry (var client = new CopilotClient()) {\n    client.start().get();\n    \u002F\u002F Use client...\n}\n```\n\n### Client Configuration Options\n\nWhen creating a CopilotClient, use `CopilotClientOptions`:\n\n- `cliPath` - Path to CLI executable (default: \"copilot\" from PATH)\n- `cliArgs` - Extra arguments prepended before SDK-managed flags\n- `cliUrl` - URL of existing CLI server (e.g., \"localhost:8080\"). When provided, client won't spawn a process\n- `port` - Server port (default: 0 for random, only when `useStdio` is false)\n- `useStdio` - Use stdio transport instead of TCP (default: true)\n- `logLevel` - Log level: \"error\", \"warn\", \"info\", \"debug\", \"trace\" (default: \"info\")\n- `autoStart` - Auto-start server on first request (default: true)\n- `autoRestart` - Auto-restart on crash (default: true)\n- `cwd` - Working directory for the CLI process\n- `environment` - Environment variables for the CLI process\n- `gitHubToken` - GitHub token for authentication\n- `useLoggedInUser` - Use logged-in `gh` CLI auth (default: true unless token provided)\n- `onListModels` - Custom model list handler for BYOK scenarios\n\n```java\nvar options = new CopilotClientOptions()\n    .setCliPath(\"\u002Fpath\u002Fto\u002Fcopilot\")\n    .setLogLevel(\"debug\")\n    .setAutoStart(true)\n    .setAutoRestart(true)\n    .setGitHubToken(System.getenv(\"GITHUB_TOKEN\"));\n\ntry (var client = new CopilotClient(options)) {\n    client.start().get();\n    \u002F\u002F Use client...\n}\n```\n\n### Manual Server Control\n\nFor explicit control:\n```java\nvar client = new CopilotClient(new CopilotClientOptions().setAutoStart(false));\nclient.start().get();\n\u002F\u002F Use client...\nclient.stop().get();\n```\n\nUse `forceStop()` when `stop()` takes too long.\n\n## Session Management\n\n### Creating Sessions\n\nUse `SessionConfig` for configuration. The permission handler is **required**:\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setStreaming(true)\n    .setTools(List.of(...))\n    .setSystemMessage(new SystemMessageConfig()\n        .setMode(SystemMessageMode.APPEND)\n        .setContent(\"Custom instructions\"))\n    .setAvailableTools(List.of(\"tool1\", \"tool2\"))\n    .setExcludedTools(List.of(\"tool3\"))\n    .setProvider(new ProviderConfig().setType(\"openai\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Session Config Options\n\n- `sessionId` - Custom session ID\n- `clientName` - Application name\n- `model` - Model name (\"gpt-5\", \"claude-sonnet-4.5\", etc.)\n- `reasoningEffort` - \"low\", \"medium\", \"high\", \"xhigh\"\n- `tools` - Custom tools exposed to the CLI\n- `systemMessage` - System message customization\n- `availableTools` - Allowlist of tool names\n- `excludedTools` - Blocklist of tool names\n- `provider` - Custom API provider configuration (BYOK)\n- `streaming` - Enable streaming response chunks (default: false)\n- `workingDirectory` - Session working directory\n- `mcpServers` - MCP server configurations\n- `customAgents` - Custom agent configurations\n- `agent` - Pre-select agent by name\n- `infiniteSessions` - Infinite sessions configuration\n- `skillDirectories` - Skill SKILL.md directories\n- `disabledSkills` - Skills to disable\n- `configDir` - Config directory path\n- `hooks` - Session lifecycle hooks\n- `onPermissionRequest` - **REQUIRED** permission handler\n- `onUserInputRequest` - User input handler\n- `onEvent` - Event handler registered before session creation\n\nAll setters return `SessionConfig` for method chaining.\n\n### Resuming Sessions\n\n```java\nvar session = client.resumeSession(sessionId, new ResumeSessionConfig()\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Session Operations\n\n- `session.getSessionId()` - Get session identifier\n- `session.send(prompt)` \u002F `session.send(MessageOptions)` - Send message, returns message ID\n- `session.sendAndWait(prompt)` \u002F `session.sendAndWait(MessageOptions)` - Send and wait for response (60s timeout)\n- `session.sendAndWait(options, timeoutMs)` - Send and wait with custom timeout\n- `session.abort()` - Abort current processing\n- `session.getMessages()` - Get all events\u002Fmessages\n- `session.setModel(modelId)` - Switch to a different model\n- `session.log(message)` \u002F `session.log(message, \"warning\", false)` \u002F `session.log(message, \"error\", false)` - Log to session timeline with level `\"info\"`, `\"warning\"`, or `\"error\"`\n- `session.close()` - Clean up resources\n\n## Event Handling\n\n### Event Subscription Pattern\n\nUse `CompletableFuture` for waiting on session events:\n\n```java\nvar done = new CompletableFuture\u003CVoid>();\n\nsession.on(event -> {\n    if (event instanceof AssistantMessageEvent msg) {\n        System.out.println(msg.getData().content());\n    } else if (event instanceof SessionIdleEvent) {\n        done.complete(null);\n    }\n});\n\nsession.send(new MessageOptions().setPrompt(\"Hello\"));\ndone.get();\n```\n\n### Type-Safe Event Handling\n\nUse the typed `on()` overload for compile-time safety:\n\n```java\nsession.on(AssistantMessageEvent.class, msg -> {\n    System.out.println(msg.getData().content());\n});\n\nsession.on(SessionIdleEvent.class, idle -> {\n    done.complete(null);\n});\n```\n\n### Unsubscribing from Events\n\nThe `on()` method returns a `Closeable`:\n\n```java\nvar subscription = session.on(event -> { \u002F* handler *\u002F });\n\u002F\u002F Later...\nsubscription.close();\n```\n\n### Event Types\n\nUse pattern matching (Java 17+) for event handling:\n\n```java\nsession.on(event -> {\n    if (event instanceof UserMessageEvent userMsg) {\n        \u002F\u002F Handle user message\n    } else if (event instanceof AssistantMessageEvent assistantMsg) {\n        System.out.println(assistantMsg.getData().content());\n    } else if (event instanceof AssistantMessageDeltaEvent delta) {\n        System.out.print(delta.getData().deltaContent());\n    } else if (event instanceof ToolExecutionStartEvent toolStart) {\n        \u002F\u002F Tool execution started\n    } else if (event instanceof ToolExecutionCompleteEvent toolComplete) {\n        \u002F\u002F Tool execution completed\n    } else if (event instanceof SessionStartEvent start) {\n        \u002F\u002F Session started\n    } else if (event instanceof SessionIdleEvent idle) {\n        \u002F\u002F Session is idle (processing complete)\n    } else if (event instanceof SessionErrorEvent error) {\n        System.err.println(\"Error: \" + error.getData().message());\n    }\n});\n```\n\n### Event Error Handling\n\nControl how errors in event handlers are handled:\n\n```java\n\u002F\u002F Set a custom error handler\nsession.setEventErrorHandler(ex -> {\n    logger.error(\"Event handler error\", ex);\n});\n\n\u002F\u002F Or set the error propagation policy\nsession.setEventErrorPolicy(EventErrorPolicy.SUPPRESS_AND_LOG_ERRORS);\n```\n\n## Streaming Responses\n\n### Enabling Streaming\n\nSet `streaming(true)` in SessionConfig:\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setStreaming(true)\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Handling Streaming Events\n\nHandle both delta events (incremental) and final events:\n\n```java\nvar done = new CompletableFuture\u003CVoid>();\n\nsession.on(event -> {\n    switch (event) {\n        case AssistantMessageDeltaEvent delta ->\n            \u002F\u002F Incremental text chunk\n            System.out.print(delta.getData().deltaContent());\n        case AssistantReasoningDeltaEvent reasoningDelta ->\n            \u002F\u002F Incremental reasoning chunk (model-dependent)\n            System.out.print(reasoningDelta.getData().deltaContent());\n        case AssistantMessageEvent msg ->\n            \u002F\u002F Final complete message\n            System.out.println(\"\\n--- Final ---\\n\" + msg.getData().content());\n        case AssistantReasoningEvent reasoning ->\n            \u002F\u002F Final reasoning content\n            System.out.println(\"--- Reasoning ---\\n\" + reasoning.getData().content());\n        case SessionIdleEvent idle ->\n            done.complete(null);\n        default -> { }\n    }\n});\n\nsession.send(new MessageOptions().setPrompt(\"Tell me a story\"));\ndone.get();\n```\n\nNote: Final events (`AssistantMessageEvent`, `AssistantReasoningEvent`) are ALWAYS sent regardless of streaming setting.\n\n## Custom Tools\n\n### Defining Tools\n\nUse `ToolDefinition.create()` with JSON Schema parameters and a `ToolHandler`:\n\n```java\nvar tool = ToolDefinition.create(\n    \"get_weather\",\n    \"Get weather for a location\",\n    Map.of(\n        \"type\", \"object\",\n        \"properties\", Map.of(\n            \"location\", Map.of(\"type\", \"string\", \"description\", \"City name\")\n        ),\n        \"required\", List.of(\"location\")\n    ),\n    invocation -> {\n        String location = (String) invocation.getArguments().get(\"location\");\n        return CompletableFuture.completedFuture(\"Sunny in \" + location);\n    }\n);\n\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setTools(List.of(tool))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Type-Safe Tool Arguments\n\nUse `getArgumentsAs()` for deserialization into a typed record or class:\n\n```java\nrecord WeatherArgs(String location, String unit) {}\n\nvar tool = ToolDefinition.create(\n    \"get_weather\",\n    \"Get weather for a location\",\n    Map.of(\n        \"type\", \"object\",\n        \"properties\", Map.of(\n            \"location\", Map.of(\"type\", \"string\"),\n            \"unit\", Map.of(\"type\", \"string\", \"enum\", List.of(\"celsius\", \"fahrenheit\"))\n        ),\n        \"required\", List.of(\"location\")\n    ),\n    invocation -> {\n        var args = invocation.getArgumentsAs(WeatherArgs.class);\n        return CompletableFuture.completedFuture(\n            Map.of(\"temp\", 72, \"unit\", args.unit(), \"location\", args.location())\n        );\n    }\n);\n```\n\n### Overriding Built-In Tools\n\n```java\nvar override = ToolDefinition.createOverride(\n    \"built_in_tool_name\",\n    \"Custom description\",\n    Map.of(\"type\", \"object\", \"properties\", Map.of(...)),\n    invocation -> CompletableFuture.completedFuture(\"custom result\")\n);\n```\n\n### Tool Return Types\n\n- Return any JSON-serializable value (String, Map, List, record, POJO)\n- The SDK automatically serializes the return value and sends it back to the CLI\n\n### Tool Execution Flow\n\nWhen Copilot invokes a tool, the client automatically:\n1. Deserializes the arguments\n2. Runs your handler function\n3. Serializes the return value\n4. Responds to the CLI\n\n## Permission Handling\n\n### Required Permission Handler\n\nA permission handler is **mandatory** when creating or resuming sessions:\n\n```java\n\u002F\u002F Approve all requests (for development\u002Ftesting)\nnew SessionConfig()\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n\n\u002F\u002F Custom permission logic\nnew SessionConfig()\n    .setOnPermissionRequest((request, invocation) -> {\n        if (\"dangerous-action\".equals(request.getKind())) {\n            return CompletableFuture.completedFuture(\n                new PermissionRequestResult().setKind(PermissionRequestResultKind.DENIED)\n            );\n        }\n        return CompletableFuture.completedFuture(\n            new PermissionRequestResult().setKind(PermissionRequestResultKind.APPROVED)\n        );\n    })\n```\n\n## User Input Handling\n\nHandle user input requests from the agent:\n\n```java\nnew SessionConfig()\n    .setOnUserInputRequest((request, invocation) -> {\n        System.out.println(\"Agent asks: \" + request.getQuestion());\n        String answer = scanner.nextLine();\n        return CompletableFuture.completedFuture(\n            new UserInputResponse()\n                .setAnswer(answer)\n                .setWasFreeform(true)\n        );\n    })\n```\n\n## System Message Customization\n\n### Append Mode (Default - Preserves Guardrails)\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setSystemMessage(new SystemMessageConfig()\n        .setMode(SystemMessageMode.APPEND)\n        .setContent(\"\"\"\n            \u003Cworkflow_rules>\n            - Always check for security vulnerabilities\n            - Suggest performance improvements when applicable\n            \u003C\u002Fworkflow_rules>\n            \"\"\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Replace Mode (Full Control - Removes Guardrails)\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setSystemMessage(new SystemMessageConfig()\n        .setMode(SystemMessageMode.REPLACE)\n        .setContent(\"You are a helpful assistant.\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n## File Attachments\n\nAttach files to messages using `Attachment`:\n\n```java\nsession.send(new MessageOptions()\n    .setPrompt(\"Analyze this file\")\n    .setAttachments(List.of(\n        new Attachment(\"file\", \"\u002Fpath\u002Fto\u002Ffile.java\", \"My File\")\n    ))\n);\n```\n\n## Message Delivery Modes\n\nUse the `mode` property in `MessageOptions`:\n\n- `\"enqueue\"` - Queue message for processing (default)\n- `\"immediate\"` - Process message immediately\n\n```java\nsession.send(new MessageOptions()\n    .setPrompt(\"...\")\n    .setMode(\"enqueue\")\n);\n```\n\n## Convenience: Send and Wait\n\nUse `sendAndWait()` to send a message and block until the assistant responds:\n\n```java\n\u002F\u002F With default 60-second timeout\nAssistantMessageEvent response = session.sendAndWait(\"What is 2+2?\").get();\nSystem.out.println(response.getData().content());\n\n\u002F\u002F With custom timeout\nAssistantMessageEvent response = session.sendAndWait(\n    new MessageOptions().setPrompt(\"Write a long story\"),\n    120_000  \u002F\u002F 120 seconds\n).get();\n```\n\n## Multiple Sessions\n\nSessions are independent and can run concurrently:\n\n```java\nvar session1 = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n\nvar session2 = client.createSession(new SessionConfig()\n    .setModel(\"claude-sonnet-4.5\")\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n\nsession1.send(new MessageOptions().setPrompt(\"Hello from session 1\"));\nsession2.send(new MessageOptions().setPrompt(\"Hello from session 2\"));\n```\n\n## Bring Your Own Key (BYOK)\n\nUse custom API providers via `ProviderConfig`:\n\n```java\n\u002F\u002F OpenAI\nvar session = client.createSession(new SessionConfig()\n    .setProvider(new ProviderConfig()\n        .setType(\"openai\")\n        .setBaseUrl(\"https:\u002F\u002Fapi.openai.com\u002Fv1\")\n        .setApiKey(\"sk-...\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n\n\u002F\u002F Azure OpenAI\nvar session = client.createSession(new SessionConfig()\n    .setProvider(new ProviderConfig()\n        .setType(\"azure\")\n        .setAzure(new AzureOptions()\n            .setEndpoint(\"https:\u002F\u002Fmy-resource.openai.azure.com\")\n            .setDeployment(\"gpt-4\"))\n        .setBearerToken(\"...\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n## Session Lifecycle Management\n\n### Listing Sessions\n\n```java\nvar sessions = client.listSessions().get();\nfor (var metadata : sessions) {\n    System.out.println(\"Session: \" + metadata.getSessionId());\n}\n```\n\n### Deleting Sessions\n\n```java\nclient.deleteSession(sessionId).get();\n```\n\n### Checking Connection State\n\n```java\nvar state = client.getState();\n```\n\n### Lifecycle Event Subscription\n\n```java\nAutoCloseable subscription = client.onLifecycle(event -> {\n    System.out.println(\"Lifecycle event: \" + event);\n});\n\u002F\u002F Later...\nsubscription.close();\n```\n\n## Error Handling\n\n### Standard Exception Handling\n\n```java\ntry {\n    var session = client.createSession(new SessionConfig()\n        .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n    ).get();\n    session.sendAndWait(\"Hello\").get();\n} catch (ExecutionException ex) {\n    Throwable cause = ex.getCause();\n    System.err.println(\"Error: \" + cause.getMessage());\n} catch (Exception ex) {\n    System.err.println(\"Error: \" + ex.getMessage());\n}\n```\n\n### Session Error Events\n\nMonitor `SessionErrorEvent` for runtime errors:\n\n```java\nsession.on(SessionErrorEvent.class, error -> {\n    System.err.println(\"Session Error: \" + error.getData().message());\n});\n```\n\n## Connectivity Testing\n\nUse `ping()` to verify server connectivity:\n\n```java\nvar response = client.ping(\"test message\").get();\n```\n\n## Status and Authentication\n\n```java\n\u002F\u002F Get CLI version and protocol info\nvar status = client.getStatus().get();\n\n\u002F\u002F Check authentication status\nvar authStatus = client.getAuthStatus().get();\n\n\u002F\u002F List available models\nvar models = client.listModels().get();\n```\n\n## Resource Cleanup\n\n### Automatic Cleanup with try-with-resources\n\nALWAYS use try-with-resources for automatic disposal:\n\n```java\ntry (var client = new CopilotClient()) {\n    client.start().get();\n    try (var session = client.createSession(new SessionConfig()\n            .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get()) {\n        \u002F\u002F Use session...\n    }\n}\n\u002F\u002F Resources automatically cleaned up\n```\n\n### Manual Cleanup\n\nIf not using try-with-resources:\n\n```java\nvar client = new CopilotClient();\ntry {\n    client.start().get();\n    \u002F\u002F Use client...\n} finally {\n    client.stop().get();\n}\n```\n\n## Best Practices\n\n1. **Always use try-with-resources** for `CopilotClient` and `CopilotSession`\n2. **Always provide a permission handler** - it is required for `createSession` and `resumeSession`\n3. **Use `CompletableFuture`** properly - call `.get()` to block, or chain with `.thenApply()`\u002F`.thenCompose()`\n4. **Use `sendAndWait()`** for simple request-response patterns instead of manual event handling\n5. **Handle `SessionErrorEvent`** for robust error handling\n6. **Use pattern matching** (switch with sealed types) for event handling\n7. **Enable streaming** for better UX in interactive scenarios\n8. **Close event subscriptions** (`Closeable`) when no longer needed\n9. **Use `SystemMessageMode.APPEND`** to preserve safety guardrails\n10. **Provide descriptive tool names and descriptions** for better model understanding\n11. **Handle both delta and final events** when streaming is enabled\n12. **Use `getArgumentsAs()`** for type-safe tool argument deserialization\n\n## Common Patterns\n\n### Simple Query-Response\n\n```java\ntry (var client = new CopilotClient()) {\n    client.start().get();\n\n    try (var session = client.createSession(new SessionConfig()\n            .setModel(\"gpt-5\")\n            .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get()) {\n\n        var response = session.sendAndWait(\"What is 2+2?\").get();\n        System.out.println(response.getData().content());\n    }\n}\n```\n\n### Event-Driven Conversation\n\n```java\ntry (var client = new CopilotClient()) {\n    client.start().get();\n\n    try (var session = client.createSession(new SessionConfig()\n            .setModel(\"gpt-5\")\n            .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get()) {\n\n        var done = new CompletableFuture\u003CVoid>();\n\n        session.on(AssistantMessageEvent.class, msg ->\n            System.out.println(msg.getData().content()));\n\n        session.on(SessionIdleEvent.class, idle ->\n            done.complete(null));\n\n        session.send(new MessageOptions().setPrompt(\"What is 2+2?\"));\n        done.get();\n    }\n}\n```\n\n### Multi-Turn Conversation\n\n```java\ntry (var session = client.createSession(new SessionConfig()\n        .setModel(\"gpt-5\")\n        .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get()) {\n\n    var response1 = session.sendAndWait(\"What is the capital of France?\").get();\n    System.out.println(response1.getData().content());\n\n    var response2 = session.sendAndWait(\"What is its population?\").get();\n    System.out.println(response2.getData().content());\n}\n```\n\n### Tool with Complex Return Type\n\n```java\nrecord UserInfo(String id, String name, String email, String role) {}\n\nvar tool = ToolDefinition.create(\n    \"get_user\",\n    \"Retrieve user information\",\n    Map.of(\n        \"type\", \"object\",\n        \"properties\", Map.of(\n            \"userId\", Map.of(\"type\", \"string\", \"description\", \"User ID\")\n        ),\n        \"required\", List.of(\"userId\")\n    ),\n    invocation -> {\n        String userId = (String) invocation.getArguments().get(\"userId\");\n        return CompletableFuture.completedFuture(\n            new UserInfo(userId, \"John Doe\", \"john@example.com\", \"Developer\")\n        );\n    }\n);\n```\n\n### Session Hooks\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n    .setHooks(new SessionHooks()\n        .setOnPreToolUse((input, invocation) -> {\n            System.out.println(\"About to execute tool: \" + input);\n            var decision = new PreToolUseHookOutput().setKind(\"allow\");\n            return CompletableFuture.completedFuture(decision);\n        })\n        .setOnPostToolUse((output, invocation) -> {\n            System.out.println(\"Tool execution complete: \" + output);\n            return CompletableFuture.completedFuture(null);\n        }))\n).get();\n```\n","# Java Coding Skill\n\n## Core Principles\n\n- The SDK is in public preview and may have breaking changes\n- Requires Java 17 or later\n- Requires GitHub Copilot CLI installed and in PATH\n- Uses `CompletableFuture` for all async operations\n- Implements `AutoCloseable` for resource cleanup (try-with-resources)\n\n## Installation\n\n### Maven\n\n```xml\n\u003Cdependency>\n    \u003CgroupId>com.github\u003C\u002FgroupId>\n    \u003CartifactId>copilot-sdk-java\u003C\u002FartifactId>\n    \u003Cversion>${copilot-sdk-java.version}\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\n### Gradle\n\n```groovy\nimplementation \"com.github:copilot-sdk-java:${copilotSdkJavaVersion}\"\n```\n\n## Client Initialization\n\n### Basic Client Setup\n\n```java\ntry (var client = new CopilotClient()) {\n    client.start().get();\n    \u002F\u002F Use client...\n}\n```\n\n### Client Configuration Options\n\nWhen creating a CopilotClient, use `CopilotClientOptions`:\n\n- `cliPath` - Path to CLI executable (default: \"copilot\" from PATH)\n- `cliArgs` - Extra arguments prepended before SDK-managed flags\n- `cliUrl` - URL of existing CLI server (e.g., \"localhost:8080\"). When provided, client won't spawn a process\n- `port` - Server port (default: 0 for random, only when `useStdio` is false)\n- `useStdio` - Use stdio transport instead of TCP (default: true)\n- `logLevel` - Log level: \"error\", \"warn\", \"info\", \"debug\", \"trace\" (default: \"info\")\n- `autoStart` - Auto-start server on first request (default: true)\n- `autoRestart` - Auto-restart on crash (default: true)\n- `cwd` - Working directory for the CLI process\n- `environment` - Environment variables for the CLI process\n- `gitHubToken` - GitHub token for authentication\n- `useLoggedInUser` - Use logged-in `gh` CLI auth (default: true unless token provided)\n- `onListModels` - Custom model list handler for BYOK scenarios\n\n```java\nvar options = new CopilotClientOptions()\n    .setCliPath(\"\u002Fpath\u002Fto\u002Fcopilot\")\n    .setLogLevel(\"debug\")\n    .setAutoStart(true)\n    .setAutoRestart(true)\n    .setGitHubToken(System.getenv(\"GITHUB_TOKEN\"));\n\ntry (var client = new CopilotClient(options)) {\n    client.start().get();\n    \u002F\u002F Use client...\n}\n```\n\n### Manual Server Control\n\nFor explicit control:\n```java\nvar client = new CopilotClient(new CopilotClientOptions().setAutoStart(false));\nclient.start().get();\n\u002F\u002F Use client...\nclient.stop().get();\n```\n\nUse `forceStop()` when `stop()` takes too long.\n\n## Session Management\n\n### Creating Sessions\n\nUse `SessionConfig` for configuration. The permission handler is **required**:\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setStreaming(true)\n    .setTools(List.of(...))\n    .setSystemMessage(new SystemMessageConfig()\n        .setMode(SystemMessageMode.APPEND)\n        .setContent(\"Custom instructions\"))\n    .setAvailableTools(List.of(\"tool1\", \"tool2\"))\n    .setExcludedTools(List.of(\"tool3\"))\n    .setProvider(new ProviderConfig().setType(\"openai\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Session Config Options\n\n- `sessionId` - Custom session ID\n- `clientName` - Application name\n- `model` - Model name (\"gpt-5\", \"claude-sonnet-4.5\", etc.)\n- `reasoningEffort` - \"low\", \"medium\", \"high\", \"xhigh\"\n- `tools` - Custom tools exposed to the CLI\n- `systemMessage` - System message customization\n- `availableTools` - Allowlist of tool names\n- `excludedTools` - Blocklist of tool names\n- `provider` - Custom API provider configuration (BYOK)\n- `streaming` - Enable streaming response chunks (default: false)\n- `workingDirectory` - Session working directory\n- `mcpServers` - MCP server configurations\n- `customAgents` - Custom agent configurations\n- `agent` - Pre-select agent by name\n- `infiniteSessions` - Infinite sessions configuration\n- `skillDirectories` - Skill SKILL.md directories\n- `disabledSkills` - Skills to disable\n- `configDir` - Config directory path\n- `hooks` - Session lifecycle hooks\n- `onPermissionRequest` - **REQUIRED** permission handler\n- `onUserInputRequest` - User input handler\n- `onEvent` - Event handler registered before session creation\n\nAll setters return `SessionConfig` for method chaining.\n\n### Resuming Sessions\n\n```java\nvar session = client.resumeSession(sessionId, new ResumeSessionConfig()\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Session Operations\n\n- `session.getSessionId()` - Get session identifier\n- `session.send(prompt)` \u002F `session.send(MessageOptions)` - Send message, returns message ID\n- `session.sendAndWait(prompt)` \u002F `session.sendAndWait(MessageOptions)` - Send and wait for response (60s timeout)\n- `session.sendAndWait(options, timeoutMs)` - Send and wait with custom timeout\n- `session.abort()` - Abort current processing\n- `session.getMessages()` - Get all events\u002Fmessages\n- `session.setModel(modelId)` - Switch to a different model\n- `session.log(message)` \u002F `session.log(message, \"warning\", false)` \u002F `session.log(message, \"error\", false)` - Log to session timeline with level `\"info\"`, `\"warning\"`, or `\"error\"`\n- `session.close()` - Clean up resources\n\n## Event Handling\n\n### Event Subscription Pattern\n\nUse `CompletableFuture` for waiting on session events:\n\n```java\nvar done = new CompletableFuture\u003CVoid>();\n\nsession.on(event -> {\n    if (event instanceof AssistantMessageEvent msg) {\n        System.out.println(msg.getData().content());\n    } else if (event instanceof SessionIdleEvent) {\n        done.complete(null);\n    }\n});\n\nsession.send(new MessageOptions().setPrompt(\"Hello\"));\ndone.get();\n```\n\n### Type-Safe Event Handling\n\nUse the typed `on()` overload for compile-time safety:\n\n```java\nsession.on(AssistantMessageEvent.class, msg -> {\n    System.out.println(msg.getData().content());\n});\n\nsession.on(SessionIdleEvent.class, idle -> {\n    done.complete(null);\n});\n```\n\n### Unsubscribing from Events\n\nThe `on()` method returns a `Closeable`:\n\n```java\nvar subscription = session.on(event -> { \u002F* handler *\u002F });\n\u002F\u002F Later...\nsubscription.close();\n```\n\n### Event Types\n\nUse pattern matching (Java 17+) for event handling:\n\n```java\nsession.on(event -> {\n    if (event instanceof UserMessageEvent userMsg) {\n        \u002F\u002F Handle user message\n    } else if (event instanceof AssistantMessageEvent assistantMsg) {\n        System.out.println(assistantMsg.getData().content());\n    } else if (event instanceof AssistantMessageDeltaEvent delta) {\n        System.out.print(delta.getData().deltaContent());\n    } else if (event instanceof ToolExecutionStartEvent toolStart) {\n        \u002F\u002F Tool execution started\n    } else if (event instanceof ToolExecutionCompleteEvent toolComplete) {\n        \u002F\u002F Tool execution completed\n    } else if (event instanceof SessionStartEvent start) {\n        \u002F\u002F Session started\n    } else if (event instanceof SessionIdleEvent idle) {\n        \u002F\u002F Session is idle (processing complete)\n    } else if (event instanceof SessionErrorEvent error) {\n        System.err.println(\"Error: \" + error.getData().message());\n    }\n});\n```\n\n### Event Error Handling\n\nControl how errors in event handlers are handled:\n\n```java\n\u002F\u002F Set a custom error handler\nsession.setEventErrorHandler(ex -> {\n    logger.error(\"Event handler error\", ex);\n});\n\n\u002F\u002F Or set the error propagation policy\nsession.setEventErrorPolicy(EventErrorPolicy.SUPPRESS_AND_LOG_ERRORS);\n```\n\n## Streaming Responses\n\n### Enabling Streaming\n\nSet `streaming(true)` in SessionConfig:\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setStreaming(true)\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Handling Streaming Events\n\nHandle both delta events (incremental) and final events:\n\n```java\nvar done = new CompletableFuture\u003CVoid>();\n\nsession.on(event -> {\n    switch (event) {\n        case AssistantMessageDeltaEvent delta ->\n            \u002F\u002F Incremental text chunk\n            System.out.print(delta.getData().deltaContent());\n        case AssistantReasoningDeltaEvent reasoningDelta ->\n            \u002F\u002F Incremental reasoning chunk (model-dependent)\n            System.out.print(reasoningDelta.getData().deltaContent());\n        case AssistantMessageEvent msg ->\n            \u002F\u002F Final complete message\n            System.out.println(\"\\n--- Final ---\\n\" + msg.getData().content());\n        case AssistantReasoningEvent reasoning ->\n            \u002F\u002F Final reasoning content\n            System.out.println(\"--- Reasoning ---\\n\" + reasoning.getData().content());\n        case SessionIdleEvent idle ->\n            done.complete(null);\n        default -> { }\n    }\n});\n\nsession.send(new MessageOptions().setPrompt(\"Tell me a story\"));\ndone.get();\n```\n\nNote: Final events (`AssistantMessageEvent`, `AssistantReasoningEvent`) are ALWAYS sent regardless of streaming setting.\n\n## Custom Tools\n\n### Defining Tools\n\nUse `ToolDefinition.create()` with JSON Schema parameters and a `ToolHandler`:\n\n```java\nvar tool = ToolDefinition.create(\n    \"get_weather\",\n    \"Get weather for a location\",\n    Map.of(\n        \"type\", \"object\",\n        \"properties\", Map.of(\n            \"location\", Map.of(\"type\", \"string\", \"description\", \"City name\")\n        ),\n        \"required\", List.of(\"location\")\n    ),\n    invocation -> {\n        String location = (String) invocation.getArguments().get(\"location\");\n        return CompletableFuture.completedFuture(\"Sunny in \" + location);\n    }\n);\n\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setTools(List.of(tool))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Type-Safe Tool Arguments\n\nUse `getArgumentsAs()` for deserialization into a typed record or class:\n\n```java\nrecord WeatherArgs(String location, String unit) {}\n\nvar tool = ToolDefinition.create(\n    \"get_weather\",\n    \"Get weather for a location\",\n    Map.of(\n        \"type\", \"object\",\n        \"properties\", Map.of(\n            \"location\", Map.of(\"type\", \"string\"),\n            \"unit\", Map.of(\"type\", \"string\", \"enum\", List.of(\"celsius\", \"fahrenheit\"))\n        ),\n        \"required\", List.of(\"location\")\n    ),\n    invocation -> {\n        var args = invocation.getArgumentsAs(WeatherArgs.class);\n        return CompletableFuture.completedFuture(\n            Map.of(\"temp\", 72, \"unit\", args.unit(), \"location\", args.location())\n        );\n    }\n);\n```\n\n### Overriding Built-In Tools\n\n```java\nvar override = ToolDefinition.createOverride(\n    \"built_in_tool_name\",\n    \"Custom description\",\n    Map.of(\"type\", \"object\", \"properties\", Map.of(...)),\n    invocation -> CompletableFuture.completedFuture(\"custom result\")\n);\n```\n\n### Tool Return Types\n\n- Return any JSON-serializable value (String, Map, List, record, POJO)\n- The SDK automatically serializes the return value and sends it back to the CLI\n\n### Tool Execution Flow\n\nWhen Copilot invokes a tool, the client automatically:\n1. Deserializes the arguments\n2. Runs your handler function\n3. Serializes the return value\n4. Responds to the CLI\n\n## Permission Handling\n\n### Required Permission Handler\n\nA permission handler is **mandatory** when creating or resuming sessions:\n\n```java\n\u002F\u002F Approve all requests (for development\u002Ftesting)\nnew SessionConfig()\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n\n\u002F\u002F Custom permission logic\nnew SessionConfig()\n    .setOnPermissionRequest((request, invocation) -> {\n        if (\"dangerous-action\".equals(request.getKind())) {\n            return CompletableFuture.completedFuture(\n                new PermissionRequestResult().setKind(PermissionRequestResultKind.DENIED)\n            );\n        }\n        return CompletableFuture.completedFuture(\n            new PermissionRequestResult().setKind(PermissionRequestResultKind.APPROVED)\n        );\n    })\n```\n\n## User Input Handling\n\nHandle user input requests from the agent:\n\n```java\nnew SessionConfig()\n    .setOnUserInputRequest((request, invocation) -> {\n        System.out.println(\"Agent asks: \" + request.getQuestion());\n        String answer = scanner.nextLine();\n        return CompletableFuture.completedFuture(\n            new UserInputResponse()\n                .setAnswer(answer)\n                .setWasFreeform(true)\n        );\n    })\n```\n\n## System Message Customization\n\n### Append Mode (Default - Preserves Guardrails)\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setSystemMessage(new SystemMessageConfig()\n        .setMode(SystemMessageMode.APPEND)\n        .setContent(\"\"\"\n            \u003Cworkflow_rules>\n            - Always check for security vulnerabilities\n            - Suggest performance improvements when applicable\n            \u003C\u002Fworkflow_rules>\n            \"\"\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n### Replace Mode (Full Control - Removes Guardrails)\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setSystemMessage(new SystemMessageConfig()\n        .setMode(SystemMessageMode.REPLACE)\n        .setContent(\"You are a helpful assistant.\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n## File Attachments\n\nAttach files to messages using `Attachment`:\n\n```java\nsession.send(new MessageOptions()\n    .setPrompt(\"Analyze this file\")\n    .setAttachments(List.of(\n        new Attachment(\"file\", \"\u002Fpath\u002Fto\u002Ffile.java\", \"My File\")\n    ))\n);\n```\n\n## Message Delivery Modes\n\nUse the `mode` property in `MessageOptions`:\n\n- `\"enqueue\"` - Queue message for processing (default)\n- `\"immediate\"` - Process message immediately\n\n```java\nsession.send(new MessageOptions()\n    .setPrompt(\"...\")\n    .setMode(\"enqueue\")\n);\n```\n\n## Convenience: Send and Wait\n\nUse `sendAndWait()` to send a message and block until the assistant responds:\n\n```java\n\u002F\u002F With default 60-second timeout\nAssistantMessageEvent response = session.sendAndWait(\"What is 2+2?\").get();\nSystem.out.println(response.getData().content());\n\n\u002F\u002F With custom timeout\nAssistantMessageEvent response = session.sendAndWait(\n    new MessageOptions().setPrompt(\"Write a long story\"),\n    120_000  \u002F\u002F 120 seconds\n).get();\n```\n\n## Multiple Sessions\n\nSessions are independent and can run concurrently:\n\n```java\nvar session1 = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n\nvar session2 = client.createSession(new SessionConfig()\n    .setModel(\"claude-sonnet-4.5\")\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n\nsession1.send(new MessageOptions().setPrompt(\"Hello from session 1\"));\nsession2.send(new MessageOptions().setPrompt(\"Hello from session 2\"));\n```\n\n## Bring Your Own Key (BYOK)\n\nUse custom API providers via `ProviderConfig`:\n\n```java\n\u002F\u002F OpenAI\nvar session = client.createSession(new SessionConfig()\n    .setProvider(new ProviderConfig()\n        .setType(\"openai\")\n        .setBaseUrl(\"https:\u002F\u002Fapi.openai.com\u002Fv1\")\n        .setApiKey(\"sk-...\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n\n\u002F\u002F Azure OpenAI\nvar session = client.createSession(new SessionConfig()\n    .setProvider(new ProviderConfig()\n        .setType(\"azure\")\n        .setAzure(new AzureOptions()\n            .setEndpoint(\"https:\u002F\u002Fmy-resource.openai.azure.com\")\n            .setDeployment(\"gpt-4\"))\n        .setBearerToken(\"...\"))\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n## Session Lifecycle Management\n\n### Listing Sessions\n\n```java\nvar sessions = client.listSessions().get();\nfor (var metadata : sessions) {\n    System.out.println(\"Session: \" + metadata.getSessionId());\n}\n```\n\n### Deleting Sessions\n\n```java\nclient.deleteSession(sessionId).get();\n```\n\n### Checking Connection State\n\n```java\nvar state = client.getState();\n```\n\n### Lifecycle Event Subscription\n\n```java\nAutoCloseable subscription = client.onLifecycle(event -> {\n    System.out.println(\"Lifecycle event: \" + event);\n});\n\u002F\u002F Later...\nsubscription.close();\n```\n\n## Error Handling\n\n### Standard Exception Handling\n\n```java\ntry {\n    var session = client.createSession(new SessionConfig()\n        .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n    ).get();\n    session.sendAndWait(\"Hello\").get();\n} catch (ExecutionException ex) {\n    Throwable cause = ex.getCause();\n    System.err.println(\"Error: \" + cause.getMessage());\n} catch (Exception ex) {\n    System.err.println(\"Error: \" + ex.getMessage());\n}\n```\n\n### Session Error Events\n\nMonitor `SessionErrorEvent` for runtime errors:\n\n```java\nsession.on(SessionErrorEvent.class, error -> {\n    System.err.println(\"Session Error: \" + error.getData().message());\n});\n```\n\n## Connectivity Testing\n\nUse `ping()` to verify server connectivity:\n\n```java\nvar response = client.ping(\"test message\").get();\n```\n\n## Status and Authentication\n\n```java\n\u002F\u002F Get CLI version and protocol info\nvar status = client.getStatus().get();\n\n\u002F\u002F Check authentication status\nvar authStatus = client.getAuthStatus().get();\n\n\u002F\u002F List available models\nvar models = client.listModels().get();\n```\n\n## Resource Cleanup\n\n### Automatic Cleanup with try-with-resources\n\nALWAYS use try-with-resources for automatic disposal:\n\n```java\ntry (var client = new CopilotClient()) {\n    client.start().get();\n    try (var session = client.createSession(new SessionConfig()\n            .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get()) {\n        \u002F\u002F Use session...\n    }\n}\n\u002F\u002F Resources automatically cleaned up\n```\n\n### Manual Cleanup\n\nIf not using try-with-resources:\n\n```java\nvar client = new CopilotClient();\ntry {\n    client.start().get();\n    \u002F\u002F Use client...\n} finally {\n    client.stop().get();\n}\n```\n\n## Best Practices\n\n1. **Always use try-with-resources** for `CopilotClient` and `CopilotSession`\n2. **Always provide a permission handler** - it is required for `createSession` and `resumeSession`\n3. **Use `CompletableFuture`** properly - call `.get()` to block, or chain with `.thenApply()`\u002F`.thenCompose()`\n4. **Use `sendAndWait()`** for simple request-response patterns instead of manual event handling\n5. **Handle `SessionErrorEvent`** for robust error handling\n6. **Use pattern matching** (switch with sealed types) for event handling\n7. **Enable streaming** for better UX in interactive scenarios\n8. **Close event subscriptions** (`Closeable`) when no longer needed\n9. **Use `SystemMessageMode.APPEND`** to preserve safety guardrails\n10. **Provide descriptive tool names and descriptions** for better model understanding\n11. **Handle both delta and final events** when streaming is enabled\n12. **Use `getArgumentsAs()`** for type-safe tool argument deserialization\n\n## Common Patterns\n\n### Simple Query-Response\n\n```java\ntry (var client = new CopilotClient()) {\n    client.start().get();\n\n    try (var session = client.createSession(new SessionConfig()\n            .setModel(\"gpt-5\")\n            .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get()) {\n\n        var response = session.sendAndWait(\"What is 2+2?\").get();\n        System.out.println(response.getData().content());\n    }\n}\n```\n\n### Event-Driven Conversation\n\n```java\ntry (var client = new CopilotClient()) {\n    client.start().get();\n\n    try (var session = client.createSession(new SessionConfig()\n            .setModel(\"gpt-5\")\n            .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get()) {\n\n        var done = new CompletableFuture\u003CVoid>();\n\n        session.on(AssistantMessageEvent.class, msg ->\n            System.out.println(msg.getData().content()));\n\n        session.on(SessionIdleEvent.class, idle ->\n            done.complete(null));\n\n        session.send(new MessageOptions().setPrompt(\"What is 2+2?\"));\n        done.get();\n    }\n}\n```\n\n### Multi-Turn Conversation\n\n```java\ntry (var session = client.createSession(new SessionConfig()\n        .setModel(\"gpt-5\")\n        .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)).get()) {\n\n    var response1 = session.sendAndWait(\"What is the capital of France?\").get();\n    System.out.println(response1.getData().content());\n\n    var response2 = session.sendAndWait(\"What is its population?\").get();\n    System.out.println(response2.getData().content());\n}\n```\n\n### Tool with Complex Return Type\n\n```java\nrecord UserInfo(String id, String name, String email, String role) {}\n\nvar tool = ToolDefinition.create(\n    \"get_user\",\n    \"Retrieve user information\",\n    Map.of(\n        \"type\", \"object\",\n        \"properties\", Map.of(\n            \"userId\", Map.of(\"type\", \"string\", \"description\", \"User ID\")\n        ),\n        \"required\", List.of(\"userId\")\n    ),\n    invocation -> {\n        String userId = (String) invocation.getArguments().get(\"userId\");\n        return CompletableFuture.completedFuture(\n            new UserInfo(userId, \"John Doe\", \"john@example.com\", \"Developer\")\n        );\n    }\n);\n```\n\n### Session Hooks\n\n```java\nvar session = client.createSession(new SessionConfig()\n    .setModel(\"gpt-5\")\n    .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n    .setHooks(new SessionHooks()\n        .setOnPreToolUse((input, invocation) -> {\n            System.out.println(\"About to execute tool: \" + input);\n            var decision = new PreToolUseHookOutput().setKind(\"allow\");\n            return CompletableFuture.completedFuture(decision);\n        })\n        .setOnPostToolUse((output, invocation) -> {\n            System.out.println(\"Tool execution complete: \" + output);\n            return CompletableFuture.completedFuture(null);\n        }))\n).get();\n```\n",{"name":5,"description":7},"main","36d1906c0f5e8cbdc4c3b5cc88236b6d68628299",".github\u002Fskills\u002Fjava-coding-skill",1,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Fgithub_copilot-sdk","https:\u002F\u002Fgithub.com\u002Freview-bench","https:\u002F\u002Freview-bench.ai","An open benchmark for AI code review.","2026-10-27 07:02:57",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add review-bench\u002Fgithub_copilot-sdk --skill java-coding-skill",{"tool":39,"command":40},"bunx","bunx skills add review-bench\u002Fgithub_copilot-sdk --skill java-coding-skill",{"tool":42,"command":43},"pnpm","pnpm dlx skills add review-bench\u002Fgithub_copilot-sdk --skill java-coding-skill","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Freview-bench\u002Fgithub_copilot-sdk\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fjava-coding-skill\u002FSKILL.md",true,[],[48,54],{"skillNo":49,"name":50,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7529JCBRR1WB00VK5CWKMJS","greeting","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Fgithub_copilot-sdk\u002Fblob\u002Fmain\u002Ftest\u002Fscenarios\u002Ftools\u002Fskills\u002Fsample-skills\u002Fgreeting\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7529GA0MJE8WC0AABMQGVM0","rust-coding-skill","Use this skill whenever editing `*.rs` files in the `rust\u002F` SDK in order to write idiomatic, efficient, well-structured Rust code","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Fgithub_copilot-sdk\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Frust-coding-skill\u002FSKILL.md",[],[]]