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.21 kB
from __future__ import annotations
"""FCC-owned coding conversation state and harness-neutral events."""
import time
from dataclasses import dataclass, field
from typing import Literal
from pydantic import BaseModel, ConfigDict, Field
from free_claude_code.core.json_types import JsonObject
type RunStatus = Literal[
"preparing", "running", "stopping", "completed", "interrupted", "failed"
]
ACTIVE_RUN_STATUSES = frozenset({"preparing", "running", "stopping"})
type CodeMode = Literal["config", "ask", "auto_review", "full_access"]
def now_ms() -> int:
return time.time_ns() // 1_000_000
class Record(BaseModel):
model_config = ConfigDict(frozen=True, extra="forbid")
class CodeSession(Record):
id: str
cwd: str
model: str
reasoning_effort: str | None = None
mode: CodeMode = "config"
harness: Literal["codex"] = "codex"
title: str = "New code session"
auto_title: bool = True
native_thread_id: str | None = None
native_permission_defaults: JsonObject | None = None
native_may_have_input: bool = False
context_used_tokens: int | None = Field(default=None, ge=0)
revision: int = 1
status: Literal["ready", "deleting", "delete_uncertain"] = "ready"
error: str | None = None
created_at: int = Field(default_factory=now_ms)
updated_at: int = Field(default_factory=now_ms)
class CodeRun(Record):
id: str
session_id: str
text: str
model: str
reasoning_effort: str | None = None
mode: CodeMode = "config"
ordinal: int = 0
status: RunStatus = "preparing"
submission_started: bool = False
native_turn_id: str | None = None
stop_requested: bool = False
error: str | None = None
error_details: JsonObject = Field(default_factory=dict)
created_at: int = Field(default_factory=now_ms)
finished_at: int | None = None
class CodeItem(Record):
id: str
session_id: str
sequence: int
run_id: str
native_turn_id: str | None = None
native_item_id: str | None = None
kind: str
title: str = ""
text: str = ""
detail: str = ""
complete: bool = False
raw: JsonObject = Field(default_factory=dict)
class CodePrompt(Record):
"""Form and response state for the prompt CodeItem with the same session/id."""
id: str
session_id: str
generation: str
request_id: str | int
native_turn_id: str | None = None
native_item_id: str | None = None
kind: str
form: JsonObject
raw: JsonObject
status: Literal["pending", "answering", "resolved", "expired"] = "pending"
response_id: str | None = None
error: str | None = None
@dataclass(frozen=True, slots=True)
class CodeDetail:
session: CodeSession
run: CodeRun | None
items: tuple[CodeItem, ...]
prompts: tuple[CodePrompt, ...]
epoch: str
version: int
cursor: int
next_before: tuple[int, int] | None = None
runs: tuple[CodeRun, ...] = ()
active_prompt_ids: tuple[str, ...] = ()
active_review_ids: tuple[str, ...] = ()
@dataclass(frozen=True, slots=True)
class CodeItemPage:
items: tuple[CodeItem, ...]
runs: tuple[CodeRun, ...]
next_before: tuple[int, int] | None = None
@dataclass(frozen=True, slots=True)
class CodeHistory:
session: CodeSession
run: CodeRun | None
items: tuple[CodeItem, ...]
prompts: tuple[CodePrompt, ...]
runs: tuple[CodeRun, ...]
active_prompt_ids: tuple[str, ...]
next_before: tuple[int, int] | None
@dataclass(frozen=True, slots=True)
class CodeExecutionSeed:
session: CodeSession
run: CodeRun | None
sequence: int
items: tuple[CodeItem, ...]
prompts: tuple[CodePrompt, ...]
runs: tuple[CodeRun, ...]
class CodeModel(Record):
id: str
display_name: str
provider_id: str
model_name: str
reasoning_efforts: tuple[str, ...] = ()
default_reasoning_effort: str | None = None
context_window_tokens: int | None = Field(default=None, gt=0)
@dataclass(frozen=True, slots=True)
class CodeCatalog:
default_model: str
models: tuple[CodeModel, ...]
@dataclass(frozen=True, slots=True)
class CodePage:
sessions: tuple[CodeSession, ...]
next_cursor: tuple[int, str] | None = None
@dataclass(frozen=True, slots=True)
class ItemUpdate:
turn_id: str
item_id: str
kind: str
text: str = ""
title: str = ""
detail: str = ""
raw: JsonObject = field(default_factory=dict)
complete: bool = False
client_id: str | None = None
@dataclass(frozen=True, slots=True)
class PromptRequest:
request_id: str | int
kind: str
form: JsonObject
raw: JsonObject
turn_id: str | None = None
item_id: str | None = None
@dataclass(frozen=True, slots=True)
class HarnessEvent:
generation: str
thread_id: str | None
kind: Literal[
"turn_started",
"turn_completed",
"item",
"prompt",
"resolved",
"error",
"notice",
"context_usage",
"closed",
]
turn_id: str | None = None
context_used_tokens: int | None = None
item: ItemUpdate | None = None
prompt: PromptRequest | None = None
request_id: str | int | None = None
status: RunStatus = "completed"
message: str | None = None
will_retry: bool = False
error_details: JsonObject = field(default_factory=dict)
raw: JsonObject = field(default_factory=dict)
@dataclass(frozen=True, slots=True)
class NativeTurn:
id: str
items: tuple[ItemUpdate, ...] = ()
status: RunStatus = "completed"
error: str | None = None
error_details: JsonObject = field(default_factory=dict)
@dataclass(frozen=True, slots=True)
class NativeThread:
id: str
turns: tuple[NativeTurn, ...] = ()
permission_defaults: JsonObject | None = None
class CodeError(Exception):
"""A user-facing failure of the coding session application."""
class CodeConflictError(CodeError):
pass
class CodeNotFoundError(CodeError):
pass
class CodeValidationError(CodeError):
pass
class CodeUnavailableError(CodeError):
pass
class NativeHistoryMissing(CodeNotFoundError):
"""The registered conversation no longer exists in native storage."""