Require onPermissionRequest handler, auto-inject via CopilotManager

[Copilot]

Follows official SDK PRs #554 and #555 — makes onPermissionRequest mandatory on session creation/resume. To avoid burdening Laravel users who call Copilot::run()/Copilot::start(), the Manager auto-injects PermissionHandler::approveAll() by default.

Changes

• Client.createSession() / resumeSession() — config param is now required (no default), throws InvalidArgumentException if onPermissionRequest is missing. Always calls registerPermissionHandler() unconditionally.
• CopilotClient contract — removed = [] defaults from createSession and resumeSession signatures
• CopilotManager — new ensurePermissionHandler() injects PermissionHandler::approveAll() when handler is absent and config('copilot.permission_approve') is true
• config/copilot.php — added permission_approve option (default true via COPILOT_PERMISSION_APPROVE env)
• docs/jp/permission-request.md — rewritten to reflect auto-approve default, direct Client usage requirement, and custom-tool permission kind from PR #555

Usage

// Facade: works without explicit handler (auto-approved by default)
$response = Copilot::run(prompt: 'Hello');

// Direct Client: handler is required (matches official SDK)
$session = $client->createSession([
    'onPermissionRequest' => PermissionHandler::approveAll(),
]);

// Opt out of auto-approve via config
// config/copilot.php: 'permission_approve' => false

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/copilot_internal/user
  • Triggering command: /home/REDACTED/.local/bin/copilot copilot --headless --stdio --log-level info (http block)
  • Triggering command: /home/REDACTED/.local/bin/copilot copilot --headless --stdio --log-level info ash stty n/stty (http block)
  • Triggering command: /home/REDACTED/.local/bin/copilot copilot --headless --stdio --log-level info pilot-sdk/vendor/bin/stty stty ndor/bin/stty (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.