use Revolution\Copilot\Enums\EventsReadDirection;
use Revolution\Copilot\Types\Rpc\HooksDiscoverRequest;
use Revolution\Copilot\Types\Rpc\SessionsListRequest;
use Revolution\Copilot\Types\Rpc\SessionsPruneOldRequest;
use Revolution\Copilot\Types\Rpc\SessionsReadPersistedEventsRequest;
use Revolution\Copilot\Types\Rpc\SessionsOpenCreateRequest;
use Revolution\Copilot\Enums\SessionsOpenStatus;
use Revolution\Copilot\Types\SessionConfig;
use Revolution\Copilot\Types\SessionListFilter;
// 新規セッションで利用可能な組み込みスラッシュコマンド一覧(experimental)
Copilot::client()->rpc()->commands()->list();
// セッション開始前のフック探索(experimental)
Copilot::client()->rpc()->hooks()->discover(new HooksDiscoverRequest(
projectPaths: ['/path/to/project'],
));
// ホストのサンドボックス対応状況(experimental)
$hostSupport = Copilot::client()->rpc()->sandbox()->getHostSupport();
// $hostSupport->supported, $hostSupport->reason, $hostSupport->capabilities
// sessions (experimental: 永続化済みセッションの照会・管理)
// sessions.open は kind で作成・再開・resumeLast・attach・remote/cloud 接続・handoff を選択します。
$opened = $sessions->open(new SessionsOpenCreateRequest(
options: new SessionConfig(sessionId: 'new-session', model: 'gpt-5'),
));
if ($opened->status === SessionsOpenStatus::Created) {
echo $opened->sessionId;
}
// 配列でも指定できます。再開時の sessionId は variant のトップレベルに指定します。
$resumed = $sessions->open(['kind' => 'resume', 'sessionId' => 'existing-session']);
// 戻り値は SessionsOpenResult。not_found の場合は sessionId がありません。
// sessionApi、onTaskCreated、onProgress、onConfirm は in-process 専用で、wire payload には含まれません。
$listed = $sessions->list(new SessionsListRequest(
source: 'local',
metadataLimit: 50,
filter: new SessionListFilter(cwd: '/path/to/project'),
));
// 各 SessionMetadata の isRemote で local / remote セッションを判別
foreach ($listed->sessions as $session) {
echo $session->sessionId;
}
$sessions->findByTaskId(['taskId' => 'task-id']);
$sessions->findByPrefix(['prefix' => 'session-id-prefix']);
$sessions->getLastForContext(['context' => ['cwd' => '/path/to/project']]);
// セッションを開かずローカルのイベントログの有無を確認(空のログも true)
$hasEvents = Copilot::client()->rpc()->sessions()->hasEvents(['sessionId' => 'session-id']);
// $hasEvents->exists は、ログがなくメタデータのみの場合 false
$sizes = $sessions->getSizes(); // $sizes->sizes は session ID => byte 数
$inUse = $sessions->checkInUse(['sessionIds' => ['session-id']]);
$deleted = $sessions->bulkDelete(['sessionIds' => ['session-id']]);
// アクティブなセッションを閉じる(履歴は削除しない)
$sessions->close(['sessionId' => 'session-id']);
// 保留中イベントをディスクへ保存
$sessions->save(['sessionId' => 'session-id']);
// このプロセスが保持するセッションのin-use lockを明示的に解放
$sessions->releaseLock(['sessionId' => 'session-id']);
// reloadPluginHooksはuser/plugin hooksを再読み込みする。
// folder trustの確認前はrepo hooksを遅延させ、信頼確認後に続けてロードする。
$sessions->reloadPluginHooks([
'sessionId' => 'session-id',
'deferRepoHooks' => true,
]);
$loadedHooks = $sessions->loadDeferredRepoHooks(['sessionId' => 'session-id']);
// $loadedHooks->startupPrompts と $loadedHooks->hookCount
// Manager-wideの追加plugin設定を置換(空配列でクリア)
$sessions->setAdditionalPlugins(['plugins' => []]);
// local session metadata の summary / context を補完
$enriched = $sessions->enrichMetadata([
'sessions' => [[
'sessionId' => 'session-id',
'startTime' => '2026-10-17T09:00:00Z',
'modifiedTime' => '2026-10-17T09:00:00Z',
'isRemote' => false,
]],
]);
// close() はshutdown・イベント保存・ロック解放を行ってactive sessionを破棄しますが、
// persisted historyは削除しません。$session->disconnect() はsession.detachでこのSDKとの
// 接続とPHP側のin-memory resourcesを解放します。永続データの削除にはbulkDelete()を使います。
// セッションを開かず、cursor を使って永続化済みイベントをページング
$cursor = null;
do {
$page = $sessions->readPersistedEvents(new SessionsReadPersistedEventsRequest(
sessionId: 'session-id',
cursor: $cursor,
max: 100,
direction: EventsReadDirection::FORWARD,
));
foreach ($page->events as $event) {
// イベントを処理
}
$cursor = $page->cursor;
} while ($page->hasMore);
// dryRun は削除せず候補と見積もりを返す。実削除する場合は dryRun: false を指定
$preview = $sessions->pruneOld(new SessionsPruneOldRequest(
olderThanDays: 30,
dryRun: true,
));
// sessions.fork
$sessions->fork(new SessionsForkRequest(
sessionId: 'source-session-id',
toEventId: 'evt-boundary', // オプション: この ID より前のイベントのみ含める
));
// environments (experimental: GitHub Mission Control 環境の検索・取得・削除)
$result = Copilot::client()->rpc()->environments()->list(['kind' => 'user-local']);
// $result->environments は GitHubEnvironment の配列
$env = Copilot::client()->rpc()->environments()->get(['environmentId' => 'env-id']);
Copilot::client()->rpc()->environments()->delete(['environmentId' => 'env-id']);