RPC (Remote Procedure Call)

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Enums\TokenPriceUnit;
use Revolution\Copilot\Types\Rpc\ModelsListTokenPriceUnitsRequest;
use Revolution\Copilot\Types\Rpc\ModelList;

// Modellliste abrufen
// Rückgabewert ist ModelList
$result = Copilot::client()->rpc()->models()->list();
// models ist ein Array von ModelInfo
$models = $result->models;

// Nahezu identisch mit dem von Anfang an vorhandenen listModels()
// Rückgabewert ist ein Array von ModelInfo
Copilot::client()->listModels();

use Illuminate\Http\Client\Response;
use Revolution\Copilot\Enums\CatalogCandidateKind;
use Revolution\Copilot\Enums\CatalogCapability;
use Revolution\Copilot\Enums\CatalogSelectionDecision;
use Revolution\Copilot\Enums\CatalogTrustTier;
use Revolution\Copilot\Enums\EventsReadDirection;
use Revolution\Copilot\Enums\McpInstallationSecretStorage;
use Revolution\Copilot\Enums\OptionsUpdateToolFilterPrecedence;
use Revolution\Copilot\Enums\SkillInstallationManagementOutcomeKind;
use Revolution\Copilot\Enums\SkillInstallationManagementResultKind;
use Revolution\Copilot\Enums\AzureMlRegistry;
use Revolution\Copilot\Types\Rpc\AzureMlAcquireFamilyRequest;
use Revolution\Copilot\Types\Rpc\AzureMlCancelRequest;
use Revolution\Copilot\Types\Rpc\AzureMlCatalogRequest;
use Revolution\Copilot\Types\Rpc\AzureMlDiscardRequest;
use Revolution\Copilot\Types\Rpc\AzureMlDownloadRequest;
use Revolution\Copilot\Types\Rpc\AzureMlLatestRequest;
use Revolution\Copilot\Types\Rpc\AzureMlReleaseFamilyRequest;
use Revolution\Copilot\Types\Rpc\AzureMlResolveRequest;
use Revolution\Copilot\Types\Rpc\AzureMlStatusRequest;
use Revolution\Copilot\Types\Rpc\AgentsDiscoverRequest;
use Revolution\Copilot\Types\Rpc\AgentsGetDiscoveryPathsRequest;
use Revolution\Copilot\Types\Rpc\CatalogClientContract;
use Revolution\Copilot\Types\Rpc\CatalogGetGeneratedFeedRequest;
use Revolution\Copilot\Types\Rpc\CatalogGetSavedFeedRequest;
use Revolution\Copilot\Types\Rpc\CatalogMaterializationReference;
use Revolution\Copilot\Types\Rpc\CatalogSearchRequest;
use Revolution\Copilot\Types\Rpc\CatalogSelectionRequest;
use Revolution\Copilot\Types\Rpc\ExtensionLaunchProfile;
use Revolution\Copilot\Types\Rpc\ExtensionLaunchProviderResolveRequest;
use Revolution\Copilot\Types\Rpc\ExtensionLaunchProviderResolveResult;
use Revolution\Copilot\Types\Rpc\HooksDiscoverRequest;
use Revolution\Copilot\Types\Rpc\InstructionsDiscoverRequest;
use Revolution\Copilot\Types\Rpc\InstructionsGetDiscoveryPathsRequest;
use Revolution\Copilot\Types\Rpc\McpApplyInstallRequest;
use Revolution\Copilot\Types\Rpc\McpApplyUninstallRequest;
use Revolution\Copilot\Types\Rpc\McpInstallationOperationRequest;
use Revolution\Copilot\Types\Rpc\McpInstallationsRequest;
use Revolution\Copilot\Types\Rpc\McpPlanUninstallRequest;
use Revolution\Copilot\Types\Rpc\McpPrepareInstallRequest;
use Revolution\Copilot\Types\Rpc\McpRegistryCancelRequest;
use Revolution\Copilot\Types\Rpc\McpRegistrySearchRequest;
use Revolution\Copilot\Types\Rpc\McpServerCardReference;
use Revolution\Copilot\Types\Rpc\McpShouldExcludeGitHubToolsRequest;
use Revolution\Copilot\Types\Rpc\PluginsBuiltinSetRequest;
use Revolution\Copilot\Types\Rpc\PluginsDisableRequest;
use Revolution\Copilot\Types\Rpc\PluginsEnableRequest;
use Revolution\Copilot\Types\Rpc\PluginsInstallRequest;
use Revolution\Copilot\Types\Rpc\PluginsMarketplacesAddRequest;
use Revolution\Copilot\Types\Rpc\PluginsMarketplacesBrowseRequest;
use Revolution\Copilot\Types\Rpc\PluginsMarketplacesRefreshRequest;
use Revolution\Copilot\Types\Rpc\PluginsMarketplacesRemoveRequest;
use Revolution\Copilot\Types\Rpc\PluginsUninstallRequest;
use Revolution\Copilot\Types\Rpc\PluginsUpdateRequest;
use Revolution\Copilot\Types\Rpc\SessionsListRequest;
use Revolution\Copilot\Types\Rpc\SessionsPruneOldRequest;
use Revolution\Copilot\Types\Rpc\SessionsReadPersistedEventsRequest;
use Revolution\Copilot\Types\Rpc\SkillApplyInstallRequest;
use Revolution\Copilot\Types\Rpc\SkillApplyUninstallRequest;
use Revolution\Copilot\Types\Rpc\SkillInstallationOperationRequest;
use Revolution\Copilot\Types\Rpc\SkillInstallationsRequest;
use Revolution\Copilot\Types\Rpc\SkillPlanInstallRequest;
use Revolution\Copilot\Types\Rpc\SkillPlanInstallFromReferenceRequest;
use Revolution\Copilot\Types\Rpc\SkillPlanUninstallRequest;
use Revolution\Copilot\Types\Rpc\SkillSetEnabledRequest;
use Revolution\Copilot\Types\Rpc\SkillsGetDiscoveryPathsRequest;
use Revolution\Copilot\Types\Rpc\UIEphemeralQueryRequest;
use Revolution\Copilot\Types\SessionListFilter;
use Revolution\Copilot\Support\CopilotRequestContext;
use Revolution\Copilot\Support\CopilotRequestHandler;

Copilot::client()->rpc()->ping();

// models
Copilot::client()->rpc()->models()->list();
// Mit einem GitHub-Token pro Session abrufen
Copilot::client()->rpc()->models()->list(new ModelsListRequest(gitHubToken: $token));
// Einheit der Token-Preise der Modelle abrufen. Dieselben Kontoauswahl-Informationen wie bei models.list übergeben
$priceUnits = Copilot::client()->rpc()->models()->listTokenPriceUnits(
    new ModelsListTokenPriceUnitsRequest(gitHubToken: $token),
);
// $priceUnits->units enthält modelId und unit vom Typ TokenPriceUnit|string
foreach ($priceUnits->units as $priceUnit) {
    if ($priceUnit->unit === TokenPriceUnit::NanoAiu) {
        // Zur Umrechnung von nano-AIU in AI Credits durch 1,000,000,000 teilen
    }
}
// Integrierter Modellkatalog
Copilot::client()->rpc()->models()->getBuiltInCatalog();

// Azure ML: Verwaltung lokaler Modelle (experimental)
$azureMl = Copilot::client()->rpc()->azureMl();
$catalog = $azureMl->catalog(new AzureMlCatalogRequest(includeDev: false));
$latest = $azureMl->latest(new AzureMlLatestRequest(
    registry: AzureMlRegistry::AzureMl,
    name: 'phi',
));
$resolved = $azureMl->resolve(new AzureMlResolveRequest(
    registry: AzureMlRegistry::AzureMl,
    name: $latest->name,
    version: $latest->version,
));

// requestId und leaseId sind an diese SDK-Verbindung gebunden und dürfen nicht in einem anderen Client wiederverwendet werden
$lease = $azureMl->acquireFamily(new AzureMlAcquireFamilyRequest(
    registry: AzureMlRegistry::AzureMl,
    name: $latest->name,
));

try {
    $download = $azureMl->download(new AzureMlDownloadRequest(
        requestId: 'download-1',
        registry: AzureMlRegistry::AzureMl,
        name: $latest->name,
        version: $latest->version,
        destination: 'models/phi/'.$latest->version,
        leaseId: $lease->leaseId,
    ));
} finally {
    $azureMl->releaseFamily(new AzureMlReleaseFamilyRequest(
        leaseId: $lease->leaseId,
        registry: AzureMlRegistry::AzureMl,
        name: $latest->name,
    ));
}

// download() wartet bis zum Abschluss. Fortschrittsabfrage und Abbruch während der Verarbeitung
// erfolgen z. B. aus einer anderen Fiber mit demselben $azureMl derselben Verbindung
// $status = $azureMl->status(new AzureMlStatusRequest(requestId: 'download-1'));
// $cancelled = $azureMl->cancel(new AzureMlCancelRequest(requestId: 'download-1'));
// Der bool von cancel() zeigt an, dass die Abbruchanfrage angenommen wurde; den Abschluss der Bereinigung prüfen Sie über download()

// Inaktive Versionen löschen
$azureMl->discard(new AzureMlDiscardRequest(destination: 'models/phi/previous-version'));

// Die Typen von resolve() und download() haben keine eigenen Felder für signierte URLs
// download() hat standardmäßig kein Timeout. Um Sekunden anzugeben, übergeben Sie sie als zweites Argument

// Liste der integrierten Slash-Befehle, die in neuen Sessions verfügbar sind (experimental)
Copilot::client()->rpc()->commands()->list();

// Hook-Erkennung vor dem Sessionstart (experimental)
Copilot::client()->rpc()->hooks()->discover(new HooksDiscoverRequest(
    projectPaths: ['/path/to/project'],
));

// Sandbox-Unterstützung des Hosts (experimental)
$hostSupport = Copilot::client()->rpc()->sandbox()->getHostSupport();
// $hostSupport->supported, $hostSupport->reason, $hostSupport->capabilities

// tools
Copilot::client()->rpc()->tools()->list();

// account
Copilot::client()->rpc()->account()->getQuota();
// Mit einem GitHub-Token pro Session abrufen
Copilot::client()->rpc()->account()->getQuota(new AccountGetQuotaRequest(gitHubToken: $token));

// mcp config (Verwaltung der MCP-Server-Konfiguration)
Copilot::client()->rpc()->mcp()->list();
Copilot::client()->rpc()->mcp()->add(new McpConfigAddRequest(
    name: 'my-server',
    config: new McpServerValue(type: 'local', command: 'php', args: ['artisan', 'mcp']),
));
// args ist optional
Copilot::client()->rpc()->mcp()->update(new McpConfigUpdateRequest(
    name: 'my-server',
    config: new McpServerValue(type: 'http', url: 'https://mcp.example.com'),
));
Copilot::client()->rpc()->mcp()->remove(new McpConfigRemoveRequest(name: 'my-server'));
// MCP-Server aktivieren/deaktivieren (globale Einstellung)
Copilot::client()->rpc()->mcp()->enable(new McpConfigEnableRequest(names: ['my-server']));
Copilot::client()->rpc()->mcp()->disable(new McpConfigDisableRequest(names: ['my-server']));
// In-Memory-Cache leeren (beim nächsten Laden erneut von der Festplatte lesen)
Copilot::client()->rpc()->mcp()->reload();

// MCP-Registry-Suche (experimental/internal)
// $authInfo sind vom Host bereitgestellte JSON-Authentifizierungsdaten. Das SDK interpretiert deren Inhalt nicht.

$registry = Copilot::client()->rpc()->mcp()->registry();
$requestId = $registry->allocateRequestId()->requestId;
$servers = $registry->search(new McpRegistrySearchRequest(
    requestId: $requestId,
    authInfo: $authInfo, // Vom Host übergebene Authentifizierungsdaten. Das SDK interpretiert deren Inhalt nicht.
    query: 'database',
    limit: 20,
));
// $servers->servers enthält die Serverdaten der Registry (unverändert, ohne Interpretation der Struktur)
// Nicht verwendete reservierte IDs können freigegeben werden. Laufende Suchen brechen Sie ab, indem Sie cancel() aus einem anderen Ablauf aufrufen.
$unusedRequestId = $registry->allocateRequestId()->requestId;
$cancelResult = $registry->cancel(new McpRegistryCancelRequest(requestId: $unusedRequestId));
// Beim Freigeben einer unbenutzten ID ist canceled false. Nur beim Stoppen einer laufenden Suche ist es true.

// Installation / Deinstallation über den MCP-Katalog (experimental)
// Das Ergebnis ist ein assoziatives Array einer diskriminierten Union mit kind. Prüfen Sie kind, bevor Sie auf die einzelnen Felder zugreifen.

$mcp = Copilot::client()->rpc()->mcp();
$contract = new CatalogClientContract(
    protocolVersion: 1,
    requiredCapabilities: ['mcp-server-card', 'mcp-install-planning'],
);

// $candidateHandle, $searchId und $cardReference stammen aus dem Ergebnis der Katalogsuche.
// $sessionId ist die ID einer Session, die bereits mit diesem Client verbunden ist.
$planned = $mcp->planInstall([
    'contract' => $contract->toArray(),
    'source' => ['kind' => 'candidate', 'candidateHandle' => $candidateHandle, 'searchId' => $searchId],
]);

if (($planned['kind'] ?? null) === 'planned') {
    $plan = $planned['plan'];
    $prepared = $mcp->prepareInstall(new McpPrepareInstallRequest(
        contract: $contract,
        planHandle: $plan['planHandle'],
        choiceId: $plan['transportChoices'][0]['choiceId'],
        inputs: [],
        policySessionId: $sessionId,
        secrets: [],
        secretStorage: McpInstallationSecretStorage::Keychain,
        source: McpServerCardReference::fromArray($cardReference),
    ));

    // Während applyInstall wird der beim Erstellen des Clients konfigurierte installation_confirmation_handler aufgerufen.
    if (($prepared['kind'] ?? null) === 'outcome'
        && ($prepared['outcome']['kind'] ?? null) === 'install-prepared') {
        $applied = $mcp->applyInstall(new McpApplyInstallRequest(
            contract: $contract,
            operationId: $prepared['outcome']['operation']['operationId'],
            policySessionId: $sessionId,
        ));
    }
}

// Eigene Installationen auflisten und nicht abgeschlossene Operationen wiederherstellen
$installations = $mcp->installations();
$installations->list(new McpInstallationsRequest(contract: $contract, policySessionId: $sessionId));
$installations->recover(new McpInstallationsRequest(contract: $contract, policySessionId: $sessionId));
$installations->status(new McpInstallationOperationRequest($contract, $operationId));
$installations->cancel(new McpInstallationOperationRequest($contract, $operationId));

// Für die Deinstallation planen Sie mit einer installationId, die Ihnen gehört, und wenden das zurückgegebene planHandle an.
$uninstallPlan = $mcp->planUninstall(new McpPlanUninstallRequest(
    contract: $contract,
    installationId: $installationId,
    policySessionId: $sessionId,
));
if (($uninstallPlan['kind'] ?? null) === 'outcome'
    && ($uninstallPlan['outcome']['kind'] ?? null) === 'uninstall-planned') {
    $mcp->applyUninstall(new McpApplyUninstallRequest(
        contract: $contract,
        planHandle: $uninstallPlan['outcome']['plan']['planHandle'],
        policySessionId: $sessionId,
    ));
}

// Prüfen, ob GitHub-MCP-Tools ausgeschlossen werden können (experimental/internal)

$exclude = Copilot::client()->rpc()->mcp()->shouldExcludeGitHubTools(
    new McpShouldExcludeGitHubToolsRequest(
        availableTools: ['builtin:bash'],
        excludedTools: [],
        toolFilterPrecedence: OptionsUpdateToolFilterPrecedence::Available,
    ),
)->excludeGhReplaceableTools;

// user settings (Benutzereinstellungen)
// Die aktuelle CLI hat keinen user.settings.reload-RPC. get() bezieht sich auf settings.json.
Copilot::client()->rpc()->userSettings()->set(['settings' => ['theme' => 'dark']]); // kein Rückgabewert

// mcp discover (automatische Erkennung von MCP-Servern)
Copilot::client()->rpc()->mcp()->discover(new McpDiscoverRequest(
    workingDirectory: '/path/to/project',
));
// Auch ohne Argumente ausführbar
$result = Copilot::client()->rpc()->mcp()->discover();
// $result->servers ist ein Array von DiscoveredMcpServer

// llmInference (experimental: HTTP-Anfragen an die Modellschicht abfangen)
$client = Copilot::client([
    'request_handler' => new class extends CopilotRequestHandler
    {
        public function sendRequest(CopilotRequestContext $context, string $method, string $body): Response
        {
            $context->url = 'https://proxy.example.com/v1/chat/completions';
            $context->headers['X-Request-Source'] = ['laravel'];

            return parent::sendRequest($context, $method, $body);
        }
    },
]);

// Beim Start wird llmInference.setProvider gesendet, und httpRequestStart / httpRequestChunk werden empfangen.
// Ein Handler, der sendRequest nicht überschreibt, leitet HTTP/SSE transparent über den Laravel HTTP Client weiter.
// Bei Angabe einer Closure geben Sie eine Response in der Form fn (CopilotRequestContext $context, string $method, string $body): Response zurück.
// request_handler ist experimental. Der WebSocket-Transport wird nicht unterstützt und führt zu einer Fehlerantwort entsprechend 501.

// sessionFs (Registrierung eines Session-Dateisystem-Providers)
Copilot::client()->rpc()->sessionFs()->setProvider(new SessionFsSetProviderRequest(
    initialCwd: '/path/to/project',
    sessionStatePath: '.copilot/sessions',
    conventions: 'posix',
));

// Client-Option zum Auflösen der Startmethode von Erweiterungen (Antwort innerhalb von 15 Sekunden)
$client = Copilot::client([
    'extensionLaunchProvider' => fn (ExtensionLaunchProviderResolveRequest $request) => new ExtensionLaunchProviderResolveResult(
        launch: new ExtensionLaunchProfile(
            executable: '/usr/bin/node',
            args: [$request->modulePath],
        ),
    ),
]);
// Wenn keine passende Startmethode existiert, geben Sie null zurück.
// fn (ExtensionLaunchProviderResolveRequest $request) => null

$sessions = Copilot::client()->rpc()->sessions();

// sessions (experimental: Abfrage und Verwaltung persistierter Sessions)

$listed = $sessions->list(new SessionsListRequest(
    source: 'local',
    metadataLimit: 50,
    filter: new SessionListFilter(cwd: '/path/to/project'),
));
// Über isRemote jedes SessionMetadata zwischen lokalen und Remote-Sessions unterscheiden
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']]);
$sizes = $sessions->getSizes(); // $sizes->sizes ist Session-ID => Anzahl Bytes
$inUse = $sessions->checkInUse(['sessionIds' => ['session-id']]);
$deleted = $sessions->bulkDelete(['sessionIds' => ['session-id']]);

// Aktive Session schließen (Verlauf wird nicht gelöscht)
$sessions->close(['sessionId' => 'session-id']);

// Ausstehende Events auf die Festplatte speichern
$sessions->save(['sessionId' => 'session-id']);

// Die von diesem Prozess gehaltene In-Use-Sperre der Session explizit freigeben
$sessions->releaseLock(['sessionId' => 'session-id']);

// reloadPluginHooks lädt User-/Plugin-Hooks neu.
// Vor der Folder-Trust-Bestätigung werden Repo-Hooks zurückgestellt und nach der Vertrauensbestätigung nachgeladen.
$sessions->reloadPluginHooks([
    'sessionId' => 'session-id',
    'deferRepoHooks' => true,
]);
$loadedHooks = $sessions->loadDeferredRepoHooks(['sessionId' => 'session-id']);
// $loadedHooks->startupPrompts und $loadedHooks->hookCount

// Manager-weite zusätzliche Plugin-Konfiguration ersetzen (leeres Array zum Löschen)
$sessions->setAdditionalPlugins(['plugins' => []]);

// summary / context der lokalen Session-Metadaten ergänzen
$enriched = $sessions->enrichMetadata([
    'sessions' => [[
        'sessionId' => 'session-id',
        'startTime' => '2026-10-17T09:00:00Z',
        'modifiedTime' => '2026-10-17T09:00:00Z',
        'isRemote' => false,
    ]],
]);

// close() führt Shutdown, Event-Speicherung und Freigabe der Sperre durch und verwirft die aktive Session,
// löscht aber nicht den persistierten Verlauf. $session->disconnect() gibt per session.detach die Verbindung
// zu diesem SDK und die In-Memory-Ressourcen auf PHP-Seite frei. Zum Löschen persistierter Daten verwenden Sie bulkDelete().

// Persistierte Events ohne Öffnen der Session mit einem Cursor seitenweise lesen
$cursor = null;
do {
    $page = $sessions->readPersistedEvents(new SessionsReadPersistedEventsRequest(
        sessionId: 'session-id',
        cursor: $cursor,
        max: 100,
        direction: EventsReadDirection::FORWARD,
    ));

    foreach ($page->events as $event) {
        // Event verarbeiten
    }

    $cursor = $page->cursor;
} while ($page->hasMore);

// dryRun löscht nichts, sondern gibt Kandidaten und Schätzungen zurück. Zum tatsächlichen Löschen dryRun: false angeben
$preview = $sessions->pruneOld(new SessionsPruneOldRequest(
    olderThanDays: 30,
    dryRun: true,
));

// sessions.fork
$sessions->fork(new SessionsForkRequest(
    sessionId: 'source-session-id',
    toEventId: 'evt-boundary', // Optional: Nur Events vor dieser ID einschließen
));

// skills (Skill-Verwaltung auf Serverebene)
// Skills erkennen
$result = Copilot::client()->rpc()->skills()->discover();
// $result->skills ist ein Array von ServerSkill
// Optional Projektpfade angeben
$result = Copilot::client()->rpc()->skills()->discover(new SkillsDiscoverRequest(
    projectPaths: ['/path/to/project'],
    skillDirectories: ['/custom/skills'],
));

// Zu deaktivierende Skills festlegen
Copilot::client()->rpc()->skills()->config()->setDisabledSkills(
    new SkillsConfigSetDisabledSkillsRequest(disabledSkills: ['skill-name'])
);

// Einzelne Skills aktivieren/deaktivieren
Copilot::client()->rpc()->skills()->config()->setSkillDisabled(
    new SkillsConfigSetSkillDisabledRequest(name: 'skill-name', disabled: true)
);

// Skill-Kandidaten über catalog.search → catalog.select auswählen (experimental)

$contract = new CatalogClientContract(1, ['catalog-selection', 'ai-skill-installation']);
$catalog = Copilot::client()->rpc()->catalog();
$search = $catalog->search(new CatalogSearchRequest(
    contract: $contract,
    query: 'code review skill',
    kinds: [CatalogCandidateKind::AiSkill],
));
$selection = $catalog->select(new CatalogSelectionRequest(
    contract: $contract,
    sessionId: $sessionId,
    selectionRef: $search['candidates'][0]['selectionRef'],
    outcome: CatalogSelectionDecision::Selected,
));

// Für einen Kategoriefilter catalog-search-categories anfordern
$categoryContract = new CatalogClientContract(3, [
    CatalogCapability::CatalogSearchCategories->value,
]);
$categorySearch = $catalog->search(new CatalogSearchRequest(
    contract: $categoryContract,
    query: 'design tools',
    categories: ['design', 'test'],
));
// Bei Angabe von policySessionId fordern Sie im contract auch credential-required und session-bound an;
// die Bindung erfolgt nur an eine bestehende attached Session. Es wird keine Session neu erstellt oder fortgesetzt.

// Gespeicherte und generierte Catalog-Feeds (credential required)
$feedContract = new CatalogClientContract(3, [
    CatalogCapability::CatalogFeeds->value,
    CatalogCapability::CatalogSearchCredentialRequired->value,
]);
$savedFeed = $catalog->getSavedFeed(new CatalogGetSavedFeedRequest(
    contract: $feedContract,
    feedId: 'opaque-feed-id',
    trustTiers: [CatalogTrustTier::T1],
));

// Für die Bindung an eine bestehende attached Session zusätzlich die session-bound-Capability anfordern
$sessionFeedContract = new CatalogClientContract(3, [
    CatalogCapability::CatalogFeeds->value,
    CatalogCapability::CatalogSearchCredentialRequired->value,
    CatalogCapability::CatalogSearchSessionBound->value,
]);
$generatedFeed = $catalog->getGeneratedFeed(new CatalogGetGeneratedFeedRequest(
    contract: $sessionFeedContract,
    strategy: 'telemetry',
    key: 'popular',
    policySessionId: $sessionId,
    trustTiers: [CatalogTrustTier::T1, CatalogTrustTier::T2],
));
// entries behalten die Feed-Reihenfolge bei. Einträge, die nicht zum Trust-Tier passen, behalten als filtered ihre Position,
// und nicht anzeigbare Einträge werden als unavailable mit reason zurückgegeben.
// Existiert kein Feed, gilt kind=unavailable, reason=feed-not-found. Auch Authentifizierungs-, Aushandlungs- und Richtlinienablehnungen
// werden als jeweils typisierte Ergebnisse zurückgegeben; Catalog-Feed-RPCs führen keine Installationen oder Konfigurationen durch.

// Installationsplan für Skills erstellen und anwenden

$skills = Copilot::client()->rpc()->skills();
if ($selection['kind'] === 'selected') {
    $planned = $skills->planInstall(new SkillPlanInstallRequest(
        contract: $contract,
        candidateHandle: $selection['candidateHandle'],
        policySessionId: $sessionId,
    ));
    if ($planned->kind === SkillInstallationManagementResultKind::Outcome
        && $planned->outcome?->kind === SkillInstallationManagementOutcomeKind::InstallPlanned) {
        // applyInstall() wird nach der Bestätigung über installations.confirm angewendet
        $result = $skills->applyInstall(new SkillApplyInstallRequest(
            contract: $contract,
            planHandle: $planned->outcome->plan['planHandle'],
            policySessionId: $sessionId,
        ));
    }
}

// Skill-Installation aus einer Materialisation Reference von Agent Finder planen
$referenceContract = new CatalogClientContract(3, [
    'skill-confirmed-installation',
    'skill-reference-installation',
]);
$referencePlan = $skills->planInstallFromReference(new SkillPlanInstallFromReferenceRequest(
    contract: $referenceContract,
    reference: new CatalogMaterializationReference(
        resourceId: '12345',
        revisionId: '67890',
        schemaVersion: '1.0.0',
        descriptorDigest: 'sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
        bundleDigest: 'sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb',
    ),
    policySessionId: $sessionId,
));
// Bei Erfolg gilt $referencePlan->kind === SkillInstallationManagementResultKind::Outcome,
// $referencePlan->outcome->kind === SkillInstallationManagementOutcomeKind::InstallPlanned.
// Die Planung selbst hat keine Nebenwirkungen; sie holt den Descriptor von der festen Agent-Finder-Authority
// und gleicht die Digests von Descriptor und Bundle ab. Prüfen Sie den Inhalt und schließen Sie den bestehenden Bestätigungsablauf ab, bevor Sie applyInstall() ausführen.
// invalid-reference, descriptor-not-found, descriptor-withdrawn, digest-mismatch und
// unsupported-resource werden als Ablehnungsgründe im Planergebnis zurückgegeben.
// Die GitHub-Ablehnungsgründe source-rate-limited, no-credential und credential-rejected werden
// über SkillInstallationFailureReason unterschieden; retryAfterSeconds wird nur bei source-rate-limited zurückgegeben.
// Die message bei network-failure ist eine sichere Beschreibung ohne URLs, Suchanfragen, Handles oder Secrets.

// Installierte Skills und laufende Operationen
$installations = $skills->installations();
$owned = $installations->list(new SkillInstallationsRequest($contract, $sessionId));
$pending = $installations->recover(new SkillInstallationsRequest($contract, $sessionId));
$status = $installations->status(new SkillInstallationOperationRequest($contract, 'operation-id'));
$cancelled = $installations->cancel(new SkillInstallationOperationRequest($contract, 'operation-id'));
$enabled = $installations->setEnabled(new SkillSetEnabledRequest(
    contract: $contract,
    installationId: 'installation-id',
    enabled: true,
    policySessionId: $sessionId,
));

// Auch die Deinstallation wird erst nach Prüfung des Plans angewendet
$removalPlan = $skills->planUninstall(new SkillPlanUninstallRequest(
    contract: $contract,
    installationId: 'installation-id',
    policySessionId: $sessionId,
));
$removed = $skills->applyUninstall(new SkillApplyUninstallRequest(
    contract: $contract,
    planHandle: $removalPlan['planHandle'],
    policySessionId: $sessionId,
));

// skills: Verzeichnisse abrufen, in denen Skills erstellt werden können (experimental)
// Liste der Verzeichnisse, in denen die Runtime abgelegte Skills erkennt

$result = Copilot::client()->rpc()->skills()->getDiscoveryPaths();
// $result->paths ist ein Array von SkillDiscoveryPath
// $result->paths[0]->path - Verzeichnispfad
// $result->paths[0]->scope - Scope (user, project, plugin)
// $result->paths[0]->preferredForCreation - Ob es das empfohlene Verzeichnis für Neuanlagen ist
// Optional nach Scope filtern
$result = Copilot::client()->rpc()->skills()->getDiscoveryPaths(
    new SkillsGetDiscoveryPathsRequest(scope: 'project')
);

// plugins (Plugin-Verwaltung im Server-Scope)

$plugins = Copilot::client()->rpc()->plugins();
$result = $plugins->list(); // Rückgabewert ist PluginList
$installed = $plugins->install(new PluginsInstallRequest(source: 'eslint@official'));
$plugins->uninstall(new PluginsUninstallRequest(name: 'eslint@official'));
$plugins->update(new PluginsUpdateRequest(name: 'eslint@official'));
$plugins->updateAll();
$plugins->enable(new PluginsEnableRequest(names: ['eslint@official']));
$plugins->disable(new PluginsDisableRequest(names: ['eslint@official']));

// Verzeichnisse für integrierte Plugins festlegen
$plugins->builtin()->set(new PluginsBuiltinSetRequest(paths: ['/opt/copilot/plugins']));

// Verzeichnisse für alle Sessions, die in der Client-Konfiguration angegeben sind,
// registriert Client::start() automatisch vor dem Erstellen der ersten Session
// config/copilot.php: 'builtin_plugin_directories' => ['/opt/copilot/plugins']

// Marketplace-Verwaltung
$marketplaces = $plugins->marketplaces();
$marketplaces->list();
$marketplaces->add(new PluginsMarketplacesAddRequest(source: 'github/copilot-plugins'));
$marketplaces->remove(new PluginsMarketplacesRemoveRequest(name: 'official', force: true));
$marketplaces->browse(new PluginsMarketplacesBrowseRequest(name: 'official'));
$marketplaces->refresh(new PluginsMarketplacesRefreshRequest(name: 'official'));

// agents (experimental: Verwaltung benutzerdefinierter Agents)
// Benutzerdefinierte Agents erkennen

$result = Copilot::client()->rpc()->agents()->discover();
// $result->agents ist ein Array von AgentInfo
$result = Copilot::client()->rpc()->agents()->discover(new AgentsDiscoverRequest(
    projectPaths: ['/path/to/project'],
    excludeHostAgents: true,
));

// Verzeichnisse abrufen, in denen Agents erstellt werden können (experimental)

$result = Copilot::client()->rpc()->agents()->getDiscoveryPaths();
// $result->paths ist ein Array von AgentDiscoveryPath
// $result->paths[0]->path - Verzeichnispfad
// $result->paths[0]->scope - Scope (user, project, plugin)
// $result->paths[0]->preferredForCreation - Ob es das empfohlene Verzeichnis für Neuanlagen ist
$result = Copilot::client()->rpc()->agents()->getDiscoveryPaths(
    new AgentsGetDiscoveryPathsRequest(scope: 'user')
);

// instructions (experimental: Verwaltung von Instructions)
// Instructions erkennen

$result = Copilot::client()->rpc()->instructions()->discover();
// $result->sources ist ein Array von InstructionSource
$result = Copilot::client()->rpc()->instructions()->discover(
    new InstructionsDiscoverRequest(projectPaths: ['/path/to/project'])
);

// Dateien/Verzeichnisse abrufen, in denen Instructions erstellt werden können (experimental)

$result = Copilot::client()->rpc()->instructions()->getDiscoveryPaths();
// $result->paths ist ein Array von InstructionDiscoveryPath
// $result->paths[0]->path - Datei-/Verzeichnispfad
// $result->paths[0]->location - Ort (user, repository, working-directory, plugin)
// $result->paths[0]->kind - Art (file, directory)
// $result->paths[0]->preferredForCreation - Ob es für Neuanlagen empfohlen ist
$result = Copilot::client()->rpc()->instructions()->getDiscoveryPaths(
    new InstructionsGetDiscoveryPathsRequest(location: 'repository')
);

// extensions (experimental: Verwaltung persistierter Erweiterungen)
$result = Copilot::client()->rpc()->extensions()->discover();
Copilot::client()->rpc()->extensions()->enable(['ids' => ['user:demo']]);
Copilot::client()->rpc()->extensions()->disable(['ids' => ['plugin:demo']]);

// environments (experimental: GitHub-Mission-Control-Umgebungen suchen, abrufen und löschen)
$result = Copilot::client()->rpc()->environments()->list(['kind' => 'user-local']);
// $result->environments ist ein Array von GitHubEnvironment
$env = Copilot::client()->rpc()->environments()->get(['environmentId' => 'env-id']);
Copilot::client()->rpc()->environments()->delete(['environmentId' => 'env-id']);

use Revolution\Copilot\Enums\CatalogReferenceInstallationResultKind;
use Revolution\Copilot\Enums\PluginInstallationManagementOutcomeKind;
use Revolution\Copilot\Types\Rpc\CatalogClientContract;
use Revolution\Copilot\Types\Rpc\PluginApplyInstallRequest;
use Revolution\Copilot\Types\Rpc\PluginPlanInstallRequest;

$contract = new CatalogClientContract(3, [
    'agent-plugin-confirmed-installation',
]);
$plugins = Copilot::client()->rpc()->plugins();

$planned = $plugins->planInstall(new PluginPlanInstallRequest(
    candidateHandle: $candidateHandle,
    contract: $contract,
    policySessionId: $sessionId,
));

if ($planned->kind === CatalogReferenceInstallationResultKind::Outcome
    && $planned->outcome?->kind === PluginInstallationManagementOutcomeKind::InstallPlanned) {
    $applied = $plugins->applyInstall(new PluginApplyInstallRequest(
        contract: $contract,
        planHandle: $planned->outcome->plan->planHandle,
        policySessionId: $sessionId,
    ));
}

use Revolution\Copilot\Enums\CatalogCapability;
use Revolution\Copilot\Enums\CatalogReferenceInstallationOutcomeKind;
use Revolution\Copilot\Enums\CatalogReferenceInstallationResultKind;
use Revolution\Copilot\Types\Rpc\CatalogClientContract;
use Revolution\Copilot\Types\Rpc\CatalogPlanInstallFromReferenceRequest;
use Revolution\Copilot\Types\Rpc\PluginApplyInstallRequest;

$referenceContract = new CatalogClientContract(3, [
    CatalogCapability::CatalogReferenceInstallation->value,
    CatalogCapability::AgentPluginConfirmedInstallation->value,
]);
$planned = Copilot::client()->rpc()->catalog()->planInstallFromReference(
    new CatalogPlanInstallFromReferenceRequest(
        contract: $referenceContract,
        policySessionId: $sessionId,
        reference: $reference,
    ),
);

$plugins = Copilot::client()->rpc()->plugins();
if ($planned->kind === CatalogReferenceInstallationResultKind::Outcome
    && $planned->outcome?->kind === CatalogReferenceInstallationOutcomeKind::PluginInstallPlanned) {
    $plugins->applyInstall(new PluginApplyInstallRequest(
        contract: $referenceContract,
        planHandle: $planned->outcome->plan->planHandle,
        policySessionId: $sessionId,
    ));
}

use Revolution\Copilot\Types\Rpc\ContentExclusionValidatePoliciesRequest;

$result = Copilot::client()->rpc()->contentExclusion()->validatePolicies(
    new ContentExclusionValidatePoliciesRequest(policiesJson: $policiesJson),
);
// $result->policies sind die validierten und normalisierten Richtlinien

$managedSettings = $client->rpc()->managedSettings()->read();
$effective = $client->rpc()->managedSettings()->resolve([
    'selectionId' => 'selection-id',
    'workingDirectory' => '/path/to/project',
]);
$schema = $client->rpc()->managedSettings()->schema();
$validation = $client->rpc()->managedSettings()->validate(['content' => ['permissions' => []]]);
$preview = $client->rpc()->managedSettings()->compose(['layers' => [
    ['source' => 'device', 'settings' => ['permissions' => []]],
]]);
$client->rpc()->managedSettings()->clearCache();

$result = Copilot::client()->rpc()->host()->unpublishSession([
    'hostId' => 'host-1',
    'sessionId' => 'session-1',
]);
// $result->unpublished

Copilot::client()->rpc()->host()->dispose(['hostId' => 'host-1']);

use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\ModeSetRequest;
use Revolution\Copilot\Types\Rpc\PlanReadResult;

Copilot::start(function (CopilotSession $session) {
    $session->rpc()->mode()->set(new ModeSetRequest(mode: 'plan'));

    $response = $session->sendAndWait(prompt: 'Erstelle einen Plan für ...');

    $result = $session->rpc()->plan()->read();
    dump($result->content);

    $session->rpc()->mode()->set(new ModeSetRequest(mode: 'autopilot'));

    $response = $session->sendAndWait(prompt: 'Setze es gemäß dem Plan um');
    dump($response->content());
});

use Revolution\Copilot\Enums\DebugCollectLogsEntryKind;
use Revolution\Copilot\Enums\DebugCollectLogsRedaction;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsDestination;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsEntry;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsRequest;

$result = $session->rpc()->debug()->collectLogs(new DebugCollectLogsRequest(
    destination: DebugCollectLogsDestination::archive('/tmp/copilot-debug.tgz', noOverwrite: true),
    additionalEntries: [
        new DebugCollectLogsEntry(
            kind: DebugCollectLogsEntryKind::File,
            path: '/var/log/my-app.log',
            bundlePath: 'application/my-app.log',
            redaction: DebugCollectLogsRedaction::PlainText,
            required: true,
        ),
    ],
));

use Revolution\Copilot\Types\Rpc\ContentExclusionCheckPathsRequest;

$result = $session->rpc()->contentExclusion()->checkPaths(
    new ContentExclusionCheckPathsRequest(paths: [
        '/workspace/private.txt',
        '/workspace/public.txt',
    ]),
);

if ($result->isExcluded('/workspace/private.txt')) {
    // Ausgeschlossen oder nicht sicher bestimmbar.
}

use Revolution\Copilot\Types\Rpc\MCPAppsDiagnoseRequest;
use Revolution\Copilot\Types\Rpc\MCPAppsListToolsRequest;
use Revolution\Copilot\Types\Rpc\McpAppsCallToolRequest;
use Revolution\Copilot\Types\Rpc\McpAppsReadResourceRequest;
use Revolution\Copilot\Types\Rpc\McpAppsSetHostContextDetails;
use Revolution\Copilot\Types\Rpc\McpAppsSetHostContextRequest;

$apps = $session->rpc()->mcp()->apps();

$tools = $apps->listTools(new MCPAppsListToolsRequest(
    serverName: 'my-server',
    originServerName: 'my-server',
));
$result = $apps->callTool(new McpAppsCallToolRequest(
    serverName: 'my-server',
    toolName: 'lookup',
    originServerName: 'my-server',
    arguments: ['query' => 'hello'],
));
$resource = $apps->readResource(new McpAppsReadResourceRequest(
    serverName: 'my-server',
    uri: 'ui://my-app/index.html',
));
$context = $apps->getHostContext();
$apps->setHostContext(new McpAppsSetHostContextRequest(
    context: new McpAppsSetHostContextDetails(theme: 'dark', locale: 'ja-JP'),
));
$diagnostics = $apps->diagnose(new MCPAppsDiagnoseRequest(serverName: 'my-server'));

// model
$session->rpc()->model()->getCurrent();
// Anzeigerichtlinie für reasoning summaries des aktuellen Modells abrufen (experimental)
$policy = $session->rpc()->model()->getReasoningSummaries(new ModelGetReasoningSummariesRequest(
    persistedShowReasoning: true, // Weglassen, wenn nicht gesetzt
    summariesVisible: true, // Ob sie aktuell in der Host-UI angezeigt werden
));
// $policy->ready, $policy->sessionShowsSummaries, $policy->visibility usw.
// Nur den reasoning effort ändern, ohne das ausgewählte Modell zu wechseln (experimental)
$effort = $session->rpc()->model()->setReasoningEffort(
    new ModelSetReasoningEffortRequest(reasoningEffort: ReasoningEffort::HIGH),
);
// $effort->reasoningEffort
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'gpt-4'));
// Mit Angabe von reasoningEffort (nur unterstützte Modelle)
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'claude-opus-4.7', reasoningEffort: ReasoningEffort::HIGH));
// Mit Angabe von reasoningSummary
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'claude-opus-4.7', reasoningSummary: 'concise'));
// Mit Angabe von contextTier (nur unterstützte Modelle)
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'gpt-4o', contextTier: 'long_context'));
// modelCapabilities überschreiben
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(
    modelId: 'gpt-4',
    modelCapabilities: new ModelCapabilitiesOverride(
        supports: new ModelCapabilitiesOverrideSupports(vision: true),
    ),
));
// Liste der in der Session verfügbaren Modelle abrufen (experimental)
$models = $session->rpc()->model()->list();
$models->auto?->tiers; // Für das Konto verfügbare Auto-Routing-Präferenzen
$session->rpc()->model()->list(new ModelListRequest(skipCache: true)); // Cache überspringen

// Auto-Routing-Präferenz ändern (ausgewähltes Modell bleibt unverändert, experimental)
$session->rpc()->model()->switchAutoTier(new ModelSwitchAutoTierRequest(autoTier: AutoTier::BALANCE));
$session->rpc()->model()->switchAutoTier(new ModelSwitchAutoTierRequest(autoTier: null)); // Zum provider-default Auto-Routing zurückkehren

// Allowlist der Modelle für die Session auf Host-Seite setzen bzw. aufheben (experimental)
$session->rpc()->model()->setAllowedModels(new ModelSetAllowedModelsRequest(allowedModels: ['gpt-5']));
$session->rpc()->model()->setAllowedModels(new ModelSetAllowedModelsRequest(allowedModels: null)); // Einschränkung aufheben

// Auch mit dem Helper setModel() lassen sich reasoningEffort und modelCapabilities angeben
$session->setModel('claude-opus-4.7', ReasoningEffort::HIGH);
$session->setModel('claude-opus-4.7', 'high'); // Auch als String möglich
$session->setModel('gpt-4', modelCapabilities: ['supports' => ['vision' => true]]); // Auch als Array möglich
// Mit Angabe von autoTier (nur wirksam, wenn modelId 'auto' ist)
$session->setModel('auto', autoTier: AutoTier::INTELLIGENCE);

// Mit dem Helper setAutoTier() nur die Auto-Routing-Präferenz ändern, ohne das Modell zu wechseln (experimental)
$session->setAutoTier(AutoTier::EFFICIENCY);

// mode
$session->rpc()->mode()->get();
$modeResult = $session->rpc()->mode()->set(new ModeSetRequest(mode: 'plan'));
// $modeResult->modeApplied, $modeResult->modelChanged, $modeResult->confirmation usw.

// name
$session->rpc()->name()->get();
$session->rpc()->name()->set(new NameSetRequest(name: 'My Session'));
// Zusammenfassung als Session-Namen übernehmen, wenn der Benutzer keinen Namen gesetzt hat (experimental)
$autoName = $session->rpc()->name()->setAuto(new NameSetAutoRequest(summary: 'Summary of the session'));
// $autoName->applied

// plan
$session->rpc()->plan()->read();
$session->rpc()->plan()->update(new PlanUpdateRequest(content: '...'));
$session->rpc()->plan()->delete();
// SQLite-Todo-Liste lesen (Planmodus)
$result = $session->rpc()->plan()->readSqlTodos();
// $result->rows - Array von PlanSqlTodosRow (id, title, description, status)

// SQLite-Todo-Liste mit Abhängigkeiten lesen (experimental)
$result = $session->rpc()->plan()->readSqlTodosWithDependencies();
// $result->rows - Array von PlanSqlTodosRow
// $result->dependencies - Array von PlanSqlTodoDependency (todo_id, depends_on)

// workspaces
$session->rpc()->workspaces()->getWorkspace();
$session->rpc()->workspaces()->listFiles();
$session->rpc()->workspaces()->readFile(new WorkspacesReadFileRequest(path: 'file.txt'));
$session->rpc()->workspaces()->createFile(new WorkspacesCreateFileRequest(path: 'file.txt', content: '...'));
$session->rpc()->workspaces()->statFile(new WorkspacesStatFileRequest(path: 'file.txt'));
$session->rpc()->workspaces()->createDirectory(new WorkspacesCreateDirectoryRequest(path: 'new/dir', recursive: true));
$session->rpc()->workspaces()->removePath(new WorkspacesRemovePathRequest(path: 'old/dir', recursive: true, force: true));
$session->rpc()->workspaces()->renamePath(new WorkspacesRenamePathRequest(source: 'old.txt', destination: 'new.txt'));

// instructions (Instruction-Quellen der Session abrufen)
$result = $session->rpc()->instructions()->getSources();
// $result->sources - Array von InstructionsSources
$session->rpc()->instructions()->reload();

// LSP-Konfiguration explizit neu laden (experimental)
$session->rpc()->lsp()->initialize([
    'workingDirectory' => base_path(),
    'gitRoot' => base_path(),
    'force' => true,
]);

// instructions discover (Instruction-Dateien erkennen)
use Revolution\Copilot\Types\Rpc\InstructionsDiscoverRequest;

$result = $session->rpc()->instructions()->discover();
// $result->sources - Array von InstructionSource
$result = $session->rpc()->instructions()->discover(new InstructionsDiscoverRequest(
    projectPaths: ['/path/to/project'],
    excludeHostInstructions: true, // Instructions auf Host-Ebene ausschließen
));

// fleet
$session->rpc()->fleet()->start(new FleetStartRequest(prompt: '...'));
// Details siehe fleet-mode.md

// agent
$session->rpc()->agent()->list();
$session->rpc()->agent()->getCurrent();
$session->rpc()->agent()->select(new AgentSelectRequest(agentId: '...'));
$session->rpc()->agent()->deselect();
$session->rpc()->agent()->reload();

// skills (experimental: Skill-Verwaltung)
$session->rpc()->skills()->list();
$session->rpc()->skills()->enable(new SkillsEnableRequest(name: 'skill-name'));
$session->rpc()->skills()->disable(new SkillsDisableRequest(name: 'skill-name'));
$session->rpc()->skills()->reload();
$session->rpc()->skills()->ensureLoaded(); // Noch nicht geladene Skills laden (kein erneutes Laden)
$invoked = $session->rpc()->skills()->getInvoked();
// $invoked->skills - Verlauf der in der Session aufgerufenen Skills

// mcp (experimental: Verwaltung von MCP-Servern)
$servers = $session->rpc()->mcp()->list();
// Konfigurierte URL eines HTTP/SSE-Servers: $servers->servers[0]->url
$session->rpc()->mcp()->enable(new McpEnableRequest(serverName: 'server-name'));
$session->rpc()->mcp()->disable(new McpDisableRequest(serverName: 'server-name'));
$session->rpc()->mcp()->reload();
// Laufendes MCP-Laden in den Hintergrund verschieben (wartenden Turn freigeben)
$session->rpc()->mcp()->moveLoadingToBackground();

// MCP-Server innerhalb der Session starten/neu starten (persistente Konfiguration bleibt unverändert)
use Revolution\Copilot\Types\Rpc\McpRestartServerRequest;
use Revolution\Copilot\Types\Rpc\McpStartServerRequest;

$session->rpc()->mcp()->startServer(new McpStartServerRequest(
    serverName: 'server-name',
    config: ['type' => 'http', 'url' => 'https://mcp.example.com'],
));
$session->rpc()->mcp()->restartServer(new McpRestartServerRequest(
    serverName: 'server-name',
    expectedInstallationId: 'installation-id',
));

// Automatisch verwalteten GitHub-MCP-Server entfernen und Auflösungsmodus für Umgebungsvariablenwerte festlegen
$removed = $session->rpc()->mcp()->removeGitHub();
$mode = $session->rpc()->mcp()->setEnvValueMode(['mode' => 'indirect']);
// $removed->removed, $mode->mode

// MCP-Sampling ausführen und abbrechen
use Revolution\Copilot\Types\Rpc\McpCancelSamplingExecutionParams;
use Revolution\Copilot\Types\Rpc\McpExecuteSamplingParams;

$sampling = $session->rpc()->mcp()->executeSampling(new McpExecuteSamplingParams(
    requestId: 'sampling-1',
    serverName: 'server-name',
    mcpRequestId: 'mcp-request-1',
    request: ['messages' => [], 'maxTokens' => 256],
));
$cancelled = $session->rpc()->mcp()->cancelSamplingExecution(
    new McpCancelSamplingExecutionParams(requestId: 'sampling-1'),
);

// Prüfen, ob ein MCP-Server läuft
use Revolution\Copilot\Types\Rpc\McpIsServerRunningRequest;

$result = $session->rpc()->mcp()->isServerRunning(new McpIsServerRunningRequest(serverName: 'my-server'));
// $result->running - Ob der Server läuft

// Tool-Liste eines MCP-Servers abrufen
use Revolution\Copilot\Types\Rpc\McpListToolsRequest;

$result = $session->rpc()->mcp()->listTools(new McpListToolsRequest(serverName: 'my-server'));
// $result->tools - Array von McpTools (name, description)

// MCP-Prompts auflisten und abrufen (experimental)
use Revolution\Copilot\Types\Rpc\McpPromptsGetRequest;
use Revolution\Copilot\Types\Rpc\McpPromptsListRequest;

$prompts = $session->rpc()->mcp()->listPrompts(new McpPromptsListRequest(serverName: 'my-server'));
$rendered = $session->rpc()->mcp()->getPrompt(new McpPromptsGetRequest(
    serverName: 'my-server',
    promptName: 'summarize',
    arguments: ['document' => 'README.md'],
));
// $prompts->prompts - MCP-Prompt-Definitionen
// $rendered->messages - Gerenderter Prompt (wird nicht an das Modell gesendet)

// MCP-Server stoppen
use Revolution\Copilot\Types\Rpc\McpStopServerRequest;

$session->rpc()->mcp()->stopServer(new McpStopServerRequest(serverName: 'my-server'));

// Liste der MCP-Ressourcen abrufen (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesListRequest;

$result = $session->rpc()->mcp()->resources()->list(new McpResourcesListRequest(serverName: 'my-server'));
// $result->resources - Array von McpResource (uri, name, title, mimeType usw.)
// $result->nextCursor - Cursor für die nächste Seite (falls vorhanden)

// MCP-Ressource abrufen (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesReadRequest;

$result = $session->rpc()->mcp()->resources()->read(new McpResourcesReadRequest(serverName: 'my-server', uri: 'ui://example'));
// $result->contents - Array von McpResourceContent

// Liste der MCP-Ressourcenvorlagen abrufen (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesListTemplatesRequest;

$result = $session->rpc()->mcp()->resources()->listTemplates(new McpResourcesListTemplatesRequest(serverName: 'my-server'));
// MCP-OAuth-Anmeldung (für MCP-Server, die eine Authentifizierung erfordern)
use Revolution\Copilot\Types\Rpc\McpOauthCompleteRequest;
use Revolution\Copilot\Types\Rpc\McpOauthLoginRequest;
use Revolution\Copilot\Types\Rpc\McpOauthProbeRequest;
use Revolution\Copilot\Types\Rpc\SessionMcpOauthCancelLoginRequest;
use Revolution\Copilot\Types\Rpc\SessionMcpOauthPrepareLoginRequest;

$result = $session->rpc()->mcp()->login(new McpOauthLoginRequest(serverName: 'my-server'));
// $result->authorizationUrl - URL des OAuth-Flows (falls eine Authentifizierung erforderlich ist)
// Beim hostverwalteten OAuth-Redirect-Flow redirectUri angeben und nach dem Callback complete() aufrufen
$result = $session->rpc()->mcp()->login(new McpOauthLoginRequest(
    serverName: 'my-server',
    redirectUri: 'http://localhost:3000/oauth/callback',
));
$session->rpc()->mcp()->complete(new McpOauthCompleteRequest(
    authorizationId: $result->authorizationId,
    callbackUrl: $callbackUrl,
));

// OAuth-Status prüfen und eine an die eigene Installation gebundene Anmeldung vorbereiten bzw. abbrechen
$probe = $session->rpc()->mcp()->oauth()->probe(new McpOauthProbeRequest(serverName: 'my-server'));
$prepared = $session->rpc()->mcp()->oauth()->prepareLogin(new SessionMcpOauthPrepareLoginRequest(
    serverName: 'my-server',
    expectedInstallationId: 'installation-id',
));
$cancelled = $session->rpc()->mcp()->oauth()->cancelLogin(new SessionMcpOauthCancelLoginRequest(
    expectedInstallationId: 'installation-id',
    loginId: $prepared->loginId,
));

// plugins (experimental: Plugin-Liste)
$session->rpc()->plugins()->list();
// Plugins neu laden
$session->rpc()->plugins()->reload();
// Mit Optionen neu laden
use Revolution\Copilot\Types\Rpc\PluginsReloadRequest;

$session->rpc()->plugins()->reload(new PluginsReloadRequest(
    reloadMcp: true,      // MCP-Server-Konfiguration neu laden
    reloadHooks: true,    // Hooks neu laden
    reloadCustomAgents: false, // Benutzerdefinierte Agents nicht neu laden
));

// extensions (experimental: Verwaltung von Extensions)
$session->rpc()->extensions()->list();
$session->rpc()->extensions()->enable(new ExtensionsEnableRequest(id: 'project:my-ext'));
$session->rpc()->extensions()->disable(new ExtensionsDisableRequest(id: 'project:my-ext'));
$session->rpc()->extensions()->reconcile(); // host-only: effektive Membership neu synchronisieren und die settled list zurückgeben
$session->rpc()->extensions()->reload();

// compaction → in history umbenannt
$session->rpc()->history()->compact();
// Manuelle Komprimierung abbrechen / Hintergrundkomprimierung abbrechen
$session->rpc()->history()->abortManualCompaction();
$session->rpc()->history()->cancelBackgroundCompaction();
// Zusammenfassung für die Übergabe an eine andere Session abrufen
$summary = $session->rpc()->history()->summarizeForHandoff()->summary;
// Verlauf ab einem bestimmten Event kürzen
$session->rpc()->history()->truncate(new HistoryTruncateRequest(
    eventId: 'evt-123', // Dieses Event und alle nachfolgenden Events werden gelöscht
));

// tools (Protokoll v3+: Antwort auf external_tool.requested-Events)
// Aktuell in der Session bereitgestellte Tools über die native Aufrufpipeline ausführen (experimental)
use Revolution\Copilot\Types\Rpc\ToolsExecuteRequest;

$result = $session->rpc()->tools()->execute(new ToolsExecuteRequest(
    name: 'search',
    arguments: ['query' => 'Laravel'],
    toolCallId: 'call-123', // Optional. Zur Korrelation mit dem Aufruf
));

if (is_string($result)) {
    // Einfaches Textergebnis
    echo $result;
} else {
    // ToolResultExpanded: textResultForLlm, resultType, newMessages,
    // mcpMeta, structuredContent, taskCompletionDecision usw.
    echo $result->textResultForLlm;
    // resultType enthält ToolResultType oder einen string mit einem unbekannten Wert
}

// Auch als Array möglich. toolCallId kann weggelassen werden; sessionId wird mit dem Wert dieser Session überschrieben
$session->rpc()->tools()->execute([
    'name' => 'search',
    'arguments' => ['query' => 'Copilot'],
]);
// arguments: [] wird als JSON-Objekt {} gesendet; scalar/null/nicht leere Arrays behalten ihren JSON-Wert

// execute() durchläuft die normale native Tool-Aufrufpipeline und umgeht daher keine Berechtigungsprüfungen.
// Wenn ein Tool eine Genehmigung benötigt, wird dies wie gewohnt vom onPermissionRequest-Handler der SessionConfig verarbeitet.
$session->rpc()->tools()->handlePendingToolCall(new HandlePendingToolCallRequest(
    requestId: '...',
    result: 'Ergebnis der Tool-Ausführung',
));
// Aktuelle Tool-Metadaten der Session abrufen (experimental)
$session->rpc()->tools()->getCurrentMetadata();
// Die von dieser Verbindung bereitgestellten externen Tools vollständig ersetzen (experimental)
$session->rpc()->tools()->set(['tools' => [
    ['name' => 'search', 'description' => 'Search documents', 'parameters' => ['type' => 'object']],
]]);
// Einstellungen für Subagents aktualisieren (experimental)
use Revolution\Copilot\Types\Rpc\SubagentSettings;
use Revolution\Copilot\Types\Rpc\SubagentSettingsEntry;
use Revolution\Copilot\Types\Rpc\UpdateSubagentSettingsRequest;

$result = $session->rpc()->tools()->updateSubagentSettings(new UpdateSubagentSettingsRequest(
    settings: new SubagentSettings(entries: [
        new SubagentSettingsEntry(agentName: 'my-agent', contextTier: 'medium', enabled: true),
    ]),
));
// $result->settings - Aktualisierte SubagentSettings

// permissions (Protokoll v3+: Antwort auf permission.requested-Events)
use Revolution\Copilot\Types\Rpc\FolderTrustAddParams;
use Revolution\Copilot\Types\Rpc\PermissionLocationAddToolApprovalParams;
use Revolution\Copilot\Types\Rpc\PermissionLocationApplyParams;
use Revolution\Copilot\Types\Rpc\PermissionLocationResolveParams;
use Revolution\Copilot\Types\Rpc\PermissionsLocationsAddToolApprovalDetailsCommands;

$session->rpc()->permissions()->handlePendingPermissionRequest(new PermissionDecisionRequest(
    requestId: '...',
    result: PermissionDecision::approveOnce(),
));
// Alle Berechtigungsanfragen in der Session automatisch genehmigen
$session->rpc()->permissions()->setApproveAll(new PermissionsSetApproveAllRequest(enabled: true));
// Berechtigungsmodus festlegen (manual / assisted / allow-all)
$session->rpc()->permissions()->setMode(new PermissionsSetModeRequest(mode: PermissionMode::AllowAll));
// Aktuellen Berechtigungsmodus abrufen
$mode = $session->rpc()->permissions()->getMode();
// Session-bezogene Berechtigungsfreigaben zurücksetzen
$session->rpc()->permissions()->resetSessionApprovals();
// Liste der aktuell ausstehenden Berechtigungsanfragen abrufen
$pending = $session->rpc()->permissions()->pendingRequests();
// Event-Bridge für Berechtigungsanfragen aktivieren/deaktivieren
$session->rpc()->permissions()->setRequired(new PermissionsSetRequiredRequest(required: true));
// Berechtigungsregeln hinzufügen/entfernen
$session->rpc()->permissions()->modifyRules(new PermissionsModifyRulesParams(
    scope: PermissionsModifyRulesScope::SESSION,
    add: [['tool' => 'bash', 'decision' => 'allow']],
));
// Mitteilen, dass ein Berechtigungs-Prompt angezeigt wurde
$session->rpc()->permissions()->notifyPromptShown(new PermissionPromptShownNotification(message: 'tool permission prompt'));
// Pfadberechtigungen
$paths = $session->rpc()->permissions()->paths()->list();
$session->rpc()->permissions()->paths()->add(new PermissionPathsAddParams(path: '/path/to/allow'));
$session->rpc()->permissions()->paths()->updatePrimary(new PermissionPathsUpdatePrimaryParams(path: '/path/to/allow'));
$session->rpc()->permissions()->paths()->isPathWithinAllowedDirectories(new PermissionPathsAllowedCheckParams(path: '/path/to/allow/file.txt'));
$session->rpc()->permissions()->paths()->isPathWithinWorkspace(new PermissionPathsWorkspaceCheckParams(path: '/path/to/allow/file.txt'));
// URL-Berechtigungen
$session->rpc()->permissions()->urls()->setUnrestrictedMode(
    new PermissionUrlsSetUnrestrictedModeParams(enabled: true)
);
// Berechtigungs-Location des Arbeitsverzeichnisses auflösen und gespeicherte Regeln anwenden
$location = $session->rpc()->permissions()->locations()->resolve(
    new PermissionLocationResolveParams(workingDirectory: '/path/to/repo')
);
$session->rpc()->permissions()->locations()->apply(
    new PermissionLocationApplyParams(workingDirectory: '/path/to/repo')
);
// Tool-Freigabe dauerhaft in der Berechtigungs-Location speichern
$session->rpc()->permissions()->locations()->addToolApproval(
    new PermissionLocationAddToolApprovalParams(
        approval: new PermissionsLocationsAddToolApprovalDetailsCommands(commandIdentifiers: ['bash']),
        locationKey: $location->locationKey,
    )
);
// Ordner-Vertrauensstatus prüfen und hinzufügen
$trusted = $session->rpc()->permissions()->folderTrust()->isTrusted(['path' => '/path/to/repo']);
$session->rpc()->permissions()->folderTrust()->addTrusted(new FolderTrustAddParams(path: '/path/to/repo'));

// commands: Liste der in der Session verfügbaren Slash-Befehle abrufen
use Revolution\Copilot\Types\Rpc\CommandsListRequest;

$list = $session->rpc()->commands()->list();
// $list->commands - Array von SlashCommandInfo
// $list->commands[0]->name - Befehlsname (ohne Schrägstrich)
// $list->commands[0]->description - Befehlsbeschreibung
// $list->commands[0]->kind - Befehlskategorie (builtin, skill, client)
// $list->commands[0]->allowDuringAgentExecution - Ob der Befehl während der Agent-Ausführung verwendbar ist

// Liste mit Filter abrufen
$list = $session->rpc()->commands()->list(new CommandsListRequest(
    includeBuiltins: true,
    includeSkills: false,
));

// commands: Slash-Befehl aufrufen
use Revolution\Copilot\Types\Rpc\CommandsInvokeRequest;

$result = $session->rpc()->commands()->invoke(new CommandsInvokeRequest(
    name: 'help',
    input: 'optional input text',
));

// commands: Antwort auf ein Befehlsaufruf-Event
$session->rpc()->commands()->handlePendingCommand(new CommandsHandlePendingCommandRequest(
    requestId: '...',
));

// commands: Slash-Befehl synchron ausführen
use Revolution\Copilot\Types\Rpc\ExecuteCommandParams;

$result = $session->rpc()->commands()->execute(new ExecuteCommandParams(
    commandName: 'review',
    args: 'src/',
), timeout: 120.0); // Wartezeit auf die CLI-Antwort (Sekunden). Standardmäßig 30 Sekunden
// $result->error - Fehlermeldung bei fehlgeschlagener Ausführung (bei Erfolg null)

// commands: Antwort auf einen in die Warteschlange gestellten Befehl
$session->rpc()->commands()->respondToQueuedCommand(new CommandsRespondToQueuedCommandRequest(
    requestId: '...',
    result: new QueuedCommandResult(handled: true),
));

// ui: Antwort auf eine UI-Elicitation-Anfrage
$session->rpc()->ui()->elicitation(new UIElicitationRequest(
    message: 'Frage an den Benutzer',
    requestedSchema: ['type' => 'object', 'properties' => [...]],
));

// ui: Temporäre Abfrage, die nicht zum Gesprächsverlauf hinzugefügt wird
$result = $session->rpc()->ui()->ephemeralQuery(new UIEphemeralQueryRequest(
    question: 'Fasse die wichtigsten Punkte des bisherigen Gesprächs zusammen.',
));
// $result->answer

// ui: Antwort auf eine ausstehende Elicitation-Anfrage (über das elicitation.requested-Event)
$session->rpc()->ui()->handlePendingElicitation(new UIHandlePendingElicitationRequest(
    requestId: '...',
    result: ['action' => 'accept', 'content' => ['name' => 'John']],
));

// ui: Über Broadcast-Events auf ausstehende Anfragen antworten
use Revolution\Copilot\Enums\UIAutoModeSwitchResponse;
use Revolution\Copilot\Types\Rpc\UIExitPlanModeResponse;
use Revolution\Copilot\Types\Rpc\UIHandlePendingAutoModeSwitchRequest;
use Revolution\Copilot\Types\Rpc\UIHandlePendingExitPlanModeRequest;
use Revolution\Copilot\Types\Rpc\UIHandlePendingSamplingRequest;
use Revolution\Copilot\Types\Rpc\UIHandlePendingUserInputRequest;
use Revolution\Copilot\Types\Rpc\UIUserInputResponse;

$result = $session->rpc()->ui()->handlePendingUserInput(new UIHandlePendingUserInputRequest(
    requestId: '...',
    response: new UIUserInputResponse(answer: 'blue', wasFreeform: false),
));

$result = $session->rpc()->ui()->handlePendingExitPlanMode(new UIHandlePendingExitPlanModeRequest(
    requestId: '...',
    response: new UIExitPlanModeResponse(approved: true, selectedAction: 'autopilot_fleet'),
));

$result = $session->rpc()->ui()->handlePendingAutoModeSwitch(new UIHandlePendingAutoModeSwitchRequest(
    requestId: '...',
    response: UIAutoModeSwitchResponse::Yes,
));

$result = $session->rpc()->ui()->handlePendingSampling(new UIHandlePendingSamplingRequest(
    requestId: '...',
    response: ['result' => '...'],
));
// Jede Methode gibt UIHandlePendingResult zurück. Über $result->success prüfen Sie, ob die Antwort angenommen wurde.

// onExitPlanModeRequest / onAutoModeSwitchRequest in SessionConfig antworten automatisch per reverse-RPC.
// Wenn Sie dieselbe Anfrage manuell über Events beantworten, verwenden Sie nicht beide Wege gleichzeitig.

// log: Nachrichten in der Session-Timeline protokollieren
$session->rpc()->log()->log(new LogRequest(message: 'Verarbeitung gestartet'));
$session->rpc()->log()->log(new LogRequest(message: 'Hohe Festplattenauslastung', level: LogLevel::WARNING));
$session->rpc()->log()->log(new LogRequest(message: 'Ein Fehler ist aufgetreten', level: LogLevel::ERROR));
$session->rpc()->log()->log(new LogRequest(message: 'Debug-Informationen', ephemeral: true));

// shell: Shell-Befehle innerhalb der Session ausführen
$result = $session->rpc()->shell()->exec(new ShellExecRequest(command: 'ls -la'));
// Über $result->processId die Prozess-ID abrufen und für kill oder das Verfolgen der Ausgabe verwenden

$session->rpc()->shell()->exec(new ShellExecRequest(
    command: 'npm test',
    cwd: '/path/to/project',
    timeout: 60000, // Millisekunden
));

// Laufenden Shell-Prozess stoppen
$session->rpc()->shell()->kill(new ShellKillRequest(
    processId: $result->processId,
    signal: 'SIGTERM', // SIGTERM (Standard), SIGKILL, SIGINT
));

// Vom Benutzer angeforderten Shell-Befehl abbrechen
use Revolution\Copilot\Types\Rpc\ShellExecuteUserRequestedRequest;
use Revolution\Copilot\Types\Rpc\ShellCancelUserRequestedRequest;

$execution = $session->rpc()->shell()->executeUserRequested(new ShellExecuteUserRequestedRequest(
    requestId: 'req-123',
    command: 'pwd',
), timeout: 120.0); // Wartezeit auf die CLI-Antwort (Sekunden). Standardmäßig 30 Sekunden
// $execution->toolCallId / success / output / exitCode / error
// Zum Abbrechen während der Ausführung aus einem anderen Ablauf dieselbe requestId angeben

$cancelled = $session->rpc()->shell()->cancelUserRequested(
    new ShellCancelUserRequestedRequest(requestId: 'req-123')
);
// $cancelled->cancelled - Ob der Abbruch erfolgreich war

// usage (experimental: Nutzungsmetriken der Session)
$metrics = $session->rpc()->usage()->getMetrics();
// $metrics->totalPremiumRequestCost - Gesamtkosten der Premium-Anfragen
// $metrics->totalUserRequests - Gesamtzahl der Benutzeranfragen
// $metrics->codeChanges - Metriken zu Codeänderungen (hinzugefügte Zeilen, gelöschte Zeilen, geänderte Dateien)
// $metrics->modelMetrics - Token-Nutzung und Anzahl der Anfragen pro Modell
// $metrics->currentModel - Bezeichner des aktuellen Modells

// auth: Authentifizierungsstatus der Session abrufen
$status = $session->rpc()->auth()->getStatus();
// $status->isAuthenticated - Ob authentifiziert
// $status->authType - Authentifizierungstyp (AuthInfoType enum: gh-cli, token, env usw.)
// $status->login - GitHub-Anmeldename
// $status->host - GitHub-Host
// $status->copilotPlan - Copilot-Plan (individual, business usw.)
// $status->statusMessage - Meldung zum Authentifizierungsstatus

// provider: Endpunktinformationen des von der Session verwendeten Providers abrufen (experimental)
// Wird verwendet, um in BYOK-Konfigurationen (Bring Your Own Key) das LLM-Backend direkt aufzurufen
use Revolution\Copilot\Types\Rpc\ProviderGetEndpointRequest;

$endpoint = $session->rpc()->provider()->getEndpoint();
// $endpoint->baseUrl - Basis-URL für die LLM-Clientbibliothek
// $endpoint->type - Provider-Typ (openai, anthropic usw.)
// $endpoint->headers - In Anfragen einzuschließende HTTP-Header
// $endpoint->apiKey - Anmeldeinformationen (nullable)
// $endpoint->sessionToken - Kurzlebige Session-Anmeldeinformationen (nullable)
// $endpoint->wireApi - Provider-spezifische Wire-API (nullable)

// Endpunkt für ein bestimmtes Modell abrufen
$endpoint = $session->rpc()->provider()->getEndpoint(
    new ProviderGetEndpointRequest(model: 'gpt-5')
);

// provider: Hostverwaltete Modelle aus der BYOK-Registry zurückziehen (experimental)
$result = $session->rpc()->provider()->withdraw(['models' => ['provider/model']]);
// $result->withdrawn, $result->providersRemoved, $result->modelDeselected

// queue: Benutzerbezogene Einträge in der Warteschlange prüfen und verwalten
$pending = $session->rpc()->queue()->pendingItems();
// $pending->items - Array von QueuePendingItems
// $pending->items[0]->kind - QueuePendingItemsKind (Command / Message)

$removed = $session->rpc()->queue()->removeMostRecent();
// $removed->removed - Ob der letzte Eintrag entfernt werden konnte

$session->rpc()->queue()->clear();

// Eintrag an einer bestimmten Position einfügen (position beginnt bei 0)
use Revolution\Copilot\Types\Rpc\QueueInsertAtRequest;
use Revolution\Copilot\Types\Rpc\QueueInsertMessage;

$queue = $session->rpc()->queue();
$inserted = $queue->insertAt(new QueueInsertAtRequest(
    position: 0,
    message: new QueueInsertMessage(prompt: 'Review the changes'),
));
// $inserted->id - ID des eingefügten Eintrags

$queue->moveItem(['id' => $inserted->id, 'toPosition' => 1]);
$duplicated = $queue->duplicateAt(['id' => $inserted->id]);
$queue->updateText(['id' => $duplicated->id, 'prompt' => 'Review and test the changes']);
$removedAt = $queue->removeAt(['id' => $duplicated->id]);
// $removedAt->removed - Ob der Eintrag entfernt werden konnte

$sent = $queue->sendNow(['id' => $inserted->id]);
// $sent->steered - Ob er an den laufenden Turn gesendet wurde

// Drain pausieren. Die Pause wird nicht automatisch aufgehoben; setzen Sie sie immer mit false fort
$queue->setDrainPaused(['paused' => true]);
$queue->setDrainPaused(['paused' => false]);

// schedule (experimental: Verwaltung geplanter Prompts)
$schedule = $session->rpc()->schedule()->list();
// $schedule->entries - Array von ScheduleEntry

use Revolution\Copilot\Types\Rpc\ScheduleStopRequest;

$stopped = $session->rpc()->schedule()->stop(new ScheduleStopRequest(id: 1));
// $stopped->stopped - Ob das Stoppen erfolgreich war

// tasks (experimental: Verwaltung von Hintergrundaufgaben)
// Agent-Task starten und ID abrufen
use Revolution\Copilot\Types\Rpc\TasksStartAgentRequest;

$result = $session->rpc()->tasks()->startAgent(new TasksStartAgentRequest(
    agentType: 'explore',
    prompt: 'Search for all TODO comments in the codebase',
    name: 'todo-search',
    description: 'Find TODO items', // Optional
    model: 'gpt-4o', // Optional
));
// $result->agentId - ID der Hintergrundaufgabe

// Aktuelle Task-Liste abrufen
$list = $session->rpc()->tasks()->list();
// $list->tasks - Array von TaskAgentInfo, TaskShellInfo und TaskClientInfo

// Ausgabe einer abgetrennten Shell inkrementell per Cursor lesen
use Revolution\Copilot\Types\Rpc\TasksReadOutputRequest;

$cursor = null;
do {
    $output = $session->rpc()->tasks()->readOutput(new TasksReadOutputRequest(
        id: 'shell-1',
        cursor: $cursor,
        waitMs: 1000,
    ));
    echo $output->text;
    $cursor = $output->cursor;
} while ($output->exit === null);
// $output->exit->status - Endstatus der Task
// $output->exit->exitCode - Exit-Code des Prozesses (nullable)

// Ein Lesevorgang umfasst maximal 64 KiB. waitMs ist standardmäßig 0, maximal 30000ms.
// stdout und stderr werden zusammengeführt. Wird der Cursor ungültig, lesen Sie ohne Cursor erneut.

// Anwendungseigene Jobs als Task registrieren
use Revolution\Copilot\Types\Rpc\TasksRegisterRequest;

$registered = $session->rpc()->tasks()->register(new TasksRegisterRequest(
    clientTaskId: 'import-123',
    description: 'Kundendaten importieren',
    cancellable: true,
    displayName: 'Kundenimport', // Optional
));
// $registered->task->id - Von der CLI zugewiesene Task-ID
// $registered->created / $registered->reclaimed - Status: neu erstellt bzw. verwaiste Task zurückgeholt

// Fortschritt einer clientseitigen Task aktualisieren
use Revolution\Copilot\Enums\TaskClientActiveStatus;
use Revolution\Copilot\Enums\TaskClientUpdateKind;
use Revolution\Copilot\Types\Rpc\TaskClientUpdate;
use Revolution\Copilot\Types\Rpc\TasksUpdateRequest;

$updated = $session->rpc()->tasks()->update(new TasksUpdateRequest(
    id: $registered->task->id,
    sequence: 1,
    update: new TaskClientUpdate(
        kind: TaskClientUpdateKind::Progress,
        status: TaskClientActiveStatus::Running,
        phase: 'importing',
        percentage: 25,
    ),
));
// sequence bei jeder Aktualisierung erhöhen

// Abschluss melden
$completed = $session->rpc()->tasks()->update(new TasksUpdateRequest(
    id: $registered->task->id,
    sequence: 2,
    update: new TaskClientUpdate(
        kind: TaskClientUpdateKind::Completed,
        result: ['imported' => 100],
    ),
));

// Fortschritt der Task abrufen (null, wenn nicht verfolgt)
$progress = $session->rpc()->tasks()->getProgress(['id' => $registered->task->id])->progress;
// TaskAgentProgress, TaskClientProgress, TaskShellProgress oder null

// Status abgetrennter Shells aktualisieren und auf den Abschluss der Hintergrundarbeit warten
$session->rpc()->tasks()->refresh();
$session->rpc()->tasks()->waitForPending();

// Aktuell in den Hintergrund verschiebbare Task abrufen oder diese Task sofort in den Hintergrund verschieben
$promotable = $session->rpc()->tasks()->getCurrentPromotable()->task;
$promotedCurrent = $session->rpc()->tasks()->promoteCurrentToBackground()->task;

// Task in den Hintergrundmodus verschieben (synchrones Warten aufheben)
use Revolution\Copilot\Types\Rpc\TasksPromoteToBackgroundRequest;

$promoted = $session->rpc()->tasks()->promoteToBackground(
    new TasksPromoteToBackgroundRequest(id: $result->agentId)
);
// $promoted->promoted - Ob das Verschieben erfolgreich war

// Task abbrechen
use Revolution\Copilot\Types\Rpc\TasksCancelRequest;

$cancelled = $session->rpc()->tasks()->cancel(
    new TasksCancelRequest(id: $result->agentId)
);
// $cancelled->cancelled - Ob der Abbruch erfolgreich war

// Abgeschlossene oder abgebrochene Task entfernen
use Revolution\Copilot\Types\Rpc\TasksRemoveRequest;

$removed = $session->rpc()->tasks()->remove(
    new TasksRemoveRequest(id: $result->agentId)
);
// $removed->removed - Ob das Entfernen erfolgreich war

// Nachricht an eine laufende Agent-Task senden (Steering)
use Revolution\Copilot\Types\Rpc\TasksSendMessageRequest;

$sent = $session->rpc()->tasks()->sendMessage(
    new TasksSendMessageRequest(id: $result->agentId, message: 'Bitte durchsuche auch ein anderes Verzeichnis')
);
// $sent->sent - Ob die Nachricht erfolgreich gesendet wurde
// $sent->error - Fehlermeldung bei fehlgeschlagenem Senden (nullable)

// Nur den Haupt-Turn unterbrechen und die Prompts in der Warteschlange für den nächsten Turn behalten
use Revolution\Copilot\Types\Rpc\InterruptMainTurnRequest;

$interrupted = $session->rpc()->interruptMainTurn(
    new InterruptMainTurnRequest(flushQueued: true)
);
// $interrupted->interrupted - Ob der laufende Haupt-Turn unterbrochen werden konnte

// Alle laufenden Hintergrund-Agents abbrechen, ohne den Haupt-Turn zu unterbrechen
$cancelledCount = $session->rpc()->cancelAllBackgroundAgents();
// Anzahl der abgebrochenen Agents