Package com.github.copilot.sdk.json

Class SessionHooks

java.lang.Object
com.github.copilot.sdk.json.SessionHooks
public class SessionHooks extends Object
Hook handlers configuration for a session.

Hooks allow you to intercept and modify tool execution behavior. Currently supports pre-tool-use and post-tool-use hooks.

Example Usage


 var hooks = new SessionHooks().setOnPreToolUse((input, invocation) -> {
 	System.out.println("Tool being called: " + input.getToolName());
 	return CompletableFuture.completedFuture(new PreToolUseHookOutput().setPermissionDecision("allow"));
 }).setOnPostToolUse((input, invocation) -> {
 	System.out.println("Tool result: " + input.getToolResult());
 	return CompletableFuture.completedFuture(null);
 });

 var session = client.createSession(new SessionConfig().setHooks(hooks)).get();
Since:
1.0.6

  • Constructor Details

    • SessionHooks

      public SessionHooks()

  • Method Details

    • getOnPreToolUse

      public PreToolUseHandler getOnPreToolUse()
      Gets the pre-tool-use handler.
      Returns:
      the handler, or null if not set

    • setOnPreToolUse

      public SessionHooks setOnPreToolUse(PreToolUseHandler onPreToolUse)
      Sets the handler called before a tool is executed.
      Parameters:
      onPreToolUse - the handler
      Returns:
      this instance for method chaining

    • getOnPostToolUse

      public PostToolUseHandler getOnPostToolUse()
      Gets the post-tool-use handler.
      Returns:
      the handler, or null if not set

    • setOnPostToolUse

      public SessionHooks setOnPostToolUse(PostToolUseHandler onPostToolUse)
      Sets the handler called after a tool has been executed.
      Parameters:
      onPostToolUse - the handler
      Returns:
      this instance for method chaining

    • hasHooks

      public boolean hasHooks()
      Returns whether any hooks are registered.
      Returns:
      true if at least one hook handler is set