dheraingoud's picture
sync: upstream 9194f15 + custom addons (KeyRotator, RotatingChatTransport, sol/terra/luna, ScannerTrap, health, Py3.12 compat)
e99df76
Raw History Blame Contribute Delete
6.3 kB
from __future__ import annotations
"""Persistence and native execution required by Code sessions."""
from collections.abc import Awaitable, Callable, Sequence
from typing import Protocol
from free_claude_code.application.session_events import EventSubscription
from free_claude_code.core.json_types import JsonObject
from .models import (
CodeCatalog,
CodeDetail,
CodeExecutionSeed,
CodeHistory,
CodeItem,
CodeItemPage,
CodeMode,
CodePage,
CodePrompt,
CodeRun,
CodeSession,
HarnessEvent,
NativeThread,
)
# Harness connections must await each call and preserve native wire order.
type EventSink = Callable[[HarnessEvent], Awaitable[None]]
class HarnessConnection(Protocol):
generation: str
thread_id: str | None
def supports(self, selection: HarnessSelection) -> bool: ...
async def create_thread(self) -> NativeThread: ...
async def resume_thread(self, thread_id: str) -> NativeThread: ...
async def read_thread(self, thread_id: str) -> NativeThread: ...
async def start_turn(
self,
text: str,
selection: HarnessSelection,
client_id: str,
permission_defaults: JsonObject,
) -> str: ...
async def interrupt(self, turn_id: str) -> None: ...
def prepare_answer(
self, request_id: str | int, answer: JsonObject
) -> JsonObject: ...
async def respond(self, request_id: str | int, response: JsonObject) -> None: ...
async def delete_thread(self, thread_id: str) -> None: ...
async def close(self) -> None: ...
class HarnessSelection(Protocol):
@property
def mode(self) -> CodeMode: ...
@property
def model(self) -> str: ...
@property
def reasoning_effort(self) -> str | None: ...
@property
def configuration_key(self) -> str: ...
async def open(self, cwd: str, sink: EventSink) -> HarnessConnection: ...
class HarnessFactory(Protocol):
def availability(self) -> tuple[bool, str | None]: ...
def catalog(self) -> CodeCatalog: ...
async def prepare(
self, model: str, reasoning_effort: str | None, mode: CodeMode
) -> HarnessSelection: ...
async def open_history(self, cwd: str, sink: EventSink) -> HarnessConnection: ...
class CodeStore(Protocol):
async def execution_seed(self, session_id: str) -> CodeExecutionSeed: ...
async def read_history(
self,
session_id: str,
before: tuple[int, int] | None,
include_item_ids: Sequence[str],
) -> CodeHistory: ...
async def get_native_item(
self,
session_id: str,
turn_id: str,
item_id: str,
) -> CodeItem | None: ...
async def run_items(self, session_id: str, run_id: str) -> tuple[CodeItem, ...]: ...
async def get_prompt(
self, session_id: str, prompt_id: str
) -> CodePrompt | None: ...
async def has_prompt_request(
self,
session_id: str,
generation: str,
request_id: str | int,
) -> bool: ...
async def has_native_turn(self, session_id: str, turn_id: str) -> bool: ...
async def start(self) -> None: ...
async def close(self) -> None: ...
async def create(self, session: CodeSession) -> CodeSession: ...
async def get_session(self, session_id: str) -> CodeSession: ...
async def list_sessions(
self, cursor: tuple[int, str] | None, limit: int, query: str = ""
) -> CodePage: ...
async def pending_deletions(self) -> tuple[CodeSession, ...]: ...
async def is_deleted(self, session_id: str) -> bool: ...
async def get_run(self, session_id: str, run_id: str) -> CodeRun | None: ...
async def runs(self, session_id: str) -> tuple[CodeRun, ...]: ...
async def latest_run(self, session_id: str) -> CodeRun | None: ...
async def items(
self, session_id: str, before: tuple[int, int] | None, limit: int | None
) -> tuple[CodeItem, ...]: ...
async def prompts(self, session_id: str) -> tuple[CodePrompt, ...]: ...
async def item_page(
self, session_id: str, before: tuple[int, int] | None, limit: int | None
) -> CodeItemPage: ...
async def update_settings(
self, session: CodeSession, expected_revision: int
) -> CodeSession: ...
async def admit_run(
self, session: CodeSession, run: CodeRun, item: CodeItem, expected_revision: int
) -> tuple[CodeSession, CodeRun]: ...
async def claim_prompt(
self, session_id: str, prompt_id: str, response_id: str, generation: str
) -> CodePrompt: ...
async def save_progress(
self,
session: CodeSession,
expected_revision: int,
*,
run: CodeRun | None = None,
items: Sequence[CodeItem] = (),
prompts: Sequence[CodePrompt] = (),
) -> None: ...
async def delete(self, session_id: str) -> None: ...
class CodeApplicationPort(Protocol):
@property
def epoch(self) -> str: ...
@property
def cursor(self) -> int: ...
def storage_status(self) -> JsonObject: ...
def availability(self) -> tuple[bool, str | None]: ...
def catalog(self) -> CodeCatalog: ...
async def create_session(self, session_id: str, cwd: str) -> CodeSession: ...
async def list_sessions(
self, cursor: tuple[int, str] | None = None, limit: int = 25, query: str = ""
) -> CodePage: ...
async def get_detail(
self,
session_id: str,
*,
before: tuple[int, int] | None = None,
include_item_ids: Sequence[str] = (),
) -> CodeDetail: ...
async def subscribe(self) -> tuple[EventSubscription, JsonObject]: ...
async def update_settings(
self, session_id: str, revision: int, changes: JsonObject
) -> CodeSession: ...
async def send(
self,
session_id: str,
operation_id: str,
revision: int,
text: str,
*,
expected_epoch: str,
) -> CodeRun: ...
async def stop(self, session_id: str, operation_id: str) -> CodeRun: ...
async def answer(
self, session_id: str, prompt_id: str, response_id: str, answer: JsonObject
) -> CodePrompt: ...
async def delete_session(
self, session_id: str, revision: int
) -> CodeSession | None: ...