権限リクエスト

デフォルト動作（`deny-all`）

config/copilot.php の permission_approve が "deny-all"（デフォルト）の場合、Copilot::run() や Copilot::start() では権限リクエストは自動で拒否されます。テキスト生成中心の用途では権限を必要としないことが多いため、安全なデフォルトです。

// config/copilot.php
'permission_approve' => env('COPILOT_PERMISSION_APPROVE', 'deny-all'),

設定できる値

値	動作
`"deny-all"`	すべて自動拒否（デフォルト）
`"approve-safety"`	`shell` と `write` のみ拒否し、他は自動許可
`"approve-all"`	すべて自動許可
`false`	ハンドラなし。`onPermissionRequest` が必須（公式 SDK と同じ）

// .env
COPILOT_PERMISSION_APPROVE="approve-safety"

ユーザー入力プロンプトを受け付ける場合、"approve-safety" と "approve-all" は危険です。必ず false または "deny-all" を使ってください。 read-only 権限でも Laravel プロジェクトのコードが読まれる可能性があります。

`PermissionHandler::approveAll()`

PermissionHandler::approveAll() はすべてのリクエストを自動許可します。

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Support\PermissionHandler;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    onPermissionRequest: PermissionHandler::approveAll(),
);

$response = Copilot::run(prompt: 'Hello', config: $config);

`PermissionHandler::approveSafety()`

PermissionHandler::approveSafety() は高リスクの権限（shell, write）のみ拒否し、他を自動許可します。

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Support\PermissionHandler;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    onPermissionRequest: PermissionHandler::approveSafety(),
);

$response = Copilot::run(prompt: 'Hello', config: $config);

これでも完全に安全とは限りません。厳密に制御したい場合はカスタムハンドラを実装し、$request['kind'] を見て判定してください。

`PermissionHandler::denyAll()`

PermissionHandler::denyAll() はすべて拒否します。

use Revolution\Copilot\Support\PermissionHandler;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    onPermissionRequest: PermissionHandler::denyAll(),
);

Client を直接使う場合

CopilotClient を直接使う場合は、公式 SDK と同様に onPermissionRequest の指定が必須です。

use Revolution\Copilot\Client;
use Revolution\Copilot\Support\PermissionHandler;

$client = new Client([
    'cli_path' => 'copilot',
    'cli_args' => [],
    'cwd' => base_path(),
    'log_level' => 'info',
    'env' => null,
]);
$client->start();

// onPermissionRequest は必須
$session = $client->createSession([
    'onPermissionRequest' => PermissionHandler::approveSafety(),
]);

// 省略すると InvalidArgumentException
// $session = $client->createSession([]); // Error!

カスタムハンドラ

リクエスト種別ごとに許可・拒否を制御するにはクロージャを渡します。 $request と $invocation は以下のような配列です。

use Illuminate\Support\Facades\Artisan;
use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Support\PermissionRequestResultKind;
use Revolution\Copilot\Types\SessionConfig;

use function Laravel\Prompts\{confirm, note, spin, text};

Artisan::command('copilot:chat', function () {
    $config = new SessionConfig(
        onPermissionRequest: function (array $request, array $invocation) {
            $confirm = confirm(
                label: 'Do you accept the requested permissions?',
            );
            if ($confirm) {
                return PermissionRequestResultKind::approveOnce();
            } else {
                return PermissionRequestResultKind::reject();
            }
        },
    );

    Copilot::start(function (CopilotSession $session) use ($config) {
        while (true) {
            $prompt = text(
                label: 'Enter your prompt',
                placeholder: 'Ask me anything...',
                required: true,
                hint: 'Ctrl+C to exit',
            );

            $response = spin(
                callback: fn () => $session->sendAndWait($prompt),
                message: 'Waiting for Copilot response...',
            );

            note($response->content());
        }
    }, config: $config);
});

`$request`

kind と toolCallId 以外のフィールドは kind によって変わります。

kind: "shell" | "write" | "mcp" | "read" | "url" | "custom-tool" | "memory" | "hook"

[
  "kind" => "shell",
  "toolCallId" => "toolu_...",
  "fullCommandText" => "...",
  "intention" => "Run copilot:ping to test permission request",
  "commands" => [
    [
      "identifier" => "bash",
      "readOnly" => false,
    ]
  ]
  "possiblePaths" => [],
  "possibleUrls" => [],
  "hasWriteFileRedirection" => false,
  "canOfferSessionApproval" => false,
]

$request['managedApprovalRequired'] が true の場合、組織の Managed Settings によってこのリクエストは自動承認できません。 PermissionHandler::approveAll() はこの場合 no-result を返し、Copilot CLI 側の標準フローに委ねます。

`$invocation`

[
  "sessionId" => "...",
  // 新しいCLIランタイムでのみ任意に含まれる
  "promptRequest" => [
    "kind" => "read",
    "managedApprovalRequired" => false,
  ],
]

プロンプトコンテキスト（`promptRequest`）

新しいCLIランタイムでは、$invocation['promptRequest'] にユーザー向けプロンプトのコンテキストが含まれることがあります。カスタムハンドラでは、この値を見て人間の応答が必要かどうかを判断できます。 PermissionHandler::approveAll() は次の条件をすべて満たす場合、promptRequest['managedApprovalRequired'] を優先します。

promptRequest['kind'] が commands / read / write / url / workflow のいずれか
promptRequest['managedApprovalRequired'] が boolean

これにより、$request['managedApprovalRequired'] がポリシー由来のマーカーとして残っていても、プロンプト上で人間の応答が不要なら自動承認できます。 $request の生のマーカーは引き続き保持されます。 promptRequest がない古いCLI、未対応の種類、または有効な boolean 値がない場合は、従来どおり $request['managedApprovalRequired'] で判断します。

use Revolution\Copilot\Support\PermissionRequestResultKind;

onPermissionRequest: function (array $request, array $invocation) {
    $prompt = $invocation['promptRequest'] ?? null;

    if (is_array($prompt) && ($prompt['managedApprovalRequired'] ?? null) === true) {
        // 人間の応答が必要なため、CLI 側の標準フローに委ねる
        return PermissionRequestResultKind::noResult();
    }

    return PermissionRequestResultKind::approveOnce();
},

Response

権限判定結果は配列で返します。 PermissionRequestResultKind クラスを使うと読みやすくなります。

return PermissionRequestResultKind::approveOnce();
return PermissionRequestResultKind::reject();

プロトコル詳細

Protocol v3（現在のデフォルト）では、権限リクエストは JSON-RPC リクエストではなくセッションイベント（permission.requested）として配信されます。 SDK は内部でこれを処理し、session.permissions.handlePendingPermissionRequest RPC で応答します。 SessionConfig の使い方は変わりません。 onPermissionRequest にハンドラを渡せば、プロトコル差分は SDK が吸収します。

PermissionRequestResultKind

['kind' => 'approve-once'] の形式で直接返すこともできますが、PermissionRequestResultKind を使うと分かりやすくなります。

use Revolution\Copilot\Support\PermissionRequestResultKind;

$confirm = confirm(
    label: 'Do you accept the requested permissions?',
);

if ($confirm) {
    return PermissionRequestResultKind::approveOnce();
} else {
    return PermissionRequestResultKind::reject();
}

利用可能なメソッド

メソッド	値	説明
`approveOnce()`	`approve-once`	今回のリクエストのみ許可
`approveForSession()`	`approve-for-session`	このセッション中の同種リクエストをすべて許可
`approveForLocation()`	`approve-for-location`	この場所（ファイルパス等）からの同種リクエストをすべて許可
`reject()`	`reject`	リクエストを拒否
`userNotAvailable()`	`user-not-available`	ユーザーが応答できない状態（非インタラクティブ環境など）
`noResult()`	`no-result`	ハンドラが結果を返せない場合（RPC 呼び出しをスキップ）

Laravel\Prompts\select を使いたい場合は PermissionRequestResultKind::select() で選択肢を取得できます。

use Revolution\Copilot\Support\PermissionRequestResultKind;
use function Laravel\Prompts\select;

$select = select(
    label: 'Do you accept the requested permissions?',
    options: PermissionRequestResultKind::select(),
);

return ['kind' => $select];

no-result

ハンドラが結果を返せない場合（例: 非対話環境）は no-result を返せます。 no-result を返すと RPC 呼び出しをスキップし、Copilot CLI 側のデフォルト拒否が適用されます。

return PermissionRequestResultKind::noResult();
// または ['kind' => 'no-result']

最新情報は GitHub リポジトリを参照してください。

GitHub Copilot

SDK

AI SDK

VOICEVOX

スターターキット

フィード・RSS

ミドルウェア

権限リクエスト