Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python
3.8 KB
Raw Blame
"""Runtime capabilities consumed by the HTTP API adapter."""

from collections.abc import Mapping
from dataclasses import dataclass
from typing import Protocol

from free_claude_code.application.code_sessions import CodeApplicationPort
from free_claude_code.application.connected_accounts import (
    ConnectedAccountLoginMode,
    ConnectedAccountStatus,
)
from free_claude_code.application.model_metadata import ProviderModelRefreshResult
from free_claude_code.application.ports import RequestRuntimePort, TaskController
from free_claude_code.application.web_tools.ports import WebToolsPort
from free_claude_code.config.admin.custom_providers import CustomProviderMutation
from free_claude_code.config.admin.state import ConfigInputValue, ValueState
from free_claude_code.core.json_types import JsonObject


class AdminRuntimePort(Protocol):
    """Runtime operations exposed by the local Admin API."""

    async def apply_admin_config(
        self,
        updates: Mapping[str, ConfigInputValue],
        custom_provider: CustomProviderMutation | None = None,
    ) -> JsonObject: ...

    async def admin_config(self) -> JsonObject: ...

    async def admin_values(self) -> ValueState: ...

    async def admin_status(self) -> JsonObject: ...

    async def claude_vscode_status(self) -> JsonObject: ...

    async def claude_onboarding_status(self) -> JsonObject: ...

    async def complete_claude_onboarding(self) -> JsonObject: ...

    async def vscode_chat_status(self) -> JsonObject: ...

    async def connect_vscode_chat(self) -> JsonObject: ...

    async def disconnect_vscode_chat(self) -> JsonObject: ...

    async def refresh_vscode_chat(self) -> JsonObject: ...

    async def connect_claude_vscode(self) -> JsonObject: ...

    async def disconnect_claude_vscode(self) -> JsonObject: ...

    async def refresh_claude_vscode(self) -> JsonObject: ...

    async def dsh_desktop_status(self) -> JsonObject: ...

    async def connect_dsh_desktop(self) -> JsonObject: ...

    async def disconnect_dsh_desktop(self) -> JsonObject: ...

    async def refresh_dsh_desktop(self) -> JsonObject: ...

    async def claude_desktop_status(self) -> JsonObject: ...

    async def jetbrains_acp_status(self) -> JsonObject: ...

    async def connect_jetbrains_acp(self) -> JsonObject: ...

    async def disconnect_jetbrains_acp(self) -> JsonObject: ...

    async def refresh_jetbrains_acp(self) -> JsonObject: ...

    async def connect_claude_desktop(self) -> JsonObject: ...

    async def disconnect_claude_desktop(self) -> JsonObject: ...

    async def refresh_claude_desktop(self) -> JsonObject: ...

    async def codex_integration_status(self) -> JsonObject: ...

    async def connect_codex(self) -> JsonObject: ...

    async def disconnect_codex(self) -> JsonObject: ...

    async def refresh_codex_integration(self) -> JsonObject: ...

    async def pick_folder(self, initial_path: str | None) -> str | None: ...

    async def test_provider(self, provider_id: str) -> JsonObject: ...

    async def refresh_models(self) -> ProviderModelRefreshResult: ...

    async def connected_account_status(
        self, provider_id: str
    ) -> ConnectedAccountStatus: ...

    async def start_connected_account_login(
        self,
        provider_id: str,
        mode: ConnectedAccountLoginMode,
    ) -> ConnectedAccountStatus: ...

    async def cancel_connected_account_login(
        self, provider_id: str
    ) -> ConnectedAccountStatus: ...

    async def disconnect_connected_account(
        self, provider_id: str
    ) -> ConnectedAccountStatus: ...


@dataclass(frozen=True, slots=True)
class ApiServices:
    """Complete runtime boundary required to construct the API application."""

    requests: RequestRuntimePort
    admin: AdminRuntimePort
    tasks: TaskController
    web_tools: WebToolsPort
    code: CodeApplicationPort | None = None