SessionConfig

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\SessionConfig;
use Revolution\Copilot\Types\SystemMessageConfig;
use Revolution\Copilot\Types\InfiniteSessionConfig;
use Revolution\Copilot\Types\UserInputRequest;
use Revolution\Copilot\Types\Rpc\ModelCapabilitiesOverride;
use Revolution\Copilot\Types\Rpc\ModelCapabilitiesOverrideSupports;
use Revolution\Copilot\Types\Rpc\ModelCapabilitiesOverrideLimits;
use Revolution\Copilot\Enums\ReasoningEffort;
use Revolution\Copilot\Enums\UIAutoModeSwitchResponse;
use Revolution\Copilot\Enums\MemoryMode;
use Revolution\Copilot\Enums\WorkingDirectoryTrust;
use Revolution\Copilot\Types\AutoModeSwitchRequest;
use Revolution\Copilot\Types\ExitPlanModeRequest;
use Revolution\Copilot\Types\ExitPlanModeResult;
use Revolution\Copilot\Types\McpAuthRequest;
use Revolution\Copilot\Types\McpAuthToken;
use Revolution\Copilot\Types\MemoryConfiguration;

$config = new SessionConfig(
    // 사용할 모델 지정
    model: 'auto',

    // 신규 세션 작성 시 고정 세션 ID를 지정
    sessionId: 'session-123',

    // 신규 로컬 세션의 이름(cloud와 함께 지정하면 런타임이 거부함).
    // 이름이 있는 세션은 즉시 영속화되므로, 턴을 실행하기 전부터 목록 조회나 재개가 가능함.
    // 빈 문자열, 앞뒤 공백, 제어 문자, 큰따옴표는 사용할 수 없음.
    // 최대 100 UTF-16 코드 유닛.
    name: 'issue-triage',

    clientName: 'my-app',

    // 사람이 조작하는 세션으로 표시하여 사용자 메시지 분석 텔레메트리를 활성화(SDK 기본값: false).
    // 자동화된 메시지는 제외됨. 클라우드 세션이나 실행 중인 세션을 재개하는 경우에는 무시됨.
    interactiveUser: true,

    // 추론 레벨. 대응하는 모델에서만 설정 가능.
    reasoningEffort: ReasoningEffort::HIGH,

    // 모델의 capabilities를 오버라이드. 런타임의 기본값에 deep-merge된다.
    // modelCapabilities: new ModelCapabilitiesOverride(
    //     supports: new ModelCapabilitiesOverrideSupports(vision: true, reasoningEffort: true),
    //     limits: new ModelCapabilitiesOverrideLimits(max_prompt_tokens: 200000),
    // ),
    // 배열로도 지정 가능
    // modelCapabilities: ['supports' => ['vision' => true]],

    // config 디렉터리를 덮어쓰기 설정
    configDirectory: '',

    // MCP 설정이나 스킬 디렉터리의 자동 검출 활성화
    // .mcp.json 이나 .vscode/mcp.json 을 워킹 디렉터리에서 자동 검출하고,
    // 명시적으로 지정한 mcpServers 나 skillDirectories 와 병합함(이름 충돌 시 명시 지정이 우선)
    enableConfigDiscovery: true,

    // 커스텀 도구
    tools: [...],

    // 시스템 메시지
    systemMessage: new SystemMessageConfig(
        content: 'You are a helpful assistant for Laravel developers.',
    ),

    // 시스템 메시지: replace 모드(시스템 프롬프트를 완전히 대체)
    // systemMessage: new SystemMessageConfig(
    //     mode: 'replace',
    //     content: '커스텀 시스템 프롬프트 전체',
    // ),

    // 시스템 메시지: customize 모드(섹션 단위로 오버라이드)
    // systemMessage: new SystemMessageConfig(
    //     mode: 'customize',
    //     sections: [
    //         'tone' => new SectionOverride(action: SectionOverrideAction::REPLACE, content: 'Always respond in Japanese.'),
    //         'safety' => new SectionOverride(action: SectionOverrideAction::REMOVE),
    //         'custom_instructions' => new SectionOverride(action: SectionOverrideAction::APPEND, content: 'Additional instructions here.'),
    //     ],
    //     content: 'append 모드와 마찬가지의 추가 콘텐츠(옵션)',
    // ),

    // 커스텀 프로바이더
    provider: new ProviderConfig(),

    // 세션별 GitHub 토큰(멀티테넌트 대응)
    // 클라이언트 레벨의 github_token과는 별도로, 세션 단위로 토큰을 지정할 수 있음
    gitHubToken: $user->github_token,

    // 메모리 설정 (experimental)
    // mode의 기본값은 system-prompt. user-prompt를 지정하면 생성되는 사용자 메시지에 메모리를 주입함.
    memory: new MemoryConfiguration(
        enabled: true,
        mode: MemoryMode::UserPrompt,
    ),
    // 배열로도 지정 가능
    // memory: ['enabled' => true, 'mode' => 'user-prompt'],

    // 클라우드 세션(로컬이 아닌 클라우드에서 세션 작성)
    // 옵션으로 저장소 정보를 관련지을 수 있음
    cloud: new \Revolution\Copilot\Types\CloudSessionOptions(
        repository: new \Revolution\Copilot\Types\CloudSessionRepository(
            owner: 'myorg',
            name: 'myrepo',
            branch: 'main',
        ),
    ),

    onPermissionRequest: function (array $request) {
        // 권한 요청 처리
    },

    onUserInputRequest: function (UserInputRequest $request) {
        // 사용자 인풋 요청 처리. ask_user
    },

    // 엘리시테이션 요청 핸들러
    // 설정하면 에이전트의 폼 기반 UI 다이얼로그 요청을 받을 수 있음
    onElicitationRequest: function (ElicitationContext $context) {
        // 엘리시테이션 요청 처리
        return ['action' => 'accept', 'content' => ['field' => 'value']];
    },

    // MCP 서버가 OAuth 인증을 요청했을 때 호스트 측에서 토큰을 제공
    onMcpAuthRequest: function (McpAuthRequest $request, array $context): ?McpAuthToken {
        $accessToken = $credentialProvider->tokenFor($request->serverName);

        return $accessToken === null
            ? null
            : new McpAuthToken(accessToken: $accessToken, tokenType: 'Bearer');
    },

    // 플랜 모드 종료 요청 핸들러
    // 설정하면 에이전트가 플랜 모드를 종료할 때의 요청을 받을 수 있음
    // 설정하면 SDK가 리버스 RPC로 응답함. 생략하면 요청은 자동으로 승인됨.
    onExitPlanModeRequest: function (ExitPlanModeRequest $request) {
        // 플랜 내용을 확인하고 승인, 거부
        return new ExitPlanModeResult(approved: true, selectedAction: $request->recommendedAction);
    },

    // 자동 모드 전환 요청 핸들러
    // 레이트 리밋 도달 시 auto 모드로의 전환을 허용할지 선택 가능. 생략하면 "no"로 처리됨.
    onAutoModeSwitchRequest: function (AutoModeSwitchRequest $request) {
        // "yes", "yes_always", "no" 또는 UIAutoModeSwitchResponse 케이스를 반환
        return UIAutoModeSwitchResponse::Yes;
    },

    // 세션 훅
    hooks: [],

    // 워킹 디렉터리
    workingDirectory: '',

    // 워킹 디렉터리의 신뢰 범위. User는 이후 세션에도 영속됨.
    trustWorkingDirectory: WorkingDirectoryTrust::Session,

    // 스트리밍 활성화
    streaming: true,

    // 서브에이전트의 스트리밍 이벤트를 메인 스트림에 포함할지(기본값: true)
    includeSubAgentStreamingEvents: true,

    // 사용 가능한 빌트인 도구
    availableTools: ['read_file', 'write_file'],

    // 또는 제외할 도구
    excludedTools: ['shell'],

    // MCP 서버 설정
    mcpServers: [
        'github' => [
            'type' => 'http',
            'url' => 'https://api.githubcopilot.com/mcp/',
        ],
    ],

    // 커스텀 에이전트
    customAgents: [
        [
            'name' => 'reviewer',
            'displayName' => 'Code Reviewer',
            'description' => 'Reviews code for best practices',
            'prompt' => 'You are an expert code reviewer.',
        ],
    ],

    // 기본 에이전트 설정. 커스텀 에이전트가 선택되어 있지 않은 경우에 사용되는 빌트인 에이전트의 설정.
    // excludedTools: 기본 에이전트에서 제외할 도구 리스트.
    // 커스텀 서브에이전트에는 계속 사용 가능.
    defaultAgent: ['excludedTools' => ['tool_name']],

    // 세션 시작 시에 활성화할 에이전트를 지정. customAgents의 name과 일치해야 함.
    agent: 'reviewer',

    // 스킬, 에이전트, 훅, 인스트럭션 파일의 명시적인 검출 루트
    skillDirectories: [],
    agentDirectories: [],
    hookDirectories: [],
    instructionDirectories: [],

    // 비활성 스킬
    disabledSkills: [],

    // 무한 세션 설정. 기본값은 활성.
    infiniteSessions: new InfiniteSessionConfig(
        enabled: true,
        backgroundCompactionThreshold: 0.80, // 컨텍스트 사용률이 80%가 되면 압축 시작
        bufferExhaustionThreshold: 0.95,     // 압축이 완료될 때까지 95%에서 블록
    ),

    // 무한 세션 비활성화
    // infiniteSessions: new InfiniteSessionConfig(enabled: false),

    // 세션 작성 RPC보다 앞서 이벤트 핸들러를 등록.
    // session.start 등 초기 이벤트를 놓치지 않기 위해 사용.
    // $session->on($handler)을 나중에 호출하는 것과 동등하지만, 라이프사이클의 더 이른 단계에서 등록됨.
    onEvent: function (SessionEvent $event) {
        // 모든 세션 이벤트를 받음
    },
);

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

use Revolution\Copilot\Enums\WorkingDirectoryTrust;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    workingDirectory: base_path(),
    trustWorkingDirectory: WorkingDirectoryTrust::Session,
);

use Revolution\Copilot\Enums\MemoryMode;
use Revolution\Copilot\Types\MemoryConfiguration;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    memory: new MemoryConfiguration(enabled: true, mode: MemoryMode::UserPrompt),
);

// 배열로도 지정 가능
$config = new SessionConfig(memory: ['enabled' => true, 'mode' => 'user-prompt']);

use Revolution\Copilot\Types\MemoryConfiguration;
use Revolution\Copilot\Types\MemoryStoreCallOptions;
use Revolution\Copilot\Types\SessionConfig;
use Revolution\Copilot\Types\StoredMemory;

$config = new SessionConfig(
    memory: new MemoryConfiguration(
        enabled: true,
        storeMemory: function (StoredMemory $memory, MemoryStoreCallOptions $options) use ($memoryRepository): void {
            if ($options->signal->isCancellationRequested()) {
                return;
            }

            $memoryRepository->store($memory);
        },
    ),
);

// 배열로도 지정할 수 있다. storeMemory에는 Closure를 전달한다.
$config = new SessionConfig(memory: ['enabled' => true, 'storeMemory' => $storeMemory]);

use Revolution\Copilot\Enums\PermissionMode;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(permissionMode: PermissionMode::Assisted);

use Revolution\Copilot\Enums\UIAutoModeSwitchResponse;
use Revolution\Copilot\Types\AutoModeSwitchRequest;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    autoModeRecovery: true,
    onAutoModeSwitchRequest: function (AutoModeSwitchRequest $request) {
        // 복구 제안인 경우 $request->autoModeRecovery에 컨텍스트가 들어 있다
        return UIAutoModeSwitchResponse::Yes;
    },
);

$config = new SessionConfig(
    excludedManagedSettings: ['permissions'],
);

use Revolution\Copilot\Types\Rpc\AutopilotOptions;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    autopilot: new AutopilotOptions(
        continuationEnabled: true,
        maxContinues: 3,
    ),
);

// 배열로도 지정 가능
$config = new SessionConfig(autopilot: [
    'continuationEnabled' => false,
    'maxContinues' => 0,
]);

use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    sandboxConfig: [
        'enabled' => true,
        'userPolicy' => [
            'filesystem' => ['readwritePaths' => [storage_path('app/workspace')]],
            'network' => [
                'allowedHosts' => ['api.example.com'],
                'blockedHosts' => ['untrusted.example.com'],
            ],
        ],
    ],
);

$config = new SessionConfig(
    sandboxConfig: [
        'enabled' => true,
        'auth' => ['git' => true, 'gh' => true],
        'credentials' => [
            'envVars' => [
                'APP_CREDENTIAL' => ['injectHosts' => ['registry.example.com']],
            ],
        ],
        'userPolicy' => [
            'experimental' => ['seatbelt' => ['keychainAccess' => true]],
        ],
    ],
);

use Revolution\Copilot\Support\CanvasError;
use Revolution\Copilot\Support\CanvasHandler;
use Revolution\Copilot\Types\CanvasDeclaration;
use Revolution\Copilot\Types\Rpc\CanvasAction;
use Revolution\Copilot\Types\Rpc\CanvasProviderInvokeActionRequest;
use Revolution\Copilot\Types\Rpc\CanvasProviderOpenRequest;
use Revolution\Copilot\Types\Rpc\CanvasProviderOpenResult;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    canvases: [
        new CanvasDeclaration(
            id: 'editor',
            displayName: 'Editor',
            description: 'Opens and edits project files.',
            actions: [
                new CanvasAction(name: 'format', description: 'Format the open file.'),
            ],
        ),
    ],
    canvasHandler: new class extends CanvasHandler
    {
        public function open(CanvasProviderOpenRequest $request): CanvasProviderOpenResult|array
        {
            return new CanvasProviderOpenResult(
                url: 'https://app.example.test/canvas/'.$request->instanceId,
                title: 'Project editor',
            );
        }

        public function invoke(CanvasProviderInvokeActionRequest $request): mixed
        {
            if ($request->actionName !== 'format') {
                throw CanvasError::noHandler();
            }

            return ['formatted' => true];
        }
    },
    requestCanvasRenderer: true,
);

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

$config = new SessionConfig(
    onPermissionRequest: PermissionHandler::approveAll(),
    skillProvider: [
        'listSkills' => fn (SkillProviderCallOptions $options) => [
            ['name' => 'deployment', 'description' => 'Safe application deployments'],
        ],
        'readSkill' => fn (string $name, SkillProviderCallOptions $options) =>
            $name === 'deployment' ? '# Deployment checklist' : null,
    ],
);

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

$config = new SessionConfig(
    onPermissionRequest: PermissionHandler::approveAll(),
    sessionFsProvider: [
        'readFile' => fn (string $path) => Storage::disk('local')->get($path),
        'writeFile' => fn (string $path, string $content, ?int $mode = null) =>
            Storage::disk('local')->put($path, $content),
        'readFileBytes' => fn (string $path) => Storage::disk('local')->get($path),
        'writeFileBytes' => fn (string $path, string $bytes, ?int $mode = null) =>
            Storage::disk('local')->put($path, $bytes),
    ],
);

use Revolution\Copilot\Client;
use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Support\PermissionHandler;
use Revolution\Copilot\Types\SessionConfig;

$client = new Client(['sessionFs' => [
    'initialCwd' => '/workspace',
    'sessionStatePath' => '/session-state',
    'conventions' => 'posix', // 또는 windows
    'capabilities' => ['sqlite' => true, 'binary' => true], // 옵션
]]);

$session = $client->createSession(new SessionConfig(
    onPermissionRequest: PermissionHandler::approveAll(),
    createSessionFsProvider: fn (CopilotSession $session) => new MySessionFsProvider($session->id()),
));

// config/copilot.php
'mode' => env('COPILOT_MODE', 'copilot-cli'),
'base_directory' => storage_path('app/copilot'),

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Support\BuiltInTools;
use Revolution\Copilot\Support\ToolSet;

$response = Copilot::run(
    prompt: 'Summarize this text.',
    config: [
        'availableTools' => (new ToolSet)
            ->addBuiltIn(BuiltInTools::Isolated)
            ->addCustom('lookup_order')
            ->addMcp('search'),
    ],
);