opencode-sdk-python/api.md

Shared Types

from opencode_ai.types import ProviderAuthError, UnknownError

Event

Types:

from opencode_ai.types import EventListResponse

Methods:

• client.event.list() -> EventListResponse

App

Types:

from opencode_ai.types import App, AppInitResponse

Methods:

• client.app.get() -> App
• client.app.init() -> AppInitResponse

File

Types:

from opencode_ai.types import FileSearchResponse

Methods:

• client.file.search(**params) -> FileSearchResponse

Config

Types:

from opencode_ai.types import (
    Config,
    Keybinds,
    McpLocal,
    McpRemote,
    Model,
    Provider,
    ConfigProvidersResponse,
)

Methods:

• client.config.get() -> Config
• client.config.providers() -> ConfigProvidersResponse

Session

Types:

from opencode_ai.types import (
    FilePart,
    Message,
    MessagePart,
    ReasoningPart,
    Session,
    SourceURLPart,
    StepStartPart,
    TextPart,
    ToolCall,
    ToolInvocationPart,
    ToolPartialCall,
    ToolResult,
    SessionListResponse,
    SessionDeleteResponse,
    SessionAbortResponse,
    SessionInitResponse,
    SessionMessagesResponse,
    SessionSummarizeResponse,
)

Methods:

• client.session.create() -> Session
• client.session.list() -> SessionListResponse
• client.session.delete(id) -> SessionDeleteResponse
• client.session.abort(id) -> SessionAbortResponse
• client.session.chat(id, **params) -> Message
• client.session.init(id, **params) -> SessionInitResponse
• client.session.messages(id) -> SessionMessagesResponse
• client.session.share(id) -> Session
• client.session.summarize(id, **params) -> SessionSummarizeResponse
• client.session.unshare(id) -> Session