Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.starlight-search.com/llms.txt

Use this file to discover all available pages before exploring further.

This reference is auto-generated from SDK docstrings. Run python scripts/generate_api_docs.py to regenerate.
Types are represented as Python models (Pydantic for API contracts, plus SDK dataclasses where applicable).

MemoryResponse

Returned by query_memories and contained in AugmentedTask.memories.
class ... (BaseModel)
class MemoryResponse:
    id: str
    task: str
    reflection: str
    q_value: float = 0.5
    similarity: float = 0.0
    score: float = 0.0
    success: bool | None = None
    summary: str = ''
    key_mistake: str = ''
    correct_action: str = ''
    applicable_tools: list[str] = field(default_factory=list)
    guidance: str = ''
    tools_used: list[str] = field(default_factory=list)
FieldTypeDescription
idstr
taskstr
reflectionstr
q_valuefloat
similarityfloat
scorefloat
success`boolNone`
summarystr
key_mistakestr
correct_actionstr
applicable_toolslist[str]
guidancestr
tools_usedlist[str]

AugmentedTask

Returned by augment_with_memories.
@dataclass(slots=True)
class AugmentedTask:
    augmented_task: str
    memories: list[MemoryResponse]
FieldTypeDescription
augmented_taskstrThe original task with formatted memory blocks appended.
memorieslist[MemoryResponse]List of MemoryResponse objects that were used.

TraceCreateResponse

Returned by create_trace and create_trace_async.
class ... (BaseModel)
class TraceCreateResponse:
    trace_id: str
    ingest_status: Literal[queued, completed]
FieldTypeDescription
trace_idstr
ingest_statusLiteral[queued, completed]

TraceResponse

Returned by get_trace, list_traces, review_trace, wait_for_trace, and create_trace_and_wait.
class ... (BaseModel)
class TraceResponse:
    id: str
    task: str
    trajectory: list[TrajectoryMessage]
    final_response: str
    retrieved_memory_ids: list[str]
    model: str | None = None
    metadata: dict[str, object] = field(default_factory=dict)
    review_status: Literal[pending, reviewed]
    ingest_status: Literal[queued, processing, completed, failed]
    ingest_attempts: int = 0
    last_ingest_error: str | None = None
    created_memory_id: str | None = None
    review: reflect_contracts.models.ReviewResponse | None = None
FieldTypeDescription
idstr
taskstr
trajectorylist[TrajectoryMessage]
final_responsestr
retrieved_memory_idslist[str]
model`strNone`
metadatadict[str, object]
review_statusLiteral[pending, reviewed]
ingest_statusLiteral[queued, processing, completed, failed]
ingest_attemptsint
last_ingest_error`strNone`
created_memory_id`strNone`
review`reflect_contracts.models.ReviewResponseNone`

ReviewResponse

Nested in TraceResponse.review.
class ... (BaseModel)
class ReviewResponse:
    id: str
    trace_id: str
    result: Literal[pass, fail]
    feedback_text: str | None = None
    mode: Literal[inline, deferred]
FieldTypeDescription
idstr
trace_idstr
resultLiteral[pass, fail]
feedback_text`strNone`
modeLiteral[inline, deferred]

ApiKeyResponse

Returned by list_api_keys, revoke_api_key, and nested in ApiKeyCreateResponse.key.
class ... (BaseModel)
class ApiKeyResponse:
    id: str
    public_id: str
    label: str
    scopes: list[str]
    is_master: bool = False
    environment: Literal[live, test]
    status: Literal[active, revoked]
    created_at: str | None = None
    last_used_at: str | None = None
    revoked_at: str | None = None
FieldTypeDescription
idstr
public_idstr
labelstr
scopeslist[str]
is_masterbool
environmentLiteral[live, test]
statusLiteral[active, revoked]
created_at`strNone`
last_used_at`strNone`
revoked_at`strNone`

ApiKeyCreateResponse

Returned by create_api_key.
class ... (BaseModel)
class ApiKeyCreateResponse:
    api_key: str
    key: ApiKeyResponse
FieldTypeDescription
api_keystr
keyApiKeyResponse

BootstrapResponse

Returned by ReflectClient.bootstrap.
class ... (BaseModel)
class BootstrapResponse:
    user_id: str
    project_id: str
    api_key: str
FieldTypeDescription
user_idstr
project_idstr
api_keystr