OpenCode Adapter

1
import asyncio
2
import logging
3
from thenvoi import Agent
4
from thenvoi.adapters import OpencodeAdapter, OpencodeAdapterConfig
5
from thenvoi.config import load_agent_config
6
7
logging.basicConfig(level=logging.INFO)
8
logger = logging.getLogger(__name__)
9
10
async def main():
11
    agent_id, api_key = load_agent_config("my_agent")
12
13
    adapter = OpencodeAdapter(
14
        config=OpencodeAdapterConfig(
15
            custom_section="You are a helpful assistant. Keep replies concise.",
16
            enable_execution_reporting=True,
17
        )
18
    )
19
20
    agent = Agent.create(
21
        adapter=adapter,
22
        agent_id=agent_id,
23
        api_key=api_key,
24
    )
25
26
    logger.info("Agent is running! Press Ctrl+C to stop.")
27
    await agent.run()
28
29
if __name__ == "__main__":
30
    asyncio.run(main())

1
adapter = OpencodeAdapter(
2
    config=OpencodeAdapterConfig(
3
        provider_id="opencode",
4
        model_id="minimax-m2.5-free",
5
    )
6
)

1
adapter = OpencodeAdapter(
2
    config=OpencodeAdapterConfig(
3
        custom_section=(
4
            "This is a Python FastAPI project.\n"
5
            "Focus on the src/ directory.\n"
6
            "Run tests with: pytest tests/ -v"
7
        ),
8
    )
9
)

1
adapter = OpencodeAdapter(
2
    config=OpencodeAdapterConfig(
3
        approval_mode="manual",              # manual, auto_accept, auto_decline
4
        approval_wait_timeout_s=300.0,       # Seconds before timeout
5
        approval_timeout_reply="reject",     # reject, once, or always
6
    )
7
)

1
adapter = OpencodeAdapter(
2
    config=OpencodeAdapterConfig(
3
        question_mode="manual",             # manual or auto_reject
4
        question_wait_timeout_s=300.0,
5
    )
6
)

1
adapter = OpencodeAdapter(
2
    config=OpencodeAdapterConfig(
3
        enable_execution_reporting=True,
4
    )
5
)

1
adapter = OpencodeAdapter(
2
    config=OpencodeAdapterConfig(
3
        # OpenCode server URL
4
        base_url="http://127.0.0.1:4096",
5
6
        # Working directory for OpenCode sessions
7
        directory="/path/to/project",
8
9
        # Provider and model selection
10
        provider_id="opencode",
11
        model_id="minimax-m2.5-free",
12
13
        # OpenCode agent variant (optional)
14
        agent="code",
15
        variant=None,
16
17
        # Custom instructions appended to the system prompt
18
        custom_section="You are a helpful assistant.",
19
20
        # Include SDK's default platform instructions
21
        include_base_instructions=False,
22
23
        # Approval handling
24
        approval_mode="manual",
25
        approval_wait_timeout_s=300.0,
26
        approval_timeout_reply="reject",     # reject, once, always
27
28
        # Question handling
29
        question_mode="manual",
30
        question_wait_timeout_s=300.0,
31
32
        # Enable visibility into tool calls
33
        enable_execution_reporting=False,
34
35
        # Enable task lifecycle events
36
        enable_task_events=True,
37
38
        # Maximum time for a single turn (seconds)
39
        turn_timeout_s=300.0,
40
41
        # Session title prefix in OpenCode
42
        session_title_prefix="Thenvoi",
43
44
        # MCP server name for platform tools
45
        mcp_server_name="thenvoi",
46
    )
47
)

1
import asyncio
2
import logging
3
from thenvoi import Agent
4
from thenvoi.adapters import OpencodeAdapter, OpencodeAdapterConfig
5
from thenvoi.config import load_agent_config
6
7
# Enable debug logging for the SDK
8
logging.basicConfig(
9
    level=logging.WARNING,
10
    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
11
    datefmt="%Y-%m-%d %H:%M:%S",
12
)
13
logging.getLogger("thenvoi").setLevel(logging.DEBUG)
14
logger = logging.getLogger(__name__)
15
16
async def main():
17
    agent_id, api_key = load_agent_config("my_agent")
18
19
    adapter = OpencodeAdapter(
20
        config=OpencodeAdapterConfig()
21
    )
22
23
    agent = Agent.create(
24
        adapter=adapter,
25
        agent_id=agent_id,
26
        api_key=api_key,
27
    )
28
29
    logger.info("Agent running with DEBUG logging. Press Ctrl+C to stop.")
30
    await agent.run()
31
32
if __name__ == "__main__":
33
    asyncio.run(main())